@godxjp/ui 19.0.0 → 19.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (445) hide show
  1. package/README.md +25 -128
  2. package/dist/app/app-provider.d.ts +1 -1
  3. package/dist/app/app-provider.js +3 -0
  4. package/dist/app/theme-axes.d.ts +4 -15
  5. package/dist/app/timezones.d.ts +1 -4
  6. package/dist/components/charts/area-chart.d.ts +2 -3
  7. package/dist/components/charts/bar-chart.d.ts +2 -3
  8. package/dist/components/charts/chart-frame.d.ts +7 -16
  9. package/dist/components/charts/chart-summary.d.ts +2 -2
  10. package/dist/components/charts/compact-bar-trend.d.ts +9 -24
  11. package/dist/components/charts/index.d.ts +1 -6
  12. package/dist/components/data-display/badge.d.ts +2 -12
  13. package/dist/components/data-display/card.d.ts +21 -41
  14. package/dist/components/data-display/carousel.d.ts +1 -2
  15. package/dist/components/data-display/code-block.d.ts +4 -0
  16. package/dist/components/data-display/code-block.js +24 -0
  17. package/dist/components/data-display/data-table.d.ts +15 -37
  18. package/dist/components/data-display/data-table.js +1 -3
  19. package/dist/components/data-display/descriptions.d.ts +2 -6
  20. package/dist/components/data-display/descriptions.js +0 -2
  21. package/dist/components/data-display/index.d.ts +4 -0
  22. package/dist/components/data-display/index.js +4 -0
  23. package/dist/components/data-display/list-row.d.ts +3 -22
  24. package/dist/components/data-display/permission-matrix.d.ts +7 -20
  25. package/dist/components/data-display/progress.d.ts +1 -1
  26. package/dist/components/data-display/prose.d.ts +4 -0
  27. package/dist/components/data-display/prose.js +20 -0
  28. package/dist/components/data-display/service-launcher-card.d.ts +3 -10
  29. package/dist/components/data-display/table.d.ts +20 -80
  30. package/dist/components/data-display/table.js +0 -3
  31. package/dist/components/data-display/timeline.d.ts +3 -5
  32. package/dist/components/data-entry/branch-scope-picker.d.ts +2 -19
  33. package/dist/components/data-entry/branch-scope-picker.js +0 -1
  34. package/dist/components/data-entry/calendar.d.ts +3 -2
  35. package/dist/components/data-entry/calendar.js +58 -3
  36. package/dist/components/data-entry/cascader.js +3 -1
  37. package/dist/components/data-entry/checkbox-group.js +12 -5
  38. package/dist/components/data-entry/checkbox.js +30 -21
  39. package/dist/components/data-entry/command-palette.d.ts +8 -22
  40. package/dist/components/data-entry/date-picker.d.ts +4 -5
  41. package/dist/components/data-entry/date-picker.js +12 -3
  42. package/dist/components/data-entry/date-range-picker.d.ts +1 -1
  43. package/dist/components/data-entry/date-range-picker.js +17 -6
  44. package/dist/components/data-entry/form-errors.d.ts +7 -18
  45. package/dist/components/data-entry/form-field.d.ts +1 -1
  46. package/dist/components/data-entry/form-field.js +15 -6
  47. package/dist/components/data-entry/form.d.ts +1 -9
  48. package/dist/components/data-entry/input.d.ts +16 -14
  49. package/dist/components/data-entry/input.js +13 -3
  50. package/dist/components/data-entry/month-picker.js +6 -4
  51. package/dist/components/data-entry/month-range-picker.d.ts +4 -6
  52. package/dist/components/data-entry/month-range-picker.js +11 -5
  53. package/dist/components/data-entry/number-input.d.ts +1 -5
  54. package/dist/components/data-entry/number-input.js +1 -0
  55. package/dist/components/data-entry/radio.js +19 -6
  56. package/dist/components/data-entry/search-select.d.ts +3 -5
  57. package/dist/components/data-entry/search-select.js +8 -2
  58. package/dist/components/data-entry/select.d.ts +15 -2
  59. package/dist/components/data-entry/select.js +57 -10
  60. package/dist/components/data-entry/switch.js +9 -2
  61. package/dist/components/data-entry/textarea.d.ts +10 -16
  62. package/dist/components/data-entry/textarea.js +8 -1
  63. package/dist/components/data-entry/time-picker.d.ts +3 -5
  64. package/dist/components/data-entry/tree-select.js +3 -1
  65. package/dist/components/data-entry/upload-types.d.ts +1 -5
  66. package/dist/components/data-entry/use-upload-draft.d.ts +0 -4
  67. package/dist/components/feedback/dialog.d.ts +6 -15
  68. package/dist/components/feedback/overlay-header-tone.d.ts +1 -1
  69. package/dist/components/feedback/sheet.d.ts +3 -10
  70. package/dist/components/feedback/sheet.js +1 -1
  71. package/dist/components/feedback/sonner.js +2 -3
  72. package/dist/components/general/activity.d.ts +4 -30
  73. package/dist/components/general/button.js +1 -10
  74. package/dist/components/general/logo.d.ts +6 -28
  75. package/dist/components/general/reveal.d.ts +3 -9
  76. package/dist/components/general/typography.d.ts +1 -3
  77. package/dist/components/layout/account-chip.d.ts +8 -0
  78. package/dist/components/layout/account-chip.js +45 -0
  79. package/dist/components/layout/auth-divider.d.ts +2 -9
  80. package/dist/components/layout/auth-shell.d.ts +1 -14
  81. package/dist/components/layout/breadcrumb.d.ts +1 -5
  82. package/dist/components/layout/centered-shell.d.ts +4 -18
  83. package/dist/components/layout/error-surface.d.ts +11 -28
  84. package/dist/components/layout/error-surface.js +4 -1
  85. package/dist/components/layout/index.d.ts +2 -0
  86. package/dist/components/layout/index.js +2 -0
  87. package/dist/components/layout/legal-document-shell.d.ts +5 -28
  88. package/dist/components/layout/master-detail.d.ts +2 -18
  89. package/dist/components/layout/page-container.js +0 -1
  90. package/dist/components/layout/responsive-grid.d.ts +6 -1
  91. package/dist/components/layout/responsive-grid.js +9 -2
  92. package/dist/components/layout/service-role-panel.d.ts +7 -19
  93. package/dist/components/layout/sidebar.d.ts +5 -27
  94. package/dist/components/layout/sidebar.js +0 -1
  95. package/dist/components/layout/split-pane.d.ts +0 -7
  96. package/dist/components/layout/topbar.d.ts +1 -14
  97. package/dist/components/navigation/app-setting-picker.js +1 -3
  98. package/dist/components/navigation/filter-bar.d.ts +1 -6
  99. package/dist/components/navigation/pagination-utils.d.ts +2 -12
  100. package/dist/components/navigation/tabs-scroll.d.ts +2 -36
  101. package/dist/components/navigation/tabs.js +4 -8
  102. package/dist/components/query/data-state.d.ts +2 -2
  103. package/dist/components/ui/credential-reveal.d.ts +1 -4
  104. package/dist/components/ui/hover-card.d.ts +1 -2
  105. package/dist/components/ui/separator.d.ts +2 -15
  106. package/dist/components/ui/toggle-group.d.ts +1 -5
  107. package/dist/components/ui/toggle.d.ts +6 -31
  108. package/dist/email/brand-mark.d.ts +6 -34
  109. package/dist/email/color.d.ts +7 -17
  110. package/dist/email/geometry.d.ts +4 -8
  111. package/dist/email/index.d.ts +4 -48
  112. package/dist/email/inline-style.d.ts +3 -9
  113. package/dist/email/urgency.d.ts +2 -7
  114. package/dist/form/form-context.d.ts +2 -5
  115. package/dist/form/form-root.d.ts +1 -2
  116. package/dist/i18n/messages/en.json +4 -0
  117. package/dist/i18n/messages/ja.json +4 -0
  118. package/dist/i18n/messages/vi.json +4 -0
  119. package/dist/inertia/index.d.ts +2 -10
  120. package/dist/lib/control-styles.d.ts +10 -21
  121. package/dist/lib/control-styles.js +4 -6
  122. package/dist/lib/datetime/format-date.d.ts +1 -4
  123. package/dist/lib/field-a11y.d.ts +31 -36
  124. package/dist/lib/field-a11y.js +16 -2
  125. package/dist/lib/format.d.ts +4 -8
  126. package/dist/lib/hooks.d.ts +6 -12
  127. package/dist/lib/permission-grid.d.ts +3 -18
  128. package/dist/lib/query-error.d.ts +3 -3
  129. package/dist/props/components/app.prop.d.ts +19 -27
  130. package/dist/props/components/charts.prop.d.ts +2 -3
  131. package/dist/props/components/data-display.prop.d.ts +48 -72
  132. package/dist/props/components/data-entry.prop.d.ts +41 -30
  133. package/dist/props/components/form.prop.d.ts +2 -6
  134. package/dist/props/components/general.prop.d.ts +11 -27
  135. package/dist/props/components/layout.prop.d.ts +89 -260
  136. package/dist/props/components/navigation.prop.d.ts +27 -42
  137. package/dist/props/registry.d.ts +31 -0
  138. package/dist/props/registry.js +33 -0
  139. package/dist/props/vocabulary/data.prop.d.ts +18 -49
  140. package/dist/props/vocabulary/index.d.ts +1 -1
  141. package/dist/props/vocabulary/interaction.prop.d.ts +10 -12
  142. package/dist/props/vocabulary/layout.prop.d.ts +8 -30
  143. package/dist/props/vocabulary/shared.prop.d.ts +3 -2
  144. package/dist/styles/alert-layout.css +1 -32
  145. package/dist/styles/badge-layout.css +4 -18
  146. package/dist/styles/base.css +14 -113
  147. package/dist/styles/card-layout.css +6 -128
  148. package/dist/styles/chart-layout.css +2 -17
  149. package/dist/styles/control.css +380 -458
  150. package/dist/styles/core.css +21 -0
  151. package/dist/styles/data-display-layout.css +175 -94
  152. package/dist/styles/data-entry-layout.css +0 -45
  153. package/dist/styles/density.css +1 -30
  154. package/dist/styles/dialog-layout.css +5 -69
  155. package/dist/styles/focus-ring.css +13 -87
  156. package/dist/styles/fonts.css +1 -31
  157. package/dist/styles/form-layout.css +7 -91
  158. package/dist/styles/index.css +2 -20
  159. package/dist/styles/layout.css +38 -456
  160. package/dist/styles/logo-layout.css +1 -35
  161. package/dist/styles/motion.css +3 -42
  162. package/dist/styles/navigation-layout.css +3 -50
  163. package/dist/styles/shell-layout.css +37 -403
  164. package/dist/styles/table-layout.css +16 -274
  165. package/dist/styles/text-layout.css +7 -21
  166. package/dist/styles/toggle.css +1 -23
  167. package/dist/theme/dxs.canonical.css +1 -55
  168. package/dist/theme/example.service.css +1 -26
  169. package/dist/theme/famgia.service.css +5 -15
  170. package/dist/tokens/axes.css +3 -40
  171. package/dist/tokens/base.css +1 -4
  172. package/dist/tokens/components/activity.css +6 -42
  173. package/dist/tokens/components/badge.css +4 -13
  174. package/dist/tokens/components/banner.css +4 -9
  175. package/dist/tokens/components/card.css +32 -88
  176. package/dist/tokens/components/chart.css +9 -26
  177. package/dist/tokens/components/control.css +37 -222
  178. package/dist/tokens/components/data-display.css +28 -79
  179. package/dist/tokens/components/data-entry.css +5 -19
  180. package/dist/tokens/components/descriptions.css +7 -27
  181. package/dist/tokens/components/email.css +38 -84
  182. package/dist/tokens/components/error-surface.css +2 -18
  183. package/dist/tokens/components/feedback.css +27 -124
  184. package/dist/tokens/components/form.css +13 -45
  185. package/dist/tokens/components/legal-document.css +16 -41
  186. package/dist/tokens/components/list-row.css +11 -36
  187. package/dist/tokens/components/logo.css +2 -57
  188. package/dist/tokens/components/navigation.css +16 -94
  189. package/dist/tokens/components/scroll-area.css +2 -18
  190. package/dist/tokens/components/separator.css +8 -30
  191. package/dist/tokens/components/sheet.css +3 -14
  192. package/dist/tokens/components/shell.css +53 -307
  193. package/dist/tokens/components/sidebar.css +5 -22
  194. package/dist/tokens/components/table.css +19 -140
  195. package/dist/tokens/components/toggle.css +3 -65
  196. package/dist/tokens/components/upload.css +7 -43
  197. package/dist/tokens/foundation.css +108 -383
  198. package/dist/tokens/semantic/layout.css +33 -207
  199. package/docs/CANONICAL-CONTRACTS.md +206 -0
  200. package/docs/COMPONENTS.md +157 -0
  201. package/docs/COMPOSITION-VS-COMPONENT.md +105 -0
  202. package/docs/CONSUMER-RULES.md +14 -0
  203. package/docs/CUSTOMER-THEMING.md +162 -0
  204. package/docs/DATETIME.md +69 -0
  205. package/docs/DEVELOPMENT.md +173 -0
  206. package/docs/FORMS.md +143 -0
  207. package/docs/FRAME-A11Y-CI.md +267 -0
  208. package/docs/FRAME-COVERAGE-LEDGER.md +123 -0
  209. package/docs/FRAME-COVERAGE-REPORT.md +140 -0
  210. package/docs/FRAME-COVERAGE-STANDARD.md +65 -0
  211. package/docs/FRAME-COVERAGE.md +29 -0
  212. package/docs/PROPS-REGISTRY.md +61 -0
  213. package/docs/PROPS-VOCABULARY.md +100 -0
  214. package/docs/README.md +60 -0
  215. package/docs/REGISTRY.md +70 -0
  216. package/docs/SPACING.md +56 -0
  217. package/docs/STANDARDS-vocabulary-tokens.md +48 -0
  218. package/docs/TESTING.md +98 -0
  219. package/docs/TOKENS.md +347 -0
  220. package/docs/asset-modules.d.ts +46 -0
  221. package/docs/assets/cover-terrain.svg +6 -0
  222. package/docs/assets/portrait-amber.svg +5 -0
  223. package/docs/assets/portrait-clay.svg +5 -0
  224. package/docs/assets/portrait-indigo.svg +5 -0
  225. package/docs/assets/portrait-iris.svg +5 -0
  226. package/docs/assets/portrait-moss.svg +5 -0
  227. package/docs/assets/portrait-plum.svg +5 -0
  228. package/docs/assets/portrait-slate.svg +5 -0
  229. package/docs/charts/compact-bar-trend.tsx +328 -0
  230. package/docs/charts/size-tiers.tsx +192 -0
  231. package/docs/data-display/accordion.tsx +99 -0
  232. package/docs/data-display/avatar.tsx +355 -0
  233. package/docs/data-display/badge.tsx +247 -0
  234. package/docs/data-display/card/examples/detail-panel.tsx +106 -0
  235. package/docs/data-display/card/index.md +3 -0
  236. package/docs/data-display/card/index.tsx +285 -0
  237. package/docs/data-display/carousel.tsx +156 -0
  238. package/docs/data-display/charts.tsx +198 -0
  239. package/docs/data-display/code-block.tsx +90 -0
  240. package/docs/data-display/collapsible.tsx +162 -0
  241. package/docs/data-display/credential-reveal.tsx +145 -0
  242. package/docs/data-display/data-table/examples/approval-queue.tsx +212 -0
  243. package/docs/data-display/data-table/examples/grid-features.tsx +158 -0
  244. package/docs/data-display/data-table/examples/list-page.tsx +175 -0
  245. package/docs/data-display/data-table/index.md +5 -0
  246. package/docs/data-display/data-table/index.tsx +295 -0
  247. package/docs/data-display/descriptions.tsx +143 -0
  248. package/docs/data-display/empty-state.tsx +164 -0
  249. package/docs/data-display/hover-card.tsx +181 -0
  250. package/docs/data-display/list-row.tsx +420 -0
  251. package/docs/data-display/permission-matrix.tsx +184 -0
  252. package/docs/data-display/popover-touch.tsx +27 -0
  253. package/docs/data-display/popover.tsx +245 -0
  254. package/docs/data-display/progress.tsx +84 -0
  255. package/docs/data-display/prose.tsx +105 -0
  256. package/docs/data-display/qr-code.tsx +68 -0
  257. package/docs/data-display/scroll-area.tsx +271 -0
  258. package/docs/data-display/service-launcher-card.tsx +145 -0
  259. package/docs/data-display/stat-card.tsx +99 -0
  260. package/docs/data-display/table.tsx +251 -0
  261. package/docs/data-display/timeline.tsx +112 -0
  262. package/docs/data-display/touch-actions.tsx +36 -0
  263. package/docs/data-display/tree-list.tsx +107 -0
  264. package/docs/data-entry/branch-scope-picker.tsx +123 -0
  265. package/docs/data-entry/calendar.tsx +180 -0
  266. package/docs/data-entry/cascader.tsx +378 -0
  267. package/docs/data-entry/checkbox.tsx +256 -0
  268. package/docs/data-entry/color-picker.tsx +117 -0
  269. package/docs/data-entry/command-palette.tsx +179 -0
  270. package/docs/data-entry/command.tsx +262 -0
  271. package/docs/data-entry/country-picker-recipe.tsx +170 -0
  272. package/docs/data-entry/date-picker.tsx +191 -0
  273. package/docs/data-entry/date-range-picker.tsx +149 -0
  274. package/docs/data-entry/form/examples/employee-settings.tsx +267 -0
  275. package/docs/data-entry/form/examples/invoice-form.tsx +387 -0
  276. package/docs/data-entry/form-field/examples/a11y-contract.tsx +240 -0
  277. package/docs/data-entry/form-field/examples/create-form.tsx +105 -0
  278. package/docs/data-entry/form-field/index.md +8 -0
  279. package/docs/data-entry/form-field/index.tsx +326 -0
  280. package/docs/data-entry/form-inertia.tsx +80 -0
  281. package/docs/data-entry/form-root.tsx +102 -0
  282. package/docs/data-entry/form.tsx +724 -0
  283. package/docs/data-entry/input-otp.tsx +231 -0
  284. package/docs/data-entry/input.tsx +114 -0
  285. package/docs/data-entry/label.tsx +100 -0
  286. package/docs/data-entry/month-picker.tsx +101 -0
  287. package/docs/data-entry/month-range-picker.tsx +115 -0
  288. package/docs/data-entry/number-input.tsx +240 -0
  289. package/docs/data-entry/password-input.tsx +106 -0
  290. package/docs/data-entry/password-strength.tsx +97 -0
  291. package/docs/data-entry/radio-group.tsx +95 -0
  292. package/docs/data-entry/rating.tsx +87 -0
  293. package/docs/data-entry/search-input.tsx +120 -0
  294. package/docs/data-entry/select-async-contracts.tsx +108 -0
  295. package/docs/data-entry/select-matrix.tsx +204 -0
  296. package/docs/data-entry/select.tsx +369 -0
  297. package/docs/data-entry/slider.tsx +130 -0
  298. package/docs/data-entry/switch.tsx +67 -0
  299. package/docs/data-entry/tag-input.tsx +108 -0
  300. package/docs/data-entry/textarea.tsx +209 -0
  301. package/docs/data-entry/time-picker.tsx +99 -0
  302. package/docs/data-entry/toggle-count.tsx +293 -0
  303. package/docs/data-entry/toggle-group.tsx +225 -0
  304. package/docs/data-entry/toggle.tsx +127 -0
  305. package/docs/data-entry/transfer.tsx +97 -0
  306. package/docs/data-entry/tree-select.tsx +204 -0
  307. package/docs/data-entry/upload.tsx +184 -0
  308. package/docs/feedback/alert-dialog.tsx +270 -0
  309. package/docs/feedback/alert.tsx +248 -0
  310. package/docs/feedback/banner.tsx +183 -0
  311. package/docs/feedback/danger-confirm.tsx +88 -0
  312. package/docs/feedback/dialog-touch.tsx +24 -0
  313. package/docs/feedback/dialog.tsx +193 -0
  314. package/docs/feedback/sheet.tsx +410 -0
  315. package/docs/feedback/skeleton.tsx +111 -0
  316. package/docs/feedback/toast.tsx +135 -0
  317. package/docs/feedback/tooltip.tsx +171 -0
  318. package/docs/feedback/two-factor-setup.tsx +68 -0
  319. package/docs/foundation/_email-specimen.ts +274 -0
  320. package/docs/foundation/colors.tsx +202 -0
  321. package/docs/foundation/density.tsx +232 -0
  322. package/docs/foundation/email-tokens.tsx +306 -0
  323. package/docs/foundation/radius-shadow.tsx +152 -0
  324. package/docs/foundation/spacing.tsx +211 -0
  325. package/docs/foundation/typography.tsx +147 -0
  326. package/docs/general/activity.tsx +224 -0
  327. package/docs/general/button/examples/destructive-confirm.tsx +90 -0
  328. package/docs/general/button/examples/form-actions.tsx +85 -0
  329. package/docs/general/button/examples/toolbar.tsx +160 -0
  330. package/docs/general/button/index.md +12 -0
  331. package/docs/general/button/index.tsx +211 -0
  332. package/docs/general/logo.tsx +131 -0
  333. package/docs/general/reveal.tsx +41 -0
  334. package/docs/general/typography.tsx +152 -0
  335. package/docs/layout/account-chip.tsx +72 -0
  336. package/docs/layout/admin-collection.tsx +122 -0
  337. package/docs/layout/app-shell.tsx +374 -0
  338. package/docs/layout/aspect-ratio.tsx +119 -0
  339. package/docs/layout/auth-account-summary.tsx +103 -0
  340. package/docs/layout/auth-divider.tsx +28 -0
  341. package/docs/layout/auth-footer.tsx +37 -0
  342. package/docs/layout/auth-identity.tsx +36 -0
  343. package/docs/layout/auth-recovery/examples/mfa-challenge.md +41 -0
  344. package/docs/layout/auth-recovery/examples/mfa-challenge.tsx +254 -0
  345. package/docs/layout/auth-recovery/examples/mobile-390.md +25 -0
  346. package/docs/layout/auth-recovery/examples/mobile-390.tsx +82 -0
  347. package/docs/layout/auth-recovery/examples/password-recovery.md +24 -0
  348. package/docs/layout/auth-recovery/examples/password-recovery.tsx +197 -0
  349. package/docs/layout/auth-recovery/examples/wrapping-ja-en-vi.md +27 -0
  350. package/docs/layout/auth-recovery/examples/wrapping-ja-en-vi.tsx +156 -0
  351. package/docs/layout/auth-recovery/index.md +140 -0
  352. package/docs/layout/auth-recovery/index.tsx +96 -0
  353. package/docs/layout/auth-shell-context.tsx +103 -0
  354. package/docs/layout/auth-shell-device.tsx +112 -0
  355. package/docs/layout/auth-shell-registration.tsx +335 -0
  356. package/docs/layout/auth-shell-variants.tsx +139 -0
  357. package/docs/layout/auth-shell.tsx +59 -0
  358. package/docs/layout/auth-stack.tsx +40 -0
  359. package/docs/layout/centered-shell.tsx +102 -0
  360. package/docs/layout/error-surface/examples/application-403.tsx +84 -0
  361. package/docs/layout/error-surface/examples/application-404.tsx +77 -0
  362. package/docs/layout/error-surface/examples/system-500.tsx +47 -0
  363. package/docs/layout/error-surface/examples/system-503.tsx +48 -0
  364. package/docs/layout/error-surface/index.md +153 -0
  365. package/docs/layout/error-surface/index.tsx +239 -0
  366. package/docs/layout/flex.tsx +262 -0
  367. package/docs/layout/legal-document-shell/_data.ts +110 -0
  368. package/docs/layout/legal-document-shell/examples/desktop-1440.md +12 -0
  369. package/docs/layout/legal-document-shell/examples/desktop-1440.tsx +83 -0
  370. package/docs/layout/legal-document-shell/examples/mobile-390.md +22 -0
  371. package/docs/layout/legal-document-shell/examples/mobile-390.tsx +70 -0
  372. package/docs/layout/legal-document-shell/examples/tablet-1024.md +3 -0
  373. package/docs/layout/legal-document-shell/examples/tablet-1024.tsx +84 -0
  374. package/docs/layout/legal-document-shell/examples/wrapping-ja-en-vi.md +18 -0
  375. package/docs/layout/legal-document-shell/examples/wrapping-ja-en-vi.tsx +61 -0
  376. package/docs/layout/legal-document-shell/index.md +51 -0
  377. package/docs/layout/legal-document-shell/index.tsx +101 -0
  378. package/docs/layout/master-detail.tsx +387 -0
  379. package/docs/layout/org-switcher.tsx +131 -0
  380. package/docs/layout/page-container.tsx +946 -0
  381. package/docs/layout/resizable-panel.tsx +419 -0
  382. package/docs/layout/responsive-grid.tsx +235 -0
  383. package/docs/layout/separator.tsx +327 -0
  384. package/docs/layout/service-role-panel.tsx +144 -0
  385. package/docs/layout/sidebar.tsx +586 -0
  386. package/docs/layout/split-pane.tsx +451 -0
  387. package/docs/layout/topbar.tsx +347 -0
  388. package/docs/navigation/app-setting-picker.tsx +141 -0
  389. package/docs/navigation/breadcrumb.tsx +128 -0
  390. package/docs/navigation/context-menu.tsx +117 -0
  391. package/docs/navigation/dropdown-menu.tsx +213 -0
  392. package/docs/navigation/filter-bar.tsx +227 -0
  393. package/docs/navigation/menubar.tsx +141 -0
  394. package/docs/navigation/navigation-menu.tsx +165 -0
  395. package/docs/navigation/pagination.tsx +241 -0
  396. package/docs/navigation/steps.tsx +263 -0
  397. package/docs/navigation/tabs-rtl.tsx +28 -0
  398. package/docs/navigation/tabs.tsx +308 -0
  399. package/docs/navigation/toolbar.tsx +339 -0
  400. package/docs/providers/app-provider.tsx +191 -0
  401. package/docs/providers/format-date.tsx +230 -0
  402. package/docs/query/button-refetch.tsx +160 -0
  403. package/docs/query/data-state.tsx +192 -0
  404. package/docs/query/infinite-query-state.tsx +93 -0
  405. package/docs/query/mutation-feedback.tsx +70 -0
  406. package/docs/query/prefetch-link.tsx +262 -0
  407. package/docs/query/touch-actions.tsx +68 -0
  408. package/docs/showcase/acme-portal.tsx +441 -0
  409. package/docs/showcase/acme-website.tsx +455 -0
  410. package/docs/showcase/case1-warehouse-dashboard.tsx +343 -0
  411. package/docs/showcase/case2-employee-me.tsx +441 -0
  412. package/docs/showcase/case3-approval-workflow.tsx +527 -0
  413. package/docs/showcase/case4-login.tsx +307 -0
  414. package/docs/showcase/case5-shift-calendar.tsx +795 -0
  415. package/docs/showcase/case6-agency-handy.tsx +1072 -0
  416. package/docs/showcase/futurelastic-web.tsx +390 -0
  417. package/docs/showcase/org-switcher.tsx +313 -0
  418. package/docs/showcase/permission-matrix.tsx +343 -0
  419. package/docs/showcase/public-landing.tsx +210 -0
  420. package/docs/showcase/settings-account-sections.tsx +559 -0
  421. package/docs/showcase/settings-security-mfa.tsx +145 -0
  422. package/docs/showcase/table-approval-queue.tsx +199 -0
  423. package/docs/showcase/table-bulk-actions.tsx +460 -0
  424. package/docs/showcase/table-compact-kintone.tsx +438 -0
  425. package/docs/showcase/table-conditional-format.tsx +367 -0
  426. package/docs/showcase/table-crud-list.tsx +544 -0
  427. package/docs/showcase/table-density.tsx +340 -0
  428. package/docs/showcase/table-expandable-rows.tsx +471 -0
  429. package/docs/showcase/table-filter-chips.tsx +461 -0
  430. package/docs/showcase/table-footer-totals.tsx +311 -0
  431. package/docs/showcase/table-grouped-subtotals.tsx +388 -0
  432. package/docs/showcase/table-master-detail.tsx +479 -0
  433. package/docs/showcase/table-pagination.tsx +320 -0
  434. package/docs/showcase/table-states.tsx +363 -0
  435. package/docs/showcase/table-sticky-columns.tsx +373 -0
  436. package/docs/showcase/table-tree-rows.tsx +444 -0
  437. package/docs/showcase/table-view-tabs.tsx +488 -0
  438. package/package.json +10 -11
  439. package/scripts/_agent-setup.mjs +16 -2
  440. package/scripts/audit-hook.mjs +3 -13
  441. package/scripts/init-agent-kit.mjs +1 -14
  442. package/scripts/postinstall.mjs +12 -12
  443. package/scripts/ui-audit.mjs +93 -31
  444. package/scripts/visual-audit-rules.mjs +51 -7
  445. package/scripts/visual-audit.mjs +118 -47
@@ -0,0 +1,559 @@
1
+ /**
2
+ * Showcase · settings-account-sections — the canonical SETTINGS SECTION / ROW composition (gh#216)
3
+ *
4
+ * ── Gate 0 verdict: COMPOSITION PATTERN, not a framework component ────────────────────────────
5
+ * A "SettingsSection" / "SettingsRow" / "DangerZone" fails the Framework-Component Test
6
+ * (docs/COMPOSITION-VS-COMPONENT.md): C2 — it owns NO behavior (pure layout + content + colour);
7
+ * C3 — it is fully expressible TODAY from `Card` + `CardHeader/CardTitle/CardDescription/
8
+ * CardAction/CardContent flush/CardFooter` + `ListRow` + `Descriptions` + `Switch`/`Select` +
9
+ * `StatusBadge` + `AlertDialog` + the existing `--card-*` / `--list-row-*` / `--descriptions-*`
10
+ * knobs; C4 — its API would be a screen-shaped grab-bag ("identity", "billing", "danger"); C7 —
11
+ * it would ship one design's block to every consumer. So it lives HERE (and as the MCP
12
+ * `settings-section-rows` pattern), never in `src/components/`. Zero new components were added.
13
+ *
14
+ * ── The four blocks the DXS consumer kept re-inventing ───────────────────────────────────────
15
+ * 1. Identity — avatar + `Descriptions` metadata, one header action (`CardAction`).
16
+ * 2. Preferences — `CardContent flush` + `ListRow` rows whose trailing slot IS the control
17
+ * (`Switch` / `Select`). Never a hand-rolled
18
+ * `<div className="flex justify-between border-b">`.
19
+ * 3. Billing handoff — canonical `StatusBadge status=…` (NO page-local status→colour map),
20
+ * money/seats/dates through `Intl`, and a footer button that hands off to
21
+ * the external billing portal with an sr-only "opens in a new tab".
22
+ * 4. Danger zone — `Card accent="destructive"` (the semantic leading rail is already a
23
+ * token, `--card-accent-rail-width`) + destructive `ListRow` actions +
24
+ * `AlertDialog challenge=…` type-to-confirm friction.
25
+ *
26
+ * ── Acceptance evidence baked into the page ──────────────────────────────────────────────────
27
+ * · 1440 / 1024 / 390 — every block is a Card in a `max-w-3xl` column: `Descriptions` collapses
28
+ * 3→2→1 columns, `ListRow` wraps its trailing controls onto their own line under
29
+ * `--list-row-body-min-width`, and the header action row wraps. Nothing scrolls horizontally.
30
+ * · long JA/EN/VI labels — the "表示言語 / Label language" Select swaps the WHOLE label bundle to
31
+ * deliberately long JA, EN and VI strings (and re-tags every `Intl` formatter: ja-JP/JPY,
32
+ * en-US/USD, vi-VN/VND) so the rows can be checked at their worst case, not their best. It also
33
+ * drives the APP locale (`useAppLocale().setLocale`), so the library's own `t()` chrome — the
34
+ * canonical `StatusBadge` label above all — switches with the page instead of lagging behind it.
35
+ * · Intl only — `Intl.NumberFormat` (currency, ISO 4217 + integer seat counts),
36
+ * `Intl.DateTimeFormat` (member-since / next invoice), `Intl.PluralRules` (seat noun),
37
+ * `Intl.DisplayNames` (region of the billing account, from ISO 3166-1 alpha-2).
38
+ * · Logical CSS only, semantic tokens only, lucide icons (no emoji), quiet factual copy.
39
+ */
40
+ import * as React from "react";
41
+ import { ExternalLink, ShieldAlert, UserMinus } from "lucide-react";
42
+
43
+ import { useAppLocale } from "@godxjp/ui/app";
44
+ import { Button, Text } from "@godxjp/ui/general";
45
+ import {
46
+ Avatar,
47
+ AvatarFallback,
48
+ Card,
49
+ CardAction,
50
+ CardContent,
51
+ CardDescription,
52
+ CardFooter,
53
+ CardHeader,
54
+ CardTitle,
55
+ Descriptions,
56
+ ListRow,
57
+ StatusBadge,
58
+ } from "@godxjp/ui/data-display";
59
+ import { FormField, Select, Switch } from "@godxjp/ui/data-entry";
60
+ import { AlertDialog } from "@godxjp/ui/feedback";
61
+ import { Flex, PageContainer } from "@godxjp/ui/layout";
62
+
63
+ // ── Label bundles: the SAME screen at its longest JA / EN / VI wording ────────────────────────
64
+ // Long-label stress is a first-class acceptance criterion (#216), so the bundle intentionally
65
+ // carries the verbose form of each label instead of the tidy demo form.
66
+
67
+ type LabelBundle = {
68
+ /** BCP-47 tag driving every Intl formatter on the page. */
69
+ tag: string;
70
+ /** ISO 4217 code of the billing account. */
71
+ currency: string;
72
+ /** ISO 3166-1 alpha-2 region of the billing account. */
73
+ region: string;
74
+ optionLabel: string;
75
+ pageTitle: string;
76
+ pageSubtitle: string;
77
+ save: string;
78
+ labelLanguage: string;
79
+ identityTitle: string;
80
+ identityDescription: string;
81
+ identityEdit: string;
82
+ fieldName: string;
83
+ fieldEmail: string;
84
+ fieldEmployeeId: string;
85
+ fieldMemberSince: string;
86
+ displayName: string;
87
+ email: string;
88
+ preferencesTitle: string;
89
+ preferencesDescription: string;
90
+ prefDigestTitle: string;
91
+ prefDigestDescription: string;
92
+ prefMentionTitle: string;
93
+ prefMentionDescription: string;
94
+ prefDateFormatTitle: string;
95
+ prefDateFormatDescription: string;
96
+ billingTitle: string;
97
+ billingDescription: string;
98
+ billingPlanLabel: string;
99
+ billingPlanValue: string;
100
+ billingSeatsLabel: string;
101
+ billingAmountLabel: string;
102
+ billingNextInvoiceLabel: string;
103
+ billingRegionLabel: string;
104
+ billingHandoff: string;
105
+ billingHandoffHint: string;
106
+ opensInNewTab: string;
107
+ seat: { one: string; other: string };
108
+ dangerTitle: string;
109
+ dangerDescription: string;
110
+ dangerTransferTitle: string;
111
+ dangerTransferDescription: string;
112
+ dangerTransfer: string;
113
+ dangerDeleteTitle: string;
114
+ dangerDeleteDescription: string;
115
+ dangerDelete: string;
116
+ confirmTitle: string;
117
+ confirmDescription: string;
118
+ confirmLabel: string;
119
+ cancelLabel: string;
120
+ };
121
+
122
+ const BUNDLES: Record<"ja" | "en" | "vi", LabelBundle> = {
123
+ ja: {
124
+ tag: "ja-JP",
125
+ currency: "JPY",
126
+ region: "JP",
127
+ optionLabel: "日本語(長いラベル検証用)",
128
+ pageTitle: "ワークスペースの設定",
129
+ pageSubtitle:
130
+ "アカウント情報・通知の環境設定・請求先ポータルへの引き渡し・取り消せない操作をまとめて管理します。",
131
+ save: "変更内容を保存する",
132
+ labelLanguage: "表示言語",
133
+ identityTitle: "アカウント情報",
134
+ identityDescription: "請求書・監査ログ・共有リンクに表示される氏名とメールアドレスです。",
135
+ identityEdit: "アカウント情報を編集",
136
+ fieldName: "表示名",
137
+ fieldEmail: "連絡先メールアドレス",
138
+ fieldEmployeeId: "従業員番号",
139
+ fieldMemberSince: "利用開始日",
140
+ displayName: "藤原 慧(ふじわら さとし)",
141
+ email: "satoshi.fujiwara@example.co.jp",
142
+ preferencesTitle: "通知と表示の環境設定",
143
+ preferencesDescription: "変更は保存操作なしで即時反映されます。",
144
+ prefDigestTitle: "週次サマリーをメールで受け取る",
145
+ prefDigestDescription: "毎週月曜日の朝に、担当中の申請と未処理の承認をまとめて送信します。",
146
+ prefMentionTitle: "メンションされたときにデスクトップ通知を表示する",
147
+ prefMentionDescription: "ブラウザの通知許可が必要です。",
148
+ prefDateFormatTitle: "日付の表示形式",
149
+ prefDateFormatDescription: "一覧・詳細・書き出したファイルのすべてに適用されます。",
150
+ billingTitle: "請求とサブスクリプション",
151
+ billingDescription: "支払い方法と請求書は外部の請求ポータルで管理します。",
152
+ billingPlanLabel: "契約プラン",
153
+ billingPlanValue: "ビジネス(年額)",
154
+ billingSeatsLabel: "利用ライセンス数",
155
+ billingAmountLabel: "次回請求予定額",
156
+ billingNextInvoiceLabel: "次回請求日",
157
+ billingRegionLabel: "請求先の国/地域",
158
+ billingHandoff: "請求ポータルを開く",
159
+ billingHandoffHint: "支払い方法の変更・請求書のダウンロードは請求ポータルで行います。",
160
+ opensInNewTab: "新しいタブで開きます",
161
+ seat: { one: "{count} ライセンス", other: "{count} ライセンス" },
162
+ dangerTitle: "取り消せない操作",
163
+ dangerDescription: "以下の操作は元に戻せません。実行前に必ず内容を確認してください。",
164
+ dangerTransferTitle: "ワークスペースの所有権を他のメンバーへ移管する",
165
+ dangerTransferDescription: "移管後、あなたは管理者権限を失います。",
166
+ dangerTransfer: "所有権を移管",
167
+ dangerDeleteTitle: "ワークスペースと全データを完全に削除する",
168
+ dangerDeleteDescription: "勤怠記録・申請履歴・監査ログがすべて削除されます。",
169
+ dangerDelete: "ワークスペースを削除",
170
+ confirmTitle: "ワークスペースを完全に削除しますか?",
171
+ confirmDescription:
172
+ "この操作は取り消せません。確認のためワークスペース識別子を入力してください。",
173
+ confirmLabel: "完全に削除する",
174
+ cancelLabel: "キャンセル",
175
+ },
176
+ en: {
177
+ tag: "en-US",
178
+ currency: "USD",
179
+ region: "US",
180
+ optionLabel: "English (long-label stress case)",
181
+ pageTitle: "Workspace settings",
182
+ pageSubtitle:
183
+ "Manage your account identity, notification preferences, the handoff to the billing portal, and irreversible actions.",
184
+ save: "Save all changes",
185
+ labelLanguage: "Label language",
186
+ identityTitle: "Account identity",
187
+ identityDescription:
188
+ "The name and address shown on invoices, audit log entries and shared links.",
189
+ identityEdit: "Edit account identity",
190
+ fieldName: "Display name",
191
+ fieldEmail: "Contact email address",
192
+ fieldEmployeeId: "Employee number",
193
+ fieldMemberSince: "Member since",
194
+ displayName: "Satoshi Fujiwara (Workspace administrator)",
195
+ email: "satoshi.fujiwara@example.co.jp",
196
+ preferencesTitle: "Notification and display preferences",
197
+ preferencesDescription: "Changes apply immediately. There is nothing to save here.",
198
+ prefDigestTitle: "Email me the weekly summary of assigned and pending requests",
199
+ prefDigestDescription:
200
+ "Sent every Monday morning with everything still waiting on your approval.",
201
+ prefMentionTitle: "Show a desktop notification when somebody mentions me",
202
+ prefMentionDescription: "Requires browser notification permission.",
203
+ prefDateFormatTitle: "Date display format",
204
+ prefDateFormatDescription: "Applies to every list, detail page and exported file.",
205
+ billingTitle: "Billing and subscription",
206
+ billingDescription: "Payment methods and invoices live in the external billing portal.",
207
+ billingPlanLabel: "Current plan",
208
+ billingPlanValue: "Business (billed annually)",
209
+ billingSeatsLabel: "Licensed seats in use",
210
+ billingAmountLabel: "Amount due next cycle",
211
+ billingNextInvoiceLabel: "Next invoice date",
212
+ billingRegionLabel: "Billing country or region",
213
+ billingHandoff: "Open the billing portal",
214
+ billingHandoffHint:
215
+ "Change the payment method or download past invoices in the billing portal.",
216
+ opensInNewTab: "opens in a new tab",
217
+ seat: { one: "{count} seat", other: "{count} seats" },
218
+ dangerTitle: "Irreversible actions",
219
+ dangerDescription: "These actions cannot be undone. Read each one before you continue.",
220
+ dangerTransferTitle: "Transfer workspace ownership to another member",
221
+ dangerTransferDescription: "You lose administrator rights as soon as the transfer completes.",
222
+ dangerTransfer: "Transfer ownership",
223
+ dangerDeleteTitle: "Permanently delete this workspace and all of its data",
224
+ dangerDeleteDescription: "Attendance records, request history and audit logs are all removed.",
225
+ dangerDelete: "Delete workspace",
226
+ confirmTitle: "Permanently delete this workspace?",
227
+ confirmDescription:
228
+ "This cannot be undone. Type the workspace identifier below to confirm the deletion.",
229
+ confirmLabel: "Delete permanently",
230
+ cancelLabel: "Cancel",
231
+ },
232
+ vi: {
233
+ tag: "vi-VN",
234
+ currency: "VND",
235
+ region: "VN",
236
+ optionLabel: "Tiếng Việt (nhãn dài nhất)",
237
+ pageTitle: "Cài đặt không gian làm việc",
238
+ pageSubtitle:
239
+ "Quản lý thông tin tài khoản, tuỳ chọn thông báo, chuyển sang cổng thanh toán và các thao tác không thể hoàn tác.",
240
+ save: "Lưu toàn bộ thay đổi",
241
+ labelLanguage: "Ngôn ngữ nhãn",
242
+ identityTitle: "Thông tin tài khoản",
243
+ identityDescription:
244
+ "Tên và địa chỉ hiển thị trên hoá đơn, bản ghi kiểm toán và liên kết chia sẻ.",
245
+ identityEdit: "Sửa thông tin tài khoản",
246
+ fieldName: "Tên hiển thị",
247
+ fieldEmail: "Địa chỉ email liên hệ",
248
+ fieldEmployeeId: "Mã nhân viên",
249
+ fieldMemberSince: "Thành viên từ ngày",
250
+ displayName: "Fujiwara Satoshi (Quản trị viên không gian làm việc)",
251
+ email: "satoshi.fujiwara@example.co.jp",
252
+ preferencesTitle: "Tuỳ chọn thông báo và hiển thị",
253
+ preferencesDescription: "Thay đổi được áp dụng ngay, không cần bấm lưu.",
254
+ prefDigestTitle: "Gửi email tổng hợp hằng tuần về các yêu cầu đang chờ tôi xử lý",
255
+ prefDigestDescription: "Gửi vào sáng thứ Hai, gồm mọi yêu cầu còn chờ bạn phê duyệt.",
256
+ prefMentionTitle: "Hiện thông báo trên máy tính khi có người nhắc đến tôi",
257
+ prefMentionDescription: "Cần quyền thông báo của trình duyệt.",
258
+ prefDateFormatTitle: "Định dạng hiển thị ngày",
259
+ prefDateFormatDescription: "Áp dụng cho mọi danh sách, trang chi tiết và tệp xuất ra.",
260
+ billingTitle: "Thanh toán và gói đăng ký",
261
+ billingDescription: "Phương thức thanh toán và hoá đơn nằm ở cổng thanh toán bên ngoài.",
262
+ billingPlanLabel: "Gói hiện tại",
263
+ billingPlanValue: "Business (thanh toán theo năm)",
264
+ billingSeatsLabel: "Số giấy phép đang dùng",
265
+ billingAmountLabel: "Số tiền của kỳ kế tiếp",
266
+ billingNextInvoiceLabel: "Ngày xuất hoá đơn kế tiếp",
267
+ billingRegionLabel: "Quốc gia hoặc vùng thanh toán",
268
+ billingHandoff: "Mở cổng thanh toán",
269
+ billingHandoffHint: "Đổi phương thức thanh toán hoặc tải hoá đơn cũ ở cổng thanh toán.",
270
+ opensInNewTab: "mở trong tab mới",
271
+ seat: { one: "{count} giấy phép", other: "{count} giấy phép" },
272
+ dangerTitle: "Thao tác không thể hoàn tác",
273
+ dangerDescription: "Các thao tác dưới đây không thể hoàn tác. Hãy đọc kỹ trước khi tiếp tục.",
274
+ dangerTransferTitle: "Chuyển quyền sở hữu không gian làm việc cho thành viên khác",
275
+ dangerTransferDescription: "Bạn sẽ mất quyền quản trị ngay khi việc chuyển giao hoàn tất.",
276
+ dangerTransfer: "Chuyển quyền sở hữu",
277
+ dangerDeleteTitle: "Xoá vĩnh viễn không gian làm việc và toàn bộ dữ liệu",
278
+ dangerDeleteDescription: "Dữ liệu chấm công, lịch sử yêu cầu và bản ghi kiểm toán đều bị xoá.",
279
+ dangerDelete: "Xoá không gian làm việc",
280
+ confirmTitle: "Xoá vĩnh viễn không gian làm việc này?",
281
+ confirmDescription:
282
+ "Không thể hoàn tác. Hãy nhập mã định danh không gian làm việc để xác nhận.",
283
+ confirmLabel: "Xoá vĩnh viễn",
284
+ cancelLabel: "Huỷ",
285
+ },
286
+ };
287
+
288
+ const WORKSPACE_SLUG = "godx-shinjuku-hq";
289
+ const EMPLOYEE_ID = "EMP-1042-JP";
290
+ const MEMBER_SINCE = new Date("2023-04-01T00:00:00Z");
291
+ const NEXT_INVOICE = new Date("2026-08-31T00:00:00Z");
292
+ const SEATS = 128;
293
+ /** Minor-unit amounts per ISO 4217 account currency (JPY has 0 decimals, USD 2, VND 0). */
294
+ const AMOUNT: Record<string, number> = { JPY: 1_536_000, USD: 10_240, VND: 268_800_000 };
295
+
296
+ /** CLDR plural selection — never one template for a counted noun ("1 seats" is a bug). */
297
+ function seatCount(bundle: LabelBundle) {
298
+ const category = new Intl.PluralRules(bundle.tag).select(SEATS);
299
+ const template = category === "one" ? bundle.seat.one : bundle.seat.other;
300
+ return template.replace("{count}", new Intl.NumberFormat(bundle.tag).format(SEATS));
301
+ }
302
+
303
+ export default function SettingsAccountSectionsShowcase() {
304
+ // One language switch drives BOTH halves of the page: the app-authored bundle above AND the
305
+ // library's own `t()` chrome — the canonical `StatusBadge` label, dialog affordances, empty
306
+ // states. Swapping only the local bundle would leave an English page wearing a Vietnamese
307
+ // status pill, so the switch owns `setLocale` too (`AppLocale` is exactly ja | en | vi).
308
+ const { locale, setLocale } = useAppLocale();
309
+ const lang: "ja" | "en" | "vi" = locale;
310
+ const b = BUNDLES[lang];
311
+ const [digest, setDigest] = React.useState(true);
312
+ const [mention, setMention] = React.useState(false);
313
+ const [dateFormat, setDateFormat] = React.useState("iso");
314
+ const [confirmOpen, setConfirmOpen] = React.useState(false);
315
+
316
+ const money = new Intl.NumberFormat(b.tag, {
317
+ style: "currency",
318
+ currency: b.currency,
319
+ }).format(AMOUNT[b.currency] ?? 0);
320
+ const longDate = (d: Date) =>
321
+ new Intl.DateTimeFormat(b.tag, { dateStyle: "long", timeZone: "UTC" }).format(d);
322
+ const regionName = new Intl.DisplayNames([b.tag], { type: "region" }).of(b.region) ?? b.region;
323
+
324
+ // Date-format options are themselves localized samples, formatted with Intl — never a
325
+ // hand-written "YYYY-MM-DD" string table.
326
+ const sample = new Date("2026-07-30T00:00:00Z");
327
+ const dateFormatOptions = [
328
+ {
329
+ value: "iso",
330
+ label: new Intl.DateTimeFormat("en-CA", { dateStyle: "short", timeZone: "UTC" }).format(
331
+ sample,
332
+ ),
333
+ },
334
+ {
335
+ value: "long",
336
+ label: new Intl.DateTimeFormat(b.tag, { dateStyle: "long", timeZone: "UTC" }).format(sample),
337
+ },
338
+ {
339
+ value: "medium",
340
+ label: new Intl.DateTimeFormat(b.tag, { dateStyle: "medium", timeZone: "UTC" }).format(
341
+ sample,
342
+ ),
343
+ },
344
+ ];
345
+
346
+ return (
347
+ <PageContainer
348
+ title={b.pageTitle}
349
+ subtitle={b.pageSubtitle}
350
+ breadcrumb={[{ label: b.pageTitle }]}
351
+ // PageHeader action composition (#216): the header owns the page-level actions through
352
+ // `extra`. It wraps at 390 instead of overflowing, so no page-local header geometry.
353
+ extra={
354
+ <Flex direction="row" align="end" gap="sm" wrap>
355
+ <FormField id="label-language" label={b.labelLanguage}>
356
+ <Select
357
+ id="label-language"
358
+ options={(["ja", "en", "vi"] as const).map((id) => ({
359
+ value: id,
360
+ label: BUNDLES[id].optionLabel,
361
+ }))}
362
+ value={lang}
363
+ onValueChange={(next: string) => {
364
+ setLocale(next as "ja" | "en" | "vi");
365
+ }}
366
+ />
367
+ </FormField>
368
+ <Button>{b.save}</Button>
369
+ </Flex>
370
+ }
371
+ >
372
+ <Flex direction="col" gap="lg" className="max-w-3xl">
373
+ {/* ── 1 · Identity ─────────────────────────────────────────────────────────────────
374
+ Metadata is a description list, so it is `Descriptions` (a real <dl>), never a
375
+ two-column flex of styled divs. `CardAction` parks the single header action. */}
376
+ <Card>
377
+ <CardHeader>
378
+ <CardTitle level={2}>{b.identityTitle}</CardTitle>
379
+ <CardDescription>{b.identityDescription}</CardDescription>
380
+ <CardAction>
381
+ <Button variant="outline" size="sm">
382
+ {b.identityEdit}
383
+ </Button>
384
+ </CardAction>
385
+ </CardHeader>
386
+ <CardContent>
387
+ <Flex direction="col" gap="md" className="sm:flex-row sm:items-start">
388
+ <Avatar className="size-12 shrink-0 rounded-md">
389
+ <AvatarFallback className="bg-primary text-primary-foreground font-bold">
390
+ SF
391
+ </AvatarFallback>
392
+ </Avatar>
393
+ <Descriptions columns={2} layout="vertical" className="min-w-0 flex-1">
394
+ <Descriptions.Item label={b.fieldName}>{b.displayName}</Descriptions.Item>
395
+ <Descriptions.Item label={b.fieldEmail}>{b.email}</Descriptions.Item>
396
+ <Descriptions.Item label={b.fieldEmployeeId} mono>
397
+ {EMPLOYEE_ID}
398
+ </Descriptions.Item>
399
+ <Descriptions.Item label={b.fieldMemberSince}>
400
+ {/* ISO-8601 machine value in the <time> datetime, localized text for humans. */}
401
+ <time dateTime={MEMBER_SINCE.toISOString().slice(0, 10)}>
402
+ {longDate(MEMBER_SINCE)}
403
+ </time>
404
+ </Descriptions.Item>
405
+ </Descriptions>
406
+ </Flex>
407
+ </CardContent>
408
+ </Card>
409
+
410
+ {/* ── 2 · Preferences ─────────────────────────────────────────────────────────────
411
+ THE settings-row pattern: `CardContent flush` + `ListRow`, whose `trailing` slot IS
412
+ the control. `align="start"` + `overflow="wrap"` keep long JA/VI titles readable and
413
+ let the control drop onto its own line at 390 (--list-row-body-min-width). */}
414
+ <Card>
415
+ <CardHeader>
416
+ <CardTitle level={2}>{b.preferencesTitle}</CardTitle>
417
+ <CardDescription>{b.preferencesDescription}</CardDescription>
418
+ </CardHeader>
419
+ <CardContent flush>
420
+ <ListRow
421
+ align="start"
422
+ overflow="wrap"
423
+ title={<label htmlFor="pref-digest">{b.prefDigestTitle}</label>}
424
+ description={b.prefDigestDescription}
425
+ trailing={<Switch id="pref-digest" checked={digest} onCheckedChange={setDigest} />}
426
+ />
427
+ <ListRow
428
+ align="start"
429
+ overflow="wrap"
430
+ title={<label htmlFor="pref-mention">{b.prefMentionTitle}</label>}
431
+ description={b.prefMentionDescription}
432
+ trailing={<Switch id="pref-mention" checked={mention} onCheckedChange={setMention} />}
433
+ />
434
+ <ListRow
435
+ align="start"
436
+ overflow="wrap"
437
+ title={<label htmlFor="pref-date-format">{b.prefDateFormatTitle}</label>}
438
+ description={b.prefDateFormatDescription}
439
+ trailing={
440
+ <Select
441
+ id="pref-date-format"
442
+ options={dateFormatOptions}
443
+ value={dateFormat}
444
+ onValueChange={setDateFormat}
445
+ className="w-[var(--filter-picker-width-sm)]"
446
+ />
447
+ }
448
+ />
449
+ </CardContent>
450
+ </Card>
451
+
452
+ {/* ── 3 · Billing handoff ─────────────────────────────────────────────────────────
453
+ The subscription state is a canonical `StatusBadge status="past_due"` — the tone and
454
+ icon come from the shared domain-status map in the library, so no page ever keeps its
455
+ own status→colour table (#216 acceptance). Money/seats/dates/region are all Intl. */}
456
+ <Card>
457
+ <CardHeader>
458
+ <CardTitle level={2}>{b.billingTitle}</CardTitle>
459
+ <CardDescription>{b.billingDescription}</CardDescription>
460
+ <CardAction>
461
+ <StatusBadge status="past_due" variant="outline" />
462
+ </CardAction>
463
+ </CardHeader>
464
+ <CardContent>
465
+ <Descriptions columns={2} layout="vertical">
466
+ <Descriptions.Item label={b.billingPlanLabel}>{b.billingPlanValue}</Descriptions.Item>
467
+ <Descriptions.Item label={b.billingSeatsLabel}>{seatCount(b)}</Descriptions.Item>
468
+ <Descriptions.Item label={b.billingAmountLabel}>{money}</Descriptions.Item>
469
+ <Descriptions.Item label={b.billingNextInvoiceLabel}>
470
+ <time dateTime={NEXT_INVOICE.toISOString().slice(0, 10)}>
471
+ {longDate(NEXT_INVOICE)}
472
+ </time>
473
+ </Descriptions.Item>
474
+ <Descriptions.Item label={b.billingRegionLabel} span={2}>
475
+ {regionName}
476
+ </Descriptions.Item>
477
+ </Descriptions>
478
+ </CardContent>
479
+ <CardFooter separated>
480
+ <Flex direction="col" gap="xs" className="sm:flex-row sm:items-center sm:gap-4">
481
+ <Button variant="outline" asChild>
482
+ <a href="https://billing.example.com/portal" target="_blank" rel="noreferrer">
483
+ <ExternalLink aria-hidden="true" />
484
+ {b.billingHandoff}
485
+ {/* Never signal "leaves the app" with the icon alone (WCAG 1.4.1 / 2.4.4). */}
486
+ <span className="sr-only"> ({b.opensInNewTab})</span>
487
+ </a>
488
+ </Button>
489
+ <Text size="xs" tone="muted">
490
+ {b.billingHandoffHint}
491
+ </Text>
492
+ </Flex>
493
+ </CardFooter>
494
+ </Card>
495
+
496
+ {/* ── 4 · Danger zone ─────────────────────────────────────────────────────────────
497
+ `Card accent="destructive"` paints the semantic leading rail from `--destructive`
498
+ through the existing `--card-accent-rail-width` token — a danger zone needs NO new
499
+ component and NO new token. Colour never carries the meaning alone: the heading says
500
+ "irreversible", the rows say what is lost, and delete is gated behind a type-to-confirm
501
+ AlertDialog (`challenge`). */}
502
+ <Card accent="destructive">
503
+ <CardHeader>
504
+ <CardTitle level={2} className="text-destructive">
505
+ {b.dangerTitle}
506
+ </CardTitle>
507
+ <CardDescription>{b.dangerDescription}</CardDescription>
508
+ </CardHeader>
509
+ <CardContent flush>
510
+ <ListRow
511
+ align="start"
512
+ overflow="wrap"
513
+ leading={<UserMinus className="text-muted-foreground size-4" aria-hidden="true" />}
514
+ title={b.dangerTransferTitle}
515
+ description={b.dangerTransferDescription}
516
+ trailing={
517
+ <Button variant="outline" size="sm">
518
+ {b.dangerTransfer}
519
+ </Button>
520
+ }
521
+ />
522
+ <ListRow
523
+ align="start"
524
+ overflow="wrap"
525
+ leading={<ShieldAlert className="text-destructive size-4" aria-hidden="true" />}
526
+ title={b.dangerDeleteTitle}
527
+ description={b.dangerDeleteDescription}
528
+ trailing={
529
+ <Button
530
+ variant="destructive"
531
+ size="sm"
532
+ onClick={() => {
533
+ setConfirmOpen(true);
534
+ }}
535
+ >
536
+ {b.dangerDelete}
537
+ </Button>
538
+ }
539
+ />
540
+ </CardContent>
541
+ </Card>
542
+ </Flex>
543
+
544
+ <AlertDialog
545
+ open={confirmOpen}
546
+ onOpenChange={setConfirmOpen}
547
+ title={b.confirmTitle}
548
+ description={b.confirmDescription}
549
+ challenge={WORKSPACE_SLUG}
550
+ variant="destructive"
551
+ confirmLabel={b.confirmLabel}
552
+ cancelLabel={b.cancelLabel}
553
+ onConfirm={() => {
554
+ setConfirmOpen(false);
555
+ }}
556
+ />
557
+ </PageContainer>
558
+ );
559
+ }