@powerhousedao/connect 6.2.3-dev.61 → 6.2.3-dev.62

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (178) hide show
  1. package/README.md +101 -0
  2. package/dist/{AddDriveModal-C5odBO8y.js → AddDriveModal-D_3jDwjp.js} +6 -6
  3. package/dist/AddDriveModal-D_3jDwjp.js.map +1 -0
  4. package/dist/{ClearStorageModal-nzpz8MeW.js → ClearStorageModal-CXWhHez-.js} +9 -11
  5. package/dist/ClearStorageModal-CXWhHez-.js.map +1 -0
  6. package/dist/{ConfirmDocumentUpgradeModal-k79v2wM6.js → ConfirmDocumentUpgradeModal-CrU2Z1CL.js} +5 -5
  7. package/dist/{ConfirmDocumentUpgradeModal-k79v2wM6.js.map → ConfirmDocumentUpgradeModal-CrU2Z1CL.js.map} +1 -1
  8. package/dist/{CookiesPolicyModal-BLw4pnhn.js → CookiesPolicyModal-DQwsgDI9.js} +5 -5
  9. package/dist/{CookiesPolicyModal-BLw4pnhn.js.map → CookiesPolicyModal-DQwsgDI9.js.map} +1 -1
  10. package/dist/{CreateDocumentModal-Bmv0V-kY.js → CreateDocumentModal-Cf1APibL.js} +4 -4
  11. package/dist/{CreateDocumentModal-Bmv0V-kY.js.map → CreateDocumentModal-Cf1APibL.js.map} +1 -1
  12. package/dist/{DebugSettingsModal-BW0HWI1D.js → DebugSettingsModal-C0j4mtkx.js} +8 -8
  13. package/dist/{DebugSettingsModal-BW0HWI1D.js.map → DebugSettingsModal-C0j4mtkx.js.map} +1 -1
  14. package/dist/{DeleteDriveModal-CjGnG0ht.js → DeleteDriveModal-lE9eCBua.js} +5 -5
  15. package/dist/{DeleteDriveModal-CjGnG0ht.js.map → DeleteDriveModal-lE9eCBua.js.map} +1 -1
  16. package/dist/{DeleteItemModal-BbY_4_xT.js → DeleteItemModal-BFgcGsm3.js} +6 -6
  17. package/dist/{DeleteItemModal-BbY_4_xT.js.map → DeleteItemModal-BFgcGsm3.js.map} +1 -1
  18. package/dist/{DisclaimerModal-DuglmEwL.js → DisclaimerModal-CF6JkIIu.js} +6 -6
  19. package/dist/{DisclaimerModal-DuglmEwL.js.map → DisclaimerModal-CF6JkIIu.js.map} +1 -1
  20. package/dist/{DocumentVersionUnsupportedModal-C4fy7fZ6.js → DocumentVersionUnsupportedModal-Cm9Jb9W7.js} +5 -5
  21. package/dist/DocumentVersionUnsupportedModal-Cm9Jb9W7.js.map +1 -0
  22. package/dist/{DownloadDocumentWithErrorsModal-BsPQ5qgy.js → DownloadDocumentWithErrorsModal-CShKhfEQ.js} +5 -5
  23. package/dist/{DownloadDocumentWithErrorsModal-BsPQ5qgy.js.map → DownloadDocumentWithErrorsModal-CShKhfEQ.js.map} +1 -1
  24. package/dist/{DriveAuthRequiredModal-CtsB0kwH.js → DriveAuthRequiredModal-CMwPUyZf.js} +5 -5
  25. package/dist/{DriveAuthRequiredModal-CtsB0kwH.js.map → DriveAuthRequiredModal-CMwPUyZf.js.map} +1 -1
  26. package/dist/{DriveSettingsModal-d1L0eYof.js → DriveSettingsModal-BSImj4BH.js} +5 -5
  27. package/dist/{DriveSettingsModal-d1L0eYof.js.map → DriveSettingsModal-BSImj4BH.js.map} +1 -1
  28. package/dist/FloatingTanStackRouterDevtools-CqogiFob-dxj8lrTP.js +2565 -0
  29. package/dist/FloatingTanStackRouterDevtools-CqogiFob-dxj8lrTP.js.map +1 -0
  30. package/dist/{InspectorModal-Dpf-3LVT.js → InspectorModal-CKuKR5g7.js} +9 -9
  31. package/dist/{InspectorModal-Dpf-3LVT.js.map → InspectorModal-CKuKR5g7.js.map} +1 -1
  32. package/dist/{LoginModal-CI0ogC2-.js → LoginModal-DT_05uva.js} +6 -6
  33. package/dist/{LoginModal-CI0ogC2-.js.map → LoginModal-DT_05uva.js.map} +1 -1
  34. package/dist/{MissingPackageModal-DS3dgJ1K.js → MissingPackageModal-DtISKgub.js} +6 -6
  35. package/dist/{MissingPackageModal-DS3dgJ1K.js.map → MissingPackageModal-DtISKgub.js.map} +1 -1
  36. package/dist/{OpenFileDocumentsModal-BOmFtxS1.js → OpenFileDocumentsModal-X9GnX2Bk.js} +13 -12
  37. package/dist/OpenFileDocumentsModal-X9GnX2Bk.js.map +1 -0
  38. package/dist/{UpgradeDriveModal-CXX6D5Au.js → UpgradeDriveModal-DvM-PNWe.js} +6 -6
  39. package/dist/{UpgradeDriveModal-CXX6D5Au.js.map → UpgradeDriveModal-DvM-PNWe.js.map} +1 -1
  40. package/dist/app-layout-BIq-ZW-6.js +394 -0
  41. package/dist/app-layout-BIq-ZW-6.js.map +1 -0
  42. package/dist/app-loader-DqNf3gc0.js +1291 -0
  43. package/dist/app-loader-DqNf3gc0.js.map +1 -0
  44. package/dist/app-loader-gMCokq-Y.js +4 -0
  45. package/dist/{app-skeleton-CBN4tenZ.js → app-skeleton-DYLZ7npI.js} +3 -3
  46. package/dist/{app-skeleton--Me5zlSz.js → app-skeleton-gzg8cRzm.js} +7 -7
  47. package/dist/app-skeleton-gzg8cRzm.js.map +1 -0
  48. package/dist/{boot-CNW7ypcB.js → boot-CC_DgQKX.js} +32 -9
  49. package/dist/boot-CC_DgQKX.js.map +1 -0
  50. package/dist/{build-info-DNKZUbvY.js → build-info-BL03di3M.js} +5 -5
  51. package/dist/{build-info-DNKZUbvY.js.map → build-info-BL03di3M.js.map} +1 -1
  52. package/dist/components-D4yHqff7.js +120 -0
  53. package/dist/components-D4yHqff7.js.map +1 -0
  54. package/dist/connect-router-KmNBGS0G.js +434 -0
  55. package/dist/connect-router-KmNBGS0G.js.map +1 -0
  56. package/dist/{connect.config-CB78ZsFz.js → connect.config-uZF-gnvV.js} +7 -7
  57. package/dist/{connect.config-CB78ZsFz.js.map → connect.config-uZF-gnvV.js.map} +1 -1
  58. package/dist/{connection-state-BDikOGKo.js → connection-state-C_477Kr_.js} +6 -6
  59. package/dist/{connection-state-BDikOGKo.js.map → connection-state-C_477Kr_.js.map} +1 -1
  60. package/dist/context-De2EB1AA-Ni0d829Q.js +1759 -0
  61. package/dist/context-De2EB1AA-Ni0d829Q.js.map +1 -0
  62. package/dist/{cookie-banner-D05DZRqY.js → cookie-banner-HPgyuHM5.js} +6 -6
  63. package/dist/{cookie-banner-D05DZRqY.js.map → cookie-banner-HPgyuHM5.js.map} +1 -1
  64. package/dist/drive-icon-BiVP8yJc.js +38 -0
  65. package/dist/drive-icon-BiVP8yJc.js.map +1 -0
  66. package/dist/esm-BDACZntJ.js +148 -0
  67. package/dist/esm-BDACZntJ.js.map +1 -0
  68. package/dist/index-UrZFqSgm.d.ts +166 -0
  69. package/dist/index-UrZFqSgm.d.ts.map +1 -0
  70. package/dist/layout.d.ts +29 -0
  71. package/dist/layout.d.ts.map +1 -0
  72. package/dist/layout.js +6 -0
  73. package/dist/{load-BxQ82Cxc.js → load-CEuzCNRz.js} +48 -48
  74. package/dist/load-CEuzCNRz.js.map +1 -0
  75. package/dist/main.js +2 -2
  76. package/dist/{multi-reactor-BG-DqUcm.js → multi-reactor-fSKpLBjT.js} +10 -7
  77. package/dist/multi-reactor-fSKpLBjT.js.map +1 -0
  78. package/dist/open-file-uploads-BcyWmUZn.js +183 -0
  79. package/dist/open-file-uploads-BcyWmUZn.js.map +1 -0
  80. package/dist/{package-manager-BPVMRBoV.js → package-manager-BkFRzovd.js} +52 -45
  81. package/dist/package-manager-BkFRzovd.js.map +1 -0
  82. package/dist/{pglite-migrate-core-BcXcImng.js → pglite-migrate-core-DBlU6HIc.js} +4 -4
  83. package/dist/pglite-migrate-core-DBlU6HIc.js.map +1 -0
  84. package/dist/{pglite-seed-CQJ97bEt.js → pglite-seed-BsEPByVM.js} +4 -4
  85. package/dist/{pglite-seed-CQJ97bEt.js.map → pglite-seed-BsEPByVM.js.map} +1 -1
  86. package/dist/{preferences-store-Cm0BoiHA.js → preferences-store-DANUajdg.js} +4 -4
  87. package/dist/{preferences-store-Cm0BoiHA.js.map → preferences-store-DANUajdg.js.map} +1 -1
  88. package/dist/prerendered-shell-DxCUDEXL.js +45 -0
  89. package/dist/prerendered-shell-DxCUDEXL.js.map +1 -0
  90. package/dist/{reactor-DHJyk5ow.js → reactor-DmBtssmg.js} +50 -46
  91. package/dist/reactor-DmBtssmg.js.map +1 -0
  92. package/dist/reactor-chat-LAB-9G3G.js +50 -0
  93. package/dist/reactor-chat-LAB-9G3G.js.map +1 -0
  94. package/dist/reactor.worker.js +85 -27
  95. package/dist/reactor.worker.js.map +1 -1
  96. package/dist/{registerServiceWorker-DT6t8wjg.js → registerServiceWorker-CkVxA2KC.js} +4 -4
  97. package/dist/{registerServiceWorker-DT6t8wjg.js.map → registerServiceWorker-CkVxA2KC.js.map} +1 -1
  98. package/dist/route-components-BkztQruF.js +148 -0
  99. package/dist/route-components-BkztQruF.js.map +1 -0
  100. package/dist/route-tree.d.ts +2229 -0
  101. package/dist/route-tree.d.ts.map +1 -0
  102. package/dist/route-tree.js +211 -0
  103. package/dist/route-tree.js.map +1 -0
  104. package/dist/router-B4Z1LV9b.js +4 -0
  105. package/dist/router-BlxJIE3W.js +604 -0
  106. package/dist/router-BlxJIE3W.js.map +1 -0
  107. package/dist/router.d.ts +4 -0
  108. package/dist/router.js +7 -0
  109. package/dist/{runtime-config-DI5OfIC6.js → runtime-config-DdN1Frg7.js} +6 -9
  110. package/dist/runtime-config-DdN1Frg7.js.map +1 -0
  111. package/dist/{sentry-jfDyrxdX.js → sentry-CJb7--mu.js} +7 -4
  112. package/dist/{sentry-jfDyrxdX.js.map → sentry-CJb7--mu.js.map} +1 -1
  113. package/dist/{SettingsModal-BJVPEHbo.js → settings-2Id1UgNY.js} +126 -83
  114. package/dist/settings-2Id1UgNY.js.map +1 -0
  115. package/dist/settings-CjvK8OKA.js +91 -0
  116. package/dist/settings-CjvK8OKA.js.map +1 -0
  117. package/dist/shell-head.html +1 -0
  118. package/dist/shell.html +1 -0
  119. package/dist/sidebar-BXf8OEwm.d.ts +34 -0
  120. package/dist/sidebar-BXf8OEwm.d.ts.map +1 -0
  121. package/dist/sidebar-lAVFRsni.js +31 -0
  122. package/dist/sidebar-lAVFRsni.js.map +1 -0
  123. package/dist/start-connect.d.ts +4 -1
  124. package/dist/start-connect.d.ts.map +1 -1
  125. package/dist/start-connect.js +9 -5
  126. package/dist/start-connect.js.map +1 -1
  127. package/dist/style.css +36 -18
  128. package/dist/{useRegistryPackages-3EcR3GOh.js → useRegistryPackages-BqIWwXV-.js} +5 -5
  129. package/dist/{useRegistryPackages-3EcR3GOh.js.map → useRegistryPackages-BqIWwXV-.js.map} +1 -1
  130. package/fonts.css +177 -0
  131. package/package.json +51 -22
  132. package/scripts/critical-css.ts +243 -0
  133. package/scripts/prerender-shell.ts +100 -0
  134. package/src/routeTree.gen.ts +293 -0
  135. package/src/router/connect-router.ts +170 -0
  136. package/src/router/drive-route-loader.ts +116 -0
  137. package/src/router/index.ts +51 -0
  138. package/src/router/navigation.ts +230 -0
  139. package/src/router/perf-marks.test.tsx +98 -0
  140. package/src/router/perf-marks.ts +97 -0
  141. package/src/router/register.ts +9 -0
  142. package/src/router/route-components.tsx +98 -0
  143. package/src/router/route-tree.ts +88 -0
  144. package/src/router/scroll.ts +69 -0
  145. package/src/router/search.ts +66 -0
  146. package/src/router/settings.ts +120 -0
  147. package/src/router/sidebar.ts +55 -0
  148. package/src/router/titles.test.ts +24 -0
  149. package/src/router/titles.ts +33 -0
  150. package/src/routes/__root.tsx +28 -0
  151. package/src/routes/core/_app/$.tsx +13 -0
  152. package/src/routes/core/_app/_content/d/$driveSlug/{-$nodeSlug}.tsx +52 -0
  153. package/src/routes/core/_app/_content/index.tsx +3 -0
  154. package/src/routes/core/_app/_content.tsx +9 -0
  155. package/src/routes/core/_app/settings/about.tsx +20 -0
  156. package/src/routes/core/_app/settings/ai-assistant.tsx +20 -0
  157. package/src/routes/core/_app/settings/danger-zone.tsx +21 -0
  158. package/src/routes/core/_app/settings/default-editors.tsx +20 -0
  159. package/src/routes/core/_app/settings/package-manager.tsx +20 -0
  160. package/src/routes/core/_app/settings.tsx +35 -0
  161. package/src/routes/core/_app.tsx +10 -0
  162. package/dist/AddDriveModal-C5odBO8y.js.map +0 -1
  163. package/dist/ClearStorageModal-nzpz8MeW.js.map +0 -1
  164. package/dist/DocumentVersionUnsupportedModal-C4fy7fZ6.js.map +0 -1
  165. package/dist/OpenFileDocumentsModal-BOmFtxS1.js.map +0 -1
  166. package/dist/SettingsModal-BJVPEHbo.js.map +0 -1
  167. package/dist/app-loader-CNCzLxgV.js +0 -2379
  168. package/dist/app-loader-CNCzLxgV.js.map +0 -1
  169. package/dist/app-loader-DvnGgSyC.js +0 -4
  170. package/dist/app-skeleton--Me5zlSz.js.map +0 -1
  171. package/dist/boot-CNW7ypcB.js.map +0 -1
  172. package/dist/components-BKUI79po.js +0 -5
  173. package/dist/load-BxQ82Cxc.js.map +0 -1
  174. package/dist/multi-reactor-BG-DqUcm.js.map +0 -1
  175. package/dist/package-manager-BPVMRBoV.js.map +0 -1
  176. package/dist/pglite-migrate-core-BcXcImng.js.map +0 -1
  177. package/dist/reactor-DHJyk5ow.js.map +0 -1
  178. package/dist/runtime-config-DI5OfIC6.js.map +0 -1
@@ -0,0 +1,170 @@
1
+ import type { DriveArrivals, PHStore } from "@powerhousedao/reactor-browser";
2
+ import { getPHStoreSubscribe } from "@powerhousedao/reactor-browser";
3
+ import type { AnyRoute, Router, RouterHistory } from "@tanstack/react-router";
4
+ import { createRouter } from "@tanstack/react-router";
5
+ import type { ErrorInfo, PropsWithChildren, ReactElement } from "react";
6
+ import { createElement } from "react";
7
+ import { captureException } from "../services/sentry.js";
8
+ import { markRouterNavigations } from "./perf-marks.js";
9
+ import { bindConnectScroll, connectScrollRestoration } from "./scroll.js";
10
+ import type { DriveRouteData } from "./drive-route-loader.js";
11
+ import { isDriveNotFound } from "./drive-route-loader.js";
12
+ import type {
13
+ ConnectRootRoute,
14
+ ConnectRouteComponents,
15
+ ConnectRoutes,
16
+ } from "./route-tree.js";
17
+ import { createConnectNavigation } from "./navigation.js";
18
+ import { DriveNotFoundView, NotFoundView } from "./route-components.js";
19
+ import { addConnectRoutes, connectRoutes } from "./route-tree.js";
20
+ import { parseConnectSearch, stringifyConnectSearch } from "./search.js";
21
+ import { driveTitle } from "./titles.js";
22
+
23
+ /** The scroll container of the content view. */
24
+ export const CONTENT_VIEW_ID = "content-view";
25
+
26
+ export type ConnectRouterOptions = {
27
+ store: PHStore;
28
+ arrivals?: DriveArrivals;
29
+ components: ConnectRouteComponents;
30
+ basepath?: string;
31
+ history?: RouterHistory;
32
+ InnerWrap?: (props: PropsWithChildren) => ReactElement;
33
+ /** Code routes added to Connect's file routes; see `addConnectRoutes`. */
34
+ routes?: readonly AnyRoute[];
35
+ /** Reports a route's loader or render error; Sentry by default. */
36
+ onCatch?: (error: unknown, info?: ErrorInfo) => void;
37
+ /** Ends every document title; "Connect" without one. */
38
+ appName?: string;
39
+ };
40
+
41
+ function reportRouteError(error: unknown, info?: ErrorInfo) {
42
+ captureException(
43
+ error,
44
+ info?.componentStack
45
+ ? { data: { componentStack: info.componentStack } }
46
+ : undefined,
47
+ );
48
+ }
49
+
50
+ /** The router over `TRouteTree`; a project's generated tree registers its own. */
51
+ export type ConnectRouterFor<TRouteTree extends AnyRoute> = Router<
52
+ TRouteTree,
53
+ "never",
54
+ false,
55
+ RouterHistory,
56
+ Record<string, any>
57
+ >;
58
+ // Written out, not inferred; see ConnectRootRoute.
59
+ export type ConnectRouter = ConnectRouterFor<ConnectRootRoute>;
60
+ export type ConnectRouterBundle = Pick<
61
+ ConnectRoutes,
62
+ "homeRoute" | "driveRoute" | "settingsRoute"
63
+ > & { router: ConnectRouter };
64
+
65
+ export function createConnectRouter(
66
+ options: ConnectRouterOptions,
67
+ ): ConnectRouterBundle {
68
+ if (options.routes) addConnectRoutes(options.routes);
69
+ const { routeTree, homeRoute, driveRoute, settingsRoute } = connectRoutes();
70
+ const router = createRouter({
71
+ routeTree,
72
+ basepath: options.basepath,
73
+ history: options.history,
74
+ context: {
75
+ store: options.store,
76
+ arrivals: options.arrivals,
77
+ components: options.components,
78
+ appName: options.appName,
79
+ },
80
+ parseSearch: parseConnectSearch,
81
+ stringifySearch: stringifyConnectSearch,
82
+ scrollRestoration: connectScrollRestoration(),
83
+ scrollToTopSelectors: [`#${CONTENT_VIEW_ID}`],
84
+ InnerWrap: options.InnerWrap,
85
+ defaultErrorComponent: options.components.error,
86
+ // Not per route: a route's notFoundComponent mounts a boundary that
87
+ // re-renders on every navigation.
88
+ defaultNotFoundComponent: ({ data }) =>
89
+ isDriveNotFound(data)
90
+ ? createElement(DriveNotFoundView, { driveSlug: data.driveSlug })
91
+ : createElement(NotFoundView),
92
+ defaultOnCatch: options.onCatch ?? reportRouteError,
93
+ });
94
+ return { router, homeRoute, driveRoute, settingsRoute };
95
+ }
96
+
97
+ function writeSelection(store: PHStore, data: DriveRouteData | undefined) {
98
+ // Revision history belongs to the document it was opened for.
99
+ if (store.selectedNodeId !== data?.nodeId) {
100
+ store.revisionHistoryVisible = false;
101
+ }
102
+ // Drive first: a new drive resets the node.
103
+ store.selectedDriveId = data?.driveId;
104
+ store.selectedNodeId = data?.nodeId;
105
+ }
106
+
107
+ /** Makes `router` the store's navigation and writes the selection it commits. */
108
+ export function bindConnectRouter(
109
+ connectRouter: ConnectRouterBundle,
110
+ store: PHStore,
111
+ ) {
112
+ const { router, driveRoute } = connectRouter;
113
+
114
+ // Only committed matches select; pending ones keep the open view.
115
+ const commitSelection = () => {
116
+ const matches = router.state.matches;
117
+ const drive = matches.find((match) => match.routeId === driveRoute.id);
118
+ if (drive) {
119
+ if (drive.status === "success" && drive.loaderData) {
120
+ writeSelection(store, drive.loaderData);
121
+ } else if (matches.some((match) => match.status === "notFound")) {
122
+ // The drive's 404 page shows no drive.
123
+ writeSelection(store, undefined);
124
+ }
125
+ return;
126
+ }
127
+ // Any other page (home, settings, a project's, a 404) shows no drive.
128
+ const shown = matches.at(-1)?.status;
129
+ if (shown === "success" || shown === "notFound") {
130
+ writeSelection(store, undefined);
131
+ }
132
+ };
133
+
134
+ // Set once, before the first render; selection setters navigate from the start.
135
+ const navigation = createConnectNavigation(connectRouter);
136
+ store.navigation = navigation;
137
+
138
+ // The drive route's head reads names from the store; a rename re-runs it.
139
+ const shownTitle = () => {
140
+ const drive = router.state.matches.find((m) => m.routeId === driveRoute.id);
141
+ return driveTitle(store, drive?.loaderData, router.options.context.appName);
142
+ };
143
+ let title = shownTitle();
144
+ const retitle = () => {
145
+ const next = shownTitle();
146
+ if (next === title) return;
147
+ title = next;
148
+ void router.invalidate({ filter: (m) => m.routeId === driveRoute.id });
149
+ };
150
+
151
+ // Before mount, so the view and scroll restoration see the new selection.
152
+ const unsubscribes = [
153
+ router.subscribe("onBeforeRouteMount", commitSelection),
154
+ router.subscribe("onResolved", commitSelection),
155
+ router.subscribe("onResolved", () => {
156
+ title = shownTitle();
157
+ }),
158
+ getPHStoreSubscribe(store, "drives")(retitle),
159
+ markRouterNavigations(router),
160
+ ];
161
+ const unbindScroll = bindConnectScroll(router, CONTENT_VIEW_ID);
162
+ commitSelection();
163
+
164
+ return () => {
165
+ navigation.dispose();
166
+ unbindScroll();
167
+ for (const unsubscribe of unsubscribes) unsubscribe();
168
+ if (store.navigation === navigation) store.navigation = undefined;
169
+ };
170
+ }
@@ -0,0 +1,116 @@
1
+ // The drive route's loader. Server-safe: it reads everything from router context.
2
+ import type { DriveArrivals, PHStore } from "@powerhousedao/reactor-browser";
3
+ import {
4
+ findDriveBySlugOrId,
5
+ makeDriveSlug,
6
+ makeNodeSlug,
7
+ resolveDriveRoute,
8
+ } from "@powerhousedao/reactor-browser";
9
+ import { notFound, redirect } from "@tanstack/react-router";
10
+ import type { ConnectRouteComponents } from "./route-components.js";
11
+
12
+ export type ConnectRouterContext = {
13
+ store: PHStore;
14
+ /** Without it the drive route never waits for drives to arrive. */
15
+ arrivals?: DriveArrivals;
16
+ /** What the file routes render; `createConnectRouter` sets them. */
17
+ components?: ConnectRouteComponents;
18
+ /** Ends every document title; "Connect" without one. */
19
+ appName?: string;
20
+ };
21
+
22
+ /** The route a missing drive's not-found page replaces: the content view. */
23
+ export const DRIVE_NOT_FOUND_ROUTE_ID = "/_app/_content";
24
+
25
+ /** A missing drive's not-found data. */
26
+ export type DriveNotFoundData = { driveSlug: string };
27
+
28
+ export function isDriveNotFound(data: unknown): data is DriveNotFoundData {
29
+ return (
30
+ typeof data === "object" &&
31
+ data !== null &&
32
+ typeof (data as { driveSlug?: unknown }).driveSlug === "string"
33
+ );
34
+ }
35
+
36
+ /** What the drive route resolved its params to. */
37
+ export type DriveRouteData = { driveId: string; nodeId?: string };
38
+
39
+ export type DriveRouteParams = { driveSlug: string; nodeSlug?: string };
40
+
41
+ /** Resolves a drive route's slugs; a missing drive is not found and a missing
42
+ * node leads to its drive. */
43
+ export async function loadDriveRoute(options: {
44
+ params: DriveRouteParams;
45
+ context: ConnectRouterContext;
46
+ signal: AbortSignal;
47
+ preload: boolean;
48
+ }): Promise<DriveRouteData> {
49
+ const { params, context, signal, preload } = options;
50
+ const result = await resolveDriveRoute({
51
+ store: context.store,
52
+ arrivals: context.arrivals,
53
+ driveSlug: params.driveSlug,
54
+ nodeSlug: params.nodeSlug,
55
+ signal,
56
+ preload,
57
+ });
58
+ switch (result.kind) {
59
+ case "drive": {
60
+ const data: DriveRouteData = result.nodeId
61
+ ? { driveId: result.driveId, nodeId: result.nodeId }
62
+ : { driveId: result.driveId };
63
+ const canonical = canonicalParams(context.store, data);
64
+ // An id, an old name or an old drive id in the URL becomes the current slugs.
65
+ if (
66
+ !preload &&
67
+ canonical &&
68
+ (canonical.driveSlug !== params.driveSlug ||
69
+ canonical.nodeSlug !== (params.nodeSlug || undefined))
70
+ ) {
71
+ // oxlint-disable-next-line typescript/only-throw-error -- router control flow
72
+ throw redirectTo(canonical);
73
+ }
74
+ return data;
75
+ }
76
+ case "drive-not-found":
77
+ // Shown in place of the content view, so no stale drive renders beside it.
78
+ // oxlint-disable-next-line typescript/only-throw-error -- router control flow
79
+ throw notFound({
80
+ routeId: DRIVE_NOT_FOUND_ROUTE_ID as never,
81
+ data: { driveSlug: params.driveSlug } satisfies DriveNotFoundData,
82
+ });
83
+ case "node-not-found":
84
+ // oxlint-disable-next-line typescript/only-throw-error -- router control flow
85
+ throw redirectTo({
86
+ driveSlug:
87
+ canonicalParams(context.store, { driveId: result.driveId })
88
+ ?.driveSlug ?? params.driveSlug,
89
+ nodeSlug: undefined,
90
+ });
91
+ }
92
+ }
93
+
94
+ // The slugs links write for `data`; unknown while the drive is unlisted.
95
+ function canonicalParams(
96
+ store: PHStore,
97
+ data: DriveRouteData,
98
+ ): DriveRouteParams | undefined {
99
+ const drive = findDriveBySlugOrId(store, data.driveId);
100
+ if (!drive) return undefined;
101
+ if (!data.nodeId) return { driveSlug: makeDriveSlug(drive) };
102
+ const node = drive.state.global.nodes.find((n) => n.id === data.nodeId);
103
+ if (!node) return undefined;
104
+ return { driveSlug: makeDriveSlug(drive), nodeSlug: makeNodeSlug(node) };
105
+ }
106
+
107
+ // In place, with the URL's search params and history state (the opened-from index).
108
+ function redirectTo(params: DriveRouteParams) {
109
+ return redirect({
110
+ to: "/d/$driveSlug/{-$nodeSlug}",
111
+ params,
112
+ search: true,
113
+ state: true,
114
+ replace: true,
115
+ });
116
+ }
@@ -0,0 +1,51 @@
1
+ // Connect's router, without the app: safe to import where the app doesn't boot.
2
+ export {
3
+ bindConnectRouter,
4
+ CONTENT_VIEW_ID,
5
+ createConnectRouter,
6
+ } from "./connect-router.js";
7
+ export type {
8
+ ConnectRouter,
9
+ ConnectRouterBundle,
10
+ ConnectRouterFor,
11
+ ConnectRouterOptions,
12
+ } from "./connect-router.js";
13
+ export { loadDriveRoute } from "./drive-route-loader.js";
14
+ export type {
15
+ ConnectRouterContext,
16
+ DriveRouteData,
17
+ DriveRouteParams,
18
+ } from "./drive-route-loader.js";
19
+ export { createConnectNavigation } from "./navigation.js";
20
+ export {
21
+ addConnectRoutes,
22
+ connectRoutes,
23
+ createConnectRouteTree,
24
+ DRIVE_PENDING_MS,
25
+ APP_ROUTE_ID,
26
+ HOME_ROUTE_ID,
27
+ } from "./route-tree.js";
28
+ export type {
29
+ ConnectRootRoute,
30
+ ConnectRouteComponents,
31
+ ConnectRoutes,
32
+ ConnectRouteTree,
33
+ } from "./route-tree.js";
34
+ export {
35
+ connectSearchMiddlewares,
36
+ FEATURE_FLAG_PARAM_PREFIX,
37
+ GLOBAL_SEARCH_PARAMS,
38
+ parseConnectSearch,
39
+ stringifyConnectSearch,
40
+ } from "./search.js";
41
+ export type { ConnectSearch } from "./search.js";
42
+ export type { CoreSettingsTabId } from "./route-components.js";
43
+ export { navRoutes, useNavRoutes, useSidebarMode } from "./sidebar.js";
44
+ export type { ConnectNavItem, NavRouteEntry, SidebarMode } from "./sidebar.js";
45
+ export {
46
+ SETTINGS_ROUTE_ID,
47
+ settingsTabs,
48
+ settingsTitle,
49
+ useSettingsTabs,
50
+ } from "./settings.js";
51
+ export type { ConnectSettingsTab, SettingsTabEntry } from "./settings.js";
@@ -0,0 +1,230 @@
1
+ import type {
2
+ PHDriveTarget,
3
+ PHNavigation,
4
+ PHNavigationTarget,
5
+ PHSettingsTarget,
6
+ SetSearchParams,
7
+ } from "@powerhousedao/reactor-browser";
8
+ import {
9
+ applySearchUpdate,
10
+ findDriveBySlugOrId,
11
+ isSettingsTarget,
12
+ makeDriveSlug,
13
+ OPENED_FROM_STATE_KEY,
14
+ openedFromIndex,
15
+ resolveSearchUpdate,
16
+ } from "@powerhousedao/reactor-browser";
17
+ import type {
18
+ AnyRouter,
19
+ HistoryState,
20
+ MakeRouteMatchUnion,
21
+ } from "@tanstack/react-router";
22
+ import { useRouterState } from "@tanstack/react-router";
23
+ import { useMemo } from "react";
24
+ import type { ConnectRouterBundle } from "./connect-router.js";
25
+ import { markNavigationClick } from "./perf-marks.js";
26
+ import { definedSearch } from "./search.js";
27
+ import { keepOpenedFrom, settingsTabs } from "./settings.js";
28
+
29
+ // Hover intent: a pointer passing over cards doesn't preload each of them.
30
+ const PRELOAD_DELAY_MS = 50;
31
+
32
+ /** The PH navigation backed by `router`; its hooks take the router directly,
33
+ * so they work outside the RouterProvider. */
34
+ export function createConnectNavigation(
35
+ connectRouter: ConnectRouterBundle,
36
+ ): PHNavigation & { dispose(): void } {
37
+ const { router, homeRoute, driveRoute, settingsRoute } = connectRouter;
38
+ // Settings tabs can come from a project's routes, unknown to Connect's types.
39
+ const anyRouter = router as unknown as AnyRouter;
40
+
41
+ // A listed drive is addressed by its canonical slug, whatever form came in.
42
+ const driveParams = (target: PHDriveTarget) => {
43
+ const drive = findDriveBySlugOrId(
44
+ router.options.context.store,
45
+ target.driveSlug,
46
+ );
47
+ return {
48
+ driveSlug: drive ? makeDriveSlug(drive) : target.driveSlug,
49
+ nodeSlug: target.nodeSlug || undefined,
50
+ };
51
+ };
52
+
53
+ // `true` is the first tab, so the URL names a tab without a redirect.
54
+ const settingsPath = ({ settings }: PHSettingsTarget) => {
55
+ const tab =
56
+ settings === true ? settingsTabs(anyRouter).at(0)?.id : settings;
57
+ return tab ? `${settingsRoute.fullPath}/${tab}` : settingsRoute.fullPath;
58
+ };
59
+
60
+ // In-document writes keep the entry's state, so its opened-from index too.
61
+ const setSearch: PHNavigation["setSearch"] = (update, options) => {
62
+ void router.navigate({
63
+ to: ".",
64
+ search: (prev) => applySearchUpdate({}, update(definedSearch(prev))),
65
+ state: true,
66
+ replace: options?.replace,
67
+ resetScroll: false,
68
+ });
69
+ };
70
+
71
+ const showsSettings = () =>
72
+ router.state.matches.some((match) => match.routeId === settingsRoute.id);
73
+
74
+ // A push remembers the entry it leaves; a replace keeps what that one had,
75
+ // as does a move between settings tabs.
76
+ const openedFromState = (
77
+ replace: boolean | undefined,
78
+ target: PHNavigationTarget | undefined,
79
+ ) => {
80
+ const { state } = router.history.location;
81
+ const next =
82
+ replace || (isSettingsTarget(target) && showsSettings())
83
+ ? keepOpenedFrom(state)
84
+ : ({
85
+ [OPENED_FROM_STATE_KEY]: state.__TSR_index,
86
+ } as unknown as HistoryState);
87
+ return () => next;
88
+ };
89
+
90
+ const targetKey = (target: PHNavigationTarget | undefined) => {
91
+ if (!target) return homeRoute.id;
92
+ if (isSettingsTarget(target)) return settingsPath(target);
93
+ const { driveSlug, nodeSlug } = driveParams(target);
94
+ return JSON.stringify([driveSlug, nodeSlug ?? ""]);
95
+ };
96
+ let keyedMatches: readonly MakeRouteMatchUnion[] | undefined;
97
+ let matchesKey: string | undefined;
98
+ const currentKey = (matches: readonly MakeRouteMatchUnion[]) => {
99
+ if (matches === keyedMatches) return matchesKey;
100
+ keyedMatches = matches;
101
+ const drive = matches.find((match) => match.routeId === driveRoute.id);
102
+ const settings = matches.some(
103
+ (match) => match.routeId === settingsRoute.id,
104
+ );
105
+ if (drive) {
106
+ matchesKey = targetKey(drive.params as PHDriveTarget);
107
+ } else if (settings) {
108
+ // A tab's key is its path, as settingsPath builds it.
109
+ matchesKey = matches.at(-1)?.fullPath.replace(/\/$/, "");
110
+ } else {
111
+ matchesKey = matches.find(
112
+ (match) => match.routeId === homeRoute.id,
113
+ )?.routeId;
114
+ }
115
+ return matchesKey;
116
+ };
117
+
118
+ // Hrefs depend only on the target and the global params of the current search.
119
+ const hrefs = new Map<string, string>();
120
+ let hrefsSearch: string | undefined;
121
+
122
+ const setSearchParams: SetSearchParams = (update, options) =>
123
+ setSearch((prev) => resolveSearchUpdate(prev, update), options);
124
+
125
+ let preloadTimer: ReturnType<typeof setTimeout> | undefined;
126
+ return {
127
+ location: () => router.history.location,
128
+ // The root route's middlewares add the global params to `search`.
129
+ open: (target, options) => {
130
+ markNavigationClick();
131
+ const search = applySearchUpdate({}, options?.search ?? {});
132
+ const replace = options?.replace;
133
+ const state = openedFromState(replace, target);
134
+ if (!target) {
135
+ void router.navigate({
136
+ to: homeRoute.fullPath,
137
+ search,
138
+ replace,
139
+ state,
140
+ });
141
+ return;
142
+ }
143
+ if (isSettingsTarget(target)) {
144
+ void anyRouter.navigate({
145
+ to: settingsPath(target),
146
+ search,
147
+ replace,
148
+ state,
149
+ });
150
+ return;
151
+ }
152
+ void router.navigate({
153
+ to: driveRoute.fullPath,
154
+ params: driveParams(target),
155
+ search,
156
+ replace,
157
+ state,
158
+ });
159
+ },
160
+ // The public href, base path included; global params as `open` keeps them.
161
+ hrefFor: (target) => {
162
+ const { searchStr } = router.latestLocation;
163
+ if (searchStr !== hrefsSearch) {
164
+ hrefs.clear();
165
+ hrefsSearch = searchStr;
166
+ }
167
+ const key = targetKey(target);
168
+ let href = hrefs.get(key);
169
+ if (href === undefined) {
170
+ const location = !target
171
+ ? router.buildLocation({ to: homeRoute.fullPath, search: {} })
172
+ : isSettingsTarget(target)
173
+ ? anyRouter.buildLocation({ to: settingsPath(target), search: {} })
174
+ : router.buildLocation({
175
+ to: driveRoute.fullPath,
176
+ params: driveParams(target),
177
+ search: {},
178
+ });
179
+ href = location.publicHref;
180
+ hrefs.set(key, href);
181
+ }
182
+ return href;
183
+ },
184
+ // One key per shown matches, so each link's selector is a string compare.
185
+ useIsCurrent: (target) => {
186
+ // The settings page itself is current on any of its tabs.
187
+ const anyTab = isSettingsTarget(target) && target.settings === true;
188
+ const key = anyTab ? `${settingsRoute.fullPath}/` : targetKey(target);
189
+ return useRouterState({
190
+ router,
191
+ select: (state) => {
192
+ const current = currentKey(state.matches);
193
+ return anyTab ? !!current?.startsWith(key) : current === key;
194
+ },
195
+ });
196
+ },
197
+ preload: (target) => {
198
+ clearTimeout(preloadTimer);
199
+ if (!target) return;
200
+ preloadTimer = setTimeout(() => {
201
+ const preloading = isSettingsTarget(target)
202
+ ? anyRouter.preloadRoute({ to: settingsPath(target) })
203
+ : router.preloadRoute({
204
+ to: driveRoute.fullPath,
205
+ params: driveParams(target),
206
+ });
207
+ preloading.catch(() => undefined);
208
+ }, PRELOAD_DELAY_MS);
209
+ },
210
+ setSearch,
211
+ // The presented matches' params, else the location's.
212
+ useSearchParams() {
213
+ const search = useRouterState({
214
+ router,
215
+ select: (state) =>
216
+ state.matches.at(-1)?.search ?? state.location.search,
217
+ });
218
+ return useMemo(() => definedSearch(search), [search]);
219
+ },
220
+ useSetSearchParams: () => setSearchParams,
221
+ closeOpened: () => {
222
+ const { state } = router.history.location;
223
+ const from = openedFromIndex(state, state.__TSR_index);
224
+ if (from === undefined) return false;
225
+ router.history.go(from - state.__TSR_index);
226
+ return true;
227
+ },
228
+ dispose: () => clearTimeout(preloadTimer),
229
+ };
230
+ }
@@ -0,0 +1,98 @@
1
+ // @vitest-environment happy-dom
2
+
3
+ import { act, cleanup, render } from "@testing-library/react";
4
+ import {
5
+ createMemoryHistory,
6
+ createRootRoute,
7
+ createRoute,
8
+ createRouter,
9
+ Outlet,
10
+ RouterProvider,
11
+ } from "@tanstack/react-router";
12
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
13
+ import {
14
+ markNavigationClick,
15
+ markRouterNavigations,
16
+ PERF_STORAGE_KEY,
17
+ ROUTER_MEASURES,
18
+ routerPerfEnabled,
19
+ } from "./perf-marks.js";
20
+
21
+ function mountRouter() {
22
+ const rootRoute = createRootRoute({ component: Outlet });
23
+ const pages = ["a", "b"].map((path) =>
24
+ createRoute({
25
+ getParentRoute: () => rootRoute,
26
+ path,
27
+ loader: () => new Promise((resolve) => setTimeout(resolve, 5)),
28
+ component: () => <p>{path}</p>,
29
+ }),
30
+ );
31
+ const router = createRouter({
32
+ routeTree: rootRoute.addChildren(pages),
33
+ history: createMemoryHistory({ initialEntries: ["/a"] }),
34
+ });
35
+ render(<RouterProvider router={router} />);
36
+ return router;
37
+ }
38
+
39
+ const measures = () =>
40
+ performance.getEntriesByType("measure").map((entry) => entry.name);
41
+
42
+ async function clickTo(router: ReturnType<typeof mountRouter>, to: string) {
43
+ await vi.waitFor(() => expect(router.state.status).toBe("idle"));
44
+ performance.clearMeasures();
45
+ performance.clearMarks();
46
+ markNavigationClick();
47
+ await act(() => router.navigate({ to }));
48
+ }
49
+
50
+ let unmark: (() => void) | undefined;
51
+
52
+ beforeEach(() => {
53
+ performance.clearMeasures();
54
+ performance.clearMarks();
55
+ });
56
+
57
+ afterEach(() => {
58
+ unmark?.();
59
+ unmark = undefined;
60
+ cleanup();
61
+ localStorage.removeItem(PERF_STORAGE_KEY);
62
+ window.history.replaceState(null, "", "/");
63
+ });
64
+
65
+ describe("router performance marks", () => {
66
+ it("measures click, loader, commit and total when enabled", async () => {
67
+ const router = mountRouter();
68
+ unmark = markRouterNavigations(router, true);
69
+ await clickTo(router, "/b");
70
+ await vi.waitFor(() =>
71
+ expect(measures()).toEqual(
72
+ expect.arrayContaining(Object.values(ROUTER_MEASURES)),
73
+ ),
74
+ );
75
+ const [loader] = performance.getEntriesByName(ROUTER_MEASURES.loader);
76
+ expect(loader.duration).toBeGreaterThan(0);
77
+ expect(performance.getEntriesByName("nav:click", "mark")).toHaveLength(1);
78
+ });
79
+
80
+ it("writes nothing when disabled", async () => {
81
+ const router = mountRouter();
82
+ unmark = markRouterNavigations(router, false);
83
+ await clickTo(router, "/b");
84
+ await act(() => new Promise((resolve) => setTimeout(resolve, 50)));
85
+ expect(measures()).toEqual([]);
86
+ expect(performance.getEntriesByType("mark")).toEqual([]);
87
+ });
88
+
89
+ it("is on in dev, and elsewhere only with ?perf=1 or the storage flag", () => {
90
+ expect(routerPerfEnabled(true)).toBe(true);
91
+ expect(routerPerfEnabled(false)).toBe(false);
92
+ window.history.replaceState(null, "", "/?perf=1");
93
+ expect(routerPerfEnabled(false)).toBe(true);
94
+ window.history.replaceState(null, "", "/");
95
+ localStorage.setItem(PERF_STORAGE_KEY, "1");
96
+ expect(routerPerfEnabled(false)).toBe(true);
97
+ });
98
+ });