@qijenchen/design-system 0.1.0-beta.8 → 0.1.0-beta.81

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 (1375) hide show
  1. package/CLAUDE.md +201 -0
  2. package/README.md +10 -9
  3. package/cli-init.mjs +90 -0
  4. package/dist/components/Accordion/accordion.d.ts +1 -1
  5. package/dist/components/Accordion/accordion.d.ts.map +1 -1
  6. package/dist/components/Accordion/accordion.js +4 -1
  7. package/dist/components/Accordion/accordion.js.map +1 -1
  8. package/dist/components/Accordion/index.d.ts +2 -0
  9. package/dist/components/Accordion/index.d.ts.map +1 -0
  10. package/dist/components/Accordion/index.js +9 -0
  11. package/dist/components/Accordion/index.js.map +1 -0
  12. package/dist/components/Alert/alert.d.ts +7 -2
  13. package/dist/components/Alert/alert.d.ts.map +1 -1
  14. package/dist/components/Alert/alert.js +12 -8
  15. package/dist/components/Alert/alert.js.map +1 -1
  16. package/dist/components/Alert/index.d.ts +2 -0
  17. package/dist/components/Alert/index.d.ts.map +1 -0
  18. package/dist/components/Alert/index.js +7 -0
  19. package/dist/components/Alert/index.js.map +1 -0
  20. package/dist/components/AppShell/_demo-helpers.d.ts +3 -1
  21. package/dist/components/AppShell/_demo-helpers.d.ts.map +1 -1
  22. package/dist/components/AppShell/app-shell.d.ts +3 -3
  23. package/dist/components/AppShell/app-shell.d.ts.map +1 -1
  24. package/dist/components/AppShell/app-shell.js +9 -8
  25. package/dist/components/AppShell/app-shell.js.map +1 -1
  26. package/dist/components/AppShell/index.d.ts +2 -0
  27. package/dist/components/AppShell/index.d.ts.map +1 -0
  28. package/dist/components/AppShell/index.js +7 -0
  29. package/dist/components/AppShell/index.js.map +1 -0
  30. package/dist/components/AspectRatio/aspect-ratio.d.ts +3 -2
  31. package/dist/components/AspectRatio/aspect-ratio.d.ts.map +1 -1
  32. package/dist/components/AspectRatio/aspect-ratio.js +4 -2
  33. package/dist/components/AspectRatio/aspect-ratio.js.map +1 -1
  34. package/dist/components/AspectRatio/index.d.ts +2 -0
  35. package/dist/components/AspectRatio/index.d.ts.map +1 -0
  36. package/dist/components/AspectRatio/index.js +6 -0
  37. package/dist/components/AspectRatio/index.js.map +1 -0
  38. package/dist/components/Avatar/avatar.d.ts +14 -7
  39. package/dist/components/Avatar/avatar.d.ts.map +1 -1
  40. package/dist/components/Avatar/avatar.js +19 -24
  41. package/dist/components/Avatar/avatar.js.map +1 -1
  42. package/dist/components/Avatar/index.d.ts +2 -0
  43. package/dist/components/Avatar/index.d.ts.map +1 -0
  44. package/dist/components/Avatar/index.js +6 -0
  45. package/dist/components/Avatar/index.js.map +1 -0
  46. package/dist/components/Badge/badge.d.ts +20 -8
  47. package/dist/components/Badge/badge.d.ts.map +1 -1
  48. package/dist/components/Badge/badge.js +9 -6
  49. package/dist/components/Badge/badge.js.map +1 -1
  50. package/dist/components/Badge/index.d.ts +2 -0
  51. package/dist/components/Badge/index.d.ts.map +1 -0
  52. package/dist/components/Badge/index.js +7 -0
  53. package/dist/components/Badge/index.js.map +1 -0
  54. package/dist/components/Breadcrumb/breadcrumb.d.ts +15 -2
  55. package/dist/components/Breadcrumb/breadcrumb.d.ts.map +1 -1
  56. package/dist/components/Breadcrumb/breadcrumb.js +9 -3
  57. package/dist/components/Breadcrumb/breadcrumb.js.map +1 -1
  58. package/dist/components/Breadcrumb/index.d.ts +2 -0
  59. package/dist/components/Breadcrumb/index.d.ts.map +1 -0
  60. package/dist/components/Breadcrumb/index.js +12 -0
  61. package/dist/components/Breadcrumb/index.js.map +1 -0
  62. package/dist/components/BulkActionBar/bulk-action-bar.d.ts +3 -3
  63. package/dist/components/BulkActionBar/bulk-action-bar.d.ts.map +1 -1
  64. package/dist/components/BulkActionBar/bulk-action-bar.js +3 -3
  65. package/dist/components/BulkActionBar/bulk-action-bar.js.map +1 -1
  66. package/dist/components/BulkActionBar/index.d.ts +2 -0
  67. package/dist/components/BulkActionBar/index.d.ts.map +1 -0
  68. package/dist/components/BulkActionBar/index.js +7 -0
  69. package/dist/components/BulkActionBar/index.js.map +1 -0
  70. package/dist/components/Button/button.d.ts +10 -10
  71. package/dist/components/Button/button.d.ts.map +1 -1
  72. package/dist/components/Button/button.js +79 -50
  73. package/dist/components/Button/button.js.map +1 -1
  74. package/dist/components/Button/index.d.ts +3 -0
  75. package/dist/components/Button/index.d.ts.map +1 -0
  76. package/dist/components/Button/index.js +11 -0
  77. package/dist/components/Button/index.js.map +1 -0
  78. package/dist/components/Calendar/calendar.d.ts +9 -5
  79. package/dist/components/Calendar/calendar.d.ts.map +1 -1
  80. package/dist/components/Calendar/calendar.js +88 -76
  81. package/dist/components/Calendar/calendar.js.map +1 -1
  82. package/dist/components/Calendar/index.d.ts +2 -0
  83. package/dist/components/Calendar/index.d.ts.map +1 -0
  84. package/dist/components/Calendar/index.js +6 -0
  85. package/dist/components/Calendar/index.js.map +1 -0
  86. package/dist/components/Carousel/carousel.d.ts.map +1 -1
  87. package/dist/components/Carousel/carousel.js +11 -6
  88. package/dist/components/Carousel/carousel.js.map +1 -1
  89. package/dist/components/Carousel/index.d.ts +2 -0
  90. package/dist/components/Carousel/index.d.ts.map +1 -0
  91. package/dist/components/Carousel/index.js +11 -0
  92. package/dist/components/Carousel/index.js.map +1 -0
  93. package/dist/components/Chart/chart.d.ts +2 -2
  94. package/dist/components/Chart/chart.d.ts.map +1 -1
  95. package/dist/components/Chart/chart.js +4 -2
  96. package/dist/components/Chart/chart.js.map +1 -1
  97. package/dist/components/Chart/index.d.ts +2 -0
  98. package/dist/components/Chart/index.d.ts.map +1 -0
  99. package/dist/components/Chart/index.js +11 -0
  100. package/dist/components/Chart/index.js.map +1 -0
  101. package/dist/components/Checkbox/checkbox-group.d.ts +2 -1
  102. package/dist/components/Checkbox/checkbox-group.d.ts.map +1 -1
  103. package/dist/components/Checkbox/checkbox-group.js.map +1 -1
  104. package/dist/components/Checkbox/checkbox.d.ts +18 -9
  105. package/dist/components/Checkbox/checkbox.d.ts.map +1 -1
  106. package/dist/components/Checkbox/checkbox.js +70 -15
  107. package/dist/components/Checkbox/checkbox.js.map +1 -1
  108. package/dist/components/Checkbox/index.d.ts +3 -0
  109. package/dist/components/Checkbox/index.d.ts.map +1 -0
  110. package/dist/components/Checkbox/index.js +10 -0
  111. package/dist/components/Checkbox/index.js.map +1 -0
  112. package/dist/components/Chip/chip.d.ts +13 -7
  113. package/dist/components/Chip/chip.d.ts.map +1 -1
  114. package/dist/components/Chip/chip.js +9 -4
  115. package/dist/components/Chip/chip.js.map +1 -1
  116. package/dist/components/Chip/index.d.ts +2 -0
  117. package/dist/components/Chip/index.d.ts.map +1 -0
  118. package/dist/components/Chip/index.js +8 -0
  119. package/dist/components/Chip/index.js.map +1 -0
  120. package/dist/components/CircularProgress/circular-progress.d.ts +2 -3
  121. package/dist/components/CircularProgress/circular-progress.d.ts.map +1 -1
  122. package/dist/components/CircularProgress/circular-progress.js +4 -3
  123. package/dist/components/CircularProgress/circular-progress.js.map +1 -1
  124. package/dist/components/CircularProgress/index.d.ts +2 -0
  125. package/dist/components/CircularProgress/index.d.ts.map +1 -0
  126. package/dist/components/CircularProgress/index.js +6 -0
  127. package/dist/components/CircularProgress/index.js.map +1 -0
  128. package/dist/components/Coachmark/coachmark-story-helpers.d.ts +22 -0
  129. package/dist/components/Coachmark/coachmark-story-helpers.d.ts.map +1 -0
  130. package/dist/components/Coachmark/coachmark.d.ts +6 -4
  131. package/dist/components/Coachmark/coachmark.d.ts.map +1 -1
  132. package/dist/components/Coachmark/coachmark.js +13 -5
  133. package/dist/components/Coachmark/coachmark.js.map +1 -1
  134. package/dist/components/Coachmark/index.d.ts +2 -0
  135. package/dist/components/Coachmark/index.d.ts.map +1 -0
  136. package/dist/components/Coachmark/index.js +6 -0
  137. package/dist/components/Coachmark/index.js.map +1 -0
  138. package/dist/components/Combobox/combobox.d.ts +18 -7
  139. package/dist/components/Combobox/combobox.d.ts.map +1 -1
  140. package/dist/components/Combobox/combobox.js +81 -45
  141. package/dist/components/Combobox/combobox.js.map +1 -1
  142. package/dist/components/Combobox/index.d.ts +2 -0
  143. package/dist/components/Combobox/index.d.ts.map +1 -0
  144. package/dist/components/Combobox/index.js +6 -0
  145. package/dist/components/Combobox/index.js.map +1 -0
  146. package/dist/components/Command/command.d.ts +6 -2
  147. package/dist/components/Command/command.d.ts.map +1 -1
  148. package/dist/components/Command/command.js +8 -7
  149. package/dist/components/Command/command.js.map +1 -1
  150. package/dist/components/Command/index.d.ts +2 -0
  151. package/dist/components/Command/index.d.ts.map +1 -0
  152. package/dist/components/Command/index.js +14 -0
  153. package/dist/components/Command/index.js.map +1 -0
  154. package/dist/components/DataTable/active-editor-controller.d.ts +4 -3
  155. package/dist/components/DataTable/active-editor-controller.d.ts.map +1 -1
  156. package/dist/components/DataTable/cell-registry.d.ts.map +1 -1
  157. package/dist/components/DataTable/cell-registry.js +9 -5
  158. package/dist/components/DataTable/cell-registry.js.map +1 -1
  159. package/dist/components/DataTable/data-table-filter-panel.d.ts.map +1 -1
  160. package/dist/components/DataTable/data-table-interaction-layer.d.ts +4 -3
  161. package/dist/components/DataTable/data-table-interaction-layer.d.ts.map +1 -1
  162. package/dist/components/DataTable/data-table-interaction-layer.js.map +1 -1
  163. package/dist/components/DataTable/data-table.d.ts +37 -13
  164. package/dist/components/DataTable/data-table.d.ts.map +1 -1
  165. package/dist/components/DataTable/data-table.js +211 -89
  166. package/dist/components/DataTable/data-table.js.map +1 -1
  167. package/dist/components/DataTable/filter-operators.d.ts +1 -1
  168. package/dist/components/DataTable/filter-tree.d.ts +6 -1
  169. package/dist/components/DataTable/filter-tree.d.ts.map +1 -1
  170. package/dist/components/DataTable/index.d.ts +2 -0
  171. package/dist/components/DataTable/index.d.ts.map +1 -0
  172. package/dist/components/DataTable/index.js +8 -0
  173. package/dist/components/DataTable/index.js.map +1 -0
  174. package/dist/components/DateGrid/date-grid.d.ts +22 -18
  175. package/dist/components/DateGrid/date-grid.d.ts.map +1 -1
  176. package/dist/components/DateGrid/date-grid.js +8 -6
  177. package/dist/components/DateGrid/date-grid.js.map +1 -1
  178. package/dist/components/DateGrid/index.d.ts +2 -0
  179. package/dist/components/DateGrid/index.d.ts.map +1 -0
  180. package/dist/components/DateGrid/index.js +6 -0
  181. package/dist/components/DateGrid/index.js.map +1 -0
  182. package/dist/components/DatePicker/date-picker.d.ts.map +1 -1
  183. package/dist/components/DatePicker/date-picker.js +153 -124
  184. package/dist/components/DatePicker/date-picker.js.map +1 -1
  185. package/dist/components/DatePicker/index.d.ts +2 -0
  186. package/dist/components/DatePicker/index.d.ts.map +1 -0
  187. package/dist/components/DatePicker/index.js +8 -0
  188. package/dist/components/DatePicker/index.js.map +1 -0
  189. package/dist/components/DescriptionList/description-list.d.ts +3 -3
  190. package/dist/components/DescriptionList/description-list.js +4 -3
  191. package/dist/components/DescriptionList/description-list.js.map +1 -1
  192. package/dist/components/DescriptionList/index.d.ts +2 -0
  193. package/dist/components/DescriptionList/index.d.ts.map +1 -0
  194. package/dist/components/DescriptionList/index.js +7 -0
  195. package/dist/components/DescriptionList/index.js.map +1 -0
  196. package/dist/components/Dialog/dialog.d.ts +1 -1
  197. package/dist/components/Dialog/dialog.d.ts.map +1 -1
  198. package/dist/components/Dialog/dialog.js +2 -1
  199. package/dist/components/Dialog/dialog.js.map +1 -1
  200. package/dist/components/Dialog/index.d.ts +2 -0
  201. package/dist/components/Dialog/index.d.ts.map +1 -0
  202. package/dist/components/Dialog/index.js +16 -0
  203. package/dist/components/Dialog/index.js.map +1 -0
  204. package/dist/components/DropdownMenu/dropdown-menu.d.ts +4 -3
  205. package/dist/components/DropdownMenu/dropdown-menu.d.ts.map +1 -1
  206. package/dist/components/DropdownMenu/dropdown-menu.js +13 -7
  207. package/dist/components/DropdownMenu/dropdown-menu.js.map +1 -1
  208. package/dist/components/DropdownMenu/index.d.ts +2 -0
  209. package/dist/components/DropdownMenu/index.d.ts.map +1 -0
  210. package/dist/components/DropdownMenu/index.js +21 -0
  211. package/dist/components/DropdownMenu/index.js.map +1 -0
  212. package/dist/components/Empty/empty.d.ts +11 -3
  213. package/dist/components/Empty/empty.d.ts.map +1 -1
  214. package/dist/components/Empty/empty.js +6 -6
  215. package/dist/components/Empty/empty.js.map +1 -1
  216. package/dist/components/Empty/index.d.ts +2 -0
  217. package/dist/components/Empty/index.d.ts.map +1 -0
  218. package/dist/components/Empty/index.js +6 -0
  219. package/dist/components/Empty/index.js.map +1 -0
  220. package/dist/components/Field/field-context.d.ts +49 -0
  221. package/dist/components/Field/field-context.d.ts.map +1 -1
  222. package/dist/components/Field/field-context.js +42 -0
  223. package/dist/components/Field/field-context.js.map +1 -1
  224. package/dist/components/Field/field-types.js.map +1 -1
  225. package/dist/components/Field/field-wrapper.d.ts +1 -0
  226. package/dist/components/Field/field-wrapper.d.ts.map +1 -1
  227. package/dist/components/Field/field-wrapper.js +32 -12
  228. package/dist/components/Field/field-wrapper.js.map +1 -1
  229. package/dist/components/Field/field.d.ts +4 -2
  230. package/dist/components/Field/field.d.ts.map +1 -1
  231. package/dist/components/Field/field.js +1 -0
  232. package/dist/components/Field/field.js.map +1 -1
  233. package/dist/components/Field/index.d.ts +2 -0
  234. package/dist/components/Field/index.d.ts.map +1 -0
  235. package/dist/components/Field/index.js +12 -0
  236. package/dist/components/Field/index.js.map +1 -0
  237. package/dist/components/Field/use-form-validation.d.ts +92 -0
  238. package/dist/components/Field/use-form-validation.d.ts.map +1 -0
  239. package/dist/components/Field/use-form-validation.js +139 -0
  240. package/dist/components/Field/use-form-validation.js.map +1 -0
  241. package/dist/components/FieldControlGroup/field-control-group.d.ts +8 -8
  242. package/dist/components/FieldControlGroup/field-control-group.d.ts.map +1 -1
  243. package/dist/components/FieldControlGroup/field-control-group.js +1 -1
  244. package/dist/components/FieldControlGroup/field-control-group.js.map +1 -1
  245. package/dist/components/FieldControlGroup/index.d.ts +2 -0
  246. package/dist/components/FieldControlGroup/index.d.ts.map +1 -0
  247. package/dist/components/FieldControlGroup/index.js +6 -0
  248. package/dist/components/FieldControlGroup/index.js.map +1 -0
  249. package/dist/components/FileItem/file-item.d.ts +12 -2
  250. package/dist/components/FileItem/file-item.d.ts.map +1 -1
  251. package/dist/components/FileItem/file-item.js +23 -8
  252. package/dist/components/FileItem/file-item.js.map +1 -1
  253. package/dist/components/FileItem/index.d.ts +2 -0
  254. package/dist/components/FileItem/index.d.ts.map +1 -0
  255. package/dist/components/FileItem/index.js +6 -0
  256. package/dist/components/FileItem/index.js.map +1 -0
  257. package/dist/components/FileUpload/file-upload.d.ts +32 -13
  258. package/dist/components/FileUpload/file-upload.d.ts.map +1 -1
  259. package/dist/components/FileUpload/file-upload.js +72 -22
  260. package/dist/components/FileUpload/file-upload.js.map +1 -1
  261. package/dist/components/FileUpload/index.d.ts +2 -0
  262. package/dist/components/FileUpload/index.d.ts.map +1 -0
  263. package/dist/components/FileUpload/index.js +6 -0
  264. package/dist/components/FileUpload/index.js.map +1 -0
  265. package/dist/components/FileViewer/file-viewer.d.ts +2 -2
  266. package/dist/components/FileViewer/file-viewer.d.ts.map +1 -1
  267. package/dist/components/FileViewer/file-viewer.js +32 -22
  268. package/dist/components/FileViewer/file-viewer.js.map +1 -1
  269. package/dist/components/FileViewer/index.d.ts +2 -0
  270. package/dist/components/FileViewer/index.d.ts.map +1 -0
  271. package/dist/components/FileViewer/index.js +7 -0
  272. package/dist/components/FileViewer/index.js.map +1 -0
  273. package/dist/components/HoverCard/hover-card.d.ts +7 -3
  274. package/dist/components/HoverCard/hover-card.d.ts.map +1 -1
  275. package/dist/components/HoverCard/hover-card.js +4 -3
  276. package/dist/components/HoverCard/hover-card.js.map +1 -1
  277. package/dist/components/HoverCard/index.d.ts +2 -0
  278. package/dist/components/HoverCard/index.d.ts.map +1 -0
  279. package/dist/components/HoverCard/index.js +8 -0
  280. package/dist/components/HoverCard/index.js.map +1 -0
  281. package/dist/components/Input/index.d.ts +2 -0
  282. package/dist/components/Input/index.d.ts.map +1 -0
  283. package/dist/components/Input/index.js +6 -0
  284. package/dist/components/Input/index.js.map +1 -0
  285. package/dist/components/Input/input.d.ts +5 -2
  286. package/dist/components/Input/input.d.ts.map +1 -1
  287. package/dist/components/Input/input.js +11 -13
  288. package/dist/components/Input/input.js.map +1 -1
  289. package/dist/components/LinkInput/index.d.ts +2 -0
  290. package/dist/components/LinkInput/index.d.ts.map +1 -0
  291. package/dist/components/LinkInput/index.js +6 -0
  292. package/dist/components/LinkInput/index.js.map +1 -0
  293. package/dist/components/LinkInput/link-input.d.ts +2 -2
  294. package/dist/components/LinkInput/link-input.d.ts.map +1 -1
  295. package/dist/components/LinkInput/link-input.js +36 -35
  296. package/dist/components/LinkInput/link-input.js.map +1 -1
  297. package/dist/components/Menu/index.d.ts +2 -0
  298. package/dist/components/Menu/index.d.ts.map +1 -0
  299. package/dist/components/Menu/index.js +9 -0
  300. package/dist/components/Menu/index.js.map +1 -0
  301. package/dist/components/Menu/menu-item.d.ts +6 -2
  302. package/dist/components/Menu/menu-item.d.ts.map +1 -1
  303. package/dist/components/Menu/menu-item.js +3 -2
  304. package/dist/components/Menu/menu-item.js.map +1 -1
  305. package/dist/components/Notice/index.d.ts +2 -0
  306. package/dist/components/Notice/index.d.ts.map +1 -0
  307. package/dist/components/Notice/index.js +8 -0
  308. package/dist/components/Notice/index.js.map +1 -0
  309. package/dist/components/Notice/notice.d.ts +18 -6
  310. package/dist/components/Notice/notice.d.ts.map +1 -1
  311. package/dist/components/Notice/notice.js +25 -9
  312. package/dist/components/Notice/notice.js.map +1 -1
  313. package/dist/components/NumberInput/index.d.ts +2 -0
  314. package/dist/components/NumberInput/index.d.ts.map +1 -0
  315. package/dist/components/NumberInput/index.js +7 -0
  316. package/dist/components/NumberInput/index.js.map +1 -0
  317. package/dist/components/NumberInput/number-input.d.ts.map +1 -1
  318. package/dist/components/NumberInput/number-input.js +23 -14
  319. package/dist/components/NumberInput/number-input.js.map +1 -1
  320. package/dist/components/OverflowIndicator/index.d.ts +2 -0
  321. package/dist/components/OverflowIndicator/index.d.ts.map +1 -0
  322. package/dist/components/OverflowIndicator/index.js +6 -0
  323. package/dist/components/OverflowIndicator/index.js.map +1 -0
  324. package/dist/components/OverflowIndicator/overflow-indicator.d.ts +6 -2
  325. package/dist/components/OverflowIndicator/overflow-indicator.d.ts.map +1 -1
  326. package/dist/components/OverflowIndicator/overflow-indicator.js +15 -7
  327. package/dist/components/OverflowIndicator/overflow-indicator.js.map +1 -1
  328. package/dist/components/PeoplePicker/index.d.ts +2 -0
  329. package/dist/components/PeoplePicker/index.d.ts.map +1 -0
  330. package/dist/components/PeoplePicker/index.js +9 -0
  331. package/dist/components/PeoplePicker/index.js.map +1 -0
  332. package/dist/components/PeoplePicker/people-picker-helpers.d.ts.map +1 -1
  333. package/dist/components/PeoplePicker/people-picker-helpers.js +2 -2
  334. package/dist/components/PeoplePicker/people-picker-helpers.js.map +1 -1
  335. package/dist/components/PeoplePicker/people-picker.d.ts +2 -2
  336. package/dist/components/PeoplePicker/people-picker.d.ts.map +1 -1
  337. package/dist/components/PeoplePicker/people-picker.js +56 -51
  338. package/dist/components/PeoplePicker/people-picker.js.map +1 -1
  339. package/dist/components/PeoplePicker/person-display.d.ts +7 -7
  340. package/dist/components/PeoplePicker/person-display.d.ts.map +1 -1
  341. package/dist/components/PeoplePicker/person-display.js +11 -11
  342. package/dist/components/PeoplePicker/person-display.js.map +1 -1
  343. package/dist/components/Popover/index.d.ts +2 -0
  344. package/dist/components/Popover/index.d.ts.map +1 -0
  345. package/dist/components/Popover/index.js +14 -0
  346. package/dist/components/Popover/index.js.map +1 -0
  347. package/dist/components/Popover/popover.d.ts +2 -2
  348. package/dist/components/Popover/popover.d.ts.map +1 -1
  349. package/dist/components/Popover/popover.js +12 -12
  350. package/dist/components/Popover/popover.js.map +1 -1
  351. package/dist/components/ProfileCard/index.d.ts +2 -0
  352. package/dist/components/ProfileCard/index.d.ts.map +1 -0
  353. package/dist/components/ProfileCard/index.js +8 -0
  354. package/dist/components/ProfileCard/index.js.map +1 -0
  355. package/dist/components/{NameCard/name-card.d.ts → ProfileCard/profile-card.d.ts} +29 -20
  356. package/dist/components/ProfileCard/profile-card.d.ts.map +1 -0
  357. package/dist/components/{NameCard/name-card.js → ProfileCard/profile-card.js} +11 -10
  358. package/dist/components/ProfileCard/profile-card.js.map +1 -0
  359. package/dist/components/ProgressBar/index.d.ts +2 -0
  360. package/dist/components/ProgressBar/index.d.ts.map +1 -0
  361. package/dist/components/ProgressBar/index.js +6 -0
  362. package/dist/components/ProgressBar/index.js.map +1 -0
  363. package/dist/components/ProgressBar/progress-bar.d.ts +2 -2
  364. package/dist/components/ProgressBar/progress-bar.js +3 -3
  365. package/dist/components/ProgressBar/progress-bar.js.map +1 -1
  366. package/dist/components/RadioGroup/index.d.ts +2 -0
  367. package/dist/components/RadioGroup/index.d.ts.map +1 -0
  368. package/dist/components/RadioGroup/index.js +8 -0
  369. package/dist/components/RadioGroup/index.js.map +1 -0
  370. package/dist/components/RadioGroup/radio-group.d.ts +16 -10
  371. package/dist/components/RadioGroup/radio-group.d.ts.map +1 -1
  372. package/dist/components/RadioGroup/radio-group.js +97 -35
  373. package/dist/components/RadioGroup/radio-group.js.map +1 -1
  374. package/dist/components/Rating/index.d.ts +2 -0
  375. package/dist/components/Rating/index.d.ts.map +1 -0
  376. package/dist/components/Rating/index.js +6 -0
  377. package/dist/components/Rating/index.js.map +1 -0
  378. package/dist/components/Rating/rating.d.ts +6 -2
  379. package/dist/components/Rating/rating.d.ts.map +1 -1
  380. package/dist/components/Rating/rating.js +13 -10
  381. package/dist/components/Rating/rating.js.map +1 -1
  382. package/dist/components/ScrollArea/index.d.ts +2 -0
  383. package/dist/components/ScrollArea/index.d.ts.map +1 -0
  384. package/dist/components/ScrollArea/index.js +7 -0
  385. package/dist/components/ScrollArea/index.js.map +1 -0
  386. package/dist/components/ScrollArea/scroll-area.d.ts +2 -2
  387. package/dist/components/ScrollArea/scroll-area.js +4 -4
  388. package/dist/components/ScrollArea/scroll-area.js.map +1 -1
  389. package/dist/components/SegmentedControl/index.d.ts +2 -0
  390. package/dist/components/SegmentedControl/index.d.ts.map +1 -0
  391. package/dist/components/SegmentedControl/index.js +9 -0
  392. package/dist/components/SegmentedControl/index.js.map +1 -0
  393. package/dist/components/SegmentedControl/segmented-control.d.ts +4 -4
  394. package/dist/components/SegmentedControl/segmented-control.d.ts.map +1 -1
  395. package/dist/components/SegmentedControl/segmented-control.js +18 -15
  396. package/dist/components/SegmentedControl/segmented-control.js.map +1 -1
  397. package/dist/components/Select/index.d.ts +2 -0
  398. package/dist/components/Select/index.d.ts.map +1 -0
  399. package/dist/components/Select/index.js +6 -0
  400. package/dist/components/Select/index.js.map +1 -0
  401. package/dist/components/Select/select.d.ts +9 -3
  402. package/dist/components/Select/select.d.ts.map +1 -1
  403. package/dist/components/Select/select.js +73 -29
  404. package/dist/components/Select/select.js.map +1 -1
  405. package/dist/components/SelectMenu/index.d.ts +2 -0
  406. package/dist/components/SelectMenu/index.d.ts.map +1 -0
  407. package/dist/components/SelectMenu/index.js +7 -0
  408. package/dist/components/SelectMenu/index.js.map +1 -0
  409. package/dist/components/SelectMenu/select-menu.d.ts +24 -6
  410. package/dist/components/SelectMenu/select-menu.d.ts.map +1 -1
  411. package/dist/components/SelectMenu/select-menu.js +51 -10
  412. package/dist/components/SelectMenu/select-menu.js.map +1 -1
  413. package/dist/components/SelectionControl/index.d.ts +2 -0
  414. package/dist/components/SelectionControl/index.d.ts.map +1 -0
  415. package/dist/components/SelectionControl/index.js +7 -0
  416. package/dist/components/SelectionControl/index.js.map +1 -0
  417. package/dist/components/SelectionControl/selection-item.d.ts +5 -1
  418. package/dist/components/SelectionControl/selection-item.d.ts.map +1 -1
  419. package/dist/components/SelectionControl/selection-item.js +3 -1
  420. package/dist/components/SelectionControl/selection-item.js.map +1 -1
  421. package/dist/components/Separator/index.d.ts +2 -0
  422. package/dist/components/Separator/index.d.ts.map +1 -0
  423. package/dist/components/Separator/index.js +6 -0
  424. package/dist/components/Separator/index.js.map +1 -0
  425. package/dist/components/Separator/separator.d.ts +2 -2
  426. package/dist/components/Separator/separator.js +4 -3
  427. package/dist/components/Separator/separator.js.map +1 -1
  428. package/dist/components/Sheet/index.d.ts +2 -0
  429. package/dist/components/Sheet/index.d.ts.map +1 -0
  430. package/dist/components/Sheet/index.js +17 -0
  431. package/dist/components/Sheet/index.js.map +1 -0
  432. package/dist/components/Sheet/sheet.d.ts +7 -6
  433. package/dist/components/Sheet/sheet.d.ts.map +1 -1
  434. package/dist/components/Sheet/sheet.js +3 -2
  435. package/dist/components/Sheet/sheet.js.map +1 -1
  436. package/dist/components/Sidebar/index.d.ts +2 -0
  437. package/dist/components/Sidebar/index.d.ts.map +1 -0
  438. package/dist/components/Sidebar/index.js +24 -0
  439. package/dist/components/Sidebar/index.js.map +1 -0
  440. package/dist/components/Sidebar/sidebar.d.ts +2 -2
  441. package/dist/components/Sidebar/sidebar.d.ts.map +1 -1
  442. package/dist/components/Sidebar/sidebar.js +32 -13
  443. package/dist/components/Sidebar/sidebar.js.map +1 -1
  444. package/dist/components/Skeleton/index.d.ts +2 -0
  445. package/dist/components/Skeleton/index.d.ts.map +1 -0
  446. package/dist/components/Skeleton/index.js +6 -0
  447. package/dist/components/Skeleton/index.js.map +1 -0
  448. package/dist/components/Skeleton/skeleton.d.ts +2 -2
  449. package/dist/components/Skeleton/skeleton.js +4 -3
  450. package/dist/components/Skeleton/skeleton.js.map +1 -1
  451. package/dist/components/Slider/index.d.ts +2 -0
  452. package/dist/components/Slider/index.d.ts.map +1 -0
  453. package/dist/components/Slider/index.js +7 -0
  454. package/dist/components/Slider/index.js.map +1 -0
  455. package/dist/components/Slider/slider.d.ts +6 -6
  456. package/dist/components/Slider/slider.d.ts.map +1 -1
  457. package/dist/components/Slider/slider.js +25 -10
  458. package/dist/components/Slider/slider.js.map +1 -1
  459. package/dist/components/Steps/index.d.ts +2 -0
  460. package/dist/components/Steps/index.d.ts.map +1 -0
  461. package/dist/components/Steps/index.js +12 -0
  462. package/dist/components/Steps/index.js.map +1 -0
  463. package/dist/components/Steps/steps.d.ts +2 -2
  464. package/dist/components/Steps/steps.d.ts.map +1 -1
  465. package/dist/components/Steps/steps.js +54 -26
  466. package/dist/components/Steps/steps.js.map +1 -1
  467. package/dist/components/Switch/index.d.ts +2 -0
  468. package/dist/components/Switch/index.d.ts.map +1 -0
  469. package/dist/components/Switch/index.js +7 -0
  470. package/dist/components/Switch/index.js.map +1 -0
  471. package/dist/components/Switch/switch.d.ts +18 -16
  472. package/dist/components/Switch/switch.d.ts.map +1 -1
  473. package/dist/components/Switch/switch.js +81 -22
  474. package/dist/components/Switch/switch.js.map +1 -1
  475. package/dist/components/Tabs/index.d.ts +2 -0
  476. package/dist/components/Tabs/index.d.ts.map +1 -0
  477. package/dist/components/Tabs/index.js +10 -0
  478. package/dist/components/Tabs/index.js.map +1 -0
  479. package/dist/components/Tabs/tabs.d.ts +10 -7
  480. package/dist/components/Tabs/tabs.d.ts.map +1 -1
  481. package/dist/components/Tabs/tabs.js +30 -31
  482. package/dist/components/Tabs/tabs.js.map +1 -1
  483. package/dist/components/Tag/index.d.ts +2 -0
  484. package/dist/components/Tag/index.d.ts.map +1 -0
  485. package/dist/components/Tag/index.js +7 -0
  486. package/dist/components/Tag/index.js.map +1 -0
  487. package/dist/components/Tag/tag.d.ts +37 -23
  488. package/dist/components/Tag/tag.d.ts.map +1 -1
  489. package/dist/components/Tag/tag.js +43 -44
  490. package/dist/components/Tag/tag.js.map +1 -1
  491. package/dist/components/Textarea/index.d.ts +2 -0
  492. package/dist/components/Textarea/index.d.ts.map +1 -0
  493. package/dist/components/Textarea/index.js +7 -0
  494. package/dist/components/Textarea/index.js.map +1 -0
  495. package/dist/components/Textarea/textarea.d.ts +7 -11
  496. package/dist/components/Textarea/textarea.d.ts.map +1 -1
  497. package/dist/components/Textarea/textarea.js +34 -24
  498. package/dist/components/Textarea/textarea.js.map +1 -1
  499. package/dist/components/TimePicker/index.d.ts +2 -0
  500. package/dist/components/TimePicker/index.d.ts.map +1 -0
  501. package/dist/components/TimePicker/index.js +6 -0
  502. package/dist/components/TimePicker/index.js.map +1 -0
  503. package/dist/components/TimePicker/time-columns.d.ts.map +1 -1
  504. package/dist/components/TimePicker/time-columns.js +4 -1
  505. package/dist/components/TimePicker/time-columns.js.map +1 -1
  506. package/dist/components/TimePicker/time-picker.d.ts +4 -3
  507. package/dist/components/TimePicker/time-picker.d.ts.map +1 -1
  508. package/dist/components/TimePicker/time-picker.js +38 -39
  509. package/dist/components/TimePicker/time-picker.js.map +1 -1
  510. package/dist/components/Toast/index.d.ts +2 -0
  511. package/dist/components/Toast/index.d.ts.map +1 -0
  512. package/dist/components/Toast/index.js +7 -0
  513. package/dist/components/Toast/index.js.map +1 -0
  514. package/dist/components/Toast/toast.d.ts +2 -2
  515. package/dist/components/Toast/toast.d.ts.map +1 -1
  516. package/dist/components/Toast/toast.js +5 -4
  517. package/dist/components/Toast/toast.js.map +1 -1
  518. package/dist/components/Tooltip/index.d.ts +2 -0
  519. package/dist/components/Tooltip/index.d.ts.map +1 -0
  520. package/dist/components/Tooltip/index.js +9 -0
  521. package/dist/components/Tooltip/index.js.map +1 -0
  522. package/dist/components/Tooltip/tooltip.d.ts +1 -1
  523. package/dist/components/Tooltip/tooltip.d.ts.map +1 -1
  524. package/dist/components/Tooltip/tooltip.js +3 -2
  525. package/dist/components/Tooltip/tooltip.js.map +1 -1
  526. package/dist/components/TreeView/index.d.ts +2 -0
  527. package/dist/components/TreeView/index.d.ts.map +1 -0
  528. package/dist/components/TreeView/index.js +8 -0
  529. package/dist/components/TreeView/index.js.map +1 -0
  530. package/dist/components/TreeView/tree-view.d.ts +11 -11
  531. package/dist/components/TreeView/tree-view.d.ts.map +1 -1
  532. package/dist/components/TreeView/tree-view.js +38 -10
  533. package/dist/components/TreeView/tree-view.js.map +1 -1
  534. package/dist/hooks/use-overflow-items.d.ts +10 -6
  535. package/dist/hooks/use-overflow-items.d.ts.map +1 -1
  536. package/dist/hooks/use-overflow-items.js.map +1 -1
  537. package/dist/index.d.ts +58 -67
  538. package/dist/index.d.ts.map +1 -1
  539. package/dist/index.js +38 -57
  540. package/dist/index.js.map +1 -1
  541. package/dist/lib/utils.d.ts.map +1 -1
  542. package/dist/lib/utils.js +3 -1
  543. package/dist/lib/utils.js.map +1 -1
  544. package/dist/patterns/element-anatomy/index.d.ts +2 -0
  545. package/dist/patterns/element-anatomy/index.d.ts.map +1 -0
  546. package/dist/patterns/element-anatomy/index.js +20 -0
  547. package/dist/patterns/element-anatomy/index.js.map +1 -0
  548. package/dist/patterns/element-anatomy/item-anatomy.d.ts +10 -6
  549. package/dist/patterns/element-anatomy/item-anatomy.d.ts.map +1 -1
  550. package/dist/patterns/element-anatomy/item-anatomy.js +1 -1
  551. package/dist/patterns/element-anatomy/item-anatomy.js.map +1 -1
  552. package/dist/patterns/header-canonical/chrome-header.d.ts +13 -4
  553. package/dist/patterns/header-canonical/chrome-header.d.ts.map +1 -1
  554. package/dist/patterns/header-canonical/chrome-header.js +4 -2
  555. package/dist/patterns/header-canonical/chrome-header.js.map +1 -1
  556. package/dist/patterns/header-canonical/index.d.ts +2 -0
  557. package/dist/patterns/header-canonical/index.d.ts.map +1 -0
  558. package/dist/patterns/header-canonical/index.js +6 -0
  559. package/dist/patterns/header-canonical/index.js.map +1 -0
  560. package/dist/patterns/horizontal-overflow/index.d.ts +2 -0
  561. package/dist/patterns/horizontal-overflow/index.d.ts.map +1 -0
  562. package/dist/patterns/horizontal-overflow/index.js +14 -0
  563. package/dist/patterns/horizontal-overflow/index.js.map +1 -0
  564. package/dist/patterns/overlay-surface/index.d.ts +2 -0
  565. package/dist/patterns/overlay-surface/index.d.ts.map +1 -0
  566. package/dist/patterns/overlay-surface/index.js +8 -0
  567. package/dist/patterns/overlay-surface/index.js.map +1 -0
  568. package/dist/patterns/overlay-surface/overlay-surface.d.ts +11 -2
  569. package/dist/patterns/overlay-surface/overlay-surface.d.ts.map +1 -1
  570. package/dist/patterns/overlay-surface/overlay-surface.js +5 -2
  571. package/dist/patterns/overlay-surface/overlay-surface.js.map +1 -1
  572. package/dist/patterns/resize-handle/index.d.ts +2 -0
  573. package/dist/patterns/resize-handle/index.d.ts.map +1 -0
  574. package/dist/patterns/resize-handle/index.js +5 -0
  575. package/dist/patterns/resize-handle/index.js.map +1 -0
  576. package/dist/story-governance/category-matrix.d.ts +35 -0
  577. package/dist/story-governance/category-matrix.d.ts.map +1 -0
  578. package/dist/tokens/categorical-color.d.ts +60 -0
  579. package/dist/tokens/categorical-color.d.ts.map +1 -0
  580. package/dist/tokens/categorical-color.js +110 -0
  581. package/dist/tokens/categorical-color.js.map +1 -0
  582. package/dist/tokens/motion/motion.d.ts +1 -1
  583. package/dist/tokens/motion/motion.d.ts.map +1 -1
  584. package/dist/tokens/motion/motion.js.map +1 -1
  585. package/dist/tokens/uiSize/icon-size.d.ts +3 -4
  586. package/dist/tokens/uiSize/icon-size.d.ts.map +1 -1
  587. package/ds-canonical/commands/README.md +26 -0
  588. package/ds-canonical/commands/gov-status.md +79 -0
  589. package/ds-canonical/fork/governance.lock +222 -0
  590. package/ds-canonical/fork/hooks/block_prototype_imports.py +111 -0
  591. package/ds-canonical/fork/hooks/check_chrome_header_avatar_canonical.sh +95 -0
  592. package/ds-canonical/fork/hooks/check_consumer_app_invariants.sh +349 -0
  593. package/ds-canonical/fork/hooks/check_ds_anchor_preflight.sh +132 -0
  594. package/ds-canonical/fork/hooks/check_escape_marker_abuse.sh +140 -0
  595. package/ds-canonical/fork/hooks/check_field_family_invariants.sh +250 -0
  596. package/ds-canonical/fork/hooks/check_fork_product_quality.sh +36 -0
  597. package/ds-canonical/fork/hooks/check_item_list_gap.sh +54 -0
  598. package/ds-canonical/fork/hooks/check_layout_space_magic_numbers.sh +96 -0
  599. package/ds-canonical/fork/hooks/check_opacity_token_usage.sh +158 -0
  600. package/ds-canonical/fork/hooks/check_pattern_invariants.sh +196 -0
  601. package/ds-canonical/fork/hooks/check_sidebar_menu_button_implicit_wrap.sh +86 -0
  602. package/ds-canonical/fork/hooks/check_tabs_content_chrome_body_double_gap.sh +183 -0
  603. package/ds-canonical/fork/hooks/check_tailwind_wildcard_in_docs.sh +79 -0
  604. package/ds-canonical/fork/hooks/inject_deploy_url_after_push.sh +238 -0
  605. package/ds-canonical/fork/launchers/fork-governance-dispatcher.sh +44 -0
  606. package/ds-canonical/fork/launchers/inject_fork_governance_preamble.sh +54 -0
  607. package/ds-canonical/fork/launchers/settings-hooks.json +58 -0
  608. package/ds-canonical/fork/manifest.json +98 -0
  609. package/ds-canonical/fork/preamble.md +495 -0
  610. package/ds-canonical/fork/skills/bug-fix-rhythm/SKILL.md +183 -0
  611. package/ds-canonical/fork/skills/code-quality-audit/SKILL.md +65 -0
  612. package/ds-canonical/fork/skills/delivery-handoff/SKILL.md +229 -0
  613. package/ds-canonical/fork/skills/delivery-handoff/references/flow-diagram.md +180 -0
  614. package/ds-canonical/fork/skills/delivery-handoff/references/handoff-template.md +177 -0
  615. package/ds-canonical/fork/skills/delivery-handoff/references/inventory-checklist.md +196 -0
  616. package/ds-canonical/fork/skills/performance-audit/SKILL.md +107 -0
  617. package/ds-canonical/fork/skills/product-ui-audit/SKILL.md +232 -0
  618. package/ds-canonical/fork/skills/product-ui-audit/references/audit-checks.md +246 -0
  619. package/ds-canonical/fork/skills/product-ui-audit/references/common-misuses.md +329 -0
  620. package/ds-canonical/fork/skills/product-ui-audit/references/report-template.md +159 -0
  621. package/ds-canonical/fork/skills/propose-options/SKILL.md +177 -0
  622. package/ds-canonical/fork/skills/prototype/SKILL.md +244 -0
  623. package/ds-canonical/fork/skills/prototype/references/audit-checks.md +38 -0
  624. package/ds-canonical/fork/skills/prototype/references/benchmark-sources.md +94 -0
  625. package/ds-canonical/fork/skills/prototype/references/checkpoints.md +191 -0
  626. package/ds-canonical/fork/skills/prototype/references/evaluation-matrix.md +141 -0
  627. package/ds-canonical/fork/skills/prototype/references/ooux-template.md +198 -0
  628. package/ds-canonical/fork/skills/prototype/references/proposal-template.md +229 -0
  629. package/ds-canonical/fork/skills/scan-similar-bugs/SKILL.md +200 -0
  630. package/ds-canonical/fork/skills/ux-audit/SKILL.md +130 -0
  631. package/ds-canonical/fork/skills/visual-audit/SKILL.md +247 -0
  632. package/ds-canonical/fork/skills/visual-audit/output/.gitkeep +0 -0
  633. package/ds-canonical/fork/skills/visual-audit/references/audit-architecture.md +101 -0
  634. package/ds-canonical/fork/skills/visual-audit/references/visual-checklist.md +297 -0
  635. package/ds-canonical/fork/skills/visual-audit/references/world-class-benchmarks.md +198 -0
  636. package/ds-canonical/hooks/README.md +145 -0
  637. package/ds-canonical/hooks/_log-fire.sh +46 -0
  638. package/ds-canonical/hooks/auto_regen_ds_barrel.sh +58 -0
  639. package/ds-canonical/hooks/block_prototype_imports.py +111 -0
  640. package/ds-canonical/hooks/check_audit_post_report_validator.sh +169 -0
  641. package/ds-canonical/hooks/check_audit_sample_escape.sh +76 -0
  642. package/ds-canonical/hooks/check_benchmark_citation.sh +106 -0
  643. package/ds-canonical/hooks/check_canonical_propagation.sh +189 -0
  644. package/ds-canonical/hooks/check_chrome_header_avatar_canonical.sh +95 -0
  645. package/ds-canonical/hooks/check_codex_brief_invariants.sh +115 -0
  646. package/ds-canonical/hooks/check_codex_collab_5step.sh +108 -0
  647. package/ds-canonical/hooks/check_consumer_app_invariants.sh +349 -0
  648. package/ds-canonical/hooks/check_datatable_invariants.sh +180 -0
  649. package/ds-canonical/hooks/check_dim_count_drift.sh +72 -0
  650. package/ds-canonical/hooks/check_ds_anchor_preflight.sh +132 -0
  651. package/ds-canonical/hooks/check_escape_marker_abuse.sh +140 -0
  652. package/ds-canonical/hooks/check_field_controls_contracts.sh +137 -0
  653. package/ds-canonical/hooks/check_field_family_invariants.sh +250 -0
  654. package/ds-canonical/hooks/check_file_size_budget.sh +60 -0
  655. package/ds-canonical/hooks/check_full_story_visual_interaction_sweep.sh +72 -0
  656. package/ds-canonical/hooks/check_item_list_gap.sh +54 -0
  657. package/ds-canonical/hooks/check_layout_space_magic_numbers.sh +96 -0
  658. package/ds-canonical/hooks/check_main_branch_workbench.sh +93 -0
  659. package/ds-canonical/hooks/check_naming_and_abstraction.sh +165 -0
  660. package/ds-canonical/hooks/check_opacity_token_usage.sh +158 -0
  661. package/ds-canonical/hooks/check_orphan_ds_css.sh +66 -0
  662. package/ds-canonical/hooks/check_overlay_open_focus_escape_probe.sh +75 -0
  663. package/ds-canonical/hooks/check_pattern_invariants.sh +196 -0
  664. package/ds-canonical/hooks/check_peoplepicker_ssot_drift.sh +56 -0
  665. package/ds-canonical/hooks/check_pixel_quantified_audit.sh +53 -0
  666. package/ds-canonical/hooks/check_plugin_fork_health.sh +145 -0
  667. package/ds-canonical/hooks/check_post_main_ssot_propagate.sh +90 -0
  668. package/ds-canonical/hooks/check_propose_discipline.sh +147 -0
  669. package/ds-canonical/hooks/check_propose_pre_grep_verify.sh +70 -0
  670. package/ds-canonical/hooks/check_propose_without_benchmark.sh +63 -0
  671. package/ds-canonical/hooks/check_select_all_canonical.sh +58 -0
  672. package/ds-canonical/hooks/check_sidebar_menu_button_implicit_wrap.sh +86 -0
  673. package/ds-canonical/hooks/check_solo_workflow.sh +317 -0
  674. package/ds-canonical/hooks/check_spec_class_drift.sh +88 -0
  675. package/ds-canonical/hooks/check_story_invariants.sh +760 -0
  676. package/ds-canonical/hooks/check_storybook_addon_packaging.sh +151 -0
  677. package/ds-canonical/hooks/check_substantive_edit_approval_preflight.sh +113 -0
  678. package/ds-canonical/hooks/check_tabs_content_chrome_body_double_gap.sh +183 -0
  679. package/ds-canonical/hooks/check_tailwind_wildcard_in_docs.sh +79 -0
  680. package/ds-canonical/hooks/check_wrapper_primitive_schema_drift.sh +104 -0
  681. package/ds-canonical/hooks/chrome_header_dispatcher.sh +56 -0
  682. package/ds-canonical/hooks/enforce_home_charter.sh +44 -0
  683. package/ds-canonical/hooks/inject_deploy_url_after_push.sh +238 -0
  684. package/ds-canonical/hooks/inject_pending_self_audit.sh +248 -0
  685. package/ds-canonical/hooks/lib/_app_shell_primary_header_consistency.sh +100 -0
  686. package/ds-canonical/hooks/lib/_approval_re.sh +33 -0
  687. package/ds-canonical/hooks/lib/_chrome_header_handcraft.sh +75 -0
  688. package/ds-canonical/hooks/lib/_code_quality.sh +73 -0
  689. package/ds-canonical/hooks/lib/_cva_default_sync.sh +69 -0
  690. package/ds-canonical/hooks/lib/_governance_coverage_check.sh +49 -0
  691. package/ds-canonical/hooks/lib/_hardcoded_strings.sh +163 -0
  692. package/ds-canonical/hooks/lib/_header_with_tabs_border.sh +87 -0
  693. package/ds-canonical/hooks/lib/_layout_space_canonical.sh +56 -0
  694. package/ds-canonical/hooks/lib/_overlay_handcraft.sh +162 -0
  695. package/ds-canonical/hooks/lib/_person_data_richness.sh +42 -0
  696. package/ds-canonical/hooks/lib/_story_compile_drift.sh +48 -0
  697. package/ds-canonical/hooks/lib/_tab_lg_chrome_header_equal.sh +70 -0
  698. package/ds-canonical/hooks/lib/_token_hygiene.sh +104 -0
  699. package/ds-canonical/hooks/log_governance_fires.sh +50 -0
  700. package/ds-canonical/hooks/log_skill_invokes.sh +41 -0
  701. package/ds-canonical/hooks/post_edit_dispatcher.sh +62 -0
  702. package/ds-canonical/hooks/retired/2026-06-11-prune-merge/check_addon_subdir_ship.sh +76 -0
  703. package/ds-canonical/hooks/retired/2026-06-11-prune-merge/check_consumer_app_story_title.sh +81 -0
  704. package/ds-canonical/hooks/retired/2026-06-11-prune-merge/check_consumer_ds_primitive_misuse.sh +120 -0
  705. package/ds-canonical/hooks/retired/2026-06-11-prune-merge/check_consumer_no_ds_catalog.sh +101 -0
  706. package/ds-canonical/hooks/retired/2026-06-11-prune-merge/check_consumer_story_baseline.sh +76 -0
  707. package/ds-canonical/hooks/retired/2026-06-11-prune-merge/check_data_table_size_num_to_meta_width.sh +68 -0
  708. package/ds-canonical/hooks/retired/2026-06-11-prune-merge/check_fork_user_plugin_install.sh +79 -0
  709. package/ds-canonical/hooks/retired/2026-06-11-prune-merge/check_plugin_freshness.sh +68 -0
  710. package/ds-canonical/hooks/retired/2026-06-11-prune-merge/check_propose_cite_required.sh +88 -0
  711. package/ds-canonical/hooks/retired/2026-06-11-prune-merge/check_propose_plain_chinese.sh +74 -0
  712. package/ds-canonical/hooks/retired/2026-06-11-prune-merge/check_storybook_addon_preset_cjs.sh +87 -0
  713. package/ds-canonical/hooks/retired/check_anatomy_section_numbering.sh +106 -0
  714. package/ds-canonical/hooks/retired/check_avatar_hovercard.sh +90 -0
  715. package/ds-canonical/hooks/retired/check_button_icon_literal.sh.retired-2026-04-28 +38 -0
  716. package/ds-canonical/hooks/retired/check_container_breathing.sh +142 -0
  717. package/ds-canonical/hooks/retired/check_governance_compliance.sh +61 -0
  718. package/ds-canonical/hooks/retired/check_icon_only_padding_formula.sh +104 -0
  719. package/ds-canonical/hooks/retired/check_item_content_primitive.sh +150 -0
  720. package/ds-canonical/hooks/retired/check_item_list_gap.sh +153 -0
  721. package/ds-canonical/hooks/retired/check_sideoffset_canonical.sh +65 -0
  722. package/ds-canonical/hooks/retired/check_spec_iteration_tag.sh +87 -0
  723. package/ds-canonical/hooks/retired/check_ssot_consultation.sh +88 -0
  724. package/ds-canonical/hooks/retired/check_sync_update.sh +20 -0
  725. package/ds-canonical/hooks/retired/check_third_party_dom_verified.sh +95 -0
  726. package/ds-canonical/hooks/retired/enforce_home_charter.sh +125 -0
  727. package/ds-canonical/hooks/retired/post_edit_canonical_interrogate.sh +109 -0
  728. package/ds-canonical/hooks/retired/pre_edit_spec_check.sh +68 -0
  729. package/ds-canonical/hooks/retired/pre_new_component_spec.sh +39 -0
  730. package/ds-canonical/hooks/retired/pre_write_subsumption_check.sh +112 -0
  731. package/ds-canonical/hooks/retired/stop_meta_self_audit.sh.retired-2026-05-13 +76 -0
  732. package/ds-canonical/hooks/retired/tests/test_check_anatomy_section_numbering.sh +14 -0
  733. package/ds-canonical/hooks/retired/tests/test_check_avatar_hovercard.sh +15 -0
  734. package/ds-canonical/hooks/retired/tests/test_check_container_breathing.sh +15 -0
  735. package/ds-canonical/hooks/retired/tests/test_check_governance_compliance.sh +15 -0
  736. package/ds-canonical/hooks/retired/tests/test_check_icon_only_padding_formula.sh +79 -0
  737. package/ds-canonical/hooks/retired/tests/test_check_item_content_primitive.sh +15 -0
  738. package/ds-canonical/hooks/retired/tests/test_check_item_list_gap.sh +163 -0
  739. package/ds-canonical/hooks/retired/tests/test_check_sideoffset_canonical.sh +15 -0
  740. package/ds-canonical/hooks/retired/tests/test_check_spec_iteration_tag.sh +15 -0
  741. package/ds-canonical/hooks/retired/tests/test_check_ssot_consultation.sh +15 -0
  742. package/ds-canonical/hooks/retired/tests/test_check_sync_update.sh +14 -0
  743. package/ds-canonical/hooks/retired/tests/test_check_third_party_dom_verified.sh +15 -0
  744. package/ds-canonical/hooks/retired/tests/test_enforce_home_charter.sh +15 -0
  745. package/ds-canonical/hooks/retired/tests/test_pre_edit_spec_check.sh +15 -0
  746. package/ds-canonical/hooks/retired/tests/test_pre_new_component_spec.sh +15 -0
  747. package/ds-canonical/hooks/retired/tests/test_pre_write_subsumption_check.sh +63 -0
  748. package/ds-canonical/hooks/session_start_governance_check.sh +310 -0
  749. package/ds-canonical/hooks/stop_passive_logging.sh +322 -0
  750. package/ds-canonical/hooks/stop_self_audit.sh +516 -0
  751. package/ds-canonical/hooks/tests/KNOWN-BROKEN.md +15 -0
  752. package/ds-canonical/hooks/tests/run-all.sh +76 -0
  753. package/ds-canonical/hooks/tests/test_auto_regen_ds_barrel.sh +180 -0
  754. package/ds-canonical/hooks/tests/test_block_prototype_imports.sh +143 -0
  755. package/ds-canonical/hooks/tests/test_check_addon_subdir_ship.sh +171 -0
  756. package/ds-canonical/hooks/tests/test_check_app_shell_primary_header_consistency.sh +196 -0
  757. package/ds-canonical/hooks/tests/test_check_audit_post_report_validator.sh +127 -0
  758. package/ds-canonical/hooks/tests/test_check_audit_sample_escape.sh +93 -0
  759. package/ds-canonical/hooks/tests/test_check_benchmark_citation.sh +115 -0
  760. package/ds-canonical/hooks/tests/test_check_canonical_propagation.sh +133 -0
  761. package/ds-canonical/hooks/tests/test_check_chrome_header_avatar_canonical.sh +198 -0
  762. package/ds-canonical/hooks/tests/test_check_chrome_header_handcraft.sh +146 -0
  763. package/ds-canonical/hooks/tests/test_check_code_quality.sh +15 -0
  764. package/ds-canonical/hooks/tests/test_check_codex_brief_invariants.sh +208 -0
  765. package/ds-canonical/hooks/tests/test_check_codex_collab_5step.sh +96 -0
  766. package/ds-canonical/hooks/tests/test_check_consumer_app_invariants.sh +12 -0
  767. package/ds-canonical/hooks/tests/test_check_consumer_app_story_title.sh +164 -0
  768. package/ds-canonical/hooks/tests/test_check_consumer_ds_primitive_misuse.sh +240 -0
  769. package/ds-canonical/hooks/tests/test_check_consumer_no_ds_catalog.sh +214 -0
  770. package/ds-canonical/hooks/tests/test_check_consumer_story_baseline.sh +202 -0
  771. package/ds-canonical/hooks/tests/test_check_cva_default_sync.sh +15 -0
  772. package/ds-canonical/hooks/tests/test_check_data_table_size_num_to_meta_width.sh +53 -0
  773. package/ds-canonical/hooks/tests/test_check_datatable_invariants.sh +122 -0
  774. package/ds-canonical/hooks/tests/test_check_dim_count_drift.sh +98 -0
  775. package/ds-canonical/hooks/tests/test_check_ds_anchor_preflight.sh +104 -0
  776. package/ds-canonical/hooks/tests/test_check_escape_marker_abuse.sh +192 -0
  777. package/ds-canonical/hooks/tests/test_check_field_controls_contracts.sh +126 -0
  778. package/ds-canonical/hooks/tests/test_check_field_family_invariants.sh +203 -0
  779. package/ds-canonical/hooks/tests/test_check_file_size_budget.sh +32 -0
  780. package/ds-canonical/hooks/tests/test_check_fork_user_plugin_install.sh +46 -0
  781. package/ds-canonical/hooks/tests/test_check_full_story_visual_interaction_sweep.sh +190 -0
  782. package/ds-canonical/hooks/tests/test_check_hardcoded_strings.sh +14 -0
  783. package/ds-canonical/hooks/tests/test_check_header_with_tabs_border.sh +110 -0
  784. package/ds-canonical/hooks/tests/test_check_item_list_gap.sh +44 -0
  785. package/ds-canonical/hooks/tests/test_check_layout_space_canonical.sh +73 -0
  786. package/ds-canonical/hooks/tests/test_check_layout_space_magic_numbers.sh +206 -0
  787. package/ds-canonical/hooks/tests/test_check_main_branch_workbench.sh +147 -0
  788. package/ds-canonical/hooks/tests/test_check_naming_and_abstraction.sh +136 -0
  789. package/ds-canonical/hooks/tests/test_check_opacity_token_usage.sh +110 -0
  790. package/ds-canonical/hooks/tests/test_check_orphan_ds_css.sh +212 -0
  791. package/ds-canonical/hooks/tests/test_check_overlay_handcraft.sh +126 -0
  792. package/ds-canonical/hooks/tests/test_check_overlay_open_focus_escape_probe.sh +191 -0
  793. package/ds-canonical/hooks/tests/test_check_pattern_invariants.sh +148 -0
  794. package/ds-canonical/hooks/tests/test_check_peoplepicker_ssot_drift.sh +108 -0
  795. package/ds-canonical/hooks/tests/test_check_person_data_richness.sh +58 -0
  796. package/ds-canonical/hooks/tests/test_check_pixel_quantified_audit.sh +142 -0
  797. package/ds-canonical/hooks/tests/test_check_plugin_fork_health.sh +9 -0
  798. package/ds-canonical/hooks/tests/test_check_propose_cite_required.sh +181 -0
  799. package/ds-canonical/hooks/tests/test_check_propose_discipline.sh +10 -0
  800. package/ds-canonical/hooks/tests/test_check_propose_plain_chinese.sh +127 -0
  801. package/ds-canonical/hooks/tests/test_check_propose_pre_grep_verify.sh +117 -0
  802. package/ds-canonical/hooks/tests/test_check_propose_without_benchmark.sh +55 -0
  803. package/ds-canonical/hooks/tests/test_check_select_all_canonical.sh +125 -0
  804. package/ds-canonical/hooks/tests/test_check_sidebar_menu_button_implicit_wrap.sh +224 -0
  805. package/ds-canonical/hooks/tests/test_check_solo_workflow.sh +201 -0
  806. package/ds-canonical/hooks/tests/test_check_spec_class_drift.sh +135 -0
  807. package/ds-canonical/hooks/tests/test_check_story_anatomy.sh.broken +197 -0
  808. package/ds-canonical/hooks/tests/test_check_story_category.sh.broken +187 -0
  809. package/ds-canonical/hooks/tests/test_check_story_compile_drift.sh +15 -0
  810. package/ds-canonical/hooks/tests/test_check_story_invariants.sh +384 -0
  811. package/ds-canonical/hooks/tests/test_check_story_name_jargon.sh.broken +53 -0
  812. package/ds-canonical/hooks/tests/test_check_story_slot_split.sh +156 -0
  813. package/ds-canonical/hooks/tests/test_check_storybook_addon_packaging.sh +10 -0
  814. package/ds-canonical/hooks/tests/test_check_storybook_addon_preset_cjs.sh +200 -0
  815. package/ds-canonical/hooks/tests/test_check_substantive_edit_approval_preflight.sh +176 -0
  816. package/ds-canonical/hooks/tests/test_check_tab_lg_chrome_header_equal.sh +141 -0
  817. package/ds-canonical/hooks/tests/test_check_tailwind_wildcard_in_docs.sh +182 -0
  818. package/ds-canonical/hooks/tests/test_check_token_hygiene.sh +21 -0
  819. package/ds-canonical/hooks/tests/test_check_wrapper_primitive_schema_drift.sh +169 -0
  820. package/ds-canonical/hooks/tests/test_enforce_home_charter.sh +77 -0
  821. package/ds-canonical/hooks/tests/test_inject_deploy_url_after_push.sh +193 -0
  822. package/ds-canonical/hooks/tests/test_inject_pending_self_audit.sh +125 -0
  823. package/ds-canonical/hooks/tests/test_log_governance_fires.sh +10 -0
  824. package/ds-canonical/hooks/tests/test_log_skill_invokes.sh +7 -0
  825. package/ds-canonical/hooks/tests/test_post_edit_dispatcher.sh +108 -0
  826. package/ds-canonical/hooks/tests/test_session_start_governance_check.sh +154 -0
  827. package/ds-canonical/hooks/tests/test_stop_capture_metrics.sh +95 -0
  828. package/ds-canonical/hooks/tests/test_stop_governance_drift_check.sh.broken +125 -0
  829. package/ds-canonical/hooks/tests/test_stop_harvest_corrections.sh +10 -0
  830. package/ds-canonical/hooks/tests/test_stop_passive_logging.sh +100 -0
  831. package/ds-canonical/hooks/tests/test_stop_self_audit.sh +98 -0
  832. package/ds-canonical/hooks/tests/test_stop_tsc_sanity.sh +10 -0
  833. package/ds-canonical/references/README.md +46 -0
  834. package/ds-canonical/references/audit-coverage-vs-24-checklist.md +74 -0
  835. package/ds-canonical/references/build-ui-canonicals.md +72 -0
  836. package/ds-canonical/references/composition-fidelity.md +47 -0
  837. package/ds-canonical/references/cva-patterns.md +41 -0
  838. package/ds-canonical/references/drag-canonical.md +331 -0
  839. package/ds-canonical/references/item-anatomy-recipe.md +225 -0
  840. package/ds-canonical/references/naming-conventions.md +57 -0
  841. package/ds-canonical/references/principle-dim-map.json +613 -0
  842. package/ds-canonical/references/props-naming.md +59 -0
  843. package/ds-canonical/references/scenario-definition.md +146 -0
  844. package/ds-canonical/references/spec-rules.md +58 -0
  845. package/ds-canonical/references/ssot-consultation.md +63 -0
  846. package/ds-canonical/references/ssot-index.md +40 -0
  847. package/ds-canonical/references/story-baseline-registry.json +108 -0
  848. package/ds-canonical/references/structural-token-retention.md +42 -0
  849. package/ds-canonical/references/tailwind-gotchas.md +87 -0
  850. package/ds-canonical/references/ui-dev-rules.md +81 -0
  851. package/ds-canonical/rules/README.md +34 -0
  852. package/ds-canonical/rules/meta-patterns.md +87 -0
  853. package/ds-canonical/rules/self-verify.md +56 -0
  854. package/ds-canonical/rules/spec-rules.md +25 -0
  855. package/ds-canonical/rules/story-rules.md +67 -0
  856. package/ds-canonical/rules/ui-development.md +92 -0
  857. package/ds-canonical/skills/README.md +88 -0
  858. package/ds-canonical/skills/bug-fix-rhythm/SKILL.md +181 -0
  859. package/ds-canonical/skills/code-quality-audit/SKILL.md +63 -0
  860. package/ds-canonical/skills/codex-collab/SKILL.md +249 -0
  861. package/ds-canonical/skills/codex-collab/references/brief-template.md +48 -0
  862. package/ds-canonical/skills/codex-collab/references/transport.md +58 -0
  863. package/ds-canonical/skills/codify-corrections/SKILL.md +184 -0
  864. package/ds-canonical/skills/codify-principle/SKILL.md +151 -0
  865. package/ds-canonical/skills/component-quality-gate/SKILL.md +102 -0
  866. package/ds-canonical/skills/component-quality-gate/references/checklist.md +79 -0
  867. package/ds-canonical/skills/deep-audit-cross-codex/SKILL.md +254 -0
  868. package/ds-canonical/skills/deep-audit-cross-codex/references/phase-a-workflow.md +123 -0
  869. package/ds-canonical/skills/deep-audit-cross-codex/references/phase-b-codex-brief.md +186 -0
  870. package/ds-canonical/skills/deep-audit-cross-codex/references/skill-relationships-antipatterns-benchmarks.md +30 -0
  871. package/ds-canonical/skills/deep-audit-cross-codex/references/triage-rubric.md +69 -0
  872. package/ds-canonical/skills/deep-audit-cross-codex/references/upstream-directives-r-mapping.md +33 -0
  873. package/ds-canonical/skills/delivery-handoff/SKILL.md +229 -0
  874. package/ds-canonical/skills/delivery-handoff/references/flow-diagram.md +180 -0
  875. package/ds-canonical/skills/delivery-handoff/references/handoff-template.md +177 -0
  876. package/ds-canonical/skills/delivery-handoff/references/inventory-checklist.md +196 -0
  877. package/ds-canonical/skills/design-system-audit/SKILL.md +386 -0
  878. package/ds-canonical/skills/design-system-audit/references/audit-prompts.md +1325 -0
  879. package/ds-canonical/skills/design-system-audit/references/checkpoints.md +240 -0
  880. package/ds-canonical/skills/design-system-audit/references/historical-bugs.md +240 -0
  881. package/ds-canonical/skills/design-system-audit/references/principle-audit-protocol.md +378 -0
  882. package/ds-canonical/skills/design-system-audit/references/rule-placement.md +175 -0
  883. package/ds-canonical/skills/ensure-canonical/SKILL.md +196 -0
  884. package/ds-canonical/skills/governance-health/SKILL.md +147 -0
  885. package/ds-canonical/skills/knowledge-prune/SKILL.md +250 -0
  886. package/ds-canonical/skills/knowledge-prune/references/phase-z-cross-repo-ssot-propagation.md +11 -0
  887. package/ds-canonical/skills/knowledge-prune/references/prune-dimensions-d5-d10.md +55 -0
  888. package/ds-canonical/skills/knowledge-prune/references/world-class-prune-alignment.md +7 -0
  889. package/ds-canonical/skills/new-component/SKILL.md +170 -0
  890. package/ds-canonical/skills/new-component/references/new-component-checklist.md +85 -0
  891. package/ds-canonical/skills/performance-audit/SKILL.md +107 -0
  892. package/ds-canonical/skills/product-ui-audit/SKILL.md +230 -0
  893. package/ds-canonical/skills/product-ui-audit/references/audit-checks.md +246 -0
  894. package/ds-canonical/skills/product-ui-audit/references/common-misuses.md +329 -0
  895. package/ds-canonical/skills/product-ui-audit/references/report-template.md +159 -0
  896. package/ds-canonical/skills/propose-options/SKILL.md +177 -0
  897. package/ds-canonical/skills/prototype/SKILL.md +244 -0
  898. package/ds-canonical/skills/prototype/references/audit-checks.md +37 -0
  899. package/ds-canonical/skills/prototype/references/benchmark-sources.md +94 -0
  900. package/ds-canonical/skills/prototype/references/checkpoints.md +191 -0
  901. package/ds-canonical/skills/prototype/references/evaluation-matrix.md +141 -0
  902. package/ds-canonical/skills/prototype/references/ooux-template.md +198 -0
  903. package/ds-canonical/skills/prototype/references/proposal-template.md +229 -0
  904. package/ds-canonical/skills/scan-similar-bugs/SKILL.md +198 -0
  905. package/ds-canonical/skills/story-auto-compile-migrate/SKILL.md +159 -0
  906. package/ds-canonical/skills/story-writing/SKILL.md +122 -0
  907. package/ds-canonical/skills/story-writing/references/anatomy-standard.md +217 -0
  908. package/ds-canonical/skills/story-writing/references/category-templates.md +174 -0
  909. package/ds-canonical/skills/story-writing/references/example-selection.md +70 -0
  910. package/ds-canonical/skills/story-writing/references/self-check.md +20 -0
  911. package/ds-canonical/skills/ux-audit/SKILL.md +130 -0
  912. package/ds-canonical/skills/visual-audit/SKILL.md +245 -0
  913. package/ds-canonical/skills/visual-audit/output/.gitkeep +0 -0
  914. package/ds-canonical/skills/visual-audit/references/audit-architecture.md +100 -0
  915. package/ds-canonical/skills/visual-audit/references/visual-checklist.md +297 -0
  916. package/ds-canonical/skills/visual-audit/references/world-class-benchmarks.md +198 -0
  917. package/ds-canonical/templates/_README.md +23 -0
  918. package/ds-canonical/templates/dashboard-app.tsx +161 -0
  919. package/ds-story-manifest.json +1684 -0
  920. package/llms-full.txt +419 -0
  921. package/llms.txt +71 -0
  922. package/package.json +31 -8
  923. package/src/components/Accordion/accordion.anatomy.stories.tsx +496 -0
  924. package/src/components/Accordion/accordion.principles.stories.tsx +360 -0
  925. package/src/components/Accordion/accordion.spec.md +131 -0
  926. package/src/components/Accordion/accordion.stories.tsx +190 -0
  927. package/src/components/Accordion/accordion.tsx +4 -1
  928. package/src/components/Accordion/index.ts +5 -0
  929. package/src/components/Alert/alert.anatomy.stories.tsx +241 -0
  930. package/src/components/Alert/alert.principles.stories.tsx +220 -0
  931. package/src/components/Alert/alert.spec.md +202 -0
  932. package/src/components/Alert/alert.stories.tsx +139 -0
  933. package/src/components/Alert/alert.tsx +18 -7
  934. package/src/components/Alert/index.ts +5 -0
  935. package/src/components/AppShell/_demo-helpers.tsx +87 -11
  936. package/src/components/AppShell/app-shell.anatomy.stories.tsx +179 -0
  937. package/src/components/AppShell/app-shell.principles.stories.tsx +140 -0
  938. package/src/components/AppShell/app-shell.spec.md +358 -0
  939. package/src/components/AppShell/app-shell.stories.tsx +442 -0
  940. package/src/components/AppShell/app-shell.tsx +16 -10
  941. package/src/components/AppShell/index.ts +5 -0
  942. package/src/components/AspectRatio/aspect-ratio.anatomy.stories.tsx +208 -0
  943. package/src/components/AspectRatio/aspect-ratio.principles.stories.tsx +303 -0
  944. package/src/components/AspectRatio/aspect-ratio.spec.md +147 -0
  945. package/src/components/AspectRatio/aspect-ratio.stories.tsx +170 -0
  946. package/src/components/AspectRatio/aspect-ratio.tsx +6 -3
  947. package/src/components/AspectRatio/index.ts +5 -0
  948. package/src/components/Avatar/avatar.anatomy.stories.tsx +701 -0
  949. package/src/components/Avatar/avatar.principles.stories.tsx +245 -0
  950. package/src/components/Avatar/avatar.spec.md +312 -0
  951. package/src/components/Avatar/avatar.stories.tsx +135 -0
  952. package/src/components/Avatar/avatar.tsx +61 -54
  953. package/src/components/Avatar/index.ts +5 -0
  954. package/src/components/Badge/badge.anatomy.stories.tsx +591 -0
  955. package/src/components/Badge/badge.principles.stories.tsx +391 -0
  956. package/src/components/Badge/badge.spec.md +398 -0
  957. package/src/components/Badge/badge.stories.tsx +80 -0
  958. package/src/components/Badge/badge.tsx +38 -14
  959. package/src/components/Badge/index.ts +5 -0
  960. package/src/components/Breadcrumb/breadcrumb.anatomy.stories.tsx +458 -0
  961. package/src/components/Breadcrumb/breadcrumb.principles.stories.tsx +348 -0
  962. package/src/components/Breadcrumb/breadcrumb.spec.md +270 -0
  963. package/src/components/Breadcrumb/breadcrumb.stories.tsx +307 -0
  964. package/src/components/Breadcrumb/breadcrumb.tsx +12 -6
  965. package/src/components/Breadcrumb/index.ts +5 -0
  966. package/src/components/BulkActionBar/bulk-action-bar.anatomy.stories.tsx +225 -0
  967. package/src/components/BulkActionBar/bulk-action-bar.principles.stories.tsx +242 -0
  968. package/src/components/BulkActionBar/bulk-action-bar.spec.md +227 -0
  969. package/src/components/BulkActionBar/bulk-action-bar.stories.tsx +136 -0
  970. package/src/components/BulkActionBar/bulk-action-bar.tsx +14 -12
  971. package/src/components/BulkActionBar/index.ts +5 -0
  972. package/src/components/Button/button.anatomy.stories.tsx +710 -0
  973. package/src/components/Button/button.principles.stories.tsx +370 -0
  974. package/src/components/Button/button.spec.md +463 -0
  975. package/src/components/Button/button.stories.tsx +362 -0
  976. package/src/components/Button/button.tsx +86 -52
  977. package/src/components/Button/index.ts +6 -0
  978. package/src/components/Calendar/calendar.anatomy.stories.tsx +218 -0
  979. package/src/components/Calendar/calendar.principles.stories.tsx +143 -0
  980. package/src/components/Calendar/calendar.spec.md +270 -0
  981. package/src/components/Calendar/calendar.stories.tsx +88 -0
  982. package/src/components/Calendar/calendar.tsx +54 -40
  983. package/src/components/Calendar/index.ts +5 -0
  984. package/src/components/Carousel/carousel.anatomy.stories.tsx +516 -0
  985. package/src/components/Carousel/carousel.principles.stories.tsx +330 -0
  986. package/src/components/Carousel/carousel.spec.md +273 -0
  987. package/src/components/Carousel/carousel.stories.tsx +121 -0
  988. package/src/components/Carousel/carousel.tsx +27 -7
  989. package/src/components/Carousel/index.ts +5 -0
  990. package/src/components/Chart/chart.anatomy.stories.tsx +307 -0
  991. package/src/components/Chart/chart.principles.stories.tsx +436 -0
  992. package/src/components/Chart/chart.spec.md +174 -0
  993. package/src/components/Chart/chart.stories.tsx +268 -0
  994. package/src/components/Chart/chart.tsx +7 -3
  995. package/src/components/Chart/index.ts +5 -0
  996. package/src/components/Checkbox/checkbox-group.tsx +2 -1
  997. package/src/components/Checkbox/checkbox.anatomy.stories.tsx +626 -0
  998. package/src/components/Checkbox/checkbox.principles.stories.tsx +216 -0
  999. package/src/components/Checkbox/checkbox.spec.md +372 -0
  1000. package/src/components/Checkbox/checkbox.stories.tsx +114 -0
  1001. package/src/components/Checkbox/checkbox.tsx +115 -24
  1002. package/src/components/Checkbox/index.ts +6 -0
  1003. package/src/components/Chip/chip.anatomy.stories.tsx +422 -0
  1004. package/src/components/Chip/chip.principles.stories.tsx +228 -0
  1005. package/src/components/Chip/chip.spec.md +237 -0
  1006. package/src/components/Chip/chip.stories.tsx +88 -0
  1007. package/src/components/Chip/chip.tsx +10 -10
  1008. package/src/components/Chip/index.ts +5 -0
  1009. package/src/components/CircularProgress/circular-progress.anatomy.stories.tsx +176 -0
  1010. package/src/components/CircularProgress/circular-progress.principles.stories.tsx +260 -0
  1011. package/src/components/CircularProgress/circular-progress.spec.md +269 -0
  1012. package/src/components/CircularProgress/circular-progress.stories.tsx +145 -0
  1013. package/src/components/CircularProgress/circular-progress.tsx +4 -5
  1014. package/src/components/CircularProgress/index.ts +5 -0
  1015. package/src/components/Coachmark/coachmark-story-helpers.tsx +39 -0
  1016. package/src/components/Coachmark/coachmark.anatomy.stories.tsx +356 -0
  1017. package/src/components/Coachmark/coachmark.principles.stories.tsx +355 -0
  1018. package/src/components/Coachmark/coachmark.spec.md +238 -0
  1019. package/src/components/Coachmark/coachmark.stories.tsx +214 -0
  1020. package/src/components/Coachmark/coachmark.tsx +26 -9
  1021. package/src/components/Coachmark/index.ts +5 -0
  1022. package/src/components/Combobox/combobox.anatomy.stories.tsx +919 -0
  1023. package/src/components/Combobox/combobox.principles.stories.tsx +239 -0
  1024. package/src/components/Combobox/combobox.spec.md +202 -0
  1025. package/src/components/Combobox/combobox.stories.tsx +184 -0
  1026. package/src/components/Combobox/combobox.tsx +109 -55
  1027. package/src/components/Combobox/index.ts +5 -0
  1028. package/src/components/Command/command.anatomy.stories.tsx +107 -0
  1029. package/src/components/Command/command.principles.stories.tsx +86 -0
  1030. package/src/components/Command/command.spec.md +181 -0
  1031. package/src/components/Command/command.stories.tsx +280 -0
  1032. package/src/components/Command/command.tsx +14 -9
  1033. package/src/components/Command/index.ts +5 -0
  1034. package/src/components/DataTable/active-editor-controller.ts +4 -3
  1035. package/src/components/DataTable/cell-registry.tsx +27 -6
  1036. package/src/components/DataTable/data-table-filter-panel.tsx +16 -10
  1037. package/src/components/DataTable/data-table-interaction-layer.tsx +8 -7
  1038. package/src/components/DataTable/data-table-sort-manager.tsx +4 -4
  1039. package/src/components/DataTable/data-table.anatomy.stories.tsx +519 -0
  1040. package/src/components/DataTable/data-table.css +3 -3
  1041. package/src/components/DataTable/data-table.principles.stories.tsx +265 -0
  1042. package/src/components/DataTable/data-table.spec.md +540 -0
  1043. package/src/components/DataTable/data-table.stories.tsx +1942 -0
  1044. package/src/components/DataTable/data-table.tsx +323 -104
  1045. package/src/components/DataTable/filter-operators.spec.md +267 -0
  1046. package/src/components/DataTable/filter-operators.ts +1 -1
  1047. package/src/components/DataTable/filter-tree.ts +34 -11
  1048. package/src/components/DataTable/index.ts +5 -0
  1049. package/src/components/DateGrid/date-grid.anatomy.stories.tsx +583 -0
  1050. package/src/components/DateGrid/date-grid.principles.stories.tsx +338 -0
  1051. package/src/components/DateGrid/date-grid.spec.md +220 -0
  1052. package/src/components/DateGrid/date-grid.stories.tsx +195 -0
  1053. package/src/components/DateGrid/date-grid.tsx +29 -23
  1054. package/src/components/DateGrid/index.ts +5 -0
  1055. package/src/components/DatePicker/date-picker.anatomy.stories.tsx +952 -0
  1056. package/src/components/DatePicker/date-picker.principles.stories.tsx +205 -0
  1057. package/src/components/DatePicker/date-picker.spec.md +338 -0
  1058. package/src/components/DatePicker/date-picker.stories.tsx +342 -0
  1059. package/src/components/DatePicker/date-picker.tsx +79 -34
  1060. package/src/components/DatePicker/index.ts +5 -0
  1061. package/src/components/DescriptionList/description-list.anatomy.stories.tsx +252 -0
  1062. package/src/components/DescriptionList/description-list.principles.stories.tsx +309 -0
  1063. package/src/components/DescriptionList/description-list.spec.md +220 -0
  1064. package/src/components/DescriptionList/description-list.stories.tsx +112 -0
  1065. package/src/components/DescriptionList/description-list.tsx +3 -3
  1066. package/src/components/DescriptionList/index.ts +5 -0
  1067. package/src/components/Dialog/dialog.anatomy.stories.tsx +484 -0
  1068. package/src/components/Dialog/dialog.principles.stories.tsx +313 -0
  1069. package/src/components/Dialog/dialog.spec.md +216 -0
  1070. package/src/components/Dialog/dialog.stories.tsx +483 -0
  1071. package/src/components/Dialog/dialog.tsx +11 -10
  1072. package/src/components/Dialog/index.ts +5 -0
  1073. package/src/components/DropdownMenu/dropdown-menu.anatomy.stories.tsx +971 -0
  1074. package/src/components/DropdownMenu/dropdown-menu.principles.stories.tsx +339 -0
  1075. package/src/components/DropdownMenu/dropdown-menu.spec.md +262 -0
  1076. package/src/components/DropdownMenu/dropdown-menu.stories.tsx +286 -0
  1077. package/src/components/DropdownMenu/dropdown-menu.tsx +39 -9
  1078. package/src/components/DropdownMenu/index.ts +5 -0
  1079. package/src/components/Empty/empty.anatomy.stories.tsx +275 -0
  1080. package/src/components/Empty/empty.principles.stories.tsx +314 -0
  1081. package/src/components/Empty/empty.spec.md +217 -0
  1082. package/src/components/Empty/empty.stories.tsx +69 -0
  1083. package/src/components/Empty/empty.tsx +16 -7
  1084. package/src/components/Empty/index.ts +5 -0
  1085. package/src/components/Field/field-context.ts +98 -0
  1086. package/src/components/Field/field-controls.spec.md +383 -0
  1087. package/src/components/Field/field-types.ts +1 -1
  1088. package/src/components/Field/field-wrapper.tsx +34 -14
  1089. package/src/components/Field/field.anatomy.stories.tsx +544 -0
  1090. package/src/components/Field/field.principles.stories.tsx +278 -0
  1091. package/src/components/Field/field.spec.md +462 -0
  1092. package/src/components/Field/field.stories.tsx +716 -0
  1093. package/src/components/Field/field.tsx +12 -5
  1094. package/src/components/Field/form-validation.spec.md +175 -0
  1095. package/src/components/Field/index.ts +5 -0
  1096. package/src/components/Field/use-form-validation.ts +266 -0
  1097. package/src/components/FieldControlGroup/field-control-group.anatomy.stories.tsx +119 -0
  1098. package/src/components/FieldControlGroup/field-control-group.principles.stories.tsx +121 -0
  1099. package/src/components/FieldControlGroup/field-control-group.spec.md +195 -0
  1100. package/src/components/FieldControlGroup/field-control-group.stories.tsx +161 -0
  1101. package/src/components/FieldControlGroup/field-control-group.tsx +12 -11
  1102. package/src/components/FieldControlGroup/index.ts +5 -0
  1103. package/src/components/FileItem/file-item.anatomy.stories.tsx +346 -0
  1104. package/src/components/FileItem/file-item.principles.stories.tsx +276 -0
  1105. package/src/components/FileItem/file-item.spec.md +491 -0
  1106. package/src/components/FileItem/file-item.stories.tsx +265 -0
  1107. package/src/components/FileItem/file-item.tsx +40 -15
  1108. package/src/components/FileItem/index.ts +5 -0
  1109. package/src/components/FileUpload/file-upload.anatomy.stories.tsx +446 -0
  1110. package/src/components/FileUpload/file-upload.principles.stories.tsx +312 -0
  1111. package/src/components/FileUpload/file-upload.spec.md +166 -0
  1112. package/src/components/FileUpload/file-upload.stories.tsx +167 -0
  1113. package/src/components/FileUpload/file-upload.tsx +97 -31
  1114. package/src/components/FileUpload/index.ts +5 -0
  1115. package/src/components/FileViewer/file-viewer.anatomy.stories.tsx +1129 -0
  1116. package/src/components/FileViewer/file-viewer.principles.stories.tsx +636 -0
  1117. package/src/components/FileViewer/file-viewer.spec.md +368 -0
  1118. package/src/components/FileViewer/file-viewer.stories.tsx +407 -0
  1119. package/src/components/FileViewer/file-viewer.tsx +62 -31
  1120. package/src/components/FileViewer/index.ts +5 -0
  1121. package/src/components/HoverCard/hover-card.anatomy.stories.tsx +145 -0
  1122. package/src/components/HoverCard/hover-card.principles.stories.tsx +222 -0
  1123. package/src/components/HoverCard/hover-card.spec.md +167 -0
  1124. package/src/components/HoverCard/hover-card.stories.tsx +304 -0
  1125. package/src/components/HoverCard/hover-card.tsx +15 -4
  1126. package/src/components/HoverCard/index.ts +5 -0
  1127. package/src/components/Input/index.ts +5 -0
  1128. package/src/components/Input/input.anatomy.stories.tsx +763 -0
  1129. package/src/components/Input/input.principles.stories.tsx +265 -0
  1130. package/src/components/Input/input.spec.md +207 -0
  1131. package/src/components/Input/input.stories.tsx +139 -0
  1132. package/src/components/Input/input.tsx +18 -19
  1133. package/src/components/LinkInput/index.ts +5 -0
  1134. package/src/components/LinkInput/link-input.anatomy.stories.tsx +748 -0
  1135. package/src/components/LinkInput/link-input.principles.stories.tsx +182 -0
  1136. package/src/components/LinkInput/link-input.spec.md +144 -0
  1137. package/src/components/LinkInput/link-input.stories.tsx +132 -0
  1138. package/src/components/LinkInput/link-input.tsx +53 -40
  1139. package/src/components/Menu/index.ts +5 -0
  1140. package/src/components/Menu/menu-item.anatomy.stories.tsx +780 -0
  1141. package/src/components/Menu/menu-item.principles.stories.tsx +81 -0
  1142. package/src/components/Menu/menu-item.spec.md +305 -0
  1143. package/src/components/Menu/menu-item.stories.tsx +214 -0
  1144. package/src/components/Menu/menu-item.tsx +11 -4
  1145. package/src/components/Notice/index.ts +5 -0
  1146. package/src/components/Notice/notice.anatomy.stories.tsx +615 -0
  1147. package/src/components/Notice/notice.principles.stories.tsx +102 -0
  1148. package/src/components/Notice/notice.spec.md +159 -0
  1149. package/src/components/Notice/notice.stories.tsx +257 -0
  1150. package/src/components/Notice/notice.tsx +47 -14
  1151. package/src/components/NumberInput/index.ts +5 -0
  1152. package/src/components/NumberInput/number-input.anatomy.stories.tsx +788 -0
  1153. package/src/components/NumberInput/number-input.principles.stories.tsx +200 -0
  1154. package/src/components/NumberInput/number-input.spec.md +145 -0
  1155. package/src/components/NumberInput/number-input.stories.tsx +142 -0
  1156. package/src/components/NumberInput/number-input.tsx +32 -18
  1157. package/src/components/OverflowIndicator/index.ts +5 -0
  1158. package/src/components/OverflowIndicator/overflow-indicator.anatomy.stories.tsx +549 -0
  1159. package/src/components/OverflowIndicator/overflow-indicator.principles.stories.tsx +77 -0
  1160. package/src/components/OverflowIndicator/overflow-indicator.spec.md +127 -0
  1161. package/src/components/OverflowIndicator/overflow-indicator.stories.tsx +238 -0
  1162. package/src/components/OverflowIndicator/overflow-indicator.tsx +21 -7
  1163. package/src/components/PeoplePicker/index.ts +5 -0
  1164. package/src/components/PeoplePicker/people-picker-helpers.ts +5 -5
  1165. package/src/components/PeoplePicker/people-picker.anatomy.stories.tsx +427 -0
  1166. package/src/components/PeoplePicker/people-picker.principles.stories.tsx +192 -0
  1167. package/src/components/PeoplePicker/people-picker.spec.md +292 -0
  1168. package/src/components/PeoplePicker/people-picker.stories.tsx +162 -0
  1169. package/src/components/PeoplePicker/people-picker.tsx +92 -74
  1170. package/src/components/PeoplePicker/person-display.tsx +35 -32
  1171. package/src/components/Popover/index.ts +5 -0
  1172. package/src/components/Popover/popover.anatomy.stories.tsx +279 -0
  1173. package/src/components/Popover/popover.principles.stories.tsx +295 -0
  1174. package/src/components/Popover/popover.spec.md +207 -0
  1175. package/src/components/Popover/popover.stories.tsx +116 -0
  1176. package/src/components/Popover/popover.tsx +19 -16
  1177. package/src/components/ProfileCard/index.ts +5 -0
  1178. package/src/components/ProfileCard/profile-card.anatomy.stories.tsx +504 -0
  1179. package/src/components/ProfileCard/profile-card.principles.stories.tsx +225 -0
  1180. package/src/components/ProfileCard/profile-card.spec.md +190 -0
  1181. package/src/components/ProfileCard/profile-card.stories.tsx +53 -0
  1182. package/src/components/{NameCard/name-card.tsx → ProfileCard/profile-card.tsx} +39 -30
  1183. package/src/components/ProgressBar/index.ts +5 -0
  1184. package/src/components/ProgressBar/progress-bar.anatomy.stories.tsx +438 -0
  1185. package/src/components/ProgressBar/progress-bar.principles.stories.tsx +339 -0
  1186. package/src/components/ProgressBar/progress-bar.spec.md +240 -0
  1187. package/src/components/ProgressBar/progress-bar.stories.tsx +119 -0
  1188. package/src/components/ProgressBar/progress-bar.tsx +4 -4
  1189. package/src/components/RadioGroup/index.ts +5 -0
  1190. package/src/components/RadioGroup/radio-group.anatomy.stories.tsx +681 -0
  1191. package/src/components/RadioGroup/radio-group.principles.stories.tsx +163 -0
  1192. package/src/components/RadioGroup/radio-group.spec.md +149 -0
  1193. package/src/components/RadioGroup/radio-group.stories.tsx +103 -0
  1194. package/src/components/RadioGroup/radio-group.tsx +150 -60
  1195. package/src/components/Rating/index.ts +5 -0
  1196. package/src/components/Rating/rating.anatomy.stories.tsx +498 -0
  1197. package/src/components/Rating/rating.principles.stories.tsx +296 -0
  1198. package/src/components/Rating/rating.spec.md +214 -0
  1199. package/src/components/Rating/rating.stories.tsx +133 -0
  1200. package/src/components/Rating/rating.tsx +32 -17
  1201. package/src/components/ScrollArea/index.ts +5 -0
  1202. package/src/components/ScrollArea/scroll-area.anatomy.stories.tsx +451 -0
  1203. package/src/components/ScrollArea/scroll-area.principles.stories.tsx +331 -0
  1204. package/src/components/ScrollArea/scroll-area.spec.md +144 -0
  1205. package/src/components/ScrollArea/scroll-area.stories.tsx +243 -0
  1206. package/src/components/ScrollArea/scroll-area.tsx +3 -3
  1207. package/src/components/SegmentedControl/index.ts +5 -0
  1208. package/src/components/SegmentedControl/segmented-control.anatomy.stories.tsx +295 -0
  1209. package/src/components/SegmentedControl/segmented-control.principles.stories.tsx +281 -0
  1210. package/src/components/SegmentedControl/segmented-control.spec.md +297 -0
  1211. package/src/components/SegmentedControl/segmented-control.stories.tsx +33 -0
  1212. package/src/components/SegmentedControl/segmented-control.tsx +25 -16
  1213. package/src/components/Select/index.ts +5 -0
  1214. package/src/components/Select/select.anatomy.stories.tsx +828 -0
  1215. package/src/components/Select/select.principles.stories.tsx +311 -0
  1216. package/src/components/Select/select.spec.md +338 -0
  1217. package/src/components/Select/select.stories.tsx +198 -0
  1218. package/src/components/Select/select.tsx +72 -30
  1219. package/src/components/SelectMenu/index.ts +5 -0
  1220. package/src/components/SelectMenu/select-menu.anatomy.stories.tsx +812 -0
  1221. package/src/components/SelectMenu/select-menu.principles.stories.tsx +107 -0
  1222. package/src/components/SelectMenu/select-menu.spec.md +232 -0
  1223. package/src/components/SelectMenu/select-menu.stories.tsx +155 -0
  1224. package/src/components/SelectMenu/select-menu.tsx +123 -16
  1225. package/src/components/SelectionControl/index.ts +5 -0
  1226. package/src/components/SelectionControl/selection-item.anatomy.stories.tsx +571 -0
  1227. package/src/components/SelectionControl/selection-item.principles.stories.tsx +77 -0
  1228. package/src/components/SelectionControl/selection-item.spec.md +142 -0
  1229. package/src/components/SelectionControl/selection-item.stories.tsx +137 -0
  1230. package/src/components/SelectionControl/selection-item.tsx +8 -2
  1231. package/src/components/Separator/index.ts +5 -0
  1232. package/src/components/Separator/separator.anatomy.stories.tsx +125 -0
  1233. package/src/components/Separator/separator.principles.stories.tsx +141 -0
  1234. package/src/components/Separator/separator.spec.md +115 -0
  1235. package/src/components/Separator/separator.stories.tsx +127 -0
  1236. package/src/components/Separator/separator.tsx +2 -2
  1237. package/src/components/Sheet/index.ts +5 -0
  1238. package/src/components/Sheet/sheet.anatomy.stories.tsx +269 -0
  1239. package/src/components/Sheet/sheet.principles.stories.tsx +351 -0
  1240. package/src/components/Sheet/sheet.spec.md +146 -0
  1241. package/src/components/Sheet/sheet.stories.tsx +168 -0
  1242. package/src/components/Sheet/sheet.tsx +9 -7
  1243. package/src/components/Sidebar/index.ts +5 -0
  1244. package/src/components/Sidebar/sidebar.anatomy.stories.tsx +772 -0
  1245. package/src/components/Sidebar/sidebar.principles.stories.tsx +505 -0
  1246. package/src/components/Sidebar/sidebar.spec.md +725 -0
  1247. package/src/components/Sidebar/sidebar.stories.tsx +500 -0
  1248. package/src/components/Sidebar/sidebar.tsx +56 -20
  1249. package/src/components/Skeleton/index.ts +5 -0
  1250. package/src/components/Skeleton/skeleton.anatomy.stories.tsx +145 -0
  1251. package/src/components/Skeleton/skeleton.principles.stories.tsx +234 -0
  1252. package/src/components/Skeleton/skeleton.spec.md +105 -0
  1253. package/src/components/Skeleton/skeleton.stories.tsx +137 -0
  1254. package/src/components/Skeleton/skeleton.tsx +2 -2
  1255. package/src/components/Slider/index.ts +5 -0
  1256. package/src/components/Slider/slider.anatomy.stories.tsx +236 -0
  1257. package/src/components/Slider/slider.principles.stories.tsx +250 -0
  1258. package/src/components/Slider/slider.spec.md +358 -0
  1259. package/src/components/Slider/slider.stories.tsx +99 -0
  1260. package/src/components/Slider/slider.tsx +54 -16
  1261. package/src/components/Steps/index.ts +5 -0
  1262. package/src/components/Steps/steps.anatomy.stories.tsx +448 -0
  1263. package/src/components/Steps/steps.principles.stories.tsx +300 -0
  1264. package/src/components/Steps/steps.spec.md +480 -0
  1265. package/src/components/Steps/steps.stories.tsx +335 -0
  1266. package/src/components/Steps/steps.tsx +67 -29
  1267. package/src/components/Switch/index.ts +5 -0
  1268. package/src/components/Switch/switch.anatomy.stories.tsx +227 -0
  1269. package/src/components/Switch/switch.principles.stories.tsx +174 -0
  1270. package/src/components/Switch/switch.spec.md +238 -0
  1271. package/src/components/Switch/switch.stories.tsx +107 -0
  1272. package/src/components/Switch/switch.tsx +116 -38
  1273. package/src/components/Tabs/index.ts +5 -0
  1274. package/src/components/Tabs/tabs.anatomy.stories.tsx +415 -0
  1275. package/src/components/Tabs/tabs.principles.stories.tsx +259 -0
  1276. package/src/components/Tabs/tabs.spec.md +332 -0
  1277. package/src/components/Tabs/tabs.stories.tsx +155 -0
  1278. package/src/components/Tabs/tabs.tsx +49 -35
  1279. package/src/components/Tag/index.ts +5 -0
  1280. package/src/components/Tag/tag.anatomy.stories.tsx +664 -0
  1281. package/src/components/Tag/tag.principles.stories.tsx +270 -0
  1282. package/src/components/Tag/tag.spec.md +324 -0
  1283. package/src/components/Tag/tag.stories.tsx +69 -0
  1284. package/src/components/Tag/tag.tsx +59 -57
  1285. package/src/components/Textarea/index.ts +5 -0
  1286. package/src/components/Textarea/textarea.anatomy.stories.tsx +304 -0
  1287. package/src/components/Textarea/textarea.principles.stories.tsx +175 -0
  1288. package/src/components/Textarea/textarea.spec.md +163 -0
  1289. package/src/components/Textarea/textarea.stories.tsx +53 -0
  1290. package/src/components/Textarea/textarea.tsx +36 -27
  1291. package/src/components/TimePicker/index.ts +5 -0
  1292. package/src/components/TimePicker/time-columns.tsx +8 -1
  1293. package/src/components/TimePicker/time-picker.anatomy.stories.tsx +282 -0
  1294. package/src/components/TimePicker/time-picker.principles.stories.tsx +140 -0
  1295. package/src/components/TimePicker/time-picker.spec.md +290 -0
  1296. package/src/components/TimePicker/time-picker.stories.tsx +193 -0
  1297. package/src/components/TimePicker/time-picker.tsx +46 -30
  1298. package/src/components/Toast/index.ts +5 -0
  1299. package/src/components/Toast/toast.anatomy.stories.tsx +323 -0
  1300. package/src/components/Toast/toast.principles.stories.tsx +216 -0
  1301. package/src/components/Toast/toast.spec.md +181 -0
  1302. package/src/components/Toast/toast.stories.tsx +129 -0
  1303. package/src/components/Toast/toast.tsx +11 -8
  1304. package/src/components/Tooltip/index.ts +5 -0
  1305. package/src/components/Tooltip/tooltip.anatomy.stories.tsx +413 -0
  1306. package/src/components/Tooltip/tooltip.principles.stories.tsx +204 -0
  1307. package/src/components/Tooltip/tooltip.spec.md +142 -0
  1308. package/src/components/Tooltip/tooltip.stories.tsx +116 -0
  1309. package/src/components/Tooltip/tooltip.tsx +5 -2
  1310. package/src/components/TreeView/index.ts +5 -0
  1311. package/src/components/TreeView/tree-view.anatomy.stories.tsx +431 -0
  1312. package/src/components/TreeView/tree-view.principles.stories.tsx +190 -0
  1313. package/src/components/TreeView/tree-view.spec.md +390 -0
  1314. package/src/components/TreeView/tree-view.stories.tsx +299 -0
  1315. package/src/components/TreeView/tree-view.tsx +79 -27
  1316. package/src/hooks/use-overflow-items.ts +10 -6
  1317. package/src/index.ts +73 -69
  1318. package/src/lib/utils.ts +2 -1
  1319. package/src/patterns/README.md +15 -11
  1320. package/src/patterns/action-bar/action-bar.spec.md +465 -0
  1321. package/src/patterns/action-bar/action-bar.stories.tsx +612 -0
  1322. package/src/patterns/element-anatomy/element-anatomy.spec.md +217 -0
  1323. package/src/patterns/element-anatomy/index.ts +5 -0
  1324. package/src/patterns/element-anatomy/inline-action.spec.md +320 -0
  1325. package/src/patterns/element-anatomy/item-anatomy.spec.md +1043 -0
  1326. package/src/patterns/element-anatomy/item-anatomy.stories.tsx +1623 -0
  1327. package/src/patterns/element-anatomy/item-anatomy.tsx +10 -6
  1328. package/src/patterns/header-canonical/chrome-header.tsx +16 -5
  1329. package/src/patterns/header-canonical/header-canonical.css +3 -4
  1330. package/src/patterns/header-canonical/header-canonical.spec.md +326 -0
  1331. package/src/patterns/header-canonical/header-canonical.stories.tsx +150 -0
  1332. package/src/patterns/header-canonical/index.ts +5 -0
  1333. package/src/patterns/horizontal-overflow/horizontal-overflow.spec.md +212 -0
  1334. package/src/patterns/horizontal-overflow/index.ts +5 -0
  1335. package/src/patterns/overlay-surface/index.ts +5 -0
  1336. package/src/patterns/overlay-surface/overlay-surface.spec.md +443 -0
  1337. package/src/patterns/overlay-surface/overlay-surface.tsx +31 -16
  1338. package/src/patterns/resize-handle/index.ts +5 -0
  1339. package/src/patterns/resize-handle/resize-handle.spec.md +120 -0
  1340. package/src/patterns/resize-handle/resize-handle.stories.tsx +71 -0
  1341. package/src/story-governance/category-matrix.json +132 -0
  1342. package/src/story-governance/category-matrix.ts +55 -0
  1343. package/src/styles/base.css +92 -0
  1344. package/src/styles/tokens.css +11 -0
  1345. package/src/tokens/README.md +7 -2
  1346. package/src/tokens/categorical-color.ts +164 -0
  1347. package/src/tokens/color/color.spec.md +801 -0
  1348. package/src/tokens/color/color.stories.tsx +363 -0
  1349. package/src/tokens/color/primitives.css +14 -5
  1350. package/src/tokens/color/semantic.css +28 -13
  1351. package/src/tokens/density/density.spec.md +130 -0
  1352. package/src/tokens/density/density.stories.tsx +240 -0
  1353. package/src/tokens/elevation/elevation.spec.md +78 -0
  1354. package/src/tokens/elevation/elevation.stories.tsx +98 -0
  1355. package/src/tokens/layoutSpace/layoutSpace.css +1 -1
  1356. package/src/tokens/layoutSpace/layoutSpace.spec.md +324 -0
  1357. package/src/tokens/layoutSpace/layoutSpace.stories.tsx +75 -0
  1358. package/src/tokens/motion/motion.css +2 -2
  1359. package/src/tokens/motion/motion.spec.md +105 -0
  1360. package/src/tokens/motion/motion.ts +1 -1
  1361. package/src/tokens/opacity/opacity.spec.md +73 -0
  1362. package/src/tokens/opacity/opacity.stories.tsx +65 -0
  1363. package/src/tokens/orphan-tokens.spec.md +128 -0
  1364. package/src/tokens/radius/radius.spec.md +126 -0
  1365. package/src/tokens/radius/radius.stories.tsx +86 -0
  1366. package/src/tokens/token-system.spec.md +240 -0
  1367. package/src/tokens/typography/typography.css +1 -1
  1368. package/src/tokens/typography/typography.spec.md +204 -0
  1369. package/src/tokens/typography/typography.stories.tsx +133 -0
  1370. package/src/tokens/uiSize/icon-size.ts +3 -4
  1371. package/src/tokens/uiSize/uiSize.css +21 -0
  1372. package/src/tokens/uiSize/uiSize.spec.md +466 -0
  1373. package/src/tokens/utility-registry.json +125 -0
  1374. package/dist/components/NameCard/name-card.d.ts.map +0 -1
  1375. package/dist/components/NameCard/name-card.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Avatar/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAA"}
@@ -0,0 +1,6 @@
1
+ import { Avatar, avatarMeta } from "./avatar.js";
2
+ export {
3
+ Avatar,
4
+ avatarMeta
5
+ };
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
@@ -1,24 +1,36 @@
1
1
  import * as React from 'react';
2
- import { type VariantProps } from 'class-variance-authority';
3
2
  declare const badgeVariants: (props?: ({
4
3
  variant?: "high" | "low" | "medium" | "critical" | null | undefined;
5
4
  dot?: boolean | null | undefined;
6
5
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
7
- export interface BadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'>, Omit<VariantProps<typeof badgeVariants>, 'dot'> {
6
+ type BadgeBaseProps = Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'>;
7
+ export interface BadgeDotProps extends BadgeBaseProps {
8
8
  /** dot 模式:6×6px 純色圓點,無文字 */
9
- dot?: boolean;
10
- /** 顯示的數量(dot 模式下忽略) */
9
+ dot: true;
10
+ /** dot 只接高訊號 attention 色:critical(立即)/ high(有感)。預設 critical。
11
+ * 不提供 medium/low —— dot = 「這裡有東西要看」,淡點不 earn existence
12
+ * (對齊 Material/Ant/Polaris:dot 是單一 attention/status,非 severity 刻度)。 */
13
+ variant?: 'critical' | 'high';
14
+ count?: never;
15
+ max?: never;
16
+ }
17
+ export interface BadgeCountProps extends BadgeBaseProps {
18
+ dot?: false;
19
+ /** 四級 severity(low→critical),見 badge.spec.md「選 level 的流程」 */
20
+ variant?: 'critical' | 'high' | 'medium' | 'low';
21
+ /** 顯示的數量 */
11
22
  count?: number;
12
23
  /** 數量上限,超過時顯示 "max+"(例:max=99 → "99+") */
13
24
  max?: number;
14
25
  }
26
+ export type BadgeProps = BadgeDotProps | BadgeCountProps;
15
27
  declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLSpanElement>>;
16
28
  export declare const badgeMeta: {
17
29
  readonly component: "Badge";
18
- readonly family: 3;
30
+ readonly family: null;
19
31
  readonly variants: {
20
32
  readonly critical: {
21
- readonly purpose: "紅底白字(bg-notification)";
33
+ readonly purpose: "deep-orange 底白字(bg-notification = deep-orange-6)";
22
34
  };
23
35
  readonly high: {
24
36
  readonly purpose: "藍底白字(bg-info)";
@@ -31,10 +43,10 @@ export declare const badgeMeta: {
31
43
  };
32
44
  };
33
45
  readonly sizes: {};
34
- readonly states: readonly ["default", "hover", "active", "focus-visible", "disabled"];
46
+ readonly states: readonly ["default"];
35
47
  readonly tokens: {
36
48
  readonly bg: readonly ["bg-info", "bg-info-subtle", "bg-notification", "bg-secondary"];
37
- readonly fg: readonly ["text-fg-muted", "text-info-text"];
49
+ readonly fg: readonly ["text-fg-muted", "text-info-text", "text-on-emphasis"];
38
50
  readonly ring: readonly [];
39
51
  };
40
52
  readonly defaultVariant: "low";
@@ -1 +1 @@
1
- {"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/components/Badge/badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAkBjE,QAAA,MAAM,aAAa;;;8EAwBlB,CAAA;AAED,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,EAC7D,IAAI,CAAC,YAAY,CAAC,OAAO,aAAa,CAAC,EAAE,KAAK,CAAC;IACjD,4BAA4B;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,QAAA,MAAM,KAAK,oFAqBV,CAAA;AAKD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;CAmBZ,CAAA;AAEV,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAA"}
1
+ {"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/components/Badge/badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAwB9B,QAAA,MAAM,aAAa;;;8EAwBlB,CAAA;AAED,KAAK,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,CAAA;AAE7E,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,4BAA4B;IAC5B,GAAG,EAAE,IAAI,CAAA;IACT;;2EAEuE;IACvE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,GAAG,CAAC,EAAE,KAAK,CAAA;CACZ;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,GAAG,CAAC,EAAE,KAAK,CAAA;IACX,6DAA6D;IAC7D,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;IAChD,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,eAAe,CAAA;AAExD,QAAA,MAAM,KAAK,oFA0BV,CAAA;AAKD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;CAmBZ,CAAA;AAEV,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAA"}
@@ -29,13 +29,15 @@ const badgeVariants = cva(
29
29
  );
30
30
  const Badge = React.forwardRef(
31
31
  ({ variant, dot = false, count, max, className, role, ...props }, ref) => {
32
- const display = dot ? null : max != null && count != null && count > max ? `${max}+` : `${count}`;
32
+ const effectiveVariant = variant ?? (dot ? "critical" : "low");
33
+ if (!dot && count == null) return null;
34
+ const display = dot ? null : max != null && count > max ? `${max}+` : `${count}`;
33
35
  return /* @__PURE__ */ jsx(
34
36
  "span",
35
37
  {
36
38
  ref,
37
39
  role: role ?? "status",
38
- className: cn(badgeVariants({ variant, dot }), className),
40
+ className: cn(badgeVariants({ variant: effectiveVariant, dot }), className),
39
41
  ...props,
40
42
  children: display
41
43
  }
@@ -45,18 +47,19 @@ const Badge = React.forwardRef(
45
47
  Badge.displayName = "Badge";
46
48
  const badgeMeta = {
47
49
  component: "Badge",
48
- family: 3,
50
+ family: null,
51
+ // self-contained(對齊 spec frontmatter 2026-06-11 修),
49
52
  variants: {
50
- critical: { purpose: "紅底白字(bg-notification)" },
53
+ critical: { purpose: "deep-orange 底白字(bg-notification = deep-orange-6)" },
51
54
  high: { purpose: "藍底白字(bg-info)" },
52
55
  medium: { purpose: "淺藍底藍字(bg-info-subtle)" },
53
56
  low: { purpose: "使用者切 tab 才看,不需搶注意力" }
54
57
  },
55
58
  sizes: {},
56
- states: ["default", "hover", "active", "focus-visible", "disabled"],
59
+ states: ["default"],
57
60
  tokens: {
58
61
  bg: ["bg-info", "bg-info-subtle", "bg-notification", "bg-secondary"],
59
- fg: ["text-fg-muted", "text-info-text"],
62
+ fg: ["text-fg-muted", "text-info-text", "text-on-emphasis"],
60
63
  ring: []
61
64
  },
62
65
  defaultVariant: "low"
@@ -1 +1 @@
1
- {"version":3,"file":"badge.js","sources":["../../../src/components/Badge/badge.tsx"],"sourcesContent":["import * as React from 'react'\nimport { cva, type VariantProps } from 'class-variance-authority'\nimport { cn } from '@/lib/utils'\n\n// ── Badge(notification count indicator)────────────────────────────────────\n// 通知計數指示器,用於未讀數量、待辦計數等。\n//\n// 兩種模式:\n// count — 16px 高,10px 字,font-medium。個位數正圓,多位數膠囊。\n// dot — 6×6px 純色圓點,無文字。\n//\n// 四個層級(由 passive 到 urgent):\n// low(預設) — 灰底灰字(neutral-3 + neutral-7),被動計數\n// medium — 淺藍底藍字(bg-info-subtle + text-info-text),可延後看\n// high — 藍底白字(bg-info),有感影響的待辦\n// critical — 紅底白字(bg-notification),立即處理\n//\n// 規則:default low, escalate with reason。見 badge.spec.md「選 level 的流程」。\n\nconst badgeVariants = cva(\n // 2026-05-23 Path B revert:icon-as-text / numeric-in-circle 用 leading-none canonical(對齊 Material Avatar `line-height: 1` / Polaris Badge / Carbon Tag 共識)。\n // 視覺等效驗證:Badge container 顯式 `h-4 (16px)` + `flex items-center` 主導,text 被 items-center 置中,line-height 1.0 vs 1.3 視覺零差別。\n // user 2026-05-23「或是其實根本不用分?」+「照你建議」path B:統一 leading-none,不分。\n // 廢除 2026-05-21 F1 fix 的 leading-compact migration(那次 anchor「不影響高度的話就改」core constraint 是高度不變,Path B 同樣滿足且更簡單)。\n 'inline-flex items-center justify-center rounded-full leading-none',\n {\n variants: {\n variant: {\n critical: 'bg-notification text-on-emphasis',\n high: 'bg-info text-on-emphasis',\n medium: 'bg-info-subtle text-info-text',\n low: 'bg-secondary text-fg-muted',\n },\n dot: {\n true: 'w-1.5 h-1.5',\n false: 'min-w-4 h-4 px-1 text-[10px] font-medium',\n },\n },\n defaultVariants: {\n variant: 'low',\n dot: false,\n },\n }\n)\n\nexport interface BadgeProps\n extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'>,\n Omit<VariantProps<typeof badgeVariants>, 'dot'> {\n /** dot 模式:6×6px 純色圓點,無文字 */\n dot?: boolean\n /** 顯示的數量(dot 模式下忽略) */\n count?: number\n /** 數量上限,超過時顯示 \"max+\"(例:max=99 → \"99+\") */\n max?: number\n}\n\nconst Badge = React.forwardRef<HTMLSpanElement, BadgeProps>(\n ({ variant, dot = false, count, max, className, role, ...props }, ref) => {\n const display = dot ? null : (\n max != null && count != null && count > max ? `${max}+` : `${count}`\n )\n\n // a11y(2026-04-25 axe aria-prohibited-attr fix):\n // span default 無 role → 不接 aria-label(WCAG 禁止)。Badge 是通知指示器,\n // `role=\"status\"` 語意正確(live region 可播報計數變化)且允許 aria-label。\n // Consumer 可 override(傳 role=\"img\" / role={undefined})。\n return (\n <span\n ref={ref}\n role={role ?? 'status'}\n className={cn(badgeVariants({ variant, dot }), className)}\n {...props}\n >\n {display}\n </span>\n )\n }\n)\nBadge.displayName = 'Badge'\n\n// Story auto-compile metadata — Phase 1 mechanical migration(2026-04-24)\n// Phase 2 fill needed: purpose descriptions + when rationale + world-class refs\nexport const badgeMeta = {\n component: 'Badge',\n family: 3,\n variants: {\n critical: { purpose: '紅底白字(bg-notification)' },\n high: { purpose: '藍底白字(bg-info)' },\n medium: { purpose: '淺藍底藍字(bg-info-subtle)' },\n low: { purpose: '使用者切 tab 才看,不需搶注意力' },\n },\n sizes: {\n\n },\n states: ['default', 'hover', 'active', 'focus-visible', 'disabled'],\n tokens: {\n bg: ['bg-info', 'bg-info-subtle', 'bg-notification', 'bg-secondary'],\n fg: ['text-fg-muted', 'text-info-text'],\n ring: [],\n },\n defaultVariant: 'low',\n} as const\n\nexport { Badge, badgeVariants }\n"],"names":[],"mappings":";;;;AAmBA,MAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKpB;AAAA,EACA;AAAA,IACE,UAAU;AAAA,MACR,SAAS;AAAA,QACP,UAAU;AAAA,QACV,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,KAAK;AAAA,MAAA;AAAA,MAEP,KAAK;AAAA,QACH,MAAM;AAAA,QACN,OAAO;AAAA,MAAA;AAAA,IACT;AAAA,IAEF,iBAAiB;AAAA,MACf,SAAS;AAAA,MACT,KAAK;AAAA,IAAA;AAAA,EACP;AAEJ;AAaA,MAAM,QAAQ,MAAM;AAAA,EAClB,CAAC,EAAE,SAAS,MAAM,OAAO,OAAO,KAAK,WAAW,MAAM,GAAG,MAAA,GAAS,QAAQ;AACxE,UAAM,UAAU,MAAM,OACpB,OAAO,QAAQ,SAAS,QAAQ,QAAQ,MAAM,GAAG,GAAG,MAAM,GAAG,KAAK;AAOpE,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,MAAM,QAAQ;AAAA,QACd,WAAW,GAAG,cAAc,EAAE,SAAS,IAAA,CAAK,GAAG,SAAS;AAAA,QACvD,GAAG;AAAA,QAEH,UAAA;AAAA,MAAA;AAAA,IAAA;AAAA,EAGP;AACF;AACA,MAAM,cAAc;AAIb,MAAM,YAAY;AAAA,EACvB,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,UAAU;AAAA,IACR,UAAU,EAAE,SAAS,wBAAA;AAAA,IACrB,MAAM,EAAE,SAAS,gBAAA;AAAA,IACjB,QAAQ,EAAE,SAAS,wBAAA;AAAA,IACnB,KAAK,EAAE,SAAS,qBAAA;AAAA,EAAqB;AAAA,EAEvC,OAAO,CAAA;AAAA,EAGP,QAAQ,CAAC,WAAW,SAAS,UAAU,iBAAiB,UAAU;AAAA,EAClE,QAAQ;AAAA,IACN,IAAI,CAAC,WAAW,kBAAkB,mBAAmB,cAAc;AAAA,IACnE,IAAI,CAAC,iBAAiB,gBAAgB;AAAA,IACtC,MAAM,CAAA;AAAA,EAAC;AAAA,EAET,gBAAgB;AAClB;"}
1
+ {"version":3,"file":"badge.js","sources":["../../../src/components/Badge/badge.tsx"],"sourcesContent":["import * as React from 'react'\nimport { cva } from 'class-variance-authority'\nimport { cn } from '@/lib/utils'\n\n// ── Badge(notification count indicator)────────────────────────────────────\n// 通知計數指示器,用於未讀數量、待辦計數等。\n//\n// 兩種模式:\n// count — 16px 高,10px 字,font-medium。個位數正圓,多位數膠囊。\n// dot — 6×6px 純色圓點,無文字。\n//\n// 四個層級(由 passive 到 urgent):\n// low(預設) — 灰底灰字(neutral-3 + neutral-7),被動計數\n// medium — 淺藍底藍字(bg-info-subtle + text-info-text),可延後看\n// high — 藍底白字(bg-info),有感影響的待辦\n// critical — deep-orange 底白字(bg-notification = --color-deep-orange-6,hue 38;非 categorical red hue 25),立即處理\n//\n// dot 模式只接 critical / high(單一 attention 點,實心可見色)—— 不提供 medium/low dot:\n// dot = 「這裡有東西要看」,淡點不 earn existence(對齊 Material small-badge / Ant status dot /\n// Polaris:dot 是單一 attention/status,非 4 級 severity 刻度;2026-06-05 user 拍板 Option A)。\n// medium/low 仍完整存在於 count/text badge。\n//\n// 規則:count default low, escalate with reason。見 badge.spec.md「選 level 的流程」+「dot 變體」。\n\nconst badgeVariants = cva(\n // 2026-05-23 Path B revert:icon-as-text / numeric-in-circle 用 leading-none canonical(對齊 Material Avatar `line-height: 1` / Polaris Badge / Carbon Tag 共識)。\n // 視覺等效驗證:Badge container 顯式 `h-4 (16px)` + `flex items-center` 主導,text 被 items-center 置中,line-height 1.0 vs 1.3 視覺零差別。\n // user 2026-05-23「或是其實根本不用分?」+「照你建議」path B:統一 leading-none,不分。\n // 廢除 2026-05-21 F1 fix 的 leading-compact migration(那次 anchor「不影響高度的話就改」core constraint 是高度不變,Path B 同樣滿足且更簡單)。\n 'inline-flex items-center justify-center rounded-full leading-none',\n {\n variants: {\n variant: {\n critical: 'bg-notification text-on-emphasis',\n high: 'bg-info text-on-emphasis',\n medium: 'bg-info-subtle text-info-text',\n low: 'bg-secondary text-fg-muted',\n },\n dot: {\n true: 'w-1.5 h-1.5',\n false: 'min-w-4 h-4 px-1 text-[10px] font-medium',\n },\n },\n defaultVariants: {\n variant: 'low',\n dot: false,\n },\n }\n)\n\ntype BadgeBaseProps = Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'>\n\nexport interface BadgeDotProps extends BadgeBaseProps {\n /** dot 模式:6×6px 純色圓點,無文字 */\n dot: true\n /** dot 只接高訊號 attention 色:critical(立即)/ high(有感)。預設 critical。\n * 不提供 medium/low —— dot = 「這裡有東西要看」,淡點不 earn existence\n * (對齊 Material/Ant/Polaris:dot 是單一 attention/status,非 severity 刻度)。 */\n variant?: 'critical' | 'high'\n count?: never\n max?: never\n}\n\nexport interface BadgeCountProps extends BadgeBaseProps {\n dot?: false\n /** 四級 severity(low→critical),見 badge.spec.md「選 level 的流程」 */\n variant?: 'critical' | 'high' | 'medium' | 'low'\n /** 顯示的數量 */\n count?: number\n /** 數量上限,超過時顯示 \"max+\"(例:max=99 → \"99+\") */\n max?: number\n}\n\nexport type BadgeProps = BadgeDotProps | BadgeCountProps\n\nconst Badge = React.forwardRef<HTMLSpanElement, BadgeProps>(\n ({ variant, dot = false, count, max, className, role, ...props }, ref) => {\n // dot 預設 attention 色 = critical(非 cva 的 count default 'low');count 沿用 cva default 'low'。\n const effectiveVariant = variant ?? (dot ? 'critical' : 'low')\n // 2026-07-05 D4 修(續 07-04 guard):count 模式 count == null → 整顆 return null 不渲染 —\n // 原 guard 只擋文字,仍渲染 16px 空 pill + 空 role=status live region(Ant/Material 皆不渲染)。\n if (!dot && count == null) return null\n const display = dot ? null : (\n max != null && count! > max ? `${max}+` : `${count}`\n )\n\n // a11y(2026-04-25 axe aria-prohibited-attr fix):\n // span default 無 role → 不接 aria-label(WCAG 禁止)。Badge 是通知指示器,\n // `role=\"status\"` 語意正確(live region 可播報計數變化)且允許 aria-label。\n // Consumer 可 override(傳 role=\"img\" / role={undefined})。\n return (\n <span\n ref={ref}\n role={role ?? 'status'}\n className={cn(badgeVariants({ variant: effectiveVariant, dot }), className)}\n {...props}\n >\n {display}\n </span>\n )\n }\n)\nBadge.displayName = 'Badge'\n\n// Story auto-compile metadata — Phase 1 mechanical migration(2026-04-24)\n// Phase 2 fill needed: purpose descriptions + when rationale + world-class refs\nexport const badgeMeta = {\n component: 'Badge',\n family: null, // self-contained(對齊 spec frontmatter 2026-06-11 修),\n variants: {\n critical: { purpose: 'deep-orange 底白字(bg-notification = deep-orange-6)' },\n high: { purpose: '藍底白字(bg-info)' },\n medium: { purpose: '淺藍底藍字(bg-info-subtle)' },\n low: { purpose: '使用者切 tab 才看,不需搶注意力' },\n },\n sizes: {\n\n },\n states: ['default'],\n tokens: {\n bg: ['bg-info', 'bg-info-subtle', 'bg-notification', 'bg-secondary'],\n fg: ['text-fg-muted', 'text-info-text', 'text-on-emphasis'],\n ring: [],\n },\n defaultVariant: 'low',\n} as const\n\nexport { Badge, badgeVariants }\n"],"names":[],"mappings":";;;;AAwBA,MAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKpB;AAAA,EACA;AAAA,IACE,UAAU;AAAA,MACR,SAAS;AAAA,QACP,UAAU;AAAA,QACV,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,KAAK;AAAA,MAAA;AAAA,MAEP,KAAK;AAAA,QACH,MAAM;AAAA,QACN,OAAO;AAAA,MAAA;AAAA,IACT;AAAA,IAEF,iBAAiB;AAAA,MACf,SAAS;AAAA,MACT,KAAK;AAAA,IAAA;AAAA,EACP;AAEJ;AA2BA,MAAM,QAAQ,MAAM;AAAA,EAClB,CAAC,EAAE,SAAS,MAAM,OAAO,OAAO,KAAK,WAAW,MAAM,GAAG,MAAA,GAAS,QAAQ;AAExE,UAAM,mBAAmB,YAAY,MAAM,aAAa;AAGxD,QAAI,CAAC,OAAO,SAAS,KAAM,QAAO;AAClC,UAAM,UAAU,MAAM,OACpB,OAAO,QAAQ,QAAS,MAAM,GAAG,GAAG,MAAM,GAAG,KAAK;AAOpD,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,MAAM,QAAQ;AAAA,QACd,WAAW,GAAG,cAAc,EAAE,SAAS,kBAAkB,IAAA,CAAK,GAAG,SAAS;AAAA,QACzE,GAAG;AAAA,QAEH,UAAA;AAAA,MAAA;AAAA,IAAA;AAAA,EAGP;AACF;AACA,MAAM,cAAc;AAIb,MAAM,YAAY;AAAA,EACvB,WAAW;AAAA,EACX,QAAQ;AAAA;AAAA,EACR,UAAU;AAAA,IACR,UAAU,EAAE,SAAS,mDAAA;AAAA,IACrB,MAAM,EAAE,SAAS,gBAAA;AAAA,IACjB,QAAQ,EAAE,SAAS,wBAAA;AAAA,IACnB,KAAK,EAAE,SAAS,qBAAA;AAAA,EAAqB;AAAA,EAEvC,OAAO,CAAA;AAAA,EAGP,QAAQ,CAAC,SAAS;AAAA,EAClB,QAAQ;AAAA,IACN,IAAI,CAAC,WAAW,kBAAkB,mBAAmB,cAAc;AAAA,IACnE,IAAI,CAAC,iBAAiB,kBAAkB,kBAAkB;AAAA,IAC1D,MAAM,CAAA;AAAA,EAAC;AAAA,EAET,gBAAgB;AAClB;"}
@@ -0,0 +1,2 @@
1
+ export * from './badge';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Badge/index.ts"],"names":[],"mappings":"AAIA,cAAc,SAAS,CAAA"}
@@ -0,0 +1,7 @@
1
+ import { Badge, badgeMeta, badgeVariants } from "./badge.js";
2
+ export {
3
+ Badge,
4
+ badgeMeta,
5
+ badgeVariants
6
+ };
7
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
@@ -28,7 +28,7 @@ import { ItemInlineActionButton } from '../../patterns/element-anatomy/item-anat
28
28
  * ── 視覺 ──
29
29
  * Link (預設): text-fg-secondary
30
30
  * Link hover: text-primary-hover (canonical「互動高亮」, 跟 Tabs / Chip 用法一致)
31
- * Page (當前): text-foreground + font-medium
31
+ * Page (當前): text-foreground(不加粗 加粗會讓 breadcrumb 最右端視覺過重,見 spec)
32
32
  * Separator: ChevronRight (size 跟 list 一致), text-fg-muted
33
33
  *
34
34
  * ── 詳見 breadcrumb.spec.md ──
@@ -150,7 +150,20 @@ export declare const breadcrumbMeta: {
150
150
  readonly component: "Breadcrumb";
151
151
  readonly family: null;
152
152
  readonly variants: {};
153
- readonly sizes: {};
153
+ readonly sizes: {
154
+ readonly sm: {
155
+ readonly iconSize: 16;
156
+ readonly typography: "body";
157
+ };
158
+ readonly md: {
159
+ readonly iconSize: 16;
160
+ readonly typography: "body";
161
+ };
162
+ readonly lg: {
163
+ readonly iconSize: 20;
164
+ readonly typography: "body-lg";
165
+ };
166
+ };
154
167
  readonly states: readonly ["default", "hover", "active", "focus-visible", "disabled"];
155
168
  readonly tokens: {
156
169
  readonly bg: readonly [];
@@ -1 +1 @@
1
- {"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../../src/components/Breadcrumb/breadcrumb.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAE5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAA;AA0E9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,KAAK,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AA0BxC,QAAA,MAAM,UAAU,0JAKd,CAAA;AAKF;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,UAAU,CAAA;CACvB;AAED,UAAU,mBAAoB,SAAQ,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC1F;;;;;OAKG;IACH,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAGD,QAAA,MAAM,cAAc,8FAgLnB,CAAA;AAKD;;;;;;;;;;;;GAYG;AACH,UAAU,mBAAoB,SAAQ,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC;IACxE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;CAClD;AAED,QAAA,MAAM,cAAc,2FA4BnB,CAAA;AAKD,UAAU,mBAAoB,SAAQ,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC;IACvE,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,UAAU,CAAA;CACvB;AAED,QAAA,MAAM,cAAc,+FAyCnB,CAAA;AAKD,UAAU,mBAAoB,SAAQ,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC;IAC1E,wEAAwE;IACxE,SAAS,CAAC,EAAE,UAAU,CAAA;CACvB;AAED,QAAA,MAAM,cAAc,6FAqBnB,CAAA;AAKD,UAAU,wBAAyB,SAAQ,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC;IAC7E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAGD,QAAA,MAAM,mBAAmB,gGAgBxB,CAAA;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,KAAK,uBAAuB,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,OAAO,sBAAsB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;AAEnH,QAAA,MAAM,kBAAkB,mGAavB,CAAA;AAKD,eAAO,MAAM,cAAc;;;;;;;;;;;CAejB,CAAA;AAEV,OAAO,EACL,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,CAAA;AACD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,CAAA"}
1
+ {"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../../src/components/Breadcrumb/breadcrumb.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAE5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAA;AA0E9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,KAAK,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AA0BxC,QAAA,MAAM,UAAU,0JAKd,CAAA;AAKF;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,UAAU,CAAA;CACvB;AAED,UAAU,mBAAoB,SAAQ,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC1F;;;;;OAKG;IACH,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAGD,QAAA,MAAM,cAAc,8FAkLnB,CAAA;AAKD;;;;;;;;;;;;GAYG;AACH,UAAU,mBAAoB,SAAQ,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC;IACxE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;CAClD;AAED,QAAA,MAAM,cAAc,2FA4BnB,CAAA;AAKD,UAAU,mBAAoB,SAAQ,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC;IACvE,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,UAAU,CAAA;CACvB;AAED,QAAA,MAAM,cAAc,+FAyCnB,CAAA;AAKD,UAAU,mBAAoB,SAAQ,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC;IAC1E,wEAAwE;IACxE,SAAS,CAAC,EAAE,UAAU,CAAA;CACvB;AAED,QAAA,MAAM,cAAc,6FAqBnB,CAAA;AAKD,UAAU,wBAAyB,SAAQ,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC;IAC7E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAGD,QAAA,MAAM,mBAAmB,gGAgBxB,CAAA;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,KAAK,uBAAuB,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,OAAO,sBAAsB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;AAEnH,QAAA,MAAM,kBAAkB,mGAavB,CAAA;AAKD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;CAmBjB,CAAA;AAEV,OAAO,EACL,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,CAAA;AACD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,CAAA"}
@@ -67,7 +67,7 @@ const BreadcrumbList = React.forwardRef(
67
67
  const ctxValue = React.useMemo(() => ({ size }), [size]);
68
68
  const declarativeContent = React.useMemo(() => {
69
69
  if (!items) return null;
70
- const renderItem = (spec, role) => /* @__PURE__ */ jsx(BreadcrumbItem, { role, children: role === "current" ? /* @__PURE__ */ jsx(BreadcrumbPage, { startIcon: spec.startIcon, children: /* @__PURE__ */ jsx(TruncatedLabel, { fullText: typeof spec.label === "string" ? spec.label : void 0, children: spec.label }) }) : /* @__PURE__ */ jsx(BreadcrumbLink, { href: spec.href, asChild: spec.asChild, startIcon: spec.startIcon, children: /* @__PURE__ */ jsx(TruncatedLabel, { fullText: typeof spec.label === "string" ? spec.label : void 0, children: spec.label }) }) }, `${role}-${typeof spec.label === "string" ? spec.label : Math.random()}`);
70
+ const renderItem = (spec, role, idx) => /* @__PURE__ */ jsx(BreadcrumbItem, { role, children: role === "current" ? /* @__PURE__ */ jsx(BreadcrumbPage, { startIcon: spec.startIcon, children: /* @__PURE__ */ jsx(TruncatedLabel, { fullText: typeof spec.label === "string" ? spec.label : void 0, children: spec.label }) }) : /* @__PURE__ */ jsx(BreadcrumbLink, { href: spec.href, asChild: spec.asChild, startIcon: spec.startIcon, children: /* @__PURE__ */ jsx(TruncatedLabel, { fullText: typeof spec.label === "string" ? spec.label : void 0, children: spec.label }) }) }, `${role}-${typeof spec.label === "string" ? spec.label : idx}`);
71
71
  const shouldCollapse = items.length > maxItems;
72
72
  const beforeN = Math.max(0, itemsBeforeCollapse);
73
73
  const afterN = Math.max(1, itemsAfterCollapse);
@@ -100,7 +100,7 @@ const BreadcrumbList = React.forwardRef(
100
100
  ] }) }, "ellipsis")
101
101
  );
102
102
  } else {
103
- rendered.push(renderItem(entry.spec, entry.role));
103
+ rendered.push(renderItem(entry.spec, entry.role, i));
104
104
  }
105
105
  });
106
106
  return rendered;
@@ -279,7 +279,13 @@ const breadcrumbMeta = {
279
279
  family: null,
280
280
  // non-family composite / overlay / layout
281
281
  variants: {},
282
- sizes: {},
282
+ sizes: {
283
+ // 值源 = code SSOT:BREADCRUMB_SIZE_TEXT(sm/md=text-body, lg=text-body-lg)+ BREADCRUMB_ICON_SIZE(sm/md=16, lg=20)。
284
+ // Breadcrumb 是文字列無固定高度 token,故不列 height(對照 Tag meta 有自身 h-* 才列)。
285
+ sm: { iconSize: 16, typography: "body" },
286
+ md: { iconSize: 16, typography: "body" },
287
+ lg: { iconSize: 20, typography: "body-lg" }
288
+ },
283
289
  states: ["default", "hover", "active", "focus-visible", "disabled"],
284
290
  tokens: {
285
291
  bg: [],
@@ -1 +1 @@
1
- {"version":3,"file":"breadcrumb.js","sources":["../../../src/components/Breadcrumb/breadcrumb.tsx"],"sourcesContent":["// @benchmark-unverified-blanket: file-level retraction per M22 (d) — claims herein not individually URL-cited; treat as unverified visual/usage rumor unless retrofit per-claim. Hook escape preserved.\n// code-quality-allow: file-size — Breadcrumb 含 BreadcrumbList(主)+ BreadcrumbItem + BreadcrumbEllipsis + items-collapse logic,split 會破壞 collapse/overflow Tooltip subtree\nimport * as React from 'react'\nimport { Slot } from '@radix-ui/react-slot'\nimport { ChevronRight, MoreHorizontal, type LucideIcon } from 'lucide-react'\nimport { cn } from '@/lib/utils'\nimport { ItemInlineActionButton } from '@/design-system/patterns/element-anatomy/item-anatomy'\nimport { Tooltip, TooltipTrigger, TooltipContent } from '@/design-system/components/Tooltip/tooltip'\nimport {\n DropdownMenu,\n DropdownMenuTrigger,\n DropdownMenuContent,\n DropdownMenuItem,\n} from '@/design-system/components/DropdownMenu/dropdown-menu'\n\n// ── TruncatedLabel ────────────────────────────────────────────────────────────\n// 同 `data-table.tsx:339 TruncateCell` + `tag.tsx:138 isTruncated` SSOT pattern\n// (shared ResizeObserver + scrollWidth > clientWidth → wrap Tooltip)。\n// **TODO** future:Rule-of-3 達 → 抽 `patterns/element-anatomy/truncated-text.tsx` 共用\n// (本 component / DataTable TruncateCell / Tag inner 三處同 idiom,符合 M30 SSOT 抽取門檻)。\n\ntype RoCallback = (entry: ResizeObserverEntry) => void\nlet sharedRO: ResizeObserver | null = null\nconst sharedROCallbacks = new WeakMap<Element, RoCallback>()\nfunction getSharedRO(): ResizeObserver {\n if (sharedRO) return sharedRO\n sharedRO = new ResizeObserver((entries) => {\n entries.forEach((e) => {\n const cb = sharedROCallbacks.get(e.target)\n if (cb) cb(e)\n })\n })\n return sharedRO\n}\nfunction observeShared(el: Element, cb: RoCallback): () => void {\n const obs = getSharedRO()\n sharedROCallbacks.set(el, cb)\n obs.observe(el)\n return () => { sharedROCallbacks.delete(el); obs.unobserve(el) }\n}\n\nfunction TruncatedLabel({ children, fullText }: { children: React.ReactNode; fullText?: string }) {\n const ref = React.useRef<HTMLSpanElement>(null)\n const [isTruncated, setIsTruncated] = React.useState(false)\n React.useEffect(() => {\n const el = ref.current\n if (!el) return\n const check = () => setIsTruncated(el.scrollWidth > el.clientWidth)\n check()\n // 2026-05-11 fix:首幀 layout 未完成 / 字型 async load → scrollWidth=clientWidth 假陰性。\n // RAF + 短延遲再驗一次,捕獲字型 / 容器尺寸後變(對齊 TruncateCell / Tag SSOT pattern)。\n const raf = requestAnimationFrame(check)\n const t = setTimeout(check, 100)\n const cleanup = observeShared(el, check)\n return () => {\n cancelAnimationFrame(raf)\n clearTimeout(t)\n cleanup()\n }\n }, [])\n // Tooltip canonical:per `tooltip.principles.stories.tsx:190`「Tooltip 是資訊補救 — 文字被\n // truncate 時才顯示完整內容。沒被截斷就不該顯示 tooltip」\n //\n // 2026-05-11 fix(playwright tooltip-on-truncate 卡 hover 沒 tooltip):\n // 原本 isTruncated=false 直接 return 裸 span / true 才 wrap Tooltip → JSX 樹結構改變\n // → React 把 span unmount + remount(因為 wrapper component 變),ref 換到新 span,\n // useEffect [] 不重跑(同 component instance)→ 觀察的 DOM 跟實際 DOM 對不上。\n // Fix:**永遠 wrap Tooltip**(同 DOM 節點生命週期);`open` 由 isTruncated 控制 —\n // 沒被 truncate 就 force `open={false}`,有 truncate 就 `undefined`(uncontrolled,\n // hover 走 Radix default behavior)。對齊 canonical「沒被截斷就不該 tooltip」。\n return (\n <Tooltip open={isTruncated ? undefined : false}>\n <TooltipTrigger asChild>\n <span ref={ref} className=\"truncate min-w-0 block\">{children}</span>\n </TooltipTrigger>\n <TooltipContent>{fullText ?? children}</TooltipContent>\n </Tooltip>\n )\n}\n\n/**\n * Breadcrumb — 顯示當前頁面在階層中的位置\n *\n * 基於 shadcn/ui Breadcrumb 結構(純 HTML nav + ol + li + a/span),\n * 橋接設計系統 token。\n *\n * ── 結構 ──\n * <Breadcrumb>\n * <BreadcrumbList size=\"md\">\n * <BreadcrumbItem>\n * <BreadcrumbLink href=\"/projects\">專案</BreadcrumbLink>\n * </BreadcrumbItem>\n * <BreadcrumbSeparator />\n * <BreadcrumbItem>\n * <BreadcrumbPage>目前頁面</BreadcrumbPage>\n * </BreadcrumbItem>\n * </BreadcrumbList>\n * </Breadcrumb>\n *\n * ── Size(跟 page title 配對) ──\n * sm text-body(14) → 建議配 text-h4(20) title —— Dialog / panel / drawer\n * md text-body(14) → 建議配 text-h3(24) title —— 一般頁面 header (預設)\n * lg text-body-lg(16) → 建議配 text-h2(32) title —— Detail page hero / landing\n *\n * ── 視覺 ──\n * Link (預設): text-fg-secondary\n * Link hover: text-primary-hover (canonical「互動高亮」, 跟 Tabs / Chip 用法一致)\n * Page (當前): text-foreground + font-medium\n * Separator: ChevronRight (size 跟 list 一致), text-fg-muted\n *\n * ── 詳見 breadcrumb.spec.md ──\n */\n\n// ── Size context ─────────────────────────────────────────────────────────────\n\ntype BreadcrumbSize = 'sm' | 'md' | 'lg'\n\ninterface BreadcrumbContextValue {\n size: BreadcrumbSize\n}\n\nconst BreadcrumbContext = React.createContext<BreadcrumbContextValue>({ size: 'md' })\n\nconst BREADCRUMB_TEXT_CLASS: Record<BreadcrumbSize, string> = {\n sm: 'text-body',\n md: 'text-body',\n lg: 'text-body-lg',\n}\n\n// Separator / ellipsis icon 尺寸 — 對齊 uiSize.spec.md「Icon Size Tier」(field-height-sm/md→16,lg→20)\n// 2026-05-18 改 per user 拍板「A 先改 16/16/20」+「做完」approval:\n// 撤回 text-flow 例外設計,Breadcrumb chevron 跟其他 chrome icon 同 tier。\n// World-class 對齊:Atlassian Breadcrumb chevron 16 default / Material 3 / Ant Design 同。\nconst BREADCRUMB_ICON_SIZE: Record<BreadcrumbSize, number> = {\n sm: 16,\n md: 16,\n lg: 20,\n}\n\n// ── Breadcrumb (nav root) ────────────────────────────────────────────────────\n\nconst Breadcrumb = React.forwardRef<\n HTMLElement,\n React.ComponentPropsWithoutRef<'nav'>\n>(({ ...props }, ref) => (\n <nav ref={ref} aria-label=\"Breadcrumb\" {...props} />\n))\nBreadcrumb.displayName = 'Breadcrumb'\n\n// ── BreadcrumbList (ol) ──────────────────────────────────────────────────────\n\n/**\n * Phase B(2026-05-10):declarative items mode 啟用 auto-collapse + auto-separator + auto-page-end。\n * 對齊 Material UI source `Breadcrumbs.js renderItemsBeforeAndAfter` mechanism(`maxItems`\n * default 8;本 DS 採 user-tuned 4 — 更積極 collapse 適合 single-line 緊湊 layout)。\n */\n// code-quality-allow: dead-export — public consumer-facing item spec type;對齊 BreadcrumbProps API contract,允許 consumer 構造 items array 外部\nexport interface BreadcrumbItemSpec {\n label: React.ReactNode\n href?: string\n asChild?: boolean\n /**\n * 起始 icon(per `ui-development.md`「icon prop 命名 4 條」:slot 只接 icon → `startIcon`)。\n * 業界慣例:Breadcrumb 首項用 Home icon 強化視覺錨點(Material / Atlassian)。\n * 內部消費 `BREADCRUMB_ICON_SIZE[size]` SSOT(sm/md=16, lg=20,對齊 uiSize.spec.md Icon Size Tier)。\n * Consumer **不傳** size,DS 統一管。\n */\n startIcon?: LucideIcon\n}\n\ninterface BreadcrumbListProps extends Omit<React.ComponentPropsWithoutRef<'ol'>, 'children'> {\n /**\n * 字體尺寸 — 依據與之配對的 page title 選擇:\n * sm → 配 text-h4(20) title (Dialog / panel / drawer)\n * md → 配 text-h3(24) title (一般頁面 header,預設)\n * lg → 配 text-h2(32) title (Detail page hero / landing)\n */\n size?: BreadcrumbSize\n /**\n * Declarative items mode(opt-in)。當 provided 時 `children` 被忽略,List 內部自動:\n * - 插 separator\n * - 末位 spec(無 `href`)自動 BreadcrumbPage(per Title-breadcrumb-end SSOT)\n * - 超 `maxItems` auto-collapse 中段成 BreadcrumbEllipsis + DropdownMenu(對齊 Material UI\n * source `renderItemsBeforeAndAfter`)\n */\n items?: BreadcrumbItemSpec[]\n /**\n * Auto-collapse 閾值。Default 4(user-tuned;Material UI source 預設 8)。`items.length > maxItems`\n * 才 collapse。\n */\n maxItems?: number\n /** Collapse 後保留首 N 個(default 1)。對齊 Material UI source default。 */\n itemsBeforeCollapse?: number\n /** Collapse 後保留末 N 個(default 1)。對齊 Material UI source default。 */\n itemsAfterCollapse?: number\n children?: React.ReactNode\n}\n\n// code-quality-allow: long-function — items props × children narrowing × collapse-with-overflow × tooltip 4 軸組合在 BreadcrumbList,拆 sub-fn 會跨 fn 傳 itemsBeforeCollapse/After collapsed-tooltip refs\nconst BreadcrumbList = React.forwardRef<HTMLOListElement, BreadcrumbListProps>(\n ({ className, size = 'md', items, maxItems = 4, itemsBeforeCollapse = 1, itemsAfterCollapse = 1, children, ...props }, ref) => {\n // Memoize provider value(2026-04-22 D3 perf audit):單 field wrapper memoize\n const ctxValue = React.useMemo(() => ({ size }), [size])\n\n // Declarative mode(items prop provided):自動 render + auto-collapse\n const declarativeContent = React.useMemo(() => {\n if (!items) return null\n const renderItem = (spec: BreadcrumbItemSpec, role: 'root' | 'middle' | 'current') => (\n <BreadcrumbItem key={`${role}-${typeof spec.label === 'string' ? spec.label : Math.random()}`} role={role}>\n {role === 'current'\n ? <BreadcrumbPage startIcon={spec.startIcon}>\n <TruncatedLabel fullText={typeof spec.label === 'string' ? spec.label : undefined}>{spec.label}</TruncatedLabel>\n </BreadcrumbPage>\n : <BreadcrumbLink href={spec.href} asChild={spec.asChild} startIcon={spec.startIcon}>\n <TruncatedLabel fullText={typeof spec.label === 'string' ? spec.label : undefined}>{spec.label}</TruncatedLabel>\n </BreadcrumbLink>\n }\n </BreadcrumbItem>\n )\n\n const shouldCollapse = items.length > maxItems\n const beforeN = Math.max(0, itemsBeforeCollapse)\n const afterN = Math.max(1, itemsAfterCollapse) // 末位永遠 ≥ 1(current page)\n\n type VisibleItem = { spec: BreadcrumbItemSpec; role: 'root' | 'middle' | 'current' }\n let visible: Array<VisibleItem | { ellipsisOf: BreadcrumbItemSpec[] }>\n if (!shouldCollapse) {\n visible = items.map((spec, i) => ({\n spec,\n role: i === 0 ? 'root' : (i === items.length - 1 ? 'current' : 'middle') as 'root' | 'middle' | 'current',\n }))\n } else {\n const before = items.slice(0, beforeN).map((spec, i) => ({\n spec,\n role: (i === 0 ? 'root' : 'middle') as 'root' | 'middle' | 'current',\n }))\n const collapsed = items.slice(beforeN, items.length - afterN)\n const after = items.slice(items.length - afterN).map((spec, i, arr) => ({\n spec,\n role: (i === arr.length - 1 ? 'current' : 'middle') as 'root' | 'middle' | 'current',\n }))\n visible = [...before, { ellipsisOf: collapsed }, ...after]\n }\n\n // Interleave with separators\n const rendered: React.ReactNode[] = []\n visible.forEach((entry, i) => {\n if (i > 0) rendered.push(<BreadcrumbSeparator key={`sep-${i}`} />)\n if ('ellipsisOf' in entry) {\n rendered.push(\n <BreadcrumbItem key=\"ellipsis\" role=\"ellipsis\">\n <DropdownMenu>\n <DropdownMenuTrigger asChild>\n <BreadcrumbEllipsis />\n </DropdownMenuTrigger>\n <DropdownMenuContent align=\"start\">\n {entry.ellipsisOf.map((s, j) => (\n <DropdownMenuItem key={j} asChild={!!s.href}>\n {s.href ? <a href={s.href}>{s.label}</a> : <span>{s.label}</span>}\n </DropdownMenuItem>\n ))}\n </DropdownMenuContent>\n </DropdownMenu>\n </BreadcrumbItem>\n )\n } else {\n rendered.push(renderItem(entry.spec, entry.role))\n }\n })\n return rendered\n }, [items, maxItems, itemsBeforeCollapse, itemsAfterCollapse])\n\n // 2026-05-12 fix(user 抓 image 2 Deep story 違反 single-line + max-levels canonical):\n // Compositional path 也走 auto-collapse + flex-shrink hierarchy。Walk children, 找\n // BreadcrumbItem 並按 index 分派 role (first=root / last=current / middle=middle)。\n // > maxItems 自動 collapse 中段成 ellipsis(對齊 declarative path canonical SSOT)。\n const compositionalContent = React.useMemo(() => {\n if (items) return null\n const childArr = React.Children.toArray(children)\n // 抓 BreadcrumbItem children(skip BreadcrumbSeparator — auto re-interleave)\n // 2026-05-12 Round 4.5 fix(codex M31 Layer C 抓):type-identity primary path + displayName fallback。\n // 純 `displayName` check 在 HOC / React.memo / consumer alias 場景脆弱(production build / wrap\n // 可能改寫 displayName)。`c.type === BreadcrumbItem` 是 React fiber reference-identity 最穩\n // primary(對齊 Radix children-walk pattern);displayName fallback 給 HOC 場景。\n const itemChildren = childArr.filter((c): c is React.ReactElement<BreadcrumbItemProps> =>\n React.isValidElement(c) && (c.type === BreadcrumbItem ||\n (c.type as React.ComponentType)?.displayName === 'BreadcrumbItem')\n )\n // 無 item 或全是 separator → pass-through(consumer raw children,e.g. spinners)\n if (itemChildren.length === 0) return children\n // Assign role by position; clone with role prop\n const total = itemChildren.length\n const cloneWithRole = (item: React.ReactElement<BreadcrumbItemProps>, idx: number, role: 'root' | 'middle' | 'current') =>\n React.cloneElement(item, { role: item.props.role ?? role, key: `bc-${role}-${idx}` })\n const shouldCollapse = total > maxItems\n const beforeN = Math.max(0, itemsBeforeCollapse)\n const afterN = Math.max(1, itemsAfterCollapse)\n const rendered: React.ReactNode[] = []\n if (!shouldCollapse) {\n itemChildren.forEach((item, i) => {\n if (i > 0) rendered.push(<BreadcrumbSeparator key={`sep-${i}`} />)\n const role: 'root' | 'middle' | 'current' = i === 0 ? 'root' : (i === total - 1 ? 'current' : 'middle')\n rendered.push(cloneWithRole(item, i, role))\n })\n } else {\n // before(first N) + ellipsis + after(last M)\n const beforeItems = itemChildren.slice(0, beforeN)\n const collapsedItems = itemChildren.slice(beforeN, total - afterN)\n const afterItems = itemChildren.slice(total - afterN)\n beforeItems.forEach((item, i) => {\n if (i > 0) rendered.push(<BreadcrumbSeparator key={`sep-bef-${i}`} />)\n const role: 'root' | 'middle' = i === 0 ? 'root' : 'middle'\n rendered.push(cloneWithRole(item, i, role))\n })\n if (rendered.length > 0) rendered.push(<BreadcrumbSeparator key=\"sep-ellipsis-before\" />)\n rendered.push(\n <BreadcrumbItem key=\"bc-ellipsis\" role=\"ellipsis\">\n <DropdownMenu>\n <DropdownMenuTrigger asChild>\n <BreadcrumbEllipsis />\n </DropdownMenuTrigger>\n <DropdownMenuContent align=\"start\">\n {collapsedItems.map((item, j) => {\n // 2026-05-12 Round 4.5 fix(codex M31 Layer C 抓):consumer BreadcrumbItem children 常包\n // `<BreadcrumbLink href>` = anchor button-like。直接放進 `<DropdownMenuItem>` 會 nested\n // interactive(menuitem within button violates HTML / a11y)。Fix:extract href + label,\n // 用 `asChild` 把 anchor 接到 menuitem 對齊 declarative path line 245 canonical pattern。\n const innerChildren = (item.props as { children?: React.ReactNode }).children\n let href: string | undefined\n let label: React.ReactNode = innerChildren\n React.Children.forEach(innerChildren, (c) => {\n if (React.isValidElement<{ href?: string; children?: React.ReactNode }>(c)) {\n if (c.props.href) href = c.props.href\n if (c.props.children != null) label = c.props.children\n }\n })\n return href\n ? <DropdownMenuItem key={`collapsed-${j}`} asChild><a href={href}>{label}</a></DropdownMenuItem>\n : <DropdownMenuItem key={`collapsed-${j}`}>{label}</DropdownMenuItem>\n })}\n </DropdownMenuContent>\n </DropdownMenu>\n </BreadcrumbItem>\n )\n rendered.push(<BreadcrumbSeparator key=\"sep-ellipsis-after\" />)\n afterItems.forEach((item, i) => {\n if (i > 0) rendered.push(<BreadcrumbSeparator key={`sep-aft-${i}`} />)\n const role: 'middle' | 'current' = i === afterItems.length - 1 ? 'current' : 'middle'\n rendered.push(cloneWithRole(item, i, role))\n })\n }\n return rendered\n }, [items, children, maxItems, itemsBeforeCollapse, itemsAfterCollapse])\n\n return (\n <BreadcrumbContext.Provider value={ctxValue}>\n <ol\n ref={ref}\n // gap-1 (4px) — separator 與兩邊 items 間距;緊湊節奏,符合 breadcrumb 密集流動感。\n // 2026-05-10 Phase A single-line canonical(per user + Material UI source verified):\n // `flex-nowrap` 不 wrap。長路徑走中段折疊。\n // 2026-05-12 fix:compositional 也走 auto-collapse + role-assignment(`compositionalContent`)\n // → declarative / compositional 兩 path 都符合 single-line + max-levels + width 分配 canonical SSOT。\n className={cn(\n 'flex flex-nowrap items-center gap-1 text-fg-secondary leading-compact min-w-0',\n BREADCRUMB_TEXT_CLASS[size],\n className\n )}\n {...props}\n >\n {items ? declarativeContent : compositionalContent}\n </ol>\n </BreadcrumbContext.Provider>\n )\n },\n)\nBreadcrumbList.displayName = 'BreadcrumbList'\n\n// ── BreadcrumbItem (li) ──────────────────────────────────────────────────────\n\n/**\n * Phase B(2026-05-10):`role` prop emit `data-bc-role` attr → CSS flex-shrink hierarchy。\n * Per BreadcrumbItem 在 row 中的角色決定 shrink 優先級:\n * - `root`(首位)→ shrink:3(縮最積極;root context 可弱化)\n * - `middle`(中段)→ shrink:2\n * - `current`(末位 / page)→ shrink:1(最後縮;a11y current page anchor)\n * - `ellipsis`(BreadcrumbEllipsis 包裝)→ shrink:0(永遠完整 ⋯)\n *\n * 設計回應 user 兩 challenges:\n * (a) Root 也 truncate(shrink:3,不是 shrink-0)\n * (b) 不用 fixed max-width — flex-shrink hierarchy 容器寬時自然展開不浪費空間,\n * 窄時按優先級縮 + TruncatedLabel 內部 CSS truncate + tooltip。\n */\ninterface BreadcrumbItemProps extends React.ComponentPropsWithoutRef<'li'> {\n role?: 'root' | 'middle' | 'current' | 'ellipsis'\n}\n\nconst BreadcrumbItem = React.forwardRef<HTMLLIElement, BreadcrumbItemProps>(\n ({ className, role, style, ...props }, ref) => {\n // 2026-05-20 fix v3(user 抓「專案 後方多 4px 間距 / 我的新專案 沒有」chevron 不對稱):\n // v2 `minWidth: '2rem'`(32px)在寬容器強制 li ≥ 32px → 短 label「專案」(natural ~28px)\n // 被撐 4px,長 label「我的新專案」(natural ~70px)hug content → chevron 兩側不對稱。\n //\n // v3 解法:minWidth `2rem` → `1.5rem`(24px)\n // 數學:中文「X…」最小寬度 = 1 char(~14-16px)+ ellipsis(~6-8px)≈ 22-24px → 24px 剛 cover\n // 結果:\n // - 寬容器:所有自然 label ≥ 24px → li hug content,chevron 緊貼,對稱(本 fix 主目的)\n // - 窄容器 truncate:shrink 不過 24px → 「X…」仍可見 ellipsis 保險\n // - 短英文「OK / ID」(natural ~20px)→ 多 ~4px(原 12px → 縮到 4px,顯著改善)\n // 對齊 user verbatim「minWidth 再調小一點」+ ellipsis 數學最小值。\n const shrinkStyle: React.CSSProperties = role === 'root' ? { flexShrink: 3, minWidth: '1.5rem' }\n : role === 'middle' ? { flexShrink: 2, minWidth: '1.5rem' }\n : role === 'current' ? { flexShrink: 1, minWidth: '1.5rem' }\n : role === 'ellipsis' ? { flexShrink: 0 }\n : {}\n return (\n <li\n ref={ref}\n data-bc-role={role}\n className={cn('inline-flex items-center min-w-0', className)}\n style={{ ...shrinkStyle, ...style }}\n {...props}\n />\n )\n }\n)\nBreadcrumbItem.displayName = 'BreadcrumbItem'\n\n// ── BreadcrumbLink (a) ───────────────────────────────────────────────────────\n\ninterface BreadcrumbLinkProps extends React.ComponentPropsWithoutRef<'a'> {\n /** 將樣式套用至子元件(e.g. React Router Link) */\n asChild?: boolean\n /**\n * 起始 icon(per `ui-development.md`「icon prop 命名 4 條」:slot 只接 icon → `startIcon`)。\n * 內部消費 `BREADCRUMB_ICON_SIZE[size]` SSOT,DS 統一尺寸不允許 consumer override。\n * 對齊 uiSize.spec.md Icon Size Tier(2026-05-18 撤回 14 例外,統一 16/16/20)。\n */\n startIcon?: LucideIcon\n}\n\nconst BreadcrumbLink = React.forwardRef<HTMLAnchorElement, BreadcrumbLinkProps>(\n ({ asChild, className, children, startIcon: StartIcon, ...props }, ref) => {\n const { size } = React.useContext(BreadcrumbContext)\n // 2026-05-12 fix(user 抓 image 2 Deep story 麵包屑沒符合 single-line + truncate canonical):\n // 純文字 children → auto-wrap TruncatedLabel(canonical「single-line + ellipsis + tooltip\n // on truncate」per spec.md / Polaris breadcrumb)。Non-string children(consumer 自訂 icon+text\n // 結構)→ pass-through 不 force-wrap(consumer own truncate)。\n const wrappedChildren = typeof children === 'string'\n ? <TruncatedLabel fullText={children}>{children}</TruncatedLabel>\n : children\n const sharedClassName = cn(\n 'inline-flex items-center gap-2',\n 'min-w-0 max-w-full',\n 'text-fg-secondary',\n 'hover:text-primary-hover',\n 'transition-colors duration-150',\n 'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1',\n 'rounded-md',\n className\n )\n // 2026-05-25 fix(user 抓 Breadcrumb asChild story React.Children.only runtime fail):\n // Radix Slot 規範 children 必為單 element;原 unified Comp render 在 asChild path 內\n // 仍輸出「{StartIcon && ...} + {wrappedChildren}」雙 JSX expression → Slot 收到 array\n // → React.Children.only(array) throws「expected to receive a single React element child」。\n // 分支 render 解 — asChild path 只傳 consumer-supplied child(icon 由 consumer 自管,\n // 對齊 Radix Slot canonical「single child contract」);非 asChild path 維持原 native\n // <a> + DS-controlled icon + wrapped label。\n if (asChild) {\n return (\n <Slot ref={ref} className={sharedClassName} {...props}>\n {wrappedChildren}\n </Slot>\n )\n }\n return (\n <a ref={ref} className={sharedClassName} {...props}>\n {StartIcon && <StartIcon size={BREADCRUMB_ICON_SIZE[size]} aria-hidden className=\"shrink-0\" />}\n {wrappedChildren}\n </a>\n )\n }\n)\nBreadcrumbLink.displayName = 'BreadcrumbLink'\n\n// ── BreadcrumbPage (current, non-clickable) ──────────────────────────────────\n\ninterface BreadcrumbPageProps extends React.ComponentPropsWithoutRef<'span'> {\n /** 起始 icon。內部消費 `BREADCRUMB_ICON_SIZE[size]` SSOT。對齊 BreadcrumbLink. */\n startIcon?: LucideIcon\n}\n\nconst BreadcrumbPage = React.forwardRef<HTMLSpanElement, BreadcrumbPageProps>(\n ({ className, children, startIcon: StartIcon, ...props }, ref) => {\n const { size } = React.useContext(BreadcrumbContext)\n // 2026-05-12 fix(同 BreadcrumbLink):純文字 children → auto-wrap TruncatedLabel。\n const wrappedChildren = typeof children === 'string'\n ? <TruncatedLabel fullText={children}>{children}</TruncatedLabel>\n : children\n return (\n <span\n ref={ref}\n role=\"link\"\n aria-disabled=\"true\"\n aria-current=\"page\"\n className={cn('inline-flex items-center gap-2 min-w-0 max-w-full text-foreground', className)}\n {...props}\n >\n {StartIcon && <StartIcon size={BREADCRUMB_ICON_SIZE[size]} aria-hidden className=\"shrink-0\" />}\n {wrappedChildren}\n </span>\n )\n }\n)\nBreadcrumbPage.displayName = 'BreadcrumbPage'\n\n// ── BreadcrumbSeparator ──────────────────────────────────────────────────────\n\ninterface BreadcrumbSeparatorProps extends React.ComponentPropsWithoutRef<'li'> {\n children?: React.ReactNode\n}\n\n// code-quality-allow: long-function — foundational composite main body — 拆 sub-fn 會複雜化 local state / ref / context binding\nconst BreadcrumbSeparator = React.forwardRef<HTMLLIElement, BreadcrumbSeparatorProps>(\n ({ children, className, ...props }, ref) => {\n const { size } = React.useContext(BreadcrumbContext)\n return (\n <li\n ref={ref}\n role=\"presentation\"\n aria-hidden=\"true\"\n // Phase B(2026-05-10):separator 永遠 shrink-0(必完整顯示,否則 path 視覺斷裂)\n className={cn('inline-flex items-center text-fg-muted shrink-0', className)}\n {...props}\n >\n {children ?? <ChevronRight size={BREADCRUMB_ICON_SIZE[size]} aria-hidden />}\n </li>\n )\n }\n)\nBreadcrumbSeparator.displayName = 'BreadcrumbSeparator'\n\n// ── BreadcrumbEllipsis ───────────────────────────────────────────────────────\n\n/**\n * BreadcrumbEllipsis — 折疊路徑的 \"⋯\" 按鈕\n *\n * 2026-05-10 重寫:消費 `ItemInlineActionButton`(primitive SSOT)取代自刻 `<button>`。\n * Per inline-action.spec.md L106-131 predicate Q1+Q2+Q3 全指向 Inline Action:\n * - Q1 點了要做事嗎?是(展開折疊路徑 dropdown)\n * - Q2 位置?BreadcrumbList row inline flow(host 內)\n * - Q3 row 多大?14-16px text row(compact tier)→ Inline Action\n * + 對齊 M1「視覺決策前必消費 SSOT」+ Mindset #2「優先消費既有」。\n *\n * 配合 DropdownMenuTrigger asChild 使用:\n *\n * ```tsx\n * <DropdownMenu>\n * <DropdownMenuTrigger asChild>\n * <BreadcrumbEllipsis />\n * </DropdownMenuTrigger>\n * <DropdownMenuContent>\n * <DropdownMenuItem asChild><a href=\"/org\">組織</a></DropdownMenuItem>\n * </DropdownMenuContent>\n * </DropdownMenu>\n * ```\n *\n * `overlayTrigger=true` 視覺鎖:DropdownMenu open 期間 button 維持 hover bg(對齊\n * shadcn / Radix Themes / Material 的 overlay trigger canonical,inline-action.spec.md\n * 「Overlay trigger canonical」段)。\n */\ntype BreadcrumbEllipsisProps = Omit<React.ComponentPropsWithoutRef<typeof ItemInlineActionButton>, 'icon' | 'size'>\n\nconst BreadcrumbEllipsis = React.forwardRef<HTMLButtonElement, BreadcrumbEllipsisProps>(\n ({ 'aria-label': ariaLabel = '顯示折疊路徑' /* i18n-allow: DS default; consumer override via aria-label prop */, ...props }, ref) => {\n return (\n <ItemInlineActionButton\n ref={ref}\n icon={MoreHorizontal}\n size=\"md\" // Breadcrumb 不在 RowSizeProvider 樹內,固定 md(16px icon + 18px hover bg,對齊 inline-action.spec.md 尺寸表)\n aria-label={ariaLabel}\n overlayTrigger\n {...props}\n />\n )\n }\n)\nBreadcrumbEllipsis.displayName = 'BreadcrumbEllipsis'\n\n// Story auto-compile metadata — Phase 1 mechanical migration(2026-04-24)\n// Phase 2 fill needed: purpose descriptions + when rationale + world-class refs\nexport const breadcrumbMeta = {\n component: 'Breadcrumb',\n family: null, // non-family composite / overlay / layout\n variants: {\n\n },\n sizes: {\n\n },\n states: ['default', 'hover', 'active', 'focus-visible', 'disabled'],\n tokens: {\n bg: [],\n fg: ['text-fg-muted', 'text-fg-secondary', 'text-foreground'],\n ring: ['ring-ring'],\n },\n} as const\n\nexport {\n Breadcrumb,\n BreadcrumbList,\n BreadcrumbItem,\n BreadcrumbLink,\n BreadcrumbPage,\n BreadcrumbSeparator,\n BreadcrumbEllipsis,\n}\nexport type { BreadcrumbSize, BreadcrumbListProps, BreadcrumbEllipsisProps }\n// BreadcrumbItemSpec 已在上方 `export interface BreadcrumbItemSpec` 直接 export\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"breadcrumb.js","sources":["../../../src/components/Breadcrumb/breadcrumb.tsx"],"sourcesContent":["// @benchmark-unverified-blanket: file-level retraction per M22 (d) — claims herein not individually URL-cited; treat as unverified visual/usage rumor unless retrofit per-claim. Hook escape preserved.\n// code-quality-allow: file-size — Breadcrumb 含 BreadcrumbList(主)+ BreadcrumbItem + BreadcrumbEllipsis + items-collapse logic,split 會破壞 collapse/overflow Tooltip subtree\nimport * as React from 'react'\nimport { Slot } from '@radix-ui/react-slot'\nimport { ChevronRight, MoreHorizontal, type LucideIcon } from 'lucide-react'\nimport { cn } from '@/lib/utils'\nimport { ItemInlineActionButton } from '@/design-system/patterns/element-anatomy/item-anatomy'\nimport { Tooltip, TooltipTrigger, TooltipContent } from '@/design-system/components/Tooltip/tooltip'\nimport {\n DropdownMenu,\n DropdownMenuTrigger,\n DropdownMenuContent,\n DropdownMenuItem,\n} from '@/design-system/components/DropdownMenu/dropdown-menu'\n\n// ── TruncatedLabel ────────────────────────────────────────────────────────────\n// 同 `data-table.tsx TruncateCell` + `tag.tsx isTruncated` SSOT pattern\n// (shared ResizeObserver + scrollWidth > clientWidth → wrap Tooltip)。\n// **TODO** future:Rule-of-3 達 → 抽 `patterns/element-anatomy/truncated-text.tsx` 共用\n// (本 component / DataTable TruncateCell / Tag inner 三處同 idiom,符合 M30 SSOT 抽取門檻)。\n\ntype RoCallback = (entry: ResizeObserverEntry) => void\nlet sharedRO: ResizeObserver | null = null\nconst sharedROCallbacks = new WeakMap<Element, RoCallback>()\nfunction getSharedRO(): ResizeObserver {\n if (sharedRO) return sharedRO\n sharedRO = new ResizeObserver((entries) => {\n entries.forEach((e) => {\n const cb = sharedROCallbacks.get(e.target)\n if (cb) cb(e)\n })\n })\n return sharedRO\n}\nfunction observeShared(el: Element, cb: RoCallback): () => void {\n const obs = getSharedRO()\n sharedROCallbacks.set(el, cb)\n obs.observe(el)\n return () => { sharedROCallbacks.delete(el); obs.unobserve(el) }\n}\n\nfunction TruncatedLabel({ children, fullText }: { children: React.ReactNode; fullText?: string }) {\n const ref = React.useRef<HTMLSpanElement>(null)\n const [isTruncated, setIsTruncated] = React.useState(false)\n React.useEffect(() => {\n const el = ref.current\n if (!el) return\n const check = () => setIsTruncated(el.scrollWidth > el.clientWidth)\n check()\n // 2026-05-11 fix:首幀 layout 未完成 / 字型 async load → scrollWidth=clientWidth 假陰性。\n // RAF + 短延遲再驗一次,捕獲字型 / 容器尺寸後變(對齊 TruncateCell / Tag SSOT pattern)。\n const raf = requestAnimationFrame(check)\n const t = setTimeout(check, 100)\n const cleanup = observeShared(el, check)\n return () => {\n cancelAnimationFrame(raf)\n clearTimeout(t)\n cleanup()\n }\n }, [])\n // Tooltip canonical:per `tooltip.principles.stories.tsx:190`「Tooltip 是資訊補救 — 文字被\n // truncate 時才顯示完整內容。沒被截斷就不該顯示 tooltip」\n //\n // 2026-05-11 fix(playwright tooltip-on-truncate 卡 hover 沒 tooltip):\n // 原本 isTruncated=false 直接 return 裸 span / true 才 wrap Tooltip → JSX 樹結構改變\n // → React 把 span unmount + remount(因為 wrapper component 變),ref 換到新 span,\n // useEffect [] 不重跑(同 component instance)→ 觀察的 DOM 跟實際 DOM 對不上。\n // Fix:**永遠 wrap Tooltip**(同 DOM 節點生命週期);`open` 由 isTruncated 控制 —\n // 沒被 truncate 就 force `open={false}`,有 truncate 就 `undefined`(uncontrolled,\n // hover 走 Radix default behavior)。對齊 canonical「沒被截斷就不該 tooltip」。\n return (\n <Tooltip open={isTruncated ? undefined : false}>\n <TooltipTrigger asChild>\n <span ref={ref} className=\"truncate min-w-0 block\">{children}</span>\n </TooltipTrigger>\n <TooltipContent>{fullText ?? children}</TooltipContent>\n </Tooltip>\n )\n}\n\n/**\n * Breadcrumb — 顯示當前頁面在階層中的位置\n *\n * 基於 shadcn/ui Breadcrumb 結構(純 HTML nav + ol + li + a/span),\n * 橋接設計系統 token。\n *\n * ── 結構 ──\n * <Breadcrumb>\n * <BreadcrumbList size=\"md\">\n * <BreadcrumbItem>\n * <BreadcrumbLink href=\"/projects\">專案</BreadcrumbLink>\n * </BreadcrumbItem>\n * <BreadcrumbSeparator />\n * <BreadcrumbItem>\n * <BreadcrumbPage>目前頁面</BreadcrumbPage>\n * </BreadcrumbItem>\n * </BreadcrumbList>\n * </Breadcrumb>\n *\n * ── Size(跟 page title 配對) ──\n * sm text-body(14) → 建議配 text-h4(20) title —— Dialog / panel / drawer\n * md text-body(14) → 建議配 text-h3(24) title —— 一般頁面 header (預設)\n * lg text-body-lg(16) → 建議配 text-h2(32) title —— Detail page hero / landing\n *\n * ── 視覺 ──\n * Link (預設): text-fg-secondary\n * Link hover: text-primary-hover (canonical「互動高亮」, 跟 Tabs / Chip 用法一致)\n * Page (當前): text-foreground(不加粗 — 加粗會讓 breadcrumb 最右端視覺過重,見 spec)\n * Separator: ChevronRight (size 跟 list 一致), text-fg-muted\n *\n * ── 詳見 breadcrumb.spec.md ──\n */\n\n// ── Size context ─────────────────────────────────────────────────────────────\n\ntype BreadcrumbSize = 'sm' | 'md' | 'lg'\n\ninterface BreadcrumbContextValue {\n size: BreadcrumbSize\n}\n\nconst BreadcrumbContext = React.createContext<BreadcrumbContextValue>({ size: 'md' })\n\nconst BREADCRUMB_TEXT_CLASS: Record<BreadcrumbSize, string> = {\n sm: 'text-body',\n md: 'text-body',\n lg: 'text-body-lg',\n}\n\n// Separator / ellipsis icon 尺寸 — 對齊 uiSize.spec.md「Icon Size Tier」(field-height-sm/md→16,lg→20)\n// 2026-05-18 改 per user 拍板「A 先改 16/16/20」+「做完」approval:\n// 撤回 text-flow 例外設計,Breadcrumb chevron 跟其他 chrome icon 同 tier。\n// World-class 對齊:Atlassian Breadcrumb chevron 16 default / Material 3 / Ant Design 同。\nconst BREADCRUMB_ICON_SIZE: Record<BreadcrumbSize, number> = {\n sm: 16,\n md: 16,\n lg: 20,\n}\n\n// ── Breadcrumb (nav root) ────────────────────────────────────────────────────\n\nconst Breadcrumb = React.forwardRef<\n HTMLElement,\n React.ComponentPropsWithoutRef<'nav'>\n>(({ ...props }, ref) => (\n <nav ref={ref} aria-label=\"Breadcrumb\" {...props} />\n))\nBreadcrumb.displayName = 'Breadcrumb'\n\n// ── BreadcrumbList (ol) ──────────────────────────────────────────────────────\n\n/**\n * Phase B(2026-05-10):declarative items mode 啟用 auto-collapse + auto-separator + auto-page-end。\n * 對齊 Material UI source `Breadcrumbs.js renderItemsBeforeAndAfter` mechanism(`maxItems`\n * default 8;本 DS 採 user-tuned 4 — 更積極 collapse 適合 single-line 緊湊 layout)。\n */\n// code-quality-allow: dead-export — public consumer-facing item spec type;對齊 BreadcrumbProps API contract,允許 consumer 構造 items array 外部\nexport interface BreadcrumbItemSpec {\n label: React.ReactNode\n href?: string\n asChild?: boolean\n /**\n * 起始 icon(per `ui-development.md`「icon prop 命名 4 條」:slot 只接 icon → `startIcon`)。\n * 業界慣例:Breadcrumb 首項用 Home icon 強化視覺錨點(Material / Atlassian)。\n * 內部消費 `BREADCRUMB_ICON_SIZE[size]` SSOT(sm/md=16, lg=20,對齊 uiSize.spec.md Icon Size Tier)。\n * Consumer **不傳** size,DS 統一管。\n */\n startIcon?: LucideIcon\n}\n\ninterface BreadcrumbListProps extends Omit<React.ComponentPropsWithoutRef<'ol'>, 'children'> {\n /**\n * 字體尺寸 — 依據與之配對的 page title 選擇:\n * sm → 配 text-h4(20) title (Dialog / panel / drawer)\n * md → 配 text-h3(24) title (一般頁面 header,預設)\n * lg → 配 text-h2(32) title (Detail page hero / landing)\n */\n size?: BreadcrumbSize\n /**\n * Declarative items mode(opt-in)。當 provided 時 `children` 被忽略,List 內部自動:\n * - 插 separator\n * - 末位 spec(無 `href`)自動 BreadcrumbPage(per Title-breadcrumb-end SSOT)\n * - 超 `maxItems` auto-collapse 中段成 BreadcrumbEllipsis + DropdownMenu(對齊 Material UI\n * source `renderItemsBeforeAndAfter`)\n */\n items?: BreadcrumbItemSpec[]\n /**\n * Auto-collapse 閾值。Default 4(user-tuned;Material UI source 預設 8)。`items.length > maxItems`\n * 才 collapse。\n */\n maxItems?: number\n /** Collapse 後保留首 N 個(default 1)。對齊 Material UI source default。 */\n itemsBeforeCollapse?: number\n /** Collapse 後保留末 N 個(default 1)。對齊 Material UI source default。 */\n itemsAfterCollapse?: number\n children?: React.ReactNode\n}\n\n// code-quality-allow: long-function — items props × children narrowing × collapse-with-overflow × tooltip 4 軸組合在 BreadcrumbList,拆 sub-fn 會跨 fn 傳 itemsBeforeCollapse/After collapsed-tooltip refs\nconst BreadcrumbList = React.forwardRef<HTMLOListElement, BreadcrumbListProps>(\n ({ className, size = 'md', items, maxItems = 4, itemsBeforeCollapse = 1, itemsAfterCollapse = 1, children, ...props }, ref) => {\n // Memoize provider value(2026-04-22 D3 perf audit):單 field wrapper memoize\n const ctxValue = React.useMemo(() => ({ size }), [size])\n\n // Declarative mode(items prop provided):自動 render + auto-collapse\n const declarativeContent = React.useMemo(() => {\n if (!items) return null\n // 2026-07-04 修:非字串 label 的 key 原用 Math.random() → 每次 render 新 key 造成\n // BreadcrumbItem unmount/remount(重置 TruncatedLabel ResizeObserver 與 state)→ 改 stable idx key\n const renderItem = (spec: BreadcrumbItemSpec, role: 'root' | 'middle' | 'current', idx: number) => (\n <BreadcrumbItem key={`${role}-${typeof spec.label === 'string' ? spec.label : idx}`} role={role}>\n {role === 'current'\n ? <BreadcrumbPage startIcon={spec.startIcon}>\n <TruncatedLabel fullText={typeof spec.label === 'string' ? spec.label : undefined}>{spec.label}</TruncatedLabel>\n </BreadcrumbPage>\n : <BreadcrumbLink href={spec.href} asChild={spec.asChild} startIcon={spec.startIcon}>\n <TruncatedLabel fullText={typeof spec.label === 'string' ? spec.label : undefined}>{spec.label}</TruncatedLabel>\n </BreadcrumbLink>\n }\n </BreadcrumbItem>\n )\n\n const shouldCollapse = items.length > maxItems\n const beforeN = Math.max(0, itemsBeforeCollapse)\n const afterN = Math.max(1, itemsAfterCollapse) // 末位永遠 ≥ 1(current page)\n\n type VisibleItem = { spec: BreadcrumbItemSpec; role: 'root' | 'middle' | 'current' }\n let visible: Array<VisibleItem | { ellipsisOf: BreadcrumbItemSpec[] }>\n if (!shouldCollapse) {\n visible = items.map((spec, i) => ({\n spec,\n role: i === 0 ? 'root' : (i === items.length - 1 ? 'current' : 'middle') as 'root' | 'middle' | 'current',\n }))\n } else {\n const before = items.slice(0, beforeN).map((spec, i) => ({\n spec,\n role: (i === 0 ? 'root' : 'middle') as 'root' | 'middle' | 'current',\n }))\n const collapsed = items.slice(beforeN, items.length - afterN)\n const after = items.slice(items.length - afterN).map((spec, i, arr) => ({\n spec,\n role: (i === arr.length - 1 ? 'current' : 'middle') as 'root' | 'middle' | 'current',\n }))\n visible = [...before, { ellipsisOf: collapsed }, ...after]\n }\n\n // Interleave with separators\n const rendered: React.ReactNode[] = []\n visible.forEach((entry, i) => {\n if (i > 0) rendered.push(<BreadcrumbSeparator key={`sep-${i}`} />)\n if ('ellipsisOf' in entry) {\n rendered.push(\n <BreadcrumbItem key=\"ellipsis\" role=\"ellipsis\">\n <DropdownMenu>\n <DropdownMenuTrigger asChild>\n <BreadcrumbEllipsis />\n </DropdownMenuTrigger>\n <DropdownMenuContent align=\"start\">\n {entry.ellipsisOf.map((s, j) => (\n <DropdownMenuItem key={j} asChild={!!s.href}>\n {s.href ? <a href={s.href}>{s.label}</a> : <span>{s.label}</span>}\n </DropdownMenuItem>\n ))}\n </DropdownMenuContent>\n </DropdownMenu>\n </BreadcrumbItem>\n )\n } else {\n rendered.push(renderItem(entry.spec, entry.role, i))\n }\n })\n return rendered\n }, [items, maxItems, itemsBeforeCollapse, itemsAfterCollapse])\n\n // 2026-05-12 fix(user 抓 image 2 Deep story 違反 single-line + max-levels canonical):\n // Compositional path 也走 auto-collapse + flex-shrink hierarchy。Walk children, 找\n // BreadcrumbItem 並按 index 分派 role (first=root / last=current / middle=middle)。\n // > maxItems 自動 collapse 中段成 ellipsis(對齊 declarative path canonical SSOT)。\n const compositionalContent = React.useMemo(() => {\n if (items) return null\n const childArr = React.Children.toArray(children)\n // 抓 BreadcrumbItem children(skip BreadcrumbSeparator — auto re-interleave)\n // 2026-05-12 Round 4.5 fix(codex M31 Layer C 抓):type-identity primary path + displayName fallback。\n // 純 `displayName` check 在 HOC / React.memo / consumer alias 場景脆弱(production build / wrap\n // 可能改寫 displayName)。`c.type === BreadcrumbItem` 是 React fiber reference-identity 最穩\n // primary(對齊 Radix children-walk pattern);displayName fallback 給 HOC 場景。\n const itemChildren = childArr.filter((c): c is React.ReactElement<BreadcrumbItemProps> =>\n React.isValidElement(c) && (c.type === BreadcrumbItem ||\n (c.type as React.ComponentType)?.displayName === 'BreadcrumbItem')\n )\n // 無 item 或全是 separator → pass-through(consumer raw children,e.g. spinners)\n if (itemChildren.length === 0) return children\n // Assign role by position; clone with role prop\n const total = itemChildren.length\n const cloneWithRole = (item: React.ReactElement<BreadcrumbItemProps>, idx: number, role: 'root' | 'middle' | 'current') =>\n React.cloneElement(item, { role: item.props.role ?? role, key: `bc-${role}-${idx}` })\n const shouldCollapse = total > maxItems\n const beforeN = Math.max(0, itemsBeforeCollapse)\n const afterN = Math.max(1, itemsAfterCollapse)\n const rendered: React.ReactNode[] = []\n if (!shouldCollapse) {\n itemChildren.forEach((item, i) => {\n if (i > 0) rendered.push(<BreadcrumbSeparator key={`sep-${i}`} />)\n const role: 'root' | 'middle' | 'current' = i === 0 ? 'root' : (i === total - 1 ? 'current' : 'middle')\n rendered.push(cloneWithRole(item, i, role))\n })\n } else {\n // before(first N) + ellipsis + after(last M)\n const beforeItems = itemChildren.slice(0, beforeN)\n const collapsedItems = itemChildren.slice(beforeN, total - afterN)\n const afterItems = itemChildren.slice(total - afterN)\n beforeItems.forEach((item, i) => {\n if (i > 0) rendered.push(<BreadcrumbSeparator key={`sep-bef-${i}`} />)\n const role: 'root' | 'middle' = i === 0 ? 'root' : 'middle'\n rendered.push(cloneWithRole(item, i, role))\n })\n if (rendered.length > 0) rendered.push(<BreadcrumbSeparator key=\"sep-ellipsis-before\" />)\n rendered.push(\n <BreadcrumbItem key=\"bc-ellipsis\" role=\"ellipsis\">\n <DropdownMenu>\n <DropdownMenuTrigger asChild>\n <BreadcrumbEllipsis />\n </DropdownMenuTrigger>\n <DropdownMenuContent align=\"start\">\n {collapsedItems.map((item, j) => {\n // 2026-05-12 Round 4.5 fix(codex M31 Layer C 抓):consumer BreadcrumbItem children 常包\n // `<BreadcrumbLink href>` = anchor button-like。直接放進 `<DropdownMenuItem>` 會 nested\n // interactive(menuitem within button violates HTML / a11y)。Fix:extract href + label,\n // 用 `asChild` 把 anchor 接到 menuitem 對齊 declarative path line 245 canonical pattern。\n const innerChildren = (item.props as { children?: React.ReactNode }).children\n let href: string | undefined\n let label: React.ReactNode = innerChildren\n React.Children.forEach(innerChildren, (c) => {\n if (React.isValidElement<{ href?: string; children?: React.ReactNode }>(c)) {\n if (c.props.href) href = c.props.href\n if (c.props.children != null) label = c.props.children\n }\n })\n return href\n ? <DropdownMenuItem key={`collapsed-${j}`} asChild><a href={href}>{label}</a></DropdownMenuItem>\n : <DropdownMenuItem key={`collapsed-${j}`}>{label}</DropdownMenuItem>\n })}\n </DropdownMenuContent>\n </DropdownMenu>\n </BreadcrumbItem>\n )\n rendered.push(<BreadcrumbSeparator key=\"sep-ellipsis-after\" />)\n afterItems.forEach((item, i) => {\n if (i > 0) rendered.push(<BreadcrumbSeparator key={`sep-aft-${i}`} />)\n const role: 'middle' | 'current' = i === afterItems.length - 1 ? 'current' : 'middle'\n rendered.push(cloneWithRole(item, i, role))\n })\n }\n return rendered\n }, [items, children, maxItems, itemsBeforeCollapse, itemsAfterCollapse])\n\n return (\n <BreadcrumbContext.Provider value={ctxValue}>\n <ol\n ref={ref}\n // gap-1 (4px) — separator 與兩邊 items 間距;緊湊節奏,符合 breadcrumb 密集流動感。\n // 2026-05-10 Phase A single-line canonical(per user + Material UI source verified):\n // `flex-nowrap` 不 wrap。長路徑走中段折疊。\n // 2026-05-12 fix:compositional 也走 auto-collapse + role-assignment(`compositionalContent`)\n // → declarative / compositional 兩 path 都符合 single-line + max-levels + width 分配 canonical SSOT。\n className={cn(\n 'flex flex-nowrap items-center gap-1 text-fg-secondary leading-compact min-w-0',\n BREADCRUMB_TEXT_CLASS[size],\n className\n )}\n {...props}\n >\n {items ? declarativeContent : compositionalContent}\n </ol>\n </BreadcrumbContext.Provider>\n )\n },\n)\nBreadcrumbList.displayName = 'BreadcrumbList'\n\n// ── BreadcrumbItem (li) ──────────────────────────────────────────────────────\n\n/**\n * Phase B(2026-05-10):`role` prop emit `data-bc-role` attr → CSS flex-shrink hierarchy。\n * Per BreadcrumbItem 在 row 中的角色決定 shrink 優先級:\n * - `root`(首位)→ shrink:3(縮最積極;root context 可弱化)\n * - `middle`(中段)→ shrink:2\n * - `current`(末位 / page)→ shrink:1(最後縮;a11y current page anchor)\n * - `ellipsis`(BreadcrumbEllipsis 包裝)→ shrink:0(永遠完整 ⋯)\n *\n * 設計回應 user 兩 challenges:\n * (a) Root 也 truncate(shrink:3,不是 shrink-0)\n * (b) 不用 fixed max-width — flex-shrink hierarchy 容器寬時自然展開不浪費空間,\n * 窄時按優先級縮 + TruncatedLabel 內部 CSS truncate + tooltip。\n */\ninterface BreadcrumbItemProps extends React.ComponentPropsWithoutRef<'li'> {\n role?: 'root' | 'middle' | 'current' | 'ellipsis'\n}\n\nconst BreadcrumbItem = React.forwardRef<HTMLLIElement, BreadcrumbItemProps>(\n ({ className, role, style, ...props }, ref) => {\n // 2026-05-20 fix v3(user 抓「專案 後方多 4px 間距 / 我的新專案 沒有」chevron 不對稱):\n // v2 `minWidth: '2rem'`(32px)在寬容器強制 li ≥ 32px → 短 label「專案」(natural ~28px)\n // 被撐 4px,長 label「我的新專案」(natural ~70px)hug content → chevron 兩側不對稱。\n //\n // v3 解法:minWidth `2rem` → `1.5rem`(24px)\n // 數學:中文「X…」最小寬度 = 1 char(~14-16px)+ ellipsis(~6-8px)≈ 22-24px → 24px 剛 cover\n // 結果:\n // - 寬容器:所有自然 label ≥ 24px → li hug content,chevron 緊貼,對稱(本 fix 主目的)\n // - 窄容器 truncate:shrink 不過 24px → 「X…」仍可見 ellipsis 保險\n // - 短英文「OK / ID」(natural ~20px)→ 多 ~4px(原 12px → 縮到 4px,顯著改善)\n // 對齊 user verbatim「minWidth 再調小一點」+ ellipsis 數學最小值。\n const shrinkStyle: React.CSSProperties = role === 'root' ? { flexShrink: 3, minWidth: '1.5rem' }\n : role === 'middle' ? { flexShrink: 2, minWidth: '1.5rem' }\n : role === 'current' ? { flexShrink: 1, minWidth: '1.5rem' }\n : role === 'ellipsis' ? { flexShrink: 0 }\n : {}\n return (\n <li\n ref={ref}\n data-bc-role={role}\n className={cn('inline-flex items-center min-w-0', className)}\n style={{ ...shrinkStyle, ...style }}\n {...props}\n />\n )\n }\n)\nBreadcrumbItem.displayName = 'BreadcrumbItem'\n\n// ── BreadcrumbLink (a) ───────────────────────────────────────────────────────\n\ninterface BreadcrumbLinkProps extends React.ComponentPropsWithoutRef<'a'> {\n /** 將樣式套用至子元件(e.g. React Router Link) */\n asChild?: boolean\n /**\n * 起始 icon(per `ui-development.md`「icon prop 命名 4 條」:slot 只接 icon → `startIcon`)。\n * 內部消費 `BREADCRUMB_ICON_SIZE[size]` SSOT,DS 統一尺寸不允許 consumer override。\n * 對齊 uiSize.spec.md Icon Size Tier(2026-05-18 撤回 14 例外,統一 16/16/20)。\n */\n startIcon?: LucideIcon\n}\n\nconst BreadcrumbLink = React.forwardRef<HTMLAnchorElement, BreadcrumbLinkProps>(\n ({ asChild, className, children, startIcon: StartIcon, ...props }, ref) => {\n const { size } = React.useContext(BreadcrumbContext)\n // 2026-05-12 fix(user 抓 image 2 Deep story 麵包屑沒符合 single-line + truncate canonical):\n // 純文字 children → auto-wrap TruncatedLabel(canonical「single-line + ellipsis + tooltip\n // on truncate」per spec.md / Polaris breadcrumb)。Non-string children(consumer 自訂 icon+text\n // 結構)→ pass-through 不 force-wrap(consumer own truncate)。\n const wrappedChildren = typeof children === 'string'\n ? <TruncatedLabel fullText={children}>{children}</TruncatedLabel>\n : children\n const sharedClassName = cn(\n 'inline-flex items-center gap-2',\n 'min-w-0 max-w-full',\n 'text-fg-secondary',\n 'hover:text-primary-hover',\n 'transition-colors duration-150',\n 'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1',\n 'rounded-md',\n className\n )\n // 2026-05-25 fix(user 抓 Breadcrumb asChild story React.Children.only runtime fail):\n // Radix Slot 規範 children 必為單 element;原 unified Comp render 在 asChild path 內\n // 仍輸出「{StartIcon && ...} + {wrappedChildren}」雙 JSX expression → Slot 收到 array\n // → React.Children.only(array) throws「expected to receive a single React element child」。\n // 分支 render 解 — asChild path 只傳 consumer-supplied child(icon 由 consumer 自管,\n // 對齊 Radix Slot canonical「single child contract」);非 asChild path 維持原 native\n // <a> + DS-controlled icon + wrapped label。\n if (asChild) {\n return (\n <Slot ref={ref} className={sharedClassName} {...props}>\n {wrappedChildren}\n </Slot>\n )\n }\n return (\n <a ref={ref} className={sharedClassName} {...props}>\n {StartIcon && <StartIcon size={BREADCRUMB_ICON_SIZE[size]} aria-hidden className=\"shrink-0\" />}\n {wrappedChildren}\n </a>\n )\n }\n)\nBreadcrumbLink.displayName = 'BreadcrumbLink'\n\n// ── BreadcrumbPage (current, non-clickable) ──────────────────────────────────\n\ninterface BreadcrumbPageProps extends React.ComponentPropsWithoutRef<'span'> {\n /** 起始 icon。內部消費 `BREADCRUMB_ICON_SIZE[size]` SSOT。對齊 BreadcrumbLink. */\n startIcon?: LucideIcon\n}\n\nconst BreadcrumbPage = React.forwardRef<HTMLSpanElement, BreadcrumbPageProps>(\n ({ className, children, startIcon: StartIcon, ...props }, ref) => {\n const { size } = React.useContext(BreadcrumbContext)\n // 2026-05-12 fix(同 BreadcrumbLink):純文字 children → auto-wrap TruncatedLabel。\n const wrappedChildren = typeof children === 'string'\n ? <TruncatedLabel fullText={children}>{children}</TruncatedLabel>\n : children\n return (\n <span\n ref={ref}\n role=\"link\"\n aria-disabled=\"true\"\n aria-current=\"page\"\n className={cn('inline-flex items-center gap-2 min-w-0 max-w-full text-foreground', className)}\n {...props}\n >\n {StartIcon && <StartIcon size={BREADCRUMB_ICON_SIZE[size]} aria-hidden className=\"shrink-0\" />}\n {wrappedChildren}\n </span>\n )\n }\n)\nBreadcrumbPage.displayName = 'BreadcrumbPage'\n\n// ── BreadcrumbSeparator ──────────────────────────────────────────────────────\n\ninterface BreadcrumbSeparatorProps extends React.ComponentPropsWithoutRef<'li'> {\n children?: React.ReactNode\n}\n\n// code-quality-allow: long-function — foundational composite main body — 拆 sub-fn 會複雜化 local state / ref / context binding\nconst BreadcrumbSeparator = React.forwardRef<HTMLLIElement, BreadcrumbSeparatorProps>(\n ({ children, className, ...props }, ref) => {\n const { size } = React.useContext(BreadcrumbContext)\n return (\n <li\n ref={ref}\n role=\"presentation\"\n aria-hidden=\"true\"\n // Phase B(2026-05-10):separator 永遠 shrink-0(必完整顯示,否則 path 視覺斷裂)\n className={cn('inline-flex items-center text-fg-muted shrink-0', className)}\n {...props}\n >\n {children ?? <ChevronRight size={BREADCRUMB_ICON_SIZE[size]} aria-hidden />}\n </li>\n )\n }\n)\nBreadcrumbSeparator.displayName = 'BreadcrumbSeparator'\n\n// ── BreadcrumbEllipsis ───────────────────────────────────────────────────────\n\n/**\n * BreadcrumbEllipsis — 折疊路徑的 \"⋯\" 按鈕\n *\n * 2026-05-10 重寫:消費 `ItemInlineActionButton`(primitive SSOT)取代自刻 `<button>`。\n * Per inline-action.spec.md L106-131 predicate Q1+Q2+Q3 全指向 Inline Action:\n * - Q1 點了要做事嗎?是(展開折疊路徑 dropdown)\n * - Q2 位置?BreadcrumbList row inline flow(host 內)\n * - Q3 row 多大?14-16px text row(compact tier)→ Inline Action\n * + 對齊 M1「視覺決策前必消費 SSOT」+ Mindset #2「優先消費既有」。\n *\n * 配合 DropdownMenuTrigger asChild 使用:\n *\n * ```tsx\n * <DropdownMenu>\n * <DropdownMenuTrigger asChild>\n * <BreadcrumbEllipsis />\n * </DropdownMenuTrigger>\n * <DropdownMenuContent>\n * <DropdownMenuItem asChild><a href=\"/org\">組織</a></DropdownMenuItem>\n * </DropdownMenuContent>\n * </DropdownMenu>\n * ```\n *\n * `overlayTrigger=true` 視覺鎖:DropdownMenu open 期間 button 維持 hover bg(對齊\n * shadcn / Radix Themes / Material 的 overlay trigger canonical,inline-action.spec.md\n * 「Overlay trigger canonical」段)。\n */\ntype BreadcrumbEllipsisProps = Omit<React.ComponentPropsWithoutRef<typeof ItemInlineActionButton>, 'icon' | 'size'>\n\nconst BreadcrumbEllipsis = React.forwardRef<HTMLButtonElement, BreadcrumbEllipsisProps>(\n ({ 'aria-label': ariaLabel = '顯示折疊路徑' /* i18n-allow: DS default; consumer override via aria-label prop */, ...props }, ref) => {\n return (\n <ItemInlineActionButton\n ref={ref}\n icon={MoreHorizontal}\n size=\"md\" // Breadcrumb 不在 RowSizeProvider 樹內,固定 md(16px icon + 18px hover bg,對齊 inline-action.spec.md 尺寸表)\n aria-label={ariaLabel}\n overlayTrigger\n {...props}\n />\n )\n }\n)\nBreadcrumbEllipsis.displayName = 'BreadcrumbEllipsis'\n\n// Story auto-compile metadata — Phase 1 mechanical migration(2026-04-24)\n// Phase 2 fill needed: purpose descriptions + when rationale + world-class refs\nexport const breadcrumbMeta = {\n component: 'Breadcrumb',\n family: null, // non-family composite / overlay / layout\n variants: {\n\n },\n sizes: {\n // 值源 = code SSOT:BREADCRUMB_SIZE_TEXT(sm/md=text-body, lg=text-body-lg)+ BREADCRUMB_ICON_SIZE(sm/md=16, lg=20)。\n // Breadcrumb 是文字列無固定高度 token,故不列 height(對照 Tag meta 有自身 h-* 才列)。\n sm: { iconSize: 16, typography: 'body' },\n md: { iconSize: 16, typography: 'body' },\n lg: { iconSize: 20, typography: 'body-lg' },\n },\n states: ['default', 'hover', 'active', 'focus-visible', 'disabled'],\n tokens: {\n bg: [],\n fg: ['text-fg-muted', 'text-fg-secondary', 'text-foreground'],\n ring: ['ring-ring'],\n },\n} as const\n\nexport {\n Breadcrumb,\n BreadcrumbList,\n BreadcrumbItem,\n BreadcrumbLink,\n BreadcrumbPage,\n BreadcrumbSeparator,\n BreadcrumbEllipsis,\n}\nexport type { BreadcrumbSize, BreadcrumbListProps, BreadcrumbEllipsisProps }\n// BreadcrumbItemSpec 已在上方 `export interface BreadcrumbItemSpec` 直接 export\n"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export * from './breadcrumb';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Breadcrumb/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAA"}
@@ -0,0 +1,12 @@
1
+ import { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, breadcrumbMeta } from "./breadcrumb.js";
2
+ export {
3
+ Breadcrumb,
4
+ BreadcrumbEllipsis,
5
+ BreadcrumbItem,
6
+ BreadcrumbLink,
7
+ BreadcrumbList,
8
+ BreadcrumbPage,
9
+ BreadcrumbSeparator,
10
+ breadcrumbMeta
11
+ };
12
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
@@ -11,9 +11,9 @@ export interface BulkActionBarProps extends React.HTMLAttributes<HTMLDivElement>
11
11
  selection: readonly string[];
12
12
  /** Clear 觸發,user 點 X icon 或 Esc(consumer 在 page-level 監聽) */
13
13
  onClear?: () => void;
14
- /** 批次 actions(consumer 提供 sm Button,variant=tertiary 或 tertiary+danger;不用 primary) */
14
+ /** 批次 actions(consumer 提供 md Button,variant=tertiary 或 tertiary+danger;不用 primary) */
15
15
  actions?: React.ReactNode;
16
- /** Filter 模式:hidden 數量,顯示在 count 區 inline{N} 已選 · {M} 個被 filter 隱藏」 */
16
+ /** Filter 模式:hidden 數量,顯示在 count 區 inline「已選 {N} · {M} 個被 filter 隱藏」 */
17
17
  hiddenByFilter?: number;
18
18
  /**
19
19
  * 「擴選整個 dataset」狀態(2026-05-13 ship,per user 抓 Alert「已選 5370」但 BulkActionBar
@@ -38,7 +38,7 @@ export declare const bulkActionBarMeta: {
38
38
  readonly sizes: {};
39
39
  readonly states: readonly ["default"];
40
40
  readonly tokens: {
41
- readonly fg: readonly ["text-fg-secondary", "text-fg-muted"];
41
+ readonly fg: readonly ["text-foreground", "text-fg-muted"];
42
42
  readonly border: readonly ["border-divider"];
43
43
  };
44
44
  };
@@ -1 +1 @@
1
- {"version":3,"file":"bulk-action-bar.d.ts","sourceRoot":"","sources":["../../../src/components/BulkActionBar/bulk-action-bar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAmB9B,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAA;IACxC,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAGD,eAAO,MAAM,8BAA8B,EAAE,mBAK5C,CAAA;AAID,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC9E,wCAAwC;IACxC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,sFAAsF;IACtF,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAA;CACtC;AAeD,QAAA,MAAM,aAAa,2FAiElB,CAAA;AAID,eAAO,MAAM,iBAAiB;;;;;;;;;;CAUpB,CAAA;AAEV,OAAO,EAAE,aAAa,EAAE,CAAA"}
1
+ {"version":3,"file":"bulk-action-bar.d.ts","sourceRoot":"","sources":["../../../src/components/BulkActionBar/bulk-action-bar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAmB9B,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAA;IACxC,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAGD,eAAO,MAAM,8BAA8B,EAAE,mBAK5C,CAAA;AAID,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC9E,wCAAwC;IACxC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,sFAAsF;IACtF,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAA;CACtC;AAeD,QAAA,MAAM,aAAa,2FAmElB,CAAA;AAID,eAAO,MAAM,iBAAiB;;;;;;;;;;CAUpB,CAAA;AAEV,OAAO,EAAE,aAAa,EAAE,CAAA"}
@@ -16,7 +16,7 @@ const BulkActionBar = React.forwardRef(
16
16
  () => ({ ...BULK_ACTION_BAR_DEFAULT_LABELS, ...labelsOverride }),
17
17
  [labelsOverride]
18
18
  );
19
- if (selection.length === 0) return null;
19
+ if (selection.length === 0 && (totalSelected ?? 0) === 0) return null;
20
20
  return /* @__PURE__ */ jsxs(
21
21
  "div",
22
22
  {
@@ -44,7 +44,7 @@ const BulkActionBar = React.forwardRef(
44
44
  onClick: onClear
45
45
  }
46
46
  ),
47
- /* @__PURE__ */ jsxs("span", { className: "text-body text-foreground tabular-nums", children: [
47
+ /* @__PURE__ */ jsxs("span", { className: "text-body text-foreground font-medium tabular-nums", "aria-live": "polite", "aria-atomic": "true", children: [
48
48
  labels.count(typeof totalSelected === "number" ? totalSelected : selection.length),
49
49
  hiddenByFilter !== void 0 && hiddenByFilter > 0 && /* @__PURE__ */ jsxs("span", { className: "text-fg-muted font-normal", children: [
50
50
  " ",
@@ -66,7 +66,7 @@ const bulkActionBarMeta = {
66
66
  sizes: {},
67
67
  states: ["default"],
68
68
  tokens: {
69
- fg: ["text-fg-secondary", "text-fg-muted"],
69
+ fg: ["text-foreground", "text-fg-muted"],
70
70
  border: ["border-divider"]
71
71
  }
72
72
  };
@@ -1 +1 @@
1
- {"version":3,"file":"bulk-action-bar.js","sources":["../../../src/components/BulkActionBar/bulk-action-bar.tsx"],"sourcesContent":["import * as React from 'react'\nimport { X } from 'lucide-react'\nimport { cn } from '@/lib/utils'\nimport { Button } from '@/design-system/components/Button/button'\nimport { ButtonDivider } from '@/design-system/components/Button/button-group'\n\n// ── 消費的 SSOT ───────────────────────────────────────────────────────────────\n// - bulk-action-bar.spec.md(本元件 SSOT)\n// - DataTable/data-table.spec.md「L2 選取」(整合方式)\n// - button.spec.md + button-group.tsx(action variant=tertiary,size=sm,\n// gap-2 + ButtonDivider 自帶 mx-1 = 12px 視覺距離)\n// - inline-action.spec.md「same-row consistency rule」(close X 同尺寸 sm)\n// - tokens/layoutSpace/layoutSpace.spec.md(footer 用 px-loose py-tight)\n// - patterns/overlay-surface/overlay-surface.spec.md SurfaceFooter canonical\n// - Alert(banner)用 description ReactNode 帶 inline link CTA\n\n// ── i18n labels ─────────────────────────────────────────────────────────────\n\n// code-quality-allow: dead-export — public API per spec.md(consumer i18n override hook)\nexport interface BulkActionBarLabels {\n count: (n: number) => string\n clear: string\n hiddenSuffix: (hidden: number) => string\n toolbarAriaLabel: string\n}\n\n// code-quality-allow: dead-export — public API per spec.md(consumer spread + override)\nexport const BULK_ACTION_BAR_DEFAULT_LABELS: BulkActionBarLabels = {\n count: (n) => `已選 ${n} 項`,\n clear: '清除選取',\n hiddenSuffix: (hidden) => `· ${hidden} 個被 filter 隱藏`,\n toolbarAriaLabel: '批次操作',\n}\n\n// ── Props ───────────────────────────────────────────────────────────────────\n\nexport interface BulkActionBarProps extends React.HTMLAttributes<HTMLDivElement> {\n /** 已選 ID,length === 0 時自動隱藏(回傳 null) */\n selection: readonly string[]\n /** Clear 觸發,user 點 X icon 或 Esc(consumer 在 page-level 監聽) */\n onClear?: () => void\n /** 批次 actions(consumer 提供 sm Button,variant=tertiary 或 tertiary+danger;不用 primary) */\n actions?: React.ReactNode\n /** Filter 模式:hidden 數量,顯示在 count 區 inline{N} 已選 · {M} 個被 filter 隱藏」 */\n hiddenByFilter?: number\n /**\n * 「擴選整個 dataset」狀態(2026-05-13 ship,per user 抓 Alert「已選 5370」但 BulkActionBar\n * 仍顯「已選 50 項」regression):\n * - undefined / null(default):count 走 `selection.length`(page-level 視覺選取)\n * - number:count 走此數值(整個 dataset 擴選後 user 已選的真總數)\n *\n * Canonical pattern:consumer 把 BulkActionBar 跟「Alert info banner(提示擴選 dataset)」\n * 一起 mount,Alert 點「點此選取全部 N 個」→ setTotalSelected(N) → BulkActionBar count 同步。\n * 對齊 Gmail / Linear / Notion 全選 dataset hint pattern。\n * 詳 `bulk-action-bar.spec.md`「Extend dataset pattern」段。\n */\n totalSelected?: number | null\n /** i18n labels(Partial,merge with default) */\n labels?: Partial<BulkActionBarLabels>\n}\n\n// ── Component ───────────────────────────────────────────────────────────────\n// 視覺結構(同 SurfaceFooter / DataTable toolbar canonical):\n// px-[var(--layout-space-loose)] py-[var(--layout-space-tight)]\n// gap-2 between elements\n// 全 sm Buttons(same-row consistency)\n// <ButtonDivider /> 自帶 mx-1 = 12px 視覺距離\n//\n// Hint banner(擴 dataset 提示)完全外包給 Alert 元件 — consumer 視 ref 圖\n// 黏在 BulkActionBar 上方/下方,用 Alert variant=\"info\" placement=\"fixed\"\n// description={inline link JSX}。BulkActionBar 自己不再有 hint banner slot。\n//\n// 浮起 / fixed positioning 由 consumer wrap 決定(BulkActionBar 不限定 placement)。\n\nconst BulkActionBar = React.forwardRef<HTMLDivElement, BulkActionBarProps>(\n function BulkActionBar(\n { selection, onClear, actions, hiddenByFilter, totalSelected, labels: labelsOverride, className, ...props },\n ref\n ) {\n const labels: BulkActionBarLabels = React.useMemo(\n () => ({ ...BULK_ACTION_BAR_DEFAULT_LABELS, ...labelsOverride }),\n [labelsOverride]\n )\n\n // selection.length === 0 自動藏(對齊 spec 禁止事項 #3)\n if (selection.length === 0) return null\n\n return (\n <div\n ref={ref}\n role=\"toolbar\"\n aria-label={labels.toolbarAriaLabel}\n className={cn(\n 'flex items-center gap-2',\n 'px-[var(--layout-space-loose)] py-[var(--layout-space-tight)]',\n // 上分隔線:bottom toolbar canonical(Linear / Apple Mail / Notion 共識)— 視覺從上方內容收尾\n 'border-t border-divider',\n className\n )}\n {...props}\n >\n {/* X close — md dismiss(2026-05-04 spec update:default placement = footer variant,\n visual weight 對齊 Dialog footer commitment buttons md;same-row consistency 維持)\n 未來若有 top-toolbar variant(覆蓋 sm-density toolbar)→ 該 variant override sm */}\n {onClear && (\n <Button\n variant=\"text\"\n size=\"md\"\n iconOnly\n dismiss\n startIcon={X}\n aria-label={labels.clear}\n onClick={onClear}\n />\n )}\n\n {/* count + filter hidden inline\n color canonical(2026-05-04):count = primary foreground + medium weight\n 理由:count 是 state-bearing 主資訊(「你在 selection mode + N items」),非裝飾\n World-class 共識:Linear/Notion/Carbon/Polaris 均用 primary foreground;muted 化弱化 state signal\n hiddenByFilter suffix 維持 muted(這是次資訊,視覺層次正確) */}\n <span className=\"text-body text-foreground tabular-nums\">\n {/* 2026-05-13:totalSelected override 走 dataset 擴選後真總數,否則 fallback page-level selection.length */}\n {labels.count(typeof totalSelected === 'number' ? totalSelected : selection.length)}\n {hiddenByFilter !== undefined && hiddenByFilter > 0 && (\n <span className=\"text-fg-muted font-normal\"> {labels.hiddenSuffix(hiddenByFilter)}</span>\n )}\n </span>\n\n {/* divider */}\n {actions && <ButtonDivider />}\n\n {/* batch actions slot(consumer 提供 sm Buttons) */}\n {actions && (\n <div className=\"flex items-center gap-2 flex-1 min-w-0\">{actions}</div>\n )}\n </div>\n )\n }\n)\nBulkActionBar.displayName = 'BulkActionBar'\n\n// Story auto-compile metadata\nexport const bulkActionBarMeta = {\n component: 'BulkActionBar',\n family: null,\n variants: {},\n sizes: {},\n states: ['default'],\n tokens: {\n fg: ['text-fg-secondary', 'text-fg-muted'],\n border: ['border-divider'],\n },\n} as const\n\nexport { BulkActionBar }\n"],"names":["BulkActionBar"],"mappings":";;;;;;AA2BO,MAAM,iCAAsD;AAAA,EACjE,OAAO,CAAC,MAAM,MAAM,CAAC;AAAA,EACrB,OAAO;AAAA,EACP,cAAc,CAAC,WAAW,KAAK,MAAM;AAAA,EACrC,kBAAkB;AACpB;AA0CA,MAAM,gBAAgB,MAAM;AAAA,EAC1B,SAASA,eACP,EAAE,WAAW,SAAS,SAAS,gBAAgB,eAAe,QAAQ,gBAAgB,WAAW,GAAG,MAAA,GACpG,KACA;AACA,UAAM,SAA8B,MAAM;AAAA,MACxC,OAAO,EAAE,GAAG,gCAAgC,GAAG;MAC/C,CAAC,cAAc;AAAA,IAAA;AAIjB,QAAI,UAAU,WAAW,EAAG,QAAO;AAEnC,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,MAAK;AAAA,QACL,cAAY,OAAO;AAAA,QACnB,WAAW;AAAA,UACT;AAAA,UACA;AAAA;AAAA,UAEA;AAAA,UACA;AAAA,QAAA;AAAA,QAED,GAAG;AAAA,QAKH,UAAA;AAAA,UAAA,WACC;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,SAAQ;AAAA,cACR,MAAK;AAAA,cACL,UAAQ;AAAA,cACR,SAAO;AAAA,cACP,WAAW;AAAA,cACX,cAAY,OAAO;AAAA,cACnB,SAAS;AAAA,YAAA;AAAA,UAAA;AAAA,UASb,qBAAC,QAAA,EAAK,WAAU,0CAEb,UAAA;AAAA,YAAA,OAAO,MAAM,OAAO,kBAAkB,WAAW,gBAAgB,UAAU,MAAM;AAAA,YACjF,mBAAmB,UAAa,iBAAiB,KAChD,qBAAC,QAAA,EAAK,WAAU,6BAA4B,UAAA;AAAA,cAAA;AAAA,cAAE,OAAO,aAAa,cAAc;AAAA,YAAA,EAAA,CAAE;AAAA,UAAA,GAEtF;AAAA,UAGC,+BAAY,eAAA,EAAc;AAAA,UAG1B,WACC,oBAAC,OAAA,EAAI,WAAU,0CAA0C,UAAA,QAAA,CAAQ;AAAA,QAAA;AAAA,MAAA;AAAA,IAAA;AAAA,EAIzE;AACF;AACA,cAAc,cAAc;AAGrB,MAAM,oBAAoB;AAAA,EAC/B,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,UAAU,CAAA;AAAA,EACV,OAAO,CAAA;AAAA,EACP,QAAQ,CAAC,SAAS;AAAA,EAClB,QAAQ;AAAA,IACN,IAAI,CAAC,qBAAqB,eAAe;AAAA,IACzC,QAAQ,CAAC,gBAAgB;AAAA,EAAA;AAE7B;"}
1
+ {"version":3,"file":"bulk-action-bar.js","sources":["../../../src/components/BulkActionBar/bulk-action-bar.tsx"],"sourcesContent":["import * as React from 'react'\nimport { X } from 'lucide-react'\nimport { cn } from '@/lib/utils'\nimport { Button } from '@/design-system/components/Button/button'\nimport { ButtonDivider } from '@/design-system/components/Button/button-group'\n\n// ── 消費的 SSOT ───────────────────────────────────────────────────────────────\n// - bulk-action-bar.spec.md(本元件 SSOT)\n// - DataTable/data-table.spec.md「L2 選取」(整合方式)\n// - button.spec.md + button-group.tsx(action variant=tertiary,size=md,\n// gap-2 + ButtonDivider 自帶 mx-1 = 12px 視覺距離)\n// - inline-action.spec.md「same-row consistency rule」(close X 同尺寸 md)\n// - tokens/layoutSpace/layoutSpace.spec.md(footer 用 px-loose py-tight)\n// - patterns/overlay-surface/overlay-surface.spec.md SurfaceFooter canonical\n// - Alert(banner)用 title ReactNode 帶 inline link CTA\n\n// ── i18n labels ─────────────────────────────────────────────────────────────\n\n// code-quality-allow: dead-export — public API per spec.md(consumer i18n override hook)\nexport interface BulkActionBarLabels {\n count: (n: number) => string\n clear: string\n hiddenSuffix: (hidden: number) => string\n toolbarAriaLabel: string\n}\n\n// code-quality-allow: dead-export — public API per spec.md(consumer spread + override)\nexport const BULK_ACTION_BAR_DEFAULT_LABELS: BulkActionBarLabels = {\n count: (n) => `已選 ${n} 項`,\n clear: '清除選取',\n hiddenSuffix: (hidden) => `· ${hidden} 個被 filter 隱藏`,\n toolbarAriaLabel: '批次操作',\n}\n\n// ── Props ───────────────────────────────────────────────────────────────────\n\nexport interface BulkActionBarProps extends React.HTMLAttributes<HTMLDivElement> {\n /** 已選 ID,length === 0 時自動隱藏(回傳 null) */\n selection: readonly string[]\n /** Clear 觸發,user 點 X icon 或 Esc(consumer 在 page-level 監聽) */\n onClear?: () => void\n /** 批次 actions(consumer 提供 md Button,variant=tertiary 或 tertiary+danger;不用 primary) */\n actions?: React.ReactNode\n /** Filter 模式:hidden 數量,顯示在 count 區 inline「已選 {N} · {M} 個被 filter 隱藏」 */\n hiddenByFilter?: number\n /**\n * 「擴選整個 dataset」狀態(2026-05-13 ship,per user 抓 Alert「已選 5370」但 BulkActionBar\n * 仍顯「已選 50 項」regression):\n * - undefined / null(default):count 走 `selection.length`(page-level 視覺選取)\n * - number:count 走此數值(整個 dataset 擴選後 user 已選的真總數)\n *\n * Canonical pattern:consumer 把 BulkActionBar 跟「Alert info banner(提示擴選 dataset)」\n * 一起 mount,Alert 點「點此選取全部 N 個」→ setTotalSelected(N) → BulkActionBar count 同步。\n * 對齊 Gmail / Linear / Notion 全選 dataset hint pattern。\n * 詳 `bulk-action-bar.spec.md`「Extend dataset pattern」段。\n */\n totalSelected?: number | null\n /** i18n labels(Partial,merge with default) */\n labels?: Partial<BulkActionBarLabels>\n}\n\n// ── Component ───────────────────────────────────────────────────────────────\n// 視覺結構(同 SurfaceFooter / DataTable toolbar canonical):\n// px-[var(--layout-space-loose)] py-[var(--layout-space-tight)]\n// gap-2 between elements\n// 全 md Buttons(same-row consistency)\n// <ButtonDivider /> 自帶 mx-1 = 12px 視覺距離\n//\n// Hint banner(擴 dataset 提示)完全外包給 Alert 元件 — consumer 視 ref 圖\n// 黏在 BulkActionBar 上方/下方,用 Alert variant=\"info\" placement=\"fixed\"\n// title={inline link JSX}。BulkActionBar 自己不再有 hint banner slot。\n//\n// 浮起 / fixed positioning 由 consumer wrap 決定(BulkActionBar 不限定 placement)。\n\nconst BulkActionBar = React.forwardRef<HTMLDivElement, BulkActionBarProps>(\n function BulkActionBar(\n { selection, onClear, actions, hiddenByFilter, totalSelected, labels: labelsOverride, className, ...props },\n ref\n ) {\n const labels: BulkActionBarLabels = React.useMemo(\n () => ({ ...BULK_ACTION_BAR_DEFAULT_LABELS, ...labelsOverride }),\n [labelsOverride]\n )\n\n // selection.length === 0 自動藏(對齊 spec 禁止事項 #3)。\n // 反向選取(DataTable all 模式)例外:visible 全被 excluded 但 totalSelected>0 仍有選取 → 顯示(2026-06-22)\n if (selection.length === 0 && (totalSelected ?? 0) === 0) return null\n\n return (\n <div\n ref={ref}\n role=\"toolbar\"\n aria-label={labels.toolbarAriaLabel}\n className={cn(\n 'flex items-center gap-2',\n 'px-[var(--layout-space-loose)] py-[var(--layout-space-tight)]',\n // 上分隔線:bottom toolbar canonical(Linear / Apple Mail / Notion 共識)— 視覺從上方內容收尾\n 'border-t border-divider',\n className\n )}\n {...props}\n >\n {/* X close — md dismiss(2026-05-04 spec update:default placement = footer variant,\n visual weight 對齊 Dialog footer commitment buttons md;same-row consistency 維持)\n 未來若有 top-toolbar variant(覆蓋 sm-density toolbar)→ 該 variant override sm */}\n {onClear && (\n <Button\n variant=\"text\"\n size=\"md\"\n iconOnly\n dismiss\n startIcon={X}\n aria-label={labels.clear}\n onClick={onClear}\n />\n )}\n\n {/* count + filter hidden inline\n color canonical(2026-05-04):count = primary foreground + medium weight\n 理由:count 是 state-bearing 主資訊(「你在 selection mode + N items」),非裝飾\n World-class 共識:Linear/Notion/Carbon/Polaris 均用 primary foreground;muted 化弱化 state signal\n hiddenByFilter suffix 維持 muted(這是次資訊,視覺層次正確) */}\n {/* 2026-05-31 #3:aria-live 通知 SR 選取數變更;#20:補 font-medium 對齊 spec「Count text color canonical」表 + 上方 comment(state-bearing 主資訊) */}\n <span className=\"text-body text-foreground font-medium tabular-nums\" aria-live=\"polite\" aria-atomic=\"true\">\n {/* 2026-05-13:totalSelected override 走 dataset 擴選後真總數,否則 fallback page-level selection.length */}\n {labels.count(typeof totalSelected === 'number' ? totalSelected : selection.length)}\n {hiddenByFilter !== undefined && hiddenByFilter > 0 && (\n <span className=\"text-fg-muted font-normal\"> {labels.hiddenSuffix(hiddenByFilter)}</span>\n )}\n </span>\n\n {/* divider */}\n {actions && <ButtonDivider />}\n\n {/* batch actions slot(consumer 提供 md Buttons) */}\n {actions && (\n <div className=\"flex items-center gap-2 flex-1 min-w-0\">{actions}</div>\n )}\n </div>\n )\n }\n)\nBulkActionBar.displayName = 'BulkActionBar'\n\n// Story auto-compile metadata\nexport const bulkActionBarMeta = {\n component: 'BulkActionBar',\n family: null,\n variants: {},\n sizes: {},\n states: ['default'],\n tokens: {\n fg: ['text-foreground', 'text-fg-muted'],\n border: ['border-divider'],\n },\n} as const\n\nexport { BulkActionBar }\n"],"names":["BulkActionBar"],"mappings":";;;;;;AA2BO,MAAM,iCAAsD;AAAA,EACjE,OAAO,CAAC,MAAM,MAAM,CAAC;AAAA,EACrB,OAAO;AAAA,EACP,cAAc,CAAC,WAAW,KAAK,MAAM;AAAA,EACrC,kBAAkB;AACpB;AA0CA,MAAM,gBAAgB,MAAM;AAAA,EAC1B,SAASA,eACP,EAAE,WAAW,SAAS,SAAS,gBAAgB,eAAe,QAAQ,gBAAgB,WAAW,GAAG,MAAA,GACpG,KACA;AACA,UAAM,SAA8B,MAAM;AAAA,MACxC,OAAO,EAAE,GAAG,gCAAgC,GAAG;MAC/C,CAAC,cAAc;AAAA,IAAA;AAKjB,QAAI,UAAU,WAAW,MAAM,iBAAiB,OAAO,EAAG,QAAO;AAEjE,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,MAAK;AAAA,QACL,cAAY,OAAO;AAAA,QACnB,WAAW;AAAA,UACT;AAAA,UACA;AAAA;AAAA,UAEA;AAAA,UACA;AAAA,QAAA;AAAA,QAED,GAAG;AAAA,QAKH,UAAA;AAAA,UAAA,WACC;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,SAAQ;AAAA,cACR,MAAK;AAAA,cACL,UAAQ;AAAA,cACR,SAAO;AAAA,cACP,WAAW;AAAA,cACX,cAAY,OAAO;AAAA,cACnB,SAAS;AAAA,YAAA;AAAA,UAAA;AAAA,+BAUZ,QAAA,EAAK,WAAU,sDAAqD,aAAU,UAAS,eAAY,QAEjG,UAAA;AAAA,YAAA,OAAO,MAAM,OAAO,kBAAkB,WAAW,gBAAgB,UAAU,MAAM;AAAA,YACjF,mBAAmB,UAAa,iBAAiB,KAChD,qBAAC,QAAA,EAAK,WAAU,6BAA4B,UAAA;AAAA,cAAA;AAAA,cAAE,OAAO,aAAa,cAAc;AAAA,YAAA,EAAA,CAAE;AAAA,UAAA,GAEtF;AAAA,UAGC,+BAAY,eAAA,EAAc;AAAA,UAG1B,WACC,oBAAC,OAAA,EAAI,WAAU,0CAA0C,UAAA,QAAA,CAAQ;AAAA,QAAA;AAAA,MAAA;AAAA,IAAA;AAAA,EAIzE;AACF;AACA,cAAc,cAAc;AAGrB,MAAM,oBAAoB;AAAA,EAC/B,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,UAAU,CAAA;AAAA,EACV,OAAO,CAAA;AAAA,EACP,QAAQ,CAAC,SAAS;AAAA,EAClB,QAAQ;AAAA,IACN,IAAI,CAAC,mBAAmB,eAAe;AAAA,IACvC,QAAQ,CAAC,gBAAgB;AAAA,EAAA;AAE7B;"}
@@ -0,0 +1,2 @@
1
+ export * from './bulk-action-bar';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/BulkActionBar/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAA"}