catalyst-core 0.3.0-beta.4 → 0.3.0-canary.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (316) hide show
  1. package/changelog.md +80 -0
  2. package/dist/errors/generateDocs.js +100 -0
  3. package/dist/errors/index.js +243 -0
  4. package/dist/errors/registry.js +483 -0
  5. package/dist/errors-index.json +506 -0
  6. package/dist/globals.d.ts +62 -0
  7. package/dist/index.d.ts +5 -0
  8. package/dist/index.jsx +5 -8
  9. package/dist/logger.js +1 -1
  10. package/dist/native/androidProject/app/build.gradle.kts +142 -7
  11. package/dist/native/androidProject/app/src/main/AndroidManifest.xml +4 -0
  12. package/dist/native/androidProject/app/src/main/java/io/yourname/androidproject/NativeBridge.kt +2 -2
  13. package/dist/native/androidProject/app/src/main/java/io/yourname/androidproject/camera/BarcodeDetector.kt +3 -0
  14. package/dist/native/androidProject/app/src/main/java/io/yourname/androidproject/camera/CameraSessionManager.kt +3 -0
  15. package/dist/native/androidProject/app/src/main/java/io/yourname/androidproject/utils/FrameworkServerUtils.kt +43 -8
  16. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/BridgeUtilsTest.kt +181 -1
  17. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/CameraUtilsTest.kt +156 -236
  18. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/FileSizeRouterUtilsTest.kt +471 -0
  19. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/FileUtilsTest.kt +222 -226
  20. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/FrameworkServerUtilsTest.kt +300 -0
  21. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/IntentUtilsTest.kt +244 -0
  22. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/MetricsMonitorTest.kt +359 -0
  23. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/NativeBridgeTest.kt +108 -63
  24. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/NotificationUtilsTest.kt +329 -385
  25. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/OfflineCacheServiceTest.kt +302 -0
  26. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/PerfEventBufferTest.kt +133 -0
  27. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/UtilsKtTest.kt +152 -0
  28. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/WebCacheManagerTest.kt +145 -324
  29. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/camera/BarcodeDetectorTest.kt +132 -0
  30. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/camera/HoldControllerTest.kt +155 -0
  31. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/camera/TorchControllerTest.kt +150 -0
  32. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/camera/VideoStreamStateMachineTest.kt +120 -0
  33. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/camera/VideoStreamStateTest.kt +62 -0
  34. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/camera/ViewfinderMapperTest.kt +143 -0
  35. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/camera/ZoomControllerTest.kt +421 -0
  36. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/design/DesignTokensTest.kt +207 -0
  37. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/plugins/PluginBridgeTest.kt +368 -0
  38. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/security/FridaDetectorTest.kt +193 -0
  39. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/security/SecurityCheckManagerTest.kt +260 -0
  40. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/security/SecurityCheckSchedulerTest.kt +166 -0
  41. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/utils/DeviceInfoUtilsTest.kt +167 -0
  42. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/utils/DownloadUtilsTest.kt +197 -0
  43. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/utils/NetworkMonitorTest.kt +271 -0
  44. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/utils/PushNotificationUtilsTest.kt +119 -0
  45. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/utils/SafeAreaUtilsTest.kt +108 -0
  46. package/dist/native/androidProject/build.gradle.kts +1 -0
  47. package/dist/native/androidProject/gradle/libs.versions.toml +26 -0
  48. package/dist/native/androidProject/settings.gradle.kts +11 -8
  49. package/dist/native/androidSetup.js +2 -2
  50. package/dist/native/bridge/WebBridge.d.ts +98 -0
  51. package/dist/native/bridge/WebBridge.js +40 -6
  52. package/dist/native/bridge/constants/NativeInterfaces.d.ts +391 -0
  53. package/dist/native/bridge/errors.d.ts +67 -0
  54. package/dist/native/bridge/errors.js +66 -151
  55. package/dist/native/bridge/hooks/index.d.ts +13 -0
  56. package/dist/native/bridge/hooks/index.js +0 -6
  57. package/dist/native/bridge/hooks/useAI.d.ts +1 -0
  58. package/dist/native/bridge/hooks/useAI.js +3 -1
  59. package/dist/native/bridge/hooks/useCamera.d.ts +86 -0
  60. package/dist/native/bridge/hooks/useCamera.js +35 -6
  61. package/dist/native/bridge/hooks/useDataProtection.d.ts +17 -0
  62. package/dist/native/bridge/hooks/useDeviceInfo.d.ts +34 -0
  63. package/dist/native/bridge/hooks/useDeviceInfo.js +5 -0
  64. package/dist/native/bridge/hooks/useFilePicker.d.ts +53 -0
  65. package/dist/native/bridge/hooks/useFilePicker.js +13 -0
  66. package/dist/native/bridge/hooks/useGoogleSignIn.d.ts +12 -0
  67. package/dist/native/bridge/hooks/useHapticFeedback.d.ts +76 -0
  68. package/dist/native/bridge/hooks/useHapticFeedback.js +6 -1
  69. package/dist/native/bridge/hooks/useIntent.d.ts +33 -0
  70. package/dist/native/bridge/hooks/useIntent.js +2 -0
  71. package/dist/native/bridge/hooks/useNativeTransition.d.ts +53 -0
  72. package/dist/native/bridge/hooks/useNativeTransition.js +14 -7
  73. package/dist/native/bridge/hooks/useNetworkStatus.d.ts +22 -0
  74. package/dist/native/bridge/hooks/useNetworkStatus.js +7 -0
  75. package/dist/native/bridge/hooks/useNotification.d.ts +83 -0
  76. package/dist/native/bridge/hooks/useNotification.js +81 -34
  77. package/dist/native/bridge/hooks/useSafeArea.d.ts +12 -0
  78. package/dist/native/bridge/hooks/useSafeArea.js +8 -0
  79. package/dist/native/bridge/hooks/useVideoStream.d.ts +67 -0
  80. package/dist/native/bridge/hooks/useVideoStream.js +38 -52
  81. package/dist/native/bridge/hooks/utils.d.ts +4 -0
  82. package/dist/native/bridge/hooks.d.ts +1 -0
  83. package/dist/native/bridge/perf/collectors/ApiCollector.d.ts +30 -0
  84. package/dist/native/bridge/perf/collectors/ApiCollector.js +4 -0
  85. package/dist/native/bridge/perf/collectors/CacheCollector.d.ts +43 -0
  86. package/dist/native/bridge/perf/collectors/CacheCollector.js +4 -0
  87. package/dist/native/bridge/perf/collectors/HookCollector.d.ts +37 -0
  88. package/dist/native/bridge/perf/collectors/HookCollector.js +4 -0
  89. package/dist/native/bridge/perf/collectors/InsightsCollector.d.ts +103 -0
  90. package/dist/native/bridge/perf/collectors/InsightsCollector.js +4 -0
  91. package/dist/native/bridge/perf/collectors/InteractionCollector.d.ts +53 -0
  92. package/dist/native/bridge/perf/collectors/InteractionCollector.js +4 -0
  93. package/dist/native/bridge/perf/collectors/KeyboardCollector.d.ts +30 -0
  94. package/dist/native/bridge/perf/collectors/KeyboardCollector.js +4 -0
  95. package/dist/native/bridge/perf/collectors/NavigationCollector.d.ts +37 -0
  96. package/dist/native/bridge/perf/collectors/NavigationCollector.js +4 -0
  97. package/dist/native/bridge/perf/collectors/NetworkTimingCollector.d.ts +30 -0
  98. package/dist/native/bridge/perf/collectors/NetworkTimingCollector.js +4 -0
  99. package/dist/native/bridge/perf/collectors/RenderCollector.d.ts +47 -0
  100. package/dist/native/bridge/perf/collectors/RenderCollector.js +8 -0
  101. package/dist/native/bridge/perf/collectors/ScrollCollector.d.ts +29 -0
  102. package/dist/native/bridge/perf/collectors/ScrollCollector.js +4 -0
  103. package/dist/native/bridge/perf/collectors/ThreadCollector.d.ts +31 -0
  104. package/dist/native/bridge/perf/collectors/ThreadCollector.js +4 -0
  105. package/dist/native/bridge/perf/core/constants.d.ts +76 -0
  106. package/dist/native/bridge/perf/core/measure.d.ts +39 -0
  107. package/dist/native/bridge/perf/core/measure.js +4 -0
  108. package/dist/native/bridge/perf/core/session.d.ts +49 -0
  109. package/dist/native/bridge/perf/core/session.js +4 -0
  110. package/dist/native/bridge/perf/core/store.d.ts +37 -0
  111. package/dist/native/bridge/perf/core/store.js +4 -0
  112. package/dist/native/bridge/perf/core/summary.d.ts +60 -0
  113. package/dist/native/bridge/perf/core/traceExport.d.ts +10 -0
  114. package/dist/native/bridge/perf/core/waterfalls.d.ts +2 -0
  115. package/dist/native/bridge/perf/index.d.ts +63 -0
  116. package/dist/native/bridge/perf/index.js +4 -0
  117. package/dist/native/bridge/safeArea.d.ts +11 -0
  118. package/dist/native/bridge/safeArea.js +2 -0
  119. package/dist/native/bridge/useBaseHook.d.ts +137 -0
  120. package/dist/native/bridge/useBaseHook.js +34 -4
  121. package/dist/native/bridge/utils/CameraUtils.d.ts +94 -0
  122. package/dist/native/bridge/utils/CameraUtils.js +4 -0
  123. package/dist/native/bridge/utils/FileObjectConverter.d.ts +36 -0
  124. package/dist/native/bridge/utils/NativeBridge.d.ts +270 -0
  125. package/dist/native/bridge/utils/NativeBridge.js +10 -0
  126. package/dist/native/buildAndroid/index.js +1 -1
  127. package/dist/native/buildAppAndroid.js +9 -0
  128. package/dist/native/buildAppIos.js +16 -1
  129. package/dist/native/buildErrorFormat.js +57 -0
  130. package/dist/native/buildIos/config.js +15 -1
  131. package/dist/native/buildIos/index.js +1 -1
  132. package/dist/native/buildIos/plugins.js +10 -1
  133. package/dist/native/iosnativeWebView/CoreLogic/Package.swift +36 -0
  134. package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Camera/VideoStreamState.swift +1 -1
  135. package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Camera/VideoStreamStateMachine.swift +6 -4
  136. package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Utils/BootTimingUtility.swift +3 -3
  137. package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Utils/FrameworkServerUtils.swift +14 -9
  138. package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Utils/NetworkMonitor.swift +11 -9
  139. package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Utils/NotificationHandlerProvider.swift +1 -1
  140. package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Utils/URLWhitelistManager.swift +7 -7
  141. package/dist/native/iosnativeWebView/CoreLogic/Tests/CatalystCoreLogicTests/AnyCodableTests.swift +154 -0
  142. package/dist/native/iosnativeWebView/{iosnativeWebViewTests → CoreLogic/Tests/CatalystCoreLogicTests}/BootTimingUtilityTests.swift +23 -5
  143. package/dist/native/iosnativeWebView/CoreLogic/Tests/CatalystCoreLogicTests/CatalystConstantsTests.swift +192 -0
  144. package/dist/native/iosnativeWebView/{iosnativeWebViewTests → CoreLogic/Tests/CatalystCoreLogicTests}/ConfigMappingTests.swift +1 -1
  145. package/dist/native/iosnativeWebView/CoreLogic/Tests/CatalystCoreLogicTests/FrameworkServerUtilsErrorPathTests.swift +106 -0
  146. package/dist/native/iosnativeWebView/CoreLogic/Tests/CatalystCoreLogicTests/FrameworkServerUtilsLoopbackTests.swift +243 -0
  147. package/dist/native/iosnativeWebView/{iosnativeWebViewTests → CoreLogic/Tests/CatalystCoreLogicTests}/FrameworkServerUtilsTests.swift +1 -1
  148. package/dist/native/iosnativeWebView/CoreLogic/Tests/CatalystCoreLogicTests/NetworkMonitorTests.swift +119 -0
  149. package/dist/native/iosnativeWebView/CoreLogic/Tests/CatalystCoreLogicTests/NotificationHandlerProviderTests.swift +59 -0
  150. package/dist/native/iosnativeWebView/{iosnativeWebViewTests → CoreLogic/Tests/CatalystCoreLogicTests}/NotificationHandlerTests.swift +1 -1
  151. package/dist/native/iosnativeWebView/{iosnativeWebViewTests → CoreLogic/Tests/CatalystCoreLogicTests}/URLWhitelistManagerTests.swift +1 -1
  152. package/dist/native/iosnativeWebView/CoreLogic/Tests/CatalystCoreLogicTests/VideoStreamStateMachineTests.swift +171 -0
  153. package/dist/native/iosnativeWebView/CoreLogic/Tests/CatalystCoreLogicTests/VideoStreamStateTests.swift +91 -0
  154. package/dist/native/iosnativeWebView/Package.swift +10 -9
  155. package/dist/native/iosnativeWebView/Sources/CatalystNotifications/LocalNotificationHandler.swift +7 -2
  156. package/dist/native/iosnativeWebView/Sources/CatalystNotifications/NotificationManager.swift +1 -2
  157. package/dist/native/iosnativeWebView/Sources/CatalystNotifications/PushNotificationHandler.swift +5 -4
  158. package/dist/native/iosnativeWebView/Sources/Core/Camera/CameraSessionManager.swift +1 -0
  159. package/dist/native/iosnativeWebView/Sources/Core/Camera/HoldController.swift +1 -0
  160. package/dist/native/iosnativeWebView/Sources/Core/Camera/NativeCameraManager.swift +6 -5
  161. package/dist/native/iosnativeWebView/Sources/Core/Camera/ZoomController.swift +1 -0
  162. package/dist/native/iosnativeWebView/Sources/Core/Plugins/PluginBridge.swift +1 -0
  163. package/dist/native/iosnativeWebView/Sources/Core/Utils/CacheManager.swift +31 -30
  164. package/dist/native/iosnativeWebView/Sources/Core/Utils/CameraTransportUtils.swift +2 -1
  165. package/dist/native/iosnativeWebView/Sources/Core/Utils/DeviceInfoUtils.swift +1 -1
  166. package/dist/native/iosnativeWebView/Sources/Core/Utils/FilePickerHandler.swift +22 -19
  167. package/dist/native/iosnativeWebView/Sources/Core/Utils/ImageHandler.swift +40 -39
  168. package/dist/native/iosnativeWebView/Sources/Core/Utils/PerfEventBuffer.swift +1 -0
  169. package/dist/native/iosnativeWebView/Sources/Core/Utils/ResourceURLProtocol.swift +15 -15
  170. package/dist/native/iosnativeWebView/Sources/Core/Utils/WebKitConfig.swift +4 -3
  171. package/dist/native/iosnativeWebView/Sources/Core/WebView/BridgeCommandHandler.swift +6 -1
  172. package/dist/native/iosnativeWebView/Sources/Core/WebView/BridgeDelegateHandler.swift +1 -0
  173. package/dist/native/iosnativeWebView/Sources/Core/WebView/BridgeFileHandler.swift +2 -1
  174. package/dist/native/iosnativeWebView/Sources/Core/WebView/BridgeJavaScriptInterface.swift +2 -1
  175. package/dist/native/iosnativeWebView/Sources/Core/WebView/BridgeMessageValidator.swift +3 -5
  176. package/dist/native/iosnativeWebView/Sources/Core/WebView/NativeBridge.swift +20 -13
  177. package/dist/native/iosnativeWebView/Sources/Core/WebView/SplashView.swift +6 -5
  178. package/dist/native/iosnativeWebView/Sources/Core/WebView/SplashViewModel.swift +14 -13
  179. package/dist/native/iosnativeWebView/Sources/Core/WebView/TransitionManager.swift +3 -3
  180. package/dist/native/iosnativeWebView/Sources/Core/WebView/WebView.swift +9 -8
  181. package/dist/native/iosnativeWebView/Sources/Core/WebView/WebViewModel.swift +7 -6
  182. package/dist/native/iosnativeWebView/Sources/Core/WebView/WebViewNavigationDelegate.swift +24 -25
  183. package/dist/native/iosnativeWebView/iosnativeWebView/AppDelegate.swift +6 -1
  184. package/dist/native/iosnativeWebView/iosnativeWebView/ContentView.swift +1 -0
  185. package/dist/native/iosnativeWebView/iosnativeWebView/iosnativeWebViewApp.swift +4 -0
  186. package/dist/native/iosnativeWebView/iosnativeWebView.xcodeproj/project.pbxproj +2 -22
  187. package/dist/native/iosnativeWebView/iosnativeWebViewTests/BridgeMessageValidatorTests.swift +1 -0
  188. package/dist/native/iosnativeWebView/iosnativeWebViewTests/CacheManagerTests.swift +1 -0
  189. package/dist/native/iosnativeWebView/iosnativeWebViewTests/FilePickerHandlerTests.swift +2 -1
  190. package/dist/native/iosnativeWebView/iosnativeWebViewTests/NativeBridgeTests.swift +15 -9
  191. package/dist/native/iosnativeWebView/iosnativeWebViewTests/WebViewTests.swift +1 -0
  192. package/dist/native/setupEmulatorIos.js +2 -2
  193. package/dist/native/terminalProgress.js +17 -17
  194. package/dist/router/ClientRouter.d.ts +8 -0
  195. package/dist/router/ClientRouter.js +13 -11
  196. package/dist/router/ServerRouter.d.ts +13 -0
  197. package/dist/router/ServerRouter.js +19 -7
  198. package/dist/scripts/build.js +14 -2
  199. package/dist/scripts/loadEnvironmentVariables.js +3 -2
  200. package/dist/scripts/plugins.js +1 -1
  201. package/dist/scripts/preServerInit.js +49 -3
  202. package/dist/scripts/preflight.js +111 -0
  203. package/dist/scripts/scriptUtils.js +46 -1
  204. package/dist/scripts/serve.js +7 -1
  205. package/dist/scripts/start.js +8 -1
  206. package/dist/server/expressServer.d.ts +1 -0
  207. package/dist/server/expressServer.js +247 -271
  208. package/dist/server/manifestCache.d.ts +2 -0
  209. package/dist/server/manifestCache.js +25 -33
  210. package/dist/server/renderer/ChunkExtractor.d.ts +44 -0
  211. package/dist/server/renderer/ChunkExtractor.js +113 -125
  212. package/dist/server/renderer/document/Body.d.ts +21 -0
  213. package/dist/server/renderer/document/Body.jsx +45 -45
  214. package/dist/server/renderer/document/FastRefresh.d.ts +3 -0
  215. package/dist/server/renderer/document/FastRefresh.jsx +7 -13
  216. package/dist/server/renderer/document/Head.d.ts +20 -0
  217. package/dist/server/renderer/document/Head.jsx +32 -32
  218. package/dist/server/renderer/document/index.d.ts +2 -0
  219. package/dist/server/renderer/document/index.jsx +2 -2
  220. package/dist/server/renderer/extract.d.ts +67 -0
  221. package/dist/server/renderer/extract.js +92 -89
  222. package/dist/server/renderer/handler.d.ts +2 -0
  223. package/dist/server/renderer/handler.jsx +401 -404
  224. package/dist/server/renderer/index.d.ts +2 -0
  225. package/dist/server/renderer/index.js +5 -8
  226. package/dist/server/renderer/render.d.ts +35 -0
  227. package/dist/server/renderer/render.js +33 -32
  228. package/dist/server/utils/botDetectionMiddleware.d.ts +1 -0
  229. package/dist/server/utils/botDetectionMiddleware.js +33 -23
  230. package/dist/server/utils/cjsRequire.d.ts +8 -0
  231. package/dist/server/utils/cjsRequire.js +2 -2
  232. package/dist/server/utils/userAgentUtil.d.ts +7 -0
  233. package/dist/server/utils/userAgentUtil.js +68 -71
  234. package/dist/server/utils/validator.d.ts +31 -0
  235. package/dist/server/utils/validator.js +133 -158
  236. package/dist/vite/inject-cache-key-plugin.js +3 -27
  237. package/dist/vite/moduleAliases.js +36 -0
  238. package/dist/vite/node-loader.mjs +2 -29
  239. package/dist/vite/resolveDevServerConfig.js +4 -1
  240. package/dist/vite/vite.config.js +13 -31
  241. package/dist/web-router/components/MetaTag.d.ts +4 -0
  242. package/dist/web-router/components/MetaTag.jsx +26 -28
  243. package/dist/web-router/components/MetaTag.test.jsx +100 -0
  244. package/dist/web-router/components/RouterDataProvider.d.ts +96 -0
  245. package/dist/web-router/components/RouterDataProvider.jsx +260 -259
  246. package/dist/web-router/components/RouterDataProvider.server.test.jsx +98 -0
  247. package/dist/web-router/components/RouterDataProvider.test.jsx +310 -0
  248. package/dist/web-router/components/Split.d.ts +74 -0
  249. package/dist/web-router/components/Split.jsx +147 -156
  250. package/dist/web-router/components/Split.server.test.jsx +52 -0
  251. package/dist/web-router/components/Split.test.jsx +167 -0
  252. package/dist/web-router/components/SplitInview.d.ts +22 -0
  253. package/dist/web-router/components/SplitInview.jsx +78 -89
  254. package/dist/web-router/components/SplitInview.test.jsx +112 -0
  255. package/dist/web-router/components/SsrRequestContext.d.ts +20 -0
  256. package/dist/web-router/components/SsrRequestContext.jsx +17 -7
  257. package/dist/web-router/components/SsrRequestContext.test.jsx +53 -0
  258. package/dist/web-router/context.d.ts +15 -0
  259. package/dist/web-router/context.jsx +5 -5
  260. package/dist/web-router/context.test.jsx +10 -0
  261. package/dist/web-router/utils/metaDataUtils.d.ts +24 -0
  262. package/dist/web-router/utils/metaDataUtils.jsx +86 -86
  263. package/dist/web-router/utils/metaDataUtils.test.jsx +188 -0
  264. package/dist/web-router/vitest.setup.js +12 -0
  265. package/mcp_v2/knowledge-base.json +52 -8
  266. package/mcp_v2/mcp.js +140 -3
  267. package/mcp_v2/package-lock.json +2031 -0
  268. package/mcp_v2/package.json +13 -2
  269. package/mcp_v2/scripts/copyErrorsIndex.cjs +34 -0
  270. package/mcp_v2/test/errors.test.ts +123 -0
  271. package/mcp_v2/test/github.test.ts +177 -0
  272. package/mcp_v2/tools/errors.d.ts +20 -0
  273. package/mcp_v2/tools/errors.js +63 -0
  274. package/mcp_v2/tools/github.d.ts +41 -0
  275. package/mcp_v2/tools/github.js +231 -0
  276. package/mcp_v2/vitest.config.mjs +22 -0
  277. package/package.json +60 -11
  278. package/test/errors/docsDrift.test.ts +113 -0
  279. package/test/errors/index.test.ts +200 -0
  280. package/test/errors/registry.test.ts +108 -0
  281. package/test/scripts/preflight.test.ts +121 -0
  282. package/test/server/ChunkExtractor.test.ts +97 -0
  283. package/test/server/extract.test.ts +128 -0
  284. package/test/server/fixtures/template/server/document.jsx +19 -0
  285. package/test/server/fixtures/template/server/index.js +10 -0
  286. package/test/server/fixtures/template/src/js/containers/App/index.jsx +33 -0
  287. package/test/server/fixtures/template/src/js/routes/index.jsx +72 -0
  288. package/test/server/fixtures/template/src/js/routes/utils.jsx +39 -0
  289. package/test/server/fixtures/template/src/js/store/index.js +19 -0
  290. package/test/server/handler.assets.test.ts +331 -0
  291. package/test/server/handler.test.ts +210 -0
  292. package/test/server/manifestCache.test.ts +71 -0
  293. package/test/server/render.test.ts +90 -0
  294. package/test/server/scriptUtils.test.ts +103 -0
  295. package/test/server/userAgentUtil.test.ts +48 -0
  296. package/test/server/validator.test.ts +228 -0
  297. package/test/vite/resolveDevServerConfig.test.js +4 -1
  298. package/tsconfig.test.json +23 -0
  299. package/vitest.config.ts +93 -0
  300. package/dist/caching.js +0 -1
  301. package/dist/native/androidProject/app/src/test/java/io/yourname/androidproject/DeviceInfoUtilsTest.kt +0 -187
  302. package/dist/native/bridge/standardizedHooks.js +0 -611
  303. package/dist/router.js +0 -1
  304. package/dist/scripts/validator.js +0 -149
  305. package/dist/web-router/hooks.jsx +0 -72
  306. package/dist/web-router/types/components/MetaTag.d.ts +0 -2
  307. package/dist/web-router/types/components/RouterDataProvider.d.ts +0 -95
  308. package/dist/web-router/types/context.d.ts +0 -14
  309. package/dist/web-router/types/hooks.d.ts +0 -1
  310. package/dist/web-router/types/index.d.ts +0 -3
  311. package/dist/web-router/types/utils/metaDataUtils.d.ts +0 -24
  312. /package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Constants/CatalystConstants.swift +0 -0
  313. /package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Constants/ConfigConstants.swift +0 -0
  314. /package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Notifications/NotificationModels.swift +0 -0
  315. /package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Protocols/NotificationHandlerProtocol.swift +0 -0
  316. /package/dist/native/iosnativeWebView/{Sources/Core → CoreLogic/Sources/CatalystCoreLogic}/Utils/NullNotificationHandler.swift +0 -0
@@ -1,119 +1,119 @@
1
- import React from "react"
1
+ import React from "react";
2
2
  /**
3
3
  * Merges multiple lists of head elements, ensuring that later lists override earlier ones in case of duplicates.
4
4
  * Handles all types of head elements, including title, meta, link, etc.
5
5
  *
6
- * @param {...Array<JSX.Element>} lists - Multiple lists of JSX head elements, where the first argument is the parent and the rest are children in order.
7
- * @returns {Array<JSX.Element>} - The combined list with later lists overriding duplicates from earlier ones.
6
+ * @param lists - Multiple lists of JSX head elements, where the first argument is the parent and the rest are children in order.
7
+ * @returns The combined list with later lists overriding duplicates from earlier ones.
8
8
  */
9
9
  export function mergeHeadElements(...lists) {
10
- const elementMap = new Map()
10
+ const elementMap = new Map();
11
11
 
12
- /**
13
- * Function to get a unique key for a head element based on its type and attributes.
14
- * @param {JSX.Element} element - The head element from which to derive a key.
15
- * @returns {string} - A unique key representing the element.
16
- */
17
- const getKey = (element) => {
18
- const { type, props } = element
19
-
20
- if (type === "title") {
21
- return "title" // Only one title should exist in a document
22
- }
12
+ /**
13
+ * Function to get a unique key for a head element based on its type and attributes.
14
+ * @param element - The head element from which to derive a key.
15
+ * @returns A unique key representing the element.
16
+ */
17
+ const getKey = element => {
18
+ const {
19
+ type,
20
+ props
21
+ } = element;
22
+ if (type === "title") {
23
+ return "title"; // Only one title should exist in a document
24
+ }
23
25
 
24
- // For meta tags, use 'name' or 'property' as unique identifiers
25
- if (type === "meta") {
26
- if (props.charset) {
27
- return "charset" // Charset should be unique in a document
28
- }
29
- return props.name || props.property || props["http-equiv"] || props.httpEquiv || ""
30
- }
26
+ // For meta tags, use 'name' or 'property' as unique identifiers
27
+ if (type === "meta") {
28
+ if (props.charset) {
29
+ return "charset"; // Charset should be unique in a document
30
+ }
31
+ return props.name || props.property || props["http-equiv"] || props.httpEquiv || "";
32
+ }
31
33
 
32
- // For link tags, use 'rel' as a unique identifier
33
- // if (type === "link") {
34
- // return props.rel || "";
35
- // }
34
+ // For link tags, use 'rel' as a unique identifier
35
+ // if (type === "link") {
36
+ // return props.rel || "";
37
+ // }
36
38
 
37
- // Create a unique representation for other types of elements
38
- return `${type}:${Object.entries(props)
39
- .map(([key, value]) => `${key}=${value}`)
40
- .join(",")}`
41
- }
39
+ // Create a unique representation for other types of elements
40
+ return `${type}:${Object.entries(props).map(([key, value]) => `${key}=${value}`).join(",")}`;
41
+ };
42
42
 
43
- // Loop through all the lists, ensuring later lists override earlier ones
44
- lists?.forEach((list) => {
45
- list?.forEach((element) => {
46
- const key = getKey(element)
47
- if (key) {
48
- elementMap.set(key, element) // Overwrite earlier elements with later ones
49
- }
50
- })
51
- })
43
+ // Loop through all the lists, ensuring later lists override earlier ones
44
+ lists?.forEach(list => {
45
+ list?.forEach(element => {
46
+ const key = getKey(element);
47
+ if (key) {
48
+ elementMap.set(key, element); // Overwrite earlier elements with later ones
49
+ }
50
+ });
51
+ });
52
52
 
53
- // Return the combined list of head elements
54
- return Array.from(elementMap.values())
53
+ // Return the combined list of head elements
54
+ return Array.from(elementMap.values());
55
55
  }
56
56
 
57
57
  /**
58
58
  * Deletes all elements in the head with a specific data attribute.
59
59
  *
60
- * @param {string} attributeName - The name of the data attribute to search for.
61
- * @param {string} [attributeValue] - The specific value of the data attribute to match (optional).
60
+ * @param attributeName - The name of the data attribute to search for.
61
+ * @param attributeValue - The specific value of the data attribute to match (optional).
62
62
  */
63
63
  export function deleteHeadTagsByDataAttribute(attributeName, attributeValue) {
64
- const head = document.head
65
- const tagsToDelete = []
64
+ const head = document.head;
65
+ const tagsToDelete = [];
66
66
 
67
- // Iterate over all children in the head section
68
- Array.from(head.children).forEach((element) => {
69
- const hasAttribute = element.hasAttribute(`data-${attributeName}`)
67
+ // Iterate over all children in the head section
68
+ Array.from(head.children).forEach(element => {
69
+ const hasAttribute = element.hasAttribute(`data-${attributeName}`);
70
70
 
71
- // If a specific attribute value is provided, check for it
72
- if (attributeValue && hasAttribute) {
73
- const matchesValue = element.getAttribute(`data-${attributeName}`) === attributeValue
74
- if (matchesValue) {
75
- tagsToDelete.push(element)
76
- }
77
- } else if (hasAttribute) {
78
- // If no specific value, just check if the attribute is present
79
- tagsToDelete.push(element)
80
- }
81
- })
71
+ // If a specific attribute value is provided, check for it
72
+ if (attributeValue && hasAttribute) {
73
+ const matchesValue = element.getAttribute(`data-${attributeName}`) === attributeValue;
74
+ if (matchesValue) {
75
+ tagsToDelete.push(element);
76
+ }
77
+ } else if (hasAttribute) {
78
+ // If no specific value, just check if the attribute is present
79
+ tagsToDelete.push(element);
80
+ }
81
+ });
82
82
 
83
- // Delete all the tags that matched the attribute condition
84
- tagsToDelete.forEach((tag) => {
85
- head.removeChild(tag)
86
- })
83
+ // Delete all the tags that matched the attribute condition
84
+ tagsToDelete.forEach(tag => {
85
+ head.removeChild(tag);
86
+ });
87
87
  }
88
88
 
89
89
  /**
90
90
  * Returns resolved array of meta data elements.
91
91
  *
92
92
  *
93
- * @param {Array<Match>} matchedRoutes - Array of all matches.
94
- * @param {Object} routeData - Data returned from Router.
95
- * @returns {Array<JSX.Element>} - List of all meta tags for the matched location.
93
+ * @param matchedRoutes - Array of all matches.
94
+ * @param routeData - Data returned from Router.
95
+ * @returns List of all meta tags for the matched location.
96
96
  */
97
97
 
98
98
  export function getMetaData(matchedRoutes, routeData) {
99
- let allTags = []
100
- try {
101
- matchedRoutes?.forEach?.((match) => {
102
- const setMetaData = match?.route?.component?.setMetaData
103
- if (setMetaData) {
104
- let tags = setMetaData(routeData)
105
- allTags = [...allTags, tags]
106
- }
107
- })
108
- if (Array.isArray(allTags) && allTags.length > 0) {
109
- let mergedTags = mergeHeadElements(...allTags)
110
- allTags = mergedTags.map((el, index) =>
111
- React.cloneElement(el, { "data-catalyst": true, key: index })
112
- )
113
- }
114
- } catch (er) {
115
- console.log("meta tags error is ===>", er)
99
+ let allTags = [];
100
+ try {
101
+ matchedRoutes?.forEach?.(match => {
102
+ const setMetaData = match?.route?.component?.setMetaData;
103
+ if (setMetaData) {
104
+ let tags = setMetaData(routeData);
105
+ allTags = [...allTags, tags];
106
+ }
107
+ });
108
+ if (Array.isArray(allTags) && allTags.length > 0) {
109
+ let mergedTags = mergeHeadElements(...allTags);
110
+ allTags = mergedTags.map((el, index) => React.cloneElement(el, {
111
+ "data-catalyst": true,
112
+ key: index
113
+ }));
116
114
  }
117
-
118
- return allTags
115
+ } catch (er) {
116
+ console.log("meta tags error is ===>", er);
117
+ }
118
+ return allTags;
119
119
  }
@@ -0,0 +1,188 @@
1
+ import React from "react"
2
+ import { describe, expect, it, vi, afterEach } from "vitest"
3
+ import { mergeHeadElements, deleteHeadTagsByDataAttribute, getMetaData } from "./metaDataUtils.jsx"
4
+
5
+ describe("mergeHeadElements", () => {
6
+ it("returns an empty array when given no lists", () => {
7
+ expect(mergeHeadElements()).toEqual([])
8
+ })
9
+
10
+ it("keeps only the last title element when multiple titles are given", () => {
11
+ const first = <title key="a">First</title>
12
+ const second = <title key="b">Second</title>
13
+ const result = mergeHeadElements([first], [second])
14
+ expect(result).toHaveLength(1)
15
+ expect(result[0].props.children).toBe("Second")
16
+ })
17
+
18
+ it("dedupes meta tags by name, keeping the later one", () => {
19
+ const first = <meta name="description" content="first" />
20
+ const second = <meta name="description" content="second" />
21
+ const result = mergeHeadElements([first], [second])
22
+ expect(result).toHaveLength(1)
23
+ expect(result[0].props.content).toBe("second")
24
+ })
25
+
26
+ it("dedupes meta tags by property when name is absent", () => {
27
+ const first = <meta property="og:title" content="first" />
28
+ const second = <meta property="og:title" content="second" />
29
+ const result = mergeHeadElements([first, second])
30
+ expect(result).toHaveLength(1)
31
+ expect(result[0].props.content).toBe("second")
32
+ })
33
+
34
+ it("treats charset meta tags as a single unique slot", () => {
35
+ const first = <meta charSet="utf-8" charset="utf-8" />
36
+ const second = <meta charSet="iso-8859-1" charset="iso-8859-1" />
37
+ const result = mergeHeadElements([first], [second])
38
+ expect(result).toHaveLength(1)
39
+ })
40
+
41
+ it("keeps distinct meta tags with different names", () => {
42
+ const description = <meta name="description" content="desc" />
43
+ const keywords = <meta name="keywords" content="kw" />
44
+ const result = mergeHeadElements([description, keywords])
45
+ expect(result).toHaveLength(2)
46
+ })
47
+
48
+ it("preserves order across multiple non-overlapping lists", () => {
49
+ const a = <meta name="a" content="1" />
50
+ const b = <meta name="b" content="2" />
51
+ const c = <meta name="c" content="3" />
52
+ const result = mergeHeadElements([a], [b], [c])
53
+ expect(result.map((el) => el.props.name)).toEqual(["a", "b", "c"])
54
+ })
55
+
56
+ it("ignores null/undefined lists mixed in with real ones", () => {
57
+ const a = <meta name="a" content="1" />
58
+ const result = mergeHeadElements(null, [a], undefined)
59
+ expect(result).toHaveLength(1)
60
+ })
61
+
62
+ it("keys non-title/non-meta elements (e.g. link) by type + serialized props, so later ones override", () => {
63
+ const first = <link rel="canonical" href="https://a.example" />
64
+ const second = <link rel="canonical" href="https://a.example" data-x="2" />
65
+ // different serialized props -> different keys -> both kept
66
+ const kept = mergeHeadElements([first], [second])
67
+ expect(kept).toHaveLength(2)
68
+
69
+ // identical props -> same key -> later overrides
70
+ const dupA = <link rel="stylesheet" href="/x.css" />
71
+ const dupB = <link rel="stylesheet" href="/x.css" />
72
+ const deduped = mergeHeadElements([dupA], [dupB])
73
+ expect(deduped).toHaveLength(1)
74
+ expect(deduped[0]).toBe(dupB)
75
+ })
76
+ })
77
+
78
+ describe("deleteHeadTagsByDataAttribute", () => {
79
+ afterEach(() => {
80
+ document.head.innerHTML = ""
81
+ })
82
+
83
+ it("removes every element carrying the given data attribute", () => {
84
+ document.head.innerHTML = `
85
+ <meta data-catalyst="true" name="a">
86
+ <meta data-catalyst="true" name="b">
87
+ <meta name="c">
88
+ `
89
+ deleteHeadTagsByDataAttribute("catalyst")
90
+ expect(document.head.querySelectorAll("[data-catalyst]")).toHaveLength(0)
91
+ expect(document.head.querySelectorAll("meta")).toHaveLength(1)
92
+ })
93
+
94
+ it("removes only elements matching a specific attribute value when given one", () => {
95
+ document.head.innerHTML = `
96
+ <meta data-catalyst="route-a" name="a">
97
+ <meta data-catalyst="route-b" name="b">
98
+ `
99
+ deleteHeadTagsByDataAttribute("catalyst", "route-a")
100
+ expect(document.head.querySelector('[data-catalyst="route-a"]')).toBeNull()
101
+ expect(document.head.querySelector('[data-catalyst="route-b"]')).not.toBeNull()
102
+ })
103
+
104
+ it("does nothing when no elements match", () => {
105
+ document.head.innerHTML = `<meta name="untouched">`
106
+ expect(() => deleteHeadTagsByDataAttribute("catalyst")).not.toThrow()
107
+ expect(document.head.querySelectorAll("meta")).toHaveLength(1)
108
+ })
109
+ })
110
+
111
+ describe("getMetaData", () => {
112
+ it("returns an empty array when matchedRoutes is undefined", () => {
113
+ expect(getMetaData(undefined, {})).toEqual([])
114
+ })
115
+
116
+ it("returns an empty array when no route defines setMetaData", () => {
117
+ const matchedRoutes = [{ route: { component: {} } }]
118
+ expect(getMetaData(matchedRoutes, {})).toEqual([])
119
+ })
120
+
121
+ it("calls each route's setMetaData with the route data and merges results", () => {
122
+ const routeData = { title: "Home" }
123
+ const matchedRoutes = [
124
+ {
125
+ route: {
126
+ component: {
127
+ setMetaData: (data) => [<title key="t">{data.title}</title>],
128
+ },
129
+ },
130
+ },
131
+ ]
132
+ const result = getMetaData(matchedRoutes, routeData)
133
+ expect(result).toHaveLength(1)
134
+ expect(result[0].props.children).toBe("Home")
135
+ })
136
+
137
+ it("stamps every returned element with data-catalyst and a stable key", () => {
138
+ const matchedRoutes = [
139
+ {
140
+ route: {
141
+ component: {
142
+ setMetaData: () => [
143
+ <meta key="a" name="a" content="1" />,
144
+ <meta key="b" name="b" content="2" />,
145
+ ],
146
+ },
147
+ },
148
+ },
149
+ ]
150
+ const result = getMetaData(matchedRoutes, {})
151
+ expect(result).toHaveLength(2)
152
+ for (const el of result) {
153
+ expect(el.props["data-catalyst"]).toBe(true)
154
+ }
155
+ })
156
+
157
+ it("merges tags from multiple matched routes, later routes winning on conflict", () => {
158
+ const matchedRoutes = [
159
+ {
160
+ route: { component: { setMetaData: () => [<meta key="a" name="shared" content="parent" />] } },
161
+ },
162
+ {
163
+ route: { component: { setMetaData: () => [<meta key="b" name="shared" content="child" />] } },
164
+ },
165
+ ]
166
+ const result = getMetaData(matchedRoutes, {})
167
+ expect(result).toHaveLength(1)
168
+ expect(result[0].props.content).toBe("child")
169
+ })
170
+
171
+ it("swallows errors from a misbehaving setMetaData and returns an empty array", () => {
172
+ const consoleSpy = vi.spyOn(console, "log").mockImplementation(() => {})
173
+ const matchedRoutes = [
174
+ {
175
+ route: {
176
+ component: {
177
+ setMetaData: () => {
178
+ throw new Error("boom")
179
+ },
180
+ },
181
+ },
182
+ },
183
+ ]
184
+ expect(() => getMetaData(matchedRoutes, {})).not.toThrow()
185
+ expect(getMetaData(matchedRoutes, {})).toEqual([])
186
+ consoleSpy.mockRestore()
187
+ })
188
+ })
@@ -0,0 +1,12 @@
1
+ import "@testing-library/jest-dom/vitest"
2
+ import { cleanup } from "@testing-library/react"
3
+ import { afterEach } from "vitest"
4
+
5
+ // RTL only auto-cleans up between tests when a test framework's globals
6
+ // are detected in a way it recognizes (works out of the box with Jest);
7
+ // under Vitest it needs to be wired explicitly, or renders from one test
8
+ // leak into the next and multi-render tests using the same testids across
9
+ // `it` blocks start finding duplicate elements.
10
+ afterEach(() => {
11
+ cleanup()
12
+ })
@@ -610,7 +610,7 @@
610
610
  {
611
611
  "section": "native_hooks",
612
612
  "title": "Native Hooks \u2014 Overview & Common Interface",
613
- "content": "All catalyst-core hooks share a standardized base interface: { data, loading, progress, error, isWeb, isNative, execute, clear, clearError }. isNative is true when running inside the native shell (Android/iOS WebView). isWeb is true on browser. All return SSR-safe stubs when window is undefined. Import from catalyst-core/hooks.\n\nWEB FALLBACK SYSTEM: Hooks that implement browser fallbacks additionally expose: { webFallbackActive: boolean, webFallbackDisabled: boolean, setWebFallback: (enabled: boolean) => void }. webFallbackActive=true means the hook is currently running its browser fallback (not native bridge). setWebFallback(false) disables the built-in fallback at runtime \u2014 React re-runs effects and cleans up side effects automatically (e.g. stops MediaStream, removes event listeners). webFallbackDisabled=true means the hook returned an inert no-op shape (all actions are no-ops, data/error/loading are null/false) \u2014 consumer must render its own UI.\n\nDYNAMIC PROP SYNC: The webFallback prop syncs dynamically after mount in all hooks (both useBaseHook consumers and thin-state hooks) via useEffect. Passing a new webFallback prop value re-evaluates webFallbackActive without remounting the component.\n\nRULES OF HOOKS: All hooks (useState, useRef, useCallback, useEffect) are always called unconditionally at top level, regardless of webFallbackActive/webFallbackDisabled. Branching only happens in return statements.\n\nHooks with web fallbacks: useCamera, useFilePicker, useHapticFeedback, useVideoStream, useDataProtection, useCameraPermission, useNetworkStatus, useSafeArea, useDeviceInfo.",
613
+ "content": "catalyst-core hooks fall into THREE CATEGORIES.\n\nSINGLE-ACTION HOOKS wrap exactly one native operation and share a standardized base interface: { data, loading, progress, error, isWeb, isNative, execute, clear, clearError }. execute takes the operation's own arguments — it NEVER takes an operation-name string. Each also exposes a domain alias for execute: useCamera->takePhoto, useFilePicker->pickFile, useIntent->openFile, useGoogleSignIn->signIn, useHapticFeedback->trigger/triggerHaptic, useCameraPermission->request.\n\nMULTI-ACTION HOOKS wrap several distinct operations, so their NAMED FUNCTIONS ARE THE API and they have NO execute: useNotification (scheduleLocal, cancelLocal, registerForPush, updateBadge, subscribeToTopic, unsubscribeFromTopic, getSubscribedTopics, requestPermission), useVideoStream (start, stop, sendCommand, flip), useDataProtection (setScreenSecure, clearWebData), useNativeTransition (navigate, cancelTransition). EXCEPTION: useNotification carries execute as a frozen-but-discouraged alias of scheduleLocal — do NOT copy that pattern for other multi-action hooks.\n\nREAD-ONLY HOOKS report ambient state with no action functions: useNetworkStatus, useDeviceInfo, useSafeArea.\n\nisNative is true when running inside the native shell (Android/iOS WebView). isWeb is true on browser. All return SSR-safe stubs when window is undefined. Import from catalyst-core/hooks.\n\nWEB FALLBACK SYSTEM: Hooks that implement browser fallbacks additionally expose: { webFallbackActive: boolean, webFallbackDisabled: boolean, setWebFallback: (enabled: boolean) => void }. webFallbackActive=true means the hook is currently running its browser fallback (not native bridge). setWebFallback(false) disables the built-in fallback at runtime \u2014 React re-runs effects and cleans up side effects automatically (e.g. stops MediaStream, removes event listeners). webFallbackDisabled=true means the hook returned an inert no-op shape (all actions are no-ops, data/error/loading are null/false) \u2014 consumer must render its own UI.\n\nDYNAMIC PROP SYNC: The webFallback prop syncs dynamically after mount in all hooks (both useBaseHook consumers and thin-state hooks) via useEffect. Passing a new webFallback prop value re-evaluates webFallbackActive without remounting the component.\n\nRULES OF HOOKS: All hooks (useState, useRef, useCallback, useEffect) are always called unconditionally at top level, regardless of webFallbackActive/webFallbackDisabled. Branching only happens in return statements.\n\nHooks with web fallbacks: useCamera, useFilePicker, useHapticFeedback, useVideoStream, useDataProtection, useCameraPermission, useNetworkStatus, useSafeArea, useDeviceInfo.",
614
614
  "layer": "Runtime",
615
615
  "source": "static",
616
616
  "tags": [
@@ -673,7 +673,7 @@
673
673
  {
674
674
  "section": "native_hooks",
675
675
  "title": "useNotification \u2014 return shape",
676
- "content": "useNotification() returns: { data, loading, progress, error, execute (=scheduleLocal), clear, clearError, isNative, isWeb, permissionStatus, pushToken, badges, lastNotification, subscribedTopics, scheduleLocal(config), schedule (alias for scheduleLocal), cancelLocal(id), registerForPush(), updateBadge(count), subscribeToTopic(topic), unsubscribeFromTopic(topic), getSubscribedTopics(), requestPermission() }. requestPermission() triggers native permission prompt (wraps requestNotificationPermission(), errors routed through base.handleNativeError). schedule is an alias for scheduleLocal. Requires WEBVIEW_CONFIG.notifications.enabled=true + Firebase files.",
676
+ "content": "useNotification() is a MULTI-ACTION hook — its named functions are the API. Returns: { data, loading, progress, error, clear, clearError, isNative, isWeb, permissionStatus, pushToken, badges, lastNotification, subscribedTopics, scheduleLocal(config), cancelLocal(id), registerForPush(), updateBadge(count), subscribeToTopic(topic), unsubscribeFromTopic(topic), getSubscribedTopics(), requestPermission() }. requestPermission() triggers native permission prompt (wraps requestNotificationPermission(), errors routed through base.handleNativeError).\n\nFROZEN-BUT-DISCOURAGED ALIASES: execute and schedule both alias scheduleLocal, kept for backward compatibility only. They are the sole exception among multi-action hooks and must NOT be treated as the pattern to copy — other multi-action hooks have no execute. Both aliases are removed at 2.0; write new code against scheduleLocal. Requires WEBVIEW_CONFIG.notifications.enabled=true + Firebase files.",
677
677
  "layer": "Runtime",
678
678
  "source": "static",
679
679
  "tags": ["native-hooks", "useNotification", "return-shape"]
@@ -1072,7 +1072,7 @@
1072
1072
  {
1073
1073
  "section": "native_hooks",
1074
1074
  "title": "Native Hooks \u2014 Full List and Standard Interface",
1075
- "content": "All hooks live in src/native/bridge/hooks/ (one file per domain). hooks.js is a 2-line re-export shim for backwards compat.\n\nSTANDARD BASE INTERFACE (useBaseHook consumers):\n{ data, loading, progress, error, isWeb, isNative, execute, clear, clearError,\n webFallbackActive, webFallbackDisabled, setWebFallback }\n\nprogress shape: { state, percentage, message, phase, transport, bytesLoaded, bytesTotal }\n\nENVIRONMENT DETECTION (useBaseHook):\nisNative = window.WebBridge && (window.NativeBridge || window.webkit?.messageHandlers?.NativeBridge)\nisWeb = !isNative\n\nWEB FALLBACK SYSTEM:\n- Hooks that support a browser fallback declare hasWebFallback: true in useBaseHook options.\n- webFallbackActive defaults to true on web when a fallback exists (unless webFallback prop === false).\n- webFallback prop syncs dynamically after mount \u2014 all hooks (useBaseHook consumers and thin-state hooks) update webFallbackActive via a useEffect that watches the prop.\n- setWebFallback(false) disables fallback at runtime \u2014 React re-runs effects + cleanups (e.g. stops MediaStream, removes event listeners).\n- When disabled: webFallbackDisabled=true, all action methods are no-ops, data/error/loading are null/false.\n- Thin-state hooks (useNetworkStatus, useSafeArea, useDeviceInfo, useCameraPermission) manage webFallback locally and expose isNative, isWeb, webFallbackActive, webFallbackDisabled, setWebFallback \u2014 same surface as useBaseHook consumers.\n- Rules of Hooks: all hooks are always called unconditionally at top level \u2014 early returns and conditional branches only in return statements, never around hook calls.\n\nFULL HOOK LIST:\nWith web fallback:\n- useCamera \u2014 capture photo. Web: <input type=file capture=environment>.\n- useFilePicker \u2014 pick file. Web: <input type=file>.\n- useHapticFeedback \u2014 haptic/vibration. Web: navigator.vibrate.\n- useVideoStream \u2014 live camera stream + sendCommand (zoom/torch/fps). Web: getUserMedia (requires secure context) with track.applyConstraints. Stream auto-stopped on mode change or unmount.\n- useDataProtection \u2014 setScreenSecure + clearWebData. Web: overlay div on visibilitychange + localStorage/sessionStorage/cookie/IndexedDB clear.\n- useCameraPermission \u2014 camera permission state + request(). Web: navigator.permissions API (query) + getUserMedia side-effect for request().\n- useNetworkStatus \u2014 online/type. Web: navigator.onLine (defaults true if not boolean) + online/offline events (live updates).\n- useSafeArea \u2014 inset pixels. Web: CSS env() vars.\n- useDeviceInfo \u2014 device metadata. Web: navigator/screen APIs.\n\nNo web fallback (native-only or scoped out):\n- useNotification \u2014 push notifications. Web: scoped out (Service Worker required, unreliable in WebView).\n- useNotificationPermission \u2014 notification permission.\n- useGoogleSignIn \u2014 Google sign-in via native.\n- useIntent \u2014 open file with external app.",
1075
+ "content": "All hooks live in src/native/bridge/hooks/ (one file per domain). hooks.js is a 2-line re-export shim for backwards compat.\n\nTHREE CATEGORIES:\n- SINGLE-ACTION hooks wrap one operation and expose it as execute (plus a domain alias). execute takes the operation's arguments, never an operation-name string. These are: useCamera (takePhoto), useFilePicker (pickFile), useIntent (openFile), useGoogleSignIn (signIn), useHapticFeedback (trigger/triggerHaptic), useCameraPermission (request).\n- MULTI-ACTION hooks wrap several operations, so the named functions ARE the API and there is NO execute: useNotification, useVideoStream, useDataProtection, useNativeTransition. useNotification is the sole exception carrying execute as a frozen-but-discouraged alias of scheduleLocal — never copy that pattern.\n- READ-ONLY hooks have no action functions: useNetworkStatus, useDeviceInfo, useSafeArea.\n\nSTANDARD BASE INTERFACE (single-action useBaseHook consumers):\n{ data, loading, progress, error, isWeb, isNative, execute, clear, clearError,\n webFallbackActive, webFallbackDisabled, setWebFallback }\n\nMulti-action hooks share the same state keys (data, loading, error, isWeb, isNative, clear, clearError) but replace execute with their named functions.\n\nERROR SHAPE: error is a standard error object everywhere EXCEPT useDeviceInfo and useNetworkStatus, where it remains a plain string until 2.0. useNativeTransition and useSafeArea are error-exempt — they have no error key at all (transition failures self-heal into a plain navigate; safe-area insets always resolve to numeric defaults). useAI's shape is owned by the catalyst-ai package and is outside this contract.\n\nprogress shape: { state, percentage, message, phase, transport, bytesLoaded, bytesTotal }\n\nENVIRONMENT DETECTION (useBaseHook):\nisNative = window.WebBridge && (window.NativeBridge || window.webkit?.messageHandlers?.NativeBridge)\nisWeb = !isNative\n\nWEB FALLBACK SYSTEM:\n- Hooks that support a browser fallback declare hasWebFallback: true in useBaseHook options.\n- webFallbackActive defaults to true on web when a fallback exists (unless webFallback prop === false).\n- webFallback prop syncs dynamically after mount \u2014 all hooks (useBaseHook consumers and thin-state hooks) update webFallbackActive via a useEffect that watches the prop.\n- setWebFallback(false) disables fallback at runtime \u2014 React re-runs effects + cleanups (e.g. stops MediaStream, removes event listeners).\n- When disabled: webFallbackDisabled=true, all action methods are no-ops, data/error/loading are null/false.\n- Thin-state hooks (useNetworkStatus, useSafeArea, useDeviceInfo, useCameraPermission) manage webFallback locally and expose isNative, isWeb, webFallbackActive, webFallbackDisabled, setWebFallback \u2014 same surface as useBaseHook consumers.\n- Rules of Hooks: all hooks are always called unconditionally at top level \u2014 early returns and conditional branches only in return statements, never around hook calls.\n\nFULL HOOK LIST:\nWith web fallback:\n- useCamera \u2014 capture photo. Web: <input type=file capture=environment>.\n- useFilePicker \u2014 pick file. Web: <input type=file>.\n- useHapticFeedback \u2014 haptic/vibration. Web: navigator.vibrate.\n- useVideoStream \u2014 live camera stream + sendCommand (zoom/torch/fps). Web: getUserMedia (requires secure context) with track.applyConstraints. Stream auto-stopped on mode change or unmount.\n- useDataProtection \u2014 setScreenSecure + clearWebData. Web: overlay div on visibilitychange + localStorage/sessionStorage/cookie/IndexedDB clear.\n- useCameraPermission \u2014 camera permission state + request(). Web: navigator.permissions API (query) + getUserMedia side-effect for request().\n- useNetworkStatus \u2014 online/type. Web: navigator.onLine (defaults true if not boolean) + online/offline events (live updates).\n- useSafeArea \u2014 inset pixels. Web: CSS env() vars.\n- useDeviceInfo \u2014 device metadata. Web: navigator/screen APIs.\n\nNo web fallback (native-only or scoped out):\n- useNotification \u2014 push notifications. Web: scoped out (Service Worker required, unreliable in WebView).\n- useNotificationPermission \u2014 notification permission.\n- useGoogleSignIn \u2014 Google sign-in via native.\n- useIntent \u2014 open file with external app.\n- useNativeTransition \u2014 navigate with native slide/fade transitions. Web: CSS overlay on document.body driven by the same state machine (not a webFallback-prop hook).",
1076
1076
  "layer": "Bridge",
1077
1077
  "source": "static",
1078
1078
  "tags": [
@@ -1108,7 +1108,7 @@
1108
1108
  {
1109
1109
  "section": "native_hooks",
1110
1110
  "title": "useVideoStream \u2014 return shape",
1111
- "content": "useVideoStream(options?) returns: { isStreaming: boolean, streamState: { zoom, minZoom, maxZoom, torchOn, fpsMin, fpsMax }, error, isNative, webFallbackActive, webFallbackDisabled, setWebFallback, mediaStream: MediaStream|null (web only), viewfinderRef, start, stop, sendCommand, flip, clearError }.\n\nstart(options?) / stop() / flip() \u2014 stream lifecycle. sendCommand(type, value) controls live stream: 'zoom' (number \u2265 1.0), 'torch' (boolean), 'fps' ({ min, max }).\n\nOn native: sendCommand routes to WebBridge native commands. streamState updates only on native confirmation events (ON_TORCH_CHANGED, ON_ZOOM_CHANGED). On web fallback: sendCommand maps to track.applyConstraints().\n\nWEB FALLBACK (getUserMedia):\n- Requires secure context (HTTPS or localhost) \u2014 hook returns error if window.isSecureContext is false.\n- Requires navigator.mediaDevices.getUserMedia \u2014 hook returns error if unavailable.\n- mediaStream is returned directly (attach to <video> srcObject).\n- All tracks stopped automatically when setWebFallback(false) is called or component unmounts.\n- start()/stop()/flip() are async on web.\n- Rules of Hooks: all hooks (useState, useRef, useCallback, useEffect) declared unconditionally at top level \u2014 branching only in return statements.",
1111
+ "content": "useVideoStream(options?) is a MULTI-ACTION hook — start/stop/sendCommand/flip are the API and there is NO execute key. Returns: { isStreaming: boolean, streamState: { zoom, minZoom, maxZoom, torchOn, fpsMin, fpsMax }, loading, error, isNative, isWeb, webFallbackActive, webFallbackDisabled, setWebFallback, mediaStream: MediaStream|null (web only), viewfinderRef, start, stop, sendCommand, flip, clearError }.\n\nstart(options?) / stop() / flip() \u2014 stream lifecycle. sendCommand(type, value) controls live stream: 'zoom' (number \u2265 1.0), 'torch' (boolean), 'fps' ({ min, max }).\n\nOn native: sendCommand routes to WebBridge native commands. streamState updates only on native confirmation events (ON_TORCH_CHANGED, ON_ZOOM_CHANGED). On web fallback: sendCommand maps to track.applyConstraints().\n\nWEB FALLBACK (getUserMedia):\n- Requires secure context (HTTPS or localhost) \u2014 hook returns error if window.isSecureContext is false.\n- Requires navigator.mediaDevices.getUserMedia \u2014 hook returns error if unavailable.\n- mediaStream is returned directly (attach to <video> srcObject).\n- All tracks stopped automatically when setWebFallback(false) is called or component unmounts.\n- start()/stop()/flip() are async on web.\n- Rules of Hooks: all hooks (useState, useRef, useCallback, useEffect) declared unconditionally at top level \u2014 branching only in return statements.",
1112
1112
  "layer": "Runtime",
1113
1113
  "source": "static",
1114
1114
  "tags": [
@@ -1126,7 +1126,7 @@
1126
1126
  {
1127
1127
  "section": "native_hooks",
1128
1128
  "title": "useDeviceInfo \u2014 return shape",
1129
- "content": "useDeviceInfo() returns: { data: { model, manufacturer, platform, osVersion, screenWidth, screenHeight, screenDensity, appVersion, appInfo }, loading, error, isWeb, isNative, webFallbackActive, webFallbackDisabled, setWebFallback }.\n\nThis is a NEW React hook (did not exist before \u2014 only WebBridge.getDeviceInfo() imperative method existed). Use useDeviceInfo() in React components instead of calling WebBridge.getDeviceInfo() imperatively.\n\nOn native: wraps WebBridge.getDeviceInfo() promise, resolves on ON_DEVICE_INFO_SUCCESS callback.\n\nWEB FALLBACK: Populates device info from browser APIs:\n- platform: navigator.platform or 'web'\n- model/manufacturer: derived from navigator.userAgent (best-effort)\n- screenWidth/Height: screen.width/height\n- screenDensity: window.devicePixelRatio\n- appVersion/appInfo: null on web (no native app context)\n\nManages webFallback state locally (thin-state hook, not via useBaseHook).",
1129
+ "content": "useDeviceInfo() is a READ-ONLY hook (no action functions, no execute). Returns: { data: { model, manufacturer, platform, screenWidth, screenHeight, screenDensity, appInfo }, deviceInfo (=data, deprecated alias removed at 2.0), loading, error, isWeb, isNative, webFallbackActive, webFallbackDisabled, setWebFallback }. NOTE: error is a plain STRING here, not a standard error object — this stays a string until 2.0.\n\nThis is a NEW React hook (did not exist before \u2014 only WebBridge.getDeviceInfo() imperative method existed). Use useDeviceInfo() in React components instead of calling WebBridge.getDeviceInfo() imperatively.\n\nOn native: wraps WebBridge.getDeviceInfo() promise, resolves on ON_DEVICE_INFO_SUCCESS callback.\n\nWEB FALLBACK: Populates device info from browser APIs:\n- platform: navigator.platform or 'web'\n- model/manufacturer: derived from navigator.userAgent (best-effort)\n- screenWidth/Height: screen.width/height\n- screenDensity: window.devicePixelRatio\n- appInfo: null on web (no native app context)\n\nManages webFallback state locally (thin-state hook, not via useBaseHook).",
1130
1130
  "layer": "Runtime",
1131
1131
  "source": "static",
1132
1132
  "tags": [
@@ -1142,7 +1142,7 @@
1142
1142
  {
1143
1143
  "section": "native_hooks",
1144
1144
  "title": "useDataProtection \u2014 return shape",
1145
- "content": "useDataProtection() returns: { data, loading, error, isWeb, isNative, execute, clear, clearError, setScreenSecure: (enabled: boolean) => void, clearWebData: () => void, isScreenSecure: boolean, webFallbackActive, webFallbackDisabled, setWebFallback }.\n\nsetScreenSecure(true/false) \u2014 enables/disables screen security (prevents screenshots/recents).\nclearWebData() \u2014 clears all web storage.\n\nOn native (Android): setScreenSecure sets FLAG_SECURE on WebView. clearWebData clears cookies, localStorage, WebView cache.\nOn native (iOS): setScreenSecure applies blur overlay. clearWebData uses WKWebsiteDataStore.\n\nWEB FALLBACK:\n- setScreenSecure(true): injects a fixed black overlay div (position:fixed, z-index:9999, 100vw/100vh) that shows/hides on document.visibilitychange \u2014 best-effort screenshot prevention (cannot block OS-level screenshots on web).\n- setScreenSecure(false): removes the overlay div and visibilitychange listener.\n- clearWebData(): clears localStorage, sessionStorage, all cookies (document.cookie), and all IndexedDB databases (indexedDB.databases() + deleteDatabase()).\n- setWebFallback(false): removes overlay + listener, returns inert no-op shape.",
1145
+ "content": "useDataProtection() is a MULTI-ACTION hook — its named functions are the API and there is NO execute key. Returns: { data, loading, progress, error, isWeb, isNative, clear, clearError, screenSecure: boolean, setScreenSecure: (enabled: boolean) => void, clearWebData: () => void, webFallbackActive, webFallbackDisabled, setWebFallback }. Note the state key is screenSecure, not isScreenSecure.\n\nsetScreenSecure(true/false) \u2014 enables/disables screen security (prevents screenshots/recents).\nclearWebData() \u2014 clears all web storage.\n\nOn native (Android): setScreenSecure sets FLAG_SECURE on WebView. clearWebData clears cookies, localStorage, WebView cache.\nOn native (iOS): setScreenSecure applies blur overlay. clearWebData uses WKWebsiteDataStore.\n\nWEB FALLBACK:\n- setScreenSecure(true): injects a fixed black overlay div (position:fixed, z-index:9999, 100vw/100vh) that shows/hides on document.visibilitychange \u2014 best-effort screenshot prevention (cannot block OS-level screenshots on web).\n- setScreenSecure(false): removes the overlay div and visibilitychange listener.\n- clearWebData(): clears localStorage, sessionStorage, all cookies (document.cookie), and all IndexedDB databases (indexedDB.databases() + deleteDatabase()).\n- setWebFallback(false): removes overlay + listener, returns inert no-op shape.",
1146
1146
  "layer": "Runtime",
1147
1147
  "source": "static",
1148
1148
  "tags": [
@@ -1157,6 +1157,41 @@
1157
1157
  "IndexedDB"
1158
1158
  ]
1159
1159
  },
1160
+ {
1161
+ "section": "native_hooks",
1162
+ "title": "useNativeTransition \u2014 return shape",
1163
+ "content": "useNativeTransition(defaults?) is a MULTI-ACTION hook \u2014 navigate/cancelTransition are the API and there is NO execute key. Returns: { navigate: (to, options?) => void, cancelTransition: () => void, transitioning: boolean, loading (=transitioning, deprecated alias direction is reversed here \u2014 loading is canonical, transitioning is the alias removed at 2.0), isNative, isWeb }.\n\nERROR-EXEMPT: there is NO error key. Transition failures self-heal \u2014 if native startTransition or commitTransition throws, the hook logs, clears transitioning, and falls through to a plain router navigate, so the user always lands on the destination route.\n\nnavigate(to, options) accepts standard react-router NavigateOptions plus: type ('slide'|'fade', default 'slide'), direction ('left'|'right'|'up'|'down', default 'left'), duration (ms, default 300), timeout (ms safety timer, default max(duration*3, 800)). The same options can be passed once to the hook as per-call defaults.\n\nNative path: startTransition (native snapshots screen) \u2192 router.navigate(to) \u2192 double-rAF \u2192 commitTransition (native animates overlay out). Native-side safety timer force-fades the overlay if commit never arrives (ON_TRANSITION_TIMEOUT).\n\nWeb path: CSS overlay div on document.body (position:fixed, z-index:9999, opacity transition) driven by the same state machine, with its own setTimeout safety net. Not a webFallback-prop hook \u2014 it has no webFallbackActive/webFallbackDisabled/setWebFallback keys.",
1164
+ "layer": "Runtime",
1165
+ "source": "static",
1166
+ "tags": [
1167
+ "native-hooks",
1168
+ "useNativeTransition",
1169
+ "return-shape",
1170
+ "navigation",
1171
+ "transition",
1172
+ "react-router",
1173
+ "multi-action",
1174
+ "error-exempt"
1175
+ ]
1176
+ },
1177
+ {
1178
+ "section": "native_hooks",
1179
+ "title": "Native hooks \u2014 aliases and deprecations (removed at 2.0)",
1180
+ "content": "Alias keys kept from earlier releases. Both names work and return the same value. ALL ALIASES ARE REMOVED AT 2.0 \u2014 write new code against the canonical key.\n\nALIAS -> CANONICAL:\n- isLoading -> loading (useCamera, useFilePicker, useIntent, useCameraPermission, useNotificationPermission)\n- transitioning -> loading (useNativeTransition)\n- deviceInfo -> data (useDeviceInfo)\n- permission -> data (useCameraPermission, useNotificationPermission)\n- request -> execute (useCameraPermission)\n\nuseNotification.execute and useNotification.schedule both alias scheduleLocal. They are frozen for backward compatibility but DISCOURAGED, and they are explicitly NOT the pattern to copy for multi-action hooks \u2014 every other multi-action hook (useVideoStream, useDataProtection, useNativeTransition) has no execute key at all.\n\nERROR SHAPE EXCEPTIONS: error is a standard error object everywhere EXCEPT useDeviceInfo and useNetworkStatus, where it stays a plain string until 2.0. useNativeTransition and useSafeArea are error-exempt \u2014 no error key at all. useAI's shape is owned by the catalyst-ai package and sits outside this contract.\n\nDUAL SURFACES: requestHapticFeedback and requestCameraPermission exist BOTH as catalyst-core/hooks exports and as WebBridge methods, with different defaults and return types. requestHapticFeedback: hooks export defaults to 'light' and resolves the raw status string; WebBridge.requestHapticFeedback defaults to 'VIRTUAL_KEY' and resolves the parsed result object. requestCameraPermission: hooks export takes no arguments and REJECTS on denial; WebBridge.requestCameraPermission takes a config object ({ includeDetails }) and RESOLVES with the denied status. The hooks exports are SSR-safe (return Promise<null> when window is undefined). The two surfaces are unified at 2.0.",
1181
+ "layer": "Runtime",
1182
+ "source": "static",
1183
+ "tags": [
1184
+ "native-hooks",
1185
+ "aliases",
1186
+ "deprecations",
1187
+ "2.0",
1188
+ "api-freeze",
1189
+ "error-shape",
1190
+ "WebBridge",
1191
+ "requestHapticFeedback",
1192
+ "requestCameraPermission"
1193
+ ]
1194
+ },
1160
1195
  {
1161
1196
  "section": "seo_metadata",
1162
1197
  "title": "Legacy 0.2.x Server-Side Meta Tags \u2014 setMetaData()",
@@ -1268,10 +1303,19 @@
1268
1303
  {
1269
1304
  "section": "routing",
1270
1305
  "title": "Catalyst 0.3.x Integrated Router",
1271
- "content": "Catalyst 0.3.x removes the @tata1mg/router package dependency. catalyst-core exports React Router APIs plus RouterDataProvider, MetaTag, routing data hooks, metadata utilities, split, and hydrationReady. Existing route arrays and preparedRoutes structure remain, but imports must move from @tata1mg/router to catalyst-core. Keeping both router packages can create duplicate runtime contracts and invalid React element errors.",
1306
+ "content": "Catalyst 0.3.x removes the @tata1mg/router package dependency. As of the 0.4.0 API freeze, catalyst-core does NOT re-export React Router. Its root entry exports exactly eight names: RouterDataProvider, useCurrentRouteData, useRouterData, MetaTag, split, hydrationReady, Head, Body. There is no default export (split was previously also the default). React Router is a peerDependency (^7.18.2): install react-router in the application and import Outlet, Link, useParams, useNavigate, useLocation, Navigate and every other router name from 'react-router' directly. The one exception is RouterProvider: client/index.js imports it from 'react-router/dom', the DOM build that wires ReactDOM.flushSync into the router (the 'react-router' export renders the same tree but silently skips flushSync, so view transitions and flushSync navigations degrade). Metadata utilities (getMetaData, mergeHeadElements, deleteHeadTagsByDataAttribute), RouterContext, serverDataFetcher and useNavigateWithTransition are no longer public. Existing route arrays and preparedRoutes structure remain unchanged. Keeping both router packages can create duplicate runtime contracts and invalid React element errors.",
1272
1307
  "layer": "Runtime",
1273
1308
  "source": "static",
1274
- "tags": ["0.3.x", "router", "react-router", "RouterDataProvider", "migration"],
1309
+ "tags": [
1310
+ "0.3.x",
1311
+ "0.4.0",
1312
+ "router",
1313
+ "react-router",
1314
+ "peer-dependency",
1315
+ "RouterDataProvider",
1316
+ "migration",
1317
+ "api-freeze"
1318
+ ],
1275
1319
  "github_files": [
1276
1320
  "packages/catalyst-core/src/index.jsx",
1277
1321
  "packages/catalyst-core/src/web-router/components/RouterDataProvider.jsx"