@bevel-software/platform-core-frontend 0.15.1 → 0.19.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/THIRD-PARTY-NOTICES.md +2 -2
- package/package.json +3 -3
- package/src/core/CoreAppShell.tsx +16 -9
- package/src/core/__tests__/AppChrome.test.tsx +0 -3
- package/src/core/__tests__/events.test.ts +43 -0
- package/src/core/bootstrap.ts +11 -3
- package/src/core/events.ts +85 -3
- package/src/core/registry.ts +1 -1
- package/src/lib/__tests__/email.test.ts +44 -0
- package/src/lib/email.ts +37 -1
- package/src/modules/access/__tests__/ManageAccessDialog.add-row-picking.test.tsx +141 -0
- package/src/modules/access/__tests__/ManageAccessDialog.chip-truncation.test.tsx +204 -0
- package/src/modules/access/__tests__/ManageAccessDialog.download-read.test.tsx +234 -0
- package/src/modules/access/__tests__/ManageAccessDialog.edited-row-visible.test.tsx +160 -0
- package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +2 -2
- package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +166 -0
- package/src/modules/access/__tests__/ManageAccessDialog.restrict.test.tsx +510 -0
- package/src/modules/access/__tests__/ManageAccessDialog.row-menu-axes.test.tsx +299 -0
- package/src/modules/access/__tests__/ManageAccessDialog.row-menu-width.test.tsx +226 -0
- package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +721 -126
- package/src/modules/access/__tests__/ManageAccessDialog.unknown-email.test.tsx +314 -0
- package/src/modules/access/__tests__/manage-access-affordance.test.ts +14 -0
- package/src/modules/access/__tests__/tailwindDeclarations.ts +210 -0
- package/src/modules/access/api.ts +140 -6
- package/src/modules/access/components/ManageAccessDialog.tsx +1299 -561
- package/src/modules/access/manage-access-affordance.ts +17 -0
- package/src/modules/admin/__tests__/AddMemberInput.test.tsx +297 -0
- package/src/modules/admin/__tests__/AdminRolesPage.capabilities.test.tsx +2 -2
- package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +189 -0
- package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +1 -1
- package/src/modules/admin/__tests__/ConnectionKeysPage.test.tsx +266 -0
- package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
- package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
- package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
- package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
- package/src/modules/admin/components/AddMemberInput.tsx +268 -0
- package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
- package/src/modules/admin/components/ConnectionKeysPage.tsx +269 -0
- package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
- package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
- package/src/modules/admin/components/connection-keys-grouping.ts +43 -0
- package/src/modules/admin/components/group-members-path.ts +32 -0
- package/src/modules/admin/services/connection-keys.api.ts +47 -0
- package/src/modules/admin/services/roles.api.ts +12 -1
- package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
- package/src/modules/auth/components/AccountPage.tsx +73 -54
- package/src/modules/auth/components/LoginScreen.tsx +1 -0
- package/src/modules/auth/services/account.api.ts +78 -4
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
- package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
- package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
- package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
- package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
- package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
- package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
- package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
- package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
- package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
- package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
- package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
- package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
- package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
- package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
- package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
- package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
- package/src/modules/change-requests/services/change-requests.api.ts +57 -1
- package/src/modules/change-requests/services/denied-file.api.ts +53 -0
- package/src/modules/change-requests/services/propose.api.ts +97 -8
- package/src/modules/change-requests/utils/approval.ts +15 -0
- package/src/modules/change-requests/utils/author.ts +32 -0
- package/src/modules/change-requests/utils/readFailure.ts +110 -0
- package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
- package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
- package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
- package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
- package/src/modules/git/services/error-messages.ts +12 -0
- package/src/modules/git/services/pr-prompts.ts +5 -5
- package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
- package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
- package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
- package/src/modules/layout/components/AppLayout.tsx +2 -0
- package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
- package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
- package/src/modules/layout/components/SidebarFrame.tsx +108 -3
- package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
- package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
- package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
- package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
- package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
- package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +103 -98
- package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +20 -5
- package/src/modules/library/__tests__/LockedPluginView.test.tsx +97 -7
- package/src/modules/library/__tests__/NewPluginDialog.test.tsx +13 -4
- package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
- package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
- package/src/modules/library/__tests__/PluginExtras.test.tsx +100 -9
- package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
- package/src/modules/library/__tests__/PluginPage.test.tsx +258 -6
- package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +16 -56
- package/src/modules/library/__tests__/PluginsSidebar.test.tsx +155 -152
- package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
- package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
- package/src/modules/library/__tests__/SkillPage.test.tsx +386 -80
- package/src/modules/library/__tests__/SkillsTree.test.tsx +293 -4
- package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
- package/src/modules/library/__tests__/ToolPage.test.tsx +87 -4
- package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +173 -26
- package/src/modules/library/__tests__/auth-harness.tsx +9 -9
- package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
- package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
- package/src/modules/library/__tests__/library-data.stale.test.tsx +121 -28
- package/src/modules/library/__tests__/library-data.test.ts +7 -0
- package/src/modules/library/__tests__/library-paths.test.ts +47 -4
- package/src/modules/library/__tests__/link-membership.test.ts +13 -4
- package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
- package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
- package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
- package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
- package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
- package/src/modules/library/__tests__/plugin-summary.test.ts +36 -1
- package/src/modules/library/__tests__/status.test.ts +82 -2
- package/src/modules/library/__tests__/tools.api.test.ts +44 -1
- package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
- package/src/modules/library/components/AddDialogTabs.tsx +103 -0
- package/src/modules/library/components/AddToPluginDialog.tsx +74 -18
- package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
- package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
- package/src/modules/library/components/LibraryCard.tsx +146 -45
- package/src/modules/library/components/LibraryLayout.tsx +119 -256
- package/src/modules/library/components/LibraryPage.tsx +172 -39
- package/src/modules/library/components/LinkSkillPanel.tsx +1 -3
- package/src/modules/library/components/LockedPluginView.tsx +62 -34
- package/src/modules/library/components/NameWithBadges.tsx +164 -0
- package/src/modules/library/components/NewPluginDialog.tsx +16 -2
- package/src/modules/library/components/PageActions.tsx +11 -9
- package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
- package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
- package/src/modules/library/components/PersonalPluginPage.tsx +121 -22
- package/src/modules/library/components/PluginExtras.tsx +140 -17
- package/src/modules/library/components/PluginIndexRow.tsx +47 -12
- package/src/modules/library/components/PluginPage.tsx +157 -41
- package/src/modules/library/components/PluginRows.tsx +286 -0
- package/src/modules/library/components/PluginsSidebar.tsx +239 -263
- package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
- package/src/modules/library/components/ShareButton.tsx +17 -0
- package/src/modules/library/components/SkillsTree.tsx +141 -28
- package/src/modules/library/components/TeamRoute.tsx +15 -0
- package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
- package/src/modules/library/components/plugin-page-parts.tsx +103 -17
- package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +6 -12
- package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
- package/src/modules/library/components/skill-page/SkillPage.tsx +274 -122
- package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
- package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
- package/src/modules/library/components/tool-page/ToolPage.tsx +106 -16
- package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
- package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
- package/src/modules/library/hooks/useLibraryData.ts +92 -19
- package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
- package/src/modules/library/routes/WorkspaceItemRoute.tsx +77 -27
- package/src/modules/library/routes/library-paths.ts +26 -28
- package/src/modules/library/services/library.api.ts +38 -20
- package/src/modules/library/services/plugins.api.ts +69 -8
- package/src/modules/library/services/teams.api.ts +15 -0
- package/src/modules/library/services/tools.api.ts +78 -0
- package/src/modules/library/state/library-data.tsx +170 -32
- package/src/modules/library/utils/personal-plugin.ts +13 -15
- package/src/modules/library/utils/plugin-entries.ts +134 -0
- package/src/modules/library/utils/plugin-summary.ts +75 -9
- package/src/modules/library/utils/status.ts +135 -33
- package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +8 -1
- package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
- package/src/modules/onboarding/agent-clients.ts +55 -23
- package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
- package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
- package/src/modules/pr/services/pr-merge.api.ts +2 -1
- package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
- package/src/modules/review/components/ReviewPanel.tsx +15 -17
- package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
- package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
- package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
- package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
- package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
- package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
- package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
- package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
- package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
- package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
- package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
- package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
- package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
- package/src/modules/secrets-vault/services/connect.api.ts +36 -5
- package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
- package/src/modules/settings/components/ClaudeConnectionCard.tsx +9 -24
- package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
- package/src/modules/settings/components/DeploymentPage.tsx +10 -30
- package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
- package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +67 -4
- package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
- package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +5 -5
- package/src/modules/settings/services/github-facade.api.ts +23 -0
- package/src/modules/settings/settings-nav-items.tsx +10 -2
- package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
- package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
- package/src/modules/setup/__tests__/setup.test.tsx +497 -4
- package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
- package/src/modules/setup/components/SetupGate.tsx +16 -16
- package/src/modules/setup/components/SetupScreen.tsx +521 -43
- package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
- package/src/modules/setup/services/setup.api.ts +140 -3
- package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
- package/src/modules/setup/utils/root-folders.ts +46 -0
- package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
- package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
- package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
- package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
- package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
- package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +177 -118
- package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
- package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
- package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
- package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +542 -42
- package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
- package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
- package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
- package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
- package/src/modules/toolbar/components/deployment-address.ts +29 -0
- package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
- package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
- package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
- package/src/modules/toolbar/services/external-api-keys.api.ts +6 -0
- package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
- package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
- package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
- package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
- package/src/modules/workflow/state/event-bus.context.ts +10 -0
- package/src/modules/workspace/__tests__/testFixtures.ts +5 -3
- package/src/modules/workspace/components/FileExplorer.tsx +1295 -191
- package/src/modules/workspace/components/FileRoute.tsx +353 -36
- package/src/modules/workspace/components/FileViewer.tsx +166 -45
- package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
- package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
- package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
- package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2473 -129
- package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +731 -18
- package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +331 -12
- package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
- package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
- package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
- package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
- package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
- package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
- package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
- package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
- package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
- package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
- package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
- package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
- package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
- package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
- package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
- package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
- package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
- package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
- package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
- package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
- package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
- package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
- package/src/modules/workspace/components/renderers/index.ts +53 -2
- package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
- package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
- package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
- package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
- package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
- package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
- package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
- package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +22 -3
- package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
- package/src/modules/workspace/hooks/useWorkspaceState.ts +424 -66
- package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
- package/src/modules/workspace/routing/kb-routes.ts +206 -29
- package/src/modules/workspace/services/__tests__/workspace.api.test.ts +57 -1
- package/src/modules/workspace/services/workspace.api.ts +57 -4
- package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
- package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
- package/src/modules/workspace/state/open-change-requests.tsx +100 -12
- package/src/modules/workspace/state/workspace.context.ts +125 -19
- package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
- package/src/modules/workspace/utils/__tests__/fileTree.test.ts +220 -6
- package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
- package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
- package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
- package/src/modules/workspace/utils/file-trace.ts +50 -0
- package/src/modules/workspace/utils/fileTree.ts +112 -36
- package/src/modules/workspace/utils/frontmatter.ts +8 -4
- package/src/modules/workspace/utils/pasteLink.ts +90 -0
- package/src/modules/workspace/utils/treeConfirm.ts +338 -0
- package/src/modules/workspace/utils/uploadError.ts +29 -0
- package/src/shared/__tests__/marketplace-url.test.ts +6 -1
- package/src/shared/components/Button.tsx +16 -2
- package/src/shared/components/Dialog.tsx +27 -11
- package/src/shared/components/Menu.tsx +13 -1
- package/src/shared/components/PageShell.tsx +13 -8
- package/src/shared/components/__tests__/primitives.test.tsx +116 -2
- package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
- package/src/shared/components/index.ts +2 -0
- package/src/shared/components/useDismissableMenu.ts +32 -10
- package/src/shared/components/useFocusHandoff.ts +51 -0
- package/src/shared/components/useLatestRef.ts +28 -0
- package/src/shared/markdown/Markdown.tsx +12 -3
- package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
- package/src/shared/markdown/hrefs.ts +50 -0
- package/src/shared/marketplace-url.ts +33 -5
- package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
- package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
- package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
- package/src/shared/mcp/connect-snippets.ts +14 -9
- package/src/shared/mcp/index.ts +1 -1
- package/src/shared/theme/__tests__/header-band.test.ts +197 -0
- package/src/shared/theme/header.ts +75 -0
- package/src/shared/theme/measure.ts +7 -4
- package/src/shared/theme/tokens.css +25 -0
- package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
- package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
- package/src/modules/library/components/PluginsIndexPage.tsx +0 -270
- package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
- package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
- package/src/modules/update-check/services/update-check.api.ts +0 -24
|
@@ -0,0 +1,314 @@
|
|
|
1
|
+
import { describe, it, expect, vi, beforeEach } from 'vitest';
|
|
2
|
+
import { render, screen, waitFor, within } from '@testing-library/react';
|
|
3
|
+
import userEvent from '@testing-library/user-event';
|
|
4
|
+
import type { FileTreeEntry } from '@bevel-software/platform-shared';
|
|
5
|
+
import type { AccessResponse } from '../api';
|
|
6
|
+
|
|
7
|
+
// --- Mock the API module ----------------------------------------------------
|
|
8
|
+
const api = vi.hoisted(() => ({
|
|
9
|
+
fetchFileAccess: vi.fn(),
|
|
10
|
+
grantAccess: vi.fn(),
|
|
11
|
+
revokeAccess: vi.fn(),
|
|
12
|
+
suggestPrincipals: vi.fn(),
|
|
13
|
+
}));
|
|
14
|
+
vi.mock('../api', async (importOriginal) => {
|
|
15
|
+
const actual = await importOriginal<typeof import('../api')>();
|
|
16
|
+
return { ...actual, ...api };
|
|
17
|
+
});
|
|
18
|
+
|
|
19
|
+
// --- Mock the context hooks the dialog reads --------------------------------
|
|
20
|
+
vi.mock('../../workspace/state/workspace.context', () => ({
|
|
21
|
+
useWorkspace: () => ({ workspaceId: 'ws-1', kbDirName: 'knowledge-base' }),
|
|
22
|
+
}));
|
|
23
|
+
vi.mock('../../auth/state/auth.context', () => ({
|
|
24
|
+
useAuth: () => ({ user: { email: 'me@x.com', name: 'Me' } }),
|
|
25
|
+
}));
|
|
26
|
+
|
|
27
|
+
import { ManageAccessDialog } from '../components/ManageAccessDialog';
|
|
28
|
+
|
|
29
|
+
const KB = 'knowledge-base';
|
|
30
|
+
const ENTRY: FileTreeEntry = {
|
|
31
|
+
name: 'Deal.md',
|
|
32
|
+
relativePath: `${KB}/Sales/Deal.md`,
|
|
33
|
+
type: 'file',
|
|
34
|
+
} as unknown as FileTreeEntry;
|
|
35
|
+
|
|
36
|
+
const KNOWN = { name: 'Alice', email: 'alice@x.com' };
|
|
37
|
+
const UNKNOWN = { name: 'new.colleague', email: 'new.colleague@company.com' };
|
|
38
|
+
|
|
39
|
+
const NOTE = /hasn't signed in yet/i;
|
|
40
|
+
|
|
41
|
+
/** A view granting `users` read directly on the file. */
|
|
42
|
+
const viewWith = (users: { name: string; email: string; hasAccount?: boolean }[]): AccessResponse =>
|
|
43
|
+
({
|
|
44
|
+
canRead: true,
|
|
45
|
+
canWrite: true,
|
|
46
|
+
canDownload: false,
|
|
47
|
+
canOwner: false,
|
|
48
|
+
eligible: { roles: [], users: [] },
|
|
49
|
+
readers: { restricted: true, roles: [], users },
|
|
50
|
+
owners: { roles: [], users: [] },
|
|
51
|
+
downloaders: { roles: [], users: [] },
|
|
52
|
+
sources: Object.fromEntries(
|
|
53
|
+
users.map((u) => [`u:${u.email.toLowerCase()}`, { read: [{ kind: 'direct' }] }]),
|
|
54
|
+
),
|
|
55
|
+
}) as AccessResponse;
|
|
56
|
+
|
|
57
|
+
const EMPTY = viewWith([]);
|
|
58
|
+
|
|
59
|
+
/** The chip is the element its remove button sits in. */
|
|
60
|
+
function chipFor(label: string): HTMLElement {
|
|
61
|
+
const remove = screen.getByRole('button', { name: `Remove ${label}` });
|
|
62
|
+
const chip = remove.parentElement;
|
|
63
|
+
if (!chip) throw new Error(`chip for ${label} has no parent`);
|
|
64
|
+
return chip;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/** The grantee row for a person, found from the name it renders (once loaded). */
|
|
68
|
+
async function rowFor(name: string): Promise<HTMLElement> {
|
|
69
|
+
const label = await screen.findByText(name);
|
|
70
|
+
const row = label.closest('div.flex.flex-wrap');
|
|
71
|
+
if (!row) throw new Error(`no row around ${name}`);
|
|
72
|
+
return row as HTMLElement;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Typing an email nobody has an account for is allowed — this is the whole
|
|
77
|
+
* decision the ticket records — so the dialog says so instead of refusing:
|
|
78
|
+
* "hasn't signed in yet" beside the chip while the grant is being composed,
|
|
79
|
+
* and beside the name once it is saved. It is a label and nothing else; the
|
|
80
|
+
* grant call is identical either way, and the note goes when the person does
|
|
81
|
+
* sign in.
|
|
82
|
+
*/
|
|
83
|
+
describe('ManageAccessDialog: an email with no account is labelled, not refused', () => {
|
|
84
|
+
beforeEach(() => {
|
|
85
|
+
vi.clearAllMocks();
|
|
86
|
+
api.fetchFileAccess.mockResolvedValue(EMPTY);
|
|
87
|
+
api.grantAccess.mockResolvedValue(EMPTY);
|
|
88
|
+
api.suggestPrincipals.mockResolvedValue({
|
|
89
|
+
roles: [],
|
|
90
|
+
groups: [],
|
|
91
|
+
people: [],
|
|
92
|
+
peopleWithheld: false,
|
|
93
|
+
accountsKnown: true,
|
|
94
|
+
});
|
|
95
|
+
});
|
|
96
|
+
|
|
97
|
+
it('a typed UNKNOWN email chips with the note, and Share still saves the grant', async () => {
|
|
98
|
+
const user = userEvent.setup();
|
|
99
|
+
// The server knows of nobody by this address — the unknown case.
|
|
100
|
+
api.suggestPrincipals.mockResolvedValue({
|
|
101
|
+
roles: [],
|
|
102
|
+
groups: [],
|
|
103
|
+
people: [],
|
|
104
|
+
peopleWithheld: false,
|
|
105
|
+
accountsKnown: true,
|
|
106
|
+
});
|
|
107
|
+
render(<ManageAccessDialog entry={ENTRY} onClose={() => {}} />);
|
|
108
|
+
|
|
109
|
+
const input = await screen.findByPlaceholderText('Add people, groups, roles or plugins…');
|
|
110
|
+
await user.type(input, UNKNOWN.email);
|
|
111
|
+
await waitFor(() => expect(api.suggestPrincipals).toHaveBeenCalled());
|
|
112
|
+
await user.keyboard('{Enter}');
|
|
113
|
+
|
|
114
|
+
// The chip exists, carries the note, and is removable like any other.
|
|
115
|
+
const chip = chipFor(UNKNOWN.name);
|
|
116
|
+
expect(within(chip).getByText(NOTE)).toBeInTheDocument();
|
|
117
|
+
|
|
118
|
+
// And the grant saves — unchanged, with the typed address.
|
|
119
|
+
await user.click(screen.getByRole('button', { name: /^share$/i }));
|
|
120
|
+
await waitFor(() => expect(api.grantAccess).toHaveBeenCalled());
|
|
121
|
+
expect(api.grantAccess).toHaveBeenCalledWith(
|
|
122
|
+
'ws-1',
|
|
123
|
+
expect.objectContaining({
|
|
124
|
+
principal: { kind: 'user', email: UNKNOWN.email, displayName: UNKNOWN.name },
|
|
125
|
+
}),
|
|
126
|
+
);
|
|
127
|
+
});
|
|
128
|
+
|
|
129
|
+
it('a typed KNOWN email chips with no note', async () => {
|
|
130
|
+
const user = userEvent.setup();
|
|
131
|
+
api.suggestPrincipals.mockResolvedValue({
|
|
132
|
+
roles: [],
|
|
133
|
+
groups: [],
|
|
134
|
+
people: [{ ...KNOWN, hasAccount: true }],
|
|
135
|
+
peopleWithheld: false,
|
|
136
|
+
accountsKnown: true,
|
|
137
|
+
});
|
|
138
|
+
render(<ManageAccessDialog entry={ENTRY} onClose={() => {}} />);
|
|
139
|
+
|
|
140
|
+
const input = await screen.findByPlaceholderText('Add people, groups, roles or plugins…');
|
|
141
|
+
await user.type(input, KNOWN.email);
|
|
142
|
+
await waitFor(() => expect(api.suggestPrincipals).toHaveBeenCalled());
|
|
143
|
+
await user.keyboard('{Enter}');
|
|
144
|
+
|
|
145
|
+
expect(within(chipFor('alice')).queryByText(NOTE)).toBeNull();
|
|
146
|
+
});
|
|
147
|
+
|
|
148
|
+
it('an older server that says nothing about accounts labels nobody', async () => {
|
|
149
|
+
const user = userEvent.setup();
|
|
150
|
+
// No `hasAccount` anywhere — version skew. Silence is not "no account".
|
|
151
|
+
api.suggestPrincipals.mockResolvedValue({
|
|
152
|
+
roles: [],
|
|
153
|
+
groups: [],
|
|
154
|
+
people: [{ name: KNOWN.name, email: KNOWN.email }],
|
|
155
|
+
peopleWithheld: false,
|
|
156
|
+
});
|
|
157
|
+
render(<ManageAccessDialog entry={ENTRY} onClose={() => {}} />);
|
|
158
|
+
|
|
159
|
+
const input = await screen.findByPlaceholderText('Add people, groups, roles or plugins…');
|
|
160
|
+
await user.type(input, KNOWN.email);
|
|
161
|
+
await waitFor(() => expect(api.suggestPrincipals).toHaveBeenCalled());
|
|
162
|
+
await user.keyboard('{Enter}');
|
|
163
|
+
|
|
164
|
+
expect(within(chipFor('alice')).queryByText(NOTE)).toBeNull();
|
|
165
|
+
});
|
|
166
|
+
|
|
167
|
+
it('an older server labels nobody even for an address it never names', async () => {
|
|
168
|
+
const user = userEvent.setup();
|
|
169
|
+
// Version skew again, this time with the address absent from the answer.
|
|
170
|
+
// An old build does not report accounts at all, so "not in the answer"
|
|
171
|
+
// carries no information about accounts and the chip stays unlabelled —
|
|
172
|
+
// the previous behaviour was to read that silence as "no account" and
|
|
173
|
+
// accuse every free-typed address.
|
|
174
|
+
api.suggestPrincipals.mockResolvedValue({
|
|
175
|
+
roles: [],
|
|
176
|
+
groups: [],
|
|
177
|
+
people: [],
|
|
178
|
+
peopleWithheld: false,
|
|
179
|
+
});
|
|
180
|
+
render(<ManageAccessDialog entry={ENTRY} onClose={() => {}} />);
|
|
181
|
+
|
|
182
|
+
const input = await screen.findByPlaceholderText('Add people, groups, roles or plugins…');
|
|
183
|
+
await user.type(input, UNKNOWN.email);
|
|
184
|
+
await waitFor(() => expect(api.suggestPrincipals).toHaveBeenCalled());
|
|
185
|
+
await user.keyboard('{Enter}');
|
|
186
|
+
|
|
187
|
+
expect(within(chipFor(UNKNOWN.name)).queryByText(NOTE)).toBeNull();
|
|
188
|
+
});
|
|
189
|
+
|
|
190
|
+
it('autocomplete being DOWN labels nobody — and the grant still saves', async () => {
|
|
191
|
+
const user = userEvent.setup();
|
|
192
|
+
// No answer at all. Nothing was ruled on, so nothing is claimed: the note
|
|
193
|
+
// would otherwise appear on every address typed while suggest is failing.
|
|
194
|
+
api.suggestPrincipals.mockRejectedValue(new Error('suggest unavailable'));
|
|
195
|
+
render(<ManageAccessDialog entry={ENTRY} onClose={() => {}} />);
|
|
196
|
+
|
|
197
|
+
const input = await screen.findByPlaceholderText('Add people, groups, roles or plugins…');
|
|
198
|
+
await user.type(input, UNKNOWN.email);
|
|
199
|
+
await waitFor(() => expect(api.suggestPrincipals).toHaveBeenCalled());
|
|
200
|
+
await user.keyboard('{Enter}');
|
|
201
|
+
|
|
202
|
+
expect(within(chipFor(UNKNOWN.name)).queryByText(NOTE)).toBeNull();
|
|
203
|
+
|
|
204
|
+
// The point of the ticket survives the outage: the grant is never gated
|
|
205
|
+
// on knowing whether an account exists.
|
|
206
|
+
await user.click(screen.getByRole('button', { name: /^share$/i }));
|
|
207
|
+
await waitFor(() => expect(api.grantAccess).toHaveBeenCalled());
|
|
208
|
+
});
|
|
209
|
+
|
|
210
|
+
it('a later answer that says the account is GONE relabels the chip', async () => {
|
|
211
|
+
const user = userEvent.setup();
|
|
212
|
+
// An account can be erased while this dialog is open. The first answer
|
|
213
|
+
// said the address had one; the second explicitly says it does not, and
|
|
214
|
+
// that has to be able to take the earlier claim back.
|
|
215
|
+
let signedIn = true;
|
|
216
|
+
api.suggestPrincipals.mockImplementation(async () => ({
|
|
217
|
+
roles: [],
|
|
218
|
+
groups: [],
|
|
219
|
+
people: [{ ...KNOWN, hasAccount: signedIn }],
|
|
220
|
+
peopleWithheld: false,
|
|
221
|
+
accountsKnown: true,
|
|
222
|
+
}));
|
|
223
|
+
render(<ManageAccessDialog entry={ENTRY} onClose={() => {}} />);
|
|
224
|
+
|
|
225
|
+
const input = await screen.findByPlaceholderText('Add people, groups, roles or plugins…');
|
|
226
|
+
await user.type(input, KNOWN.email);
|
|
227
|
+
await waitFor(() => expect(api.suggestPrincipals).toHaveBeenCalled());
|
|
228
|
+
await user.keyboard('{Enter}');
|
|
229
|
+
expect(within(chipFor('alice')).queryByText(NOTE)).toBeNull();
|
|
230
|
+
|
|
231
|
+
signedIn = false;
|
|
232
|
+
await user.type(input, 'alice');
|
|
233
|
+
await waitFor(() =>
|
|
234
|
+
expect(within(chipFor('alice')).getByText(NOTE)).toBeInTheDocument(),
|
|
235
|
+
);
|
|
236
|
+
});
|
|
237
|
+
|
|
238
|
+
it('an answer that WITHHELD people labels nobody, however it flags itself', async () => {
|
|
239
|
+
const user = userEvent.setup();
|
|
240
|
+
// The harvesting guard returns nobody by design. Its empty list is not
|
|
241
|
+
// evidence that nobody has an account — read that way it would label
|
|
242
|
+
// every address at once — so the dialog refuses it even when the answer
|
|
243
|
+
// also claims to rule on accounts, which a correct server never does.
|
|
244
|
+
api.suggestPrincipals.mockResolvedValue({
|
|
245
|
+
roles: [],
|
|
246
|
+
groups: [],
|
|
247
|
+
people: [],
|
|
248
|
+
peopleWithheld: true,
|
|
249
|
+
accountsKnown: true,
|
|
250
|
+
});
|
|
251
|
+
render(<ManageAccessDialog entry={ENTRY} onClose={() => {}} />);
|
|
252
|
+
|
|
253
|
+
const input = await screen.findByPlaceholderText('Add people, groups, roles or plugins…');
|
|
254
|
+
await user.type(input, UNKNOWN.email);
|
|
255
|
+
await waitFor(() => expect(api.suggestPrincipals).toHaveBeenCalled());
|
|
256
|
+
await user.keyboard('{Enter}');
|
|
257
|
+
|
|
258
|
+
expect(within(chipFor(UNKNOWN.name)).queryByText(NOTE)).toBeNull();
|
|
259
|
+
});
|
|
260
|
+
|
|
261
|
+
it('a direct-grant ROW for an unknown email carries the note beside the name', async () => {
|
|
262
|
+
api.fetchFileAccess.mockResolvedValue(
|
|
263
|
+
viewWith([
|
|
264
|
+
{ ...KNOWN, hasAccount: true },
|
|
265
|
+
{ ...UNKNOWN, hasAccount: false },
|
|
266
|
+
]),
|
|
267
|
+
);
|
|
268
|
+
render(<ManageAccessDialog entry={ENTRY} onClose={() => {}} />);
|
|
269
|
+
|
|
270
|
+
const unknownRow = await rowFor(UNKNOWN.name);
|
|
271
|
+
expect(within(unknownRow).getByText(NOTE)).toBeInTheDocument();
|
|
272
|
+
// The one who has signed in is not labelled — the note names a difference.
|
|
273
|
+
expect(within(await rowFor(KNOWN.name)).queryByText(NOTE)).toBeNull();
|
|
274
|
+
});
|
|
275
|
+
|
|
276
|
+
it('a person only RESTRICTED here carries the note too', async () => {
|
|
277
|
+
// A `deny` on a mistyped address restricts nobody and looks fine; the
|
|
278
|
+
// restricted row is the one place that typo would otherwise stay hidden.
|
|
279
|
+
api.fetchFileAccess.mockResolvedValue({
|
|
280
|
+
...EMPTY,
|
|
281
|
+
deniedHere: {
|
|
282
|
+
principals: [],
|
|
283
|
+
users: [
|
|
284
|
+
{ ...KNOWN, hasAccount: true },
|
|
285
|
+
{ ...UNKNOWN, hasAccount: false },
|
|
286
|
+
],
|
|
287
|
+
},
|
|
288
|
+
// The `deny` is written HERE, which is what gives a restricted-only
|
|
289
|
+
// person a direct row of their own (see `classifyManage`).
|
|
290
|
+
denials: {
|
|
291
|
+
[`u:${KNOWN.email}`]: { read: [{ kind: 'direct' }] },
|
|
292
|
+
[`u:${UNKNOWN.email}`]: { read: [{ kind: 'direct' }] },
|
|
293
|
+
},
|
|
294
|
+
} as AccessResponse);
|
|
295
|
+
render(<ManageAccessDialog entry={ENTRY} onClose={() => {}} />);
|
|
296
|
+
|
|
297
|
+
expect(within(await rowFor(UNKNOWN.name)).getByText(NOTE)).toBeInTheDocument();
|
|
298
|
+
expect(within(await rowFor(KNOWN.name)).queryByText(NOTE)).toBeNull();
|
|
299
|
+
});
|
|
300
|
+
|
|
301
|
+
it('the row note disappears once that person has signed in', async () => {
|
|
302
|
+
// Same grant, two loads of the dialog: before the first sign-in and after
|
|
303
|
+
// it. Nothing about the grant changed in between.
|
|
304
|
+
api.fetchFileAccess.mockResolvedValue(viewWith([{ ...UNKNOWN, hasAccount: false }]));
|
|
305
|
+
const before = render(<ManageAccessDialog entry={ENTRY} onClose={() => {}} />);
|
|
306
|
+
expect(within(await rowFor(UNKNOWN.name)).getByText(NOTE)).toBeInTheDocument();
|
|
307
|
+
before.unmount();
|
|
308
|
+
|
|
309
|
+
api.fetchFileAccess.mockResolvedValue(viewWith([{ ...UNKNOWN, hasAccount: true }]));
|
|
310
|
+
render(<ManageAccessDialog entry={ENTRY} onClose={() => {}} />);
|
|
311
|
+
await waitFor(() => expect(screen.getByText(UNKNOWN.name)).toBeInTheDocument());
|
|
312
|
+
expect(screen.queryByText(NOTE)).toBeNull();
|
|
313
|
+
});
|
|
314
|
+
});
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { describe, it, expect } from 'vitest';
|
|
2
|
+
import { offersManageAccess } from '../manage-access-affordance';
|
|
3
|
+
|
|
4
|
+
describe('offersManageAccess', () => {
|
|
5
|
+
it("withholds it from the tree's own root row", () => {
|
|
6
|
+
expect(offersManageAccess({ relativePath: '.' })).toBe(false);
|
|
7
|
+
});
|
|
8
|
+
|
|
9
|
+
it('offers it on any folder or file inside the tree, a skill folder included', () => {
|
|
10
|
+
expect(offersManageAccess({ relativePath: 'knowledge-base/Sales' })).toBe(true);
|
|
11
|
+
expect(offersManageAccess({ relativePath: 'knowledge-base/Skills/newsletter' })).toBe(true);
|
|
12
|
+
expect(offersManageAccess({ relativePath: 'knowledge-base/Sales/Deal.md' })).toBe(true);
|
|
13
|
+
});
|
|
14
|
+
});
|
|
@@ -0,0 +1,210 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Resolve an element's utility classes to the declarations a browser would
|
|
3
|
+
* actually apply, by compiling THIS project's stylesheet with THIS project's
|
|
4
|
+
* Tailwind.
|
|
5
|
+
*
|
|
6
|
+
* `toHaveClass('truncate')` is not a layout assertion: happy-dom loads no
|
|
7
|
+
* stylesheet, so the class could be purged, renamed, or generating something
|
|
8
|
+
* else entirely and the assertion would still pass while the chip overflowed.
|
|
9
|
+
* Compiling `src/index.css` closes that gap — a utility that stops producing
|
|
10
|
+
* `text-overflow: ellipsis` (a Tailwind upgrade, a theme edit, a broken CSS
|
|
11
|
+
* build) fails the test — and it frees the assertion from the class STRING:
|
|
12
|
+
* any class that yields the same declarations reads the same here, so the chip
|
|
13
|
+
* can be refactored or restyled without a test edit.
|
|
14
|
+
*
|
|
15
|
+
* It is not a renderer. It says what CSS the element is given, not what the
|
|
16
|
+
* box then measures; pixels are the visual check's job.
|
|
17
|
+
*/
|
|
18
|
+
import { compile } from 'tailwindcss';
|
|
19
|
+
import fs from 'node:fs/promises';
|
|
20
|
+
import path from 'node:path';
|
|
21
|
+
import { createRequire } from 'node:module';
|
|
22
|
+
import { fileURLToPath } from 'node:url';
|
|
23
|
+
|
|
24
|
+
const require = createRequire(import.meta.url);
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* The application stylesheet: Tailwind, the design tokens and the plugins.
|
|
28
|
+
*
|
|
29
|
+
* Resolved through `path`, not `new URL(…, import.meta.url)` — Vite rewrites
|
|
30
|
+
* that exact form into an asset URL (`http://localhost/src/index.css`), which
|
|
31
|
+
* is not a path this can read.
|
|
32
|
+
*/
|
|
33
|
+
const APP_STYLESHEET = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../../index.css');
|
|
34
|
+
const TAILWIND_ROOT = path.dirname(require.resolve('tailwindcss/package.json'));
|
|
35
|
+
|
|
36
|
+
/** A rule's declarations, keyed by CSS property: `{ 'max-width': '100%' }`. */
|
|
37
|
+
export type Declarations = Record<string, string>;
|
|
38
|
+
|
|
39
|
+
async function loadStylesheet(id: string, base: string) {
|
|
40
|
+
let file: string;
|
|
41
|
+
if (id === 'tailwindcss') file = path.join(TAILWIND_ROOT, 'index.css');
|
|
42
|
+
else if (id.startsWith('tailwindcss/')) file = path.join(TAILWIND_ROOT, id.slice('tailwindcss/'.length));
|
|
43
|
+
else file = path.resolve(base, id);
|
|
44
|
+
if (!file.endsWith('.css')) file += '.css';
|
|
45
|
+
return { path: file, base: path.dirname(file), content: await fs.readFile(file, 'utf8') };
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* `@plugin "…"`. Loaded with `require`, not `import()`: Vite rewrites a dynamic
|
|
50
|
+
* import of a variable and warns about it, and Node ≥22.13 (this repo's engine)
|
|
51
|
+
* requires ESM as happily as CJS.
|
|
52
|
+
*/
|
|
53
|
+
type LoadModule = NonNullable<Parameters<typeof compile>[1]>['loadModule'];
|
|
54
|
+
const loadModule: NonNullable<LoadModule> = async (id, base) => {
|
|
55
|
+
const resolved = require.resolve(id, { paths: [base, path.dirname(APP_STYLESHEET)] });
|
|
56
|
+
const loaded: unknown = require(resolved);
|
|
57
|
+
const module = (loaded as { default?: unknown }).default ?? loaded;
|
|
58
|
+
return { path: resolved, base: path.dirname(resolved), module } as Awaited<
|
|
59
|
+
ReturnType<NonNullable<LoadModule>>
|
|
60
|
+
>;
|
|
61
|
+
};
|
|
62
|
+
|
|
63
|
+
/** One compile for the whole suite — it costs ~100ms, and nothing invalidates it. */
|
|
64
|
+
let compiler: Promise<{ build(candidates: string[]): string }> | null = null;
|
|
65
|
+
function appCss() {
|
|
66
|
+
compiler ??= fs
|
|
67
|
+
.readFile(APP_STYLESHEET, 'utf8')
|
|
68
|
+
.then((css) => compile(css, { base: path.dirname(APP_STYLESHEET), loadStylesheet, loadModule }));
|
|
69
|
+
return compiler;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** One style rule: its selector, its own declarations, and the at-rules around it. */
|
|
73
|
+
type Rule = { selector: string; declarations: string; within: string[] };
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Every style rule in the compiled stylesheet, brace-matched.
|
|
77
|
+
*
|
|
78
|
+
* Text becomes a selector only where it precedes a `{` and is not an at-rule
|
|
79
|
+
* prelude; a `;` or `}` ends whatever was being read. So a declaration value
|
|
80
|
+
* (`--spacing: .25rem`, `transition: .15s`) can never be picked up as one —
|
|
81
|
+
* the dotted tokens inside theme variables and values are never selectors
|
|
82
|
+
* here, which is what makes "Tailwind emitted a selector for this class" an
|
|
83
|
+
* answerable question rather than "this name occurs after a dot somewhere".
|
|
84
|
+
*/
|
|
85
|
+
function* eachRule(css: string): Generator<Rule> {
|
|
86
|
+
const within: string[] = [];
|
|
87
|
+
let start = 0;
|
|
88
|
+
let i = 0;
|
|
89
|
+
while (i < css.length) {
|
|
90
|
+
const character = css[i];
|
|
91
|
+
if (character === '{') {
|
|
92
|
+
const prelude = css.slice(start, i).trim();
|
|
93
|
+
if (prelude.startsWith('@')) {
|
|
94
|
+
within.push(prelude);
|
|
95
|
+
start = ++i;
|
|
96
|
+
continue;
|
|
97
|
+
}
|
|
98
|
+
let depth = 0;
|
|
99
|
+
let end = i;
|
|
100
|
+
while (end < css.length) {
|
|
101
|
+
if (css[end] === '{') depth++;
|
|
102
|
+
else if (css[end] === '}' && --depth === 0) break;
|
|
103
|
+
end++;
|
|
104
|
+
}
|
|
105
|
+
// Only the rule's own declarations: anything nested belongs to its own rule.
|
|
106
|
+
const body = css.slice(i + 1, end);
|
|
107
|
+
const nested = body.indexOf('{');
|
|
108
|
+
yield {
|
|
109
|
+
selector: prelude,
|
|
110
|
+
declarations: nested < 0 ? body : body.slice(0, body.lastIndexOf(';', nested) + 1),
|
|
111
|
+
within: [...within],
|
|
112
|
+
};
|
|
113
|
+
i = end + 1;
|
|
114
|
+
start = i;
|
|
115
|
+
} else if (character === '}') {
|
|
116
|
+
within.pop();
|
|
117
|
+
start = ++i;
|
|
118
|
+
} else if (character === ';') {
|
|
119
|
+
start = ++i;
|
|
120
|
+
} else {
|
|
121
|
+
i++;
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/** The class names a selector targets, unescaped: `.hover\:x:hover` → `hover:x`. */
|
|
127
|
+
function classNamesIn(selector: string): string[] {
|
|
128
|
+
return [...selector.matchAll(/\.((?:\\.|[^{},\s:>~+[.])+)/g)].map(([, name]) =>
|
|
129
|
+
name.replace(/\\(.)/g, '$1'),
|
|
130
|
+
);
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/** Whether a rule sits inside `@layer utilities`. */
|
|
134
|
+
function inUtilities(rule: Rule): boolean {
|
|
135
|
+
return rule.within.some((at) => /^@layer\s+utilities\b/.test(at));
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/**
|
|
139
|
+
* The unconditional declarations of each bare `.class` rule in the utilities
|
|
140
|
+
* layer.
|
|
141
|
+
*
|
|
142
|
+
* Throws when the layer holds no rule at all. A missing utilities layer means
|
|
143
|
+
* this parser no longer understands Tailwind's output (a version bump that
|
|
144
|
+
* renames or reformats it), and degrading to "no declarations" would report
|
|
145
|
+
* the chip as broken — or pass an absence assertion vacuously — while the chip
|
|
146
|
+
* is fine. The helper exists to keep assertions honest, so it fails as itself.
|
|
147
|
+
*/
|
|
148
|
+
function utilityDeclarations(rules: Rule[]): Map<string, Declarations> {
|
|
149
|
+
const byClass = new Map<string, Declarations>();
|
|
150
|
+
let sawUtilitiesLayer = false;
|
|
151
|
+
for (const rule of rules) {
|
|
152
|
+
if (!inUtilities(rule)) continue;
|
|
153
|
+
sawUtilitiesLayer = true;
|
|
154
|
+
for (const raw of rule.selector.split(',')) {
|
|
155
|
+
const selector = raw.trim();
|
|
156
|
+
const [className, ...rest] = classNamesIn(selector);
|
|
157
|
+
// A bare class and nothing else: `.truncate`, not `.a:hover`, `.a.b`, `.a .b`.
|
|
158
|
+
if (className === undefined || rest.length) continue;
|
|
159
|
+
if (selector.replace(/\\(.)/g, '$1') !== `.${className}`) continue;
|
|
160
|
+
const declarations: Declarations = { ...byClass.get(className) };
|
|
161
|
+
for (const declaration of rule.declarations.split(';')) {
|
|
162
|
+
const colon = declaration.indexOf(':');
|
|
163
|
+
if (colon < 0) continue;
|
|
164
|
+
declarations[declaration.slice(0, colon).trim()] = declaration.slice(colon + 1).trim();
|
|
165
|
+
}
|
|
166
|
+
byClass.set(className, declarations);
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
if (!sawUtilitiesLayer) {
|
|
170
|
+
throw new Error(
|
|
171
|
+
`No \`@layer utilities\` rule in the compiled stylesheet: ${APP_STYLESHEET} no longer ` +
|
|
172
|
+
`emits the layer this parser reads, so no element's declarations can be resolved. This ` +
|
|
173
|
+
`is a fault in the test helper (most likely a Tailwind upgrade), not in the component.`,
|
|
174
|
+
);
|
|
175
|
+
}
|
|
176
|
+
return byClass;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/**
|
|
180
|
+
* The declarations the element's own classes generate unconditionally, merged.
|
|
181
|
+
*
|
|
182
|
+
* Merging is safe for asking "does this element get `text-overflow: ellipsis`"
|
|
183
|
+
* and meaningless for a property two of its classes both set — read it for the
|
|
184
|
+
* former only.
|
|
185
|
+
*
|
|
186
|
+
* A class Tailwind emitted no selector for is a purged, renamed or misspelled
|
|
187
|
+
* utility, and throws rather than quietly contributing nothing. A class that is
|
|
188
|
+
* only styled under a variant (`hover:text-danger`) contributes nothing here by
|
|
189
|
+
* design — a rule that applies on hover is not a declaration the element has —
|
|
190
|
+
* but it is known to exist, so it is not confused with a utility that has gone
|
|
191
|
+
* missing. That check runs first, so an element whose classes are all unknown
|
|
192
|
+
* is reported as such rather than as a missing utilities layer.
|
|
193
|
+
*/
|
|
194
|
+
export async function declarationsOf(element: Element): Promise<Declarations> {
|
|
195
|
+
const classNames = element.className.split(/\s+/).filter(Boolean);
|
|
196
|
+
const rules = [...eachRule((await appCss()).build(classNames))];
|
|
197
|
+
const styled = new Set(rules.flatMap((rule) => classNamesIn(rule.selector)));
|
|
198
|
+
|
|
199
|
+
const missing = classNames.filter((c) => !styled.has(c));
|
|
200
|
+
if (missing.length) {
|
|
201
|
+
throw new Error(
|
|
202
|
+
`Tailwind emitted no CSS for ${missing.map((c) => `\`${c}\``).join(', ')} on <${element.tagName.toLowerCase()}>. ` +
|
|
203
|
+
`The utility is purged, renamed or misspelled — the element is not styled the way its ` +
|
|
204
|
+
`class list says it is.`,
|
|
205
|
+
);
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
const byClass = utilityDeclarations(rules);
|
|
209
|
+
return Object.assign({}, ...classNames.map((c) => byClass.get(c) ?? {})) as Declarations;
|
|
210
|
+
}
|