@mgamadeus/ddd-admin-ui 0.1.0-rc.6 → 0.2.1

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 (572) hide show
  1. package/.claude/skills/ddd-admin-ui-specialist/SKILL.md +56 -2
  2. package/CHANGELOG.md +243 -1
  3. package/README.md +266 -26
  4. package/STANDARDS.md +173 -2
  5. package/dist/components.css +27 -3
  6. package/dist/data/DeltaText.d.ts +29 -0
  7. package/dist/data/DeltaText.d.ts.map +1 -0
  8. package/dist/data/DeltaText.js +36 -0
  9. package/dist/data/DeltaText.js.map +1 -0
  10. package/dist/data/MetricGrid.d.ts +15 -0
  11. package/dist/data/MetricGrid.d.ts.map +1 -0
  12. package/dist/data/MetricGrid.js +17 -0
  13. package/dist/data/MetricGrid.js.map +1 -0
  14. package/dist/data/MetricTile.d.ts +32 -0
  15. package/dist/data/MetricTile.d.ts.map +1 -0
  16. package/dist/data/MetricTile.js +13 -0
  17. package/dist/data/MetricTile.js.map +1 -0
  18. package/dist/data/NoteList.d.ts +19 -0
  19. package/dist/data/NoteList.d.ts.map +1 -0
  20. package/dist/data/NoteList.js +23 -0
  21. package/dist/data/NoteList.js.map +1 -0
  22. package/dist/data/delta.d.ts +40 -0
  23. package/dist/data/delta.d.ts.map +1 -0
  24. package/dist/data/delta.js +40 -0
  25. package/dist/data/delta.js.map +1 -0
  26. package/dist/data/index.d.ts +6 -0
  27. package/dist/data/index.d.ts.map +1 -0
  28. package/dist/data/index.js +7 -0
  29. package/dist/data/index.js.map +1 -0
  30. package/dist/design-studio/contract.d.ts +162 -0
  31. package/dist/design-studio/contract.d.ts.map +1 -0
  32. package/dist/design-studio/contract.js +2 -0
  33. package/dist/design-studio/contract.js.map +1 -0
  34. package/dist/design-studio/index.d.ts +45 -0
  35. package/dist/design-studio/index.d.ts.map +1 -0
  36. package/dist/design-studio/index.js +47 -0
  37. package/dist/design-studio/index.js.map +1 -0
  38. package/dist/form/ColorValueField.d.ts +37 -0
  39. package/dist/form/ColorValueField.d.ts.map +1 -0
  40. package/dist/form/ColorValueField.js +74 -0
  41. package/dist/form/ColorValueField.js.map +1 -0
  42. package/dist/form/FormDialog.d.ts +1 -0
  43. package/dist/form/FormDialog.d.ts.map +1 -1
  44. package/dist/form/FormDialog.js +3 -1
  45. package/dist/form/FormDialog.js.map +1 -1
  46. package/dist/form/FormDrawer.d.ts +12 -1
  47. package/dist/form/FormDrawer.d.ts.map +1 -1
  48. package/dist/form/FormDrawer.js +9 -2
  49. package/dist/form/FormDrawer.js.map +1 -1
  50. package/dist/form/index.d.ts +2 -0
  51. package/dist/form/index.d.ts.map +1 -1
  52. package/dist/form/index.js +2 -0
  53. package/dist/form/index.js.map +1 -1
  54. package/dist/glass/QuickFilterPills.d.ts +7 -0
  55. package/dist/glass/QuickFilterPills.d.ts.map +1 -1
  56. package/dist/glass/QuickFilterPills.js +4 -3
  57. package/dist/glass/QuickFilterPills.js.map +1 -1
  58. package/dist/i18n/format.d.ts +3 -2
  59. package/dist/i18n/format.d.ts.map +1 -1
  60. package/dist/i18n/format.js +3 -2
  61. package/dist/i18n/format.js.map +1 -1
  62. package/dist/i18n/formatLocale.d.ts +8 -0
  63. package/dist/i18n/formatLocale.d.ts.map +1 -0
  64. package/dist/i18n/formatLocale.js +10 -0
  65. package/dist/i18n/formatLocale.js.map +1 -0
  66. package/dist/i18n/hints.json +498 -1
  67. package/dist/i18n/index.d.ts +1 -0
  68. package/dist/i18n/index.d.ts.map +1 -1
  69. package/dist/i18n/index.js +1 -0
  70. package/dist/i18n/index.js.map +1 -1
  71. package/dist/i18n-keys.json +4444 -351
  72. package/dist/list/ActionsHeaderText.d.ts +5 -0
  73. package/dist/list/ActionsHeaderText.d.ts.map +1 -0
  74. package/dist/list/ActionsHeaderText.js +9 -0
  75. package/dist/list/ActionsHeaderText.js.map +1 -0
  76. package/dist/list/Combobox.d.ts +11 -1
  77. package/dist/list/Combobox.d.ts.map +1 -1
  78. package/dist/list/Combobox.js +10 -7
  79. package/dist/list/Combobox.js.map +1 -1
  80. package/dist/list/EntityListBody.d.ts +9 -1
  81. package/dist/list/EntityListBody.d.ts.map +1 -1
  82. package/dist/list/EntityListBody.js +5 -3
  83. package/dist/list/EntityListBody.js.map +1 -1
  84. package/dist/list/EntityListBulkBar.d.ts +45 -3
  85. package/dist/list/EntityListBulkBar.d.ts.map +1 -1
  86. package/dist/list/EntityListBulkBar.js +31 -5
  87. package/dist/list/EntityListBulkBar.js.map +1 -1
  88. package/dist/list/EntityListEmpty.d.ts +9 -3
  89. package/dist/list/EntityListEmpty.d.ts.map +1 -1
  90. package/dist/list/EntityListEmpty.js +3 -3
  91. package/dist/list/EntityListEmpty.js.map +1 -1
  92. package/dist/list/EntityListTable.d.ts +3 -2
  93. package/dist/list/EntityListTable.d.ts.map +1 -1
  94. package/dist/list/EntityListTable.js +12 -8
  95. package/dist/list/EntityListTable.js.map +1 -1
  96. package/dist/list/EntityListToolbar.d.ts +30 -0
  97. package/dist/list/EntityListToolbar.d.ts.map +1 -1
  98. package/dist/list/EntityListToolbar.js +18 -4
  99. package/dist/list/EntityListToolbar.js.map +1 -1
  100. package/dist/list/EntityListViewToggle.d.ts +4 -1
  101. package/dist/list/EntityListViewToggle.d.ts.map +1 -1
  102. package/dist/list/EntityListViewToggle.js +15 -4
  103. package/dist/list/EntityListViewToggle.js.map +1 -1
  104. package/dist/list/cells.d.ts +10 -2
  105. package/dist/list/cells.d.ts.map +1 -1
  106. package/dist/list/cells.js +15 -6
  107. package/dist/list/cells.js.map +1 -1
  108. package/dist/list/columns.d.ts +85 -0
  109. package/dist/list/columns.d.ts.map +1 -0
  110. package/dist/list/columns.js +88 -0
  111. package/dist/list/columns.js.map +1 -0
  112. package/dist/list/filters.d.ts +19 -1
  113. package/dist/list/filters.d.ts.map +1 -1
  114. package/dist/list/filters.js +47 -3
  115. package/dist/list/filters.js.map +1 -1
  116. package/dist/list/index.d.ts +6 -0
  117. package/dist/list/index.d.ts.map +1 -1
  118. package/dist/list/index.js +3 -0
  119. package/dist/list/index.js.map +1 -1
  120. package/dist/logic/browser/normalizeImage.d.ts +69 -0
  121. package/dist/logic/browser/normalizeImage.d.ts.map +1 -0
  122. package/dist/logic/browser/normalizeImage.js +147 -0
  123. package/dist/logic/browser/normalizeImage.js.map +1 -0
  124. package/dist/logic/index.d.ts +25 -2
  125. package/dist/logic/index.d.ts.map +1 -1
  126. package/dist/logic/index.js +15 -1
  127. package/dist/logic/index.js.map +1 -1
  128. package/dist/logic/pure/colorValue.d.ts +22 -0
  129. package/dist/logic/pure/colorValue.d.ts.map +1 -0
  130. package/dist/logic/pure/colorValue.js +34 -0
  131. package/dist/logic/pure/colorValue.js.map +1 -0
  132. package/dist/logic/pure/confirm.d.ts +1 -0
  133. package/dist/logic/pure/confirm.d.ts.map +1 -1
  134. package/dist/logic/pure/confirm.js.map +1 -1
  135. package/dist/logic/pure/dateRangePresets.d.ts +33 -0
  136. package/dist/logic/pure/dateRangePresets.d.ts.map +1 -0
  137. package/dist/logic/pure/dateRangePresets.js +41 -0
  138. package/dist/logic/pure/dateRangePresets.js.map +1 -0
  139. package/dist/logic/pure/format.d.ts +3 -3
  140. package/dist/logic/pure/format.d.ts.map +1 -1
  141. package/dist/logic/pure/format.js +13 -12
  142. package/dist/logic/pure/format.js.map +1 -1
  143. package/dist/logic/pure/imageCrop.d.ts +99 -0
  144. package/dist/logic/pure/imageCrop.d.ts.map +1 -0
  145. package/dist/logic/pure/imageCrop.js +198 -0
  146. package/dist/logic/pure/imageCrop.js.map +1 -0
  147. package/dist/logic/pure/injectedApi.d.ts +83 -0
  148. package/dist/logic/pure/injectedApi.d.ts.map +1 -0
  149. package/dist/logic/pure/injectedApi.js +87 -0
  150. package/dist/logic/pure/injectedApi.js.map +1 -0
  151. package/dist/logic/pure/listTracks.d.ts +14 -2
  152. package/dist/logic/pure/listTracks.d.ts.map +1 -1
  153. package/dist/logic/pure/listTracks.js +15 -4
  154. package/dist/logic/pure/listTracks.js.map +1 -1
  155. package/dist/logic/pure/locales.d.ts +22 -0
  156. package/dist/logic/pure/locales.d.ts.map +1 -1
  157. package/dist/logic/pure/locales.js +43 -0
  158. package/dist/logic/pure/locales.js.map +1 -1
  159. package/dist/logic/pure/navigation.d.ts +159 -0
  160. package/dist/logic/pure/navigation.d.ts.map +1 -0
  161. package/dist/logic/pure/navigation.js +158 -0
  162. package/dist/logic/pure/navigation.js.map +1 -0
  163. package/dist/logic/pure/runSequential.d.ts +42 -0
  164. package/dist/logic/pure/runSequential.d.ts.map +1 -1
  165. package/dist/logic/pure/runSequential.js +65 -13
  166. package/dist/logic/pure/runSequential.js.map +1 -1
  167. package/dist/logic/pure/textLimits.d.ts +18 -0
  168. package/dist/logic/pure/textLimits.d.ts.map +1 -0
  169. package/dist/logic/pure/textLimits.js +14 -0
  170. package/dist/logic/pure/textLimits.js.map +1 -0
  171. package/dist/logic/react/textLimits.d.ts +8 -0
  172. package/dist/logic/react/textLimits.d.ts.map +1 -0
  173. package/dist/logic/react/textLimits.js +9 -0
  174. package/dist/logic/react/textLimits.js.map +1 -0
  175. package/dist/logic/react/useEntityTranslations.d.ts +16 -1
  176. package/dist/logic/react/useEntityTranslations.d.ts.map +1 -1
  177. package/dist/logic/react/useEntityTranslations.js +18 -4
  178. package/dist/logic/react/useEntityTranslations.js.map +1 -1
  179. package/dist/logic/react/useMediaQuery.d.ts +14 -0
  180. package/dist/logic/react/useMediaQuery.d.ts.map +1 -0
  181. package/dist/logic/react/useMediaQuery.js +24 -0
  182. package/dist/logic/react/useMediaQuery.js.map +1 -0
  183. package/dist/logic/react/useMemoryUrlState.d.ts +13 -0
  184. package/dist/logic/react/useMemoryUrlState.d.ts.map +1 -0
  185. package/dist/logic/react/useMemoryUrlState.js +41 -0
  186. package/dist/logic/react/useMemoryUrlState.js.map +1 -0
  187. package/dist/logic/react/useOptimisticRowPatches.d.ts +16 -0
  188. package/dist/logic/react/useOptimisticRowPatches.d.ts.map +1 -0
  189. package/dist/logic/react/useOptimisticRowPatches.js +39 -0
  190. package/dist/logic/react/useOptimisticRowPatches.js.map +1 -0
  191. package/dist/markdown/MarkdownEditor.d.ts +36 -0
  192. package/dist/markdown/MarkdownEditor.d.ts.map +1 -0
  193. package/dist/markdown/MarkdownEditor.js +36 -0
  194. package/dist/markdown/MarkdownEditor.js.map +1 -0
  195. package/dist/markdown/MarkdownPreview.d.ts +15 -0
  196. package/dist/markdown/MarkdownPreview.d.ts.map +1 -0
  197. package/dist/markdown/MarkdownPreview.js +17 -0
  198. package/dist/markdown/MarkdownPreview.js.map +1 -0
  199. package/dist/markdown/index.d.ts +7 -0
  200. package/dist/markdown/index.d.ts.map +1 -0
  201. package/dist/markdown/index.js +9 -0
  202. package/dist/markdown/index.js.map +1 -0
  203. package/dist/markdown/loadMarkdownLibrary.d.ts +28 -0
  204. package/dist/markdown/loadMarkdownLibrary.d.ts.map +1 -0
  205. package/dist/markdown/loadMarkdownLibrary.js +40 -0
  206. package/dist/markdown/loadMarkdownLibrary.js.map +1 -0
  207. package/dist/markdown/markdownPipeline.d.ts +20 -0
  208. package/dist/markdown/markdownPipeline.d.ts.map +1 -0
  209. package/dist/markdown/markdownPipeline.js +50 -0
  210. package/dist/markdown/markdownPipeline.js.map +1 -0
  211. package/dist/markdown/renderMarkdownEditor.d.ts +18 -0
  212. package/dist/markdown/renderMarkdownEditor.d.ts.map +1 -0
  213. package/dist/markdown/renderMarkdownEditor.js +14 -0
  214. package/dist/markdown/renderMarkdownEditor.js.map +1 -0
  215. package/dist/markdown/useMarkdownLibrary.d.ts +24 -0
  216. package/dist/markdown/useMarkdownLibrary.d.ts.map +1 -0
  217. package/dist/markdown/useMarkdownLibrary.js +47 -0
  218. package/dist/markdown/useMarkdownLibrary.js.map +1 -0
  219. package/dist/media/ImageCropDialog.d.ts +48 -0
  220. package/dist/media/ImageCropDialog.d.ts.map +1 -0
  221. package/dist/media/ImageCropDialog.js +203 -0
  222. package/dist/media/ImageCropDialog.js.map +1 -0
  223. package/dist/media/MediaItemField.d.ts.map +1 -1
  224. package/dist/media/MediaItemField.js +3 -1
  225. package/dist/media/MediaItemField.js.map +1 -1
  226. package/dist/media/MediaItemPickerDialog.d.ts +1 -0
  227. package/dist/media/MediaItemPickerDialog.d.ts.map +1 -1
  228. package/dist/media/MediaItemPickerDialog.js +3 -1
  229. package/dist/media/MediaItemPickerDialog.js.map +1 -1
  230. package/dist/media/index.d.ts +2 -0
  231. package/dist/media/index.d.ts.map +1 -1
  232. package/dist/media/index.js +2 -0
  233. package/dist/media/index.js.map +1 -1
  234. package/dist/next/index.d.ts +1 -0
  235. package/dist/next/index.d.ts.map +1 -1
  236. package/dist/next/index.js +1 -0
  237. package/dist/next/index.js.map +1 -1
  238. package/dist/next/useNextPathname.d.ts +7 -0
  239. package/dist/next/useNextPathname.d.ts.map +1 -0
  240. package/dist/next/useNextPathname.js +9 -0
  241. package/dist/next/useNextPathname.js.map +1 -0
  242. package/dist/page/DetailHeader.d.ts.map +1 -1
  243. package/dist/page/DetailHeader.js +3 -1
  244. package/dist/page/DetailHeader.js.map +1 -1
  245. package/dist/page/MaintenanceActionCard.d.ts +29 -0
  246. package/dist/page/MaintenanceActionCard.d.ts.map +1 -0
  247. package/dist/page/MaintenanceActionCard.js +21 -0
  248. package/dist/page/MaintenanceActionCard.js.map +1 -0
  249. package/dist/page/PageHeader.d.ts.map +1 -1
  250. package/dist/page/PageHeader.js +3 -1
  251. package/dist/page/PageHeader.js.map +1 -1
  252. package/dist/page/RouteError.d.ts +26 -0
  253. package/dist/page/RouteError.d.ts.map +1 -0
  254. package/dist/page/RouteError.js +35 -0
  255. package/dist/page/RouteError.js.map +1 -0
  256. package/dist/page/RouteLoading.d.ts +16 -0
  257. package/dist/page/RouteLoading.d.ts.map +1 -0
  258. package/dist/page/RouteLoading.js +17 -0
  259. package/dist/page/RouteLoading.js.map +1 -0
  260. package/dist/page/SectionHeader.d.ts.map +1 -1
  261. package/dist/page/SectionHeader.js +3 -1
  262. package/dist/page/SectionHeader.js.map +1 -1
  263. package/dist/page/index.d.ts +6 -0
  264. package/dist/page/index.d.ts.map +1 -1
  265. package/dist/page/index.js +5 -0
  266. package/dist/page/index.js.map +1 -1
  267. package/dist/primitives/alert.d.ts +1 -1
  268. package/dist/primitives/badge.d.ts +1 -1
  269. package/dist/primitives/confirmDialogView.d.ts +1 -0
  270. package/dist/primitives/confirmDialogView.d.ts.map +1 -1
  271. package/dist/primitives/confirmDialogView.js +3 -1
  272. package/dist/primitives/confirmDialogView.js.map +1 -1
  273. package/dist/primitives/descriptionContent.d.ts +8 -0
  274. package/dist/primitives/descriptionContent.d.ts.map +1 -0
  275. package/dist/primitives/descriptionContent.js +7 -0
  276. package/dist/primitives/descriptionContent.js.map +1 -0
  277. package/dist/primitives/index.d.ts +1 -0
  278. package/dist/primitives/index.d.ts.map +1 -1
  279. package/dist/primitives/index.js +1 -0
  280. package/dist/primitives/index.js.map +1 -1
  281. package/dist/primitives/pathname.d.ts +22 -0
  282. package/dist/primitives/pathname.d.ts.map +1 -0
  283. package/dist/primitives/pathname.js +23 -0
  284. package/dist/primitives/pathname.js.map +1 -0
  285. package/dist/primitives/segmented-control.d.ts +37 -3
  286. package/dist/primitives/segmented-control.d.ts.map +1 -1
  287. package/dist/primitives/segmented-control.js +45 -10
  288. package/dist/primitives/segmented-control.js.map +1 -1
  289. package/dist/provider/AdminUiProvider.d.ts +2 -2
  290. package/dist/provider/AdminUiProvider.d.ts.map +1 -1
  291. package/dist/provider/AdminUiProvider.js +14 -3
  292. package/dist/provider/AdminUiProvider.js.map +1 -1
  293. package/dist/provider/index.d.ts +1 -1
  294. package/dist/provider/index.d.ts.map +1 -1
  295. package/dist/provider/types.d.ts +19 -0
  296. package/dist/provider/types.d.ts.map +1 -1
  297. package/dist/scripts/check-contrast.mjs +353 -0
  298. package/dist/shell/AccountMenu.d.ts +51 -0
  299. package/dist/shell/AccountMenu.d.ts.map +1 -0
  300. package/dist/shell/AccountMenu.js +34 -0
  301. package/dist/shell/AccountMenu.js.map +1 -0
  302. package/dist/shell/AppShell.d.ts +68 -0
  303. package/dist/shell/AppShell.d.ts.map +1 -0
  304. package/dist/shell/AppShell.js +56 -0
  305. package/dist/shell/AppShell.js.map +1 -0
  306. package/dist/shell/LanguageMenu.d.ts +36 -0
  307. package/dist/shell/LanguageMenu.d.ts.map +1 -0
  308. package/dist/shell/LanguageMenu.js +33 -0
  309. package/dist/shell/LanguageMenu.js.map +1 -0
  310. package/dist/shell/NavItemMarks.d.ts +21 -0
  311. package/dist/shell/NavItemMarks.d.ts.map +1 -0
  312. package/dist/shell/NavItemMarks.js +30 -0
  313. package/dist/shell/NavItemMarks.js.map +1 -0
  314. package/dist/shell/ShellBreadcrumbs.d.ts +26 -0
  315. package/dist/shell/ShellBreadcrumbs.d.ts.map +1 -0
  316. package/dist/shell/ShellBreadcrumbs.js +78 -0
  317. package/dist/shell/ShellBreadcrumbs.js.map +1 -0
  318. package/dist/shell/ShellDocumentTitle.d.ts +27 -0
  319. package/dist/shell/ShellDocumentTitle.d.ts.map +1 -0
  320. package/dist/shell/ShellDocumentTitle.js +50 -0
  321. package/dist/shell/ShellDocumentTitle.js.map +1 -0
  322. package/dist/shell/ShellMobileMenu.d.ts +33 -0
  323. package/dist/shell/ShellMobileMenu.d.ts.map +1 -0
  324. package/dist/shell/ShellMobileMenu.js +33 -0
  325. package/dist/shell/ShellMobileMenu.js.map +1 -0
  326. package/dist/shell/ShellNavLink.d.ts +18 -0
  327. package/dist/shell/ShellNavLink.d.ts.map +1 -0
  328. package/dist/shell/ShellNavLink.js +16 -0
  329. package/dist/shell/ShellNavLink.js.map +1 -0
  330. package/dist/shell/ShellNavList.d.ts +18 -0
  331. package/dist/shell/ShellNavList.d.ts.map +1 -0
  332. package/dist/shell/ShellNavList.js +45 -0
  333. package/dist/shell/ShellNavList.js.map +1 -0
  334. package/dist/shell/ShellNavRail.d.ts +11 -0
  335. package/dist/shell/ShellNavRail.d.ts.map +1 -0
  336. package/dist/shell/ShellNavRail.js +97 -0
  337. package/dist/shell/ShellNavRail.js.map +1 -0
  338. package/dist/shell/ShellSidebar.d.ts +32 -0
  339. package/dist/shell/ShellSidebar.d.ts.map +1 -0
  340. package/dist/shell/ShellSidebar.js +29 -0
  341. package/dist/shell/ShellSidebar.js.map +1 -0
  342. package/dist/shell/ShellTopBar.d.ts +23 -0
  343. package/dist/shell/ShellTopBar.d.ts.map +1 -0
  344. package/dist/shell/ShellTopBar.js +25 -0
  345. package/dist/shell/ShellTopBar.js.map +1 -0
  346. package/dist/shell/index.d.ts +28 -0
  347. package/dist/shell/index.d.ts.map +1 -0
  348. package/dist/shell/index.js +19 -0
  349. package/dist/shell/index.js.map +1 -0
  350. package/dist/shell/navClasses.d.ts +12 -0
  351. package/dist/shell/navClasses.d.ts.map +1 -0
  352. package/dist/shell/navClasses.js +14 -0
  353. package/dist/shell/navClasses.js.map +1 -0
  354. package/dist/shell/shellContext.d.ts +30 -0
  355. package/dist/shell/shellContext.d.ts.map +1 -0
  356. package/dist/shell/shellContext.js +7 -0
  357. package/dist/shell/shellContext.js.map +1 -0
  358. package/dist/shell/useShellShortcut.d.ts +12 -0
  359. package/dist/shell/useShellShortcut.d.ts.map +1 -0
  360. package/dist/shell/useShellShortcut.js +42 -0
  361. package/dist/shell/useShellShortcut.js.map +1 -0
  362. package/dist/shell/useSidebarCollapsed.d.ts +10 -0
  363. package/dist/shell/useSidebarCollapsed.d.ts.map +1 -0
  364. package/dist/shell/useSidebarCollapsed.js +49 -0
  365. package/dist/shell/useSidebarCollapsed.js.map +1 -0
  366. package/dist/shell-background/ShaderBackground.d.ts +27 -0
  367. package/dist/shell-background/ShaderBackground.d.ts.map +1 -0
  368. package/dist/shell-background/ShaderBackground.js +92 -0
  369. package/dist/shell-background/ShaderBackground.js.map +1 -0
  370. package/dist/shell-background/ShaderCanvas.d.ts +16 -0
  371. package/dist/shell-background/ShaderCanvas.d.ts.map +1 -0
  372. package/dist/shell-background/ShaderCanvas.js +197 -0
  373. package/dist/shell-background/ShaderCanvas.js.map +1 -0
  374. package/dist/shell-background/index.d.ts +5 -0
  375. package/dist/shell-background/index.d.ts.map +1 -0
  376. package/dist/shell-background/index.js +5 -0
  377. package/dist/shell-background/index.js.map +1 -0
  378. package/dist/shell-background/shader.d.ts +81 -0
  379. package/dist/shell-background/shader.d.ts.map +1 -0
  380. package/dist/shell-background/shader.js +194 -0
  381. package/dist/shell-background/shader.js.map +1 -0
  382. package/dist/showcase/Showcase.d.ts +12 -2
  383. package/dist/showcase/Showcase.d.ts.map +1 -1
  384. package/dist/showcase/Showcase.js +24 -6
  385. package/dist/showcase/Showcase.js.map +1 -1
  386. package/dist/showcase/coverage.d.ts.map +1 -1
  387. package/dist/showcase/coverage.js +55 -4
  388. package/dist/showcase/coverage.js.map +1 -1
  389. package/dist/showcase/fixtures.d.ts +9 -0
  390. package/dist/showcase/fixtures.d.ts.map +1 -0
  391. package/dist/showcase/fixtures.js +268 -0
  392. package/dist/showcase/fixtures.js.map +1 -0
  393. package/dist/showcase/index.d.ts +2 -0
  394. package/dist/showcase/index.d.ts.map +1 -1
  395. package/dist/showcase/index.js +1 -0
  396. package/dist/showcase/index.js.map +1 -1
  397. package/dist/showcase/sections/DataShowcase.d.ts +3 -0
  398. package/dist/showcase/sections/DataShowcase.d.ts.map +1 -0
  399. package/dist/showcase/sections/DataShowcase.js +15 -0
  400. package/dist/showcase/sections/DataShowcase.js.map +1 -0
  401. package/dist/showcase/sections/FormAdditionsShowcase.d.ts +3 -0
  402. package/dist/showcase/sections/FormAdditionsShowcase.d.ts.map +1 -0
  403. package/dist/showcase/sections/FormAdditionsShowcase.js +15 -0
  404. package/dist/showcase/sections/FormAdditionsShowcase.js.map +1 -0
  405. package/dist/showcase/sections/FormShowcase.d.ts.map +1 -1
  406. package/dist/showcase/sections/FormShowcase.js +2 -1
  407. package/dist/showcase/sections/FormShowcase.js.map +1 -1
  408. package/dist/showcase/sections/ListAdditionsShowcase.d.ts +3 -0
  409. package/dist/showcase/sections/ListAdditionsShowcase.d.ts.map +1 -0
  410. package/dist/showcase/sections/ListAdditionsShowcase.js +61 -0
  411. package/dist/showcase/sections/ListAdditionsShowcase.js.map +1 -0
  412. package/dist/showcase/sections/ListShowcase.d.ts.map +1 -1
  413. package/dist/showcase/sections/ListShowcase.js +2 -1
  414. package/dist/showcase/sections/ListShowcase.js.map +1 -1
  415. package/dist/showcase/sections/MarkdownShowcase.d.ts +21 -0
  416. package/dist/showcase/sections/MarkdownShowcase.d.ts.map +1 -0
  417. package/dist/showcase/sections/MarkdownShowcase.js +28 -0
  418. package/dist/showcase/sections/MarkdownShowcase.js.map +1 -0
  419. package/dist/showcase/sections/MediaCropShowcase.d.ts +3 -0
  420. package/dist/showcase/sections/MediaCropShowcase.d.ts.map +1 -0
  421. package/dist/showcase/sections/MediaCropShowcase.js +56 -0
  422. package/dist/showcase/sections/MediaCropShowcase.js.map +1 -0
  423. package/dist/showcase/sections/MediaShowcase.d.ts.map +1 -1
  424. package/dist/showcase/sections/MediaShowcase.js +2 -1
  425. package/dist/showcase/sections/MediaShowcase.js.map +1 -1
  426. package/dist/showcase/sections/PageAdditionsShowcase.d.ts +3 -0
  427. package/dist/showcase/sections/PageAdditionsShowcase.d.ts.map +1 -0
  428. package/dist/showcase/sections/PageAdditionsShowcase.js +7 -0
  429. package/dist/showcase/sections/PageAdditionsShowcase.js.map +1 -0
  430. package/dist/showcase/sections/PageShowcase.d.ts.map +1 -1
  431. package/dist/showcase/sections/PageShowcase.js +4 -3
  432. package/dist/showcase/sections/PageShowcase.js.map +1 -1
  433. package/dist/showcase/sections/PrimitivesAdditionsShowcase.d.ts +3 -0
  434. package/dist/showcase/sections/PrimitivesAdditionsShowcase.d.ts.map +1 -0
  435. package/dist/showcase/sections/PrimitivesAdditionsShowcase.js +20 -0
  436. package/dist/showcase/sections/PrimitivesAdditionsShowcase.js.map +1 -0
  437. package/dist/showcase/sections/PrimitivesShowcase.d.ts.map +1 -1
  438. package/dist/showcase/sections/PrimitivesShowcase.js +3 -2
  439. package/dist/showcase/sections/PrimitivesShowcase.js.map +1 -1
  440. package/dist/showcase/sections/ShellShowcase.d.ts +3 -0
  441. package/dist/showcase/sections/ShellShowcase.d.ts.map +1 -0
  442. package/dist/showcase/sections/ShellShowcase.js +71 -0
  443. package/dist/showcase/sections/ShellShowcase.js.map +1 -0
  444. package/dist/showcase/sections/TranslationsShowcase.d.ts +2 -0
  445. package/dist/showcase/sections/TranslationsShowcase.d.ts.map +1 -1
  446. package/dist/showcase/sections/TranslationsShowcase.js +5 -1
  447. package/dist/showcase/sections/TranslationsShowcase.js.map +1 -1
  448. package/dist/showcase/sections/WorkersShowcase.d.ts +3 -0
  449. package/dist/showcase/sections/WorkersShowcase.d.ts.map +1 -0
  450. package/dist/showcase/sections/WorkersShowcase.js +15 -0
  451. package/dist/showcase/sections/WorkersShowcase.js.map +1 -0
  452. package/dist/tokens.json +276 -5
  453. package/dist/translations/AppTranslationKeyDrawer.d.ts +14 -0
  454. package/dist/translations/AppTranslationKeyDrawer.d.ts.map +1 -0
  455. package/dist/translations/AppTranslationKeyDrawer.js +197 -0
  456. package/dist/translations/AppTranslationKeyDrawer.js.map +1 -0
  457. package/dist/translations/AppTranslationsScreen.d.ts +25 -0
  458. package/dist/translations/AppTranslationsScreen.d.ts.map +1 -0
  459. package/dist/translations/AppTranslationsScreen.js +139 -0
  460. package/dist/translations/AppTranslationsScreen.js.map +1 -0
  461. package/dist/translations/ConfigImportCards.d.ts +26 -0
  462. package/dist/translations/ConfigImportCards.d.ts.map +1 -0
  463. package/dist/translations/ConfigImportCards.js +59 -0
  464. package/dist/translations/ConfigImportCards.js.map +1 -0
  465. package/dist/translations/LanguagesScreen.d.ts +20 -0
  466. package/dist/translations/LanguagesScreen.d.ts.map +1 -0
  467. package/dist/translations/LanguagesScreen.js +110 -0
  468. package/dist/translations/LanguagesScreen.js.map +1 -0
  469. package/dist/translations/LocalesScreen.d.ts +22 -0
  470. package/dist/translations/LocalesScreen.d.ts.map +1 -0
  471. package/dist/translations/LocalesScreen.js +92 -0
  472. package/dist/translations/LocalesScreen.js.map +1 -0
  473. package/dist/translations/TranslatableField.d.ts +13 -2
  474. package/dist/translations/TranslatableField.d.ts.map +1 -1
  475. package/dist/translations/TranslatableField.js +23 -5
  476. package/dist/translations/TranslatableField.js.map +1 -1
  477. package/dist/translations/TranslatableInput.d.ts.map +1 -1
  478. package/dist/translations/TranslatableInput.js +4 -1
  479. package/dist/translations/TranslatableInput.js.map +1 -1
  480. package/dist/translations/TranslatableMarkdown.d.ts +2 -0
  481. package/dist/translations/TranslatableMarkdown.d.ts.map +1 -1
  482. package/dist/translations/TranslatableMarkdown.js +12 -7
  483. package/dist/translations/TranslatableMarkdown.js.map +1 -1
  484. package/dist/translations/TranslationCompleteness.d.ts +11 -0
  485. package/dist/translations/TranslationCompleteness.d.ts.map +1 -0
  486. package/dist/translations/TranslationCompleteness.js +73 -0
  487. package/dist/translations/TranslationCompleteness.js.map +1 -0
  488. package/dist/translations/adminFormat.d.ts +27 -0
  489. package/dist/translations/adminFormat.d.ts.map +1 -0
  490. package/dist/translations/adminFormat.js +39 -0
  491. package/dist/translations/adminFormat.js.map +1 -0
  492. package/dist/translations/adminTypes.d.ts +136 -0
  493. package/dist/translations/adminTypes.d.ts.map +1 -0
  494. package/dist/translations/adminTypes.js +9 -0
  495. package/dist/translations/adminTypes.js.map +1 -0
  496. package/dist/translations/api.d.ts +225 -0
  497. package/dist/translations/api.d.ts.map +1 -0
  498. package/dist/translations/api.js +132 -0
  499. package/dist/translations/api.js.map +1 -0
  500. package/dist/translations/focusOverLimit.d.ts +7 -0
  501. package/dist/translations/focusOverLimit.d.ts.map +1 -0
  502. package/dist/translations/focusOverLimit.js +23 -0
  503. package/dist/translations/focusOverLimit.js.map +1 -0
  504. package/dist/translations/index.d.ts +22 -0
  505. package/dist/translations/index.d.ts.map +1 -1
  506. package/dist/translations/index.js +13 -0
  507. package/dist/translations/index.js.map +1 -1
  508. package/dist/translations/useContentLocales.d.ts +17 -0
  509. package/dist/translations/useContentLocales.d.ts.map +1 -0
  510. package/dist/translations/useContentLocales.js +33 -0
  511. package/dist/translations/useContentLocales.js.map +1 -0
  512. package/dist/translations/useEntityTranslator.d.ts +34 -0
  513. package/dist/translations/useEntityTranslator.d.ts.map +1 -0
  514. package/dist/translations/useEntityTranslator.js +49 -0
  515. package/dist/translations/useEntityTranslator.js.map +1 -0
  516. package/dist/workers/WorkerRestartButton.d.ts +19 -0
  517. package/dist/workers/WorkerRestartButton.d.ts.map +1 -0
  518. package/dist/workers/WorkerRestartButton.js +59 -0
  519. package/dist/workers/WorkerRestartButton.js.map +1 -0
  520. package/dist/workers/WorkerTransportScreen.d.ts +24 -0
  521. package/dist/workers/WorkerTransportScreen.d.ts.map +1 -0
  522. package/dist/workers/WorkerTransportScreen.js +121 -0
  523. package/dist/workers/WorkerTransportScreen.js.map +1 -0
  524. package/dist/workers/WorkersOverviewScreen.d.ts +30 -0
  525. package/dist/workers/WorkersOverviewScreen.d.ts.map +1 -0
  526. package/dist/workers/WorkersOverviewScreen.js +61 -0
  527. package/dist/workers/WorkersOverviewScreen.js.map +1 -0
  528. package/dist/workers/api.d.ts +113 -0
  529. package/dist/workers/api.d.ts.map +1 -0
  530. package/dist/workers/api.js +73 -0
  531. package/dist/workers/api.js.map +1 -0
  532. package/dist/workers/charts.d.ts +94 -0
  533. package/dist/workers/charts.d.ts.map +1 -0
  534. package/dist/workers/charts.js +238 -0
  535. package/dist/workers/charts.js.map +1 -0
  536. package/dist/workers/format.d.ts +96 -0
  537. package/dist/workers/format.d.ts.map +1 -0
  538. package/dist/workers/format.js +231 -0
  539. package/dist/workers/format.js.map +1 -0
  540. package/dist/workers/history.d.ts +20 -0
  541. package/dist/workers/history.d.ts.map +1 -0
  542. package/dist/workers/history.js +84 -0
  543. package/dist/workers/history.js.map +1 -0
  544. package/dist/workers/index.d.ts +24 -0
  545. package/dist/workers/index.d.ts.map +1 -0
  546. package/dist/workers/index.js +19 -0
  547. package/dist/workers/index.js.map +1 -0
  548. package/dist/workers/overview.d.ts +72 -0
  549. package/dist/workers/overview.d.ts.map +1 -0
  550. package/dist/workers/overview.js +323 -0
  551. package/dist/workers/overview.js.map +1 -0
  552. package/dist/workers/status.d.ts +11 -0
  553. package/dist/workers/status.d.ts.map +1 -0
  554. package/dist/workers/status.js +106 -0
  555. package/dist/workers/status.js.map +1 -0
  556. package/dist/workers/transport.d.ts +78 -0
  557. package/dist/workers/transport.d.ts.map +1 -0
  558. package/dist/workers/transport.js +407 -0
  559. package/dist/workers/transport.js.map +1 -0
  560. package/dist/workers/types.d.ts +234 -0
  561. package/dist/workers/types.d.ts.map +1 -0
  562. package/dist/workers/types.js +8 -0
  563. package/dist/workers/types.js.map +1 -0
  564. package/dist/workers/useWorkersWindow.d.ts +12 -0
  565. package/dist/workers/useWorkersWindow.d.ts.map +1 -0
  566. package/dist/workers/useWorkersWindow.js +38 -0
  567. package/dist/workers/useWorkersWindow.js.map +1 -0
  568. package/dist/workers/window.d.ts +30 -0
  569. package/dist/workers/window.d.ts.map +1 -0
  570. package/dist/workers/window.js +39 -0
  571. package/dist/workers/window.js.map +1 -0
  572. package/package.json +39 -4
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  name: ddd-admin-ui-specialist
3
- description: "Build admin screens with @mgamadeus/ddd-admin-ui and extend the package. Covers entries, import matrix, host setup (AdminUiProvider above every page, theme.css, components.css, tokens.json with ddd-admin-ui-check-tokens, one Radix copy with ddd-admin-ui-check-radix), list pages with URL filters, bulk actions, wide tables (tracks, pins, sort), the segmented control, the showcase, detail shells, form drawers and dialogs (FormDialog), the save shortcut, FormActions in a header slot, useConfirm with typed phrases, write access (WriteAccessProvider), server errors, the unsaved-changes guard, locale::style translations, media fields, layers, i18n-keys.json, server vs client files, adding a block. Use when building or reviewing a list, detail, form or dialog screen, a page fails with Tooltip must be used within TooltipProvider, Cmd+S submits the wrong form or none, a confirm answers false, write controls must go off for read-only users, a table squeezes, an overlay misbehaves, or URL filters get lost."
3
+ description: "Build admin screens with @mgamadeus/ddd-admin-ui and extend it: entries and import matrix, host setup (AdminUiProvider, theme.css, components.css, tokens.json, ddd-admin-ui-check-tokens, -check-radix, -check-contrast), the app shell (./shell: sidebar, rail, mobile menu, breadcrumbs, title from one navigation; ./shell-background), list pages with URL filters, date presets, column factories, bulk menus, wide tables, detail shells, route error and loading, form drawers and dialogs, the save shortcut, useConfirm, write access, locale::style translations with limits, media fields with image crop, colour fields, key figures (./data), markdown (./markdown), the workers and translation admin screens (./workers, ./translations), ./design-studio, i18n-keys.json, new blocks. Use when building a frame, list, detail, form or admin screen, Tooltip must be used within TooltipProvider, Cmd+S submits the wrong form, a confirm answers false, breadcrumbs miss a page, contrast fails, or URL filters get lost."
4
4
  metadata:
5
5
  author: mgamadeus
6
- version: 0.1.0
6
+ version: 0.2.1
7
7
  ---
8
8
 
9
9
  # ddd-admin-ui specialist
@@ -27,6 +27,10 @@ installed package (`node_modules/@mgamadeus/ddd-admin-ui/`). This skill reaches
27
27
  | a picker over a server search, with clear / create | `Combobox` `onSearch` + `useLatestSearch`, `clearable`, `onRequestCreate` | list, logic |
28
28
  | copy a value next to it | `CopyButton` | list |
29
29
  | one router link for every block, sticky search parameters | `AdminUiProvider.linkComponent` + `withStickyParams` | provider, logic |
30
+ | the application frame: sidebar (groups, badges, locks), icon rail with `[`, mobile menu, top bar slots | `AppShell` with one `NavigationItem[]` tree, `canAccess`, `AdminUiProvider usePathname={useNextPathname}` | shell, logic, next |
31
+ | breadcrumbs and the tab title from the same tree | leaf `crumbs` (`'create'`, `':itemId'` + `entity`), `useEntityLabel`, `documentTitle={{ appName }}`; `resolveDocumentTitle` on the server | shell, logic |
32
+ | account and language menus fed by the host | `AccountMenu` (entries, `LanguageMenuSub` inside), `LanguageMenu` | shell |
33
+ | an animated background | `background={<ShaderBackground />}` (separate, lazy) | shell-background |
30
34
  | a `type="date"` / `datetime-local` value | `toDateInputValue` / `fromDateTimeInputValue` … with `'local'` or `'utc'` | logic |
31
35
  | see every block in the host theme, light and dark | `Showcase` on a development route | showcase |
32
36
  | a view that loads its own data (a tree) in the list card | `EntityListBody.renderOwnView` | list |
@@ -41,6 +45,23 @@ installed package (`node_modules/@mgamadeus/ddd-admin-ui/`). This skill reaches
41
45
  | a confirmation inside a block with its own dialog | `useConfirmDialog` (returns `{ confirm, dialog }`) | form |
42
46
  | write controls off for a read-only user | `WriteAccessProvider value={{ allowed, reason }}`, `useWriteAccess()`, `ignoreWriteAccess` on reading controls | logic |
43
47
  | a toast | `notify.success / info / error / loading / submitError` | logic |
48
+ | a date filter with presets (today, last 7 / 30 days, custom) | `FilterDateRange presets` (+ `onRangeChange`) | list |
49
+ | columns without boilerplate (id, text, number, money, date, status, actions) | `idColumn`, `textColumn`, `moneyColumn` (currency required), `actionsColumn` (`width: 'content'`, pinned end) | list |
50
+ | bulk action with sub-choices, a counted confirmation, a hint | `EntityListBulkAction` `choices` / `onChoose`, `confirm`, `hint`; `moreOnServer` | list |
51
+ | a bulk run that skips rows on purpose | `skipSequential(reason)` + `runSequentialWithSummary` (`skipReasons`), `bulkSummaryText` | logic |
52
+ | filter toggle / count / clear outside the toolbar | `FilterToggleButton`, `FilterCountBadge`, `ClearFiltersButton` | list |
53
+ | table only from `lg` (many columns) or at every width | `EntityListBody tableBreakpoint` + the same on `EntityListViewToggle` | list |
54
+ | a master-detail drawer beside the page | `FormDrawer modal={false}` (`nonModalFrom`) | form |
55
+ | one tab per language, length limits on translatable texts | `useEntityTranslations({ tabModel: 'language' })`, `maxLength` / `AdminUiProvider textLimits`, `focusFirstOverLimitTranslation` | logic, translations |
56
+ | a markdown field or sanitised markdown text | `renderMarkdownEditor` / `MarkdownEditor`, `MarkdownPreview` (peers `@uiw/react-md-editor`, `rehype-sanitize`; loaded after hydration) | markdown |
57
+ | key figures with a change, a sparkline slot, footnotes | `MetricGrid` + `MetricTile` + `DeltaText` (`preference`, `format`), `NoteList` | data |
58
+ | a crashed or loading route (`error.tsx`, `loading.tsx`) | `RouteError` (`onRetry`, `onReport`), `RouteLoading` | page |
59
+ | crop or normalise a picked image | `ImageCropDialog` (`aspectOptions`, `allowSkip`, `output`) + `normalizeImage` | media, logic |
60
+ | a colour value | `ColorValueField` with an explicit `format` (`hex` / `hex-alpha`) | form |
61
+ | the workers monitoring (overview, transport, runs, processes, restart) | `createWorkersApi({ baseApi, apiPrefix })` + `WorkersOverviewScreen` / `WorkerTransportScreen` | workers |
62
+ | app translations, languages, locales, import from configuration | `createTranslationsApi({ baseApi, apiPrefix })` + `AppTranslationsScreen` / `LanguagesScreen` / `LocalesScreen` / `ConfigImportCard` | translations |
63
+ | AI translation of an entity form, content locales from the active locales | `useEntityTranslator(api)` + `useTranslationRunner`, `useContentLocales(api)` | translations, logic |
64
+ | a maintenance action (run, pending, last outcome) | `MaintenanceActionCard` | page |
44
65
 
45
66
  ## Rules that fail silently
46
67
 
@@ -58,6 +79,9 @@ installed package (`node_modules/@mgamadeus/ddd-admin-ui/`). This skill reaches
58
79
  on `:root`; `PortalContainerProvider` / the provider's `portalContainer` moves every portal.
59
80
  - **Import boundary.** Blocks import only the entries the matrix in `README.md` allows, never app code. Only `./next`
60
81
  imports `next/*`, only `./notify-sonner` imports `sonner`; `./logic` pure files run without React.
82
+ - **Design studio.** Pass `designStudioComponents` from `./design-studio` as the studio provider's `components`; replace
83
+ single slots by spreading it. The entry never imports the studio (`DesignStudioComponentsContract` is a structural
84
+ copy); a new studio slot means updating `contract.ts`, the map and the render test together.
61
85
  - **Translation keys.** Keys are full `locale::style` (`de::FORMAL`, `de::INFORMAL`). Never collapse them to the
62
86
  language: the payload of `useEntityTranslations` sends every loaded key back; a cleared text removes its key.
63
87
  - **URL state.** Build requests from `list.debounced`, never `list.values`. All writes (filters, view, drawer) go
@@ -74,6 +98,12 @@ installed package (`node_modules/@mgamadeus/ddd-admin-ui/`). This skill reaches
74
98
  terms); the block debounces and never shows the previous term's options. A picked value outside the results needs
75
99
  `selectedOption`.
76
100
  - **Links**: set `linkComponent` once on `AdminUiProvider`; without it blocks render plain `<a>` (full page loads).
101
+ - **One navigation tree.** Sidebar, mobile menu, breadcrumbs and tab title all read `AppShell.navigation`; a page below
102
+ an entry is described in that entry's `crumbs`, never in a second list. Without `usePathname` on the provider the
103
+ shell knows the path only after hydration (no current entry, no crumbs in the server HTML). `canAccess` hides
104
+ sidebar items only — crumbs of a hidden page stay as text. `useEntityLabel` and `canAccess` must be stable (a
105
+ module-level hook, a memoised predicate). The collapsed rail applies right after hydration, never on the server.
106
+ `ShaderBackground` needs the page background on `<html>` (a body background covers it).
77
107
  - **⌘S / Ctrl+S** (`FormActions`, `FormDialog`) listens on `document`: in a dialog or drawer it answers anywhere inside
78
108
  the innermost one holding the focus; on a page with focus in the form, on its actions (also portalled) or nowhere.
79
109
  It prevents the default whenever it is in scope (also with a disabled primary, then nothing submits); an event
@@ -91,6 +121,18 @@ installed package (`node_modules/@mgamadeus/ddd-admin-ui/`). This skill reaches
91
121
  - **Text contexts are literals.** `m('Failed', { context: 'import-status' })`: extractors (the package manifest and
92
122
  host exports) read the text and the context as string literals; a context only on the status map or in a variable is
93
123
  not exported. Put the same context on the definition or the map so `StatusBadge` translates with it.
124
+ - **Translatable limits never cut**: `maxLength` counts code points, marks the tab and the field, keeps the text; the
125
+ submit refuses with `overLimitKeys` and shows the text with `focusFirstOverLimitTranslation(form)`. Tab model
126
+ `language` still sends every loaded `locale::style` key back.
127
+ - **`./markdown` loads its peers after hydration**: the server draws a skeleton; never import the editor library from
128
+ another entry, and never render user markdown with `dangerouslySetInnerHTML` (use `MarkdownPreview`).
129
+ - **Contrast**: run `ddd-admin-ui-check-contrast <built css> [--exceptions host.json]` in CI and after a palette
130
+ change; declared pairs below AA fail in both themes unless the package's or the host's exception list names them
131
+ (`{ foreground, background, theme?, reason }`).
132
+ - **SegmentedControl options of a host look**: `heightOf="option"` with a track padding class, `coarsePointer="grow"`,
133
+ `badgeStyle="unstyled"`, `translate={false}`, timings as `--segmented-control-*` variables on `style`; the indicator
134
+ follows the option box.
135
+ - **Layers**: the package's dialogs open at `--layer-overlay` (50); a host with a higher overlay scale raises it.
94
136
  - **Server vs client.** Hooks and context live in files with `'use client'`; pure helpers (`m`, `formatDateTime`,
95
137
  `defineStatusMap`, schemas, conditions) may be called in server code and `metadata`.
96
138
 
@@ -184,6 +226,18 @@ const tabs = useEntityTranslations({ fields: ['name'], locales: ['en::FORMAL', '
184
226
 
185
227
  A server violation on `translations.name` shows with the field's label ("Display name: …").
186
228
 
229
+ ### Framework screens on the host's api
230
+
231
+ ```ts
232
+ export const workersApi = createWorkersApi({ baseApi: adminApi, apiPrefix: '/api/admin/maintenance/workers' });
233
+ export const translationsApi = createTranslationsApi({ baseApi: adminApi, apiPrefix: '/api/admin/common', paths: { appTranslations: 'app-translations' } });
234
+ ```
235
+
236
+ Call them once at module scope with the host's RTK Query api (the React hooks module); screens take the result as
237
+ `api`, links come from the provider's `linkComponent`, writes follow `WriteAccessProvider`, URL state needs the host's
238
+ adapters (`urlStateAdapter`, `drawerUrlAdapter`). Workers need mgamadeus/ddd ≥ 3.23.1; the translation routes are the
239
+ application's controllers (paths in `README.md`). For reviews and tests: `createStaticWorkersApi(showcaseWorkersData)`.
240
+
187
241
  ## Adding a block to the package
188
242
 
189
243
  Work in the package repository (`src/<entry>/`).
package/CHANGELOG.md CHANGED
@@ -1,7 +1,249 @@
1
1
  # Changelog
2
2
 
3
3
  All notable changes to `@mgamadeus/ddd-admin-ui`. 0.x: each minor may break; pin the exact version while the package
4
- is in 0.x prereleases.
4
+ is in 0.x.
5
+
6
+ ## 0.2.1
7
+
8
+ The showcase no longer widens the page at phone width; 0.2.0 was tagged but not published, so 0.2.1 is the first
9
+ release of the 0.2.0 content.
10
+
11
+ - `SegmentedControl`: a track that turns wider than its container scrolls inside itself from the same frame on
12
+ (`data-overflowing`, set by the resize observer before the paint). Before, the scrolling waited for React's next
13
+ render, and until then the options spilled out of the track: after a resize to phone width on a slow device the page
14
+ scrolled sideways.
15
+ - Showcase: every sample row and every section scrolls a wider specimen inside itself (`min-w-0 overflow-x-auto`), never
16
+ the page; the samples carry `data-showcase-sample`, the section contents `data-showcase-section-content`.
17
+ - Consumer check: when the showcase widens the page at 390 px, the check prints the widest elements past the viewport
18
+ with their section, sample, widths and the container they spill from.
19
+
20
+ ## 0.2.0
21
+
22
+ All additions below are optional props, new exports or new entries: a caller that uses none of them renders the same
23
+ DOM (the list snapshot of 0.1.0-rc.2 and the form actions snapshot of 0.1.0-rc.5 are unchanged).
24
+
25
+ New entries:
26
+
27
+ - `./data`: `MetricTile` (label, value, icon, delta, hint, sparkline slot, `isLoading` skeleton, `compact`),
28
+ `MetricTileSkeleton`, `MetricGrid`, `DeltaText` (signed change in the UI language; `preference` higher / lower /
29
+ none; `format` number / percent / explicit `Intl.NumberFormatOptions`; arrow, sign and a hidden word), `NoteList`, and
30
+ `resolveDelta`, `relativeChange`, `deltaDirectionOf`, `deltaToneOf`.
31
+ - `./markdown` (optional peers `@uiw/react-md-editor` ^4.1.0 and `rehype-sanitize` ^6.0.0, imported after hydration,
32
+ never from another entry): `MarkdownEditor`, `MarkdownPreview`, `renderMarkdownEditor(options)` for the
33
+ `renderEditor` slot and `AdminUiProvider.renderMarkdownEditor`, `MARKDOWN_ROW_HEIGHT`, `loadMarkdownLibrary`,
34
+ `useMarkdownLibrary`, `extendMarkdownSanitizeSchema`, `MARKDOWN_IMAGE_ATTRIBUTES`, `remarkLineBreaks`. The preview is
35
+ sanitised (raw HTML parsed, then GitHub's rules plus images; a single newline is a line break); the editor follows the
36
+ nearest `.dark` ancestor; the server draws a skeleton; a failed load falls back to a plain text area.
37
+ - `./workers`: the screens of Core's worker monitoring (`WorkersControllerTrait`, mgamadeus/ddd 3.23.1 or
38
+ later). `createWorkersApi({ baseApi, apiPrefix })` injects the six operations into the host's RTK Query api (tag
39
+ `AdminUiWorkers`; the restart request invalidates the live reads) and returns the hooks. `WorkersOverviewScreen`:
40
+ totals as tiles with sparklines, the monitoring-off and sampler banners, the live row per transport with its
41
+ processes, the throughput table per window, the history of every transport over a window switch (1 h – 14 d), the
42
+ transports table by state severity, the loops, the restart of all workers (confirmed). `WorkerTransportScreen`:
43
+ facts, five charts (queue, workers with the configured range, throughput, duration and wait with a logarithmic axis
44
+ when the maximum dwarfs the average), message classes, live processes, and the tabs Message runs and Processes (with
45
+ a lifetime timeline). Their parts are exported, with the status maps `WORKER_TRANSPORT_STATE`,
46
+ `WORKER_PROCESS_STATE`, `WORKER_MESSAGE_OUTCOME` and the payload types. Charts are SVG drawn by the entry (no chart
47
+ library, no optional peer); a step without a reading is a gap, never a 0.
48
+ - `./shell`: the application frame and its navigation, mechanism in the package, content from the host.
49
+ - `AppShell` (type `AppShellProps`): fixed top bar (`ShellTopBar`: banner, menu button, `brand`, `topBarStart`, the
50
+ breadcrumbs, `topBarEnd`; frosted once the page scrolls, `data-shell-scrolled`), fixed sidebar from `lg`
51
+ (`ShellSidebar`: `<nav>` landmark, nested groups as disclosure buttons with one open group per level, the current
52
+ entry `aria-current="page"`, badges, lock marks, external marks; `sidebarHeader`, `sidebarRailHeader`,
53
+ `sidebarFooter`), the icon rail (`ShellNavRail`: groups as flyout menus, tooltips) toggled by the foot row and `[`
54
+ (`useShellShortcut`; not while typing, in a dialog or menu, or below `lg`), remembered in localStorage per
55
+ `collapsedStorageKey` (`useSidebarCollapsed`, applied right after hydration, followed across tabs), the mobile menu
56
+ below `lg` (`ShellMenuButton`, `ShellMobileMenu`: a sheet from the inline-start edge, closes on a followed link or
57
+ a route change), the content frame (`<main>` behind a "Skip to content" link), an optional `background` and
58
+ `documentTitle`.
59
+ - `ShellBreadcrumbs`: the crumbs of the current path from the same navigation; entity names through the host's
60
+ `useEntityLabel` hook (types `UseEntityLabel`, `EntityLabelRequest`, `EntityLabelResult`); the middle folds into an
61
+ ellipsis menu with the full path on narrow trails (container queries).
62
+ - `ShellDocumentTitle`: keeps `document.title` on the page's name (`Details · Blue widget · Admin`).
63
+ - `AccountMenu` (name, description, avatar or initials, entries as links or actions, `children`, a `fallback`
64
+ without a session), `AccountAvatar`, `AccountSummary`; `LanguageMenu` (languages with native names in their own
65
+ `lang`, the current one checked, `onChange`, `isPending`, `note`), `LanguageMenuItems`, `LanguageMenuSub`.
66
+ - `ShellNavigationProvider` / `ShellNavigationContext` / `useShellNavigation`: breadcrumbs and title without the
67
+ frame. Logical sides throughout (RTL with Radix's `Direction.Provider`).
68
+ - `./shell-background`: `ShaderBackground`, an animated WebGL background (two soft blobs over the base
69
+ colour, generated displacement, a quarter resolution at 20 fps, held when hidden or idle), loaded lazily; nothing
70
+ without WebGL or with reduced motion. Colours from `--shell-background-base`, `--shell-background-blob-1`,
71
+ `--shell-background-blob-2` (falling back to `--background`, `--brand-light`, `--accent`); `tint`,
72
+ `tintShaderPalette`.
73
+ - `./design-studio`: `designStudioComponents`, the `components` of `@mgamadeus/ddd-design-studio`'s provider
74
+ (studio 0.7.x), every slot mapped to the block of the same name; typed against `DesignStudioComponentsContract`, a
75
+ structural copy of the studio's slot types, so the entry neither imports the studio nor depends on it. Checks: a type
76
+ test (exactly the contract's slots), a server render of every slot (`test:render`), and the map assigned to the
77
+ published studio 0.7.3 type in a consumer.
78
+ - `ddd-admin-ui-check-contrast <css> [tokens.json]` (bin): WCAG 2.x contrast of the pairs `tokens.json` declares
79
+ (`contrast.pairs`, 4.5 for text, 3 for large text and UI parts; `role/NN` backgrounds), light and dark; fails on a pair
80
+ below its minimum that no exception list names, and on a value it cannot compute (unless `--allow-unevaluated`).
81
+ `--exceptions <file.json>` adds a host's written exceptions (same entry format) to the package's. The package lists
82
+ the five light status pairs (`success` on `card`; `success`, `warning`, `destructive`, `info` on their 15 % tints) as
83
+ exceptions: status colours used as text or on their tint, themed by the host, until an emphasis role exists. Gated in
84
+ the consumer runs (CI and release) on the fixture app's built CSS, whose dark `--primary` moved from `#3b82f6` to
85
+ `#3472d8` (white on it: 3.68:1 → 4.62:1).
86
+
87
+ Lists:
88
+
89
+ - `FilterDateRange presets` (`true` or the host's list; `preset` / `onPresetChange`, `onRangeChange`, `today`): all
90
+ time, today, last 7 days, last 30 days, custom on a `SegmentedControl`; a preset writes the same `YYYY-MM-DD` bounds as
91
+ typed dates, so "Clear filters" is "All time" again; the resolved range shows next to the label; custom reveals the two
92
+ fields without a second visible label. Pure helpers in `./logic`: `DEFAULT_DATE_RANGE_PRESETS`,
93
+ `resolveDateRangePreset`, `dateRangePresetOf`, `addCalendarDays`, `localToday`, `CUSTOM_DATE_RANGE_PRESET` (types
94
+ `DateRange`, `DateRangePreset`).
95
+ - Bulk runs with skipped rows: a run of `runSequential` / `runSequentialWithSummary` returns `skipSequential(reason?)`
96
+ for a row it leaves alone; the outcome gains `skipped`, the toast reads `Deleted 3 of 5 tracks · 2 skipped` (clauses
97
+ per reason through `skipReasons`). `bulkSummaryText`, `bulkOutcomeCounts`, `summarizeSkipReasons` for bulk endpoints
98
+ (types `BulkOutcomeCounts`, `SequentialSkip`, `SequentialSkipMark`).
99
+ - Column factories in `./list`: `textColumn`, `numberColumn`, `moneyColumn` (currency required), `dateColumn`,
100
+ `booleanColumn`, `imageColumn`, `idColumn`, `statusColumn`, `actionsColumn` (type `ColumnFactoryOptions`); each
101
+ returns an `EntityListColumn`, display id, sort key and filter are separate, formats explicit.
102
+ - `EntityListColumn.width: 'content'`: a track as wide as its widest cell (`max-content`, measured after hydration),
103
+ also among pinned columns (`actionsColumn` uses it with `pin: 'end'`). `isContentTrack`, `listTrackLayoutTemplate`
104
+ in `./logic`.
105
+ - `EntityListBody tableBreakpoint` and `EntityListViewToggle tableBreakpoint`: `md` (default), `lg`, `always` (type
106
+ `ListTableBreakpoint`).
107
+ - `EntityListBulkBar`: an action with `choices` opens a menu (`choicesLabel`, `onChoose`; `onClick` is optional now),
108
+ `confirm` asks through `useConfirm()` with the count filled in (`%count%`, ICU plurals), `hint` shows a tooltip (also
109
+ on a disabled action), `moreOnServer` notes that only the loaded rows are selected (types
110
+ `EntityListBulkActionChoice`, `EntityListBulkActionConfirm`).
111
+ - `FilterToggleButton`, `FilterCountBadge`, `ClearFiltersButton`: the toolbar's controls for a host's own filter row or
112
+ sheet (the toolbar renders them, same DOM).
113
+ - `Combobox translate` and `ComboboxOption.translate` (also the group heading), `QuickFilterPills translate` and
114
+ `QuickFilterOption.translate`: `false` for texts from the server.
115
+ - `DateCell locale` (default: the provider's `formatLocale`, else the UI language); `formatDate`, `formatDateTime`,
116
+ `formatRelativeTime`, `uiDateTimeFormat`, `uiRelativeTimeFormat` take an optional locale. `ImageCell bordered`,
117
+ `objectFit`, `imageClassName`.
118
+ - `EntityListEmpty clearSearchSize` (the built-in "Clear search" is `sm`, `xs` when compact).
119
+
120
+ Primitives:
121
+
122
+ - `SegmentedControl`: `heightOf: 'option'` (the option carries the height, the track adds its padding),
123
+ `coarsePointer: 'grow'` (44 px options and an 8 px gap on touch, `--segmented-control-coarse-option-height`,
124
+ `--segmented-control-coarse-gap`), `badgeStyle: 'unstyled'` (also per option; there a falsy badge renders nothing),
125
+ `translate: false` (the `aria-label` and the option texts as given), `style` on the root, `pressFeedback`
126
+ (`--segmented-control-held-scale`). The indicator takes the selected option's box, so a host track padding insets it
127
+ like the options. Optional variables, unset by default: `--segmented-control-easing`,
128
+ `--segmented-control-option-duration`, `--segmented-control-option-easing`, `--segmented-control-track-duration`,
129
+ `--segmented-control-track-easing`. Measured in headless Chromium against an earlier host control in seven call-site
130
+ shapes (fine and coarse pointer): track, indicator and option geometry, timings and widths equal.
131
+ - `./primitives`: `PathnameProvider`, `PathnameContext`, `useCurrentPathname`, `useBrowserPathname`, type
132
+ `UsePathname`. `AdminUiProvider.usePathname` sets the pathname hook of every block; `./next` ships
133
+ `useNextPathname`. Without it: `location.pathname` after hydration.
134
+
135
+ Pages, forms, media, translations:
136
+
137
+ - `RouteError` (`onRetry`, optional `onReport` with its own pending / sent / failed state, `title`, `description`,
138
+ `detail`, `variant`) and `RouteLoading` (`list`, `detail`, `form`; `rows`, `inset`) in `./page`.
139
+ - `./page`: `MaintenanceActionCard` — a maintenance action with its run button (write access applies), pending state
140
+ and the outcome of the last run.
141
+ - `ColorValueField` in `./form`: an explicit `format` (`hex`, `hex-alpha`), `letterCase`, presets, `clearable`; typed
142
+ text is normalised on blur and refused when it is not a colour of that format. `parseHexColor`, `formatHexColor`,
143
+ `normalizeColorValue` in `./logic` (types `ColorValueFormat`, `RgbaValue`).
144
+ - `FormDrawer modal={false}` (with `nonModalFrom`, `nonModalClassName`): beside the page from `md` up, no overlay, the
145
+ page stays clickable, a click outside never closes it; below that the modal drawer. `useMediaQuery`,
146
+ `BREAKPOINT_QUERIES` in `./logic`.
147
+ - `ImageCropDialog` in `./media` (types `ImageCropDialogProps`, `ImageCropResult`): one picked image, aspect choices
148
+ (free, ratio, round), move, resize, wheel and pinch zoom, arrows and +/− on the focused frame; Apply answers the
149
+ cropped and normalised blob, "Use original" the untouched file, Cancel `onCancel`; a corrupt file shows an error.
150
+ `normalizeImage`, `decodeImage`, `renderNormalizedImage`, `ImageNormalizeError` / `isImageNormalizeError` (`code`
151
+ `decode`, `too-large`, `encode`, `unsupported`) in `./logic`: EXIF orientation, crop, round clip, size limits without
152
+ upscaling, alpha kept, an optional `runInWorker` adapter with a main-thread fallback; the crop geometry
153
+ (`initialCrop`, `moveCrop`, `resizeCrop`, `zoomCrop`, `planImageNormalization`, …) too. Upload, validation and presets
154
+ stay with the host.
155
+ - Translatable inputs: `useEntityTranslations({ tabModel: 'language', styleOrder, initialLocale })`: one tab per
156
+ language, each editing one full key chosen deterministically and named on the tab when not FORMAL; the language's
157
+ other keys stay and go back in the payload (`mergeLanguageTabs`, `translationLanguageOf`, `TranslatableLocale.otherKeys`).
158
+ `maxLength` / `countText` on `TranslatableInput`, `TranslatableMarkdown` and their form-bound variants: a counter in
159
+ code points, the over-limit tab marked, `aria-invalid`, nothing cut; `AdminUiProvider textLimits` sets the defaults by
160
+ kind; `focusFirstOverLimitTranslation(container)` in `./translations`; `countCodePoints`, `overLimitKeys`,
161
+ `TextLimitsContext`, `useTextLimits` in `./logic`. `MarkdownEditorRenderArgs.invalid`.
162
+ - `./translations` gains the admin screens on the application's translation controllers (the entities of
163
+ mgamadeus/ddd-common-translations and -political): `createTranslationsApi({ baseApi, apiPrefix, paths? })` (tags
164
+ `AdminUiAppTranslations`, `AdminUiLanguages`, `AdminUiLocales`; a locale write refetches the locales and the
165
+ completeness), `AppTranslationsScreen` (keys with their values per `locale::style`, search and filters, bulk delete,
166
+ "Generate all missing"), `AppTranslationKeyDrawer` (key fields, one row per value, a new value),
167
+ `TranslationCompleteness` (per active locale and writing style, generation per locale and style), `LanguagesScreen`
168
+ (active and writing styles in place), `LocalesScreen` (`isActive` and the default flags in place), `ConfigImportCard`
169
+ / `useConfigImport` (import of the configured languages or locales), `useEntityTranslator` (one
170
+ `translateEntities` request per target locale, for `useTranslationRunner`) and `useContentLocales`.
171
+
172
+ Logic:
173
+
174
+ - `./logic`: the navigation model (types `NavigationItem`, `NavigationLeaf`, `NavigationGroup`, `NavigationIcon`,
175
+ `NavigationAccess`, `CrumbRoute`, `CrumbLabel`, `CrumbParams`, `ResolvedCrumb`, `ActiveNavigation`) and its pure
176
+ resolvers: `findActiveNavigation`, `isNavigationLeafActive`, `isNavigationGroupActive`, `filterNavigation` (the rights
177
+ predicate), `resolveCrumbs`, `resolveDocumentTitle`, `documentTitleParts`, `normalisePathname`.
178
+ - `./logic`: the api injection of the screen entries (`InjectableBaseApi`, `ApiQueryHook`, `ApiMutationHook`,
179
+ `injectEndpointsOnce`, `toQueryString`, `staticQueryHook`, `staticMutationHook`), `useMemoryUrlState` (search
180
+ parameters in component state for a screen without a router adapter) and `useOptimisticRowPatches` (in-place edits
181
+ of list rows with rollback).
182
+
183
+ Provider and contract:
184
+
185
+ - `AdminUiProvider formatLocale` and `textLimits`; `FormatLocaleContext`, `useFormatLocale` in `./i18n`.
186
+ - `tokens.json`: the optional `--segmented-control-*` variables above and the `contrast` key.
187
+ - `tokens.json`: layer `--layer-chrome` (30), optional properties `--sidebar-w` (16rem), `--sidebar-rail-w` (5rem) and
188
+ the three `--shell-background-*` colours, data attributes `data-shell`, `data-shell-collapsed`,
189
+ `data-shell-content`, `data-shell-sidebar`, `data-shell-topbar`, `data-shell-scrolled`, `data-shell-background`,
190
+ `data-nav-key`. `components.css` sets the defaults and reserves the sidebar width on `[data-shell-content]`.
191
+ - README: the layers checklist (dialogs open at `--layer-overlay` 50; a host with a higher overlay scale raises it).
192
+
193
+ Showcase, import matrix, checks:
194
+
195
+ - Showcase: sections `./markdown` (through `loadMarkdown`), `./data`, `./workers`, `./shell` (an interactive frame
196
+ with the background, folding breadcrumbs, the menus), the translation admin screens and `MaintenanceActionCard`,
197
+ samples of the new blocks; the sample payloads `showcaseWorkersData`, `showcaseTranslationsData` (with
198
+ `createStaticWorkersApi` / `createStaticTranslationsApi`); `SHOWCASE_COVERAGE` lists every new entry and block.
199
+ - Import matrix: `./data` and `./markdown` import logic, i18n and primitives (`./markdown` types only from
200
+ translations); `./workers` logic, i18n, primitives, list and page; `./translations` additionally list and page and,
201
+ from form, `Form`, `FormActions`, `FormDrawer`, `FormField`, `FormSubmitButton`; `./shell` logic, i18n and
202
+ primitives; `./shell-background` no other entry; `./design-studio` primitives, list, page and glass; `./showcase`
203
+ also data, workers, shell and shell-background.
204
+ - Checks: `browser-blocks.mjs` in the Next consumer (date presets, bulk menus with a counted confirmation, a
205
+ content-sized pinned actions column, the segmented control's option height, translatable limits, the colour field,
206
+ the route error, the side-by-side drawer, `./markdown` after hydration) and unit tests of the new pure helpers and of
207
+ `check-contrast`.
208
+ - Checks: unit tests of both injections (operations, paths, tags, invalidation; the workers one also on the real RTK
209
+ Query store where the install has it), `screens-render.mjs` in `test:render` (both entries on the sample payloads,
210
+ write access disables restart, generation, toggles and imports), and `browser-screens.mjs` in the Next consumer
211
+ (real RTK Query with an in-memory base query: window switch, restart and refetch, chart tooltip, tabs and filters,
212
+ the `isActive` toggle with its refetches, the key drawer, the import, 390 px).
213
+ - Checks: resolver unit tests; `shell-render.mjs` (server render: one navigation for sidebar, breadcrumbs and title,
214
+ the rights predicate, no stored state on the server, `./shell` never reaches `./shell-background`); browser checks of
215
+ the shell (active entry, rights predicate, collapse by button and `[`, restored after a reload without a hydration
216
+ warning, rail flyout, mobile menu, folding breadcrumbs, title, RTL).
217
+
218
+ Fixes:
219
+
220
+ - A ReactNode description of `PageHeader`, `SectionHeader`, `DetailHeader`, `MediaItemField` and `TranslatableField`
221
+ renders in a `<div>` (a string or number stays in the `<p>`).
222
+
223
+ ## 0.1.0
224
+
225
+ First stable release: 0.1.0-rc.6 plus the description fix below. Published under the `latest` dist-tag; prereleases
226
+ stay on `next`. In short, the release candidates brought (details in the sections below):
227
+
228
+ - the blocks and their entries `./logic`, `./i18n`, `./primitives`, `./list`, `./page`, `./form`, `./translations`,
229
+ `./media`, `./glass`, `./provider`, `./next`, `./notify-sonner`, the stylesheets `./theme.css` and
230
+ `./components.css`, the manifests `./tokens.json` and `./i18n-keys.json`, the bins and `STANDARDS.md` (rc.2);
231
+ - list tables with column tracks, pinned columns, sortable headers, a row index, and status contexts (rc.3);
232
+ - `SegmentedControl`, the `./showcase` entry and per-column sort cycles (rc.4);
233
+ - Combobox server search, clearing, groups and a create row, selectable rows, `CopyButton`, date input and storage
234
+ helpers, the provider's link component with sticky parameters (rc.5);
235
+ - `FormDialog`, the header slot and the document-level save shortcut of `FormActions`, `useConfirm` on the provider
236
+ with `requirePhrase` and a queue, and write access as a presentation aid (rc.6).
237
+
238
+ Fix:
239
+
240
+ - A description that is not a string or number (two paragraphs, a list, a `<div>`) renders in a `<div>` instead of the
241
+ `<p>` of `DialogDescription` / `SheetDescription`, with the same classes, `data-slot` and `aria-describedby` wiring:
242
+ no `<p>` nested in a `<p>`, no hydration warning. Covers `useConfirm` / `ConfirmOptions.description`,
243
+ `FormDialog.description`, `FormDrawer.description` and `MediaItemPickerDialog.description`. A string description
244
+ renders the same DOM as in 0.1.0-rc.6. Consumer checks in the browser: a block description in `useConfirm`,
245
+ `FormDialog` and `FormDrawer` (a `<div>` referenced by `aria-describedby`, no `<p>` in a `<p>`, no console error or
246
+ hydration warning), a string description still a `<p>`.
5
247
 
6
248
  ## 0.1.0-rc.6
7
249