@godxjp/ui 5.0.2 → 6.0.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 (298) hide show
  1. package/README.md +101 -142
  2. package/package.json +124 -128
  3. package/scripts/ui-audit.mjs +179 -0
  4. package/src/app/__tests__/app-provider.test.tsx +232 -0
  5. package/src/app/__tests__/date-format-labels.test.ts +36 -0
  6. package/src/app/__tests__/date-formats.test.ts +44 -0
  7. package/src/app/__tests__/timezones.test.ts +65 -0
  8. package/src/app/app-provider.tsx +227 -0
  9. package/src/app/date-format-labels.ts +21 -0
  10. package/src/app/date-formats.ts +30 -0
  11. package/src/app/index.ts +40 -0
  12. package/src/app/locales.ts +32 -0
  13. package/src/app/request-headers.ts +31 -0
  14. package/src/app/storage.ts +44 -0
  15. package/src/app/time-format-labels.ts +19 -0
  16. package/src/app/time-formats.ts +15 -0
  17. package/src/app/timezones.ts +208 -0
  18. package/src/app/types.ts +39 -0
  19. package/src/app/use-formatting.ts +47 -0
  20. package/src/components/__tests__/accessibility-primitives.test.tsx +65 -0
  21. package/src/components/__tests__/docs-parity.test.ts +41 -0
  22. package/src/components/__tests__/shadcn-release-guardrails.test.ts +71 -0
  23. package/src/components/__tests__/theme-axes-integration.test.tsx +242 -0
  24. package/src/components/admin/index.ts +76 -0
  25. package/src/components/data-display/__tests__/card-table.test.tsx +328 -0
  26. package/src/components/data-display/__tests__/data-display.test.tsx +73 -0
  27. package/src/components/data-display/__tests__/data-table.test.tsx +84 -0
  28. package/src/components/data-display/__tests__/popover.test.tsx +92 -0
  29. package/src/components/data-display/__tests__/scroll-area-collapsible.test.tsx +66 -0
  30. package/src/components/data-display/badge.tsx +27 -0
  31. package/src/components/data-display/card.tsx +194 -0
  32. package/src/components/data-display/code-badge.tsx +28 -0
  33. package/src/components/data-display/collapsible.tsx +5 -0
  34. package/src/components/data-display/data-table.tsx +476 -0
  35. package/src/components/data-display/empty-state.tsx +22 -0
  36. package/src/components/data-display/index.ts +41 -0
  37. package/src/components/data-display/key-value-grid.tsx +46 -0
  38. package/src/components/data-display/popover.tsx +62 -0
  39. package/src/components/data-display/progress-meter.tsx +20 -0
  40. package/src/components/data-display/scan-panel.tsx +16 -0
  41. package/src/components/data-display/scroll-area.tsx +42 -0
  42. package/src/components/data-display/status-badge.tsx +83 -0
  43. package/src/components/data-display/table.tsx +59 -0
  44. package/src/components/data-display/timeline.tsx +42 -0
  45. package/src/components/data-display/tree-list.tsx +42 -0
  46. package/src/components/data-entry/__fixtures__/tree-options.ts +80 -0
  47. package/src/components/data-entry/__tests__/cascader-tree-transfer.test.tsx +417 -0
  48. package/src/components/data-entry/__tests__/checkbox-group.test.tsx +40 -0
  49. package/src/components/data-entry/__tests__/checkbox.test.tsx +20 -0
  50. package/src/components/data-entry/__tests__/date-autocomplete.test.tsx +94 -0
  51. package/src/components/data-entry/__tests__/form-field.test.tsx +49 -0
  52. package/src/components/data-entry/__tests__/input-textarea.test.tsx +38 -0
  53. package/src/components/data-entry/__tests__/label-select.test.tsx +62 -0
  54. package/src/components/data-entry/__tests__/pickers.test.tsx +74 -0
  55. package/src/components/data-entry/__tests__/radio.test.tsx +46 -0
  56. package/src/components/data-entry/__tests__/search-input.test.tsx +32 -0
  57. package/src/components/data-entry/__tests__/switch-field.test.tsx +52 -0
  58. package/src/components/data-entry/__tests__/upload.test.tsx +125 -0
  59. package/src/components/data-entry/autocomplete.tsx +91 -0
  60. package/src/components/data-entry/calendar.tsx +90 -0
  61. package/src/components/data-entry/cascader.tsx +305 -0
  62. package/src/components/data-entry/checkbox-group.tsx +90 -0
  63. package/src/components/data-entry/checkbox.tsx +30 -0
  64. package/src/components/data-entry/choice-field.tsx +27 -0
  65. package/src/components/data-entry/choice-option.ts +20 -0
  66. package/src/components/data-entry/color-picker.tsx +75 -0
  67. package/src/components/data-entry/command.tsx +56 -0
  68. package/src/components/data-entry/country-select.tsx +88 -0
  69. package/src/components/data-entry/date-picker.tsx +69 -0
  70. package/src/components/data-entry/date-range-picker.tsx +75 -0
  71. package/src/components/data-entry/form-field.tsx +59 -0
  72. package/src/components/data-entry/index.ts +62 -0
  73. package/src/components/data-entry/input.tsx +26 -0
  74. package/src/components/data-entry/label.tsx +25 -0
  75. package/src/components/data-entry/radio.tsx +109 -0
  76. package/src/components/data-entry/search-input.tsx +103 -0
  77. package/src/components/data-entry/select.tsx +149 -0
  78. package/src/components/data-entry/slider.tsx +38 -0
  79. package/src/components/data-entry/switch-field.tsx +91 -0
  80. package/src/components/data-entry/switch.tsx +24 -0
  81. package/src/components/data-entry/textarea.tsx +12 -0
  82. package/src/components/data-entry/time-picker.tsx +214 -0
  83. package/src/components/data-entry/transfer.tsx +231 -0
  84. package/src/components/data-entry/tree-select-strategy.ts +6 -0
  85. package/src/components/data-entry/tree-select.tsx +279 -0
  86. package/src/components/data-entry/tree-utils.ts +221 -0
  87. package/src/components/data-entry/upload-crop-dialog.tsx +109 -0
  88. package/src/components/data-entry/upload-types.ts +86 -0
  89. package/src/components/data-entry/upload.tsx +498 -0
  90. package/src/components/data-entry/use-upload-draft.ts +93 -0
  91. package/src/components/feedback/__tests__/alert.test.tsx +127 -0
  92. package/src/components/feedback/__tests__/dialog.test.tsx +290 -0
  93. package/src/components/feedback/__tests__/sheet.test.tsx +94 -0
  94. package/src/components/feedback/__tests__/skeleton.test.tsx +25 -0
  95. package/src/components/feedback/__tests__/toast.test.tsx +52 -0
  96. package/src/components/feedback/alert.tsx +167 -0
  97. package/src/components/feedback/dialog.tsx +325 -0
  98. package/src/components/feedback/index.ts +53 -0
  99. package/src/components/feedback/sheet.tsx +130 -0
  100. package/src/components/feedback/skeleton.tsx +95 -0
  101. package/src/components/feedback/sonner.tsx +54 -0
  102. package/src/components/feedback/toaster.tsx +1 -0
  103. package/src/components/feedback/use-toast.ts +62 -0
  104. package/src/components/general/__tests__/button.test.tsx +71 -0
  105. package/src/components/general/button.tsx +61 -0
  106. package/src/components/general/index.ts +2 -0
  107. package/src/components/layout/__tests__/page-container.test.tsx +69 -0
  108. package/src/components/layout/__tests__/page-inset.test.tsx +14 -0
  109. package/src/components/layout/__tests__/stack-inline.test.tsx +39 -0
  110. package/src/components/layout/app-shell.tsx +42 -0
  111. package/src/components/layout/breadcrumb.tsx +35 -0
  112. package/src/components/layout/index.ts +31 -0
  113. package/src/components/layout/inline.tsx +13 -0
  114. package/src/components/layout/menu.tsx +34 -0
  115. package/src/components/layout/mobile-frame.tsx +57 -0
  116. package/src/components/layout/page-container.tsx +81 -0
  117. package/src/components/layout/page-inset.tsx +16 -0
  118. package/src/components/layout/responsive-grid.tsx +14 -0
  119. package/src/components/layout/shell-app.tsx +30 -0
  120. package/src/components/layout/sidebar.tsx +98 -0
  121. package/src/components/layout/split-pane.tsx +16 -0
  122. package/src/components/layout/stack.tsx +13 -0
  123. package/src/components/layout/topbar.tsx +108 -0
  124. package/src/components/navigation/__tests__/app-pickers.test.tsx +118 -0
  125. package/src/components/navigation/__tests__/dropdown-menu.test.tsx +104 -0
  126. package/src/components/navigation/__tests__/navigation.test.tsx +61 -0
  127. package/src/components/navigation/__tests__/pagination-steps-tabs.test.tsx +76 -0
  128. package/src/components/navigation/date-format-picker.tsx +55 -0
  129. package/src/components/navigation/dropdown-menu.tsx +190 -0
  130. package/src/components/navigation/filter-bar.tsx +38 -0
  131. package/src/components/navigation/index.ts +28 -0
  132. package/src/components/navigation/locale-picker.tsx +49 -0
  133. package/src/components/navigation/page-header.tsx +50 -0
  134. package/src/components/navigation/pagination-utils.ts +35 -0
  135. package/src/components/navigation/pagination.tsx +168 -0
  136. package/src/components/navigation/steps.tsx +163 -0
  137. package/src/components/navigation/tabs-items.tsx +69 -0
  138. package/src/components/navigation/tabs.tsx +67 -0
  139. package/src/components/navigation/time-format-picker.tsx +55 -0
  140. package/src/components/navigation/timezone-picker.tsx +63 -0
  141. package/src/components/query/__tests__/data-state.test.tsx +214 -0
  142. package/src/components/query/__tests__/infinite-prefetch.test.tsx +105 -0
  143. package/src/components/query/__tests__/query-helpers.test.tsx +61 -0
  144. package/src/components/query/data-state.tsx +58 -0
  145. package/src/components/query/index.ts +10 -0
  146. package/src/components/query/infinite-query-state.tsx +99 -0
  147. package/src/components/query/mutation-feedback.tsx +31 -0
  148. package/src/components/query/prefetch-link.tsx +45 -0
  149. package/src/components/query/query-refetch-button.tsx +41 -0
  150. package/src/components/ui/alert-dialog.tsx +1 -0
  151. package/src/components/ui/alert.tsx +1 -0
  152. package/src/components/ui/autocomplete.tsx +1 -0
  153. package/src/components/ui/badge.tsx +1 -0
  154. package/src/components/ui/button.tsx +1 -0
  155. package/src/components/ui/calendar.tsx +1 -0
  156. package/src/components/ui/card.tsx +1 -0
  157. package/src/components/ui/checkbox.tsx +1 -0
  158. package/src/components/ui/color-picker.tsx +1 -0
  159. package/src/components/ui/command.tsx +1 -0
  160. package/src/components/ui/date-picker.tsx +1 -0
  161. package/src/components/ui/date-range-picker.tsx +1 -0
  162. package/src/components/ui/dialog.tsx +1 -0
  163. package/src/components/ui/dropdown-menu.tsx +1 -0
  164. package/src/components/ui/index.tsx +31 -0
  165. package/src/components/ui/input.tsx +1 -0
  166. package/src/components/ui/label.tsx +1 -0
  167. package/src/components/ui/pagination.tsx +1 -0
  168. package/src/components/ui/popover.tsx +1 -0
  169. package/src/components/ui/radio.tsx +1 -0
  170. package/src/components/ui/scroll-area.tsx +1 -0
  171. package/src/components/ui/select.tsx +1 -0
  172. package/src/components/ui/sheet.tsx +1 -0
  173. package/src/components/ui/slider.tsx +1 -0
  174. package/src/components/ui/sonner.tsx +1 -0
  175. package/src/components/ui/switch.tsx +1 -0
  176. package/src/components/ui/table.tsx +1 -0
  177. package/src/components/ui/tabs-items.tsx +1 -0
  178. package/src/components/ui/tabs.tsx +1 -0
  179. package/src/components/ui/textarea.tsx +1 -0
  180. package/src/components/ui/time-picker.tsx +1 -0
  181. package/src/components/ui/upload.tsx +1 -0
  182. package/src/form/__tests__/use-zod-form.test.tsx +97 -0
  183. package/src/form/form-field-control.tsx +44 -0
  184. package/src/form/form-root.tsx +29 -0
  185. package/src/form/index.ts +7 -0
  186. package/src/form/use-zod-form.ts +29 -0
  187. package/src/i18n/__tests__/translate.test.ts +23 -0
  188. package/src/i18n/index.ts +9 -0
  189. package/src/i18n/messages/en.json +171 -0
  190. package/src/i18n/messages/ja.json +171 -0
  191. package/src/i18n/messages/vi.json +171 -0
  192. package/src/i18n/translate.ts +74 -0
  193. package/src/i18n/use-translation.ts +53 -0
  194. package/src/index.ts +3 -0
  195. package/src/lib/__tests__/control-styles.test.ts +78 -0
  196. package/src/lib/__tests__/datetime.test.ts +77 -0
  197. package/src/lib/__tests__/format-date.test.ts +97 -0
  198. package/src/lib/__tests__/format.test.ts +62 -0
  199. package/src/lib/__tests__/theme-tokens-audit.test.ts +176 -0
  200. package/src/lib/__tests__/theme-tokens-css.test.ts +118 -0
  201. package/src/lib/__tests__/token-governance.test.ts +191 -0
  202. package/src/lib/__tests__/variants.test.ts +18 -0
  203. package/src/lib/control-styles.ts +33 -0
  204. package/src/lib/datetime/detect.ts +25 -0
  205. package/src/lib/datetime/format-date.ts +100 -0
  206. package/src/lib/datetime/format.ts +140 -0
  207. package/src/lib/datetime/index.ts +25 -0
  208. package/src/lib/datetime/parse.ts +51 -0
  209. package/src/lib/datetime/sync.ts +48 -0
  210. package/src/lib/format.ts +114 -0
  211. package/src/lib/hooks.ts +54 -0
  212. package/src/lib/utils.ts +6 -0
  213. package/src/lib/variants.ts +40 -0
  214. package/src/props/components/app.prop.ts +99 -0
  215. package/src/props/components/data-display.prop.ts +73 -0
  216. package/src/props/components/data-entry.prop.ts +334 -0
  217. package/src/props/components/feedback.prop.ts +80 -0
  218. package/src/props/components/form.prop.ts +46 -0
  219. package/src/props/components/general.prop.ts +18 -0
  220. package/src/props/components/index.ts +99 -0
  221. package/src/props/components/layout.prop.ts +130 -0
  222. package/src/props/components/navigation.prop.ts +88 -0
  223. package/src/props/components/query.prop.ts +94 -0
  224. package/src/props/index.ts +17 -0
  225. package/src/props/registry.ts +603 -0
  226. package/src/props/vocabulary/content.prop.ts +35 -0
  227. package/src/props/vocabulary/data.prop.ts +46 -0
  228. package/src/props/vocabulary/index.ts +73 -0
  229. package/src/props/vocabulary/interaction.prop.ts +42 -0
  230. package/src/props/vocabulary/layout.prop.ts +25 -0
  231. package/src/props/vocabulary/navigation.prop.ts +19 -0
  232. package/src/props/vocabulary/shared.prop.ts +59 -0
  233. package/src/styles/alert-layout.css +191 -0
  234. package/src/styles/badge-layout.css +22 -0
  235. package/src/styles/card-layout.css +373 -0
  236. package/src/styles/control.css +504 -0
  237. package/src/styles/data-display-layout.css +246 -0
  238. package/src/styles/density.css +43 -0
  239. package/src/styles/dialog-layout.css +84 -0
  240. package/src/styles/index.css +105 -0
  241. package/src/styles/layout.css +479 -0
  242. package/src/styles/shell-layout.css +604 -0
  243. package/src/styles/table-layout.css +109 -0
  244. package/src/test/__tests__/render-loop-guard.test.tsx +38 -0
  245. package/src/test/jest-dom.d.ts +4 -0
  246. package/src/test/render-loop-guard.tsx +50 -0
  247. package/src/test/render.tsx +29 -0
  248. package/src/test/theme-globals.test.ts +77 -0
  249. package/src/test/theme-globals.ts +134 -0
  250. package/src/test/theme-test-utils.tsx +67 -0
  251. package/src/theme/example.service.css +37 -0
  252. package/src/tokens/base.css +13 -0
  253. package/src/tokens/foundation.css +151 -0
  254. package/src/tokens/primitives/badge.css +13 -0
  255. package/src/tokens/primitives/card.css +29 -0
  256. package/src/tokens/primitives/control.css +55 -0
  257. package/src/tokens/primitives/feedback.css +17 -0
  258. package/src/tokens/primitives/layout.css +20 -0
  259. package/src/tokens/primitives/navigation.css +13 -0
  260. package/src/tokens/primitives/table.css +10 -0
  261. package/BRAND.md +0 -296
  262. package/CHANGELOG.md +0 -668
  263. package/config/eslint.js +0 -54
  264. package/config/prettier.cjs +0 -20
  265. package/config/tsconfig.base.json +0 -22
  266. package/config/vitest.base.ts +0 -26
  267. package/dist/MiniMonth-YAmPGEpC.d.ts +0 -143
  268. package/dist/Table.types-BbsxoIYE.d.ts +0 -352
  269. package/dist/color-DO0qqUAb.d.ts +0 -38
  270. package/dist/components/composites.d.ts +0 -963
  271. package/dist/components/composites.js +0 -7343
  272. package/dist/components/composites.js.map +0 -1
  273. package/dist/components/primitives.d.ts +0 -2744
  274. package/dist/components/primitives.js +0 -7356
  275. package/dist/components/primitives.js.map +0 -1
  276. package/dist/components/shell.d.ts +0 -182
  277. package/dist/components/shell.js +0 -774
  278. package/dist/components/shell.js.map +0 -1
  279. package/dist/hooks.d.ts +0 -100
  280. package/dist/hooks.js +0 -558
  281. package/dist/hooks.js.map +0 -1
  282. package/dist/i18n.d.ts +0 -61
  283. package/dist/i18n.js +0 -860
  284. package/dist/i18n.js.map +0 -1
  285. package/dist/index.d.ts +0 -33
  286. package/dist/index.js +0 -13062
  287. package/dist/index.js.map +0 -1
  288. package/dist/padding-DY0JV5Ja.d.ts +0 -16
  289. package/dist/preferences.d.ts +0 -132
  290. package/dist/preferences.js +0 -262
  291. package/dist/preferences.js.map +0 -1
  292. package/dist/props.d.ts +0 -86
  293. package/dist/props.js +0 -16
  294. package/dist/props.js.map +0 -1
  295. package/dist/size-CQwNvOWd.d.ts +0 -19
  296. package/dist/types-LTj-2bl-.d.ts +0 -30
  297. package/dist/useTableViews-D5NIAJ7h.d.ts +0 -154
  298. package/src/tokens/tailwind.css +0 -158
@@ -0,0 +1 @@
1
+ export * from "../data-display/card";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/checkbox";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/color-picker";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/command";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/date-picker";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/date-range-picker";
@@ -0,0 +1 @@
1
+ export * from "../feedback/dialog";
@@ -0,0 +1 @@
1
+ export * from "../navigation/dropdown-menu";
@@ -0,0 +1,31 @@
1
+ export * from "./alert";
2
+ export * from "./alert-dialog";
3
+ export * from "./autocomplete";
4
+ export * from "./badge";
5
+ export * from "./button";
6
+ export * from "./calendar";
7
+ export * from "./card";
8
+ export * from "./checkbox";
9
+ export * from "./color-picker";
10
+ export * from "./command";
11
+ export * from "./date-picker";
12
+ export * from "./date-range-picker";
13
+ export * from "./dialog";
14
+ export * from "./dropdown-menu";
15
+ export * from "./input";
16
+ export * from "./label";
17
+ export * from "./pagination";
18
+ export * from "./popover";
19
+ export * from "./radio";
20
+ export * from "./scroll-area";
21
+ export * from "./select";
22
+ export * from "./sheet";
23
+ export * from "./slider";
24
+ export * from "./sonner";
25
+ export * from "./switch";
26
+ export * from "./table";
27
+ export * from "./tabs";
28
+ export * from "./tabs-items";
29
+ export * from "./textarea";
30
+ export * from "./time-picker";
31
+ export * from "./upload";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/input";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/label";
@@ -0,0 +1 @@
1
+ export * from "../navigation/pagination";
@@ -0,0 +1 @@
1
+ export * from "../data-display/popover";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/radio";
@@ -0,0 +1 @@
1
+ export * from "../data-display/scroll-area";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/select";
@@ -0,0 +1 @@
1
+ export * from "../feedback/sheet";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/slider";
@@ -0,0 +1 @@
1
+ export * from "../feedback/sonner";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/switch";
@@ -0,0 +1 @@
1
+ export * from "../data-display/table";
@@ -0,0 +1 @@
1
+ export * from "../navigation/tabs-items";
@@ -0,0 +1 @@
1
+ export * from "../navigation/tabs";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/textarea";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/time-picker";
@@ -0,0 +1 @@
1
+ export * from "../data-entry/upload";
@@ -0,0 +1,97 @@
1
+ import { describe, expect, it, vi } from "vitest";
2
+ import { z } from "zod";
3
+ import { act, renderHook } from "@testing-library/react";
4
+ import { renderWithUi, screen, userEvent, waitFor } from "@/test/render";
5
+ import { useZodForm } from "../use-zod-form";
6
+ import { FormRoot } from "../form-root";
7
+ import { FormFieldControl } from "../form-field-control";
8
+ import { Input } from "../../components/data-entry/input";
9
+ import { Button } from "../../components/general/button";
10
+
11
+ const schema = z.object({
12
+ email: z.string().email("Email không hợp lệ"),
13
+ name: z.string().min(1, "Bắt buộc"),
14
+ });
15
+
16
+ function TestForm({ onSubmit }: { onSubmit: (v: z.infer<typeof schema>) => void }) {
17
+ const form = useZodForm(schema, { defaultValues: { email: "", name: "" } });
18
+ return (
19
+ <FormRoot form={form} onSubmit={onSubmit}>
20
+ <FormFieldControl name="name" label="Name" required>
21
+ {(field) => <Input {...field} value={typeof field.value === "string" ? field.value : ""} />}
22
+ </FormFieldControl>
23
+ <FormFieldControl name="email" label="Email" required>
24
+ {(field) => (
25
+ <Input
26
+ {...field}
27
+ type="email"
28
+ value={typeof field.value === "string" ? field.value : ""}
29
+ />
30
+ )}
31
+ </FormFieldControl>
32
+ <Button type="submit">Submit</Button>
33
+ </FormRoot>
34
+ );
35
+ }
36
+
37
+ describe("useZodForm + FormRoot + FormFieldControl", () => {
38
+ it("useZodForm handleSubmit invokes callback with valid data", async () => {
39
+ const onSubmit = vi.fn();
40
+ const { result } = renderHook(() =>
41
+ useZodForm(schema, { defaultValues: { name: "", email: "" } }),
42
+ );
43
+
44
+ await act(async () => {
45
+ result.current.setValue("name", "Bao");
46
+ result.current.setValue("email", "dev@example.com");
47
+ await result.current.handleSubmit(onSubmit)();
48
+ });
49
+
50
+ expect(onSubmit.mock.calls[0]?.[0]).toEqual({
51
+ name: "Bao",
52
+ email: "dev@example.com",
53
+ });
54
+ });
55
+
56
+ it("blocks submit and shows Zod validation errors", async () => {
57
+ const user = userEvent.setup();
58
+ const onSubmit = vi.fn();
59
+ renderWithUi(<TestForm onSubmit={onSubmit} />);
60
+
61
+ await user.click(screen.getByRole("button", { name: "Submit" }));
62
+
63
+ await waitFor(() => {
64
+ expect(screen.getAllByRole("alert").length).toBeGreaterThan(0);
65
+ });
66
+ expect(onSubmit).not.toHaveBeenCalled();
67
+ });
68
+
69
+ it("FormRoot submits with registered inputs after user typing", async () => {
70
+ const user = userEvent.setup();
71
+ const onSubmit = vi.fn();
72
+
73
+ function SimpleForm() {
74
+ const form = useZodForm(schema, { defaultValues: { name: "", email: "" } });
75
+ const { register } = form;
76
+ return (
77
+ <FormRoot form={form} onSubmit={onSubmit}>
78
+ <input aria-label="name" {...register("name")} />
79
+ <input aria-label="email" type="email" {...register("email")} />
80
+ <Button type="submit">Submit</Button>
81
+ </FormRoot>
82
+ );
83
+ }
84
+
85
+ renderWithUi(<SimpleForm />);
86
+ await user.type(screen.getByLabelText("name"), "Bao");
87
+ await user.type(screen.getByLabelText("email"), "dev@example.com");
88
+ await user.click(screen.getByRole("button", { name: "Submit" }));
89
+
90
+ await waitFor(() => {
91
+ expect(onSubmit).toHaveBeenCalledWith({
92
+ name: "Bao",
93
+ email: "dev@example.com",
94
+ });
95
+ });
96
+ });
97
+ });
@@ -0,0 +1,44 @@
1
+ import type { Ref } from "react";
2
+ import { Controller, useFormContext, type FieldValues } from "react-hook-form";
3
+
4
+ import { FormField } from "../components/data-entry/form-field";
5
+ import type { FormFieldControlProp } from "../props/components/form.prop";
6
+
7
+ export type { FormFieldControlProp } from "../props/components/form.prop";
8
+
9
+ export function FormFieldControl<TFieldValues extends FieldValues>({
10
+ name,
11
+ label,
12
+ required,
13
+ helper,
14
+ className,
15
+ children,
16
+ }: FormFieldControlProp<TFieldValues>) {
17
+ const { control } = useFormContext<TFieldValues>();
18
+
19
+ return (
20
+ <Controller
21
+ name={name}
22
+ control={control}
23
+ render={({ field, fieldState }) => (
24
+ <FormField
25
+ id={String(name)}
26
+ label={label}
27
+ required={required}
28
+ helper={helper}
29
+ error={fieldState.error?.message}
30
+ className={className}
31
+ >
32
+ {children({
33
+ id: String(name),
34
+ name: field.name,
35
+ value: field.value,
36
+ onChange: field.onChange,
37
+ onBlur: field.onBlur,
38
+ ref: field.ref as Ref<HTMLInputElement>,
39
+ })}
40
+ </FormField>
41
+ )}
42
+ />
43
+ );
44
+ }
@@ -0,0 +1,29 @@
1
+ import { FormProvider, type FieldValues } from "react-hook-form";
2
+
3
+ import { cn } from "../lib/utils";
4
+ import type { FormRootProp } from "../props/components/form.prop";
5
+
6
+ export type { FormRootProp } from "../props/components/form.prop";
7
+
8
+ export function FormRoot<TFieldValues extends FieldValues>({
9
+ form,
10
+ onSubmit,
11
+ children,
12
+ className,
13
+ id,
14
+ }: FormRootProp<TFieldValues>) {
15
+ return (
16
+ <FormProvider {...form}>
17
+ <form
18
+ id={id}
19
+ className={cn("ui-stack-md", className)}
20
+ onSubmit={(event) => {
21
+ void form.handleSubmit((values) => onSubmit(values))(event);
22
+ }}
23
+ noValidate
24
+ >
25
+ {children}
26
+ </form>
27
+ </FormProvider>
28
+ );
29
+ }
@@ -0,0 +1,7 @@
1
+ export { useZodForm } from "./use-zod-form";
2
+ export type { UseZodFormOptionsProp, UseZodFormReturnProp } from "./use-zod-form";
3
+ export { FormRoot } from "./form-root";
4
+ export type { FormRootProp } from "./form-root";
5
+ export { FormFieldControl } from "./form-field-control";
6
+ export type { FormFieldControlProp } from "./form-field-control";
7
+ export type { ZodSchemaProp, FieldErrorMessageProp } from "../props/components/form.prop";
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Mandatory form hook — wraps react-hook-form + @hookform/resolvers/zod (Zod 4).
3
+ */
4
+ import {
5
+ useForm,
6
+ type DefaultValues,
7
+ type FieldValues,
8
+ type Resolver,
9
+ type UseFormReturn,
10
+ } from "react-hook-form";
11
+ import { zodResolver } from "@hookform/resolvers/zod";
12
+ import type { z } from "zod";
13
+
14
+ import type { UseZodFormOptionsProp } from "../props/components/form.prop";
15
+
16
+ export type { UseZodFormOptionsProp, UseZodFormReturnProp } from "../props/components/form.prop";
17
+
18
+ export function useZodForm<TFieldValues extends FieldValues>(
19
+ schema: z.ZodType<TFieldValues, FieldValues>,
20
+ options?: Omit<UseZodFormOptionsProp<TFieldValues>, "defaultValues"> & {
21
+ defaultValues?: DefaultValues<TFieldValues>;
22
+ },
23
+ ): UseFormReturn<TFieldValues> {
24
+ return useForm<TFieldValues>({
25
+ ...options,
26
+ // zodResolver + Zod 4 inference gap — runtime types are correct.
27
+ resolver: zodResolver(schema) as Resolver<TFieldValues>,
28
+ }) as UseFormReturn<TFieldValues>;
29
+ }
@@ -0,0 +1,23 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { translate, translateCurrent, resetI18nLocale, syncI18nLocale } from "../translate";
3
+
4
+ describe("i18n translate", () => {
5
+ it("returns primary locale message", () => {
6
+ expect(translate("vi", "en", "common.cancel")).toBe("Hủy");
7
+ expect(translate("en", "vi", "common.cancel")).toBe("Cancel");
8
+ });
9
+
10
+ it("falls back when key missing in primary", () => {
11
+ expect(translate("vi", "en", "nonexistent.key")).toBe("nonexistent.key");
12
+ });
13
+
14
+ it("interpolates params", () => {
15
+ expect(translate("en", "vi", "common.selectedCount", { count: 3 })).toBe("3 selected");
16
+ });
17
+
18
+ it("syncI18nLocale drives translateCurrent", () => {
19
+ resetI18nLocale();
20
+ syncI18nLocale("ja", "en");
21
+ expect(translateCurrent("common.retry")).toBe("再試行");
22
+ });
23
+ });
@@ -0,0 +1,9 @@
1
+ export {
2
+ translate,
3
+ translateCurrent,
4
+ syncI18nLocale,
5
+ resetI18nLocale,
6
+ MESSAGE_CATALOG,
7
+ } from "./translate";
8
+ export type { Messages, MessageKey, TranslateParams } from "./translate";
9
+ export { useTranslation, usePickerLocales } from "./use-translation";
@@ -0,0 +1,171 @@
1
+ {
2
+ "common": {
3
+ "cancel": "Cancel",
4
+ "continue": "Continue",
5
+ "delete": "Delete",
6
+ "error": "Something went wrong",
7
+ "working": "Working…",
8
+ "retry": "Retry",
9
+ "search": "Search",
10
+ "clearSearch": "Clear search",
11
+ "clearFilters": "Clear filters",
12
+ "first": "First",
13
+ "next": "Next →",
14
+ "selectedCount": "{count} selected",
15
+ "typeToConfirm": "Type {phrase} to confirm"
16
+ },
17
+ "dataEntry": {
18
+ "datePicker": {
19
+ "placeholder": "Select date"
20
+ },
21
+ "dateRangePicker": {
22
+ "placeholder": "Select date range"
23
+ },
24
+ "timePicker": {
25
+ "placeholder": "Select time",
26
+ "hour": "Hour",
27
+ "minute": "Minute",
28
+ "typeLabel": "Type time HH:mm"
29
+ },
30
+ "searchInput": {
31
+ "placeholder": "Search…"
32
+ },
33
+ "autocomplete": {
34
+ "placeholder": "Search or select…",
35
+ "empty": "No results found"
36
+ },
37
+ "colorPicker": {
38
+ "ariaLabel": "Pick color"
39
+ },
40
+ "upload": {
41
+ "dropzoneLabel": "Upload files",
42
+ "dropzoneHint": "Drag and drop files here, or click to browse",
43
+ "dropzoneMeta": "Uploads go to temp storage — promote on form save",
44
+ "buttonLabel": "Choose file",
45
+ "addImage": "Add image",
46
+ "uploading": "Uploading…",
47
+ "pendingReplace": "New image",
48
+ "pendingReplaceHint": "New image staged — save form to apply",
49
+ "avatarLabel": "Profile photo",
50
+ "change": "Change",
51
+ "removeAvatar": "Remove photo",
52
+ "markedForDelete": "Photo will be removed when you save",
53
+ "undo": "Undo",
54
+ "cropTitle": "Crop photo",
55
+ "cropZoom": "Zoom",
56
+ "cropConfirm": "Use photo"
57
+ },
58
+ "cascader": {
59
+ "placeholder": "Select…",
60
+ "searchPlaceholder": "Search…",
61
+ "empty": "No results"
62
+ },
63
+ "treeSelect": {
64
+ "placeholder": "Select…",
65
+ "searchPlaceholder": "Search…",
66
+ "empty": "No data",
67
+ "expand": "Expand",
68
+ "collapse": "Collapse"
69
+ },
70
+ "transfer": {
71
+ "source": "Source",
72
+ "target": "Target",
73
+ "searchPlaceholder": "Search…",
74
+ "empty": "No data",
75
+ "moveRight": "Move to target",
76
+ "moveLeft": "Move to source"
77
+ }
78
+ },
79
+ "feedback": {
80
+ "errorPanel": {
81
+ "title": "Couldn't load this section"
82
+ },
83
+ "genericError": "Something went wrong. Please retry."
84
+ },
85
+ "navigation": {
86
+ "localePicker": {
87
+ "ariaLabel": "Language"
88
+ },
89
+ "timezonePicker": {
90
+ "ariaLabel": "Timezone"
91
+ },
92
+ "timeFormatPicker": {
93
+ "ariaLabel": "Time format"
94
+ },
95
+ "dateFormatPicker": {
96
+ "ariaLabel": "Date format"
97
+ },
98
+ "pagination": {
99
+ "ariaLabel": "Pagination",
100
+ "prev": "Previous page",
101
+ "next": "Next page",
102
+ "page": "Page {page}",
103
+ "pageSize": "Page size",
104
+ "pageSizeOption": "{size} / page",
105
+ "total": "Total {total} items"
106
+ }
107
+ },
108
+ "locale": {
109
+ "vi": "Tiếng Việt",
110
+ "en": "English",
111
+ "ja": "日本語"
112
+ },
113
+ "timeFormat": {
114
+ "24h": "24-hour",
115
+ "12h": "12-hour (AM/PM)"
116
+ },
117
+ "dateFormat": {
118
+ "iso": "ISO (yyyy-MM-dd)",
119
+ "dmy": "Day / Month / Year",
120
+ "mdy": "Month / Day / Year"
121
+ },
122
+ "timezone": {
123
+ "Asia/Ho_Chi_Minh": "Vietnam (Ho Chi Minh)",
124
+ "Asia/Tokyo": "Japan (Tokyo)",
125
+ "Asia/Bangkok": "Thailand (Bangkok)",
126
+ "Asia/Singapore": "Singapore",
127
+ "Asia/Seoul": "Korea (Seoul)",
128
+ "Asia/Shanghai": "China (Shanghai)",
129
+ "Asia/Taipei": "Taiwan (Taipei)",
130
+ "Asia/Hong_Kong": "Hong Kong",
131
+ "UTC": "UTC",
132
+ "Europe/London": "UK (London)",
133
+ "America/Los_Angeles": "US (Los Angeles)",
134
+ "America/New_York": "US (New York)"
135
+ },
136
+ "dataTable": {
137
+ "selectAll": "Select all rows",
138
+ "selectRow": "Select row {id}",
139
+ "bulkActions": "Bulk actions",
140
+ "densityCompact": "Compact",
141
+ "densityComfortable": "Comfortable",
142
+ "densitySwitch": "Switch to {density} density",
143
+ "rowActions": "Row actions"
144
+ },
145
+ "status": {
146
+ "active": "Active",
147
+ "completed": "Completed",
148
+ "delivered": "Delivered",
149
+ "done": "Done",
150
+ "permanent": "Permanent",
151
+ "succeeded": "Succeeded",
152
+ "draft": "Draft",
153
+ "pending": "Pending",
154
+ "scheduled": "Scheduled",
155
+ "sending": "Sending",
156
+ "temporary": "Temporary",
157
+ "bounced": "Bounced",
158
+ "cancelled": "Cancelled",
159
+ "deleted": "Deleted",
160
+ "failed": "Failed",
161
+ "private": "Private",
162
+ "internal": "Internal",
163
+ "public": "Public",
164
+ "ASSIGNMENT_STATUS_ACTIVE": "Active",
165
+ "ASSIGNMENT_STATUS_SUSPENDED": "Suspended",
166
+ "ASSIGNMENT_STATUS_TERMINATED": "Terminated"
167
+ },
168
+ "query": {
169
+ "loadMore": "Load more"
170
+ }
171
+ }