@powerhousedao/connect 6.2.3-dev.66 → 6.2.3-dev.67

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 (248) hide show
  1. package/CUSTOMIZING.md +77 -0
  2. package/README.md +18 -91
  3. package/RUNTIME-CONFIG.md +472 -0
  4. package/dist/{AddDriveModal-D_3jDwjp.js → AddDriveModal-BjgmiHJr.js} +6 -6
  5. package/dist/AddDriveModal-BjgmiHJr.js.map +1 -0
  6. package/dist/{ClearStorageModal-zZ8XzwmR.js → ClearStorageModal-_03VgDb5.js} +6 -6
  7. package/dist/ClearStorageModal-_03VgDb5.js.map +1 -0
  8. package/dist/{ConfirmDocumentUpgradeModal-CrU2Z1CL.js → ConfirmDocumentUpgradeModal-CoixS60F.js} +5 -5
  9. package/dist/ConfirmDocumentUpgradeModal-CoixS60F.js.map +1 -0
  10. package/dist/{CookiesPolicyModal-DQwsgDI9.js → CookiesPolicyModal-BpFjYc7T.js} +4 -4
  11. package/dist/{CookiesPolicyModal-DQwsgDI9.js.map → CookiesPolicyModal-BpFjYc7T.js.map} +1 -1
  12. package/dist/{CreateDocumentModal-Cf1APibL.js → CreateDocumentModal-B-cXzeOA.js} +10 -10
  13. package/dist/CreateDocumentModal-B-cXzeOA.js.map +1 -0
  14. package/dist/{DebugSettingsModal-DIc5C2lI.js → DebugSettingsModal-CGScJ_r2.js} +8 -8
  15. package/dist/DebugSettingsModal-CGScJ_r2.js.map +1 -0
  16. package/dist/{DeleteDriveModal-lE9eCBua.js → DeleteDriveModal-1pAIayG_.js} +5 -5
  17. package/dist/DeleteDriveModal-1pAIayG_.js.map +1 -0
  18. package/dist/{DeleteItemModal-BFgcGsm3.js → DeleteItemModal-BUpqmFxS.js} +5 -5
  19. package/dist/DeleteItemModal-BUpqmFxS.js.map +1 -0
  20. package/dist/{DisclaimerModal-CF6JkIIu.js → DisclaimerModal-TIJXRYLF.js} +5 -5
  21. package/dist/DisclaimerModal-TIJXRYLF.js.map +1 -0
  22. package/dist/{DocumentVersionUnsupportedModal-Cm9Jb9W7.js → DocumentVersionUnsupportedModal-DH9Zzsyw.js} +5 -5
  23. package/dist/DocumentVersionUnsupportedModal-DH9Zzsyw.js.map +1 -0
  24. package/dist/{DownloadDocumentWithErrorsModal-CShKhfEQ.js → DownloadDocumentWithErrorsModal-Beh-xw8B.js} +5 -5
  25. package/dist/DownloadDocumentWithErrorsModal-Beh-xw8B.js.map +1 -0
  26. package/dist/{DriveAuthRequiredModal-CMwPUyZf.js → DriveAuthRequiredModal-XTcoJKvj.js} +6 -6
  27. package/dist/DriveAuthRequiredModal-XTcoJKvj.js.map +1 -0
  28. package/dist/{DriveSettingsModal-BSImj4BH.js → DriveSettingsModal-DZKawN7w.js} +5 -5
  29. package/dist/DriveSettingsModal-DZKawN7w.js.map +1 -0
  30. package/dist/{InspectorModal-Dr8-gj6u.js → InspectorModal-DA_TGmM6.js} +16 -16
  31. package/dist/InspectorModal-DA_TGmM6.js.map +1 -0
  32. package/dist/{LoginModal-DT_05uva.js → LoginModal-O06ZvWFI.js} +6 -6
  33. package/dist/LoginModal-O06ZvWFI.js.map +1 -0
  34. package/dist/{OpenFileDocumentsModal-X9GnX2Bk.js → OpenFileDocumentsModal-BNHD0vg9.js} +6 -6
  35. package/dist/OpenFileDocumentsModal-BNHD0vg9.js.map +1 -0
  36. package/dist/{UpgradeDriveModal-DvM-PNWe.js → UpgradeDriveModal-CCWKp5yn.js} +5 -5
  37. package/dist/UpgradeDriveModal-CCWKp5yn.js.map +1 -0
  38. package/dist/{app-loader-DrViXipO.js → app-loader-CEN_4I3I.js} +149 -196
  39. package/dist/app-loader-CEN_4I3I.js.map +1 -0
  40. package/dist/app-loader-Cj2p8L1I.js +4 -0
  41. package/dist/{app-skeleton-gzg8cRzm.js → app-skeleton-BFjvlTWd.js} +11 -11
  42. package/dist/app-skeleton-BFjvlTWd.js.map +1 -0
  43. package/dist/{app-skeleton-DYLZ7npI.js → app-skeleton-DFg65Rxa.js} +3 -3
  44. package/dist/{boot-CC_DgQKX.js → boot-JTGLJtmJ.js} +6 -6
  45. package/dist/boot-JTGLJtmJ.js.map +1 -0
  46. package/dist/{build-info-DMrToXJe.js → build-info-DkY9PU7c.js} +5 -5
  47. package/dist/{build-info-DMrToXJe.js.map → build-info-DkY9PU7c.js.map} +1 -1
  48. package/dist/{components-CjF9XjxP.js → components-2wvJ3_Ho.js} +11 -10
  49. package/dist/{components-CjF9XjxP.js.map → components-2wvJ3_Ho.js.map} +1 -1
  50. package/dist/{connect.config-uZF-gnvV.js → connect.config-D1pGNmaF.js} +4 -4
  51. package/dist/connect.config-D1pGNmaF.js.map +1 -0
  52. package/dist/{connection-state-C_477Kr_.js → connection-state-B6fleM37.js} +6 -6
  53. package/dist/connection-state-B6fleM37.js.map +1 -0
  54. package/dist/{cookie-banner-HPgyuHM5.js → cookie-banner-CAvd3PC3.js} +6 -6
  55. package/dist/{cookie-banner-HPgyuHM5.js.map → cookie-banner-CAvd3PC3.js.map} +1 -1
  56. package/dist/document-editor-container-BnEjlmaN.js +307 -0
  57. package/dist/document-editor-container-BnEjlmaN.js.map +1 -0
  58. package/dist/document-editor-container-kgS38mkb.js +4 -0
  59. package/dist/error-boundary-BsUBww61.js +155 -0
  60. package/dist/error-boundary-BsUBww61.js.map +1 -0
  61. package/dist/generic.d.ts +116 -0
  62. package/dist/generic.d.ts.map +1 -0
  63. package/dist/generic.js +31 -0
  64. package/dist/generic.js.map +1 -0
  65. package/dist/{i18n-CTgT1HG-.js → i18n-D9WYPgk9.js} +4 -4
  66. package/dist/{i18n-CTgT1HG-.js.map → i18n-D9WYPgk9.js.map} +1 -1
  67. package/dist/index-B4g8swZG.d.ts +4 -0
  68. package/dist/layout-BOX6fL5v.js +5 -0
  69. package/dist/layout.d.ts +2 -28
  70. package/dist/layout.js +4 -6
  71. package/dist/{load--K_UgzUy.js → load-CCCHqC0d.js} +11 -11
  72. package/dist/{load--K_UgzUy.js.map → load-CCCHqC0d.js.map} +1 -1
  73. package/dist/load-runtime-config-Dhy-b5wT.js +14 -0
  74. package/dist/load-runtime-config-Dhy-b5wT.js.map +1 -0
  75. package/dist/main.js +2 -2
  76. package/dist/{open-file-uploads-BcyWmUZn.js → open-file-uploads-B5pr1sA2.js} +4 -4
  77. package/dist/{open-file-uploads-BcyWmUZn.js.map → open-file-uploads-B5pr1sA2.js.map} +1 -1
  78. package/dist/{package-manager-BkFRzovd.js → package-manager-x_fK8Hzm.js} +92 -60
  79. package/dist/package-manager-x_fK8Hzm.js.map +1 -0
  80. package/dist/{pglite-seed-BsEPByVM.js → pglite-seed-eGzXMld2.js} +4 -4
  81. package/dist/{pglite-seed-BsEPByVM.js.map → pglite-seed-eGzXMld2.js.map} +1 -1
  82. package/dist/{plugin-host--lBWChr9.js → plugins-B9VBgzio.js} +75 -83
  83. package/dist/plugins-B9VBgzio.js.map +1 -0
  84. package/dist/{preferences-store-DANUajdg.js → preferences-store-CSqauT9V.js} +5 -5
  85. package/dist/preferences-store-CSqauT9V.js.map +1 -0
  86. package/dist/prerender.d.ts +38 -0
  87. package/dist/prerender.d.ts.map +1 -0
  88. package/dist/prerender.js +177 -0
  89. package/dist/prerender.js.map +1 -0
  90. package/dist/{prerendered-shell-DxCUDEXL.js → prerendered-shell-peKE7AqI.js} +10 -4
  91. package/dist/prerendered-shell-peKE7AqI.js.map +1 -0
  92. package/dist/{reactor-5nod7BfF.js → reactor-BmI-D8O-.js} +25 -156
  93. package/dist/reactor-BmI-D8O-.js.map +1 -0
  94. package/dist/{registerServiceWorker-CkVxA2KC.js → registerServiceWorker-APlHkrmH.js} +4 -4
  95. package/dist/{registerServiceWorker-CkVxA2KC.js.map → registerServiceWorker-APlHkrmH.js.map} +1 -1
  96. package/dist/root-B1Pq9x6S.js +24 -0
  97. package/dist/root-B1Pq9x6S.js.map +1 -0
  98. package/dist/route-tree.d.ts +147 -156
  99. package/dist/route-tree.d.ts.map +1 -1
  100. package/dist/route-tree.js +93 -169
  101. package/dist/route-tree.js.map +1 -1
  102. package/dist/route-views-BF0p-4Fi.js +60 -0
  103. package/dist/route-views-BF0p-4Fi.js.map +1 -0
  104. package/dist/route-views-CTARvT5N.js +55 -0
  105. package/dist/route-views-CTARvT5N.js.map +1 -0
  106. package/dist/route-views-D8I-1PWU.js +4 -0
  107. package/dist/route-views.d.ts +7 -0
  108. package/dist/route-views.d.ts.map +1 -0
  109. package/dist/route-views.js +4 -0
  110. package/dist/router-BguOMBUh.js +4 -0
  111. package/dist/router-L9X9U-97.js +46 -0
  112. package/dist/router-L9X9U-97.js.map +1 -0
  113. package/dist/router.d.ts +1 -3
  114. package/dist/router.js +3 -7
  115. package/dist/sentry-Cuc_Nbba.js +22 -0
  116. package/dist/sentry-Cuc_Nbba.js.map +1 -0
  117. package/dist/{settings-DkLhRfEI.js → settings-DjQfTrBe.js} +488 -22
  118. package/dist/settings-DjQfTrBe.js.map +1 -0
  119. package/dist/settings-tabs-iTlo2pYz.js +365 -0
  120. package/dist/settings-tabs-iTlo2pYz.js.map +1 -0
  121. package/dist/shell-core-head.html +2 -0
  122. package/dist/shell-core.html +1 -0
  123. package/dist/shell-head.html +2 -1
  124. package/dist/shell-plugins.json +1 -0
  125. package/dist/shell.html +1 -1
  126. package/dist/start-connect.d.ts +5 -9
  127. package/dist/start-connect.d.ts.map +1 -1
  128. package/dist/start-connect.js +5 -6
  129. package/dist/start-connect.js.map +1 -1
  130. package/dist/style.css +3127 -4014
  131. package/dist/ui-b6sMhi5V.js +66 -0
  132. package/dist/ui-b6sMhi5V.js.map +1 -0
  133. package/dist/{use-renown-login-BzOSQETV.js → use-renown-login-dPpDOYq5.js} +4 -4
  134. package/dist/use-renown-login-dPpDOYq5.js.map +1 -0
  135. package/docs/customizing/data-and-navigation.md +177 -0
  136. package/docs/customizing/hosts-and-plugins.md +65 -0
  137. package/docs/customizing/layout.md +149 -0
  138. package/docs/customizing/modals.md +78 -0
  139. package/docs/customizing/overrides.md +113 -0
  140. package/docs/customizing/packages.md +38 -0
  141. package/docs/customizing/pages.md +136 -0
  142. package/docs/customizing/styles-and-branding.md +41 -0
  143. package/docs/customizing/types-and-troubleshooting.md +44 -0
  144. package/package.json +41 -18
  145. package/scripts/prerender-shell.ts +35 -84
  146. package/skills/customize-connect/SKILL.md +74 -0
  147. package/src/route-tree.ts +3 -0
  148. package/src/routeTree.gen.ts +134 -192
  149. package/src/router/index.ts +2 -51
  150. package/src/router/register.ts +1 -1
  151. package/src/routes/__root.tsx +8 -24
  152. package/src/routes/_app/$.tsx +13 -0
  153. package/src/routes/_app/d/$driveSlug/{-$nodeSlug}.tsx +13 -0
  154. package/src/routes/_app/d/$driveSlug.tsx +13 -0
  155. package/src/routes/_app/index.tsx +13 -0
  156. package/src/routes/_app/settings/appearance.tsx +13 -0
  157. package/src/routes/_app/settings/packages.tsx +13 -0
  158. package/src/routes/_app/settings.tsx +13 -0
  159. package/src/routes/_app.tsx +13 -0
  160. package/style.css +5 -22
  161. package/tailwind.css +12 -0
  162. package/dist/AddDriveModal-D_3jDwjp.js.map +0 -1
  163. package/dist/ClearStorageModal-zZ8XzwmR.js.map +0 -1
  164. package/dist/ConfirmDocumentUpgradeModal-CrU2Z1CL.js.map +0 -1
  165. package/dist/CreateDocumentModal-Cf1APibL.js.map +0 -1
  166. package/dist/DebugSettingsModal-DIc5C2lI.js.map +0 -1
  167. package/dist/DeleteDriveModal-lE9eCBua.js.map +0 -1
  168. package/dist/DeleteItemModal-BFgcGsm3.js.map +0 -1
  169. package/dist/DisclaimerModal-CF6JkIIu.js.map +0 -1
  170. package/dist/DocumentVersionUnsupportedModal-Cm9Jb9W7.js.map +0 -1
  171. package/dist/DownloadDocumentWithErrorsModal-CShKhfEQ.js.map +0 -1
  172. package/dist/DriveAuthRequiredModal-CMwPUyZf.js.map +0 -1
  173. package/dist/DriveSettingsModal-BSImj4BH.js.map +0 -1
  174. package/dist/InspectorModal-Dr8-gj6u.js.map +0 -1
  175. package/dist/LoginModal-DT_05uva.js.map +0 -1
  176. package/dist/MissingPackageModal-DtISKgub.js +0 -49
  177. package/dist/MissingPackageModal-DtISKgub.js.map +0 -1
  178. package/dist/OpenFileDocumentsModal-X9GnX2Bk.js.map +0 -1
  179. package/dist/UpgradeDriveModal-DvM-PNWe.js.map +0 -1
  180. package/dist/app-layout-BIq-ZW-6.js +0 -394
  181. package/dist/app-layout-BIq-ZW-6.js.map +0 -1
  182. package/dist/app-loader-CWAH-WxW.js +0 -4
  183. package/dist/app-loader-DrViXipO.js.map +0 -1
  184. package/dist/app-skeleton-gzg8cRzm.js.map +0 -1
  185. package/dist/boot-CC_DgQKX.js.map +0 -1
  186. package/dist/connect-router-KmNBGS0G.js +0 -434
  187. package/dist/connect-router-KmNBGS0G.js.map +0 -1
  188. package/dist/connect.config-uZF-gnvV.js.map +0 -1
  189. package/dist/connection-state-C_477Kr_.js.map +0 -1
  190. package/dist/index-UrZFqSgm.d.ts +0 -166
  191. package/dist/index-UrZFqSgm.d.ts.map +0 -1
  192. package/dist/layout.d.ts.map +0 -1
  193. package/dist/multi-reactor-fSKpLBjT.js +0 -220
  194. package/dist/multi-reactor-fSKpLBjT.js.map +0 -1
  195. package/dist/package-manager-BkFRzovd.js.map +0 -1
  196. package/dist/plugin-host--lBWChr9.js.map +0 -1
  197. package/dist/preferences-store-DANUajdg.js.map +0 -1
  198. package/dist/prerendered-shell-DxCUDEXL.js.map +0 -1
  199. package/dist/reactor-5nod7BfF.js.map +0 -1
  200. package/dist/route-components-BkztQruF.js +0 -148
  201. package/dist/route-components-BkztQruF.js.map +0 -1
  202. package/dist/router-8RIbbf6v.js +0 -4
  203. package/dist/router-C37yATTD.js +0 -604
  204. package/dist/router-C37yATTD.js.map +0 -1
  205. package/dist/runtime-config-DdN1Frg7.js +0 -34
  206. package/dist/runtime-config-DdN1Frg7.js.map +0 -1
  207. package/dist/runtime-flag-B8IYhkz-.js +0 -4
  208. package/dist/runtime-flag-CT5OKujT.js +0 -45
  209. package/dist/runtime-flag-CT5OKujT.js.map +0 -1
  210. package/dist/sentry-CJb7--mu.js +0 -18
  211. package/dist/sentry-CJb7--mu.js.map +0 -1
  212. package/dist/settings-CjvK8OKA.js +0 -91
  213. package/dist/settings-CjvK8OKA.js.map +0 -1
  214. package/dist/settings-DkLhRfEI.js.map +0 -1
  215. package/dist/sidebar-BXf8OEwm.d.ts +0 -34
  216. package/dist/sidebar-BXf8OEwm.d.ts.map +0 -1
  217. package/dist/sidebar-lAVFRsni.js +0 -31
  218. package/dist/sidebar-lAVFRsni.js.map +0 -1
  219. package/dist/use-renown-login-BzOSQETV.js.map +0 -1
  220. package/dist/useIsEmbedded-BWJ0qb7w.js +0 -26
  221. package/dist/useIsEmbedded-BWJ0qb7w.js.map +0 -1
  222. package/dist/useRegistryPackages-BqIWwXV-.js +0 -452
  223. package/dist/useRegistryPackages-BqIWwXV-.js.map +0 -1
  224. package/scripts/critical-css.ts +0 -243
  225. package/src/router/connect-router.ts +0 -170
  226. package/src/router/drive-route-loader.ts +0 -116
  227. package/src/router/navigation.ts +0 -230
  228. package/src/router/perf-marks.test.tsx +0 -98
  229. package/src/router/perf-marks.ts +0 -97
  230. package/src/router/route-components.tsx +0 -98
  231. package/src/router/route-tree.ts +0 -88
  232. package/src/router/scroll.ts +0 -69
  233. package/src/router/search.ts +0 -66
  234. package/src/router/settings.ts +0 -120
  235. package/src/router/sidebar.ts +0 -55
  236. package/src/router/titles.test.ts +0 -24
  237. package/src/router/titles.ts +0 -33
  238. package/src/routes/core/_app/$.tsx +0 -13
  239. package/src/routes/core/_app/_content/d/$driveSlug/{-$nodeSlug}.tsx +0 -52
  240. package/src/routes/core/_app/_content/index.tsx +0 -3
  241. package/src/routes/core/_app/_content.tsx +0 -9
  242. package/src/routes/core/_app/settings/about.tsx +0 -20
  243. package/src/routes/core/_app/settings/ai-assistant.tsx +0 -20
  244. package/src/routes/core/_app/settings/danger-zone.tsx +0 -21
  245. package/src/routes/core/_app/settings/default-editors.tsx +0 -20
  246. package/src/routes/core/_app/settings/package-manager.tsx +0 -20
  247. package/src/routes/core/_app/settings.tsx +0 -35
  248. package/src/routes/core/_app.tsx +0 -10
@@ -1,66 +0,0 @@
1
- import {
2
- FEATURE_FLAG_PARAM_PREFIX,
3
- GLOBAL_SEARCH_PARAMS,
4
- } from "@powerhousedao/reactor-browser";
5
- import type { SearchMiddleware } from "@tanstack/react-router";
6
- import { retainSearchParams } from "@tanstack/react-router";
7
-
8
- // Shared with reactor-browser's fallback navigation.
9
- export { FEATURE_FLAG_PARAM_PREFIX, GLOBAL_SEARCH_PARAMS };
10
-
11
- /** Connect's query params: plain strings, as in the URL. */
12
- export type ConnectSearch = Record<string, string | undefined>;
13
-
14
- const retainFeatureFlags: SearchMiddleware<ConnectSearch> = ({
15
- search,
16
- next,
17
- }) => {
18
- const result = { ...next(search) };
19
- for (const [key, value] of Object.entries(search)) {
20
- if (key.startsWith(FEATURE_FLAG_PARAM_PREFIX) && !(key in result)) {
21
- result[key] = value;
22
- }
23
- }
24
- return result;
25
- };
26
-
27
- /** The root route's middlewares; they apply to every navigation and redirect. */
28
- export const connectSearchMiddlewares: SearchMiddleware<ConnectSearch>[] = [
29
- retainSearchParams<ConnectSearch>([...GLOBAL_SEARCH_PARAMS]),
30
- retainFeatureFlags,
31
- ];
32
-
33
- /** Lets every param through; routes add none of their own. */
34
- export function validateConnectSearch(
35
- search: Record<string, unknown>,
36
- ): ConnectSearch {
37
- return search as ConnectSearch;
38
- }
39
-
40
- /** Parses a query string into plain string values, unlike the JSON default. */
41
- export function parseConnectSearch(searchStr: string): ConnectSearch {
42
- return Object.fromEntries(new URLSearchParams(searchStr));
43
- }
44
-
45
- /** Writes plain `key=value` pairs, so other readers of the URL see strings. */
46
- export function stringifyConnectSearch(search: Record<string, unknown>) {
47
- const params = new URLSearchParams();
48
- for (const [key, value] of Object.entries(search)) {
49
- if (value === undefined || value === null) continue;
50
- params.set(key, typeof value === "string" ? value : JSON.stringify(value));
51
- }
52
- const searchStr = params.toString();
53
- return searchStr ? `?${searchStr}` : "";
54
- }
55
-
56
- /** The defined values of `search`, for callers that take plain records. */
57
- export function definedSearch(search: object): Record<string, string> {
58
- const record: Record<string, string> = {};
59
- for (const [key, value] of Object.entries(search)) {
60
- if (typeof value === "string") record[key] = value;
61
- else if (value !== undefined && value !== null) {
62
- record[key] = JSON.stringify(value);
63
- }
64
- }
65
- return record;
66
- }
@@ -1,120 +0,0 @@
1
- // The settings page: its tabs are the /settings route's children with `staticData.settings`.
2
- import {
3
- OPENED_FROM_STATE_KEY,
4
- SETTINGS_PATH,
5
- } from "@powerhousedao/reactor-browser";
6
- import type {
7
- AnyRoute,
8
- AnyRouter,
9
- HistoryState,
10
- MakeRouteMatchUnion,
11
- } from "@tanstack/react-router";
12
- import { useRouter } from "@tanstack/react-router";
13
- import type { ComponentType } from "react";
14
- import { useMemo } from "react";
15
- import type { ConnectRouterContext } from "./drive-route-loader.js";
16
- import { appTitle } from "./titles.js";
17
-
18
- /** A settings tab, as a child route of /settings declares it in `staticData`. */
19
- export type ConnectSettingsTab = {
20
- label: string;
21
- /** Ascending; Connect's own tabs use multiples of 10. */
22
- order: number;
23
- icon?: ComponentType<{ size?: number; className?: string }>;
24
- /** Marks the tab as destructive, e.g. the danger zone. */
25
- destructive?: boolean;
26
- /** Hidden, and redirected away from, when this returns false. */
27
- enabled?: (context: ConnectRouterContext) => boolean;
28
- };
29
-
30
- declare module "@tanstack/react-router" {
31
- interface StaticDataRouteOption {
32
- settings?: ConnectSettingsTab;
33
- }
34
- }
35
-
36
- /** The settings layout route's id. */
37
- export const SETTINGS_ROUTE_ID = `/_app${SETTINGS_PATH}`;
38
-
39
- /** A listed tab: its id is its path below /settings. */
40
- export type SettingsTabEntry = ConnectSettingsTab & {
41
- id: string;
42
- routeId: string;
43
- to: string;
44
- };
45
-
46
- /** The enabled tabs below `settingsRoute`, in order. */
47
- export function settingsTabsOf(
48
- settingsRoute: AnyRoute,
49
- context: ConnectRouterContext,
50
- ): SettingsTabEntry[] {
51
- const children = (settingsRoute.children ?? []) as AnyRoute[];
52
- const prefix = `${settingsRoute.fullPath}/`;
53
- return children
54
- .flatMap((route) => {
55
- const tab = (
56
- route.options as { staticData?: { settings?: ConnectSettingsTab } }
57
- ).staticData?.settings;
58
- if (!tab || tab.enabled?.(context) === false) return [];
59
- const { id: routeId, fullPath } = route as {
60
- id: string;
61
- fullPath: string;
62
- };
63
- const to = fullPath.replace(/\/$/, "");
64
- return [{ ...tab, id: to.slice(prefix.length), routeId, to }];
65
- })
66
- .sort((a, b) => a.order - b.order || a.label.localeCompare(b.label));
67
- }
68
-
69
- /** The settings tabs of `router`'s tree; empty without a settings route. */
70
- export function settingsTabs(router: AnyRouter): SettingsTabEntry[] {
71
- const settingsRoute = router.routesById[SETTINGS_ROUTE_ID] as
72
- | AnyRoute
73
- | undefined;
74
- if (!settingsRoute) return [];
75
- return settingsTabsOf(
76
- settingsRoute,
77
- router.options.context as ConnectRouterContext,
78
- );
79
- }
80
-
81
- export function useSettingsTabs() {
82
- const router = useRouter();
83
- return useMemo(() => settingsTabs(router), [router]);
84
- }
85
-
86
- /** Whether `matches` show a tab that may stay: not bare /settings, not a disabled tab. */
87
- export function showsSettingsTab(
88
- matches: readonly MakeRouteMatchUnion[],
89
- context: ConnectRouterContext,
90
- ) {
91
- const leaf = matches.at(-1);
92
- if (!leaf || leaf.routeId === SETTINGS_ROUTE_ID) return false;
93
- return leaf.staticData.settings?.enabled?.(context) !== false;
94
- }
95
-
96
- /** `Settings · <tab> · <app>`. */
97
- export function settingsTitle(tabLabel: string | undefined, appName?: string) {
98
- return ["Settings", tabLabel, appTitle(appName)].filter(Boolean).join(" · ");
99
- }
100
-
101
- /** Makes closing settings go home, not back to an entry that may be gone,
102
- * e.g. a deleted drive. */
103
- export function useForgetSettingsOpenedFrom() {
104
- const router = useRouter();
105
- return () =>
106
- router.navigate({
107
- to: ".",
108
- search: true,
109
- replace: true,
110
- resetScroll: false,
111
- state: (prev) =>
112
- ({ ...prev, [OPENED_FROM_STATE_KEY]: undefined }) as HistoryState,
113
- });
114
- }
115
-
116
- /** History state that keeps where the settings page was opened from. */
117
- export function keepOpenedFrom(state: object) {
118
- const from: unknown = Reflect.get(state, OPENED_FROM_STATE_KEY);
119
- return { [OPENED_FROM_STATE_KEY]: from } as unknown as HistoryState;
120
- }
@@ -1,55 +0,0 @@
1
- // What routes tell the sidebar layout: nav items and whether to show the sidebar.
2
- import type { AnyRoute, AnyRouter } from "@tanstack/react-router";
3
- import { useMatches, useRouter } from "@tanstack/react-router";
4
- import type { ComponentType } from "react";
5
- import { useMemo } from "react";
6
-
7
- /** A sidebar link to the route that declares it in `staticData.nav`. */
8
- export type ConnectNavItem = {
9
- label: string;
10
- icon?: ComponentType<{ size?: number; className?: string }>;
11
- /** Ascending, after the drives. */
12
- order: number;
13
- };
14
-
15
- /** "hidden" drops the sidebar; "collapsed" keeps only its header and footer. */
16
- export type SidebarMode = "hidden" | "collapsed";
17
-
18
- declare module "@tanstack/react-router" {
19
- interface StaticDataRouteOption {
20
- nav?: ConnectNavItem;
21
- sidebar?: SidebarMode;
22
- }
23
- }
24
-
25
- export type NavRouteEntry = ConnectNavItem & { routeId: string; to: string };
26
-
27
- /** The routes with `staticData.nav`, in order; routes with params can't be listed. */
28
- export function navRoutes(router: AnyRouter): NavRouteEntry[] {
29
- return Object.values(router.routesById as Record<string, AnyRoute>)
30
- .flatMap((route) => {
31
- const nav = (route.options as { staticData?: { nav?: ConnectNavItem } })
32
- .staticData?.nav;
33
- const { id: routeId, fullPath } = route as {
34
- id: string;
35
- fullPath: string;
36
- };
37
- if (!nav || fullPath.includes("$")) return [];
38
- return [{ ...nav, routeId, to: fullPath.replace(/(.)\/$/, "$1") }];
39
- })
40
- .sort((a, b) => a.order - b.order || a.label.localeCompare(b.label));
41
- }
42
-
43
- export function useNavRoutes() {
44
- const router = useRouter();
45
- return useMemo(() => navRoutes(router), [router]);
46
- }
47
-
48
- /** The deepest match's `staticData.sidebar`, if any declares one. */
49
- export function useSidebarMode(): SidebarMode | undefined {
50
- return useMatches({
51
- select: (matches) =>
52
- matches.findLast((match) => match.staticData.sidebar !== undefined)
53
- ?.staticData.sidebar,
54
- });
55
- }
@@ -1,24 +0,0 @@
1
- import type { PHStore } from "@powerhousedao/reactor-browser";
2
- import { driveCreateDocument } from "@powerhousedao/shared/document-drive";
3
- import { describe, expect, it } from "vitest";
4
- import { driveTitle } from "./titles.js";
5
-
6
- function storeWith(globalName: string, headerName: string) {
7
- const drive = driveCreateDocument({
8
- global: { name: globalName, icon: null, nodes: [] },
9
- });
10
- drive.header.name = headerName;
11
- return { store: { drives: [drive] } as PHStore, driveId: drive.header.id };
12
- }
13
-
14
- describe("driveTitle", () => {
15
- it("names a drive added from Connect, whose header has no name", () => {
16
- const { store, driveId } = storeWith("Local", "");
17
- expect(driveTitle(store, { driveId })).toBe("Local · Connect");
18
- });
19
-
20
- it("names a renamed drive by its header", () => {
21
- const { store, driveId } = storeWith("Old", "Renamed");
22
- expect(driveTitle(store, { driveId }, "App")).toBe("Renamed · App");
23
- });
24
- });
@@ -1,33 +0,0 @@
1
- // Document titles for Connect's routes; route heads set them through <HeadContent />.
2
- import type { PHStore } from "@powerhousedao/reactor-browser";
3
- import { getDriveName } from "@powerhousedao/reactor-browser";
4
- import type { DriveRouteData } from "./drive-route-loader.js";
5
-
6
- const DEFAULT_APP_NAME = "Connect";
7
-
8
- /** The configured app name, else "Connect". */
9
- export function appTitle(appName?: string) {
10
- return appName || DEFAULT_APP_NAME;
11
- }
12
-
13
- /** `Not found · <app>`. */
14
- export function notFoundTitle(appName?: string) {
15
- return `Not found · ${appTitle(appName)}`;
16
- }
17
-
18
- /** `<node> · <drive> · <app>`, from the store so renames show. */
19
- export function driveTitle(
20
- store: PHStore,
21
- data: DriveRouteData | undefined,
22
- appName?: string,
23
- ) {
24
- const drive = data && store.drives?.find((d) => d.header.id === data.driveId);
25
- if (!drive) return appTitle(appName);
26
- const node = data.nodeId
27
- ? drive.state.global.nodes.find((n) => n.id === data.nodeId)
28
- : undefined;
29
- return [node?.name, getDriveName(drive)]
30
- .filter(Boolean)
31
- .concat(appTitle(appName))
32
- .join(" · ");
33
- }
@@ -1,13 +0,0 @@
1
- import { createFileRoute } from "@tanstack/react-router";
2
- import { NotFoundView } from "../../../router/route-components.js";
3
- import { notFoundTitle } from "../../../router/titles.js";
4
-
5
- // Unknown paths, inside the layout so the sidebar stays; matched last.
6
- export const Route = createFileRoute("/_app/$")({
7
- // Core routes stay in the main chunk when a project build splits its routes.
8
- codeSplitGroupings: [],
9
- head: ({ match }) => ({
10
- meta: [{ title: notFoundTitle(match.context.appName) }],
11
- }),
12
- component: NotFoundView,
13
- });
@@ -1,52 +0,0 @@
1
- // Types by package name, so a project's declarations can name them.
2
- import type { DriveRouteData } from "@powerhousedao/connect/router";
3
- import { createFileRoute } from "@tanstack/react-router";
4
- import { loadDriveRoute } from "../../../../../../router/drive-route-loader.js";
5
- import {
6
- DRIVE_PENDING_MS,
7
- DrivePendingView,
8
- } from "../../../../../../router/route-components.js";
9
- import { driveTitle } from "../../../../../../router/titles.js";
10
-
11
- export const Route = createFileRoute(
12
- "/_app/_content/d/$driveSlug/{-$nodeSlug}",
13
- )({
14
- // Core routes stay in the main chunk when a project build splits its routes.
15
- codeSplitGroupings: [],
16
- loader: {
17
- handler: ({
18
- params,
19
- context,
20
- abortController,
21
- preload,
22
- }): Promise<DriveRouteData> =>
23
- loadDriveRoute({
24
- params,
25
- context,
26
- signal: abortController.signal,
27
- preload,
28
- }),
29
- // A reused match re-resolves before it shows; drives may have changed.
30
- staleReloadMode: "blocking",
31
- },
32
- // Only a path change re-resolves; search-only and same-URL navigations stay.
33
- shouldReload: ({ cause }) => cause !== "stay",
34
- preloadStaleTime: 0,
35
- pendingMs: DRIVE_PENDING_MS,
36
- // The pending view is empty on warm navigations; the router's 500 ms default
37
- // would hold their commit.
38
- pendingMinMs: 0,
39
- // Names from the store; bindConnectRouter re-runs this when they change.
40
- head: ({ match, loaderData }) => ({
41
- meta: [
42
- {
43
- title: driveTitle(
44
- match.context.store,
45
- loaderData,
46
- match.context.appName,
47
- ),
48
- },
49
- ],
50
- }),
51
- pendingComponent: DrivePendingView,
52
- });
@@ -1,3 +0,0 @@
1
- import { createFileRoute } from "@tanstack/react-router";
2
-
3
- export const Route = createFileRoute("/_app/_content/")({});
@@ -1,9 +0,0 @@
1
- import { createFileRoute } from "@tanstack/react-router";
2
- import { ContentView } from "../../../router/route-components.js";
3
-
4
- // Pathless, so the route id keeps the content mounted across child routes.
5
- export const Route = createFileRoute("/_app/_content")({
6
- // Core routes stay in the main chunk when a project build splits its routes.
7
- codeSplitGroupings: [],
8
- component: ContentView,
9
- });
@@ -1,20 +0,0 @@
1
- import { createFileRoute } from "@tanstack/react-router";
2
- import { CircleHelp } from "lucide-react";
3
- import {
4
- shellProvidesTab,
5
- shellSettingsTab,
6
- } from "../../../../router/route-components.js";
7
-
8
- export const Route = createFileRoute("/_app/settings/about")({
9
- // Core routes stay in the main chunk when a project build splits its routes.
10
- codeSplitGroupings: [],
11
- staticData: {
12
- settings: {
13
- label: "About",
14
- order: 90,
15
- icon: CircleHelp,
16
- enabled: shellProvidesTab("about"),
17
- },
18
- },
19
- component: shellSettingsTab("about"),
20
- });
@@ -1,20 +0,0 @@
1
- import { createFileRoute } from "@tanstack/react-router";
2
- import { Bot } from "lucide-react";
3
- import {
4
- shellProvidesTab,
5
- shellSettingsTab,
6
- } from "../../../../router/route-components.js";
7
-
8
- export const Route = createFileRoute("/_app/settings/ai-assistant")({
9
- // Core routes stay in the main chunk when a project build splits its routes.
10
- codeSplitGroupings: [],
11
- staticData: {
12
- settings: {
13
- label: "AI Assistant",
14
- order: 0,
15
- icon: Bot,
16
- enabled: shellProvidesTab("ai-assistant"),
17
- },
18
- },
19
- component: shellSettingsTab("ai-assistant"),
20
- });
@@ -1,21 +0,0 @@
1
- import { createFileRoute } from "@tanstack/react-router";
2
- import { TriangleAlert } from "lucide-react";
3
- import {
4
- shellProvidesTab,
5
- shellSettingsTab,
6
- } from "../../../../router/route-components.js";
7
-
8
- export const Route = createFileRoute("/_app/settings/danger-zone")({
9
- // Core routes stay in the main chunk when a project build splits its routes.
10
- codeSplitGroupings: [],
11
- staticData: {
12
- settings: {
13
- label: "Danger Zone",
14
- order: 80,
15
- icon: TriangleAlert,
16
- destructive: true,
17
- enabled: shellProvidesTab("danger-zone"),
18
- },
19
- },
20
- component: shellSettingsTab("danger-zone"),
21
- });
@@ -1,20 +0,0 @@
1
- import { createFileRoute } from "@tanstack/react-router";
2
- import { PenLine } from "lucide-react";
3
- import {
4
- shellProvidesTab,
5
- shellSettingsTab,
6
- } from "../../../../router/route-components.js";
7
-
8
- export const Route = createFileRoute("/_app/settings/default-editors")({
9
- // Core routes stay in the main chunk when a project build splits its routes.
10
- codeSplitGroupings: [],
11
- staticData: {
12
- settings: {
13
- label: "Default Editors",
14
- order: 20,
15
- icon: PenLine,
16
- enabled: shellProvidesTab("default-editors"),
17
- },
18
- },
19
- component: shellSettingsTab("default-editors"),
20
- });
@@ -1,20 +0,0 @@
1
- import { createFileRoute } from "@tanstack/react-router";
2
- import { Package } from "lucide-react";
3
- import {
4
- shellProvidesTab,
5
- shellSettingsTab,
6
- } from "../../../../router/route-components.js";
7
-
8
- export const Route = createFileRoute("/_app/settings/package-manager")({
9
- // Core routes stay in the main chunk when a project build splits its routes.
10
- codeSplitGroupings: [],
11
- staticData: {
12
- settings: {
13
- label: "Package Manager",
14
- order: 10,
15
- icon: Package,
16
- enabled: shellProvidesTab("package-manager"),
17
- },
18
- },
19
- component: shellSettingsTab("package-manager"),
20
- });
@@ -1,35 +0,0 @@
1
- import type { AnyRouter } from "@tanstack/react-router";
2
- import { createFileRoute, notFound, redirect } from "@tanstack/react-router";
3
- import { SettingsView } from "../../../router/route-components.js";
4
- import {
5
- settingsTabsOf,
6
- settingsTitle,
7
- showsSettingsTab,
8
- } from "../../../router/settings.js";
9
-
10
- // Beside the content layout: the root keeps the sidebar, the content view goes.
11
- export const Route = createFileRoute("/_app/settings")({
12
- // Core routes stay in the main chunk when a project build splits its routes.
13
- codeSplitGroupings: [],
14
- // Bare /settings and a disabled tab go to the first tab.
15
- beforeLoad: ({ matches, context }) => {
16
- if (showsSettingsTab(matches, context)) return;
17
- const first = settingsTabsOf(Route, context).at(0);
18
- // oxlint-disable-next-line typescript/only-throw-error -- router control flow
19
- if (!first) throw notFound();
20
- // oxlint-disable-next-line typescript/only-throw-error -- router control flow
21
- throw redirect<AnyRouter>({ to: first.to, replace: true, state: true });
22
- },
23
- // The shown tab's label; a tab needs no head of its own.
24
- head: ({ matches, match }) => ({
25
- meta: [
26
- {
27
- title: settingsTitle(
28
- matches.at(-1)?.staticData.settings?.label,
29
- match.context.appName,
30
- ),
31
- },
32
- ],
33
- }),
34
- component: SettingsView,
35
- });
@@ -1,10 +0,0 @@
1
- import { createFileRoute } from "@tanstack/react-router";
2
- import { AppLayoutView } from "../../router/route-components.js";
3
-
4
- // Pathless: the sidebar layout around home, drives, settings and a project's _app/ routes.
5
- // A project's hosts/connect/routes/_app.tsx replaces this file.
6
- export const Route = createFileRoute("/_app")({
7
- // Core routes stay in the main chunk when a project build splits its routes.
8
- codeSplitGroupings: [],
9
- component: AppLayoutView,
10
- });