@lowdefy/server-dev 7.1.0 → 7.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (439) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +101 -143
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.js +6 -5
  106. package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
  107. package/lib/docs/isPageReady.test.mjs +1 -0
  108. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  109. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  110. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  111. package/lib/docs/launchBrowser.test.mjs +8 -8
  112. package/lib/docs/listTypes.js +58 -8
  113. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  114. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  115. package/lib/docs/observe/createJourneyAppErrors.test.mjs +18 -4
  116. package/lib/docs/observe/evaluateInvariants.js +23 -0
  117. package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
  118. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  119. package/lib/docs/observe/toAppErrorFailure.js +7 -4
  120. package/lib/docs/observe/watchJourneyContext.js +1 -0
  121. package/lib/docs/observe/withAppErrors.test.mjs +22 -0
  122. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  123. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  124. package/lib/docs/pollTab.js +100 -0
  125. package/lib/docs/pollTab.test.mjs +64 -0
  126. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  127. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  128. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  129. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  130. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  131. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  132. package/lib/docs/readJourneySession.js +1 -1
  133. package/lib/docs/reportDevToolFault.js +29 -0
  134. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  135. package/lib/docs/requestRestart.test.mjs +1 -0
  136. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  137. package/lib/docs/resolveSource.js +2 -2
  138. package/lib/docs/resolveSource.test.mjs +6 -6
  139. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  140. package/lib/docs/runCheck.test.mjs +3 -3
  141. package/lib/docs/runCheckChild.js +2 -1
  142. package/lib/docs/runEndpoint.js +23 -10
  143. package/lib/docs/runEndpoint.test.mjs +42 -37
  144. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  145. package/lib/docs/runJourney.js +21 -1
  146. package/lib/docs/runJourney.test.mjs +119 -99
  147. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  148. package/lib/docs/runJourneySteps.js +8 -29
  149. package/lib/docs/runRequest.js +6 -6
  150. package/lib/docs/runRequest.test.mjs +22 -22
  151. package/lib/docs/screenshotPage.js +6 -7
  152. package/lib/docs/screenshotPage.test.mjs +46 -46
  153. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  154. package/lib/docs/searchDocs.test.mjs +1 -0
  155. package/lib/docs/searchIcons.test.mjs +5 -5
  156. package/lib/docs/selectFinalState.test.mjs +1 -0
  157. package/lib/docs/serverErrorStore.test.mjs +4 -4
  158. package/lib/docs/setupTestFixtures.mjs +25 -0
  159. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  160. package/lib/docs/tabAvailable.js +1 -1
  161. package/lib/docs/tabChannel.js +90 -14
  162. package/lib/docs/tabChannel.test.mjs +40 -15
  163. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  164. package/lib/docs/validateStateSelection.test.mjs +1 -0
  165. package/lib/docs/validateViewport.test.mjs +1 -0
  166. package/lib/docs/waitForBuild.test.mjs +1 -0
  167. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  168. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  169. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  170. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  171. package/lib/server/auth/getHeadlessUser.js +6 -0
  172. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  173. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  174. package/lib/server/contextMapBudget.test.mjs +3 -3
  175. package/lib/server/continueJitKeys.test.mjs +1 -0
  176. package/lib/server/createLowdefyContext.js +5 -1
  177. package/lib/server/createLowdefyContext.test.mjs +32 -32
  178. package/lib/server/getClientAddress.test.mjs +2 -2
  179. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  180. package/lib/server/importAppCode.test.mjs +2 -2
  181. package/lib/server/jitPageBuilder.js +27 -3
  182. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  183. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  184. package/lib/server/jitPageBuilder.test.mjs +4 -4
  185. package/lib/server/journeyCookies.test.mjs +1 -0
  186. package/lib/server/loadDynamicJsMap.js +10 -1
  187. package/lib/server/log/createHandleError.js +10 -5
  188. package/lib/server/log/createHandleError.test.mjs +19 -8
  189. package/lib/server/log/createLogger.test.mjs +2 -2
  190. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  191. package/lib/server/mutants/listMutants.test.mjs +1 -0
  192. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  193. package/lib/server/mutants/operators.test.mjs +1 -0
  194. package/lib/server/pageBuildRecords.test.mjs +1 -0
  195. package/lib/server/pageCache.test.mjs +1 -0
  196. package/lib/server/pageRebuilds.test.mjs +3 -3
  197. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  198. package/lib/server/pruneJitMaps.test.mjs +1 -0
  199. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  200. package/lib/server/readInstanceRecord.test.mjs +24 -8
  201. package/lib/server/readMergedMaps.test.mjs +1 -0
  202. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  203. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  204. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  205. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  206. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  207. package/lib/server/startIdleGc.test.mjs +25 -9
  208. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  209. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  210. package/lib/vite/keepIdleConnectionsOpen.js +36 -0
  211. package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -0
  212. package/manager/getContext.mjs +9 -0
  213. package/manager/processes/checkPendingPlugins.mjs +49 -0
  214. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  215. package/manager/processes/createIdleChild.mjs +141 -0
  216. package/manager/processes/createIdleChild.test.mjs +209 -0
  217. package/manager/processes/initialBuild.mjs +2 -15
  218. package/manager/processes/initialBuild.test.mjs +8 -40
  219. package/manager/processes/lowdefyBuild.mjs +7 -4
  220. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  221. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  222. package/manager/processes/restartServer.test.mjs +63 -15
  223. package/manager/processes/shutdownServer.test.mjs +3 -3
  224. package/manager/processes/startFirstServer.test.mjs +23 -22
  225. package/manager/processes/startMailSink.mjs +11 -3
  226. package/manager/processes/startMailSink.test.mjs +28 -2
  227. package/manager/processes/startProxy.mjs +167 -29
  228. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  229. package/manager/processes/startProxy.test.mjs +130 -5
  230. package/manager/processes/startServer.mjs +5 -7
  231. package/manager/processes/startServer.test.mjs +10 -9
  232. package/manager/processes/syncServer.mjs +31 -4
  233. package/manager/processes/syncServer.test.mjs +71 -6
  234. package/manager/processes/waitForDevServer.test.mjs +21 -6
  235. package/manager/run.mjs +32 -8
  236. package/manager/utils/BatchChanges.mjs +1 -1
  237. package/manager/utils/BatchChanges.test.mjs +4 -4
  238. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  239. package/manager/utils/checkPairing.mjs +45 -0
  240. package/manager/utils/checkPairing.test.mjs +53 -0
  241. package/manager/utils/createBuildActivity.mjs +5 -1
  242. package/manager/utils/createBuildActivity.test.mjs +2 -2
  243. package/manager/utils/createChangeSignal.test.mjs +5 -5
  244. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  245. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  246. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  247. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  248. package/manager/utils/createGlobIgnore.mjs +45 -0
  249. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  250. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  251. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  252. package/manager/utils/createIdleGc.test.mjs +31 -15
  253. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  254. package/manager/utils/createLanPairing.test.mjs +46 -0
  255. package/manager/utils/createRequestActivity.mjs +30 -3
  256. package/manager/utils/createRequestActivity.test.mjs +76 -22
  257. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  258. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  259. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  260. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  261. package/manager/utils/findSignInCode.test.mjs +33 -0
  262. package/manager/utils/formatLanPairing.mjs +32 -0
  263. package/manager/utils/formatLanPairing.test.mjs +40 -0
  264. package/manager/utils/getLanAddress.mjs +83 -0
  265. package/manager/utils/getLanAddress.test.mjs +70 -0
  266. package/manager/utils/importFresh.test.mjs +1 -0
  267. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  268. package/manager/utils/pluginTypeCache.mjs +100 -0
  269. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  270. package/manager/utils/pruneRecordings.test.mjs +1 -0
  271. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  272. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  273. package/manager/utils/readBasePath.test.mjs +1 -0
  274. package/manager/utils/readManagerVersion.test.mjs +1 -0
  275. package/manager/utils/readPluginDefinitions.mjs +6 -6
  276. package/manager/utils/renderTerminalQr.mjs +54 -0
  277. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  278. package/manager/utils/setupWatcher.mjs +19 -4
  279. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  280. package/manager/utils/waitForChildExit.test.mjs +2 -2
  281. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  282. package/manager/watchers/envWatcher.mjs +3 -0
  283. package/manager/watchers/envWatcher.test.mjs +19 -7
  284. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  285. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  286. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  287. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  288. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  289. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  290. package/manager/watchers/resolveFile.mjs +46 -0
  291. package/manager/watchers/resolveFile.test.mjs +67 -0
  292. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  293. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  294. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  295. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  296. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  297. package/package.json +54 -53
  298. package/package.original.json +54 -53
  299. package/src/app.js +83 -85
  300. package/src/html/renderDevPage.test.mjs +1 -0
  301. package/src/lib/getPathSegments.js +16 -1
  302. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  303. package/src/lib/isTabAnswer.js +32 -0
  304. package/src/lib/isTabChannelCaller.js +35 -0
  305. package/src/middleware/apiContext.js +4 -2
  306. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  307. package/src/middleware/errorHandler.js +33 -45
  308. package/src/middleware/errorHandler.test.mjs +10 -10
  309. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  310. package/src/middleware/localDevToolsOnly.js +13 -1
  311. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  312. package/src/middleware/noStore.test.mjs +1 -0
  313. package/src/middleware/requestTimeout.js +7 -1
  314. package/src/middleware/staleFlag.test.mjs +1 -0
  315. package/src/middleware/stampCaller.test.mjs +1 -0
  316. package/src/routes/agentBearer.test.mjs +183 -0
  317. package/src/routes/auth.test.mjs +10 -10
  318. package/src/routes/clientError.js +21 -4
  319. package/src/routes/clientError.test.mjs +127 -0
  320. package/src/routes/devInspect.js +6 -51
  321. package/src/routes/devInspect.test.mjs +128 -3
  322. package/src/routes/devRecording.js +6 -17
  323. package/src/routes/devRecording.test.mjs +54 -3
  324. package/src/routes/docs/buildStatus.test.mjs +6 -6
  325. package/src/routes/docs/events.test.mjs +4 -4
  326. package/src/routes/docs/find.js +3 -3
  327. package/src/routes/docs/journey.test.mjs +8 -8
  328. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  329. package/src/routes/docs/loadDocsRoutes.js +70 -0
  330. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  331. package/src/routes/docs/mcp.test.mjs +5 -5
  332. package/src/routes/docs/mutants.js +7 -0
  333. package/src/routes/docs/mutants.test.mjs +20 -6
  334. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  335. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  336. package/src/routes/docs/restart.test.mjs +1 -0
  337. package/src/routes/endpoints.js +24 -0
  338. package/src/routes/endpointsLink.test.mjs +111 -0
  339. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  340. package/src/routes/jitPage.js +13 -1
  341. package/src/routes/jitPage.test.mjs +36 -11
  342. package/src/routes/mcp.js +6 -0
  343. package/src/routes/mcp.test.mjs +23 -8
  344. package/src/routes/mcpMemberToken.test.mjs +8 -8
  345. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  346. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  347. package/src/routes/mobileRoutes.test.mjs +223 -0
  348. package/src/routes/mobileSignIn.js +58 -0
  349. package/src/routes/mobileSignIn.test.mjs +59 -0
  350. package/src/routes/mobileSignInCallback.js +34 -0
  351. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  352. package/src/routes/mountDevPageRoutes.js +10 -2
  353. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  354. package/src/routes/mountMobileWellKnown.js +35 -0
  355. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  356. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  357. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  358. package/src/routes/reload.js +101 -20
  359. package/src/routes/reload.test.mjs +153 -0
  360. package/src/routes/request.js +1 -22
  361. package/src/routes/request.test.mjs +7 -24
  362. package/src/routes/requestBody.test.mjs +14 -27
  363. package/src/routes/websocket.test.mjs +2 -2
  364. package/src/routes/wellKnownFallback.test.mjs +2 -2
  365. package/src/websocket/devWebSocket.test.mjs +12 -12
  366. package/vite.config.js +15 -1
  367. package/client/feedback/FeedbackMount.jsx +0 -83
  368. package/client/feedback/FeedbackOverlay.jsx +0 -904
  369. package/client/feedback/captureTabScreenshot.js +0 -84
  370. package/client/feedback/copyToClipboard.js +0 -45
  371. package/client/feedback/drawAnnotationsSvg.js +0 -119
  372. package/client/feedback/feedbackStyles.js +0 -304
  373. package/client/feedback/pinResponsiveImages.js +0 -59
  374. package/client/feedback/sendFeedback.js +0 -39
  375. package/client/feedback/useFeedbackToggle.js +0 -70
  376. package/client/recorder/buildEngineRecord.js +0 -37
  377. package/client/recorder/buildInteractionRecord.js +0 -64
  378. package/client/recorder/buildTraceEvent.js +0 -57
  379. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  380. package/client/recorder/chunkRecords.js +0 -69
  381. package/client/recorder/chunkRecords.test.mjs +0 -59
  382. package/client/recorder/collectEventEndpoints.js +0 -40
  383. package/client/recorder/collectEventRequests.js +0 -39
  384. package/client/recorder/createPairingBuffer.js +0 -187
  385. package/client/recorder/createPasswordRedactor.js +0 -84
  386. package/client/recorder/createRecordBatcher.js +0 -54
  387. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  388. package/client/recorder/createRecordingSession.js +0 -61
  389. package/client/recorder/createRecordingSession.test.mjs +0 -72
  390. package/client/recorder/diffStateWrites.js +0 -77
  391. package/client/recorder/diffStateWrites.test.mjs +0 -66
  392. package/client/recorder/isEventCall.js +0 -30
  393. package/client/recorder/jsonType.js +0 -39
  394. package/client/recorder/sendRecords.js +0 -40
  395. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  396. package/lib/docs/checkpointPaths.js +0 -91
  397. package/lib/docs/checkpointStore.js +0 -243
  398. package/lib/docs/checkpointToMocks.js +0 -65
  399. package/lib/docs/configCheckpoints.test.mjs +0 -156
  400. package/lib/docs/createConfigCheckpoint.js +0 -92
  401. package/lib/docs/devMockRegistry.js +0 -68
  402. package/lib/docs/enrichFeedback.js +0 -71
  403. package/lib/docs/evalOperator.js +0 -49
  404. package/lib/docs/evalOperator.test.mjs +0 -157
  405. package/lib/docs/evalOperatorHeadless.js +0 -159
  406. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  407. package/lib/docs/evalOperatorInTab.js +0 -49
  408. package/lib/docs/formatFeedback.js +0 -142
  409. package/lib/docs/formatFeedback.test.mjs +0 -252
  410. package/lib/docs/getPluginDoc.js +0 -53
  411. package/lib/docs/listConfigCheckpoints.js +0 -55
  412. package/lib/docs/loadState.js +0 -220
  413. package/lib/docs/revertConfigCheckpoint.js +0 -73
  414. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  415. package/lib/docs/scaffoldPage.js +0 -77
  416. package/lib/docs/scaffoldPage.test.mjs +0 -97
  417. package/lib/docs/snapshotState.js +0 -67
  418. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  419. package/manager/watchers/listServerSidePackages.mjs +0 -47
  420. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  421. package/src/routes/docs/checkpointsCreate.js +0 -28
  422. package/src/routes/docs/evalOperator.js +0 -70
  423. package/src/routes/docs/inspectState.js +0 -59
  424. package/src/routes/docs/loadState.js +0 -51
  425. package/src/routes/docs/pluginDoc.js +0 -33
  426. package/src/routes/docs/plugins.js +0 -23
  427. package/src/routes/docs/runEndpoint.js +0 -54
  428. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  429. package/src/routes/docs/runRequest.js +0 -53
  430. package/src/routes/docs/runRequest.test.mjs +0 -92
  431. package/src/routes/docs/schema.js +0 -37
  432. package/src/routes/docs/screenshot.js +0 -120
  433. package/src/routes/docs/screenshot.test.mjs +0 -117
  434. package/src/routes/docs/search.js +0 -40
  435. package/src/routes/docs/snapshotState.js +0 -50
  436. package/src/routes/docs/stateCheckpointsList.js +0 -26
  437. package/src/routes/docs/types.js +0 -33
  438. package/src/routes/feedback.js +0 -107
  439. package/src/routes/feedback.test.mjs +0 -204
@@ -1,904 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import React, { useEffect, useReducer, useRef, useState } from 'react';
18
- import { createPortal } from 'react-dom';
19
-
20
- import { blockAncestorChain, describeElement, nearestBlock } from './elementInspect.js';
21
- import {
22
- annotatingPanel,
23
- buttonRow,
24
- colors,
25
- consoleCountRow,
26
- dangerButton,
27
- descriptorRow,
28
- errorRow,
29
- highlightBox,
30
- labelChip,
31
- overlayContainer,
32
- panelHeading,
33
- primaryButton,
34
- reviewItem,
35
- reviewItemRemove,
36
- reviewTray,
37
- secondaryButton,
38
- selectedHighlightBox,
39
- selectedLabelChip,
40
- sentBanner,
41
- svgLayer,
42
- textareaStyle,
43
- toolButtonStyle,
44
- toolRow,
45
- injectFeedbackStyleTag,
46
- removeFeedbackStyleTag,
47
- } from './feedbackStyles.js';
48
- import captureTabScreenshot from './captureTabScreenshot.js';
49
- import copyToClipboard from './copyToClipboard.js';
50
- import sendFeedback from './sendFeedback.js';
51
-
52
- const FEEDBACK_ROOT_SELECTOR = '[data-lowdefy-feedback]';
53
- const FREEHAND_MIN_SAMPLE_DIST = 4;
54
- const MIN_SHAPE_SIZE = 2;
55
- const SENT_CLOSE_DELAY_MS = 1200;
56
-
57
- const TOOL_LABELS = { rect: 'Rectangle', arrow: 'Arrow', freehand: 'Freehand' };
58
-
59
- function generateId() {
60
- try {
61
- return crypto.randomUUID();
62
- } catch {
63
- return `fb-${Date.now()}-${Math.random().toString(16).slice(2)}`;
64
- }
65
- }
66
-
67
- // Used internally for CSS positioning (top/left) of highlight boxes.
68
- function rectToPlain(rect) {
69
- return { top: rect.top, left: rect.left, width: rect.width, height: rect.height };
70
- }
71
-
72
- // Used for the wire contract (x/y), which the dev server's formatFeedback.js
73
- // and enrichFeedback.js are built against.
74
- function rectToXY(rect) {
75
- return { x: rect.left, y: rect.top, width: rect.width, height: rect.height };
76
- }
77
-
78
- const initialState = {
79
- phase: 'picking', // picking | annotating | drawing | sent
80
- hoverBlock: null, // { blockId, rect }
81
- selection: null, // { kind, blockId, blockChain, tag, classes, text, rect }
82
- draftComment: '',
83
- draftTool: null, // rect | arrow | freehand
84
- draftShapes: [],
85
- batch: [],
86
- includeScreenshot: true,
87
- sending: false,
88
- sendError: null,
89
- };
90
-
91
- function reducer(state, action) {
92
- switch (action.type) {
93
- case 'TOGGLE_SCREENSHOT':
94
- return { ...state, includeScreenshot: !state.includeScreenshot };
95
- case 'HOVER_BLOCK':
96
- return { ...state, hoverBlock: action.hoverBlock };
97
- case 'LOCK_SELECTION':
98
- return {
99
- ...state,
100
- phase: 'annotating',
101
- hoverBlock: null,
102
- selection: action.selection,
103
- draftComment: '',
104
- draftTool: null,
105
- draftShapes: [],
106
- };
107
- case 'UPDATE_HOVER_RECT':
108
- if (!state.hoverBlock) return state;
109
- return { ...state, hoverBlock: { ...state.hoverBlock, rect: action.rect } };
110
- case 'UPDATE_SELECTION_RECT':
111
- if (!state.selection) return state;
112
- return { ...state, selection: { ...state.selection, rect: action.rect } };
113
- case 'SET_COMMENT':
114
- return { ...state, draftComment: action.comment };
115
- case 'START_DRAWING':
116
- return { ...state, phase: 'drawing', draftTool: action.tool };
117
- case 'ADD_SHAPE':
118
- return {
119
- ...state,
120
- phase: 'annotating',
121
- draftTool: null,
122
- draftShapes: [...state.draftShapes, action.shape],
123
- };
124
- case 'CANCEL_DRAWING':
125
- return { ...state, phase: 'annotating', draftTool: null };
126
- // "Add another" — bank the current draft and go straight back to picking;
127
- // the banked annotations show in the pending tray until sent.
128
- case 'SAVE_ANNOTATION':
129
- return {
130
- ...state,
131
- phase: 'picking',
132
- batch: [...state.batch, action.annotation],
133
- selection: null,
134
- draftComment: '',
135
- draftTool: null,
136
- draftShapes: [],
137
- };
138
- case 'DISCARD_DRAFT':
139
- return {
140
- ...state,
141
- phase: 'picking',
142
- hoverBlock: null,
143
- selection: null,
144
- draftComment: '',
145
- draftTool: null,
146
- draftShapes: [],
147
- };
148
- case 'REMOVE_FROM_BATCH':
149
- return { ...state, batch: state.batch.filter((annotation) => annotation.id !== action.id) };
150
- case 'DISCARD_ALL':
151
- return { ...state, phase: 'picking', batch: [] };
152
- case 'SEND_START':
153
- return { ...state, sending: true, sendError: null };
154
- case 'SEND_SUCCESS':
155
- return { ...state, sending: false, phase: 'sent' };
156
- case 'SEND_ERROR':
157
- return { ...state, sending: false, sendError: action.error };
158
- default:
159
- return state;
160
- }
161
- }
162
-
163
- // Matches the dev server's contract exactly (see
164
- // lib/docs/formatFeedback.js / enrichFeedback.js and their tests):
165
- // kind is "element" | "region"; target is null for a region (there is no
166
- // block to attach a config location to); geometry.elementRect uses x/y (a
167
- // DOMRect's x/y are the same values as its top/left, just renamed for the
168
- // wire format); shapes carry a uniform `points` array regardless of tool.
169
- function buildAnnotation(state) {
170
- const { selection, draftComment, draftShapes } = state;
171
- const isElement = selection.kind === 'element';
172
- return {
173
- id: generateId(),
174
- kind: selection.kind,
175
- comment: draftComment,
176
- target: isElement
177
- ? {
178
- blockId: selection.blockId,
179
- ancestorBlockIds: selection.blockChain,
180
- tag: selection.tag,
181
- text: selection.text,
182
- }
183
- : null,
184
- geometry: {
185
- elementRect: isElement && selection.rect ? rectToXY(selection.rect) : null,
186
- shapes: draftShapes,
187
- },
188
- };
189
- }
190
-
191
- function buildBatch({ annotations, includeScreenshot, page }) {
192
- const pageId = page?.pageId;
193
- const pathParams = page?.pathParams ?? {};
194
- return {
195
- batchId: generateId(),
196
- timestamp: new Date().toISOString(),
197
- pageId,
198
- url: `${window.location.pathname}${window.location.search}`,
199
- pathParams,
200
- urlQuery: window.location.search,
201
- viewport: {
202
- width: window.innerWidth,
203
- height: window.innerHeight,
204
- scrollX: window.scrollX,
205
- scrollY: window.scrollY,
206
- dpr: window.devicePixelRatio,
207
- },
208
- annotations,
209
- includeScreenshot,
210
- stateRef: { captured: true, pageId, pathParams },
211
- };
212
- }
213
-
214
- function handleEscape({ stateRef, dispatch, onClose }) {
215
- const { phase, batch } = stateRef.current;
216
- if (phase === 'drawing') {
217
- dispatch({ type: 'CANCEL_DRAWING' });
218
- return;
219
- }
220
- if (phase === 'annotating') {
221
- dispatch({ type: 'DISCARD_DRAFT' });
222
- return;
223
- }
224
- // picking (or sent, though Esc is irrelevant there)
225
- try {
226
- if (batch.length > 0) {
227
- const confirmed = window.confirm(
228
- `Discard ${batch.length} pending annotation${batch.length === 1 ? '' : 's'}?`
229
- );
230
- if (!confirmed) {
231
- return;
232
- }
233
- }
234
- } catch {
235
- // If confirm() itself throws (unlikely), fall through and close anyway.
236
- }
237
- if (onClose) {
238
- onClose();
239
- }
240
- }
241
-
242
- // Every shape carries a uniform `points` array (the wire contract's shape),
243
- // interpreted per type: rect = [topLeft, bottomRight], arrow = [tail, head],
244
- // freehand = the full sampled path.
245
- function renderShape(shape, key) {
246
- if (shape.type === 'rect') {
247
- const [a, b] = shape.points;
248
- return (
249
- <rect
250
- key={key}
251
- x={a.x}
252
- y={a.y}
253
- width={b.x - a.x}
254
- height={b.y - a.y}
255
- stroke={colors.stroke}
256
- strokeWidth={2}
257
- fill={colors.strokeBg}
258
- />
259
- );
260
- }
261
- if (shape.type === 'arrow') {
262
- const [a, b] = shape.points;
263
- return (
264
- <line
265
- key={key}
266
- x1={a.x}
267
- y1={a.y}
268
- x2={b.x}
269
- y2={b.y}
270
- stroke={colors.stroke}
271
- strokeWidth={2}
272
- markerEnd="url(#lowdefy-feedback-arrowhead)"
273
- />
274
- );
275
- }
276
- if (shape.type === 'freehand') {
277
- return (
278
- <polyline
279
- key={key}
280
- points={shape.points.map((point) => `${point.x},${point.y}`).join(' ')}
281
- stroke={colors.stroke}
282
- strokeWidth={2}
283
- fill="none"
284
- />
285
- );
286
- }
287
- return null;
288
- }
289
-
290
- // The overlay itself. Everything here is dev-only and must never take the
291
- // app down with it — event handlers are individually try/caught, and the
292
- // whole render is wrapped so a bad state shape returns null rather than
293
- // throwing into the app's React tree.
294
- function FeedbackOverlay({ basePath, page, onClose }) {
295
- const [state, dispatch] = useReducer(reducer, initialState);
296
- const primarySendRef = useRef(null);
297
- const stateRef = useRef(state);
298
- stateRef.current = state;
299
-
300
- const textareaRef = useRef(null);
301
- const drawStartRef = useRef(null);
302
- const freehandPointsRef = useRef([]);
303
- const [isDrawingShape, setIsDrawingShape] = useState(false);
304
- const [drawPreview, setDrawPreview] = useState(null);
305
-
306
- // Style tag lifecycle — installed for the overlay's lifetime only.
307
- useEffect(() => {
308
- injectFeedbackStyleTag();
309
- return () => removeFeedbackStyleTag();
310
- }, []);
311
-
312
- // Capture-phase keydown suppressor: blocks every key from reaching the
313
- // app's own shortcut manager while the overlay is active, except when the
314
- // developer is typing inside the overlay itself (e.g. the comment
315
- // textarea). Esc and Enter are handled here first, before deciding
316
- // whether to suppress, so they always work regardless of focus.
317
- useEffect(() => {
318
- function onKeyDown(event) {
319
- try {
320
- const insideOverlay =
321
- event.target instanceof Element && Boolean(event.target.closest(FEEDBACK_ROOT_SELECTOR));
322
-
323
- if (event.key === 'Escape') {
324
- event.preventDefault();
325
- handleEscape({ stateRef, dispatch, onClose });
326
- event.stopImmediatePropagation();
327
- return;
328
- }
329
-
330
- // Enter drives the primary (blue) action for the current phase —
331
- // copy for agent, including the in-flight draft. Shift+Enter still
332
- // inserts a newline in the comment textarea.
333
- const isPlainEnter = event.key === 'Enter' && !event.shiftKey;
334
- if (isPlainEnter) {
335
- const current = stateRef.current;
336
- const canSendDraft = current.phase === 'annotating' && current.selection;
337
- const canSendBatch = current.phase === 'picking' && current.batch.length > 0;
338
- if (!current.sending && (canSendDraft || canSendBatch)) {
339
- event.preventDefault();
340
- primarySendRef.current?.();
341
- event.stopImmediatePropagation();
342
- return;
343
- }
344
- }
345
-
346
- if (!insideOverlay) {
347
- event.stopImmediatePropagation();
348
- }
349
- } catch {
350
- // Never let a keyboard-handling bug break the developer's app.
351
- }
352
- }
353
-
354
- window.addEventListener('keydown', onKeyDown, { capture: true });
355
- return () => window.removeEventListener('keydown', onKeyDown, { capture: true });
356
- }, [onClose]);
357
-
358
- // Cursor styling for pick/draw modes.
359
- useEffect(() => {
360
- const body = document.body;
361
- try {
362
- body.classList.toggle('lowdefy-feedback-picking', state.phase === 'picking');
363
- body.classList.toggle('lowdefy-feedback-drawing', state.phase === 'drawing');
364
- } catch {
365
- // no-op
366
- }
367
- return () => {
368
- try {
369
- body.classList.remove('lowdefy-feedback-picking', 'lowdefy-feedback-drawing');
370
- } catch {
371
- // no-op
372
- }
373
- };
374
- }, [state.phase]);
375
-
376
- // Picking mode: window-level pointermove drives the hover highlight,
377
- // capture-phase click locks the selection. The overlay container itself is
378
- // pointer-events:none so elementFromPoint always resolves to the real app
379
- // DOM underneath.
380
- useEffect(() => {
381
- if (state.phase !== 'picking') {
382
- return undefined;
383
- }
384
-
385
- function onPointerMove(event) {
386
- try {
387
- const el = document.elementFromPoint(event.clientX, event.clientY);
388
- const blockId = nearestBlock(el);
389
- if (!blockId) {
390
- dispatch({ type: 'HOVER_BLOCK', hoverBlock: null });
391
- return;
392
- }
393
- const blockEl = document.getElementById(`bl-${blockId}`);
394
- if (!blockEl) {
395
- dispatch({ type: 'HOVER_BLOCK', hoverBlock: null });
396
- return;
397
- }
398
- dispatch({
399
- type: 'HOVER_BLOCK',
400
- hoverBlock: { blockId, rect: rectToPlain(blockEl.getBoundingClientRect()) },
401
- });
402
- } catch {
403
- // Best-effort hover tracking.
404
- }
405
- }
406
-
407
- function onClickCapture(event) {
408
- try {
409
- // Clicks on the overlay's own UI (the pending tray) are real button
410
- // clicks, not element picks.
411
- if (event.target instanceof Element && event.target.closest(FEEDBACK_ROOT_SELECTOR)) {
412
- return;
413
- }
414
- event.preventDefault();
415
- event.stopPropagation();
416
- const el = document.elementFromPoint(event.clientX, event.clientY);
417
- const blockId = nearestBlock(el);
418
-
419
- if (blockId) {
420
- const blockEl = document.getElementById(`bl-${blockId}`);
421
- const descriptor = describeElement(blockEl ?? el);
422
- dispatch({
423
- type: 'LOCK_SELECTION',
424
- selection: {
425
- kind: 'element',
426
- blockId,
427
- blockChain: blockAncestorChain(el),
428
- tag: descriptor.tag,
429
- classes: descriptor.classes,
430
- text: descriptor.text,
431
- rect: blockEl ? rectToPlain(blockEl.getBoundingClientRect()) : null,
432
- },
433
- });
434
- return;
435
- }
436
-
437
- // No block under the cursor — start a region annotation instead.
438
- const descriptor = describeElement(el);
439
- dispatch({
440
- type: 'LOCK_SELECTION',
441
- selection: {
442
- kind: 'region',
443
- blockId: null,
444
- blockChain: [],
445
- tag: descriptor.tag,
446
- classes: descriptor.classes,
447
- text: descriptor.text,
448
- rect: { top: event.clientY, left: event.clientX, width: 0, height: 0 },
449
- },
450
- });
451
- } catch {
452
- // Best-effort selection locking.
453
- }
454
- }
455
-
456
- window.addEventListener('pointermove', onPointerMove);
457
- window.addEventListener('click', onClickCapture, { capture: true });
458
- return () => {
459
- window.removeEventListener('pointermove', onPointerMove);
460
- window.removeEventListener('click', onClickCapture, { capture: true });
461
- };
462
- }, [state.phase]);
463
-
464
- // Keep highlight/selection rects aligned with the app underneath as the
465
- // developer scrolls or resizes the window.
466
- useEffect(() => {
467
- function recompute() {
468
- try {
469
- if (stateRef.current.hoverBlock) {
470
- const el = document.getElementById(`bl-${stateRef.current.hoverBlock.blockId}`);
471
- if (el) {
472
- dispatch({ type: 'UPDATE_HOVER_RECT', rect: rectToPlain(el.getBoundingClientRect()) });
473
- }
474
- }
475
- if (stateRef.current.selection && stateRef.current.selection.kind === 'element') {
476
- const el = document.getElementById(`bl-${stateRef.current.selection.blockId}`);
477
- if (el) {
478
- dispatch({
479
- type: 'UPDATE_SELECTION_RECT',
480
- rect: rectToPlain(el.getBoundingClientRect()),
481
- });
482
- }
483
- }
484
- } catch {
485
- // Best-effort — a stale rect just corrects on the next event.
486
- }
487
- }
488
- window.addEventListener('scroll', recompute, true);
489
- window.addEventListener('resize', recompute);
490
- return () => {
491
- window.removeEventListener('scroll', recompute, true);
492
- window.removeEventListener('resize', recompute);
493
- };
494
- }, []);
495
-
496
- // Autofocus the comment textarea whenever a fresh selection is locked.
497
- useEffect(() => {
498
- if (state.phase === 'annotating' && textareaRef.current) {
499
- try {
500
- textareaRef.current.focus();
501
- } catch {
502
- // no-op
503
- }
504
- }
505
- }, [state.phase, state.selection]);
506
-
507
- // Auto-close shortly after a successful send.
508
- useEffect(() => {
509
- if (state.phase !== 'sent') {
510
- return undefined;
511
- }
512
- const timer = setTimeout(() => {
513
- if (onClose) {
514
- onClose();
515
- }
516
- }, SENT_CLOSE_DELAY_MS);
517
- return () => clearTimeout(timer);
518
- }, [state.phase, onClose]);
519
-
520
- function handleDrawPointerDown(event) {
521
- try {
522
- event.preventDefault();
523
- const point = { x: event.clientX, y: event.clientY };
524
- if (state.draftTool === 'freehand') {
525
- freehandPointsRef.current = [point];
526
- setDrawPreview({ type: 'freehand', points: [point] });
527
- } else if (state.draftTool === 'rect' || state.draftTool === 'arrow') {
528
- // rect = [topLeft, bottomRight], arrow = [tail, head] — both start
529
- // as a degenerate two-point shape at the down position.
530
- drawStartRef.current = point;
531
- setDrawPreview({ type: state.draftTool, points: [point, point] });
532
- }
533
- setIsDrawingShape(true);
534
- } catch {
535
- // no-op
536
- }
537
- }
538
-
539
- function handleDrawPointerMove(event) {
540
- if (!isDrawingShape) {
541
- return;
542
- }
543
- try {
544
- const point = { x: event.clientX, y: event.clientY };
545
- if (state.draftTool === 'freehand') {
546
- const points = freehandPointsRef.current;
547
- const last = points[points.length - 1];
548
- if (Math.hypot(point.x - last.x, point.y - last.y) >= FREEHAND_MIN_SAMPLE_DIST) {
549
- points.push(point);
550
- setDrawPreview({ type: 'freehand', points: [...points] });
551
- }
552
- } else if (state.draftTool === 'rect') {
553
- const start = drawStartRef.current;
554
- setDrawPreview({
555
- type: 'rect',
556
- points: [
557
- { x: Math.min(start.x, point.x), y: Math.min(start.y, point.y) },
558
- { x: Math.max(start.x, point.x), y: Math.max(start.y, point.y) },
559
- ],
560
- });
561
- } else if (state.draftTool === 'arrow') {
562
- const start = drawStartRef.current;
563
- setDrawPreview({ type: 'arrow', points: [start, point] });
564
- }
565
- } catch {
566
- // no-op
567
- }
568
- }
569
-
570
- function handleDrawPointerUp() {
571
- try {
572
- const shape = drawPreview;
573
- let keep = Boolean(shape);
574
- if (shape?.type === 'rect') {
575
- const [a, b] = shape.points;
576
- if (Math.abs(b.x - a.x) < MIN_SHAPE_SIZE && Math.abs(b.y - a.y) < MIN_SHAPE_SIZE) {
577
- keep = false;
578
- }
579
- }
580
- if (shape?.type === 'arrow') {
581
- const [a, b] = shape.points;
582
- if (Math.hypot(b.x - a.x, b.y - a.y) < MIN_SHAPE_SIZE) {
583
- keep = false;
584
- }
585
- }
586
- if (shape?.type === 'freehand' && shape.points.length < 2) {
587
- keep = false;
588
- }
589
- if (keep) {
590
- dispatch({ type: 'ADD_SHAPE', shape });
591
- } else {
592
- dispatch({ type: 'CANCEL_DRAWING' });
593
- }
594
- } catch {
595
- dispatch({ type: 'CANCEL_DRAWING' });
596
- } finally {
597
- setIsDrawingShape(false);
598
- setDrawPreview(null);
599
- drawStartRef.current = null;
600
- freehandPointsRef.current = [];
601
- }
602
- }
603
-
604
- function handleAddAnother() {
605
- try {
606
- if (!state.selection) {
607
- return;
608
- }
609
- dispatch({ type: 'SAVE_ANNOTATION', annotation: buildAnnotation(state) });
610
- } catch {
611
- // no-op
612
- }
613
- }
614
-
615
- async function handleSend() {
616
- try {
617
- // The in-flight draft is part of the send — copying from the panel
618
- // must not require banking the draft as a separate step first.
619
- const current = stateRef.current;
620
- const annotations = current.selection
621
- ? [...current.batch, buildAnnotation(current)]
622
- : current.batch;
623
- if (current.sending || annotations.length === 0) {
624
- return;
625
- }
626
- dispatch({ type: 'SEND_START' });
627
- const batch = buildBatch({
628
- annotations,
629
- includeScreenshot: current.includeScreenshot,
630
- page,
631
- });
632
- // Capture the annotated screenshot in THIS tab — the pixels the
633
- // developer is actually looking at (theme, loaded data) — and ship it
634
- // with the batch for the server to save. On failure the field is
635
- // absent and the server falls back to its headless capture.
636
- if (current.includeScreenshot) {
637
- const screenshot = await captureTabScreenshot({ annotations });
638
- if (screenshot) {
639
- batch.screenshot = screenshot;
640
- }
641
- }
642
- // The server enriches annotations with yaml file:line locations and
643
- // returns the agent-readable text; the clipboard is the delivery
644
- // channel — the developer pastes it into whichever agent session
645
- // they choose.
646
- const formatted = await sendFeedback({ basePath, batch });
647
- if (formatted === null) {
648
- dispatch({
649
- type: 'SEND_ERROR',
650
- error: 'Could not format annotations. Check the dev server and try again.',
651
- });
652
- return;
653
- }
654
- const copied = await copyToClipboard({ text: formatted });
655
- if (copied) {
656
- dispatch({ type: 'SEND_SUCCESS' });
657
- } else {
658
- dispatch({
659
- type: 'SEND_ERROR',
660
- error: 'Could not copy to clipboard. Click the page once, then try again.',
661
- });
662
- }
663
- } catch {
664
- dispatch({
665
- type: 'SEND_ERROR',
666
- error: 'Could not copy annotations. Check the dev server and try again.',
667
- });
668
- }
669
- }
670
- // Enter triggers the send via the capture handler above — a ref keeps the
671
- // freshest closure without re-binding.
672
- primarySendRef.current = handleSend;
673
-
674
- let content = null;
675
- try {
676
- content = renderOverlayContent({
677
- state,
678
- dispatch,
679
- textareaRef,
680
- handleAddAnother,
681
- handleSend,
682
- handleDrawPointerDown,
683
- handleDrawPointerMove,
684
- handleDrawPointerUp,
685
- drawPreview,
686
- });
687
- } catch {
688
- content = null;
689
- }
690
- // Portal to document.body so the overlay is a top-level sibling of the app
691
- // root. Rendered inline it inherits the app root's stacking context, and an
692
- // open antd modal (portalled to body, zIndex ~1000) then paints above the
693
- // overlay regardless of its own zIndex — making the comment textarea
694
- // unclickable. As a body sibling its zIndex competes in the root stacking
695
- // context and wins.
696
- if (typeof document === 'undefined' || !document.body) {
697
- return content;
698
- }
699
- return createPortal(content, document.body);
700
- }
701
-
702
- // Pure render function kept outside the hook-bearing component body so a
703
- // rendering bug can be caught by the try/catch above without affecting hook
704
- // call order.
705
- function renderOverlayContent({
706
- state,
707
- dispatch,
708
- textareaRef,
709
- handleAddAnother,
710
- handleSend,
711
- handleDrawPointerDown,
712
- handleDrawPointerMove,
713
- handleDrawPointerUp,
714
- drawPreview,
715
- }) {
716
- const showHighlightHover = state.phase === 'picking' && state.hoverBlock && state.hoverBlock.rect;
717
- const showSelection =
718
- (state.phase === 'annotating' || state.phase === 'drawing') &&
719
- state.selection &&
720
- state.selection.rect;
721
- const showAnnotatingPanel =
722
- (state.phase === 'annotating' || state.phase === 'drawing') && state.selection;
723
- const showSvg = state.phase === 'drawing';
724
- // Annotations banked via "Add another" — visible while picking the next
725
- // element so they stay reviewable/removable without a separate step.
726
- const showPendingTray = state.phase === 'picking' && state.batch.length > 0;
727
- const showSent = state.phase === 'sent';
728
- // The panel's send includes the in-flight draft on top of the banked batch.
729
- const draftSendCount = state.batch.length + 1;
730
- let draftSendLabel = draftSendCount > 1 ? `Copy ${draftSendCount} for agent` : 'Copy for agent';
731
- if (state.sending) {
732
- draftSendLabel = 'Copying…';
733
- }
734
-
735
- return (
736
- <div data-lowdefy-feedback style={overlayContainer}>
737
- {showHighlightHover && (
738
- <div
739
- style={{
740
- ...highlightBox,
741
- top: state.hoverBlock.rect.top,
742
- left: state.hoverBlock.rect.left,
743
- width: state.hoverBlock.rect.width,
744
- height: state.hoverBlock.rect.height,
745
- }}
746
- >
747
- <span style={labelChip}>{state.hoverBlock.blockId}</span>
748
- </div>
749
- )}
750
-
751
- {showSelection && (
752
- <div
753
- style={{
754
- ...selectedHighlightBox,
755
- top: state.selection.rect.top,
756
- left: state.selection.rect.left,
757
- width: state.selection.rect.width,
758
- height: state.selection.rect.height,
759
- }}
760
- >
761
- <span style={selectedLabelChip}>{state.selection.blockId ?? 'region'}</span>
762
- </div>
763
- )}
764
-
765
- {showSvg && (
766
- <svg
767
- style={{ ...svgLayer, pointerEvents: 'auto' }}
768
- onPointerDown={handleDrawPointerDown}
769
- onPointerMove={handleDrawPointerMove}
770
- onPointerUp={handleDrawPointerUp}
771
- >
772
- <defs>
773
- <marker
774
- id="lowdefy-feedback-arrowhead"
775
- markerWidth="10"
776
- markerHeight="10"
777
- refX="8"
778
- refY="5"
779
- orient="auto"
780
- >
781
- <polygon points="0,0 10,5 0,10" fill={colors.stroke} />
782
- </marker>
783
- </defs>
784
- {state.draftShapes.map((shape, index) => renderShape(shape, `saved-${index}`))}
785
- {drawPreview && renderShape(drawPreview, 'preview')}
786
- </svg>
787
- )}
788
-
789
- {showAnnotatingPanel && (
790
- <div style={annotatingPanel}>
791
- <div style={panelHeading}>Add feedback</div>
792
- <div style={descriptorRow}>
793
- {state.selection.tag ? `<${state.selection.tag}> ` : ''}
794
- {state.selection.blockId ? `#${state.selection.blockId}` : '(region)'}
795
- {state.selection.text ? ` — "${state.selection.text}"` : ''}
796
- </div>
797
- <textarea
798
- ref={textareaRef}
799
- style={textareaStyle}
800
- placeholder="What's wrong, or what should change?"
801
- value={state.draftComment}
802
- onChange={(event) => dispatch({ type: 'SET_COMMENT', comment: event.target.value })}
803
- />
804
- <div style={toolRow}>
805
- {['rect', 'arrow', 'freehand'].map((tool) => (
806
- <button
807
- key={tool}
808
- type="button"
809
- style={toolButtonStyle(state.phase === 'drawing' && state.draftTool === tool)}
810
- onClick={() => dispatch({ type: 'START_DRAWING', tool })}
811
- >
812
- {TOOL_LABELS[tool]}
813
- </button>
814
- ))}
815
- </div>
816
- {state.draftShapes.length > 0 && (
817
- <div style={descriptorRow}>{state.draftShapes.length} shape(s) drawn</div>
818
- )}
819
- <label style={consoleCountRow}>
820
- <input
821
- checked={state.includeScreenshot}
822
- onChange={() => dispatch({ type: 'TOGGLE_SCREENSHOT' })}
823
- style={{ marginRight: 6, verticalAlign: 'middle' }}
824
- type="checkbox"
825
- />
826
- Include annotated screenshot
827
- </label>
828
- {state.sendError && <div style={errorRow}>{state.sendError}</div>}
829
- <div style={buttonRow}>
830
- <button
831
- type="button"
832
- style={secondaryButton}
833
- onClick={() => dispatch({ type: 'DISCARD_DRAFT' })}
834
- >
835
- Cancel
836
- </button>
837
- <button type="button" style={secondaryButton} onClick={handleAddAnother}>
838
- Add another
839
- </button>
840
- <button
841
- type="button"
842
- style={primaryButton}
843
- disabled={state.sending}
844
- onClick={handleSend}
845
- >
846
- {draftSendLabel}
847
- </button>
848
- </div>
849
- </div>
850
- )}
851
-
852
- {showPendingTray && (
853
- <div style={reviewTray}>
854
- <div style={panelHeading}>Pending feedback ({state.batch.length})</div>
855
- {state.batch.map((annotation, index) => (
856
- <div key={annotation.id} style={reviewItem}>
857
- <div>
858
- <div>
859
- {index + 1}. {annotation.target?.blockId ?? 'region'}
860
- </div>
861
- <div style={{ color: colors.textMuted }}>
862
- {(annotation.comment ?? '').split('\n')[0].slice(0, 80) || '(no comment)'}
863
- </div>
864
- <div style={{ color: colors.textMuted, fontSize: 11 }}>
865
- {annotation.geometry.shapes.length} shape(s)
866
- </div>
867
- </div>
868
- <button
869
- type="button"
870
- style={reviewItemRemove}
871
- aria-label="Remove annotation"
872
- onClick={() => dispatch({ type: 'REMOVE_FROM_BATCH', id: annotation.id })}
873
- >
874
- ✕
875
- </button>
876
- </div>
877
- ))}
878
- {state.sendError && <div style={errorRow}>{state.sendError}</div>}
879
- <div style={buttonRow}>
880
- <button
881
- type="button"
882
- style={dangerButton}
883
- onClick={() => dispatch({ type: 'DISCARD_ALL' })}
884
- >
885
- Discard all
886
- </button>
887
- <button
888
- type="button"
889
- style={primaryButton}
890
- disabled={state.sending}
891
- onClick={handleSend}
892
- >
893
- {state.sending ? 'Copying…' : `Copy ${state.batch.length} for agent`}
894
- </button>
895
- </div>
896
- </div>
897
- )}
898
-
899
- {showSent && <div style={sentBanner}>Copied to clipboard ✓ — paste into your agent</div>}
900
- </div>
901
- );
902
- }
903
-
904
- export default FeedbackOverlay;