@bevel-software/platform-core-frontend 0.4.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +5 -3
- package/src/core/CoreAppShell.tsx +195 -56
- package/src/core/__tests__/AppChrome.test.tsx +125 -0
- package/src/core/__tests__/ShellRoutes.test.tsx +130 -95
- package/src/core/__tests__/bootstrap.test.ts +63 -0
- package/src/core/bootstrap.ts +73 -0
- package/src/core/events.ts +12 -0
- package/src/core/registry.ts +58 -9
- package/src/index.css +100 -11
- package/src/index.ts +24 -23
- package/src/lib/utils.ts +114 -138
- package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +281 -0
- package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +166 -1
- package/src/modules/access/api.ts +49 -0
- package/src/modules/access/components/ManageAccessDialog.tsx +786 -481
- package/src/modules/access/hooks/useFileAccess.ts +1 -1
- package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +86 -0
- package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +172 -156
- package/src/modules/admin/__tests__/admin.unread.test.tsx +61 -0
- package/src/modules/admin/components/AdminRolesPage.tsx +44 -38
- package/src/modules/admin/components/RolesCorruptedBanner.tsx +11 -10
- package/src/modules/admin/components/UserAccountsPage.tsx +361 -353
- package/src/modules/admin/state/admin.context.tsx +15 -6
- package/src/modules/auth/components/AccountPage.tsx +11 -11
- package/src/modules/auth/components/LoginScreen.tsx +12 -12
- package/src/modules/auth/services/sso.ts +47 -1
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +277 -0
- package/src/modules/change-requests/__tests__/author.test.ts +48 -0
- package/src/modules/change-requests/__tests__/conflict.test.ts +73 -0
- package/src/modules/change-requests/__tests__/diff.test.ts +134 -0
- package/src/modules/change-requests/__tests__/propose.test.ts +93 -0
- package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +72 -0
- package/src/modules/change-requests/change-requests.css +22 -0
- package/src/modules/change-requests/components/ChangeBox.tsx +277 -0
- package/src/modules/change-requests/components/ChangeRequestDialog.tsx +713 -0
- package/src/modules/change-requests/components/ConflictHelp.tsx +47 -0
- package/src/modules/change-requests/components/CrFileTree.tsx +398 -0
- package/src/modules/change-requests/components/FileChangeBoxes.tsx +168 -0
- package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +236 -0
- package/src/modules/change-requests/hooks/useCrFileDiffs.ts +79 -0
- package/src/modules/change-requests/hooks/useFileOnBranch.ts +80 -0
- package/src/modules/change-requests/services/change-requests.api.ts +45 -0
- package/src/modules/change-requests/services/propose.api.ts +162 -0
- package/src/modules/change-requests/utils/author.ts +47 -0
- package/src/modules/change-requests/utils/conflict.ts +38 -0
- package/src/modules/change-requests/utils/diff.ts +80 -0
- package/src/modules/git/__tests__/BranchSwitcher.test.tsx +27 -18
- package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +36 -83
- package/src/modules/git/__tests__/PullNeededBanner.test.tsx +5 -5
- package/src/modules/git/__tests__/PullRequestsForMe.test.tsx +147 -0
- package/src/modules/git/__tests__/useAutoPullUpdates.test.tsx +2 -8
- package/src/modules/git/components/BranchSwitcher.tsx +68 -31
- package/src/modules/git/components/DiffView.tsx +4 -4
- package/src/modules/git/components/FileComparisonPanel.tsx +20 -20
- package/src/modules/git/components/FileHistoryPanel.tsx +71 -107
- package/src/modules/git/components/PullNeededBanner.tsx +6 -13
- package/src/modules/git/components/PullRequestsForMe.tsx +71 -36
- package/src/modules/git/components/UnifiedDiffView.tsx +4 -4
- package/src/modules/git/hooks/__tests__/useGitState.deleteBranch.test.tsx +2 -2
- package/src/modules/git/hooks/useGitState.ts +15 -14
- package/src/modules/git/services/__tests__/error-messages.test.ts +4 -4
- package/src/modules/git/services/error-messages.ts +7 -7
- package/src/modules/git/services/git.api.ts +17 -11
- package/src/modules/git/services/pr-prompts.ts +2 -2
- package/src/modules/git/state/git.context.ts +10 -1
- package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +224 -0
- package/src/modules/layout/__tests__/SidebarToggle.test.tsx +242 -0
- package/src/modules/layout/__tests__/breakpoints.test.ts +56 -0
- package/src/modules/layout/breakpoints.ts +6 -0
- package/src/modules/layout/components/AppLayout.tsx +17 -5
- package/src/modules/layout/components/DemoBanner.tsx +10 -1
- package/src/modules/layout/components/MaintenanceOverlay.tsx +104 -104
- package/src/modules/layout/components/MobileChatLayout.tsx +31 -26
- package/src/modules/layout/components/ResizableThreePaneLayout.tsx +59 -24
- package/src/modules/layout/components/SidebarFrame.tsx +317 -0
- package/src/modules/layout/components/SidebarToggle.tsx +86 -0
- package/src/modules/layout/components/SlideOverlay.tsx +1 -1
- package/src/modules/layout/components/__tests__/MobileChatLayout.test.tsx +40 -2
- package/src/modules/layout/components/__tests__/ResizableThreePaneLayout.test.tsx +19 -3
- package/src/modules/layout/state/sidebar.ts +200 -0
- package/src/modules/library/__tests__/AddToGroupDialog.test.tsx +313 -0
- package/src/modules/library/__tests__/ChangeRequestDock.test.tsx +84 -0
- package/src/modules/library/__tests__/GroupJoinRequests.test.tsx +178 -0
- package/src/modules/library/__tests__/GroupPage.test.tsx +479 -0
- package/src/modules/library/__tests__/GroupsIndexPage.test.tsx +283 -0
- package/src/modules/library/__tests__/GroupsSidebar.contextmenu.test.tsx +175 -0
- package/src/modules/library/__tests__/GroupsSidebar.locked.test.tsx +96 -0
- package/src/modules/library/__tests__/GroupsSidebar.test.tsx +142 -0
- package/src/modules/library/__tests__/GroupsSidebarMenu.test.tsx +142 -0
- package/src/modules/library/__tests__/LibraryCard.test.tsx +149 -0
- package/src/modules/library/__tests__/LibraryRoutes.test.tsx +378 -0
- package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +347 -0
- package/src/modules/library/__tests__/LockedGroupView.test.tsx +203 -0
- package/src/modules/library/__tests__/NewGroupDialog.test.tsx +114 -0
- package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +177 -0
- package/src/modules/library/__tests__/SkillPage.test.tsx +1063 -0
- package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +259 -0
- package/src/modules/library/__tests__/ToolLogo.test.tsx +63 -0
- package/src/modules/library/__tests__/ToolPage.test.tsx +315 -0
- package/src/modules/library/__tests__/ToolSharePanel.test.tsx +36 -0
- package/src/modules/library/__tests__/ToolVarRow.test.tsx +260 -0
- package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +197 -0
- package/src/modules/library/__tests__/auth-harness.tsx +37 -0
- package/src/modules/library/__tests__/oauth-fragment.test.ts +48 -0
- package/src/modules/library/__tests__/status.test.ts +210 -117
- package/src/modules/library/__tests__/useSkillDetail.test.tsx +102 -0
- package/src/modules/library/__tests__/useToolPage.test.tsx +146 -0
- package/src/modules/library/components/AccessRequestsBanner.tsx +101 -0
- package/src/modules/library/components/AddToGroupDialog.tsx +115 -0
- package/src/modules/library/components/ChangeRequestDock.tsx +71 -47
- package/src/modules/library/components/DeleteGroupDialog.tsx +87 -0
- package/src/modules/library/components/GroupIndexRow.tsx +63 -0
- package/src/modules/library/components/GroupJoinRequests.tsx +56 -0
- package/src/modules/library/components/GroupPage.tsx +373 -0
- package/src/modules/library/components/GroupsIndexPage.tsx +222 -0
- package/src/modules/library/components/GroupsSidebar.tsx +338 -0
- package/src/modules/library/components/GroupsSidebarMenu.tsx +160 -0
- package/src/modules/library/components/LibraryCard.tsx +153 -132
- package/src/modules/library/components/LibraryLayout.tsx +344 -0
- package/src/modules/library/components/LibraryPage.tsx +138 -254
- package/src/modules/library/components/LockGlyph.tsx +31 -0
- package/src/modules/library/components/LockedGroupView.tsx +159 -0
- package/src/modules/library/components/ManagedGroupRequests.tsx +70 -0
- package/src/modules/library/components/NewGroupDialog.tsx +112 -0
- package/src/modules/library/components/NewSkillPanel.tsx +151 -0
- package/src/modules/library/components/PageActions.tsx +156 -0
- package/src/modules/library/components/PendingSkillReview.tsx +63 -0
- package/src/modules/library/components/PersonalAddDialog.tsx +88 -0
- package/src/modules/library/components/PersonalGroupPage.tsx +125 -0
- package/src/modules/library/components/StatusDot.tsx +25 -0
- package/src/modules/library/components/ToolLogo.tsx +171 -0
- package/src/modules/library/components/group-page-parts.tsx +419 -0
- package/src/modules/library/components/skill-page/SkillFileEditor.tsx +134 -0
- package/src/modules/library/components/skill-page/SkillFilePane.tsx +117 -0
- package/src/modules/library/components/skill-page/SkillFileTabs.tsx +112 -0
- package/src/modules/library/components/skill-page/SkillPage.tsx +673 -0
- package/src/modules/library/components/skill-page/tab-ids.ts +33 -0
- package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +175 -0
- package/src/modules/library/components/tool-page/ToolPage.tsx +228 -0
- package/src/modules/library/components/tool-page/ToolSharePanel.tsx +45 -0
- package/src/modules/library/components/tool-page/ToolVarRow.tsx +289 -0
- package/src/modules/library/hooks/useJoinRequests.ts +114 -0
- package/src/modules/library/hooks/useLibraryData.ts +134 -119
- package/src/modules/library/hooks/useSkillDetail.ts +119 -74
- package/src/modules/library/hooks/useToolPage.ts +145 -0
- package/src/modules/library/library.css +108 -320
- package/src/modules/library/routes/LibraryRoutes.tsx +134 -0
- package/src/modules/library/routes/WorkspaceItemRoute.tsx +74 -0
- package/src/modules/library/routes/library-paths.ts +191 -0
- package/src/modules/library/services/groups.api.ts +189 -0
- package/src/modules/library/services/library.api.ts +291 -164
- package/src/modules/library/services/tools.api.ts +60 -0
- package/src/modules/library/state/library-context.ts +22 -0
- package/src/modules/library/state/library-data.tsx +223 -0
- package/src/modules/library/state/toast.context.ts +32 -0
- package/src/modules/library/state/toast.tsx +84 -42
- package/src/modules/library/utils/clipboard.ts +33 -0
- package/src/modules/library/utils/group-summary.ts +68 -0
- package/src/modules/library/utils/names.ts +30 -0
- package/src/modules/library/utils/navigate-external.ts +15 -0
- package/src/modules/library/utils/oauth-fragment.ts +32 -0
- package/src/modules/library/utils/personal-group.ts +36 -0
- package/src/modules/library/utils/status.ts +199 -116
- package/src/modules/library/utils/toast-duration.ts +16 -0
- package/src/modules/onboarding/__tests__/onboarding.test.tsx +533 -0
- package/src/modules/onboarding/agent-clients.ts +48 -0
- package/src/modules/onboarding/components/ConnectAgentPill.tsx +133 -0
- package/src/modules/onboarding/components/RootLanding.tsx +54 -0
- package/src/modules/onboarding/components/WelcomePage.tsx +364 -0
- package/src/modules/onboarding/paths.ts +9 -0
- package/src/modules/onboarding/state/onboarding.ts +191 -0
- package/src/modules/pr/components/OpenChangeRequestDialog.tsx +10 -10
- package/src/modules/pr/services/pr-approvals.api.ts +19 -0
- package/src/modules/pr/services/pr-cancel.api.ts +11 -0
- package/src/modules/review/components/BinaryChangePlaceholder.tsx +3 -3
- package/src/modules/review/components/DiffViewer.tsx +4 -4
- package/src/modules/review/components/MarkdownDiffViewer.tsx +84 -26
- package/src/modules/review/components/ReviewFileRow.tsx +10 -10
- package/src/modules/review/components/ReviewPanel.tsx +49 -17
- package/src/modules/review/components/ReviewPanelSurface.tsx +1 -1
- package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +122 -0
- package/src/modules/review/hooks/__tests__/useReviewState.test.ts +1 -1
- package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +273 -171
- package/src/modules/secrets-vault/components/SecretsPage.tsx +313 -276
- package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +109 -92
- package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +82 -51
- package/src/modules/secrets-vault/services/connect.api.ts +24 -3
- package/src/modules/settings/components/DeploymentPage.tsx +90 -0
- package/src/modules/settings/components/SettingsLayout.tsx +135 -0
- package/src/modules/settings/components/SettingsNav.tsx +114 -0
- package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +110 -0
- package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +249 -0
- package/src/modules/settings/settings-nav-items.tsx +166 -0
- package/src/modules/setup/__tests__/setup.test.tsx +540 -0
- package/src/modules/setup/components/SetupGate.tsx +67 -0
- package/src/modules/setup/components/SetupScreen.tsx +573 -0
- package/src/modules/setup/services/setup.api.ts +106 -0
- package/src/modules/setup/utils/git-host.ts +34 -0
- package/src/modules/toolbar/components/AppSwitcher.tsx +131 -108
- package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +548 -548
- package/src/modules/toolbar/components/ProfileMenu.tsx +294 -0
- package/src/modules/toolbar/components/Toolbar.tsx +56 -54
- package/src/modules/toolbar/components/__tests__/AppSwitcher.test.tsx +176 -122
- package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +252 -77
- package/src/modules/tools/ToolsExplorerPage.tsx +45 -40
- package/src/modules/workspace/__tests__/design-system-parity.test.ts +133 -0
- package/src/modules/workspace/__tests__/testFixtures.ts +2 -0
- package/src/modules/workspace/components/EditorTabs.tsx +82 -50
- package/src/modules/workspace/components/FileExplorer.tsx +1292 -1068
- package/src/modules/workspace/components/FilePaneCard.tsx +53 -0
- package/src/modules/workspace/components/FileRoute.tsx +89 -84
- package/src/modules/workspace/components/FileViewer.tsx +1312 -906
- package/src/modules/workspace/components/KbDocumentShell.tsx +138 -0
- package/src/modules/workspace/components/KbFileRail.tsx +128 -0
- package/src/modules/workspace/components/KbPageHeader.tsx +390 -0
- package/src/modules/workspace/components/__tests__/EditorTabs.test.tsx +87 -3
- package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +293 -39
- package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +1 -16
- package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +462 -44
- package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +84 -0
- package/src/modules/workspace/components/__tests__/KbFileRail.test.tsx +83 -0
- package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +192 -0
- package/src/modules/workspace/components/renderers/CopyAnchorButton.tsx +64 -0
- package/src/modules/workspace/components/renderers/CsvRenderer.tsx +8 -8
- package/src/modules/workspace/components/renderers/DocxRenderer.tsx +18 -9
- package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +14 -14
- package/src/modules/workspace/components/renderers/ImageRenderer.tsx +2 -2
- package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +31 -165
- package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +18 -5
- package/src/modules/workspace/components/renderers/MermaidDiagram.tsx +27 -10
- package/src/modules/workspace/components/renderers/PdfRenderer.tsx +2 -2
- package/src/modules/workspace/components/renderers/TextRenderer.tsx +11 -5
- package/src/modules/workspace/components/renderers/ToolForm.tsx +24 -24
- package/src/modules/workspace/components/renderers/ToolRenderer.tsx +27 -27
- package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +11 -11
- package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +66 -0
- package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +17 -1
- package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +1 -1
- package/src/modules/workspace/components/renderers/__tests__/MermaidDiagram.test.tsx +58 -0
- package/src/modules/workspace/components/renderers/__tests__/lazyRenderer.test.tsx +68 -0
- package/src/modules/workspace/components/renderers/__tests__/rendererLayout.test.ts +64 -0
- package/src/modules/workspace/components/renderers/__tests__/sanitizeDocxHtml.test.ts +0 -0
- package/src/modules/workspace/components/renderers/chunk-boundary.tsx +71 -0
- package/src/modules/workspace/components/renderers/index.ts +78 -2
- package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +241 -0
- package/src/modules/workspace/components/renderers/lazyRenderer.tsx +59 -0
- package/src/modules/workspace/components/renderers/sanitizeDocxHtml.ts +91 -0
- package/src/modules/workspace/hooks/__tests__/useLinksOut.test.ts +59 -0
- package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +237 -0
- package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +185 -0
- package/src/modules/workspace/hooks/useAutoGrowTextarea.ts +30 -0
- package/src/modules/workspace/hooks/useLastCommit.ts +66 -0
- package/src/modules/workspace/hooks/useLinksOut.ts +56 -0
- package/src/modules/workspace/hooks/useOpenChangeRequests.ts +20 -0
- package/src/modules/workspace/hooks/useWorkspaceState.ts +123 -14
- package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +1 -1
- package/src/modules/workspace/services/workspace.api.ts +9 -2
- package/src/modules/workspace/state/open-change-requests.context.ts +35 -0
- package/src/modules/workspace/state/open-change-requests.tsx +185 -0
- package/src/modules/workspace/state/workspace.context.ts +9 -0
- package/src/modules/workspace/utils/__tests__/diff.test.ts +87 -0
- package/src/modules/workspace/utils/diff.ts +130 -53
- package/src/modules/workspace/utils/fileTree.ts +182 -179
- package/src/modules/workspace/workspace.css +28 -0
- package/src/shared/components/Badge.tsx +62 -0
- package/src/shared/components/Banner.tsx +58 -0
- package/src/shared/components/Button.tsx +90 -0
- package/src/shared/components/Dialog.tsx +6 -6
- package/src/shared/components/Field.tsx +45 -0
- package/src/shared/components/IconButton.tsx +74 -0
- package/src/shared/components/ListRow.tsx +96 -0
- package/src/shared/components/Menu.tsx +88 -0
- package/src/shared/components/PageShell.tsx +54 -51
- package/src/shared/components/Surface.tsx +86 -0
- package/src/shared/components/__tests__/primitives.test.tsx +333 -0
- package/src/shared/components/index.ts +48 -0
- package/src/shared/components/useDismissableMenu.ts +71 -0
- package/src/shared/theme/__tests__/accent-contrast.test.ts +84 -0
- package/src/shared/theme/index.css +12 -0
- package/src/shared/theme/measure.ts +64 -0
- package/src/shared/theme/shadows.css +34 -0
- package/src/shared/theme/tokens.css +193 -0
- package/src/test-setup.ts +9 -0
- package/src/modules/access/components/AccessRestrictedBanner.tsx +0 -31
- package/src/modules/access/components/NodeOwnersBanner.tsx +0 -30
- package/src/modules/git/__tests__/ProtectedBranchBanner.test.tsx +0 -82
- package/src/modules/git/components/ProtectedBranchBanner.tsx +0 -42
- package/src/modules/library/__tests__/DetailDialog.test.tsx +0 -200
- package/src/modules/library/__tests__/diff.test.ts +0 -62
- package/src/modules/library/__tests__/loadout.test.tsx +0 -72
- package/src/modules/library/components/CompareView.tsx +0 -357
- package/src/modules/library/components/DetailDialog.tsx +0 -566
- package/src/modules/library/components/GearIcon.tsx +0 -12
- package/src/modules/library/components/LoadoutSidebar.tsx +0 -156
- package/src/modules/library/components/StatusGem.tsx +0 -21
- package/src/modules/library/components/SuggestChange.tsx +0 -171
- package/src/modules/library/components/particles.ts +0 -50
- package/src/modules/library/state/loadout.tsx +0 -129
- package/src/modules/library/utils/diff.ts +0 -102
- package/src/modules/pr/__tests__/PrApprovalBadge.test.tsx +0 -93
- package/src/modules/pr/__tests__/PrCancelButton.test.tsx +0 -158
- package/src/modules/pr/__tests__/PrCancelConfirmDialog.test.tsx +0 -44
- package/src/modules/pr/__tests__/PrMergeButton.test.tsx +0 -360
- package/src/modules/pr/__tests__/bucketize-comments.test.ts +0 -85
- package/src/modules/pr/__tests__/parsePatch.test.ts +0 -104
- package/src/modules/pr/__tests__/usePrViewerState.test.ts +0 -72
- package/src/modules/pr/components/PrApprovalBadge.tsx +0 -80
- package/src/modules/pr/components/PrCancelButton.tsx +0 -99
- package/src/modules/pr/components/PrCancelConfirmDialog.tsx +0 -119
- package/src/modules/pr/components/PrCommentComposer.tsx +0 -92
- package/src/modules/pr/components/PrCommentThread.tsx +0 -168
- package/src/modules/pr/components/PrCommentsPanel.tsx +0 -143
- package/src/modules/pr/components/PrDiffPane.tsx +0 -425
- package/src/modules/pr/components/PrFileRow.tsx +0 -164
- package/src/modules/pr/components/PrFilesList.tsx +0 -53
- package/src/modules/pr/components/PrHeader.tsx +0 -45
- package/src/modules/pr/components/PrHeaderOverflowMenu.tsx +0 -58
- package/src/modules/pr/components/PrMergeButton.tsx +0 -268
- package/src/modules/pr/components/PrMergeConfirmDialog.tsx +0 -112
- package/src/modules/pr/components/PrRefreshFromTargetButton.tsx +0 -110
- package/src/modules/pr/components/PrViewer.tsx +0 -364
- package/src/modules/pr/hooks/usePrViewerState.ts +0 -150
- package/src/modules/pr/state/pr-viewer.context.ts +0 -34
- package/src/modules/pr/utils/bucketize-comments.ts +0 -55
- package/src/modules/pr/utils/parsePatch.ts +0 -57
- package/src/modules/toolbar/components/AdminMenu.tsx +0 -271
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import type { HTMLAttributes } from 'react';
|
|
2
|
+
import { cn } from '../../lib/utils';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* A raised container. Implements the prototype's `.card`, `.panel`, `.files`,
|
|
6
|
+
* `.crfiles` and `.crmini`.
|
|
7
|
+
*
|
|
8
|
+
* Absorbs 25 confirmed `bg-white + border + rounded` blocks and is the funnel
|
|
9
|
+
* for the app's 92-site `bg-white` split — a `bg-white` is either the page
|
|
10
|
+
* canvas or a raised surface, and the two want different colours the moment
|
|
11
|
+
* the palette stops being pure white.
|
|
12
|
+
*
|
|
13
|
+
* `interactive` adds the hover/press affordance the prototype gives clickable
|
|
14
|
+
* cards. It does NOT make the element a button: pass `as="button"` for that,
|
|
15
|
+
* so the semantics and the styling are decided independently.
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
export type SurfaceTone = 'surface' | 'sunken' | 'sidebar';
|
|
19
|
+
export type SurfaceRadius = 'md' | 'lg' | 'xl' | '2xl';
|
|
20
|
+
export type SurfaceElevation = 'none' | 'card' | 'overlay';
|
|
21
|
+
|
|
22
|
+
const TONE: Record<SurfaceTone, string> = {
|
|
23
|
+
surface: 'bg-surface',
|
|
24
|
+
sunken: 'bg-sunken',
|
|
25
|
+
sidebar: 'bg-sidebar',
|
|
26
|
+
};
|
|
27
|
+
|
|
28
|
+
const RADIUS: Record<SurfaceRadius, string> = {
|
|
29
|
+
md: 'rounded-md',
|
|
30
|
+
lg: 'rounded-lg',
|
|
31
|
+
xl: 'rounded-xl',
|
|
32
|
+
'2xl': 'rounded-2xl',
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
const ELEVATION: Record<SurfaceElevation, string> = {
|
|
36
|
+
none: '',
|
|
37
|
+
card: 'shadow-card',
|
|
38
|
+
overlay: 'shadow-overlay',
|
|
39
|
+
};
|
|
40
|
+
|
|
41
|
+
export interface SurfaceProps extends HTMLAttributes<HTMLElement> {
|
|
42
|
+
as?: 'div' | 'section' | 'aside' | 'article' | 'button';
|
|
43
|
+
/**
|
|
44
|
+
* Only meaningful with `as="button"`. Declared here because a `<button>`
|
|
45
|
+
* inside a form defaults to `type="submit"`, so a card that omits it would
|
|
46
|
+
* submit the form it happens to sit in.
|
|
47
|
+
*/
|
|
48
|
+
type?: 'button' | 'submit' | 'reset';
|
|
49
|
+
tone?: SurfaceTone;
|
|
50
|
+
radius?: SurfaceRadius;
|
|
51
|
+
elevation?: SurfaceElevation;
|
|
52
|
+
/** Adds the prototype's hover border/background lift and press scale. */
|
|
53
|
+
interactive?: boolean;
|
|
54
|
+
/** Applies the card's default 14px/16px padding. */
|
|
55
|
+
padded?: boolean;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export function Surface({
|
|
59
|
+
as: Tag = 'div',
|
|
60
|
+
tone = 'surface',
|
|
61
|
+
radius = 'xl',
|
|
62
|
+
elevation = 'card',
|
|
63
|
+
interactive = false,
|
|
64
|
+
padded = false,
|
|
65
|
+
className,
|
|
66
|
+
children,
|
|
67
|
+
...rest
|
|
68
|
+
}: SurfaceProps) {
|
|
69
|
+
return (
|
|
70
|
+
<Tag
|
|
71
|
+
className={cn(
|
|
72
|
+
'border border-line',
|
|
73
|
+
TONE[tone],
|
|
74
|
+
RADIUS[radius],
|
|
75
|
+
ELEVATION[elevation],
|
|
76
|
+
padded && 'px-4 pt-3.5 pb-3',
|
|
77
|
+
interactive &&
|
|
78
|
+
'cursor-pointer transition-[border-color,background-color,transform] hover:border-line-strong hover:bg-surface-hover active:scale-[.995]',
|
|
79
|
+
className,
|
|
80
|
+
)}
|
|
81
|
+
{...rest}
|
|
82
|
+
>
|
|
83
|
+
{children}
|
|
84
|
+
</Tag>
|
|
85
|
+
);
|
|
86
|
+
}
|
|
@@ -0,0 +1,333 @@
|
|
|
1
|
+
import { describe, it, expect, vi } from 'vitest';
|
|
2
|
+
import { render, screen } from '@testing-library/react';
|
|
3
|
+
import userEvent from '@testing-library/user-event';
|
|
4
|
+
import type { ReactElement } from 'react';
|
|
5
|
+
import { cn } from '../../../lib/utils';
|
|
6
|
+
import {
|
|
7
|
+
Button,
|
|
8
|
+
buttonClasses,
|
|
9
|
+
IconButton,
|
|
10
|
+
Surface,
|
|
11
|
+
ListRow,
|
|
12
|
+
Badge,
|
|
13
|
+
Banner,
|
|
14
|
+
TextField,
|
|
15
|
+
TextAreaField,
|
|
16
|
+
MenuPanel,
|
|
17
|
+
MenuItem,
|
|
18
|
+
MenuLabel,
|
|
19
|
+
} from '../index';
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* The a11y layer is a FROZEN API: 76 existing tests select components by
|
|
23
|
+
* `role`, `aria-label` and `title`. Measured against this suite, dropping
|
|
24
|
+
* `title=` breaks 31 tests, `role=` breaks 29 and `aria-label` breaks 16.
|
|
25
|
+
*
|
|
26
|
+
* So the contract every primitive must honour is: spread `...rest` onto the
|
|
27
|
+
* root node, and never synthesise or override those three attributes. The
|
|
28
|
+
* table below asserts that for every primitive at once — if someone adds a
|
|
29
|
+
* primitive that swallows `title`, this fails rather than a screen-reader
|
|
30
|
+
* regression shipping silently.
|
|
31
|
+
*/
|
|
32
|
+
const A11Y_CASES: Array<[string, (props: Record<string, unknown>) => ReactElement]> = [
|
|
33
|
+
['Button', (p) => <Button {...p}>x</Button>],
|
|
34
|
+
['IconButton', (p) => <IconButton aria-label="fallback" {...p} />],
|
|
35
|
+
['Surface', (p) => <Surface {...p}>x</Surface>],
|
|
36
|
+
['ListRow', (p) => <ListRow {...p} label="x" />],
|
|
37
|
+
['Badge', (p) => <Badge {...p}>x</Badge>],
|
|
38
|
+
['Banner', (p) => <Banner role="status" {...p}>x</Banner>],
|
|
39
|
+
['TextField', (p) => <TextField {...p} />],
|
|
40
|
+
['TextAreaField', (p) => <TextAreaField {...p} />],
|
|
41
|
+
['MenuPanel', (p) => <MenuPanel {...p}>x</MenuPanel>],
|
|
42
|
+
['MenuItem', (p) => <MenuItem {...p}>x</MenuItem>],
|
|
43
|
+
['MenuLabel', (p) => <MenuLabel {...p}>x</MenuLabel>],
|
|
44
|
+
];
|
|
45
|
+
|
|
46
|
+
describe('cn() knows the design system scales', () => {
|
|
47
|
+
it('does not drop a semantic text colour when a custom size follows it', () => {
|
|
48
|
+
// Regression: `text-ui` is a FONT SIZE. Untaught, tailwind-merge reads it
|
|
49
|
+
// as a text colour, judges it to conflict with `text-ink-muted`, and drops
|
|
50
|
+
// the colour — silently, in every primitive that composes size + colour.
|
|
51
|
+
expect(cn('text-ink-muted', 'text-ui')).toBe('text-ink-muted text-ui');
|
|
52
|
+
expect(cn('text-danger', 'text-meta')).toBe('text-danger text-meta');
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
it('still collapses genuine conflicts within one namespace', () => {
|
|
56
|
+
expect(cn('text-ink', 'text-danger')).toBe('text-danger');
|
|
57
|
+
expect(cn('text-ui', 'text-body')).toBe('text-body');
|
|
58
|
+
expect(cn('shadow-card', 'shadow-overlay')).toBe('shadow-overlay');
|
|
59
|
+
});
|
|
60
|
+
|
|
61
|
+
it('lets a caller override a primitive default via className', () => {
|
|
62
|
+
expect(cn('bg-surface', 'bg-sunken')).toBe('bg-sunken');
|
|
63
|
+
});
|
|
64
|
+
});
|
|
65
|
+
|
|
66
|
+
describe('a11y contract (C4): every primitive forwards role/aria-label/title', () => {
|
|
67
|
+
it.each(A11Y_CASES)('%s forwards all three untouched', (_name, renderFn) => {
|
|
68
|
+
const { container } = render(
|
|
69
|
+
renderFn({
|
|
70
|
+
'data-probe': 'root',
|
|
71
|
+
role: 'note',
|
|
72
|
+
'aria-label': 'my-label',
|
|
73
|
+
title: 'my-tooltip',
|
|
74
|
+
}),
|
|
75
|
+
);
|
|
76
|
+
const root = container.querySelector('[data-probe="root"]');
|
|
77
|
+
expect(root).not.toBeNull();
|
|
78
|
+
expect(root!.getAttribute('role')).toBe('note');
|
|
79
|
+
expect(root!.getAttribute('aria-label')).toBe('my-label');
|
|
80
|
+
expect(root!.getAttribute('title')).toBe('my-tooltip');
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
it('ListRow does NOT shadow the native title attribute with its text prop', () => {
|
|
84
|
+
// Regression: `label` used to be called `title`, which collided with the
|
|
85
|
+
// HTML attribute and would have broken the 31 tests that read it.
|
|
86
|
+
render(<ListRow data-testid="row" label="Row text" title="Tooltip text" />);
|
|
87
|
+
const row = screen.getByTestId('row');
|
|
88
|
+
expect(row.getAttribute('title')).toBe('Tooltip text');
|
|
89
|
+
expect(row).toHaveTextContent('Row text');
|
|
90
|
+
});
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
describe('Button', () => {
|
|
94
|
+
it('defaults to type="button" so it never submits a form by accident', () => {
|
|
95
|
+
render(<Button>Save</Button>);
|
|
96
|
+
expect(screen.getByRole('button', { name: 'Save' })).toHaveAttribute('type', 'button');
|
|
97
|
+
});
|
|
98
|
+
|
|
99
|
+
it('honours an explicit type', () => {
|
|
100
|
+
render(<Button type="submit">Go</Button>);
|
|
101
|
+
expect(screen.getByRole('button', { name: 'Go' })).toHaveAttribute('type', 'submit');
|
|
102
|
+
});
|
|
103
|
+
|
|
104
|
+
it('fires onClick when enabled and not when disabled', async () => {
|
|
105
|
+
const user = userEvent.setup();
|
|
106
|
+
const onClick = vi.fn();
|
|
107
|
+
const { rerender } = render(<Button onClick={onClick}>Go</Button>);
|
|
108
|
+
await user.click(screen.getByRole('button'));
|
|
109
|
+
expect(onClick).toHaveBeenCalledTimes(1);
|
|
110
|
+
|
|
111
|
+
rerender(
|
|
112
|
+
<Button onClick={onClick} disabled>
|
|
113
|
+
Go
|
|
114
|
+
</Button>,
|
|
115
|
+
);
|
|
116
|
+
await user.click(screen.getByRole('button'));
|
|
117
|
+
expect(onClick).toHaveBeenCalledTimes(1);
|
|
118
|
+
});
|
|
119
|
+
|
|
120
|
+
it('applies one disabled treatment rather than per-call-site copies', () => {
|
|
121
|
+
render(<Button disabled>Go</Button>);
|
|
122
|
+
const cls = screen.getByRole('button').className;
|
|
123
|
+
expect(cls).toContain('disabled:opacity-50');
|
|
124
|
+
expect(cls).toContain('disabled:cursor-not-allowed');
|
|
125
|
+
});
|
|
126
|
+
|
|
127
|
+
it('renders leading and trailing icons around the label', () => {
|
|
128
|
+
render(
|
|
129
|
+
<Button leadingIcon={<span>L</span>} trailingIcon={<span>T</span>}>
|
|
130
|
+
Mid
|
|
131
|
+
</Button>,
|
|
132
|
+
);
|
|
133
|
+
expect(screen.getByRole('button').textContent).toBe('LMidT');
|
|
134
|
+
});
|
|
135
|
+
|
|
136
|
+
it('buttonClasses produces the same classes as the component, for <a>/<Link>', () => {
|
|
137
|
+
render(<Button variant="primary" size="sm">x</Button>);
|
|
138
|
+
expect(screen.getByRole('button').className).toBe(
|
|
139
|
+
buttonClasses({ variant: 'primary', size: 'sm' }),
|
|
140
|
+
);
|
|
141
|
+
});
|
|
142
|
+
|
|
143
|
+
it.each([
|
|
144
|
+
['primary', 'bg-accent'],
|
|
145
|
+
['outline', 'border-line-strong'],
|
|
146
|
+
['quiet', 'text-ink-muted'],
|
|
147
|
+
['danger', 'text-danger'],
|
|
148
|
+
] as const)('variant %s resolves through a token, not a raw colour', (variant, expected) => {
|
|
149
|
+
render(<Button variant={variant}>x</Button>);
|
|
150
|
+
expect(screen.getByRole('button').className).toContain(expected);
|
|
151
|
+
});
|
|
152
|
+
});
|
|
153
|
+
|
|
154
|
+
describe('IconButton', () => {
|
|
155
|
+
it('is reachable by its required accessible name', () => {
|
|
156
|
+
render(<IconButton aria-label="Hide sidebar">x</IconButton>);
|
|
157
|
+
expect(screen.getByRole('button', { name: 'Hide sidebar' })).toBeInTheDocument();
|
|
158
|
+
});
|
|
159
|
+
|
|
160
|
+
it('shows a pressed background when active', () => {
|
|
161
|
+
// Match a STANDALONE class: `hover:bg-hover` is always present and
|
|
162
|
+
// contains `bg-hover` as a substring, so a naive contains() never fails.
|
|
163
|
+
const hasBare = (el: Element) => el.className.split(/\s+/).includes('bg-hover');
|
|
164
|
+
const { rerender } = render(<IconButton aria-label="Menu" />);
|
|
165
|
+
expect(hasBare(screen.getByRole('button'))).toBe(false);
|
|
166
|
+
rerender(<IconButton aria-label="Menu" active />);
|
|
167
|
+
expect(hasBare(screen.getByRole('button'))).toBe(true);
|
|
168
|
+
});
|
|
169
|
+
|
|
170
|
+
it.each([28, 24, 22, 18] as const)('size %s maps to a fixed square', (size) => {
|
|
171
|
+
const { container } = render(<IconButton aria-label="x" size={size} />);
|
|
172
|
+
const cls = container.querySelector('button')!.className;
|
|
173
|
+
expect(cls).toMatch(/h-(7|6|\[22px\]|\[18px\])/);
|
|
174
|
+
});
|
|
175
|
+
});
|
|
176
|
+
|
|
177
|
+
describe('Surface', () => {
|
|
178
|
+
it('renders the requested element', () => {
|
|
179
|
+
const { container } = render(<Surface as="section">x</Surface>);
|
|
180
|
+
expect(container.querySelector('section')).not.toBeNull();
|
|
181
|
+
});
|
|
182
|
+
|
|
183
|
+
it('only adds hover/press affordances when interactive', () => {
|
|
184
|
+
const { container, rerender } = render(<Surface>x</Surface>);
|
|
185
|
+
expect(container.firstElementChild!.className).not.toContain('cursor-pointer');
|
|
186
|
+
rerender(<Surface interactive>x</Surface>);
|
|
187
|
+
expect(container.firstElementChild!.className).toContain('cursor-pointer');
|
|
188
|
+
});
|
|
189
|
+
|
|
190
|
+
it('elevation none emits no shadow class', () => {
|
|
191
|
+
const { container } = render(<Surface elevation="none">x</Surface>);
|
|
192
|
+
expect(container.firstElementChild!.className).not.toMatch(/shadow-/);
|
|
193
|
+
});
|
|
194
|
+
});
|
|
195
|
+
|
|
196
|
+
describe('ListRow', () => {
|
|
197
|
+
it('as="button" gets type="button" so it never submits', () => {
|
|
198
|
+
render(<ListRow as="button" label="Row" />);
|
|
199
|
+
expect(screen.getByRole('button')).toHaveAttribute('type', 'button');
|
|
200
|
+
});
|
|
201
|
+
|
|
202
|
+
it('as="div" is not given a type attribute', () => {
|
|
203
|
+
const { container } = render(<ListRow label="Row" />);
|
|
204
|
+
expect(container.firstElementChild!.hasAttribute('type')).toBe(false);
|
|
205
|
+
});
|
|
206
|
+
|
|
207
|
+
it('renders label, description and meta', () => {
|
|
208
|
+
render(<ListRow label="Name" description="Detail" meta={<span>12</span>} />);
|
|
209
|
+
expect(screen.getByText('Name')).toBeInTheDocument();
|
|
210
|
+
expect(screen.getByText('Detail')).toBeInTheDocument();
|
|
211
|
+
expect(screen.getByText('12')).toBeInTheDocument();
|
|
212
|
+
});
|
|
213
|
+
|
|
214
|
+
it('active is visual only and does not invent aria-current', () => {
|
|
215
|
+
const { container } = render(<ListRow label="Row" active />);
|
|
216
|
+
const root = container.firstElementChild!;
|
|
217
|
+
expect(root.className).toContain('bg-hover');
|
|
218
|
+
expect(root.hasAttribute('aria-current')).toBe(false);
|
|
219
|
+
});
|
|
220
|
+
});
|
|
221
|
+
|
|
222
|
+
describe('Badge', () => {
|
|
223
|
+
it.each([
|
|
224
|
+
['neutral', 'bg-sunken'],
|
|
225
|
+
['ok', 'bg-ok-soft'],
|
|
226
|
+
['wait', 'bg-wait-soft'],
|
|
227
|
+
['danger', 'bg-danger-soft'],
|
|
228
|
+
['outline', 'border-line'],
|
|
229
|
+
] as const)('tone %s uses a token background', (tone, expected) => {
|
|
230
|
+
const { container } = render(<Badge tone={tone}>x</Badge>);
|
|
231
|
+
expect(container.firstElementChild!.className).toContain(expected);
|
|
232
|
+
});
|
|
233
|
+
|
|
234
|
+
it('mono badges get the mono family for digit alignment', () => {
|
|
235
|
+
const { container } = render(<Badge mono>v1.2.0</Badge>);
|
|
236
|
+
expect(container.firstElementChild!.className).toContain('font-mono');
|
|
237
|
+
});
|
|
238
|
+
});
|
|
239
|
+
|
|
240
|
+
describe('Banner', () => {
|
|
241
|
+
it('renders nothing when it has no children', () => {
|
|
242
|
+
// 13 existing tests assert `container.firstChild` is null on conditional
|
|
243
|
+
// banners. A design-system wrapper that always renders a box breaks them.
|
|
244
|
+
const { container } = render(<Banner role="status">{null}</Banner>);
|
|
245
|
+
expect(container.firstChild).toBeNull();
|
|
246
|
+
});
|
|
247
|
+
|
|
248
|
+
it('renders nothing when children is false', () => {
|
|
249
|
+
const { container } = render(<Banner role="status">{false}</Banner>);
|
|
250
|
+
expect(container.firstChild).toBeNull();
|
|
251
|
+
});
|
|
252
|
+
|
|
253
|
+
it('is selectable by the role the caller chose', () => {
|
|
254
|
+
render(<Banner role="alert">Something broke</Banner>);
|
|
255
|
+
expect(screen.getByRole('alert')).toHaveTextContent('Something broke');
|
|
256
|
+
});
|
|
257
|
+
|
|
258
|
+
it('renders the leading icon slot', () => {
|
|
259
|
+
render(
|
|
260
|
+
<Banner role="status" icon={<span>!</span>}>
|
|
261
|
+
Note
|
|
262
|
+
</Banner>,
|
|
263
|
+
);
|
|
264
|
+
expect(screen.getByRole('status').textContent).toBe('!Note');
|
|
265
|
+
});
|
|
266
|
+
});
|
|
267
|
+
|
|
268
|
+
describe('Field', () => {
|
|
269
|
+
it('TextField defaults to type=text and forwards value/onChange', async () => {
|
|
270
|
+
const user = userEvent.setup();
|
|
271
|
+
const onChange = vi.fn();
|
|
272
|
+
render(<TextField aria-label="Search" onChange={onChange} />);
|
|
273
|
+
const input = screen.getByRole('textbox', { name: 'Search' });
|
|
274
|
+
expect(input).toHaveAttribute('type', 'text');
|
|
275
|
+
await user.type(input, 'ab');
|
|
276
|
+
expect(onChange).toHaveBeenCalledTimes(2);
|
|
277
|
+
});
|
|
278
|
+
|
|
279
|
+
it('uses an inset accent outline instead of a border-colour shift on focus', () => {
|
|
280
|
+
render(<TextField aria-label="Search" />);
|
|
281
|
+
const cls = screen.getByRole('textbox').className;
|
|
282
|
+
expect(cls).toContain('focus:outline-accent');
|
|
283
|
+
expect(cls).toContain('focus:border-transparent');
|
|
284
|
+
expect(cls).not.toMatch(/focus:border-slate/);
|
|
285
|
+
});
|
|
286
|
+
|
|
287
|
+
it('TextAreaField renders a textarea', () => {
|
|
288
|
+
render(<TextAreaField aria-label="Note" />);
|
|
289
|
+
expect(screen.getByRole('textbox', { name: 'Note' }).tagName).toBe('TEXTAREA');
|
|
290
|
+
});
|
|
291
|
+
});
|
|
292
|
+
|
|
293
|
+
describe('Menu', () => {
|
|
294
|
+
it('MenuPanel uses one radius/shadow pair for every menu in the app', () => {
|
|
295
|
+
const { container } = render(<MenuPanel>x</MenuPanel>);
|
|
296
|
+
const cls = container.firstElementChild!.className;
|
|
297
|
+
expect(cls).toContain('rounded-lg');
|
|
298
|
+
expect(cls).toContain('shadow-overlay');
|
|
299
|
+
});
|
|
300
|
+
|
|
301
|
+
it('MenuItem fires onClick and blocks it when disabled', async () => {
|
|
302
|
+
const user = userEvent.setup();
|
|
303
|
+
const onClick = vi.fn();
|
|
304
|
+
const { rerender } = render(<MenuItem onClick={onClick}>Rename</MenuItem>);
|
|
305
|
+
await user.click(screen.getByRole('button', { name: 'Rename' }));
|
|
306
|
+
expect(onClick).toHaveBeenCalledTimes(1);
|
|
307
|
+
|
|
308
|
+
rerender(
|
|
309
|
+
<MenuItem onClick={onClick} disabled>
|
|
310
|
+
Rename
|
|
311
|
+
</MenuItem>,
|
|
312
|
+
);
|
|
313
|
+
await user.click(screen.getByRole('button', { name: 'Rename' }));
|
|
314
|
+
expect(onClick).toHaveBeenCalledTimes(1);
|
|
315
|
+
});
|
|
316
|
+
|
|
317
|
+
it('MenuItem danger tone is distinguishable from default', () => {
|
|
318
|
+
const { container: a } = render(<MenuItem>Delete</MenuItem>);
|
|
319
|
+
const { container: b } = render(<MenuItem tone="danger">Delete</MenuItem>);
|
|
320
|
+
expect(a.firstElementChild!.className).not.toContain('text-danger');
|
|
321
|
+
expect(b.firstElementChild!.className).toContain('text-danger');
|
|
322
|
+
});
|
|
323
|
+
|
|
324
|
+
it('MenuItem renders the trailing adornment slot', () => {
|
|
325
|
+
render(<MenuItem trailing={<span>✓</span>}>Light</MenuItem>);
|
|
326
|
+
expect(screen.getByRole('button').textContent).toBe('Light✓');
|
|
327
|
+
});
|
|
328
|
+
|
|
329
|
+
it('MenuLabel renders its section heading', () => {
|
|
330
|
+
render(<MenuLabel>Appearance</MenuLabel>);
|
|
331
|
+
expect(screen.getByText('Appearance')).toBeInTheDocument();
|
|
332
|
+
});
|
|
333
|
+
});
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The design system's public surface.
|
|
3
|
+
*
|
|
4
|
+
* This barrel is the ONLY path anything should import a primitive from —
|
|
5
|
+
* inside this package or outside it. Phase 2 of the UI migration has ~79
|
|
6
|
+
* files importing these components; keeping them behind one entry point is
|
|
7
|
+
* what lets the individual files be refactored later without a breaking
|
|
8
|
+
* change for every consumer.
|
|
9
|
+
*
|
|
10
|
+
* In-package: import { Button } from '../../shared/components';
|
|
11
|
+
* Downstream: import { Button } from '@bevel-software/platform-core-frontend/ui';
|
|
12
|
+
*
|
|
13
|
+
* Do NOT deep-import `shared/components/Button` — the `"./src/*"` export in
|
|
14
|
+
* package.json makes that technically possible and permanently unsupported.
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
export { Button, buttonClasses } from './Button';
|
|
18
|
+
export type { ButtonProps, ButtonVariant, ButtonSize } from './Button';
|
|
19
|
+
|
|
20
|
+
export { IconButton } from './IconButton';
|
|
21
|
+
export type { IconButtonProps, IconButtonSize } from './IconButton';
|
|
22
|
+
|
|
23
|
+
export { Surface } from './Surface';
|
|
24
|
+
export type { SurfaceProps, SurfaceTone, SurfaceRadius, SurfaceElevation } from './Surface';
|
|
25
|
+
|
|
26
|
+
export { ListRow } from './ListRow';
|
|
27
|
+
export type { ListRowProps, ListRowDensity } from './ListRow';
|
|
28
|
+
|
|
29
|
+
export { Badge } from './Badge';
|
|
30
|
+
export type { BadgeProps, BadgeTone, BadgeSize } from './Badge';
|
|
31
|
+
|
|
32
|
+
export { Banner } from './Banner';
|
|
33
|
+
export type { BannerProps, BannerTone } from './Banner';
|
|
34
|
+
|
|
35
|
+
export { TextField, TextAreaField } from './Field';
|
|
36
|
+
export type { TextFieldProps, TextAreaFieldProps } from './Field';
|
|
37
|
+
|
|
38
|
+
export { MenuPanel, MenuItem, MenuLabel } from './Menu';
|
|
39
|
+
export type { MenuPanelProps, MenuItemProps } from './Menu';
|
|
40
|
+
|
|
41
|
+
/* Pre-existing components that are part of the same surface. */
|
|
42
|
+
export { Dialog } from './Dialog';
|
|
43
|
+
export type { DialogSize } from './Dialog';
|
|
44
|
+
export { PageShell } from './PageShell';
|
|
45
|
+
export type { PageShellWidth } from './PageShell';
|
|
46
|
+
export { useModalLayer } from './useModalLayer';
|
|
47
|
+
export { useDismissableMenu } from './useDismissableMenu';
|
|
48
|
+
export type { DismissableMenuOptions } from './useDismissableMenu';
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import { useEffect, useRef, type RefObject } from 'react';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* The behaviour `MenuPanel` deliberately does not provide.
|
|
5
|
+
*
|
|
6
|
+
* Its own docstring is explicit: "MenuPanel is presentation only — it does not
|
|
7
|
+
* portal, trap focus, or own open state." That is the right call for a
|
|
8
|
+
* primitive (the app's menus anchor in four different ways), but it leaves
|
|
9
|
+
* every caller to re-implement the same three things. The prototype dismisses
|
|
10
|
+
* all of its menus on an outside click and on Escape (proto:4255-4273), and a
|
|
11
|
+
* menu you can only close by picking something is a trap for anyone driving
|
|
12
|
+
* the app from the keyboard.
|
|
13
|
+
*
|
|
14
|
+
* So: outside-click closes, Escape closes, and Escape returns focus to
|
|
15
|
+
* whatever opened the menu — otherwise focus is left on a node that just
|
|
16
|
+
* unmounted and the next Tab starts from the top of the document.
|
|
17
|
+
*
|
|
18
|
+
* Returns the ref to put on the panel.
|
|
19
|
+
*/
|
|
20
|
+
export interface DismissableMenuOptions {
|
|
21
|
+
open: boolean;
|
|
22
|
+
onClose: () => void;
|
|
23
|
+
/**
|
|
24
|
+
* The control that opened the menu. Clicks on it are ignored (its own
|
|
25
|
+
* handler toggles), and Escape hands focus back to it.
|
|
26
|
+
*/
|
|
27
|
+
returnFocusTo?: RefObject<HTMLElement | null>;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export function useDismissableMenu<T extends HTMLElement>({
|
|
31
|
+
open,
|
|
32
|
+
onClose,
|
|
33
|
+
returnFocusTo,
|
|
34
|
+
}: DismissableMenuOptions): RefObject<T | null> {
|
|
35
|
+
const panelRef = useRef<T>(null);
|
|
36
|
+
|
|
37
|
+
useEffect(() => {
|
|
38
|
+
if (!open) return;
|
|
39
|
+
|
|
40
|
+
function onPointerDown(e: MouseEvent) {
|
|
41
|
+
const target = e.target as Node;
|
|
42
|
+
if (panelRef.current?.contains(target)) return;
|
|
43
|
+
// A click on the trigger is the trigger's business — closing here too
|
|
44
|
+
// would make a toggle button close-then-reopen on a single click.
|
|
45
|
+
if (returnFocusTo?.current?.contains(target)) return;
|
|
46
|
+
onClose();
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function onKey(e: KeyboardEvent) {
|
|
50
|
+
if (e.key !== 'Escape') return;
|
|
51
|
+
// Stops window-level Escape handlers from also acting on this key. It
|
|
52
|
+
// does NOT protect against a `<Dialog>` hosting the menu — Dialog binds
|
|
53
|
+
// on `document` too, and same-node listeners are unaffected by
|
|
54
|
+
// stopPropagation. Nothing here mounts a menu inside a dialog; if
|
|
55
|
+
// something ever does, the fix is `useModalLayer`, not a third
|
|
56
|
+
// listener.
|
|
57
|
+
e.stopPropagation();
|
|
58
|
+
onClose();
|
|
59
|
+
returnFocusTo?.current?.focus();
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
document.addEventListener('mousedown', onPointerDown);
|
|
63
|
+
document.addEventListener('keydown', onKey);
|
|
64
|
+
return () => {
|
|
65
|
+
document.removeEventListener('mousedown', onPointerDown);
|
|
66
|
+
document.removeEventListener('keydown', onKey);
|
|
67
|
+
};
|
|
68
|
+
}, [open, onClose, returnFocusTo]);
|
|
69
|
+
|
|
70
|
+
return panelRef;
|
|
71
|
+
}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The accent tokens must stay legible under white.
|
|
3
|
+
*
|
|
4
|
+
* Why a test and not a review habit: a contrast ratio is invisible to every
|
|
5
|
+
* gate the repo already has. Tailwind compiles `bg-accent` and `text-accent`
|
|
6
|
+
* whatever the value is, tsc has no opinion on hex, and the design-system
|
|
7
|
+
* ratchet counts OFF-system values — `bg-accent` is the on-system answer, so
|
|
8
|
+
* it stays silent no matter how light the token drifts. Nothing errors; the
|
|
9
|
+
* label just gets harder to read. Only measuring catches it.
|
|
10
|
+
*
|
|
11
|
+
* The accent is the one token where this matters, because it is the only one
|
|
12
|
+
* carrying both roles against the same white:
|
|
13
|
+
*
|
|
14
|
+
* bg-accent + text-white Button's primary variant and every control
|
|
15
|
+
* ported onto it (the prototype's `.btn.primary`)
|
|
16
|
+
* text-accent on canvas links, tab underlines, checkmarks, dirty dots
|
|
17
|
+
*
|
|
18
|
+
* Both are `--color-accent` vs `#ffffff`, so one ratio governs both and a
|
|
19
|
+
* single token edit is what fixes them. Threshold is WCAG AA for normal text
|
|
20
|
+
* (4.5:1), not large text (3:1), because these labels are text-xs/text-sm.
|
|
21
|
+
*/
|
|
22
|
+
import { describe, it, expect } from 'vitest';
|
|
23
|
+
import { readFileSync } from 'node:fs';
|
|
24
|
+
import { dirname, join } from 'node:path';
|
|
25
|
+
import { fileURLToPath } from 'node:url';
|
|
26
|
+
|
|
27
|
+
// Resolved off this file rather than `process.cwd()` so the test does not
|
|
28
|
+
// care which directory vitest was launched from. Deliberately NOT written as
|
|
29
|
+
// `new URL('../tokens.css', import.meta.url)`: Vite rewrites that exact
|
|
30
|
+
// pattern into an asset URL, and the http-scheme result fails fileURLToPath.
|
|
31
|
+
const TOKENS = readFileSync(
|
|
32
|
+
join(dirname(fileURLToPath(import.meta.url)), '..', 'tokens.css'),
|
|
33
|
+
'utf8',
|
|
34
|
+
);
|
|
35
|
+
|
|
36
|
+
/** Reads a token's literal off its declaration, ignoring hex in comments. */
|
|
37
|
+
function token(name: string): string {
|
|
38
|
+
const match = TOKENS.match(
|
|
39
|
+
new RegExp(`^\\s*--color-${name}:\\s*(#[0-9a-fA-F]{6})\\s*;`, 'm'),
|
|
40
|
+
);
|
|
41
|
+
if (!match) throw new Error(`--color-${name} not found in tokens.css`);
|
|
42
|
+
return match[1];
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** WCAG 2.1 relative luminance. */
|
|
46
|
+
function luminance(hex: string): number {
|
|
47
|
+
const channels = [1, 3, 5].map((i) => parseInt(hex.slice(i, i + 2), 16) / 255);
|
|
48
|
+
const [r, g, b] = channels.map((c) =>
|
|
49
|
+
c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4,
|
|
50
|
+
);
|
|
51
|
+
return 0.2126 * r + 0.7152 * g + 0.0722 * b;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function contrast(a: string, b: string): number {
|
|
55
|
+
const [hi, lo] = [luminance(a), luminance(b)].sort((x, y) => y - x);
|
|
56
|
+
return (hi + 0.05) / (lo + 0.05);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
const WHITE = '#ffffff';
|
|
60
|
+
const AA_NORMAL_TEXT = 4.5;
|
|
61
|
+
|
|
62
|
+
describe('accent contrast', () => {
|
|
63
|
+
// Self-check: the formula reproduces two published ratios, so a failure
|
|
64
|
+
// below is the token moving rather than the maths rotting.
|
|
65
|
+
it('computes known WCAG ratios', () => {
|
|
66
|
+
expect(contrast('#000000', WHITE)).toBeCloseTo(21, 5);
|
|
67
|
+
expect(contrast(WHITE, WHITE)).toBeCloseTo(1, 5);
|
|
68
|
+
});
|
|
69
|
+
|
|
70
|
+
it.each(['accent', 'accent-hover'])(
|
|
71
|
+
'--color-%s clears AA against white',
|
|
72
|
+
(name) => {
|
|
73
|
+
expect(contrast(token(name), WHITE)).toBeGreaterThanOrEqual(AA_NORMAL_TEXT);
|
|
74
|
+
},
|
|
75
|
+
);
|
|
76
|
+
|
|
77
|
+
// The hover step is an affordance: it has to be visible, and it has to go
|
|
78
|
+
// the same direction the prototype's did (darker, never lighter). Equal
|
|
79
|
+
// ratios would pass the check above while rendering as no feedback at all.
|
|
80
|
+
it('accent-hover is perceptibly darker than accent', () => {
|
|
81
|
+
expect(luminance(token('accent-hover'))).toBeLessThan(luminance(token('accent')));
|
|
82
|
+
expect(contrast(token('accent'), token('accent-hover'))).toBeGreaterThan(1.1);
|
|
83
|
+
});
|
|
84
|
+
});
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The design system's stylesheet: tokens only, no app chrome.
|
|
3
|
+
*
|
|
4
|
+
* Import this to get the token vocabulary without the application's base
|
|
5
|
+
* styles (resets, scrollbars, prose theming) — those live in the package's
|
|
6
|
+
* top-level `src/index.css`, which imports this file.
|
|
7
|
+
*
|
|
8
|
+
* Consumers reach this as `@bevel-software/platform-core-frontend/theme.css`.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
@import './tokens.css';
|
|
12
|
+
@import './shadows.css';
|