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