@mgamadeus/ddd-admin-ui 0.1.0-rc.1 → 0.1.0-rc.3

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 (685) hide show
  1. package/.claude/skills/ddd-admin-ui-specialist/SKILL.md +159 -18
  2. package/CHANGELOG.md +56 -1
  3. package/README.md +207 -90
  4. package/STANDARDS.md +433 -0
  5. package/dist/components.css +222 -22
  6. package/dist/form/DrawerFooter.d.ts +18 -0
  7. package/dist/form/DrawerFooter.d.ts.map +1 -0
  8. package/dist/form/DrawerFooter.js +47 -0
  9. package/dist/form/DrawerFooter.js.map +1 -0
  10. package/dist/form/Form.d.ts +25 -10
  11. package/dist/form/Form.d.ts.map +1 -1
  12. package/dist/form/Form.js +17 -8
  13. package/dist/form/Form.js.map +1 -1
  14. package/dist/form/FormActions.d.ts +35 -0
  15. package/dist/form/FormActions.d.ts.map +1 -0
  16. package/dist/form/FormActions.js +80 -0
  17. package/dist/form/FormActions.js.map +1 -0
  18. package/dist/form/FormDrawer.d.ts +36 -0
  19. package/dist/form/FormDrawer.d.ts.map +1 -0
  20. package/dist/form/FormDrawer.js +31 -0
  21. package/dist/form/FormDrawer.js.map +1 -0
  22. package/dist/form/FormErrors.d.ts +22 -0
  23. package/dist/form/FormErrors.d.ts.map +1 -0
  24. package/dist/form/FormErrors.js +46 -0
  25. package/dist/form/FormErrors.js.map +1 -0
  26. package/dist/form/FormField.d.ts +74 -0
  27. package/dist/form/FormField.d.ts.map +1 -0
  28. package/dist/form/FormField.js +46 -0
  29. package/dist/form/FormField.js.map +1 -0
  30. package/dist/form/FormHeader.d.ts +20 -0
  31. package/dist/form/FormHeader.d.ts.map +1 -0
  32. package/dist/form/FormHeader.js +9 -0
  33. package/dist/form/FormHeader.js.map +1 -0
  34. package/dist/form/FormJumpBar.d.ts +20 -0
  35. package/dist/form/FormJumpBar.d.ts.map +1 -0
  36. package/dist/form/FormJumpBar.js +49 -0
  37. package/dist/form/FormJumpBar.js.map +1 -0
  38. package/dist/form/FormSubmitButton.d.ts +17 -0
  39. package/dist/form/FormSubmitButton.d.ts.map +1 -0
  40. package/dist/form/FormSubmitButton.js +14 -0
  41. package/dist/form/FormSubmitButton.js.map +1 -0
  42. package/dist/form/FormWrapper.d.ts +13 -0
  43. package/dist/form/FormWrapper.d.ts.map +1 -0
  44. package/dist/form/FormWrapper.js +15 -0
  45. package/dist/form/FormWrapper.js.map +1 -0
  46. package/dist/form/drawerSlots.d.ts +10 -0
  47. package/dist/form/drawerSlots.d.ts.map +1 -0
  48. package/dist/form/drawerSlots.js +7 -0
  49. package/dist/form/drawerSlots.js.map +1 -0
  50. package/dist/form/fieldLabels.d.ts +15 -8
  51. package/dist/form/fieldLabels.d.ts.map +1 -1
  52. package/dist/form/fieldLabels.js +18 -6
  53. package/dist/form/fieldLabels.js.map +1 -1
  54. package/dist/form/formPanelClasses.d.ts +3 -0
  55. package/dist/form/formPanelClasses.d.ts.map +1 -0
  56. package/dist/form/formPanelClasses.js +3 -0
  57. package/dist/form/formPanelClasses.js.map +1 -0
  58. package/dist/form/index.d.ts +57 -2
  59. package/dist/form/index.d.ts.map +1 -1
  60. package/dist/form/index.js +33 -2
  61. package/dist/form/index.js.map +1 -1
  62. package/dist/form/useConfirmDialog.d.ts +9 -0
  63. package/dist/form/useConfirmDialog.d.ts.map +1 -0
  64. package/dist/form/useConfirmDialog.js +29 -0
  65. package/dist/form/useConfirmDialog.js.map +1 -0
  66. package/dist/glass/ActionRow.d.ts +27 -0
  67. package/dist/glass/ActionRow.d.ts.map +1 -0
  68. package/dist/glass/ActionRow.js +22 -0
  69. package/dist/glass/ActionRow.js.map +1 -0
  70. package/dist/glass/CollapsibleCard.d.ts +36 -0
  71. package/dist/glass/CollapsibleCard.d.ts.map +1 -0
  72. package/dist/glass/CollapsibleCard.js +27 -0
  73. package/dist/glass/CollapsibleCard.js.map +1 -0
  74. package/dist/glass/GlassGroup.d.ts +26 -0
  75. package/dist/glass/GlassGroup.d.ts.map +1 -0
  76. package/dist/glass/GlassGroup.js +34 -0
  77. package/dist/glass/GlassGroup.js.map +1 -0
  78. package/dist/glass/GlassPill.d.ts +23 -0
  79. package/dist/glass/GlassPill.d.ts.map +1 -0
  80. package/dist/glass/GlassPill.js +20 -0
  81. package/dist/glass/GlassPill.js.map +1 -0
  82. package/dist/glass/QuickFilterPills.d.ts +38 -0
  83. package/dist/glass/QuickFilterPills.d.ts.map +1 -0
  84. package/dist/glass/QuickFilterPills.js +30 -0
  85. package/dist/glass/QuickFilterPills.js.map +1 -0
  86. package/dist/glass/index.d.ts +10 -1
  87. package/dist/glass/index.d.ts.map +1 -1
  88. package/dist/glass/index.js +6 -1
  89. package/dist/glass/index.js.map +1 -1
  90. package/dist/i18n/Translate.d.ts +5 -4
  91. package/dist/i18n/Translate.d.ts.map +1 -1
  92. package/dist/i18n/Translate.js +3 -3
  93. package/dist/i18n/Translate.js.map +1 -1
  94. package/dist/i18n/format.d.ts +13 -0
  95. package/dist/i18n/format.d.ts.map +1 -0
  96. package/dist/i18n/format.js +15 -0
  97. package/dist/i18n/format.js.map +1 -0
  98. package/dist/i18n/hints.json +131 -0
  99. package/dist/i18n/index.d.ts +5 -3
  100. package/dist/i18n/index.d.ts.map +1 -1
  101. package/dist/i18n/index.js +5 -3
  102. package/dist/i18n/index.js.map +1 -1
  103. package/dist/i18n/localeFormat.d.ts +10 -0
  104. package/dist/i18n/localeFormat.d.ts.map +1 -0
  105. package/dist/i18n/localeFormat.js +36 -0
  106. package/dist/i18n/localeFormat.js.map +1 -0
  107. package/dist/i18n/plural.d.ts +15 -0
  108. package/dist/i18n/plural.d.ts.map +1 -0
  109. package/dist/i18n/plural.js +95 -0
  110. package/dist/i18n/plural.js.map +1 -0
  111. package/dist/i18n/serverMessages.d.ts +26 -0
  112. package/dist/i18n/serverMessages.d.ts.map +1 -0
  113. package/dist/i18n/serverMessages.js +146 -0
  114. package/dist/i18n/serverMessages.js.map +1 -0
  115. package/dist/i18n/store.d.ts +36 -16
  116. package/dist/i18n/store.d.ts.map +1 -1
  117. package/dist/i18n/store.js +30 -20
  118. package/dist/i18n/store.js.map +1 -1
  119. package/dist/i18n/useTranslate.d.ts +15 -7
  120. package/dist/i18n/useTranslate.d.ts.map +1 -1
  121. package/dist/i18n/useTranslate.js +17 -7
  122. package/dist/i18n/useTranslate.js.map +1 -1
  123. package/dist/i18n-keys.json +1058 -13
  124. package/dist/list/ChipToggleGroup.d.ts +36 -0
  125. package/dist/list/ChipToggleGroup.d.ts.map +1 -0
  126. package/dist/list/ChipToggleGroup.js +34 -0
  127. package/dist/list/ChipToggleGroup.js.map +1 -0
  128. package/dist/list/Combobox.d.ts +32 -0
  129. package/dist/list/Combobox.d.ts.map +1 -0
  130. package/dist/list/Combobox.js +27 -0
  131. package/dist/list/Combobox.js.map +1 -0
  132. package/dist/list/EmptyValue.d.ts +14 -0
  133. package/dist/list/EmptyValue.d.ts.map +1 -0
  134. package/dist/list/EmptyValue.js +11 -0
  135. package/dist/list/EmptyValue.js.map +1 -0
  136. package/dist/list/EntityListBody.d.ts +34 -0
  137. package/dist/list/EntityListBody.d.ts.map +1 -0
  138. package/dist/list/EntityListBody.js +30 -0
  139. package/dist/list/EntityListBody.js.map +1 -0
  140. package/dist/list/EntityListBulkBar.d.ts +38 -0
  141. package/dist/list/EntityListBulkBar.d.ts.map +1 -0
  142. package/dist/list/EntityListBulkBar.js +19 -0
  143. package/dist/list/EntityListBulkBar.js.map +1 -0
  144. package/dist/list/EntityListCard.d.ts +22 -0
  145. package/dist/list/EntityListCard.d.ts.map +1 -0
  146. package/dist/list/EntityListCard.js +15 -0
  147. package/dist/list/EntityListCard.js.map +1 -0
  148. package/dist/list/EntityListEmpty.d.ts +13 -0
  149. package/dist/list/EntityListEmpty.d.ts.map +1 -0
  150. package/dist/list/EntityListEmpty.js +11 -0
  151. package/dist/list/EntityListEmpty.js.map +1 -0
  152. package/dist/list/EntityListGrid.d.ts +29 -0
  153. package/dist/list/EntityListGrid.d.ts.map +1 -0
  154. package/dist/list/EntityListGrid.js +21 -0
  155. package/dist/list/EntityListGrid.js.map +1 -0
  156. package/dist/list/EntityListLoadMore.d.ts +15 -0
  157. package/dist/list/EntityListLoadMore.d.ts.map +1 -0
  158. package/dist/list/EntityListLoadMore.js +27 -0
  159. package/dist/list/EntityListLoadMore.js.map +1 -0
  160. package/dist/list/EntityListStatus.d.ts +11 -0
  161. package/dist/list/EntityListStatus.d.ts.map +1 -0
  162. package/dist/list/EntityListStatus.js +22 -0
  163. package/dist/list/EntityListStatus.js.map +1 -0
  164. package/dist/list/EntityListTable.d.ts +67 -0
  165. package/dist/list/EntityListTable.d.ts.map +1 -0
  166. package/dist/list/EntityListTable.js +194 -0
  167. package/dist/list/EntityListTable.js.map +1 -0
  168. package/dist/list/EntityListToolbar.d.ts +39 -0
  169. package/dist/list/EntityListToolbar.d.ts.map +1 -0
  170. package/dist/list/EntityListToolbar.js +25 -0
  171. package/dist/list/EntityListToolbar.js.map +1 -0
  172. package/dist/list/EntityListViewToggle.d.ts +17 -0
  173. package/dist/list/EntityListViewToggle.d.ts.map +1 -0
  174. package/dist/list/EntityListViewToggle.js +38 -0
  175. package/dist/list/EntityListViewToggle.js.map +1 -0
  176. package/dist/list/MultiSelect.d.ts +33 -0
  177. package/dist/list/MultiSelect.d.ts.map +1 -0
  178. package/dist/list/MultiSelect.js +60 -0
  179. package/dist/list/MultiSelect.js.map +1 -0
  180. package/dist/list/SearchField.d.ts +24 -0
  181. package/dist/list/SearchField.d.ts.map +1 -0
  182. package/dist/list/SearchField.js +42 -0
  183. package/dist/list/SearchField.js.map +1 -0
  184. package/dist/list/StatusBadge.d.ts +34 -0
  185. package/dist/list/StatusBadge.d.ts.map +1 -0
  186. package/dist/list/StatusBadge.js +45 -0
  187. package/dist/list/StatusBadge.js.map +1 -0
  188. package/dist/list/Tag.d.ts +16 -0
  189. package/dist/list/Tag.d.ts.map +1 -0
  190. package/dist/list/Tag.js +15 -0
  191. package/dist/list/Tag.js.map +1 -0
  192. package/dist/list/cells.d.ts +53 -0
  193. package/dist/list/cells.d.ts.map +1 -0
  194. package/dist/list/cells.js +62 -0
  195. package/dist/list/cells.js.map +1 -0
  196. package/dist/list/filterClasses.d.ts +8 -0
  197. package/dist/list/filterClasses.d.ts.map +1 -0
  198. package/dist/list/filterClasses.js +8 -0
  199. package/dist/list/filterClasses.js.map +1 -0
  200. package/dist/list/filterOptions.d.ts +7 -0
  201. package/dist/list/filterOptions.d.ts.map +1 -0
  202. package/dist/list/filterOptions.js +7 -0
  203. package/dist/list/filterOptions.js.map +1 -0
  204. package/dist/list/filters.d.ts +78 -0
  205. package/dist/list/filters.d.ts.map +1 -0
  206. package/dist/list/filters.js +54 -0
  207. package/dist/list/filters.js.map +1 -0
  208. package/dist/list/index.d.ts +88 -2
  209. package/dist/list/index.d.ts.map +1 -1
  210. package/dist/list/index.js +50 -2
  211. package/dist/list/index.js.map +1 -1
  212. package/dist/list/types.d.ts +59 -0
  213. package/dist/list/types.d.ts.map +1 -0
  214. package/dist/list/types.js +3 -0
  215. package/dist/list/types.js.map +1 -0
  216. package/dist/logic/browser/prepareImageFile.d.ts +18 -0
  217. package/dist/logic/browser/prepareImageFile.d.ts.map +1 -0
  218. package/dist/logic/browser/prepareImageFile.js +26 -0
  219. package/dist/logic/browser/prepareImageFile.js.map +1 -0
  220. package/dist/logic/index.d.ts +60 -5
  221. package/dist/logic/index.d.ts.map +1 -1
  222. package/dist/logic/index.js +39 -4
  223. package/dist/logic/index.js.map +1 -1
  224. package/dist/logic/pure/conditions.d.ts +46 -0
  225. package/dist/logic/pure/conditions.d.ts.map +1 -0
  226. package/dist/logic/pure/conditions.js +39 -0
  227. package/dist/logic/pure/conditions.js.map +1 -0
  228. package/dist/logic/pure/confirm.d.ts +19 -0
  229. package/dist/logic/pure/confirm.d.ts.map +1 -0
  230. package/dist/logic/pure/confirm.js +10 -0
  231. package/dist/logic/pure/confirm.js.map +1 -0
  232. package/dist/logic/pure/displayMode.d.ts +12 -0
  233. package/dist/logic/pure/displayMode.d.ts.map +1 -0
  234. package/dist/logic/pure/displayMode.js +11 -0
  235. package/dist/logic/pure/displayMode.js.map +1 -0
  236. package/dist/logic/pure/entityDrawer.d.ts +24 -0
  237. package/dist/logic/pure/entityDrawer.d.ts.map +1 -0
  238. package/dist/logic/pure/entityDrawer.js +3 -0
  239. package/dist/logic/pure/entityDrawer.js.map +1 -0
  240. package/dist/logic/pure/fieldPath.d.ts +9 -0
  241. package/dist/logic/pure/fieldPath.d.ts.map +1 -0
  242. package/dist/logic/pure/fieldPath.js +17 -0
  243. package/dist/logic/pure/fieldPath.js.map +1 -0
  244. package/dist/logic/pure/formValues.d.ts +14 -0
  245. package/dist/logic/pure/formValues.d.ts.map +1 -0
  246. package/dist/logic/pure/formValues.js +82 -0
  247. package/dist/logic/pure/formValues.js.map +1 -0
  248. package/dist/logic/pure/format.d.ts +14 -14
  249. package/dist/logic/pure/format.d.ts.map +1 -1
  250. package/dist/logic/pure/format.js +50 -29
  251. package/dist/logic/pure/format.js.map +1 -1
  252. package/dist/logic/pure/listSort.d.ts +21 -0
  253. package/dist/logic/pure/listSort.d.ts.map +1 -0
  254. package/dist/logic/pure/listSort.js +31 -0
  255. package/dist/logic/pure/listSort.js.map +1 -0
  256. package/dist/logic/pure/listTracks.d.ts +90 -0
  257. package/dist/logic/pure/listTracks.d.ts.map +1 -0
  258. package/dist/logic/pure/listTracks.js +139 -0
  259. package/dist/logic/pure/listTracks.js.map +1 -0
  260. package/dist/logic/pure/locales.d.ts +27 -0
  261. package/dist/logic/pure/locales.d.ts.map +1 -0
  262. package/dist/logic/pure/locales.js +50 -0
  263. package/dist/logic/pure/locales.js.map +1 -0
  264. package/dist/logic/pure/notify.d.ts +28 -5
  265. package/dist/logic/pure/notify.d.ts.map +1 -1
  266. package/dist/logic/pure/notify.js +41 -22
  267. package/dist/logic/pure/notify.js.map +1 -1
  268. package/dist/logic/pure/rowActivation.d.ts +6 -0
  269. package/dist/logic/pure/rowActivation.d.ts.map +1 -0
  270. package/dist/logic/pure/rowActivation.js +7 -0
  271. package/dist/logic/pure/rowActivation.js.map +1 -0
  272. package/dist/logic/pure/runSequential.d.ts +31 -0
  273. package/dist/logic/pure/runSequential.d.ts.map +1 -0
  274. package/dist/logic/pure/runSequential.js +47 -0
  275. package/dist/logic/pure/runSequential.js.map +1 -0
  276. package/dist/logic/pure/schemas.d.ts +14 -0
  277. package/dist/logic/pure/schemas.d.ts.map +1 -0
  278. package/dist/logic/pure/schemas.js +6 -0
  279. package/dist/logic/pure/schemas.js.map +1 -0
  280. package/dist/logic/pure/serverViolations.d.ts +35 -0
  281. package/dist/logic/pure/serverViolations.d.ts.map +1 -0
  282. package/dist/logic/pure/serverViolations.js +77 -0
  283. package/dist/logic/pure/serverViolations.js.map +1 -0
  284. package/dist/logic/pure/status.d.ts +42 -0
  285. package/dist/logic/pure/status.d.ts.map +1 -0
  286. package/dist/logic/pure/status.js +24 -0
  287. package/dist/logic/pure/status.js.map +1 -0
  288. package/dist/logic/pure/submitError.d.ts +11 -0
  289. package/dist/logic/pure/submitError.d.ts.map +1 -0
  290. package/dist/logic/pure/submitError.js +9 -0
  291. package/dist/logic/pure/submitError.js.map +1 -0
  292. package/dist/logic/pure/translationState.d.ts +29 -0
  293. package/dist/logic/pure/translationState.d.ts.map +1 -0
  294. package/dist/logic/pure/translationState.js +88 -0
  295. package/dist/logic/pure/translationState.js.map +1 -0
  296. package/dist/logic/pure/urlListState.d.ts +18 -0
  297. package/dist/logic/pure/urlListState.d.ts.map +1 -0
  298. package/dist/logic/pure/urlListState.js +3 -0
  299. package/dist/logic/pure/urlListState.js.map +1 -0
  300. package/dist/logic/react/conditionHooks.d.ts +20 -0
  301. package/dist/logic/react/conditionHooks.d.ts.map +1 -0
  302. package/dist/logic/react/conditionHooks.js +51 -0
  303. package/dist/logic/react/conditionHooks.js.map +1 -0
  304. package/dist/logic/react/useCopyToClipboard.d.ts +9 -0
  305. package/dist/logic/react/useCopyToClipboard.d.ts.map +1 -0
  306. package/dist/logic/react/useCopyToClipboard.js +28 -0
  307. package/dist/logic/react/useCopyToClipboard.js.map +1 -0
  308. package/dist/logic/react/useDebouncedValue.d.ts +3 -0
  309. package/dist/logic/react/useDebouncedValue.d.ts.map +1 -0
  310. package/dist/logic/react/useDebouncedValue.js +12 -0
  311. package/dist/logic/react/useDebouncedValue.js.map +1 -0
  312. package/dist/logic/react/useEntityDrawer.d.ts +54 -0
  313. package/dist/logic/react/useEntityDrawer.d.ts.map +1 -0
  314. package/dist/logic/react/useEntityDrawer.js +81 -0
  315. package/dist/logic/react/useEntityDrawer.js.map +1 -0
  316. package/dist/logic/react/useEntityTranslations.d.ts +57 -0
  317. package/dist/logic/react/useEntityTranslations.d.ts.map +1 -0
  318. package/dist/logic/react/useEntityTranslations.js +50 -0
  319. package/dist/logic/react/useEntityTranslations.js.map +1 -0
  320. package/dist/logic/react/useFormDirty.d.ts +15 -0
  321. package/dist/logic/react/useFormDirty.d.ts.map +1 -0
  322. package/dist/logic/react/useFormDirty.js +17 -0
  323. package/dist/logic/react/useFormDirty.js.map +1 -0
  324. package/dist/logic/react/useGrowingWindowList.d.ts +50 -0
  325. package/dist/logic/react/useGrowingWindowList.d.ts.map +1 -0
  326. package/dist/logic/react/useGrowingWindowList.js +38 -0
  327. package/dist/logic/react/useGrowingWindowList.js.map +1 -0
  328. package/dist/logic/react/useHydrated.d.ts +7 -0
  329. package/dist/logic/react/useHydrated.d.ts.map +1 -0
  330. package/dist/logic/react/useHydrated.js +12 -0
  331. package/dist/logic/react/useHydrated.js.map +1 -0
  332. package/dist/logic/react/useInfiniteScrollSentinel.d.ts +6 -0
  333. package/dist/logic/react/useInfiniteScrollSentinel.d.ts.map +1 -0
  334. package/dist/logic/react/useInfiniteScrollSentinel.js +24 -0
  335. package/dist/logic/react/useInfiniteScrollSentinel.js.map +1 -0
  336. package/dist/logic/react/useLocaleName.d.ts +3 -0
  337. package/dist/logic/react/useLocaleName.d.ts.map +1 -0
  338. package/dist/logic/react/useLocaleName.js +10 -0
  339. package/dist/logic/react/useLocaleName.js.map +1 -0
  340. package/dist/logic/react/useRowActivation.d.ts +12 -0
  341. package/dist/logic/react/useRowActivation.d.ts.map +1 -0
  342. package/dist/logic/react/useRowActivation.js +35 -0
  343. package/dist/logic/react/useRowActivation.js.map +1 -0
  344. package/dist/logic/react/useRowSelection.d.ts +40 -0
  345. package/dist/logic/react/useRowSelection.d.ts.map +1 -0
  346. package/dist/logic/react/useRowSelection.js +70 -0
  347. package/dist/logic/react/useRowSelection.js.map +1 -0
  348. package/dist/logic/react/useTranslationRunner.d.ts +27 -0
  349. package/dist/logic/react/useTranslationRunner.d.ts.map +1 -0
  350. package/dist/logic/react/useTranslationRunner.js +57 -0
  351. package/dist/logic/react/useTranslationRunner.js.map +1 -0
  352. package/dist/logic/react/useUnsavedChangesGuard.d.ts +30 -0
  353. package/dist/logic/react/useUnsavedChangesGuard.d.ts.map +1 -0
  354. package/dist/logic/react/useUnsavedChangesGuard.js +66 -0
  355. package/dist/logic/react/useUnsavedChangesGuard.js.map +1 -0
  356. package/dist/logic/react/useUrlListState.d.ts +39 -0
  357. package/dist/logic/react/useUrlListState.d.ts.map +1 -0
  358. package/dist/logic/react/useUrlListState.js +96 -0
  359. package/dist/logic/react/useUrlListState.js.map +1 -0
  360. package/dist/media/FormMediaItemField.d.ts +38 -0
  361. package/dist/media/FormMediaItemField.d.ts.map +1 -0
  362. package/dist/media/FormMediaItemField.js +35 -0
  363. package/dist/media/FormMediaItemField.js.map +1 -0
  364. package/dist/media/MediaItemField.d.ts +17 -3
  365. package/dist/media/MediaItemField.d.ts.map +1 -1
  366. package/dist/media/MediaItemField.js +11 -7
  367. package/dist/media/MediaItemField.js.map +1 -1
  368. package/dist/media/MediaItemPickerDialog.d.ts +48 -0
  369. package/dist/media/MediaItemPickerDialog.d.ts.map +1 -0
  370. package/dist/media/MediaItemPickerDialog.js +36 -0
  371. package/dist/media/MediaItemPickerDialog.js.map +1 -0
  372. package/dist/media/MediaPreview.d.ts +16 -0
  373. package/dist/media/MediaPreview.d.ts.map +1 -0
  374. package/dist/media/MediaPreview.js +20 -0
  375. package/dist/media/MediaPreview.js.map +1 -0
  376. package/dist/media/index.d.ts +17 -2
  377. package/dist/media/index.d.ts.map +1 -1
  378. package/dist/media/index.js +7 -0
  379. package/dist/media/index.js.map +1 -1
  380. package/dist/media/types.d.ts +23 -6
  381. package/dist/media/types.d.ts.map +1 -1
  382. package/dist/next/index.d.ts +7 -2
  383. package/dist/next/index.d.ts.map +1 -1
  384. package/dist/next/index.js +7 -2
  385. package/dist/next/index.js.map +1 -1
  386. package/dist/next/listViewParam.d.ts +3 -0
  387. package/dist/next/listViewParam.d.ts.map +1 -0
  388. package/dist/next/listViewParam.js +3 -0
  389. package/dist/next/listViewParam.js.map +1 -0
  390. package/dist/next/searchParamsWriter.d.ts +30 -6
  391. package/dist/next/searchParamsWriter.d.ts.map +1 -1
  392. package/dist/next/searchParamsWriter.js +80 -27
  393. package/dist/next/searchParamsWriter.js.map +1 -1
  394. package/dist/next/storage.d.ts +11 -0
  395. package/dist/next/storage.d.ts.map +1 -0
  396. package/dist/next/storage.js +34 -0
  397. package/dist/next/storage.js.map +1 -0
  398. package/dist/next/useListViewParam.d.ts +12 -0
  399. package/dist/next/useListViewParam.d.ts.map +1 -0
  400. package/dist/next/useListViewParam.js +45 -0
  401. package/dist/next/useListViewParam.js.map +1 -0
  402. package/dist/next/useNextDrawerUrlAdapter.d.ts +11 -0
  403. package/dist/next/useNextDrawerUrlAdapter.d.ts.map +1 -0
  404. package/dist/next/useNextDrawerUrlAdapter.js +28 -0
  405. package/dist/next/useNextDrawerUrlAdapter.js.map +1 -0
  406. package/dist/next/useNextUrlStateAdapter.d.ts +20 -0
  407. package/dist/next/useNextUrlStateAdapter.d.ts.map +1 -0
  408. package/dist/next/useNextUrlStateAdapter.js +28 -0
  409. package/dist/next/useNextUrlStateAdapter.js.map +1 -0
  410. package/dist/notify-sonner/Toaster.d.ts +8 -0
  411. package/dist/notify-sonner/Toaster.d.ts.map +1 -0
  412. package/dist/notify-sonner/Toaster.js +24 -0
  413. package/dist/notify-sonner/Toaster.js.map +1 -0
  414. package/dist/notify-sonner/index.d.ts +1 -0
  415. package/dist/notify-sonner/index.d.ts.map +1 -1
  416. package/dist/notify-sonner/index.js +2 -0
  417. package/dist/notify-sonner/index.js.map +1 -1
  418. package/dist/notify-sonner/sonnerNotifications.d.ts +1 -1
  419. package/dist/notify-sonner/sonnerNotifications.d.ts.map +1 -1
  420. package/dist/notify-sonner/sonnerNotifications.js +23 -6
  421. package/dist/notify-sonner/sonnerNotifications.js.map +1 -1
  422. package/dist/page/DefinitionList.d.ts +24 -0
  423. package/dist/page/DefinitionList.d.ts.map +1 -0
  424. package/dist/page/DefinitionList.js +20 -0
  425. package/dist/page/DefinitionList.js.map +1 -0
  426. package/dist/page/DetailHeader.d.ts +26 -0
  427. package/dist/page/DetailHeader.d.ts.map +1 -0
  428. package/dist/page/DetailHeader.js +14 -0
  429. package/dist/page/DetailHeader.js.map +1 -0
  430. package/dist/page/EditableCard.d.ts +39 -0
  431. package/dist/page/EditableCard.d.ts.map +1 -0
  432. package/dist/page/EditableCard.js +21 -0
  433. package/dist/page/EditableCard.js.map +1 -0
  434. package/dist/page/EntityDetailShell.d.ts +48 -0
  435. package/dist/page/EntityDetailShell.d.ts.map +1 -0
  436. package/dist/page/EntityDetailShell.js +25 -0
  437. package/dist/page/EntityDetailShell.js.map +1 -0
  438. package/dist/page/EntityListPage.d.ts +30 -0
  439. package/dist/page/EntityListPage.d.ts.map +1 -0
  440. package/dist/page/EntityListPage.js +12 -0
  441. package/dist/page/EntityListPage.js.map +1 -0
  442. package/dist/page/EntityMetadata.d.ts +21 -0
  443. package/dist/page/EntityMetadata.d.ts.map +1 -0
  444. package/dist/page/EntityMetadata.js +39 -0
  445. package/dist/page/EntityMetadata.js.map +1 -0
  446. package/dist/page/EntityTabs.d.ts +38 -0
  447. package/dist/page/EntityTabs.d.ts.map +1 -0
  448. package/dist/page/EntityTabs.js +51 -0
  449. package/dist/page/EntityTabs.js.map +1 -0
  450. package/dist/page/PageFrame.d.ts +18 -2
  451. package/dist/page/PageFrame.d.ts.map +1 -1
  452. package/dist/page/PageFrame.js +8 -2
  453. package/dist/page/PageFrame.js.map +1 -1
  454. package/dist/page/PageHeader.d.ts +27 -0
  455. package/dist/page/PageHeader.d.ts.map +1 -0
  456. package/dist/page/PageHeader.js +16 -0
  457. package/dist/page/PageHeader.js.map +1 -0
  458. package/dist/page/PageLayout.d.ts +15 -0
  459. package/dist/page/PageLayout.d.ts.map +1 -0
  460. package/dist/page/PageLayout.js +10 -0
  461. package/dist/page/PageLayout.js.map +1 -0
  462. package/dist/page/PageToolbar.d.ts +73 -0
  463. package/dist/page/PageToolbar.d.ts.map +1 -0
  464. package/dist/page/PageToolbar.js +49 -0
  465. package/dist/page/PageToolbar.js.map +1 -0
  466. package/dist/page/SectionHeader.d.ts +27 -0
  467. package/dist/page/SectionHeader.d.ts.map +1 -0
  468. package/dist/page/SectionHeader.js +14 -0
  469. package/dist/page/SectionHeader.js.map +1 -0
  470. package/dist/page/StatusCallout.d.ts +28 -0
  471. package/dist/page/StatusCallout.d.ts.map +1 -0
  472. package/dist/page/StatusCallout.js +35 -0
  473. package/dist/page/StatusCallout.js.map +1 -0
  474. package/dist/page/index.d.ts +28 -1
  475. package/dist/page/index.d.ts.map +1 -1
  476. package/dist/page/index.js +18 -0
  477. package/dist/page/index.js.map +1 -1
  478. package/dist/page/links.d.ts +18 -0
  479. package/dist/page/links.d.ts.map +1 -0
  480. package/dist/page/links.js +4 -0
  481. package/dist/page/links.js.map +1 -0
  482. package/dist/primitives/alert.d.ts +17 -0
  483. package/dist/primitives/alert.d.ts.map +1 -0
  484. package/dist/primitives/alert.js +36 -0
  485. package/dist/primitives/alert.js.map +1 -0
  486. package/dist/primitives/badge.d.ts +10 -0
  487. package/dist/primitives/badge.d.ts.map +1 -0
  488. package/dist/primitives/badge.js +30 -0
  489. package/dist/primitives/badge.js.map +1 -0
  490. package/dist/primitives/breadcrumb.d.ts +12 -0
  491. package/dist/primitives/breadcrumb.d.ts.map +1 -0
  492. package/dist/primitives/breadcrumb.js +33 -0
  493. package/dist/primitives/breadcrumb.js.map +1 -0
  494. package/dist/primitives/button.d.ts +10 -8
  495. package/dist/primitives/button.d.ts.map +1 -1
  496. package/dist/primitives/button.js +41 -10
  497. package/dist/primitives/button.js.map +1 -1
  498. package/dist/primitives/card.d.ts +10 -0
  499. package/dist/primitives/card.d.ts.map +1 -0
  500. package/dist/primitives/card.js +29 -0
  501. package/dist/primitives/card.js.map +1 -0
  502. package/dist/primitives/checkbox.d.ts +5 -0
  503. package/dist/primitives/checkbox.d.ts.map +1 -0
  504. package/dist/primitives/checkbox.js +11 -0
  505. package/dist/primitives/checkbox.js.map +1 -0
  506. package/dist/primitives/cn.d.ts +1 -1
  507. package/dist/primitives/cn.d.ts.map +1 -1
  508. package/dist/primitives/cn.js +1 -1
  509. package/dist/primitives/cn.js.map +1 -1
  510. package/dist/primitives/collapsible.d.ts +6 -0
  511. package/dist/primitives/collapsible.d.ts.map +1 -0
  512. package/dist/primitives/collapsible.js +14 -0
  513. package/dist/primitives/collapsible.js.map +1 -0
  514. package/dist/primitives/command.d.ts +19 -0
  515. package/dist/primitives/command.d.ts.map +1 -0
  516. package/dist/primitives/command.js +38 -0
  517. package/dist/primitives/command.js.map +1 -0
  518. package/dist/primitives/dialog.d.ts +17 -9
  519. package/dist/primitives/dialog.d.ts.map +1 -1
  520. package/dist/primitives/dialog.js +39 -14
  521. package/dist/primitives/dialog.js.map +1 -1
  522. package/dist/primitives/dropdown-menu.d.ts +23 -0
  523. package/dist/primitives/dropdown-menu.d.ts.map +1 -0
  524. package/dist/primitives/dropdown-menu.js +48 -0
  525. package/dist/primitives/dropdown-menu.js.map +1 -0
  526. package/dist/primitives/fieldSurface.d.ts +23 -0
  527. package/dist/primitives/fieldSurface.d.ts.map +1 -0
  528. package/dist/primitives/fieldSurface.js +23 -0
  529. package/dist/primitives/fieldSurface.js.map +1 -0
  530. package/dist/primitives/index.d.ts +24 -5
  531. package/dist/primitives/index.d.ts.map +1 -1
  532. package/dist/primitives/index.js +25 -5
  533. package/dist/primitives/index.js.map +1 -1
  534. package/dist/primitives/input.d.ts +12 -0
  535. package/dist/primitives/input.d.ts.map +1 -0
  536. package/dist/primitives/input.js +20 -0
  537. package/dist/primitives/input.js.map +1 -0
  538. package/dist/primitives/label.d.ts +5 -0
  539. package/dist/primitives/label.d.ts.map +1 -0
  540. package/dist/primitives/label.js +10 -0
  541. package/dist/primitives/label.js.map +1 -0
  542. package/dist/primitives/listSurface.d.ts +8 -0
  543. package/dist/primitives/listSurface.d.ts.map +1 -0
  544. package/dist/primitives/listSurface.js +8 -0
  545. package/dist/primitives/listSurface.js.map +1 -0
  546. package/dist/primitives/popover.d.ts +11 -0
  547. package/dist/primitives/popover.d.ts.map +1 -0
  548. package/dist/primitives/popover.js +31 -0
  549. package/dist/primitives/popover.js.map +1 -0
  550. package/dist/primitives/portal.d.ts +16 -0
  551. package/dist/primitives/portal.d.ts.map +1 -0
  552. package/dist/primitives/portal.js +9 -0
  553. package/dist/primitives/portal.js.map +1 -0
  554. package/dist/primitives/select.d.ts +20 -8
  555. package/dist/primitives/select.d.ts.map +1 -1
  556. package/dist/primitives/select.js +46 -12
  557. package/dist/primitives/select.js.map +1 -1
  558. package/dist/primitives/separator.d.ts +5 -0
  559. package/dist/primitives/separator.d.ts.map +1 -0
  560. package/dist/primitives/separator.js +10 -0
  561. package/dist/primitives/separator.js.map +1 -0
  562. package/dist/primitives/sheet.d.ts +14 -8
  563. package/dist/primitives/sheet.d.ts.map +1 -1
  564. package/dist/primitives/sheet.js +42 -11
  565. package/dist/primitives/sheet.js.map +1 -1
  566. package/dist/primitives/skeleton.d.ts +3 -0
  567. package/dist/primitives/skeleton.d.ts.map +1 -0
  568. package/dist/primitives/skeleton.js +7 -0
  569. package/dist/primitives/skeleton.js.map +1 -0
  570. package/dist/primitives/switch.d.ts +7 -0
  571. package/dist/primitives/switch.d.ts.map +1 -0
  572. package/dist/primitives/switch.js +10 -0
  573. package/dist/primitives/switch.js.map +1 -0
  574. package/dist/primitives/table.d.ts +11 -0
  575. package/dist/primitives/table.d.ts.map +1 -0
  576. package/dist/primitives/table.js +30 -0
  577. package/dist/primitives/table.js.map +1 -0
  578. package/dist/primitives/textarea.d.ts +4 -0
  579. package/dist/primitives/textarea.d.ts.map +1 -0
  580. package/dist/primitives/textarea.js +11 -0
  581. package/dist/primitives/textarea.js.map +1 -0
  582. package/dist/primitives/tooltip.d.ts +8 -0
  583. package/dist/primitives/tooltip.d.ts.map +1 -0
  584. package/dist/primitives/tooltip.js +21 -0
  585. package/dist/primitives/tooltip.js.map +1 -0
  586. package/dist/provider/AdminUiProvider.d.ts +8 -6
  587. package/dist/provider/AdminUiProvider.d.ts.map +1 -1
  588. package/dist/provider/AdminUiProvider.js +37 -22
  589. package/dist/provider/AdminUiProvider.js.map +1 -1
  590. package/dist/provider/adminUiContext.d.ts +6 -0
  591. package/dist/provider/adminUiContext.d.ts.map +1 -0
  592. package/dist/provider/adminUiContext.js +9 -0
  593. package/dist/provider/adminUiContext.js.map +1 -0
  594. package/dist/provider/index.d.ts +4 -2
  595. package/dist/provider/index.d.ts.map +1 -1
  596. package/dist/provider/index.js +4 -1
  597. package/dist/provider/index.js.map +1 -1
  598. package/dist/provider/storageKey.d.ts +4 -0
  599. package/dist/provider/storageKey.d.ts.map +1 -0
  600. package/dist/provider/storageKey.js +3 -0
  601. package/dist/provider/storageKey.js.map +1 -0
  602. package/dist/provider/types.d.ts +38 -6
  603. package/dist/provider/types.d.ts.map +1 -1
  604. package/dist/scripts/build-i18n-manifest.mjs +138 -0
  605. package/dist/scripts/check-radix.mjs +131 -0
  606. package/dist/scripts/check-tokens.mjs +236 -0
  607. package/dist/theme.css +15 -11
  608. package/dist/tokens.json +408 -53
  609. package/dist/translations/FormTranslatableFields.d.ts +30 -0
  610. package/dist/translations/FormTranslatableFields.d.ts.map +1 -0
  611. package/dist/translations/FormTranslatableFields.js +58 -0
  612. package/dist/translations/FormTranslatableFields.js.map +1 -0
  613. package/dist/translations/TranslatableField.d.ts +48 -0
  614. package/dist/translations/TranslatableField.d.ts.map +1 -0
  615. package/dist/translations/TranslatableField.js +44 -0
  616. package/dist/translations/TranslatableField.js.map +1 -0
  617. package/dist/translations/TranslatableInput.d.ts +14 -0
  618. package/dist/translations/TranslatableInput.d.ts.map +1 -0
  619. package/dist/translations/TranslatableInput.js +15 -0
  620. package/dist/translations/TranslatableInput.js.map +1 -0
  621. package/dist/translations/TranslatableMarkdown.d.ts +21 -0
  622. package/dist/translations/TranslatableMarkdown.d.ts.map +1 -0
  623. package/dist/translations/TranslatableMarkdown.js +12 -0
  624. package/dist/translations/TranslatableMarkdown.js.map +1 -0
  625. package/dist/translations/TranslationControls.d.ts +22 -0
  626. package/dist/translations/TranslationControls.d.ts.map +1 -0
  627. package/dist/translations/TranslationControls.js +31 -0
  628. package/dist/translations/TranslationControls.js.map +1 -0
  629. package/dist/translations/index.d.ts +30 -1
  630. package/dist/translations/index.d.ts.map +1 -1
  631. package/dist/translations/index.js +17 -1
  632. package/dist/translations/index.js.map +1 -1
  633. package/package.json +29 -34
  634. package/dist/data/StatTile.d.ts +0 -8
  635. package/dist/data/StatTile.d.ts.map +0 -1
  636. package/dist/data/StatTile.js +0 -6
  637. package/dist/data/StatTile.js.map +0 -1
  638. package/dist/data/index.d.ts +0 -2
  639. package/dist/data/index.d.ts.map +0 -1
  640. package/dist/data/index.js +0 -2
  641. package/dist/data/index.js.map +0 -1
  642. package/dist/glass/GlassPanel.d.ts +0 -7
  643. package/dist/glass/GlassPanel.d.ts.map +0 -1
  644. package/dist/glass/GlassPanel.js +0 -5
  645. package/dist/glass/GlassPanel.js.map +0 -1
  646. package/dist/i18n/m.d.ts +0 -7
  647. package/dist/i18n/m.d.ts.map +0 -1
  648. package/dist/i18n/m.js +0 -7
  649. package/dist/i18n/m.js.map +0 -1
  650. package/dist/list/ClearFiltersButton.d.ts +0 -7
  651. package/dist/list/ClearFiltersButton.d.ts.map +0 -1
  652. package/dist/list/ClearFiltersButton.js +0 -10
  653. package/dist/list/ClearFiltersButton.js.map +0 -1
  654. package/dist/list/DateCell.d.ts +0 -8
  655. package/dist/list/DateCell.d.ts.map +0 -1
  656. package/dist/list/DateCell.js +0 -12
  657. package/dist/list/DateCell.js.map +0 -1
  658. package/dist/logic/pure/errors.d.ts +0 -3
  659. package/dist/logic/pure/errors.d.ts.map +0 -1
  660. package/dist/logic/pure/errors.js +0 -5
  661. package/dist/logic/pure/errors.js.map +0 -1
  662. package/dist/logic/pure/statusMap.d.ts +0 -12
  663. package/dist/logic/pure/statusMap.d.ts.map +0 -1
  664. package/dist/logic/pure/statusMap.js +0 -5
  665. package/dist/logic/pure/statusMap.js.map +0 -1
  666. package/dist/logic/react/useToggle.d.ts +0 -8
  667. package/dist/logic/react/useToggle.d.ts.map +0 -1
  668. package/dist/logic/react/useToggle.js +0 -9
  669. package/dist/logic/react/useToggle.js.map +0 -1
  670. package/dist/next/useNextSearchParam.d.ts +0 -3
  671. package/dist/next/useNextSearchParam.d.ts.map +0 -1
  672. package/dist/next/useNextSearchParam.js +0 -16
  673. package/dist/next/useNextSearchParam.js.map +0 -1
  674. package/dist/primitives/portalContainer.d.ts +0 -8
  675. package/dist/primitives/portalContainer.d.ts.map +0 -1
  676. package/dist/primitives/portalContainer.js +0 -12
  677. package/dist/primitives/portalContainer.js.map +0 -1
  678. package/dist/translations/TranslatableInputField.d.ts +0 -8
  679. package/dist/translations/TranslatableInputField.d.ts.map +0 -1
  680. package/dist/translations/TranslatableInputField.js +0 -12
  681. package/dist/translations/TranslatableInputField.js.map +0 -1
  682. package/docs/README.md +0 -11
  683. package/scripts/check-tokens.mjs +0 -136
  684. package/scripts/lib/i18n-manifest.mjs +0 -91
  685. package/scripts/lib/source-scan.mjs +0 -258
package/STANDARDS.md ADDED
@@ -0,0 +1,433 @@
1
+ # STANDARDS — how every list and detail screen is built
2
+
3
+ One presentation everywhere: a screen keeps its data and behaviour and takes its look from the blocks. Delete the
4
+ local copy when you adopt a block; never keep a screen-local `FilterField`, `Muted`, `StatusBadge`, tab shell, date
5
+ helper or checkbox column. Request bodies and filter strings stay exactly as they are.
6
+
7
+ Where the names below come from (setup and the entry list: [`README.md`](./README.md)):
8
+
9
+ | Entry | Names used here |
10
+ |---|---|
11
+ | `@mgamadeus/ddd-admin-ui/logic` | `useUrlListState`, `useRowSelection`, `useEntityDrawer`, `drawerKey`, `defineStatusMap`, `formatDate`, `formatDateTime`, `runSequentialWithSummary`, `nextListSort`, `parseListSort`, `formatListSort` |
12
+ | `@mgamadeus/ddd-admin-ui/list` | `EntityListToolbar`, `EntityListBody`, `EntityListTable`, `EntityListViewToggle`, `EntityListBulkBar`, `FilterPanel`, `FilterText`, `FilterSelect`, `FilterMultiSelect`, `FilterDateRange`, `YES_NO_FILTER_OPTIONS`, `StatusBadge`, `IdCell`, `DateCell`, `BooleanCell`, `ImageCell`, `EmptyValue`, `orEmpty`, `MultiSelect`, `ChipToggleGroup`, `Combobox`, `Tag` |
13
+ | `@mgamadeus/ddd-admin-ui/page` | `EntityListPage`, `PageToolbar`, `ExportButton`, `AddEntityButton`, `EntityDetailShell`, `SectionHeader`, `DefinitionList`, `EditableCard`, `IconValue`, `IconValueRow`, `PageSections`, `CardGrid`, `PageFrame`, `PageHeader` |
14
+ | `@mgamadeus/ddd-admin-ui/form` | `FormDrawer`, `FormActions`, `FormField`, `FormSection`, `useConfirmDialog` |
15
+ | `@mgamadeus/ddd-admin-ui/glass` | `QuickFilterPills`, `CollapsibleCard`, `GlassGroup`, `ActionRow` |
16
+ | `@mgamadeus/ddd-admin-ui/primitives` | `Button`, `Card`, `CardContent` |
17
+ | `@mgamadeus/ddd-admin-ui/next` | `useNextUrlStateAdapter`, `useNextDrawerUrlAdapter`, `useListViewParam` |
18
+
19
+ Every screen renders below `AdminUiProvider`.
20
+
21
+ ## 1. List state — `useUrlListState`
22
+
23
+ One hook for search + filters, in the URL, 350 ms debounce. Keys = URL parameter names, a module constant.
24
+
25
+ ```tsx
26
+ import { useUrlListState } from '@mgamadeus/ddd-admin-ui/logic';
27
+ import { useNextUrlStateAdapter } from '@mgamadeus/ddd-admin-ui/next'; // or the host's own `UrlStateAdapter`
28
+
29
+ const LIST_KEYS = ['q', 'workspaceId', 'status', 'createdFrom', 'createdTo'] as const;
30
+
31
+ const list = useUrlListState(LIST_KEYS, { adapter: useNextUrlStateAdapter({ listId: 'admin.projects' }), uncounted: ['q'] });
32
+ // inputs: list.values.q / list.setValue('q', value)
33
+ // request: build the filter string from list.debounced (never from list.values)
34
+ // multi: list.getList('status') / list.setList('status', next) → `?status=RUNNING,PAUSED`
35
+ // reset: list.clear() counts: list.activeFilterCount (panel), list.isActive (empty state)
36
+ ```
37
+
38
+ The screen renders inside `<Suspense>`. Build filters with the `@mgamadeus/ddd-web/query` builders.
39
+ `listId` is the list's stable id (a module constant) under which the host adapter remembers the list: e.g. the view in
40
+ localStorage, the filters in this tab's sessionStorage.
41
+
42
+ ## 2. Toolbar and filters
43
+
44
+ Search left, Filters toggle with count, one "Clear filters", scope pickers in `trailing`, view toggle last, bulk bar
45
+ below. Filters go **only** in the panel (never in `trailing`, never as an inline header row).
46
+
47
+ ```tsx
48
+ <EntityListToolbar
49
+ search={{ value: list.values.q, onChange: value => list.setValue('q', value), placeholder: 'Search name or ID' }}
50
+ filters={
51
+ <FilterPanel>
52
+ <FilterText label="ID" inputMode="numeric" value={list.values.id} onChange={value => list.setValue('id', value)} />
53
+ <FilterSelect label="Workspace" allLabel="All workspaces" options={workspaceOptions} value={list.values.workspaceId}
54
+ onChange={value => list.setValue('workspaceId', value)} />
55
+ <FilterMultiSelect label="Status" options={STATUS_OPTIONS} value={list.getList('status')}
56
+ onChange={next => list.setList('status', next)} />
57
+ <FilterDateRange label="Created" from={list.values.createdFrom} to={list.values.createdTo}
58
+ onFromChange={value => list.setValue('createdFrom', value)} onToChange={value => list.setValue('createdTo', value)} />
59
+ </FilterPanel>
60
+ }
61
+ activeFilterCount={list.activeFilterCount}
62
+ onClearFilters={list.clear}
63
+ viewToggle={<EntityListViewToggle displayMode={displayMode} onDisplayModeChange={setDisplayMode} />}
64
+ bulkBar={bulkBar}
65
+ />
66
+ ```
67
+
68
+ - `FilterSelect`: `''` = All (`allLabel`), searchable automatically from 10 options (`searchable` to force).
69
+ - Yes / No filters: `options={YES_NO_FILTER_OPTIONS}` (`'1'` / `'0'`).
70
+ - Body: `isSearchActive={list.isActive}` and `onClearSearch={list.clear}` on `EntityListBody`.
71
+ - A view that owns its data and states (a tree with its own query): `EntityListBody.renderOwnView(mode)`, drawn in the
72
+ card as is. While an own view is shown the host omits search, filters and clear from the toolbar.
73
+ - Search modes (e.g. an AI search next to the text search): the mode switch goes in `search.leading` (it replaces the
74
+ magnifier at the same spot, ≤ 24 px), Enter / Escape in `search.onKeyDown`. Never lay a control over the field from
75
+ outside.
76
+
77
+ ## 3. Page toolbar (header actions)
78
+
79
+ Order: outline secondaries → `ExportButton` → `MoreActionsMenu` (rare / maintenance) → **one** primary
80
+ `AddEntityButton` ("Add <Entity>", singular, top right; `label` replaces the whole text when an entity name does not
81
+ fit, already translated). Every write control `disabled={!writesAllowed}`.
82
+
83
+ ```tsx
84
+ <EntityListPage
85
+ title="Projects"
86
+ headerActions={
87
+ <PageToolbar
88
+ exportAction={<ExportButton onExport={handleExport} disabled={!writesAllowed} />}
89
+ moreActions={[{ id: 'recalc', label: 'Recalculate totals', icon: <RefreshCw />, onSelect: handleRecalc,
90
+ disabled: !writesAllowed }]}
91
+ primaryAction={<AddEntityButton entity="Project" href="/projects/create" linkComponent={Link}
92
+ disabled={!writesAllowed} />}
93
+ >
94
+ <Button variant="outline" onClick={openImport}>Import</Button>
95
+ </PageToolbar>
96
+ }
97
+ toolbar={…}
98
+ >
99
+ ```
100
+
101
+ `ExportButton` label defaults to "Export to Excel"; a returned promise shows the spinner.
102
+
103
+ ## 4. Selection and bulk actions
104
+
105
+ ```tsx
106
+ const selection = useRowSelection({
107
+ items: list.items, // useGrowingWindowList().items
108
+ getKey: task => toNumericId(task.id), // a host helper
109
+ resetKey: filterString ?? '', // new filters → empty selection
110
+ disabled: busy,
111
+ });
112
+
113
+ const handleBulkDelete = async () => {
114
+ if (!writesAllowed || !(await confirm({ title: `Delete ${selection.count} task(s)?`, confirmVariant: 'destructive',
115
+ confirmLabel: 'Delete' }))) return;
116
+ setBusy(true);
117
+ await runSequentialWithSummary(selection.selectedKeys, id => deleteTask({ taskId: id }).unwrap(),
118
+ { progress: 'Deleting', done: 'Deleted', noun: 'task' });
119
+ setBusy(false);
120
+ selection.clear();
121
+ };
122
+
123
+ const bulkBar = (
124
+ <EntityListBulkBar
125
+ selection={selection}
126
+ actions={[{ id: 'recreate', label: 'Recreate', icon: <RotateCcw />, onClick: handleBulkRecreate }]}
127
+ onDelete={handleBulkDelete}
128
+ disabled={!writesAllowed}
129
+ busy={busy}
130
+ />
131
+ );
132
+
133
+ <EntityListBody … selection={selection} />
134
+ ```
135
+
136
+ Never a hand-made checkbox column, never `Promise.all` for bulk writes. A job that needs a result summary or a typed
137
+ confirmation uses the host's dialogs.
138
+
139
+ ## 5. Columns and cells
140
+
141
+ Order: [select] → image → **ID** → name (link) → relations → type / attributes → **Status** → flags → Start / End →
142
+ **Created / Updated** → **Actions**. Title Case headers. Every table with a detail route sets `rowAction`.
143
+
144
+ ```tsx
145
+ const columns: EntityListColumn<Project>[] = [
146
+ { id: 'image', header: 'Image', cell: c => <ImageCell src={mediaSizedUrl(c.coverImage?.publicUrl, 'SMALL')} alt="" />,
147
+ className: 'w-16' },
148
+ { id: 'id', header: 'ID', cell: c => <IdCell id={c.id} copyable />, className: 'w-20' },
149
+ { id: 'name', header: 'Name', cell: c => <Link href={projectRoute(c.id)} className="font-medium hover:underline">
150
+ {c.name}</Link> },
151
+ { id: 'workspace', header: 'Workspace', cell: c => orEmpty(c.workspace?.name) },
152
+ { id: 'status', header: 'Status', cell: c => <StatusBadge value={c.status} map={PROJECT_STATUS} /> },
153
+ { id: 'archived', header: 'Archived', cell: c => <BooleanCell value={c.archived} /> },
154
+ { id: 'start', header: 'Start', cell: c => <DateCell value={c.startDate} format="date" /> },
155
+ { id: 'created', header: 'Created', cell: c => <DateCell value={c.changeHistory?.createdTime} /> },
156
+ { id: 'updated', header: 'Updated', cell: c => <DateCell value={c.changeHistory?.modifiedTime} /> },
157
+ { id: 'actions', header: <span className="sr-only">Actions</span>, className: 'w-24 text-right', cell: c => (
158
+ <div className="flex justify-end gap-1">
159
+ <Button variant="ghost" size="icon-sm" aria-label={`Edit ${c.name}`} …><Pencil /></Button>
160
+ <Button variant="ghost" size="icon-sm" aria-label={`Delete ${c.name}`} className="text-destructive"
161
+ disabled={!writesAllowed} …><Trash2 /></Button>
162
+ </div>
163
+ ) },
164
+ ];
165
+ ```
166
+
167
+ - Empty = `<EmptyValue />` / `orEmpty(value)` → `—`. Never `-`, `N/A`, `''` or a local `Muted`.
168
+ - Dates: `DateCell` in tables, `formatDateTime` / `formatDate` in text. Never raw strings, never
169
+ `toLocaleString()`, never `new Date(value)`.
170
+ - Numbers and ids: the host's formatters (one per kind), never ad-hoc `toFixed` calls.
171
+ - Copy next to a value outside the ID column: a copy button on `useCopyToClipboard`.
172
+
173
+ ### Wide tables: tracks, pins, sort, row index
174
+
175
+ All optional; a table that uses none of them keeps the content-sized layout.
176
+
177
+ ```tsx
178
+ const [sort, setSort] = useState<EntityListSort | null>(() => parseListSort(list.values.sort, ['name', 'created']));
179
+ // or in the URL list state: list.setValue('sort', formatListSort(next))
180
+
181
+ const columns: EntityListColumn<Project>[] = [
182
+ { id: 'id', header: 'ID', cell: c => <IdCell id={c.id} />, width: '96px', pin: 'start', sortKey: 'id' },
183
+ { id: 'name', header: 'Name', cell: c => c.name, width: '2fr', minWidth: 200, sortKey: 'name' },
184
+ { id: 'owner', header: 'Owner', cell: c => orEmpty(c.owner?.name), width: '1fr' },
185
+ { id: 'created', header: 'Created', cell: c => <DateCell value={c.changeHistory?.createdTime} />, width: '160px',
186
+ sortKey: 'created' },
187
+ { id: 'actions', header: <span className="sr-only">Actions</span>, cell: c => <RowActions project={c} />,
188
+ width: '96px', pin: 'end', align: 'end' },
189
+ ];
190
+
191
+ <EntityListBody … columns={columns} sort={sort} onSortChange={setSort} showRowIndex selection={selection} />
192
+ ```
193
+
194
+ - **Tracks.** One column with `width` gives every column a track (default `1fr`): share columns (`'2fr'`) divide the
195
+ free width and never go below `minWidth` (default 120 px), fixed columns (`'120px'`) keep their length. When the
196
+ minimums exceed the visible width the table scrolls sideways inside its card; the page never does. In a table with
197
+ tracks a width class in `className` does not size the column, and cell text wraps inside its track.
198
+ - **Pins.** `pin: 'end'` always holds (a row's actions). `pin: 'start'` is a request: honoured only while the table
199
+ overflows (by 120 px or more) and the pinned columns take less than a third of the visible width; otherwise the column
200
+ scrolls like the others. The selection column and the row index always pin in a table that uses tracks, pins or the
201
+ row index. A pinned cell paints the card surface and its edge only while content scrolls under it.
202
+ - **Sort.** `sortKey` makes the header a button (with `aria-sort` on the sorted header); a click moves the sort on: not
203
+ sorted → ascending → descending → not sorted (`null`: the request's default order). The table never sorts rows
204
+ itself; the screen maps the key to its request. One sort at a time; keep it in the URL list state as one value
205
+ (`formatListSort` / `parseListSort`, `key:asc`).
206
+ - **Row index.** `showRowIndex`: a leading `#` column, 1-based among the loaded rows.
207
+ - `align: 'center' | 'end'` aligns header and cells (numbers and actions `end`).
208
+
209
+ ## 6. Status badges
210
+
211
+ One family map per enum, defined once in the host with `defineStatusMap` (e.g. `PROJECT_STATUS`, `SYNC_STATUS` +
212
+ a `syncStatusOf` mapper for a boolean). A new enum gets a map there.
213
+
214
+ ```tsx
215
+ <StatusBadge value={task.status} map={TASK_STATUS} />
216
+ <StatusBadge value={syncStatusOf(job.succeeded)} map={SYNC_STATUS} />
217
+ <StatusBadge tone="highlight" label="Featured" icon={Zap} /> // one-off flag
218
+ ```
219
+
220
+ A word that means something else elsewhere (`Failed`, `Open`) gets a translation context, on the map or on one
221
+ definition (the definition's wins), and every label is marked with the same context so text exports find the key:
222
+
223
+ ```tsx
224
+ const IMPORT_STATUS = defineStatusMap(
225
+ { FAILED: { label: m('Failed', { context: 'import-status' }), tone: 'danger', icon: CircleX }, … },
226
+ { context: 'import-status' },
227
+ );
228
+ ```
229
+
230
+ Tones: `neutral` not started / inactive · `info` finished / informational · `success` running / active / done ·
231
+ `warning` paused / pending / needs action · `danger` failed / cancelled · `highlight` featured flag · `brand` identity.
232
+ Always with an icon.
233
+
234
+ ## 7. Multi-select inputs
235
+
236
+ - Filters: `FilterMultiSelect` (above).
237
+ - Forms (roles, teams, languages): `MultiSelect` inside `FormField`; a short fixed set (≤ ~8, fully visible):
238
+ `ChipToggleGroup`.
239
+
240
+ ```tsx
241
+ <FormField name="roles" label="Roles">
242
+ {({ field, control, disabled }) => (
243
+ <MultiSelect id={control.id} options={ROLE_OPTIONS} value={field.value} onChange={field.onChange}
244
+ aria-label="Roles" maxChips={Infinity} disabled={disabled} />
245
+ )}
246
+ </FormField>
247
+
248
+ <ChipToggleGroup aria-label="Supported Languages" options={localeOptions} value={value} onChange={onChange} />
249
+ <ChipToggleGroup mode="single" aria-label="Interval" options={INTERVALS} value={interval} onChange={setInterval} />
250
+ ```
251
+
252
+ Single searchable select (not a filter): `Combobox`.
253
+
254
+ ## 8. Detail screens — `EntityDetailShell`
255
+
256
+ Every entity detail uses the shell: back + centred title + description + actions, `EntityMetadata` (ID, Created,
257
+ Updated), centred segmented route tabs, loading and error. Full width (§ 10); the header is `DetailHeader`, `nested`
258
+ inside another shell.
259
+
260
+ ```tsx
261
+ export const ProjectShell = ({ projectId, children }: ProjectShellProps) => {
262
+ const pathname = usePathname();
263
+ const query = useProjectQuery(projectId);
264
+ const project = query.data?.project;
265
+ return (
266
+ <EntityDetailShell
267
+ title={project?.name}
268
+ fallbackTitle={`Project #${projectId}`}
269
+ description={project?.workspace?.name}
270
+ back={{ href: '/projects', label: 'Back to projects' }}
271
+ linkComponent={Link}
272
+ metadata={{ id: project?.id, changeHistory: project?.changeHistory }}
273
+ tabs={PROJECT_TABS.map(tab => ({ id: tab.segment, label: tab.label, href: projectRoute(projectId, tab.segment) }))}
274
+ currentPath={pathname}
275
+ tabsLabel="Project sections"
276
+ isLoading={query.isLoading}
277
+ error={!query.isLoading && !project ? (query.isError ? 'This project could not be loaded.' : 'Project not found.') : undefined}
278
+ actions={<PageToolbar moreActions={…} />}
279
+ >
280
+ {children}
281
+ </EntityDetailShell>
282
+ );
283
+ };
284
+ ```
285
+
286
+ Inside a tab:
287
+
288
+ ```tsx
289
+ <SectionHeader title="Members" description="People working on this project"
290
+ tabs={[{ id: 'people', label: 'People' }, { id: 'teams', label: 'Teams' }]}
291
+ activeTab={tab} onTabSelect={setTab} actions={<ExportButton onExport={exportMembers} />} />
292
+
293
+ <Card><CardContent>
294
+ <DefinitionList columns={3} items={[
295
+ { label: 'Access Code', value: workspace.accessCode },
296
+ { label: 'Start', value: <DateCell value={workspace.startDate} format="date" /> },
297
+ { label: 'Description', value: workspace.description, wide: true },
298
+ ]} />
299
+ </CardContent></Card>
300
+ ```
301
+
302
+ Create screens: no `metadata` id yet → the strip renders nothing. Edit screens outside a shell keep
303
+ `<EntityMetadata id={…} changeHistory={…} />` right under their `FormHeader`.
304
+
305
+ ## 9. Host-specific shared components
306
+
307
+ Host-specific shared components (the markdown editor passed to `FormTranslatableMarkdown` as `renderEditor`, a
308
+ colour input, copy buttons, dialogs, number / id formatters) are documented by the host; the blocks take them as props
309
+ or render slots and never import them.
310
+
311
+ ## 10. Clouds look — surfaces, tabs, titles, read-first cards
312
+
313
+ The look lives in the blocks; a screen never re-draws it.
314
+
315
+ - **No main panel.** Page titles and toolbars sit on the cloud background; content goes into cards. Never wrap a page
316
+ in a big white box, never hand-draw `rounded-xl border bg-card` — use `Card` (primitives), `FormSection`,
317
+ `EditableCard` or, for a custom frame (a chat column, a map), the `.surface rounded-2xl` classes.
318
+ - **Surfaces** are translucent (88 %) with a 12 px blur and the soft three-layer shadow, no border. Nested surfaces
319
+ drop the blur by themselves. Menus, popovers, dialogs and sheets stay opaque.
320
+ - **Widths and inset** come from the shell: every page is full width at the one page inset
321
+ (`PAGE_INSET_CLASS`, shared by the shell column, `PageFrame` and `EntityListPage`); only a one-column `FormWrapper`
322
+ (narrow) stays `max-w-2xl` — its `FormHeader` sits outside the wrapper. Never add a page-level `max-w-*`, never a
323
+ hand-made `data-page-frame` / `--app-gap` frame (use `PageFrame`).
324
+ - **Headers**: `PageHeader` (lists, dashboards, maintenance, frames) or `DetailHeader` (via `EntityDetailShell` /
325
+ `FormHeader`: details and form pages). Inside another entity's shell pass `nested` (an `h2`). Never a raw `h1`.
326
+ - **List cards**: every list — page or detail tab — is an `EntityListCard` (`label`, `toolbar`, body); never a
327
+ `section.surface` with a hand-made toolbar row. Header → card gap comes from `SectionHeader` (never `className="mb-0"`
328
+ in a `space-y-*` stack: it removes the gap).
329
+ - **Tabs** are the segmented pill control: `EntityDetailShell` centres them under the centred title; standalone tab
330
+ bars use `EntityTabs` as is; sub-tabs of a section are `SectionHeader tabs`
331
+ (compact). Never a hand-made underline or pill bar.
332
+ - **Two-tone titles**: wrap the brand part in `<em>` — `title={<>Item <em>Types</em></>}` (pass `label="Item Types"` to
333
+ `EntityListPage` then). Only where a title earns it (Home, section headers), not on every list.
334
+ - **Sticky glass bars**: page forms get them from `FormActions` (`sticky={false}` inside a dialog); the bulk bar from
335
+ `EntityListBulkBar`.
336
+
337
+ ```tsx
338
+ <PageSections>
339
+ <section>
340
+ <SectionHeader title={<>General <em>settings</em></>} />
341
+ <CardGrid>
342
+ <EditableCard title="Access" onEdit={openAccessForm} editLabel="Edit access" editDisabled={!writesAllowed}>
343
+ <IconValueRow>
344
+ <IconValue icon={<KeyRound />}>{workspace.accessCode ?? <EmptyValue />}</IconValue>
345
+ <IconValue icon={<Calendar />}><DateCell value={workspace.startDate} format="date" /></IconValue>
346
+ </IconValueRow>
347
+ </EditableCard>
348
+ <EditableCard title="Languages" onEdit={openLanguagesForm} editLabel="Edit languages" editDisabled={!writesAllowed}>
349
+ <div className="flex flex-wrap gap-2">
350
+ {locales.map(locale => <Tag key={locale} tone={locale === defaultLocale ? 'primary' : 'default'}>{locale}</Tag>)}
351
+ </div>
352
+ </EditableCard>
353
+ </CardGrid>
354
+ </section>
355
+ </PageSections>
356
+ ```
357
+
358
+ ## 11. Glass tone — quick filters, collapsible cards, group panels
359
+
360
+ Blocks in `glass/`.
361
+
362
+ ```tsx
363
+ // Status quick filters on the clouds: the same list key as the panel's Status field.
364
+ <EntityListPage
365
+ belowHeader={
366
+ <QuickFilterPills aria-label="Status quick filters" allLabel="All Statuses" options={STATUS_OPTIONS}
367
+ value={list.values.status} onChange={value => list.setValue('status', value)} />
368
+ }
369
+ …
370
+ />
371
+ // multi: mode="multi" value={list.getList('status')} onChange={next => list.setList('status', next)}
372
+
373
+ // A collapsible group inside a form card (fields stay mounted unless `forceMount={false}`).
374
+ <CollapsibleCard density="compact" defaultOpen={false} title="Primary" description="Buttons, links…"
375
+ meta={<span className="size-6 rounded-md border" style={{ backgroundColor: preview }} />}>
376
+ …fields…
377
+ </CollapsibleCard>
378
+
379
+ // A grouped to-do list on the clouds: glass group (no shadow) + solid rows.
380
+ <GlassGroup title="Running" count={cards.length} limit={8} emptyText="No tasks">
381
+ {cards.map(card => (
382
+ <Link key={card.id} href={…}><ActionRow as="span" interactive title={card.name} description={card.context}
383
+ tone={TASK_STATUS[card.status].tone} toneLabel={TASK_STATUS[card.status].label} /></Link>
384
+ ))}
385
+ </GlassGroup>
386
+ ```
387
+
388
+ - Never invent counts for pills; pass `count` only when the screen already has it.
389
+ - A glass container (`GlassGroup`, glass `CollapsibleCard`) casts no shadow; its solid rows do.
390
+ - Status inside rows and tables stays `StatusBadge`; the `ActionRow` dot is labelled (`toneLabel`).
391
+
392
+ ## 12. Side drawers — `useEntityDrawer` + `FormDrawer`
393
+
394
+ **Drawer** when all hold: no own tabs or sub-lists · ≤ ~15 fields · edited from its list · no large working surface
395
+ (map, conversation, preview + send). **Page** otherwise. Entities with a drawer also create in it (the list's Add
396
+ button).
397
+
398
+ ```tsx
399
+ // The list screen (inside <Suspense>): drawer state in the URL next to the filters — `?edit=<id>` / `?create=1`.
400
+ const drawer = useEntityDrawer({ adapter: useNextDrawerUrlAdapter() }); // ./next, or the host's own adapter
401
+
402
+ <AddEntityButton entity="Supplier" onClick={drawer.openCreate} disabled={!writesAllowed} />
403
+ rowAction={supplier => () => drawer.openEdit(id)}
404
+ <Link href={supplierEditRoute(id)} onClick={drawer.editLinkClick(id)}>{supplier.name}</Link> // middle click = new tab
405
+ <SupplierFormDrawer drawer={drawer} />
406
+
407
+ // The module's drawer: loads the entity for the header, renders the existing form inside.
408
+ const shown = drawer.shown; // stays set while the close animation runs
409
+ const id = shown?.mode === 'edit' ? shown.id : undefined;
410
+ const query = useGet…Query({ …, id: id ?? '' }, { skip: id === undefined });
411
+ const entity = id ? (query.currentData?.supplier ?? null) : null; // currentData: never the previous row's
412
+ <FormDrawer open={drawer.isOpen} onClose={drawer.close} title={entity?.name ?? `Supplier #${id}`}
413
+ metadata={entity ? { id: entity.id, changeHistory: entity.changeHistory } : undefined}>
414
+ <SupplierForm key={drawerKey(shown)} supplier={entity} onClose={drawer.close} />
415
+ </FormDrawer>
416
+ ```
417
+
418
+ - **One form, no copy.** The page form takes `onClose` instead of routing: Cancel = `confirmDiscard()` then
419
+ `onClose()`; a save resets the form's baseline (`form.reset(values, { keepValues: true })`), toasts and calls
420
+ `onClose()`. `FormActions` moves into the drawer's pinned footer by itself (change status left, buttons right); the
421
+ ✕, Esc and an overlay click ask "Discard changes?" through `useUnsavedChangesGuard`. Request bodies stay as they are.
422
+ - **Header**: entity title + `EntityMetadata variant="inline"` (ID · Created · Updated, one line) via `metadata`;
423
+ create passes a `description` instead. Entity actions that are no save (e.g. "Open as customer", "Reset password")
424
+ go into `headerActions` (outline `sm` buttons at the right end of the header); the save stays in the footer.
425
+ - **History**: opening pushes an entry (Back closes the drawer); `close()` pops it when this page opened the drawer and
426
+ removes the parameter otherwise (a link, a reload). A create that turns into the new entity's edit uses
427
+ `openEdit(newId, { replace: true })`. The writes are shallow (`history.pushState`): the list stays mounted.
428
+ - **Detail routes** (`/<entity>/:id`, `/create`) can stay as redirects to the list with the parameter. Route helpers
429
+ (`supplierEditRoute`) live in a non-client file (a server page calls them).
430
+ - A list hosting two drawers passes its own `editKey` / `createKey`.
431
+ - **Confirm**: the drawer asks through the package dialog; a host with its own confirmation service passes
432
+ `confirm={hostConfirm}` (stable function, same Radix copy). The same prop exists on the translatable fields.
433
+ - One column inside the drawer (≤ 760 px): no `md:grid-cols-2` form grids.