@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
@@ -0,0 +1,353 @@
1
+ #!/usr/bin/env node
2
+ // Checks the contrast of the colour pairs that tokens.json declares (`contrast.pairs`: a text or UI role on a
3
+ // background role) in a host's built stylesheet, light (`:root`) and dark (`.dark`), against WCAG 2.x: 4.5:1 for text,
4
+ // 3:1 for large text and UI parts (the pair's `minimum`). A pair below its minimum fails unless `contrast.exceptions`
5
+ // lists it (for that theme or for both) with a reason.
6
+ //
7
+ // Values: the role property `--<role>` (or Tailwind's `--color-<role>`) of the scope, `var()` references resolved in the
8
+ // same scope (the dark scope falls back to `:root`). Understood: hex, rgb()/rgba(), hsl()/hsla(), hwb(), oklab(),
9
+ // oklch(), `transparent`, `white`, `black`, and channel triplets (`0 0% 100%`) when the stylesheet reads the role inside
10
+ // a channel function (`hsl(var(--card))`, `rgb(…)`, `oklch(…)`). Anything else (named colours, color-mix(), lab(),
11
+ // lch(), color(), light-dark(), calc()) is reported as "cannot evaluate" and counts as a failure, never as a pass;
12
+ // `--allow-unevaluated` turns those into warnings.
13
+ //
14
+ // A background may name an alpha (`"success/15"`): the role at that alpha over `base` (default `card`), as the status
15
+ // badges draw it. A translucent foreground is composited over the background; a translucent background over the
16
+ // theme's `background` role.
17
+ //
18
+ // Host exceptions: `--exceptions <file.json>` adds a host's written exceptions to the package's (`contrast.exceptions`
19
+ // of tokens.json). The file holds the same entries, as an array or as `{ "exceptions": [...] }`:
20
+ // { "foreground": "<role>", "background": "<role or role/NN>", "theme": "light" | "dark" (optional: both),
21
+ // "reason": "<why this pair may stay below its minimum>" }
22
+ //
23
+ // Usage: node check-contrast.mjs <built.css | directory of .css files> [tokens.json] [--exceptions <file.json>]
24
+ // [--allow-unevaluated]
25
+ // Exit 0 when every declared pair passes (or is excepted); 1 with one line per failing pair; 2 on bad arguments.
26
+
27
+ import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
28
+ import { dirname, join, resolve } from 'node:path';
29
+ import { fileURLToPath } from 'node:url';
30
+
31
+ const USAGE =
32
+ 'usage: node check-contrast.mjs <built.css | directory of .css files> [tokens.json] [--exceptions <file.json>] [--allow-unevaluated]';
33
+ const args = process.argv.slice(2);
34
+ const allowUnevaluated = args.includes('--allow-unevaluated');
35
+ const exceptionsFlag = args.indexOf('--exceptions');
36
+ const hostExceptionsArg = exceptionsFlag === -1 ? undefined : args[exceptionsFlag + 1];
37
+ if (exceptionsFlag !== -1 && (!hostExceptionsArg || hostExceptionsArg.startsWith('--'))) {
38
+ console.error(`--exceptions needs a file\n${USAGE}`);
39
+ process.exit(2);
40
+ }
41
+ const [cssArg, tokensArg] = args.filter((arg, index) => !arg.startsWith('--') && (exceptionsFlag === -1 || index !== exceptionsFlag + 1));
42
+ if (!cssArg) {
43
+ console.error(USAGE);
44
+ process.exit(2);
45
+ }
46
+ const tokensPath = resolve(tokensArg ?? join(dirname(fileURLToPath(import.meta.url)), '..', 'tokens.json'));
47
+ const cssPath = resolve(cssArg);
48
+ if (!existsSync(cssPath) || !existsSync(tokensPath)) {
49
+ console.error(`not found: ${existsSync(cssPath) ? tokensPath : cssPath}`);
50
+ process.exit(2);
51
+ }
52
+ const tokens = JSON.parse(readFileSync(tokensPath, 'utf8'));
53
+ const pairs = tokens.contrast?.pairs ?? [];
54
+ /** A host's exception file: an array, or an object with `exceptions` (or `contrast.exceptions`); every entry checked. */
55
+ const readHostExceptions = file => {
56
+ const path = resolve(file);
57
+ if (!existsSync(path)) {
58
+ console.error(`not found: ${path}`);
59
+ process.exit(2);
60
+ }
61
+ let parsed;
62
+ try {
63
+ parsed = JSON.parse(readFileSync(path, 'utf8'));
64
+ } catch (error) {
65
+ console.error(`${path}: not JSON (${error instanceof Error ? error.message : error})`);
66
+ process.exit(2);
67
+ }
68
+ const list = Array.isArray(parsed) ? parsed : (parsed?.exceptions ?? parsed?.contrast?.exceptions);
69
+ const valid = item =>
70
+ item &&
71
+ typeof item.foreground === 'string' &&
72
+ typeof item.background === 'string' &&
73
+ typeof item.reason === 'string' &&
74
+ item.reason.trim() !== '' &&
75
+ (item.theme === undefined || item.theme === 'light' || item.theme === 'dark');
76
+ if (!Array.isArray(list) || !list.every(valid)) {
77
+ console.error(`${path}: expected an array of { foreground, background, theme?: "light" | "dark", reason } (or { "exceptions": [...] })`);
78
+ process.exit(2);
79
+ }
80
+ return list;
81
+ };
82
+ const exceptions = [...(tokens.contrast?.exceptions ?? []), ...(hostExceptionsArg ? readHostExceptions(hostExceptionsArg) : [])];
83
+ if (pairs.length === 0) {
84
+ console.error(`no contrast.pairs in ${tokensPath}`);
85
+ process.exit(2);
86
+ }
87
+
88
+ const cssFiles = statSync(cssPath).isDirectory()
89
+ ? readdirSync(cssPath)
90
+ .filter(name => name.endsWith('.css'))
91
+ .map(name => join(cssPath, name))
92
+ : [cssPath];
93
+
94
+ /** Style rules as `{ selector, declarations: Map<property, value> }`, at any nesting depth (as in check-tokens). */
95
+ const parseRules = source => {
96
+ const text = source.replace(/\/\*[\s\S]*?\*\//g, '');
97
+ const rules = [];
98
+ const stack = [];
99
+ let buffer = '';
100
+ let quote = null;
101
+ for (let index = 0; index < text.length; index += 1) {
102
+ const char = text[index];
103
+ if (quote) {
104
+ buffer += char;
105
+ if (char === '\\') {
106
+ buffer += text[index + 1] ?? '';
107
+ index += 1;
108
+ } else if (char === quote) quote = null;
109
+ continue;
110
+ }
111
+ if (char === '\\') {
112
+ buffer += char + (text[index + 1] ?? '');
113
+ index += 1;
114
+ continue;
115
+ }
116
+ if (char === '"' || char === "'") {
117
+ quote = char;
118
+ buffer += char;
119
+ continue;
120
+ }
121
+ if (char === '{') {
122
+ const prelude = buffer.trim();
123
+ buffer = '';
124
+ const rule = prelude.startsWith('@') ? null : { selector: prelude, declarations: new Map() };
125
+ if (rule) rules.push(rule);
126
+ stack.push(rule);
127
+ continue;
128
+ }
129
+ if (char === ';' || char === '}') {
130
+ const current = stack[stack.length - 1];
131
+ const chunk = buffer.trim();
132
+ buffer = '';
133
+ if (current && chunk.includes(':')) {
134
+ const colon = chunk.indexOf(':');
135
+ current.declarations.set(chunk.slice(0, colon).trim(), chunk.slice(colon + 1).trim());
136
+ }
137
+ if (char === '}') stack.pop();
138
+ continue;
139
+ }
140
+ buffer += char;
141
+ }
142
+ return rules;
143
+ };
144
+
145
+ const rules = cssFiles.flatMap(file => parseRules(readFileSync(file, 'utf8')));
146
+ const selectorParts = rule => rule.selector.split(',').map(part => part.trim());
147
+ const isRootSelector = part => /^(:root|html|:host|:where\(:root\))$/.test(part);
148
+ const isDarkSelector = part => /^(:root|html)?\.dark$/.test(part);
149
+
150
+ /** Custom properties per scope; the later declaration wins, as in the cascade of equal specificity. */
151
+ const scopeOf = predicate => {
152
+ const scope = new Map();
153
+ for (const rule of rules) {
154
+ if (!selectorParts(rule).some(predicate)) continue;
155
+ for (const [property, value] of rule.declarations) {
156
+ if (property.startsWith('--')) scope.set(property, value.replace(/\s*!important\s*$/, '').trim());
157
+ }
158
+ }
159
+ return scope;
160
+ };
161
+ const rootScope = scopeOf(isRootSelector);
162
+ const darkOwn = scopeOf(isDarkSelector);
163
+ const darkScope = new Map([...rootScope, ...darkOwn]);
164
+
165
+ /** How the stylesheet reads a role's channels when it holds a triplet: the channel function around `var(--role)`. */
166
+ const channelFunctionOf = property => {
167
+ const pattern = new RegExp(`\\b(rgba?|hsla?|hwb|oklab|oklch)\\(\\s*var\\(\\s*${property.replace(/[-]/g, '\\-')}\\s*[,)]`, 'i');
168
+ for (const rule of rules) for (const value of rule.declarations.values()) {
169
+ const match = pattern.exec(value);
170
+ if (match) return match[1].toLowerCase().replace(/a$/, '');
171
+ }
172
+ return null;
173
+ };
174
+
175
+ /** `var(--x)` / `var(--x, fallback)` replaced by the scope's values (depth-limited). */
176
+ const substitute = (value, scope, depth = 0) => {
177
+ if (depth > 10 || !value.includes('var(')) return value;
178
+ const replaced = value.replace(/var\(\s*(--[A-Za-z0-9_-]+)\s*(?:,\s*([^()]*(?:\([^()]*\)[^()]*)*))?\)/g, (whole, name, fallback) => {
179
+ if (scope.has(name)) return scope.get(name);
180
+ return fallback !== undefined ? fallback : whole;
181
+ });
182
+ return replaced === value ? value : substitute(replaced, scope, depth + 1);
183
+ };
184
+
185
+ const number = (text, scale = 1) => {
186
+ const trimmed = text.trim();
187
+ if (trimmed === 'none') return 0;
188
+ if (trimmed.endsWith('%')) return (Number.parseFloat(trimmed) / 100) * scale;
189
+ const value = Number.parseFloat(trimmed);
190
+ return Number.isFinite(value) ? value : Number.NaN;
191
+ };
192
+ const angle = text => {
193
+ const trimmed = text.trim();
194
+ const value = Number.parseFloat(trimmed);
195
+ if (trimmed.endsWith('turn')) return value * 360;
196
+ if (trimmed.endsWith('grad')) return value * 0.9;
197
+ if (trimmed.endsWith('rad')) return (value * 180) / Math.PI;
198
+ return value;
199
+ };
200
+ /** Arguments of a colour function: channels and an optional alpha (space or comma syntax). */
201
+ const splitArgs = inner => {
202
+ const [main, alphaPart] = inner.includes('/') ? inner.split('/') : [inner, undefined];
203
+ const parts = main.trim().split(/\s*,\s*|\s+/).filter(Boolean);
204
+ let alpha = alphaPart !== undefined ? number(alphaPart, 1) : 1;
205
+ if (alphaPart === undefined && parts.length === 4) alpha = number(parts.pop(), 1);
206
+ return { parts, alpha };
207
+ };
208
+
209
+ const hslToRgb = (h, s, l) => {
210
+ const k = n => (n + h / 30) % 12;
211
+ const a = s * Math.min(l, 1 - l);
212
+ const f = n => l - a * Math.max(-1, Math.min(k(n) - 3, 9 - k(n), 1));
213
+ return [f(0), f(8), f(4)];
214
+ };
215
+ const oklabToRgb = (L, a, b) => {
216
+ const l = (L + 0.3963377774 * a + 0.2158037573 * b) ** 3;
217
+ const m = (L - 0.1055613458 * a - 0.0638541728 * b) ** 3;
218
+ const s = (L - 0.0894841775 * a - 1.291485548 * b) ** 3;
219
+ const linear = [
220
+ 4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s,
221
+ -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s,
222
+ -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s,
223
+ ];
224
+ // linear sRGB → gamma-encoded sRGB, clamped into the gamut
225
+ return linear.map(channel => {
226
+ const clamped = Math.min(1, Math.max(0, channel));
227
+ return clamped <= 0.0031308 ? 12.92 * clamped : 1.055 * clamped ** (1 / 2.4) - 0.055;
228
+ });
229
+ };
230
+
231
+ /** A colour as `{ rgb: [0..1 ×3], alpha }`, or `null` when it cannot be evaluated. */
232
+ const parseColour = (raw, channelFunction) => {
233
+ const value = raw.trim().toLowerCase();
234
+ if (value === 'transparent') return { rgb: [0, 0, 0], alpha: 0 };
235
+ if (value === 'white') return { rgb: [1, 1, 1], alpha: 1 };
236
+ if (value === 'black') return { rgb: [0, 0, 0], alpha: 1 };
237
+ const hex = /^#([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/.exec(value);
238
+ if (hex) {
239
+ let digits = hex[1];
240
+ if (digits.length <= 4) digits = [...digits].map(digit => digit + digit).join('');
241
+ const channels = digits.match(/../g).map(pair => Number.parseInt(pair, 16) / 255);
242
+ return { rgb: channels.slice(0, 3), alpha: channels[3] ?? 1 };
243
+ }
244
+ let fn;
245
+ let inner;
246
+ const call = /^([a-z]+)\((.*)\)$/.exec(value);
247
+ if (call) {
248
+ fn = call[1].replace(/a$/, '');
249
+ inner = call[2];
250
+ } else if (
251
+ channelFunction &&
252
+ /^(?:[+-]?(?:\d+\.?\d*|\.\d+)(?:%|deg|rad|grad|turn)?|none)(?:\s*[\s,/]\s*(?:[+-]?(?:\d+\.?\d*|\.\d+)(?:%|deg|rad|grad|turn)?|none))*$/.test(value)
253
+ ) {
254
+ fn = channelFunction;
255
+ inner = value;
256
+ } else return null;
257
+ if (inner.includes('(')) return null; // calc(), nested var() left unresolved, …
258
+ const { parts, alpha } = splitArgs(inner);
259
+ if (parts.length !== 3 || Number.isNaN(alpha)) return null;
260
+ let rgb;
261
+ if (fn === 'rgb') rgb = parts.map(part => number(part, 255) / 255);
262
+ else if (fn === 'hsl') rgb = hslToRgb(angle(parts[0]), number(parts[1].endsWith('%') ? parts[1] : `${parts[1]}%`), number(parts[2].endsWith('%') ? parts[2] : `${parts[2]}%`));
263
+ else if (fn === 'hwb') {
264
+ const white = number(parts[1].endsWith('%') ? parts[1] : `${parts[1]}%`);
265
+ const black = number(parts[2].endsWith('%') ? parts[2] : `${parts[2]}%`);
266
+ const base = hslToRgb(angle(parts[0]), 1, 0.5);
267
+ rgb = white + black >= 1 ? [white / (white + black), white / (white + black), white / (white + black)] : base.map(channel => channel * (1 - white - black) + white);
268
+ } else if (fn === 'oklab') rgb = oklabToRgb(number(parts[0]), number(parts[1], 0.4), number(parts[2], 0.4));
269
+ else if (fn === 'oklch') {
270
+ const hue = (angle(parts[2]) * Math.PI) / 180;
271
+ const chroma = number(parts[1], 0.4);
272
+ rgb = oklabToRgb(number(parts[0]), chroma * Math.cos(hue), chroma * Math.sin(hue));
273
+ } else return null;
274
+ if (rgb.some(channel => Number.isNaN(channel))) return null;
275
+ return { rgb: rgb.map(channel => Math.min(1, Math.max(0, channel))), alpha: Math.min(1, Math.max(0, alpha)) };
276
+ };
277
+
278
+ const over = (top, bottom) => ({
279
+ rgb: top.rgb.map((channel, index) => channel * top.alpha + bottom.rgb[index] * (1 - top.alpha)),
280
+ alpha: 1,
281
+ });
282
+ const luminance = ({ rgb }) => {
283
+ const [r, g, b] = rgb.map(channel => (channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4));
284
+ return 0.2126 * r + 0.7152 * g + 0.0722 * b;
285
+ };
286
+ const ratioOf = (a, b) => {
287
+ const [light, dark] = [luminance(a), luminance(b)].sort((x, y) => y - x);
288
+ return (light + 0.05) / (dark + 0.05);
289
+ };
290
+
291
+ /** A role's colour in a scope: `{ colour }` or `{ problem }`. */
292
+ const roleColour = (role, scope) => {
293
+ const property = scope.has(`--${role}`) ? `--${role}` : scope.has(`--color-${role}`) ? `--color-${role}` : null;
294
+ if (!property) return { problem: `--${role} not declared` };
295
+ const resolved = substitute(scope.get(property), scope);
296
+ const colour = parseColour(resolved, channelFunctionOf(`--${role}`) ?? channelFunctionOf(`--color-${role}`));
297
+ return colour ? { colour } : { problem: `${property}: cannot evaluate "${resolved}"` };
298
+ };
299
+
300
+ /** `"success/15"` → the role at 15 % alpha. */
301
+ const parseRef = ref => {
302
+ const [role, alpha] = ref.split('/');
303
+ return { role, alpha: alpha === undefined ? 1 : Number(alpha) / 100 };
304
+ };
305
+
306
+ const themes = [{ name: 'light', scope: rootScope }];
307
+ if (darkOwn.size > 0) themes.push({ name: 'dark', scope: darkScope });
308
+
309
+ const exceptionFor = (pair, theme) =>
310
+ exceptions.find(
311
+ item => item.foreground === pair.foreground && item.background === pair.background && (!item.theme || item.theme === theme)
312
+ );
313
+
314
+ let failed = 0;
315
+ let unevaluated = 0;
316
+ for (const theme of themes) {
317
+ console.log(`${theme.name}:`);
318
+ const page = roleColour('background', theme.scope).colour ?? { rgb: [1, 1, 1], alpha: 1 };
319
+ for (const pair of pairs) {
320
+ const label = `${pair.foreground} on ${pair.background}${pair.base ? ` over ${pair.base}` : ''}`;
321
+ const minimum = pair.minimum ?? 4.5;
322
+ const fgRef = parseRef(pair.foreground);
323
+ const bgRef = parseRef(pair.background);
324
+ const fg = roleColour(fgRef.role, theme.scope);
325
+ const bg = roleColour(bgRef.role, theme.scope);
326
+ const base = bgRef.alpha < 1 ? roleColour(pair.base ?? 'card', theme.scope) : { colour: page };
327
+ const problem = fg.problem ?? bg.problem ?? base.problem;
328
+ if (problem) {
329
+ unevaluated += 1;
330
+ console.log(` ${allowUnevaluated ? 'warn ' : 'FAILED'} ${label}: ${problem}`);
331
+ continue;
332
+ }
333
+ const baseColour = base.colour.alpha < 1 ? over(base.colour, page) : base.colour;
334
+ const background = over({ rgb: bg.colour.rgb, alpha: bg.colour.alpha * bgRef.alpha }, baseColour);
335
+ const foreground = over({ rgb: fg.colour.rgb, alpha: fg.colour.alpha * fgRef.alpha }, background);
336
+ const ratio = ratioOf(foreground, background);
337
+ const passes = ratio + 1e-9 >= minimum;
338
+ const exception = passes ? undefined : exceptionFor(pair, theme.name);
339
+ const status = passes ? 'ok ' : exception ? 'except' : 'FAILED';
340
+ if (!passes && !exception) failed += 1;
341
+ console.log(
342
+ ` ${status} ${label}: ${ratio.toFixed(2)}:1 (needs ${minimum}:1${pair.use ? `, ${pair.use}` : ''})${exception ? ` — ${exception.reason}` : ''}`
343
+ );
344
+ }
345
+ }
346
+ if (darkOwn.size === 0) console.log('dark: no .dark declarations; only the light theme was checked');
347
+
348
+ const blocking = failed + (allowUnevaluated ? 0 : unevaluated);
349
+ if (blocking > 0) {
350
+ console.log(`check-contrast: ${failed} pair(s) below their minimum, ${unevaluated} not evaluated (${pairs.length} pairs, ${themes.length} theme(s))`);
351
+ process.exit(1);
352
+ }
353
+ console.log(`check-contrast: ok (${pairs.length} pairs, ${themes.length} theme(s)${unevaluated ? `, ${unevaluated} not evaluated` : ''})`);
@@ -0,0 +1,51 @@
1
+ import { type ReactNode } from 'react';
2
+ import type { NavigationIcon } from '../logic/pure/navigation.js';
3
+ /** One entry of the account menu: a link (`href`) or an action (`onSelect`). */
4
+ export interface AccountMenuEntry {
5
+ key: string;
6
+ /** UI text, translated when rendered. */
7
+ label: string;
8
+ icon?: NavigationIcon;
9
+ href?: string;
10
+ /** With `href`: a plain `<a>` (full page load, another application). */
11
+ external?: boolean;
12
+ onSelect?: () => void;
13
+ variant?: 'default' | 'destructive';
14
+ disabled?: boolean;
15
+ /** A separator before this entry. */
16
+ separatorBefore?: boolean;
17
+ }
18
+ export interface AccountMenuProps {
19
+ /** The signed-in account's name; absent while the session loads (then `fallback` shows, e.g. a bare sign-out). */
20
+ name?: string | null;
21
+ /** A second line under the name (account type, id); data, shown as given. */
22
+ description?: ReactNode;
23
+ /** Avatar image; without it the initials of `name` on the brand colour. */
24
+ avatarUrl?: string | null;
25
+ entries: readonly AccountMenuEntry[];
26
+ /** More menu content after the entries (`LanguageMenuSub`, a theme switch). */
27
+ children?: ReactNode;
28
+ /** Rendered instead of the menu without a `name`, so nobody is left without a way out. */
29
+ fallback?: ReactNode;
30
+ className?: string;
31
+ }
32
+ /** A round avatar: the image, else the initials of `name`. Decorative (the name is always next to it or in a label). */
33
+ export declare const AccountAvatar: ({ name, avatarUrl, className }: {
34
+ name: string;
35
+ avatarUrl?: string | null;
36
+ className?: string;
37
+ }) => import("react").JSX.Element;
38
+ /** Avatar, name and description in a row (the menu's header; a mobile menu footer). */
39
+ export declare const AccountSummary: ({ name, description, avatarUrl }: {
40
+ name: string;
41
+ description?: ReactNode;
42
+ avatarUrl?: string | null;
43
+ }) => import("react").JSX.Element;
44
+ /**
45
+ * The account corner of the top bar, fed by the host: a pill with the avatar and the name (the name hides on narrow
46
+ * screens; the button keeps "Account menu of …" as its name), a menu with the account summary, the host's entries
47
+ * (links through the host link, actions, separators, a destructive sign-out) and `children`. Without a name the
48
+ * `fallback` renders instead.
49
+ */
50
+ export declare const AccountMenu: ({ name, description, avatarUrl, entries, children, fallback, className }: AccountMenuProps) => import("react").JSX.Element;
51
+ //# sourceMappingURL=AccountMenu.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AccountMenu.d.ts","sourceRoot":"","sources":["../../src/shell/AccountMenu.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAYlE,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,kHAAkH;IAClH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD,wHAAwH;AACxH,eAAO,MAAM,aAAa,GAAI,gCAAgC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,gCAU5H,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,cAAc,GAAI,kCAAkC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,gCAQpI,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,0EAA0E,gBAAgB,gCAiDrH,CAAC"}
@@ -0,0 +1,34 @@
1
+ 'use client';
2
+ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
3
+ import { ChevronDown } from 'lucide-react';
4
+ import { Fragment } from 'react';
5
+ import { useTranslate } from "../i18n/useTranslate.js";
6
+ import { cn } from "../primitives/cn.js";
7
+ import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, } from "../primitives/dropdown-menu.js";
8
+ import { ShellNavLink } from "./ShellNavLink.js";
9
+ const initialsOf = (name) => {
10
+ const parts = name.split(/[\s@._-]+/).filter(Boolean);
11
+ const initials = parts.length > 1 ? `${parts[0]?.[0] ?? ''}${parts[1]?.[0] ?? ''}` : name.slice(0, 2);
12
+ return initials.toUpperCase();
13
+ };
14
+ /** A round avatar: the image, else the initials of `name`. Decorative (the name is always next to it or in a label). */
15
+ export const AccountAvatar = ({ name, avatarUrl, className }) => (_jsx("span", { "aria-hidden": true, className: cn('inline-flex size-8 shrink-0 items-center justify-center overflow-hidden rounded-full bg-brand-light text-xs font-semibold text-brand-ink', className), children: avatarUrl ? _jsx("img", { src: avatarUrl, alt: "", className: "size-full object-cover" }) : initialsOf(name) }));
16
+ /** Avatar, name and description in a row (the menu's header; a mobile menu footer). */
17
+ export const AccountSummary = ({ name, description, avatarUrl }) => (_jsxs("div", { className: "flex min-w-0 items-center gap-3", children: [_jsx(AccountAvatar, { name: name, avatarUrl: avatarUrl }), _jsxs("div", { className: "min-w-0", children: [_jsx("p", { className: "truncate text-sm font-semibold", children: name }), description && _jsx("p", { className: "truncate text-xs text-muted-foreground", children: description })] })] }));
18
+ /**
19
+ * The account corner of the top bar, fed by the host: a pill with the avatar and the name (the name hides on narrow
20
+ * screens; the button keeps "Account menu of …" as its name), a menu with the account summary, the host's entries
21
+ * (links through the host link, actions, separators, a destructive sign-out) and `children`. Without a name the
22
+ * `fallback` renders instead.
23
+ */
24
+ export const AccountMenu = ({ name, description, avatarUrl, entries, children, fallback, className }) => {
25
+ const { t } = useTranslate();
26
+ if (!name)
27
+ return _jsx(_Fragment, { children: fallback ?? null });
28
+ return (_jsxs(DropdownMenu, { children: [_jsxs(DropdownMenuTrigger, { "aria-label": t('Account menu of %name%', { replacements: { name } }), "data-shell-account-menu": "", className: cn('inline-flex h-10 shrink-0 items-center gap-2 rounded-full p-1 text-sm font-medium text-foreground transition-colors outline-none hover:bg-tint focus-visible:ring-2 focus-visible:ring-ring sm:pe-3', className), children: [_jsx(AccountAvatar, { name: name, avatarUrl: avatarUrl }), _jsx("span", { className: "hidden max-w-48 truncate sm:inline", children: name }), _jsx(ChevronDown, { "aria-hidden": true, className: "hidden size-4 text-muted-foreground sm:block" })] }), _jsxs(DropdownMenuContent, { align: "end", className: "w-72", children: [_jsx(DropdownMenuLabel, { className: "py-2 font-normal", children: _jsx(AccountSummary, { name: name, description: description, avatarUrl: avatarUrl }) }), _jsx(DropdownMenuSeparator, {}), entries.map(entry => {
29
+ const Icon = entry.icon;
30
+ const content = (_jsxs(_Fragment, { children: [Icon && _jsx(Icon, { "aria-hidden": true }), _jsx("span", { className: "min-w-0 truncate", children: t(entry.label) })] }));
31
+ return (_jsxs(Fragment, { children: [entry.separatorBefore && _jsx(DropdownMenuSeparator, {}), entry.href !== undefined ? (_jsx(DropdownMenuItem, { asChild: true, variant: entry.variant, disabled: entry.disabled, onSelect: entry.onSelect, children: _jsx(ShellNavLink, { item: { key: entry.key, href: entry.href, external: entry.external }, "data-nav-key": undefined, "data-account-entry": entry.key, children: content }) })) : (_jsx(DropdownMenuItem, { variant: entry.variant, disabled: entry.disabled, onSelect: entry.onSelect, "data-account-entry": entry.key, children: content }))] }, entry.key));
32
+ }), children] })] }));
33
+ };
34
+ //# sourceMappingURL=AccountMenu.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AccountMenu.js","sourceRoot":"","sources":["../../src/shell/AccountMenu.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,68 @@
1
+ import { type ReactNode } from 'react';
2
+ import { type NavigationAccess, type NavigationItem } from '../logic/pure/navigation.js';
3
+ import { type UseEntityLabel } from './shellContext.js';
4
+ import { type ShellDocumentTitleProps } from './ShellDocumentTitle.js';
5
+ export interface ShellNavigationProviderProps<TEntity extends string = string> {
6
+ /** The whole navigation tree. */
7
+ navigation: readonly NavigationItem<TEntity>[];
8
+ canAccess?: NavigationAccess;
9
+ useEntityLabel?: UseEntityLabel<TEntity>;
10
+ /** Overrides the provider's pathname hook. */
11
+ pathname?: string | null;
12
+ children: ReactNode;
13
+ }
14
+ /** The navigation context of `AppShell` without the shell: breadcrumbs and the document title in a host's own frame. */
15
+ export declare const ShellNavigationProvider: <TEntity extends string = string>({ navigation, canAccess, useEntityLabel, pathname, children, }: ShellNavigationProviderProps<TEntity>) => import("react").JSX.Element;
16
+ export interface AppShellProps<TEntity extends string = string> {
17
+ /** The ONE navigation tree: sidebar, mobile menu, breadcrumbs and document title read it. A stable value. */
18
+ navigation: readonly NavigationItem<TEntity>[];
19
+ /** The rights predicate: refused items leave the sidebar; their crumbs turn into text. A stable function. */
20
+ canAccess?: NavigationAccess;
21
+ /** Names entity crumbs (a hook passed by reference). */
22
+ useEntityLabel?: UseEntityLabel<TEntity>;
23
+ /** Overrides the provider's pathname hook (`AdminUiProvider.usePathname`). */
24
+ pathname?: string | null;
25
+ /** The logo (a home link), in the top bar and the mobile menu's header. */
26
+ brand?: ReactNode;
27
+ /** Top bar, after the brand. */
28
+ topBarStart?: ReactNode;
29
+ /** Top bar, the end cluster (language menu, account menu, shortcuts). */
30
+ topBarEnd?: ReactNode;
31
+ /** Above the top bar row; `--nav-h` covers both. */
32
+ banner?: ReactNode;
33
+ /** `true` (default): the breadcrumbs of the navigation; a node: the host's own; `false`: none. */
34
+ breadcrumbs?: boolean | ReactNode;
35
+ /** Over the sidebar list while expanded (a scope selector), and its compact form on the rail. */
36
+ sidebarHeader?: ReactNode;
37
+ sidebarRailHeader?: ReactNode;
38
+ /** Between the sidebar list and its collapse toggle. */
39
+ sidebarFooter?: ReactNode;
40
+ /** The mobile menu's footer (account, sign out); its header shows `brand`. */
41
+ mobileMenuFooter?: ReactNode;
42
+ /** Behind everything (e.g. `ShaderBackground` from `./shell-background`, a separate entry). */
43
+ background?: ReactNode;
44
+ /** Keeps `document.title` on the navigation (`{ appName }`); absent or `false`: the title is left alone. */
45
+ documentTitle?: false | Omit<ShellDocumentTitleProps<TEntity>, 'navigation' | 'useEntityLabel' | 'pathname'>;
46
+ /** localStorage key of the collapsed sidebar (one per area). */
47
+ collapsedStorageKey?: string;
48
+ /** The key toggling the sidebar (default `[`); `null`: no shortcut. */
49
+ collapseShortcut?: string | null;
50
+ /** The navigation landmarks' name (default "Main"). */
51
+ navigationLabel?: string;
52
+ className?: string;
53
+ /** Classes of `<main>` (the page inset is the page's: `PageFrame` brings one). */
54
+ contentClassName?: string;
55
+ children: ReactNode;
56
+ }
57
+ /**
58
+ * The application frame: a fixed top bar (`ShellTopBar`: menu button, brand, slots, breadcrumbs), a fixed sidebar from
59
+ * `lg` (`ShellSidebar`: the list, or the icon rail while collapsed — remembered per `collapsedStorageKey`, toggled by its
60
+ * foot row and the `[` key), the mobile menu below `lg` (`ShellMobileMenu`), the content frame (`<main>`, reserving the
61
+ * sidebar's width through `data-shell-collapsed`), an optional background and document title. Mechanism only: the
62
+ * navigation, the rights predicate, the slots' content, the link component and the pathname come from the host.
63
+ *
64
+ * Hydration-safe: the stored collapse state applies right after hydration (the server renders the full column); the
65
+ * scrolled state and the shortcut are read in effects. A "Skip to content" link is the first tab stop.
66
+ */
67
+ export declare const AppShell: <TEntity extends string = string>({ navigation, canAccess, useEntityLabel, pathname, brand, topBarStart, topBarEnd, banner, breadcrumbs, sidebarHeader, sidebarRailHeader, sidebarFooter, mobileMenuFooter, background, documentTitle, collapsedStorageKey, collapseShortcut, navigationLabel, className, contentClassName, children, }: AppShellProps<TEntity>) => import("react").JSX.Element;
68
+ //# sourceMappingURL=AppShell.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../src/shell/AppShell.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAyC,MAAM,OAAO,CAAC;AAG9E,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAIrC,OAAO,EAAqD,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC3G,OAAO,EAAsB,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAO5F,MAAM,WAAW,4BAA4B,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IAC3E,iCAAiC;IACjC,UAAU,EAAE,SAAS,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/C,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wHAAwH;AACxH,eAAO,MAAM,uBAAuB,GAAI,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,gEAMtE,4BAA4B,CAAC,OAAO,CAAC,gCAavC,CAAC;AAEF,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IAC5D,6GAA6G;IAC7G,UAAU,EAAE,SAAS,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/C,6GAA6G;IAC7G,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,wDAAwD;IACxD,cAAc,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,gCAAgC;IAChC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,yEAAyE;IACzE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,oDAAoD;IACpD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kGAAkG;IAClG,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,iGAAiG;IACjG,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC9B,wDAAwD;IACxD,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,+FAA+F;IAC/F,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,4GAA4G;IAC5G,aAAa,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,gBAAgB,GAAG,UAAU,CAAC,CAAC;IAE7G,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,uSAsBvD,aAAa,CAAC,OAAO,CAAC,gCAwExB,CAAC"}
@@ -0,0 +1,56 @@
1
+ 'use client';
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useCallback, useId, useMemo, useState } from 'react';
4
+ import { useTranslate } from "../i18n/useTranslate.js";
5
+ import { filterNavigation, findActiveNavigation, } from "../logic/pure/navigation.js";
6
+ import { cn } from "../primitives/cn.js";
7
+ import { useCurrentPathname } from "../primitives/pathname.js";
8
+ import { ShellBreadcrumbs } from "./ShellBreadcrumbs.js";
9
+ import { ShellNavigationContext } from "./shellContext.js";
10
+ import { ShellDocumentTitle } from "./ShellDocumentTitle.js";
11
+ import { ShellMenuButton, ShellMobileMenu } from "./ShellMobileMenu.js";
12
+ import { ShellSidebar } from "./ShellSidebar.js";
13
+ import { ShellTopBar } from "./ShellTopBar.js";
14
+ import { SIDEBAR_COLLAPSED_STORAGE_KEY, useSidebarCollapsed } from "./useSidebarCollapsed.js";
15
+ import { SIDEBAR_SHORTCUT_KEY, useShellShortcut } from "./useShellShortcut.js";
16
+ /** The navigation context of `AppShell` without the shell: breadcrumbs and the document title in a host's own frame. */
17
+ export const ShellNavigationProvider = ({ navigation, canAccess, useEntityLabel, pathname, children, }) => {
18
+ const adapterPathname = useCurrentPathname();
19
+ const path = pathname !== undefined ? pathname : adapterPathname;
20
+ const value = useMemo(() => ({
21
+ items: navigation,
22
+ canAccess,
23
+ useEntityLabel: useEntityLabel,
24
+ pathname: path,
25
+ }), [navigation, canAccess, useEntityLabel, path]);
26
+ return _jsx(ShellNavigationContext.Provider, { value: value, children: children });
27
+ };
28
+ /**
29
+ * The application frame: a fixed top bar (`ShellTopBar`: menu button, brand, slots, breadcrumbs), a fixed sidebar from
30
+ * `lg` (`ShellSidebar`: the list, or the icon rail while collapsed — remembered per `collapsedStorageKey`, toggled by its
31
+ * foot row and the `[` key), the mobile menu below `lg` (`ShellMobileMenu`), the content frame (`<main>`, reserving the
32
+ * sidebar's width through `data-shell-collapsed`), an optional background and document title. Mechanism only: the
33
+ * navigation, the rights predicate, the slots' content, the link component and the pathname come from the host.
34
+ *
35
+ * Hydration-safe: the stored collapse state applies right after hydration (the server renders the full column); the
36
+ * scrolled state and the shortcut are read in effects. A "Skip to content" link is the first tab stop.
37
+ */
38
+ export const AppShell = ({ navigation, canAccess, useEntityLabel, pathname, brand, topBarStart, topBarEnd, banner, breadcrumbs = true, sidebarHeader, sidebarRailHeader, sidebarFooter, mobileMenuFooter, background, documentTitle = false, collapsedStorageKey = SIDEBAR_COLLAPSED_STORAGE_KEY, collapseShortcut = SIDEBAR_SHORTCUT_KEY, navigationLabel, className, contentClassName, children, }) => {
39
+ const { t } = useTranslate();
40
+ const adapterPathname = useCurrentPathname();
41
+ const path = pathname !== undefined ? pathname : adapterPathname;
42
+ const [collapsed, setCollapsed] = useSidebarCollapsed(collapsedStorageKey);
43
+ const toggleCollapsed = useCallback(() => setCollapsed(), [setCollapsed]);
44
+ useShellShortcut(collapseShortcut, toggleCollapsed);
45
+ const [mobileOpen, setMobileOpen] = useState(false);
46
+ const ids = useId();
47
+ const sidebarId = `${ids}-sidebar`;
48
+ const mobileMenuId = `${ids}-menu`;
49
+ const mainId = `${ids}-main`;
50
+ const items = navigation;
51
+ const visible = useMemo(() => filterNavigation(items, canAccess), [items, canAccess]);
52
+ const active = useMemo(() => findActiveNavigation(visible, path), [visible, path]);
53
+ const value = useMemo(() => ({ items, canAccess, useEntityLabel: useEntityLabel, pathname: path }), [items, canAccess, useEntityLabel, path]);
54
+ return (_jsx(ShellNavigationContext.Provider, { value: value, children: _jsxs("div", { "data-shell": "", "data-shell-collapsed": collapsed || undefined, className: cn('min-h-svh pt-(--nav-h)', className), children: [_jsx("a", { href: `#${mainId}`, className: "sr-only focus:not-sr-only focus:fixed focus:start-3 focus:top-3 focus:z-(--layer-popover) focus:rounded-md focus:bg-background focus:px-3 focus:py-2 focus:text-sm focus:shadow-surface-raised focus:ring-2 focus:ring-ring", children: t('Skip to content') }), background, _jsx(ShellTopBar, { banner: banner, menuButton: _jsx(ShellMenuButton, { open: mobileOpen, onOpenChange: setMobileOpen, controls: mobileMenuId }), brand: brand, start: topBarStart, breadcrumbs: breadcrumbs === true ? _jsx(ShellBreadcrumbs, {}) : breadcrumbs === false ? null : breadcrumbs, end: topBarEnd }), _jsx(ShellSidebar, { id: sidebarId, items: visible, active: active, pathname: path, collapsed: collapsed, onToggleCollapsed: toggleCollapsed, shortcut: collapseShortcut, label: navigationLabel, header: sidebarHeader, railHeader: sidebarRailHeader, footer: sidebarFooter }), _jsx(ShellMobileMenu, { id: mobileMenuId, open: mobileOpen, onOpenChange: setMobileOpen, items: visible, active: active, pathname: path, label: navigationLabel, header: brand, footer: mobileMenuFooter }), _jsx("div", { "data-shell-content": "", children: _jsx("main", { id: mainId, tabIndex: -1, className: cn('w-full outline-none', contentClassName), children: children }) }), documentTitle && _jsx(ShellDocumentTitle, { ...documentTitle })] }) }));
55
+ };
56
+ //# sourceMappingURL=AppShell.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AppShell.js","sourceRoot":"","sources":["../../src/shell/AppShell.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ import type { ReactNode } from 'react';
2
+ /** One language of the menu. */
3
+ export interface LanguageOption {
4
+ /** What `onChange` receives (`de`, `pt-BR`); also the `lang` of the native name. */
5
+ code: string;
6
+ /** The name in the language itself (`Deutsch`): data, never translated. */
7
+ nativeName: string;
8
+ /** A second line for readers of the current UI language (`German`), shown when it differs. */
9
+ englishName?: string;
10
+ }
11
+ export interface LanguageMenuProps {
12
+ languages: readonly LanguageOption[];
13
+ /** The code of the current language (checked in the list, shown on the trigger). */
14
+ current: string;
15
+ onChange: (code: string) => void;
16
+ /** A change is being saved: the choices are disabled, the trigger shows a spinner. */
17
+ isPending?: boolean;
18
+ /** Under the choices (e.g. "Applies to this tab only"). */
19
+ note?: ReactNode;
20
+ /** More menu content after the languages (a writing-style choice). */
21
+ children?: ReactNode;
22
+ /** With one language or none the menu renders nothing (default `true`). */
23
+ hideWhenSingle?: boolean;
24
+ className?: string;
25
+ }
26
+ /** The language rows (menu items with a radio role and a check on the current one). */
27
+ export declare const LanguageMenuItems: ({ languages, current, onChange, isPending }: Pick<LanguageMenuProps, "languages" | "current" | "onChange" | "isPending">) => import("react").JSX.Element;
28
+ /**
29
+ * The language choice of the top bar, fed by the host: a compact pill with the current code; its menu lists the
30
+ * languages by their native names (each in its own `lang`), the current one checked (`menuitemradio`). `onChange` gets
31
+ * the code; the host applies and saves it. Nothing with fewer than two languages (unless `hideWhenSingle={false}`).
32
+ */
33
+ export declare const LanguageMenu: ({ languages, current, onChange, isPending, note, children, hideWhenSingle, className }: LanguageMenuProps) => import("react").JSX.Element | null;
34
+ /** The same choice as a submenu ("Language: Deutsch"), for the account menu. */
35
+ export declare const LanguageMenuSub: ({ languages, current, onChange, isPending, note }: Omit<LanguageMenuProps, "children" | "hideWhenSingle" | "className">) => import("react").JSX.Element;
36
+ //# sourceMappingURL=LanguageMenu.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LanguageMenu.d.ts","sourceRoot":"","sources":["../../src/shell/LanguageMenu.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAevC,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,sFAAsF;IACtF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,GAAI,6CAA6C,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC,gCA0BzJ,CAAC;AAKF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,wFAA+F,iBAAiB,uCAyB5I,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,eAAe,GAAI,mDAAmD,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,gCActJ,CAAC"}