@bevel-software/platform-core-frontend 0.4.1 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/THIRD-PARTY-NOTICES.md +5366 -0
- package/package.json +7 -4
- package/src/core/CoreAppShell.tsx +195 -56
- package/src/core/__tests__/AppChrome.test.tsx +125 -0
- package/src/core/__tests__/ShellRoutes.test.tsx +37 -2
- 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 +93 -117
- 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 +17 -1
- 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 +36 -28
- 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 +3 -3
- 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 +113 -20
- 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 +52 -28
- 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 +123 -102
- package/src/modules/library/components/LibraryLayout.tsx +344 -0
- package/src/modules/library/components/LibraryPage.tsx +111 -227
- 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 +33 -245
- 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 +108 -25
- 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 +147 -110
- package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +109 -92
- package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +35 -4
- 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 +38 -15
- package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +50 -50
- 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 +413 -189
- 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 +700 -294
- 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 +7 -4
- 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 +8 -5
- 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
|
@@ -5,13 +5,26 @@ import { TextRenderer } from './TextRenderer';
|
|
|
5
5
|
import { ImageRenderer } from './ImageRenderer';
|
|
6
6
|
import { HtmlRenderer } from './HtmlRenderer';
|
|
7
7
|
import { PdfRenderer } from './PdfRenderer';
|
|
8
|
-
import { DocxRenderer } from './DocxRenderer';
|
|
9
|
-
import { XlsxRenderer } from './XlsxRenderer';
|
|
10
8
|
import { CsvRenderer } from './CsvRenderer';
|
|
11
9
|
import { ToolRenderer } from './ToolRenderer';
|
|
10
|
+
import { lazyRenderer } from './lazyRenderer';
|
|
12
11
|
|
|
13
12
|
export type { FileRendererProps, RendererSaveState } from './types';
|
|
14
13
|
|
|
14
|
+
/**
|
|
15
|
+
* `.xlsx` and `.docx` are code-split: their parsers (xlsx ~141 KB gzip,
|
|
16
|
+
* mammoth ~119 KB) were 27% of the eager bundle for file types most sessions
|
|
17
|
+
* never open. `lazyRenderer` carries its own Suspense fallback and error
|
|
18
|
+
* boundary, so these stay plain `ComponentType<FileRendererProps>` values and
|
|
19
|
+
* `getFileRenderer()`'s contract is unchanged.
|
|
20
|
+
*/
|
|
21
|
+
const XlsxRenderer = lazyRenderer('spreadsheet', () =>
|
|
22
|
+
import('./XlsxRenderer').then((m) => ({ default: m.XlsxRenderer })),
|
|
23
|
+
);
|
|
24
|
+
const DocxRenderer = lazyRenderer('document', () =>
|
|
25
|
+
import('./DocxRenderer').then((m) => ({ default: m.DocxRenderer })),
|
|
26
|
+
);
|
|
27
|
+
|
|
15
28
|
const renderersByExtension: Record<string, ComponentType<FileRendererProps>> = {
|
|
16
29
|
'.md': MarkdownRenderer,
|
|
17
30
|
'.html': HtmlRenderer,
|
|
@@ -37,3 +50,66 @@ export function getFileRenderer(filePath: string): ComponentType<FileRendererPro
|
|
|
37
50
|
const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();
|
|
38
51
|
return renderersByExtension[ext] ?? fallbackRenderer;
|
|
39
52
|
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* How a file's renderer wants to be laid out inside `KbDocumentShell`.
|
|
56
|
+
*
|
|
57
|
+
* Two kinds of renderer, and the difference is not cosmetic:
|
|
58
|
+
*
|
|
59
|
+
* - **A document.** Markdown, plain text, Word. It has no natural height, so
|
|
60
|
+
* the shell holds the 880px measure and does the scrolling. An 800px line
|
|
61
|
+
* is a reading surface; a 2000px one is not.
|
|
62
|
+
* - **A viewport.** A PDF, an image, a spreadsheet, a sandboxed HTML page, a
|
|
63
|
+
* tool form. It is already a fixed-height thing with its own scroller, so
|
|
64
|
+
* the shell yields and hands it a definite height. An `h-full` iframe in an
|
|
65
|
+
* auto-height column collapses to 0px, and an 880px prose measure is the
|
|
66
|
+
* wrong shape for a spreadsheet.
|
|
67
|
+
*
|
|
68
|
+
* `.html` is full-bleed even though its EDIT state is a source textarea: the
|
|
69
|
+
* read state is the sandbox iframe, and the extension has to pick one. A
|
|
70
|
+
* full-height source view is harmless; a zero-height preview is not.
|
|
71
|
+
*
|
|
72
|
+
* Deliberately keyed off the extension — the same key `getFileRenderer` uses —
|
|
73
|
+
* so a registry-contributed renderer override for an extension inherits the
|
|
74
|
+
* layout its built-in counterpart had.
|
|
75
|
+
*/
|
|
76
|
+
export type RendererLayout = 'prose' | 'full-bleed';
|
|
77
|
+
|
|
78
|
+
const FULL_BLEED_EXTENSIONS = new Set([
|
|
79
|
+
'.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.bmp', '.ico',
|
|
80
|
+
'.pdf',
|
|
81
|
+
'.csv', '.xlsx',
|
|
82
|
+
'.html', '.htm',
|
|
83
|
+
'.tool',
|
|
84
|
+
]);
|
|
85
|
+
|
|
86
|
+
export function getRendererLayout(filePath: string): RendererLayout {
|
|
87
|
+
const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();
|
|
88
|
+
return FULL_BLEED_EXTENSIONS.has(ext) ? 'full-bleed' : 'prose';
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* Files whose renderer fetches its own bytes and never reads the text buffer.
|
|
93
|
+
*
|
|
94
|
+
* The workspace loads every open file's content as a STRING, so
|
|
95
|
+
* `openFileContent.length` is a number for a PDF too — it is just not a number
|
|
96
|
+
* that means anything, because those bytes were never text. The rail asks this
|
|
97
|
+
* before offering a character count: a figure nobody can interpret is worse
|
|
98
|
+
* than an absent row.
|
|
99
|
+
*
|
|
100
|
+
* Note this is NOT the same set as `FULL_BLEED_EXTENSIONS`. A CSV is laid out
|
|
101
|
+
* full-bleed and is still text you can count.
|
|
102
|
+
*
|
|
103
|
+
* `.svg` IS here, even though its bytes happen to be text: it renders through
|
|
104
|
+
* `ImageRenderer`, which fetches the raw endpoint and hands the browser a
|
|
105
|
+
* picture. Nobody reading a diagram wants to be told it is 4,812 characters of
|
|
106
|
+
* XML, and the buffer the count would come from was never displayed.
|
|
107
|
+
*/
|
|
108
|
+
const BINARY_EXTENSIONS = new Set([
|
|
109
|
+
'.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.bmp', '.ico',
|
|
110
|
+
'.pdf', '.docx', '.xlsx', '.zip',
|
|
111
|
+
]);
|
|
112
|
+
|
|
113
|
+
export function isBinaryFile(filePath: string): boolean {
|
|
114
|
+
return BINARY_EXTENSIONS.has(filePath.slice(filePath.lastIndexOf('.')).toLowerCase());
|
|
115
|
+
}
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The KB markdown pipeline: the plugin sets and the component overrides that
|
|
3
|
+
* make markdown render the way this app renders knowledge — id-links that
|
|
4
|
+
* navigate, `.md` path links, external links in a new tab, `<details>` blocks
|
|
5
|
+
* as real disclosures, heading anchors, and mermaid fences as diagrams.
|
|
6
|
+
*
|
|
7
|
+
* Extracted from `KbMarkdownView` so a SECOND surface can render with the same
|
|
8
|
+
* rules: the markdown diff viewer, which shows a document as red/green change
|
|
9
|
+
* blocks and until now used bare react-markdown — no id-links, no `<details>`,
|
|
10
|
+
* no mermaid, and no space-escaping in link destinations.
|
|
11
|
+
*
|
|
12
|
+
* Why an extraction and not "the diff viewer renders `<KbMarkdownView>`":
|
|
13
|
+
* `KbMarkdownView` is a whole document view, and three of its properties are
|
|
14
|
+
* actively wrong for a diff.
|
|
15
|
+
* - It runs `parseFrontmatter` on whatever string it is handed, and that
|
|
16
|
+
* regex matches ANY text starting with `---`. A diff is rendered in
|
|
17
|
+
* fragments split at arbitrary change boundaries, so a fragment that opens
|
|
18
|
+
* on a `---` thematic break would have everything up to the next `---`
|
|
19
|
+
* silently swallowed into a frontmatter panel. Content disappearing from a
|
|
20
|
+
* review surface is the worst bug available here.
|
|
21
|
+
* - It owns a scroller (`flex-1 overflow-auto`), which nested inside the
|
|
22
|
+
* change-request dialog's and the file-history panel's own scrollers gives
|
|
23
|
+
* a scroll trap.
|
|
24
|
+
* - It owns a `prose` scope, which the diff viewer also has — three nested
|
|
25
|
+
* typography scopes per fragment.
|
|
26
|
+
* So the diff viewer keeps its own block grouping, frontmatter panel and
|
|
27
|
+
* `prose` wrapper, and consumes only the parts below.
|
|
28
|
+
*
|
|
29
|
+
* NAVIGATION IS INJECTED, NEVER LOOKED UP. Nothing here calls a hook that
|
|
30
|
+
* needs Git/Workspace context or a Router. That is load-bearing in two
|
|
31
|
+
* directions: it keeps the diff viewer mountable from the enterprise `/embed*`
|
|
32
|
+
* routes, which render outside those providers, and it keeps the existing
|
|
33
|
+
* change-request and file-history tests — which render bare, with no Router —
|
|
34
|
+
* passing without acquiring provider wrappers.
|
|
35
|
+
*/
|
|
36
|
+
|
|
37
|
+
import { Suspense, lazy, useMemo } from 'react';
|
|
38
|
+
import type { Options as MarkdownOptions } from 'react-markdown';
|
|
39
|
+
import remarkGfm from 'remark-gfm';
|
|
40
|
+
import remarkFrontmatter from 'remark-frontmatter';
|
|
41
|
+
import rehypeRaw from 'rehype-raw';
|
|
42
|
+
import rehypeSanitize from 'rehype-sanitize';
|
|
43
|
+
import rehypeSlug from 'rehype-slug';
|
|
44
|
+
import { CopyAnchorButton } from './CopyAnchorButton';
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Mermaid's eager core is ~151 KB gzip and is only needed by documents that
|
|
48
|
+
* actually contain a ```mermaid fence — a small minority. Loading it lazily
|
|
49
|
+
* keeps it out of the initial payload for every other page.
|
|
50
|
+
*/
|
|
51
|
+
const MermaidDiagram = lazy(() =>
|
|
52
|
+
import('./MermaidDiagram').then((m) => ({ default: m.MermaidDiagram })),
|
|
53
|
+
);
|
|
54
|
+
|
|
55
|
+
type PluginList = NonNullable<MarkdownOptions['remarkPlugins']>;
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* Module-level and never rebuilt. react-markdown re-runs its whole pipeline
|
|
59
|
+
* when the plugin array's IDENTITY changes, so an inline `[remarkGfm, …]`
|
|
60
|
+
* literal in a render body re-parses on every render — which the diff viewer
|
|
61
|
+
* was doing three times per change block.
|
|
62
|
+
*/
|
|
63
|
+
export const KB_REMARK_PLUGINS: PluginList = [remarkGfm, remarkFrontmatter];
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* Document rendering. Order is load-bearing: rehype-raw parses inline HTML
|
|
67
|
+
* (the `<details>` "Source of Information" blocks in KB nodes) into real
|
|
68
|
+
* elements, rehype-sanitize runs AFTER so enabling HTML doesn't open an XSS
|
|
69
|
+
* hole, and rehype-slug runs LAST so the heading ids it adds survive
|
|
70
|
+
* sanitize's `user-content-` clobber prefix (which would break citation
|
|
71
|
+
* anchors).
|
|
72
|
+
*
|
|
73
|
+
* raw and sanitize are a PAIR. Never enable the first without the second: this
|
|
74
|
+
* pipeline renders other people's proposed content.
|
|
75
|
+
*/
|
|
76
|
+
export const KB_REHYPE_PLUGINS: PluginList = [rehypeRaw, rehypeSanitize, rehypeSlug];
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Diff rendering — the same pipeline WITHOUT rehype-slug.
|
|
80
|
+
*
|
|
81
|
+
* A diff is rendered as independent fragments, so rehype-slug runs once per
|
|
82
|
+
* fragment and a heading that appears on both sides of a change (or in an
|
|
83
|
+
* unchanged block and again in a changed one) yields duplicate DOM ids. Slugs
|
|
84
|
+
* buy nothing here — a diff shows no copy-anchor buttons and nothing links
|
|
85
|
+
* into it — so the correct trade is to leave them out rather than emit invalid
|
|
86
|
+
* markup for a feature the surface does not offer.
|
|
87
|
+
*/
|
|
88
|
+
export const KB_DIFF_REHYPE_PLUGINS: PluginList = [rehypeRaw, rehypeSanitize];
|
|
89
|
+
|
|
90
|
+
export interface KbMarkdownComponentOptions {
|
|
91
|
+
/**
|
|
92
|
+
* Called with the raw href of an internal `.md` link. The caller resolves it
|
|
93
|
+
* relative to the current node and decides how to open it. Omitted (e.g. the
|
|
94
|
+
* file-history panel, where the "current node" is a past commit) → `.md`
|
|
95
|
+
* links render as ordinary inert anchors.
|
|
96
|
+
*/
|
|
97
|
+
onOpenFile?: (href: string) => void;
|
|
98
|
+
/**
|
|
99
|
+
* Called with the bare node `id` of an id-link (`[text](some-id)`). Omitted
|
|
100
|
+
* (e.g. the embed, which has no in-app navigation) → id-links render as inert
|
|
101
|
+
* text rather than falling through as relative-URL links.
|
|
102
|
+
*/
|
|
103
|
+
onOpenNodeId?: (id: string) => void;
|
|
104
|
+
/**
|
|
105
|
+
* When provided, each heading gets a hover-revealed button copying
|
|
106
|
+
* `headingLink(slug)`. Requires {@link KB_REHYPE_PLUGINS} (slug ids); pass it
|
|
107
|
+
* only from document views, never from a diff.
|
|
108
|
+
*/
|
|
109
|
+
headingLink?: (slug: string) => string;
|
|
110
|
+
/**
|
|
111
|
+
* What a mermaid fence that fails to parse should render.
|
|
112
|
+
*
|
|
113
|
+
* `'error'` (the default) shows mermaid's message — right for a document,
|
|
114
|
+
* where a broken diagram is a defect the author wants to see.
|
|
115
|
+
*
|
|
116
|
+
* `'source'` falls back to the plain fenced code block. This is for diffs:
|
|
117
|
+
* a diagram whose fence straddles a change boundary arrives at the renderer
|
|
118
|
+
* truncated and CANNOT parse, so `'error'` would replace the red/green
|
|
119
|
+
* source lines — the only useful thing in that block — with an error box, on
|
|
120
|
+
* every edited diagram. Untouched diagrams sit inside a single unchanged
|
|
121
|
+
* block, parse fine, and still render as diagrams.
|
|
122
|
+
*/
|
|
123
|
+
onMermaidError?: 'error' | 'source';
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* The component overrides for the KB pipeline. Memoised on the injected
|
|
128
|
+
* callbacks, so a caller passing stable functions never rebuilds the map.
|
|
129
|
+
*/
|
|
130
|
+
export function useKbMarkdownComponents({
|
|
131
|
+
onOpenFile,
|
|
132
|
+
onOpenNodeId,
|
|
133
|
+
headingLink,
|
|
134
|
+
onMermaidError = 'error',
|
|
135
|
+
}: KbMarkdownComponentOptions) {
|
|
136
|
+
return useMemo(() => {
|
|
137
|
+
// One renderer for h1–h6: reads its level from the hast node's tagName,
|
|
138
|
+
// re-attaches the rehype-slug `id`, and appends the copy-anchor button.
|
|
139
|
+
const Heading = ({ node, id, children, className: cls, ...props }: {
|
|
140
|
+
node?: { tagName?: string };
|
|
141
|
+
id?: string;
|
|
142
|
+
children?: React.ReactNode;
|
|
143
|
+
className?: string;
|
|
144
|
+
}) => {
|
|
145
|
+
const Tag = (node?.tagName ?? 'h2') as keyof React.JSX.IntrinsicElements;
|
|
146
|
+
return (
|
|
147
|
+
<Tag id={id} className={`group/anchor ${cls ?? ''}`.trim()} {...props}>
|
|
148
|
+
{children}
|
|
149
|
+
{headingLink && id ? <CopyAnchorButton url={headingLink(id)} /> : null}
|
|
150
|
+
</Tag>
|
|
151
|
+
);
|
|
152
|
+
};
|
|
153
|
+
return {
|
|
154
|
+
h1: Heading, h2: Heading, h3: Heading, h4: Heading, h5: Heading, h6: Heading,
|
|
155
|
+
// `node` is destructured out and dropped in both overrides below.
|
|
156
|
+
// react-markdown hands every component the hast node, and these spread
|
|
157
|
+
// their remaining props straight onto a DOM element — so leaving it in
|
|
158
|
+
// emitted a literal `node="[object Object]"` attribute on every rendered
|
|
159
|
+
// link and code block, plus a React unknown-prop warning. (The heading
|
|
160
|
+
// renderer above already dropped it; these two did not.)
|
|
161
|
+
a({ node: _node, href, children, ...props }: {
|
|
162
|
+
node?: unknown;
|
|
163
|
+
href?: string;
|
|
164
|
+
children?: React.ReactNode;
|
|
165
|
+
}) {
|
|
166
|
+
// id-link: `[text](some-id)` or `[text](some-id#heading)` — a bare node
|
|
167
|
+
// id (the post-migration link form), optionally with a heading anchor
|
|
168
|
+
// (the `cite_kb_node` citation form). Resolve via onOpenNodeId, which
|
|
169
|
+
// splits off the heading. id grammar = lowercase alphanumeric + hyphens
|
|
170
|
+
// + underscores (snake_case tool/skill ids resolve too); the `#…` tail
|
|
171
|
+
// forbids `/` so a `.md` path link never matches. Keep in sync with
|
|
172
|
+
// `NODE_ID_LINK_RE` in kb-routes (kept inline here to avoid pulling the
|
|
173
|
+
// routing/hooks module into the embed bundle).
|
|
174
|
+
if (href && /^[a-z0-9][a-z0-9_-]*(#[^/]+)?$/.test(href)) {
|
|
175
|
+
// No resolver (e.g. the embed) → render inert, never a navigable
|
|
176
|
+
// anchor, so a bare id can't fall through as a relative-URL link.
|
|
177
|
+
if (!onOpenNodeId) return <span {...props}>{children}</span>;
|
|
178
|
+
return (
|
|
179
|
+
<a
|
|
180
|
+
{...props}
|
|
181
|
+
href={href}
|
|
182
|
+
onClick={(e) => {
|
|
183
|
+
e.preventDefault();
|
|
184
|
+
onOpenNodeId(href);
|
|
185
|
+
}}
|
|
186
|
+
className="cursor-pointer"
|
|
187
|
+
>
|
|
188
|
+
{children}
|
|
189
|
+
</a>
|
|
190
|
+
);
|
|
191
|
+
}
|
|
192
|
+
// Legacy/internal path link: a `.md` destination, optionally with a
|
|
193
|
+
// heading anchor (`Node.md#goal`) — still used by frontmatter `nodeType`.
|
|
194
|
+
// External (`http…`) and same-page (`#…`) links fall through to <a>.
|
|
195
|
+
if (
|
|
196
|
+
onOpenFile &&
|
|
197
|
+
href && !href.startsWith('http') && !href.startsWith('#') && /\.md(#|$)/.test(href)
|
|
198
|
+
) {
|
|
199
|
+
return (
|
|
200
|
+
<a
|
|
201
|
+
{...props}
|
|
202
|
+
href={href}
|
|
203
|
+
onClick={(e) => {
|
|
204
|
+
e.preventDefault();
|
|
205
|
+
onOpenFile(href);
|
|
206
|
+
}}
|
|
207
|
+
className="cursor-pointer"
|
|
208
|
+
>
|
|
209
|
+
{children}
|
|
210
|
+
</a>
|
|
211
|
+
);
|
|
212
|
+
}
|
|
213
|
+
if (href && /^https?:\/\//i.test(href)) {
|
|
214
|
+
return <a href={href} {...props} target="_blank" rel="noopener noreferrer">{children}</a>;
|
|
215
|
+
}
|
|
216
|
+
return <a href={href} {...props}>{children}</a>;
|
|
217
|
+
},
|
|
218
|
+
pre({ node: _node, children, ...props }: { node?: unknown; children?: React.ReactNode }) {
|
|
219
|
+
// Render a mermaid code block as a diagram.
|
|
220
|
+
const child = Array.isArray(children) ? children[0] : children;
|
|
221
|
+
if (
|
|
222
|
+
child && typeof child === 'object' && 'props' in child &&
|
|
223
|
+
typeof child.props.className === 'string' &&
|
|
224
|
+
child.props.className.includes('language-mermaid')
|
|
225
|
+
) {
|
|
226
|
+
const code = String(child.props.children).replace(/\n$/, '');
|
|
227
|
+
const source = <pre {...props}>{children}</pre>;
|
|
228
|
+
return (
|
|
229
|
+
<Suspense fallback={source}>
|
|
230
|
+
<MermaidDiagram
|
|
231
|
+
code={code}
|
|
232
|
+
errorFallback={onMermaidError === 'source' ? source : undefined}
|
|
233
|
+
/>
|
|
234
|
+
</Suspense>
|
|
235
|
+
);
|
|
236
|
+
}
|
|
237
|
+
return <pre {...props}>{children}</pre>;
|
|
238
|
+
},
|
|
239
|
+
};
|
|
240
|
+
}, [onOpenFile, onOpenNodeId, headingLink, onMermaidError]);
|
|
241
|
+
}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { Suspense, lazy, useMemo, useState, type ComponentType } from 'react';
|
|
2
|
+
import { ChunkErrorBoundary, RendererFallback } from './chunk-boundary';
|
|
3
|
+
import type { FileRendererProps } from './types';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Code-splitting for the renderers whose parsing libraries dominate the
|
|
7
|
+
* bundle. Measured from a production build: xlsx (141 KB gzip), mammoth
|
|
8
|
+
* (119 KB) and mermaid's eager core (151 KB) are 411 KB gzip — 43% of a
|
|
9
|
+
* 964 KB payload — for file types most sessions never open. Every route paid
|
|
10
|
+
* that, including `/connect` and `/secrets`, which are the pages users land
|
|
11
|
+
* on returning from an external OAuth sign-in.
|
|
12
|
+
*
|
|
13
|
+
* The lazy component is self-contained: it carries its own Suspense fallback
|
|
14
|
+
* AND its own error boundary, so `getFileRenderer()` keeps returning a plain
|
|
15
|
+
* `ComponentType<FileRendererProps>` and no call site changes.
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* Wrap a dynamic import as a drop-in renderer.
|
|
20
|
+
*
|
|
21
|
+
* @param label Human name for the error message ("spreadsheet", "document").
|
|
22
|
+
* @param loader Dynamic import resolving to the renderer component.
|
|
23
|
+
*/
|
|
24
|
+
export function lazyRenderer(
|
|
25
|
+
label: string,
|
|
26
|
+
loader: () => Promise<{ default: ComponentType<FileRendererProps> }>,
|
|
27
|
+
): ComponentType<FileRendererProps> {
|
|
28
|
+
// Shared across every mount, and the reason "Try again" needs the dance
|
|
29
|
+
// below: `React.lazy` memoises the loader's outcome — including a REJECTION.
|
|
30
|
+
// Once this one has failed it throws the cached error forever, so clearing
|
|
31
|
+
// the boundary and re-rendering it is not a retry, it is the same failure
|
|
32
|
+
// again. Only a new lazy component can actually re-run the import.
|
|
33
|
+
const first = lazy(loader);
|
|
34
|
+
|
|
35
|
+
return function LazyRenderer(props: FileRendererProps) {
|
|
36
|
+
const [attempt, setAttempt] = useState(0);
|
|
37
|
+
|
|
38
|
+
// Attempt 0 reuses the shared component so the common path is unchanged:
|
|
39
|
+
// a chunk already in the module cache resolves without re-suspending.
|
|
40
|
+
// Every later attempt builds a fresh lazy, which re-runs `import()` — cheap
|
|
41
|
+
// when the chunk is cached, and a real retry when it is not.
|
|
42
|
+
const Lazy = useMemo(() => (attempt === 0 ? first : lazy(loader)), [attempt]);
|
|
43
|
+
|
|
44
|
+
return (
|
|
45
|
+
// `key` remounts the boundary, which is what clears its `failed` state —
|
|
46
|
+
// the boundary never resets itself, so the new lazy and a clean boundary
|
|
47
|
+
// always arrive together.
|
|
48
|
+
<ChunkErrorBoundary
|
|
49
|
+
key={attempt}
|
|
50
|
+
label={label}
|
|
51
|
+
onRetry={() => setAttempt((a) => a + 1)}
|
|
52
|
+
>
|
|
53
|
+
<Suspense fallback={<RendererFallback />}>
|
|
54
|
+
<Lazy {...props} />
|
|
55
|
+
</Suspense>
|
|
56
|
+
</ChunkErrorBoundary>
|
|
57
|
+
);
|
|
58
|
+
};
|
|
59
|
+
}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Sanitizer for mammoth's `.docx` → HTML output, applied before that HTML is
|
|
3
|
+
* injected into the APP ORIGIN (see `DocxRenderer`).
|
|
4
|
+
*
|
|
5
|
+
* Why this exists: mammoth is a CONVERTER, not a sanitizer. It never emits a
|
|
6
|
+
* `<script>` because OOXML has no such element — but a hyperlink's target is
|
|
7
|
+
* copied verbatim out of the document's relationship table
|
|
8
|
+
* (`docx/body-reader.js`), passed straight into the anchor's attributes
|
|
9
|
+
* (`document-to-html.js`), and its writer escapes only `& " < >`, which
|
|
10
|
+
* prevents attribute breakout while leaving a `javascript:` scheme intact. A
|
|
11
|
+
* `.docx` whose hyperlink points at `javascript:…` therefore renders as a
|
|
12
|
+
* live script URL in this origin, one click from the reader's session. The
|
|
13
|
+
* markdown renderer already closes exactly this hole with `rehypeSanitize`
|
|
14
|
+
* (whose default schema enforces a protocol allowlist); this is the same
|
|
15
|
+
* guarantee for the docx path.
|
|
16
|
+
*
|
|
17
|
+
* The rule is a URL-scheme allowlist, not a blocklist: anything that is not
|
|
18
|
+
* demonstrably safe to navigate to is dropped. Event-handler attributes are
|
|
19
|
+
* stripped too — mammoth does not emit them today, but that is an internal
|
|
20
|
+
* detail of a dependency, and this function's contract should not rest on it.
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
/** Schemes a link may navigate to. Everything else is dropped. */
|
|
24
|
+
const SAFE_SCHEMES = new Set(['http', 'https', 'mailto']);
|
|
25
|
+
|
|
26
|
+
/** Attributes that carry a URL and therefore need scheme checking. */
|
|
27
|
+
const URL_ATTRIBUTES = ['href', 'src', 'xlink:href', 'action', 'formaction'];
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* Characters a browser IGNORES while parsing a URL: whitespace and control
|
|
31
|
+
* characters (`\p{Cc}` covers C0 and C1). They must be removed before the
|
|
32
|
+
* scheme is read, or a tab-separated `java<TAB>script:alert(1)` — and a
|
|
33
|
+
* leading-space ` javascript:alert(1)` — sail past a check that the browser
|
|
34
|
+
* then happily navigates.
|
|
35
|
+
*/
|
|
36
|
+
const URL_IGNORED_CHARS = /[\s\p{Cc}]/gu;
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Whether `raw` is safe to leave in a URL attribute.
|
|
40
|
+
*
|
|
41
|
+
* Relative URLs and bare fragments have no scheme and stay — they cannot
|
|
42
|
+
* execute. A value WITH a scheme must name one of {@link SAFE_SCHEMES},
|
|
43
|
+
* except `data:image/*`, which is how mammoth inlines a document's embedded
|
|
44
|
+
* pictures: those are inert in an `<img>` (SVG included — scripts inside an
|
|
45
|
+
* SVG do not run when it is loaded as an image).
|
|
46
|
+
*/
|
|
47
|
+
function isSafeUrl(raw: string, allowInlineImage: boolean): boolean {
|
|
48
|
+
const normalized = raw.replace(URL_IGNORED_CHARS, '').toLowerCase();
|
|
49
|
+
const scheme = /^([a-z][a-z0-9+.-]*):/.exec(normalized);
|
|
50
|
+
if (!scheme) return true; // relative, or a `#fragment` — same document
|
|
51
|
+
if (SAFE_SCHEMES.has(scheme[1])) return true;
|
|
52
|
+
return allowInlineImage && normalized.startsWith('data:image/');
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* Strip script-capable URLs and event handlers from `html`, returning the
|
|
57
|
+
* cleaned markup. Content is preserved wherever possible: an unsafe link
|
|
58
|
+
* loses its `href` and keeps its text, so the document still reads correctly
|
|
59
|
+
* rather than silently losing a passage.
|
|
60
|
+
*/
|
|
61
|
+
export function sanitizeDocxHtml(html: string): string {
|
|
62
|
+
const doc = new DOMParser().parseFromString(html, 'text/html');
|
|
63
|
+
|
|
64
|
+
for (const el of Array.from(doc.body.querySelectorAll('*'))) {
|
|
65
|
+
// `attributes` is live — snapshot it before removing anything.
|
|
66
|
+
for (const attr of Array.from(el.attributes)) {
|
|
67
|
+
const name = attr.name.toLowerCase();
|
|
68
|
+
|
|
69
|
+
// `onclick`, `onerror`, … — never emitted by mammoth, never welcome.
|
|
70
|
+
if (name.startsWith('on')) {
|
|
71
|
+
el.removeAttribute(attr.name);
|
|
72
|
+
continue;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
if (URL_ATTRIBUTES.includes(name)) {
|
|
76
|
+
const allowInlineImage = el.tagName.toLowerCase() === 'img' && name === 'src';
|
|
77
|
+
if (!isSafeUrl(attr.value, allowInlineImage)) {
|
|
78
|
+
el.removeAttribute(attr.name);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
// A `target` comes from the document's own `targetFrame`; pair it with
|
|
84
|
+
// `rel` so the opened page cannot reach back through `window.opener`.
|
|
85
|
+
if (el.tagName.toLowerCase() === 'a' && el.hasAttribute('target')) {
|
|
86
|
+
el.setAttribute('rel', 'noopener noreferrer');
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
return doc.body.innerHTML;
|
|
91
|
+
}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { describe, it, expect } from 'vitest';
|
|
2
|
+
import { renderHook } from '@testing-library/react';
|
|
3
|
+
import { useLinksOut } from '../useLinksOut';
|
|
4
|
+
|
|
5
|
+
const run = (path: string | null, content: string | null) =>
|
|
6
|
+
renderHook(() => useLinksOut(path, content)).result.current;
|
|
7
|
+
|
|
8
|
+
describe('useLinksOut', () => {
|
|
9
|
+
it('extracts the internal markdown links a document makes', () => {
|
|
10
|
+
const out = run(
|
|
11
|
+
'Knowledge/Invariant.md',
|
|
12
|
+
'See [NodeType](../NodeTypes/NodeType.md) and [Platform](Bevel-Platform.md).\n',
|
|
13
|
+
);
|
|
14
|
+
expect(out).toEqual([
|
|
15
|
+
{ label: 'NodeType', target: '../NodeTypes/NodeType.md' },
|
|
16
|
+
{ label: 'Platform', target: 'Bevel-Platform.md' },
|
|
17
|
+
]);
|
|
18
|
+
});
|
|
19
|
+
|
|
20
|
+
it('keeps a heading anchor on an internal link', () => {
|
|
21
|
+
expect(run('Knowledge/A.md', 'The [goal](Other.md#goal).')).toEqual([
|
|
22
|
+
{ label: 'goal', target: 'Other.md#goal' },
|
|
23
|
+
]);
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
// The angle-bracketed form is what `escapeSpacesInLinkDestinations` emits for
|
|
27
|
+
// a path with spaces in it, and the brackets are punctuation — the target the
|
|
28
|
+
// rail hands back has to be the path, spaces and anchor intact, or the row
|
|
29
|
+
// opens nothing.
|
|
30
|
+
it('unwraps an angle-bracketed destination carrying spaces', () => {
|
|
31
|
+
expect(run('Knowledge/A.md', 'The [goal](<Other File.md#goal>).')).toEqual([
|
|
32
|
+
{ label: 'goal', target: 'Other File.md#goal' },
|
|
33
|
+
]);
|
|
34
|
+
});
|
|
35
|
+
|
|
36
|
+
// The predicate is `KbMarkdownView`'s own: exactly the links that open as
|
|
37
|
+
// files in the workspace, and nothing that would take the reader off it.
|
|
38
|
+
it('ignores external links and same-page anchors', () => {
|
|
39
|
+
const out = run(
|
|
40
|
+
'Knowledge/A.md',
|
|
41
|
+
'An [external](https://example.com), an [anchor](#goal), and an [image](pic.png).',
|
|
42
|
+
);
|
|
43
|
+
expect(out).toEqual([]);
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
it('lists a destination once however many times it is linked', () => {
|
|
47
|
+
const out = run('Knowledge/A.md', '[One](Same.md) then [again](Same.md).');
|
|
48
|
+
expect(out).toEqual([{ label: 'One', target: 'Same.md' }]);
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
it('returns nothing for non-markdown content', () => {
|
|
52
|
+
expect(run('Data/velocity.csv', 'a,b\n[x](y.md),2\n')).toEqual([]);
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
it('returns nothing before the content has loaded', () => {
|
|
56
|
+
expect(run('Knowledge/A.md', null)).toEqual([]);
|
|
57
|
+
expect(run(null, '[x](y.md)')).toEqual([]);
|
|
58
|
+
});
|
|
59
|
+
});
|