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

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-Dm8fXUtB.js} +6 -6
  7. package/dist/ClearStorageModal-Dm8fXUtB.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-D2n1zf1j.js} +8 -8
  15. package/dist/DebugSettingsModal-D2n1zf1j.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-Zuv-MhXn.js} +16 -16
  31. package/dist/InspectorModal-Zuv-MhXn.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-DDh_8DF4.js +4 -0
  39. package/dist/{app-loader-DrViXipO.js → app-loader-Jc7RPPdf.js} +149 -196
  40. package/dist/app-loader-Jc7RPPdf.js.map +1 -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-CvNYaPVX.js} +6 -6
  45. package/dist/boot-CvNYaPVX.js.map +1 -0
  46. package/dist/{build-info-DMrToXJe.js → build-info-D1EoCSh4.js} +5 -5
  47. package/dist/{build-info-DMrToXJe.js.map → build-info-D1EoCSh4.js.map} +1 -1
  48. package/dist/{components-CjF9XjxP.js → components-B1iKyGVL.js} +11 -10
  49. package/dist/{components-CjF9XjxP.js.map → components-B1iKyGVL.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-runtime-config-DBnKV0Lk.js +14 -0
  72. package/dist/load-runtime-config-DBnKV0Lk.js.map +1 -0
  73. package/dist/{load--K_UgzUy.js → load-v3HkhMUC.js} +11 -11
  74. package/dist/{load--K_UgzUy.js.map → load-v3HkhMUC.js.map} +1 -1
  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--nrQ3PK_.js} +75 -83
  83. package/dist/plugins--nrQ3PK_.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-CiqT6V1j.js} +25 -156
  93. package/dist/reactor-CiqT6V1j.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-gMoXPPnn.js} +488 -22
  118. package/dist/settings-gMoXPPnn.js.map +1 -0
  119. package/dist/settings-tabs-DBwSlWx8.js +365 -0
  120. package/dist/settings-tabs-DBwSlWx8.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-g3mVHWI7.js +66 -0
  132. package/dist/ui-g3mVHWI7.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
@@ -0,0 +1,66 @@
1
+
2
+ !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5a65f7fe-4226-526c-b2eb-f3097c7324fa")}catch(e){}}();
3
+ import { c as NodeView, d as AppLayout, l as DrivePending, n as settingsTabRoutes, o as DriveLayout, r as SettingsPage, s as Home, u as RouteError } from "./settings-tabs-DBwSlWx8.js";
4
+ import { lazy } from "react";
5
+ import { jsx } from "react/jsx-runtime";
6
+ //#region src/generic/modals.ts
7
+ const AddDriveModal = lazy(() => import("./AddDriveModal-BjgmiHJr.js").then((m) => ({ default: m.AddDriveModal })));
8
+ const ClearStorageModal = lazy(() => import("./ClearStorageModal-Dm8fXUtB.js").then((m) => ({ default: m.ClearStorageModal })));
9
+ const CreateDocumentModal = lazy(() => import("./CreateDocumentModal-B-cXzeOA.js").then((m) => ({ default: m.CreateDocumentModal })));
10
+ const DebugSettingsModal = lazy(() => import("./DebugSettingsModal-D2n1zf1j.js").then((m) => ({ default: m.DebugSettingsModal })));
11
+ const DeleteDriveModal = lazy(() => import("./DeleteDriveModal-1pAIayG_.js").then((m) => ({ default: m.DeleteDriveModal })));
12
+ const DeleteItemModal = lazy(() => import("./DeleteItemModal-BUpqmFxS.js").then((m) => ({ default: m.DeleteItemModal })));
13
+ const DisclaimerModal = lazy(() => import("./DisclaimerModal-TIJXRYLF.js").then((m) => ({ default: m.DisclaimerModal })));
14
+ const DriveSettingsModal = lazy(() => import("./DriveSettingsModal-DZKawN7w.js").then((m) => ({ default: m.DriveSettingsModal })));
15
+ const DownloadDocumentWithErrorsModal = lazy(() => import("./DownloadDocumentWithErrorsModal-Beh-xw8B.js").then((m) => ({ default: m.DownloadDocumentWithErrorsModal })));
16
+ const DocumentVersionUnsupportedModal = lazy(() => import("./DocumentVersionUnsupportedModal-DH9Zzsyw.js").then((m) => ({ default: m.DocumentVersionUnsupportedModal })));
17
+ const ConfirmDocumentUpgradeModal = lazy(() => import("./ConfirmDocumentUpgradeModal-CoixS60F.js").then((m) => ({ default: m.ConfirmDocumentUpgradeModal })));
18
+ const UpgradeDriveModal = lazy(() => import("./UpgradeDriveModal-CCWKp5yn.js").then((m) => ({ default: m.UpgradeDriveModal })));
19
+ /** The generic plugin's modals: its chrome's, and core's in its style.
20
+ * "settings" is a page; showPHModal navigates to it. */
21
+ const genericModals = {
22
+ addDrive: AddDriveModal,
23
+ clearStorage: ClearStorageModal,
24
+ createDocument: CreateDocumentModal,
25
+ debugSettings: DebugSettingsModal,
26
+ deleteDrive: DeleteDriveModal,
27
+ deleteItem: DeleteItemModal,
28
+ disclaimer: DisclaimerModal,
29
+ driveSettings: DriveSettingsModal,
30
+ downloadDocumentWithErrors: DownloadDocumentWithErrorsModal,
31
+ documentVersionUnsupported: DocumentVersionUnsupportedModal,
32
+ confirmDocumentUpgrade: ConfirmDocumentUpgradeModal,
33
+ inspector: lazy(() => import("./InspectorModal-Zuv-MhXn.js").then((m) => ({ default: m.InspectorModal }))),
34
+ upgradeDrive: UpgradeDriveModal,
35
+ driveAuthRequired: lazy(() => import("./DriveAuthRequiredModal-XTcoJKvj.js").then((m) => ({ default: m.DriveAuthRequiredModal }))),
36
+ login: lazy(() => import("./LoginModal-O06ZvWFI.js").then((m) => ({ default: m.LoginModal })))
37
+ };
38
+ //#endregion
39
+ //#region src/generic/ui.tsx
40
+ const GenericLayout = () => /* @__PURE__ */ jsx(AppLayout, {});
41
+ const genericUi = {
42
+ routes: {
43
+ "/_app": { component: GenericLayout },
44
+ "/_app/": { component: Home },
45
+ "/_app/d/$driveSlug": {
46
+ component: DriveLayout,
47
+ pendingComponent: DrivePending
48
+ },
49
+ "/_app/d/$driveSlug/{-$nodeSlug}": {
50
+ component: NodeView,
51
+ pendingComponent: DrivePending
52
+ },
53
+ "/_app/settings": { component: SettingsPage },
54
+ "/_app/settings/appearance": { staticData: { settings: void 0 } },
55
+ "/_app/settings/packages": { staticData: { settings: void 0 } }
56
+ },
57
+ addRoutes: settingsTabRoutes,
58
+ modals: genericModals,
59
+ errorComponent: RouteError,
60
+ commonEditors: true
61
+ };
62
+ //#endregion
63
+ export { genericUi as default };
64
+
65
+ //# sourceMappingURL=ui-g3mVHWI7.js.map
66
+ //# debugId=5a65f7fe-4226-526c-b2eb-f3097c7324fa
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ui-g3mVHWI7.js","sources":["../src/generic/modals.ts","../src/generic/ui.tsx"],"sourcesContent":["import type { ConnectModals } from \"@powerhousedao/connect-core/router\";\nimport { lazy } from \"react\";\n\nconst AddDriveModal = lazy(() =>\n import(\"./modals/AddDriveModal.js\").then((m) => ({\n default: m.AddDriveModal,\n })),\n);\nconst ClearStorageModal = lazy(() =>\n import(\"./modals/ClearStorageModal.js\").then((m) => ({\n default: m.ClearStorageModal,\n })),\n);\nconst CreateDocumentModal = lazy(() =>\n import(\"./modals/CreateDocumentModal.js\").then((m) => ({\n default: m.CreateDocumentModal,\n })),\n);\nconst DebugSettingsModal = lazy(() =>\n import(\"./modals/DebugSettingsModal.js\").then((m) => ({\n default: m.DebugSettingsModal,\n })),\n);\nconst DeleteDriveModal = lazy(() =>\n import(\"./modals/DeleteDriveModal.js\").then((m) => ({\n default: m.DeleteDriveModal,\n })),\n);\nconst DeleteItemModal = lazy(() =>\n import(\"./modals/DeleteItemModal.js\").then((m) => ({\n default: m.DeleteItemModal,\n })),\n);\nconst DisclaimerModal = lazy(() =>\n import(\"./modals/DisclaimerModal.js\").then((m) => ({\n default: m.DisclaimerModal,\n })),\n);\nconst DriveSettingsModal = lazy(() =>\n import(\"./modals/DriveSettingsModal.js\").then((m) => ({\n default: m.DriveSettingsModal,\n })),\n);\nconst DownloadDocumentWithErrorsModal = lazy(() =>\n import(\"./modals/DownloadDocumentWithErrorsModal.js\").then((m) => ({\n default: m.DownloadDocumentWithErrorsModal,\n })),\n);\nconst DocumentVersionUnsupportedModal = lazy(() =>\n import(\"./modals/DocumentVersionUnsupportedModal.js\").then((m) => ({\n default: m.DocumentVersionUnsupportedModal,\n })),\n);\nconst ConfirmDocumentUpgradeModal = lazy(() =>\n import(\"./modals/ConfirmDocumentUpgradeModal.js\").then((m) => ({\n default: m.ConfirmDocumentUpgradeModal,\n })),\n);\nconst UpgradeDriveModal = lazy(() =>\n import(\"./modals/UpgradeDriveModal.js\").then((m) => ({\n default: m.UpgradeDriveModal,\n })),\n);\nconst InspectorModal = lazy(() =>\n import(\"./modals/InspectorModal/index.js\").then((m) => ({\n default: m.InspectorModal,\n })),\n);\nconst DriveAuthRequiredModal = lazy(() =>\n import(\"./modals/DriveAuthRequiredModal.js\").then((m) => ({\n default: m.DriveAuthRequiredModal,\n })),\n);\nconst LoginModal = lazy(() =>\n import(\"./modals/LoginModal.js\").then((m) => ({\n default: m.LoginModal,\n })),\n);\n\n/** The generic plugin's modals: its chrome's, and core's in its style.\n * \"settings\" is a page; showPHModal navigates to it. */\nexport const genericModals: ConnectModals = {\n addDrive: AddDriveModal,\n clearStorage: ClearStorageModal,\n createDocument: CreateDocumentModal,\n debugSettings: DebugSettingsModal,\n deleteDrive: DeleteDriveModal,\n deleteItem: DeleteItemModal,\n disclaimer: DisclaimerModal,\n driveSettings: DriveSettingsModal,\n downloadDocumentWithErrors: DownloadDocumentWithErrorsModal,\n documentVersionUnsupported: DocumentVersionUnsupportedModal,\n confirmDocumentUpgrade: ConfirmDocumentUpgradeModal,\n inspector: InspectorModal,\n upgradeDrive: UpgradeDriveModal,\n driveAuthRequired: DriveAuthRequiredModal,\n login: LoginModal,\n};\n","// The generic plugin's UI: Connect's sidebar, drives, editors, settings and\n// modals over core's routes. Loaded only while the plugin is active.\nimport type { ConnectPluginUi } from \"@powerhousedao/connect-core/plugins\";\nimport { AppLayout } from \"./layout/app-layout.js\";\nimport { DrivePending, RouteError } from \"./layout/route-views.js\";\nimport { genericModals } from \"./modals.js\";\nimport { DriveLayout, Home, NodeView } from \"./pages/content.js\";\nimport { SettingsPage } from \"./settings/tabs.js\";\nimport { settingsTabRoutes } from \"./settings-tabs.js\";\n\nconst GenericLayout = () => <AppLayout />;\n\nconst genericUi: ConnectPluginUi = {\n routes: {\n \"/_app\": { component: GenericLayout },\n \"/_app/\": { component: Home },\n \"/_app/d/$driveSlug\": {\n component: DriveLayout,\n pendingComponent: DrivePending,\n },\n \"/_app/d/$driveSlug/{-$nodeSlug}\": {\n component: NodeView,\n pendingComponent: DrivePending,\n },\n \"/_app/settings\": { component: SettingsPage },\n // Core's tabs; the package manager and the theme toggle replace them.\n \"/_app/settings/appearance\": { staticData: { settings: undefined } },\n \"/_app/settings/packages\": { staticData: { settings: undefined } },\n },\n addRoutes: settingsTabRoutes,\n modals: genericModals,\n errorComponent: RouteError,\n commonEditors: true,\n};\n\nexport default genericUi;\n"],"names":[],"mappings":";;;;;;AAGA,MAAM,gBAAgB,WACpB,OAAO,8BAA4B,CAAC,MAAM,OAAO,EAC/C,SAAS,EAAE,cACb,EAAE,CACJ;AACA,MAAM,oBAAoB,WACxB,OAAO,kCAAgC,CAAC,MAAM,OAAO,EACnD,SAAS,EAAE,kBACb,EAAE,CACJ;AACA,MAAM,sBAAsB,WAC1B,OAAO,oCAAkC,CAAC,MAAM,OAAO,EACrD,SAAS,EAAE,oBACb,EAAE,CACJ;AACA,MAAM,qBAAqB,WACzB,OAAO,mCAAiC,CAAC,MAAM,OAAO,EACpD,SAAS,EAAE,mBACb,EAAE,CACJ;AACA,MAAM,mBAAmB,WACvB,OAAO,iCAA+B,CAAC,MAAM,OAAO,EAClD,SAAS,EAAE,iBACb,EAAE,CACJ;AACA,MAAM,kBAAkB,WACtB,OAAO,gCAA8B,CAAC,MAAM,OAAO,EACjD,SAAS,EAAE,gBACb,EAAE,CACJ;AACA,MAAM,kBAAkB,WACtB,OAAO,gCAA8B,CAAC,MAAM,OAAO,EACjD,SAAS,EAAE,gBACb,EAAE,CACJ;AACA,MAAM,qBAAqB,WACzB,OAAO,mCAAiC,CAAC,MAAM,OAAO,EACpD,SAAS,EAAE,mBACb,EAAE,CACJ;AACA,MAAM,kCAAkC,WACtC,OAAO,gDAA8C,CAAC,MAAM,OAAO,EACjE,SAAS,EAAE,gCACb,EAAE,CACJ;AACA,MAAM,kCAAkC,WACtC,OAAO,gDAA8C,CAAC,MAAM,OAAO,EACjE,SAAS,EAAE,gCACb,EAAE,CACJ;AACA,MAAM,8BAA8B,WAClC,OAAO,4CAA0C,CAAC,MAAM,OAAO,EAC7D,SAAS,EAAE,4BACb,EAAE,CACJ;AACA,MAAM,oBAAoB,WACxB,OAAO,kCAAgC,CAAC,MAAM,OAAO,EACnD,SAAS,EAAE,kBACb,EAAE,CACJ;;;AAmBA,MAAa,gBAA+B;CAC1C,UAAU;CACV,cAAc;CACd,gBAAgB;CAChB,eAAe;CACf,aAAa;CACb,YAAY;CACZ,YAAY;CACZ,eAAe;CACf,4BAA4B;CAC5B,4BAA4B;CAC5B,wBAAwB;CACxB,WA9BqB,WACrB,OAAO,+BAAmC,CAAC,MAAM,OAAO,EACtD,SAAS,EAAE,eACb,EAAE,CA2BS;CACX,cAAc;CACd,mBA3B6B,WAC7B,OAAO,uCAAqC,CAAC,MAAM,OAAO,EACxD,SAAS,EAAE,uBACb,EAAE,CAwBiB;CACnB,OAvBiB,WACjB,OAAO,2BAAyB,CAAC,MAAM,OAAO,EAC5C,SAAS,EAAE,WACb,EAAE,CAoBK;AACT;;;ACvFA,MAAM,sBAAsB,oBAAC,WAAD,CAAY,CAAA;AAExC,MAAM,YAA6B;CACjC,QAAQ;EACN,SAAS,EAAE,WAAW,cAAc;EACpC,UAAU,EAAE,WAAW,KAAK;EAC5B,sBAAsB;GACpB,WAAW;GACX,kBAAkB;EACpB;EACA,mCAAmC;GACjC,WAAW;GACX,kBAAkB;EACpB;EACA,kBAAkB,EAAE,WAAW,aAAa;EAE5C,6BAA6B,EAAE,YAAY,EAAE,UAAU,KAAA,EAAU,EAAE;EACnE,2BAA2B,EAAE,YAAY,EAAE,UAAU,KAAA,EAAU,EAAE;CACnE;CACA,WAAW;CACX,QAAQ;CACR,gBAAgB;CAChB,eAAe;AACjB","debug_id":"5a65f7fe-4226-526c-b2eb-f3097c7324fa"}
@@ -1,8 +1,8 @@
1
1
 
2
- !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7371b189-110f-51b5-a76f-e2857d4c8cbb")}catch(e){}}();
2
+ !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="dca8d750-45bc-516e-8563-ffddcc16d7e6")}catch(e){}}();
3
3
  import { useCallback, useMemo } from "react";
4
4
  import { openRenown, showPHModal, useRenownAuth, useRenownLoginMethods } from "@powerhousedao/reactor-browser";
5
- //#region src/hooks/use-renown-login.ts
5
+ //#region src/generic/hooks/use-renown-login.ts
6
6
  function useOpenRenownLogin() {
7
7
  const methods = useRenownLoginMethods();
8
8
  return useCallback(() => {
@@ -48,5 +48,5 @@ function useRenownLoginProps() {
48
48
  //#endregion
49
49
  export { useRenownLoginProps as n, useOpenRenownLogin as t };
50
50
 
51
- //# sourceMappingURL=use-renown-login-BzOSQETV.js.map
52
- //# debugId=7371b189-110f-51b5-a76f-e2857d4c8cbb
51
+ //# sourceMappingURL=use-renown-login-dPpDOYq5.js.map
52
+ //# debugId=dca8d750-45bc-516e-8563-ffddcc16d7e6
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-renown-login-dPpDOYq5.js","sources":["../src/generic/hooks/use-renown-login.ts"],"sourcesContent":["import type { RenownLoginOption } from \"@powerhousedao/design-system/connect\";\nimport {\n openRenown,\n showPHModal,\n useRenownAuth,\n useRenownLoginMethods,\n} from \"@powerhousedao/reactor-browser\";\nimport { useCallback, useMemo } from \"react\";\n\n// Opens the in-page login modal when wallet adapters are configured; otherwise\n// redirects straight to the Renown portal (no modal with only a redirect button).\nexport function useOpenRenownLogin(): () => void {\n const methods = useRenownLoginMethods();\n return useCallback(() => {\n if (methods.length > 0) {\n showPHModal({ type: \"login\" });\n } else {\n openRenown();\n }\n }, [methods]);\n}\n\nexport interface RenownLoginProps {\n onLogin: () => void;\n // One option per configured login method (wallet, Google, email, …). Empty\n // only when no adapters are configured (the redirect Connect button is used).\n methods: RenownLoginOption[];\n loading: boolean;\n error: string | null;\n}\n\nconst LAST_METHOD_KEY = \"renown:last-login-method\";\n\nfunction getLastLoginMethod(): string | null {\n try {\n return localStorage.getItem(LAST_METHOD_KEY);\n } catch {\n return null;\n }\n}\n\nfunction setLastLoginMethod(method: string): void {\n try {\n localStorage.setItem(LAST_METHOD_KEY, method);\n } catch {\n // localStorage unavailable (private mode / SSR) — the badge is optional.\n }\n}\n\n// Single source of the login wiring shared by every Connect CTA: in-page\n// sign-in (with redirect fallback) plus pending/error feedback.\nexport function useRenownLoginProps(): RenownLoginProps {\n const { login, pending, error } = useRenownAuth();\n const onLogin = useCallback(() => login(), [login]);\n\n // Method list (labels) comes from the shared primitive; Connect adds the\n // last-used badge + the onSelect wiring for its design-system card.\n const baseMethods = useRenownLoginMethods();\n\n const methods = useMemo<RenownLoginOption[]>(() => {\n const lastUsed = getLastLoginMethod();\n return baseMethods.map((method) => ({\n id: method.id,\n label: method.label,\n lastUsed: lastUsed === method.id,\n onSelect: () => {\n setLastLoginMethod(method.id);\n login(undefined, method.id);\n },\n }));\n }, [baseMethods, login]);\n\n return { onLogin, methods, loading: pending, error: error?.message ?? null };\n}\n"],"names":[],"mappings":";;;;;AAWA,SAAgB,qBAAiC;CAC/C,MAAM,UAAU,sBAAsB;CACtC,OAAO,kBAAkB;EACvB,IAAI,QAAQ,SAAS,GACnB,YAAY,EAAE,MAAM,QAAQ,CAAC;OAE7B,WAAW;CAEf,GAAG,CAAC,OAAO,CAAC;AACd;AAWA,MAAM,kBAAkB;AAExB,SAAS,qBAAoC;CAC3C,IAAI;EACF,OAAO,aAAa,QAAQ,eAAe;CAC7C,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,mBAAmB,QAAsB;CAChD,IAAI;EACF,aAAa,QAAQ,iBAAiB,MAAM;CAC9C,QAAQ,CAER;AACF;AAIA,SAAgB,sBAAwC;CACtD,MAAM,EAAE,OAAO,SAAS,UAAU,cAAc;CAChD,MAAM,UAAU,kBAAkB,MAAM,GAAG,CAAC,KAAK,CAAC;CAIlD,MAAM,cAAc,sBAAsB;CAe1C,OAAO;EAAE;EAAS,SAbF,cAAmC;GACjD,MAAM,WAAW,mBAAmB;GACpC,OAAO,YAAY,KAAK,YAAY;IAClC,IAAI,OAAO;IACX,OAAO,OAAO;IACd,UAAU,aAAa,OAAO;IAC9B,gBAAgB;KACd,mBAAmB,OAAO,EAAE;KAC5B,MAAM,KAAA,GAAW,OAAO,EAAE;IAC5B;GACF,EAAE;EACJ,GAAG,CAAC,aAAa,KAAK,CAEE;EAAG,SAAS;EAAS,OAAO,OAAO,WAAW;CAAK;AAC7E","debug_id":"dca8d750-45bc-516e-8563-ffddcc16d7e6"}
@@ -0,0 +1,177 @@
1
+ # Data and navigation
2
+
3
+ How a route loads data, reads the open drive and document, types its search params, and how editors and packages navigate without knowing the routes.
4
+
5
+ ## Load data
6
+
7
+ A route's `loader` runs before the route renders, and on every navigation to it. Its `context` is Connect's router context (`ConnectRouterContext`):
8
+
9
+ | Field | What it is |
10
+ | --- | --- |
11
+ | `store` | The app's PH store: `drives`, `reactorClient`, `documentCache`, and the rest of `PHGlobal`. |
12
+ | `arrivals` | Whether drives are still arriving, e.g. right after boot. |
13
+ | `appName` | `connect.branding.appName`, if set. |
14
+ | `components` | What Connect's own routes render. A project route does not need it. |
15
+
16
+ This loader reads a document through the reactor client:
17
+
18
+ ```tsx
19
+ // hosts/connect/routes/_app/documents/$documentId.tsx
20
+ import { createFileRoute, notFound } from "@tanstack/react-router";
21
+
22
+ export const Route = createFileRoute("/_app/documents/$documentId")({
23
+ loader: async ({ context, params, abortController }) => {
24
+ const client = context.store.reactorClient;
25
+ if (!client) throw new Error("The reactor is not ready");
26
+ try {
27
+ const document = await client.get(
28
+ params.documentId,
29
+ undefined,
30
+ abortController.signal,
31
+ );
32
+ return { name: document.header.name, type: document.header.documentType };
33
+ } catch {
34
+ throw notFound();
35
+ }
36
+ },
37
+ component: DocumentSummary,
38
+ });
39
+
40
+ function DocumentSummary() {
41
+ const { name, type } = Route.useLoaderData();
42
+ return <p className="p-6">{name} is a {type}</p>;
43
+ }
44
+ ```
45
+
46
+ - Connect starts the reactor before it renders the router, so `reactorClient` is set in Connect. The check satisfies the type.
47
+ - Loader data is a snapshot. It does not update when the document changes. For live data, read it in the component with the `@powerhousedao/reactor-browser` hooks (`useDrives`, `useDocument`, `useDocumentById`).
48
+ - `store.drives` holds the drives that have arrived. On a deep link to a remote drive, it can be incomplete while `arrivals.isPending()` is true.
49
+
50
+ ### The open drive and document
51
+
52
+ A view reads the drive route's drive, folder and document with `useDriveRouteData()` from `@powerhousedao/connect/layout`:
53
+
54
+ ```tsx
55
+ const { drive, folder, documentId } = useDriveRouteData();
56
+ ```
57
+
58
+ - `useDriveRouteIds()` gives the ids alone, from the matched route's loader.
59
+ - Drive apps and editors keep using `useSelectedDrive`, `useSelectedNode` and the generated `useSelected<Model>Document()`. The drive layout renders them inside `RouteSelection`, so those hooks read the route they are shown in, not the app-wide selection.
60
+ - `OpenDocument` (from `@powerhousedao/connect/generic`), for a project's drive route override, scopes its editor the same way. A project route that renders a drive app or an editor itself wraps it in `RouteSelection` (from `@powerhousedao/connect/layout`).
61
+ - Connect still writes the route's ids to the app-wide selection (`store.selectedDriveId`, `store.selectedNodeId`) for code outside a route, such as a sidebar widget.
62
+
63
+ ## Read and write search params
64
+
65
+ Connect parses every query param as a string. A route types its own params with `validateSearch`, and reruns its loader on them with `loaderDeps`:
66
+
67
+ ```tsx
68
+ // hosts/connect/routes/_app/inventory.tsx
69
+ import { createFileRoute, Link, useNavigate } from "@tanstack/react-router";
70
+
71
+ type Sort = "name" | "size";
72
+
73
+ export const Route = createFileRoute("/_app/inventory")({
74
+ validateSearch: (search: Record<string, unknown>): { sort: Sort; q?: string } => ({
75
+ sort: search.sort === "size" ? "size" : "name",
76
+ q: typeof search.q === "string" ? search.q : undefined,
77
+ }),
78
+ loaderDeps: ({ search }) => ({ sort: search.sort }),
79
+ loader: ({ context, deps }) => {
80
+ const drives = (context.store.drives ?? []).map((drive) => ({
81
+ slug: drive.header.slug,
82
+ name: drive.header.name,
83
+ size: drive.state.global.nodes.length,
84
+ }));
85
+ drives.sort((a, b) =>
86
+ deps.sort === "size" ? b.size - a.size : a.name.localeCompare(b.name),
87
+ );
88
+ return { drives };
89
+ },
90
+ component: Inventory,
91
+ });
92
+
93
+ function Inventory() {
94
+ const { drives } = Route.useLoaderData();
95
+ const { sort, q } = Route.useSearch();
96
+ const navigate = useNavigate({ from: Route.fullPath });
97
+ const shown = drives.filter((d) => !q || d.name.includes(q));
98
+ return (
99
+ <div className="flex flex-col gap-2 p-6">
100
+ <input
101
+ value={q ?? ""}
102
+ onChange={(e) =>
103
+ void navigate({
104
+ search: (prev) => ({ ...prev, q: e.target.value || undefined }),
105
+ replace: true,
106
+ })
107
+ }
108
+ />
109
+ <Link to="/inventory" search={{ sort: sort === "name" ? "size" : "name" }}>
110
+ Sort by {sort === "name" ? "size" : "name"}
111
+ </Link>
112
+ <ul>
113
+ {shown.map((drive) => (
114
+ <li key={drive.slug}>
115
+ <Link to="/d/$driveSlug/{-$nodeSlug}" params={{ driveSlug: drive.slug }}>
116
+ {drive.name} ({drive.size})
117
+ </Link>
118
+ </li>
119
+ ))}
120
+ </ul>
121
+ </div>
122
+ );
123
+ }
124
+ ```
125
+
126
+ - `Route.useSearch()` also returns every other param in the URL, typed `string | undefined`.
127
+ - A route's own params are dropped when the user navigates to another route.
128
+ - Global params survive every navigation: `driveUrl`, `theme`, `embed`, `LOG_LEVEL`, `reactorWorker`, and any `FEATURE_*` flag. The list is `GLOBAL_SEARCH_PARAMS` in `@powerhousedao/reactor-browser`; Connect's root route keeps them (`src/router/search.ts` in `@powerhousedao/connect-core`).
129
+ - Non-string values are written with `JSON.stringify`, so `2` becomes `?page=2` and reads back as `"2"`.
130
+
131
+ ## Navigate from an editor
132
+
133
+ Editors and packages do not know the project's routes, and may run outside Connect. `@powerhousedao/reactor-browser` navigates by target instead of path, through the host's navigation (Connect's router in Connect; `window.history` elsewhere):
134
+
135
+ - `{ driveSlug, nodeSlug? }` (`PHDriveTarget`): a drive, or a node in it.
136
+ - `{ settings: "<tab>" }` or `{ settings: true }` (`PHSettingsTarget`): a settings tab, or the first tab.
137
+ - `undefined`: home.
138
+
139
+ ```tsx
140
+ import {
141
+ openTarget,
142
+ useLinkProps,
143
+ useSearchParams,
144
+ useSetSearchParams,
145
+ } from "@powerhousedao/reactor-browser";
146
+
147
+ // An <a> that navigates in the app and opens new tabs normally.
148
+ export function OpenInvoice(props: { driveSlug: string; nodeSlug: string }) {
149
+ const link = useLinkProps({ driveSlug: props.driveSlug, nodeSlug: props.nodeSlug });
150
+ return <a {...link}>Open invoice</a>;
151
+ }
152
+
153
+ export function SettingsButton() {
154
+ return (
155
+ <button onClick={() => openTarget({ settings: "inventory" })}>
156
+ Inventory settings
157
+ </button>
158
+ );
159
+ }
160
+
161
+ // Query params of the current page; an object merges, `undefined` removes a key.
162
+ export function TabSwitch() {
163
+ const { tab = "summary" } = useSearchParams();
164
+ const setSearchParams = useSetSearchParams();
165
+ return (
166
+ <button onClick={() => setSearchParams({ tab: tab === "summary" ? "history" : "summary" })}>
167
+ Showing {tab}
168
+ </button>
169
+ );
170
+ }
171
+ ```
172
+
173
+ - `useLinkProps(target)` returns `href`, `onClick`, `aria-current` and preload handlers for an `<a>`.
174
+ - `openTarget(target)` and `store.navigation.open(target)` navigate from code.
175
+ - `showPHModal({ type: "settings" })` is deprecated. In Connect it opens `/settings`.
176
+ - A project route can use the same API, but the router's `Link` and `useNavigate` are typed and reach the project's own routes.
177
+
@@ -0,0 +1,65 @@
1
+ # Hosts and plugins
2
+
3
+ A project runs Connect as one or more hosts (`hosts/<name>/host.js`). Each host picks its routes folder, its config and its plugins.
4
+
5
+ ## Routes per host
6
+
7
+ Every host of a project mounts `hosts/connect/routes/` by default. A host picks another folder, or none, with `runner.routes`:
8
+
9
+ ```js
10
+ // hosts/lab/host.js
11
+ export default {
12
+ name: "lab",
13
+ runner: {
14
+ module: "@powerhousedao/ph-cli/runners/connect",
15
+ routes: "hosts/lab/routes", // or false: Connect's routes only
16
+ },
17
+ };
18
+ ```
19
+
20
+ - The folder works like `hosts/connect/routes/`: `_app.tsx`, `_app/` and overrides of Connect's routes apply to that host only.
21
+ - `ph run lab dev` and `ph run lab build` generate its tree in `.ph/hosts/lab/routes.gen.ts`; `hosts/connect/routes/` keeps `.ph/connect-routes.gen.ts`.
22
+ - Only `hosts/connect/routes/` is offered to other Connects (see [Offer a package's routes](./packages.md#offer-a-packages-routes)) and type-checked by `ph build`.
23
+ - To type-check a host's folder, exclude it from the project's `tsconfig.json` and give it its own, which maps the route tree to its generated file:
24
+
25
+ ```jsonc
26
+ // hosts/lab/routes/tsconfig.json
27
+ {
28
+ "extends": "../../../tsconfig.json",
29
+ "compilerOptions": {
30
+ "noEmit": true,
31
+ "incremental": false,
32
+ // Replaces the project's paths: copy any others the routes import.
33
+ "paths": {
34
+ "@powerhousedao/connect/route-tree": ["../../../.ph/hosts/lab/routes.gen.ts"],
35
+ "@powerhousedao/connect-core/route-tree": ["../../../.ph/hosts/lab/routes.gen.ts"]
36
+ }
37
+ },
38
+ "include": [".", "../../../.ph/hosts/lab/routes.gen.ts"]
39
+ }
40
+ ```
41
+
42
+ ## Host plugins
43
+
44
+ `hosts/connect/host.js` also lists `runner.plugins`, read by `ph run connect`. They transform the served runtime config through the plugin host in `@powerhousedao/connect-core` (its `src/plugins/plugin-host.ts`), which runs the built-in plugins Connect registers ([`apps/connect/src/plugins/`](https://github.com/powerhouse-inc/powerhouse/tree/main/apps/connect/src/plugins)): `@powerhousedao/connect/plugins/generic` (`allowAddDrive`, drive sections), `.../sentry`, `.../openpanel` and `.../assistant`. A listed plugin switches its slice of the config on, and an unlisted one switches it off. Other modules are skipped with a warning.
45
+
46
+ The generic plugin is also Connect's chrome: its sidebar, home screen and settings page. A composition that leaves it out shows core's views instead: a header, an index of the drives, a directory listing for a drive without a drive app, and a JSON view for a document without an editor. Without a declared composition, Connect is classic: every built-in plugin is active.
47
+
48
+ ## A plugin's UI
49
+
50
+ A plugin definition's `ui()` loads what the plugin shows, only while the plugin is active (`ConnectPluginUi` in `@powerhousedao/connect-core/plugins`):
51
+
52
+ | Field | What it does |
53
+ | --- | --- |
54
+ | `routes` | Route options by route id, e.g. `"/_app/": { component: Home }`. They apply only while the route shows core's view, so a project's own route file wins. `staticData` merges over the route's. |
55
+ | `addRoutes` | Code routes, e.g. the generic plugin's settings tabs; a route at a path the tree already serves is skipped. |
56
+ | `modals` | Modal views by type, over core's. |
57
+ | `Root` | Rendered once beside the app. |
58
+ | `errorComponent` | Any route's loader or render error. |
59
+ | `commonEditors` | Keeps common's drive explorer and editors, which core leaves out. |
60
+ | `consent` | Needs the viewer's consent to analytics cookies; Connect shows one banner when any active plugin needs it (Sentry and OpenPanel do). |
61
+
62
+ - `loadRuntimeConfig` loads the active plugins' UI before the router exists; the router applies it once. Later plugins in the composition win.
63
+ - `shell` on a definition names the prerendered loading screen that shows its UI; a composition picks the shell of its first plugin that has one, else core's.
64
+ - The generic plugin's code lives in [`apps/connect/src/generic/`](https://github.com/powerhouse-inc/powerhouse/tree/main/apps/connect/src/generic), reached only through its `ui()`, so a composition without it doesn't download it. A project's route builds on it through `@powerhousedao/connect/generic` (or `/layout`).
65
+
@@ -0,0 +1,149 @@
1
+ # Layout and the loading screen
2
+
3
+ A project's `_app.tsx` replaces the layout around Connect's pages: keep Connect's and change its sidebar, or build another from its parts. The layout is also the loading screen.
4
+
5
+ ## Replace the sidebar
6
+
7
+ A project's `_app.tsx` replaces Connect's `_app` layout. Connect's routes and the project's `_app/` routes then render inside it.
8
+
9
+ To keep Connect's layout and change only the sidebar, render `AppLayout` with your own `sidebar`. `ConnectSidebar` is Connect's sidebar; `extraItems` go after the drives and nav links. Both are the generic plugin's UI, exported from `@powerhousedao/connect/generic` with core's parts:
10
+
11
+ ```tsx
12
+ // hosts/connect/routes/_app.tsx
13
+ import {
14
+ AppLayout,
15
+ ConnectSidebar,
16
+ SidebarItem,
17
+ useSidebarMode,
18
+ } from "@powerhousedao/connect/generic";
19
+ import { isPlainClick } from "@powerhousedao/reactor-browser";
20
+ import { createFileRoute, useRouter } from "@tanstack/react-router";
21
+
22
+ export const Route = createFileRoute("/_app")({
23
+ component: Layout,
24
+ });
25
+
26
+ function Layout() {
27
+ const router = useRouter();
28
+ // AppLayout handles "hidden"; a custom sidebar handles "collapsed" itself.
29
+ const collapsed = useSidebarMode() === "collapsed";
30
+ return (
31
+ <AppLayout
32
+ sidebar={
33
+ <ConnectSidebar
34
+ collapsed={collapsed}
35
+ extraItems={
36
+ <>
37
+ <SidebarItem title="Docs" href="https://docs.example.com" />
38
+ <SidebarItem
39
+ title="Focus"
40
+ href={router.buildLocation({ to: "/focus" }).publicHref}
41
+ onClick={(event) => {
42
+ if (!isPlainClick(event)) return;
43
+ event.preventDefault();
44
+ void router.navigate({ to: "/focus" });
45
+ }}
46
+ />
47
+ </>
48
+ }
49
+ />
50
+ }
51
+ />
52
+ );
53
+ }
54
+ ```
55
+
56
+ A plain `href` makes the browser load the whole app again. Use it for external links only. For a link inside Connect, navigate through the router, as the "Focus" item does, or render the router's `Link`. `isPlainClick` leaves modified clicks (new tab, new window) to the browser.
57
+
58
+ ## Replace the layout
59
+
60
+ `@powerhousedao/connect/layout` exports core's parts to build a different layout, and `@powerhousedao/connect/generic` the generic plugin's as well. A layout that imports only from `/layout` doesn't load the generic UI:
61
+
62
+ | Export | From | What it is |
63
+ | --- | --- | --- |
64
+ | `AppLayout` | `/generic` | Connect's layout; `sidebar` replaces the sidebar. |
65
+ | `ConnectSidebar` | `/generic` | Connect's sidebar; `extraItems`, `collapsed`. |
66
+ | `SidebarDriveItems` | `/generic` | The drive items and the add-drive item. |
67
+ | `SidebarNavItems` | `/generic` | The `staticData.nav` items. |
68
+ | `SidebarItem` | `/layout` | One sidebar item. |
69
+ | `useNavRoutes()` | `/layout` | The `staticData.nav` routes, sorted: `{ label, icon, order, routeId, to }`. |
70
+ | `useSidebarMode()` | `/layout` | The current route's `staticData.sidebar`. |
71
+ | `ContentOutlet` | `/layout` | The matched route, in the container whose scroll Connect resets on new pages and restores on back and forward. |
72
+
73
+ A layout renders a `<ContentOutlet />` for the matched route; a plain `<Outlet />` works too, without the scroll handling. This one replaces the sidebar with a top bar:
74
+
75
+ ```tsx
76
+ // hosts/connect/routes/_app.tsx
77
+ import {
78
+ ContentOutlet,
79
+ useNavRoutes,
80
+ useSidebarMode,
81
+ } from "@powerhousedao/connect/layout";
82
+ import { makeDriveSlug, useDrives, useLinkProps } from "@powerhousedao/reactor-browser";
83
+ import { createFileRoute, Link } from "@tanstack/react-router";
84
+
85
+ export const Route = createFileRoute("/_app")({
86
+ component: TopNavLayout,
87
+ });
88
+
89
+ function TopNavLayout() {
90
+ const drives = useDrives();
91
+ const navRoutes = useNavRoutes();
92
+ const settings = useLinkProps({ settings: true });
93
+ const hidden = useSidebarMode() === "hidden";
94
+ return (
95
+ <div className="flex h-full flex-col">
96
+ {!hidden && (
97
+ <nav className="flex gap-2 border-b px-4 py-2">
98
+ <Link to="/" activeOptions={{ exact: true }}>Home</Link>
99
+ {drives?.map((drive) => (
100
+ <Link
101
+ key={drive.header.id}
102
+ to="/d/$driveSlug/{-$nodeSlug}"
103
+ params={{ driveSlug: makeDriveSlug(drive) }}
104
+ >
105
+ {drive.header.name}
106
+ </Link>
107
+ ))}
108
+ {navRoutes.map((item) => (
109
+ // `to` is a plain string: the routes are only known at runtime.
110
+ <Link key={item.routeId} to={item.to as never}>
111
+ {item.label}
112
+ </Link>
113
+ ))}
114
+ <a {...settings} className="ml-auto">Settings</a>
115
+ </nav>
116
+ )}
117
+ <main className="relative min-h-0 flex-1">
118
+ <ContentOutlet />
119
+ </main>
120
+ </div>
121
+ );
122
+ }
123
+ ```
124
+
125
+ - `Link` sets `aria-current="page"` and the `active` class on the current route, for styling.
126
+ - A replaced layout is responsible for `staticData.sidebar` and embedded mode; `AppLayout` handles both, a layout of your own does not.
127
+ - The loading screen in `index.html` is your layout, with `_app`'s `pendingComponent` as its content; see [The loading screen](#the-loading-screen).
128
+
129
+ [`test/versioned-documents/hosts/connect/routes/`](https://github.com/powerhouse-inc/powerhouse/tree/main/test/versioned-documents/hosts/connect/routes) in the Powerhouse repository holds a working project: a full page, and a sidebar route with search params and a nested route.
130
+
131
+ ## The loading screen
132
+
133
+ `ph connect build` renders the project's routes at `/` and inlines the result into `index.html`, so the page shows the layout before any JavaScript runs. In that render the layout's content area (`ContentOutlet`) shows the `_app` route's `pendingComponent` in place of the page:
134
+
135
+ ```tsx
136
+ // hosts/connect/routes/_app.tsx
137
+ export const Route = createFileRoute("/_app")({
138
+ component: Layout,
139
+ // The loading screen's content, and the layout's own pending view at runtime.
140
+ pendingComponent: () => <div role="status" className="m-auto">Loading…</div>,
141
+ });
142
+ ```
143
+
144
+ - Without a `pendingComponent` on `_app`, the loading screen shows core's spinner.
145
+ - The render runs at build time, in Node, with no drives: components on the path to `/` must not touch `window` while rendering, and should show nothing for data that isn't there yet (e.g. `useDrives()` is `undefined`).
146
+ - On a deep link the screen is the same, with no tab marked current; the page appears once the app routes.
147
+ - The screen's CSS is inlined: Tailwind builds the project's `style.css` for just the classes in the screen's markup, with its tokens and rules and without third-party CSS. The full stylesheet loads without blocking the first paint.
148
+ - `staticData.nav` items are links the layout renders, so they appear on the loading screen; drives arrive later, so put them after the static items to avoid a shift.
149
+
@@ -0,0 +1,78 @@
1
+ # Modals
2
+
3
+ Editors, drive apps and Connect open modals with `showPHModal(modal)` from `@powerhousedao/reactor-browser`; the open modal's view reads it with `usePHModal()` and closes it with `closePHModal()`.
4
+
5
+ **Routed modals live in the URL:** `?modal=<id>` plus their fields. A link opens them (`modalHref(modal)` gives the href) and a reload keeps them open. Opening and closing replace the current history entry, so a modal is never a step of its own: Back leaves the page, not the modal.
6
+
7
+ | Modal | `?modal=` | Owner |
8
+ | --- | --- | --- |
9
+ | `createDocument` | `create-document&documentType=…[&documentModelVersion=…]` | core |
10
+ | `login` | `login` | core |
11
+ | `addDrive` | `add-drive` | generic |
12
+ | `driveSettings` | `drive-settings&driveId=…` | generic |
13
+ | `debugSettings`, `inspector` | `debug-settings`, `inspector` | generic |
14
+ | `disclaimer` | `disclaimer` | generic |
15
+ | `cookiesPolicy` | `cookies-policy` | Connect (analytics consent) |
16
+
17
+ **Confirmations and notices stay out of the URL:** `deleteItem`, `confirmDocumentUpgrade`, `downloadDocumentWithErrors`, `documentVersionUnsupported` and `driveAuthRequired` (core's), `deleteDrive`, `upgradeDrive` and `clearStorage` (generic's), and `openFileDocuments` (Connect's file handler).
18
+
19
+ - **Core** has a plain view for each of its modals, so every host can show what editors and drive apps open.
20
+ - **With the generic plugin**, Connect shows its design-system views for all of them; without it, core's.
21
+
22
+ ## Replace a modal's view
23
+
24
+ A route's `staticData.modals` replaces the host's view of a modal while the route matches; the deepest matched route wins. The view reads the modal with `usePHModal()`:
25
+
26
+ ```tsx
27
+ // hosts/connect/routes/_app.tsx
28
+ import { closePHModal, usePHModal } from "@powerhousedao/reactor-browser";
29
+
30
+ export const Route = createFileRoute("/_app")({
31
+ component: Layout,
32
+ staticData: { modals: { createDocument: CreateTodoList } },
33
+ });
34
+
35
+ function CreateTodoList() {
36
+ const modal = usePHModal();
37
+ if (modal?.type !== "createDocument") return null;
38
+ return (
39
+ <dialog open>
40
+ New {modal.documentType}
41
+ <button onClick={closePHModal}>Cancel</button>
42
+ </dialog>
43
+ );
44
+ }
45
+ ```
46
+
47
+ - On an override of one of Connect's routes, spread `options.staticData` first if it has any.
48
+ - A view that throws closes quietly; the error is logged.
49
+
50
+ ## Frame every modal
51
+
52
+ A route's `staticData.modalFrame` lays out every core modal while the route matches, so one component restyles all of them. Each modal passes its title, content and buttons; `ModalDialog` keeps the dialog's behaviour (modal, Escape and the backdrop close it):
53
+
54
+ ```tsx
55
+ // hosts/connect/routes/_app.tsx
56
+ import type { ModalFrameProps } from "@powerhousedao/connect/layout";
57
+ import { ModalDialog } from "@powerhousedao/connect/layout";
58
+
59
+ export const Route = createFileRoute("/_app")({
60
+ component: Layout,
61
+ staticData: { modalFrame: Frame },
62
+ });
63
+
64
+ function Frame({ title, titleId, actions, children }: ModalFrameProps) {
65
+ return (
66
+ <ModalDialog labelledBy={titleId} className="rounded-xl p-0 shadow-2xl">
67
+ <h2 id={titleId}>{title}</h2>
68
+ <div>{children}</div>
69
+ <footer>{actions}</footer>
70
+ </ModalDialog>
71
+ );
72
+ }
73
+ ```
74
+
75
+ - The deepest matched route's frame wins, as with `staticData.modals`. On `_app` it frames the modals opened inside the layout; on the root route, all of them.
76
+ - It frames core's modals. The generic plugin's design-system modals, and views a route gives in `staticData.modals`, draw their own.
77
+ - The content and buttons keep core's markup; style them from the frame, e.g. with `[&_button]:…` classes.
78
+