@ecopages/core 0.2.0-alpha.4 → 0.2.0-alpha.6

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 (418) hide show
  1. package/README.md +213 -12
  2. package/package.json +100 -188
  3. package/src/adapters/README.md +39 -0
  4. package/src/adapters/bun/hmr-manager.test.ts +267 -0
  5. package/src/adapters/bun/hmr-manager.ts +181 -68
  6. package/src/adapters/bun/index.ts +1 -2
  7. package/src/adapters/bun/server-adapter.ts +41 -34
  8. package/src/adapters/bun/server-lifecycle.ts +40 -70
  9. package/src/adapters/index.ts +1 -1
  10. package/src/adapters/node/bootstrap-dependency-resolver.test.ts +282 -0
  11. package/src/adapters/node/bootstrap-dependency-resolver.ts +301 -0
  12. package/src/adapters/node/index.ts +7 -0
  13. package/src/adapters/node/node-client-bridge.test.ts +198 -0
  14. package/src/adapters/node/node-hmr-manager.test.ts +322 -0
  15. package/src/adapters/node/node-hmr-manager.ts +208 -116
  16. package/src/adapters/node/runtime-adapter.test.ts +868 -0
  17. package/src/adapters/node/runtime-adapter.ts +439 -0
  18. package/src/adapters/node/server-adapter.ts +31 -104
  19. package/src/adapters/node/static-content-server.test.ts +60 -0
  20. package/src/adapters/node/static-content-server.ts +36 -0
  21. package/src/adapters/node/write-runtime-manifest.ts +38 -0
  22. package/src/adapters/shared/api-response.test.ts +97 -0
  23. package/src/{define-api-handler.ts → adapters/shared/define-api-handler.ts} +1 -1
  24. package/src/adapters/shared/explicit-static-route-matcher.test.ts +381 -0
  25. package/src/adapters/shared/explicit-static-route-matcher.ts +7 -1
  26. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +90 -0
  27. package/src/adapters/shared/file-route-middleware-pipeline.ts +6 -2
  28. package/src/adapters/shared/fs-server-response-factory.test.ts +187 -0
  29. package/src/adapters/shared/fs-server-response-matcher.test.ts +286 -0
  30. package/src/adapters/shared/fs-server-response-matcher.ts +17 -10
  31. package/src/adapters/shared/hmr-entrypoint-registrar.ts +149 -0
  32. package/src/adapters/shared/hmr-html-response.ts +52 -0
  33. package/src/adapters/shared/hmr-manager.contract.test.ts +196 -0
  34. package/src/adapters/shared/hmr-manager.dispatch.test.ts +220 -0
  35. package/src/adapters/shared/render-context.test.ts +146 -0
  36. package/src/adapters/shared/render-context.ts +21 -6
  37. package/src/adapters/shared/runtime-bootstrap.ts +79 -0
  38. package/src/adapters/shared/server-adapter.test.ts +77 -0
  39. package/src/adapters/shared/server-adapter.ts +51 -4
  40. package/src/adapters/shared/server-route-handler.test.ts +110 -0
  41. package/src/adapters/shared/server-route-handler.ts +5 -18
  42. package/src/adapters/shared/server-static-builder.test.ts +316 -0
  43. package/src/adapters/shared/server-static-builder.ts +92 -8
  44. package/src/build/README.md +101 -0
  45. package/src/build/build-adapter-serialization.test.ts +268 -0
  46. package/src/build/build-adapter.test.ts +815 -0
  47. package/src/build/build-adapter.ts +235 -6
  48. package/src/build/build-manifest.ts +54 -0
  49. package/src/build/dev-build-coordinator.ts +221 -0
  50. package/src/build/esbuild-build-adapter.ts +132 -83
  51. package/src/build/runtime-build-executor.ts +34 -0
  52. package/src/build/runtime-specifier-alias-plugin.test.ts +43 -0
  53. package/src/build/runtime-specifier-alias-plugin.ts +58 -0
  54. package/src/config/README.md +33 -0
  55. package/src/config/config-builder.test.ts +410 -0
  56. package/src/config/config-builder.ts +281 -49
  57. package/src/constants.ts +15 -0
  58. package/src/declarations.d.ts +18 -13
  59. package/src/eco/README.md +70 -16
  60. package/src/eco/component-render-context.ts +39 -17
  61. package/src/eco/eco.test.ts +678 -0
  62. package/src/eco/eco.ts +29 -8
  63. package/src/eco/eco.types.ts +20 -1
  64. package/src/eco/eco.utils.test.ts +124 -0
  65. package/src/eco/global-injector-map.test.ts +42 -0
  66. package/src/eco/lazy-injector-map.test.ts +66 -0
  67. package/src/eco/module-dependencies.test.ts +30 -0
  68. package/src/errors/http-error.test.ts +134 -0
  69. package/src/global/utils.test.ts +12 -0
  70. package/src/hmr/README.md +26 -0
  71. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-have-HMR-script-injected-in-page-1.png +0 -0
  72. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  73. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  74. package/src/hmr/client/hmr-runtime.ts +38 -7
  75. package/src/hmr/hmr-strategy.test.ts +124 -0
  76. package/src/hmr/hmr.postcss.test.e2e.ts +41 -0
  77. package/src/hmr/hmr.test.e2e.ts +29 -38
  78. package/src/hmr/strategies/js-hmr-strategy.test.ts +335 -0
  79. package/src/hmr/strategies/js-hmr-strategy.ts +115 -115
  80. package/src/index.ts +1 -1
  81. package/src/integrations/ghtml/ghtml-renderer.test.ts +63 -0
  82. package/src/integrations/ghtml/ghtml-renderer.ts +4 -1
  83. package/src/internal-types.ts +39 -19
  84. package/src/plugins/README.md +34 -0
  85. package/src/plugins/alias-resolver-plugin.test.ts +41 -0
  86. package/src/plugins/alias-resolver-plugin.ts +21 -3
  87. package/src/plugins/eco-component-meta-plugin.test.ts +380 -0
  88. package/src/plugins/eco-component-meta-plugin.ts +10 -3
  89. package/src/plugins/integration-plugin.test.ts +111 -0
  90. package/src/plugins/integration-plugin.ts +45 -3
  91. package/src/plugins/processor.test.ts +148 -0
  92. package/src/plugins/processor.ts +22 -2
  93. package/src/plugins/runtime-capability.ts +14 -0
  94. package/src/public-types.ts +73 -16
  95. package/src/route-renderer/GRAPH.md +16 -20
  96. package/src/route-renderer/README.md +8 -21
  97. package/src/route-renderer/component-graph/component-graph-executor.test.ts +41 -0
  98. package/src/route-renderer/component-graph/component-graph.test.ts +63 -0
  99. package/src/route-renderer/component-graph/component-marker.test.ts +73 -0
  100. package/src/route-renderer/component-graph/component-reference.ts +29 -0
  101. package/src/route-renderer/component-graph/marker-graph-resolver.test.ts +135 -0
  102. package/src/route-renderer/{marker-graph-resolver.ts → component-graph/marker-graph-resolver.ts} +11 -9
  103. package/src/route-renderer/orchestration/integration-renderer.test.ts +936 -0
  104. package/src/route-renderer/{integration-renderer.ts → orchestration/integration-renderer.ts} +113 -19
  105. package/src/route-renderer/orchestration/render-execution.service.test.ts +97 -0
  106. package/src/route-renderer/{render-execution.service.ts → orchestration/render-execution.service.ts} +109 -37
  107. package/src/route-renderer/orchestration/render-preparation.service.test.ts +235 -0
  108. package/src/route-renderer/{render-preparation.service.ts → orchestration/render-preparation.service.ts} +127 -9
  109. package/src/route-renderer/page-loading/dependency-resolver.test.ts +345 -0
  110. package/src/route-renderer/{dependency-resolver.ts → page-loading/dependency-resolver.ts} +28 -12
  111. package/src/route-renderer/page-loading/page-module-loader.test.ts +96 -0
  112. package/src/route-renderer/{page-module-loader.ts → page-loading/page-module-loader.ts} +49 -21
  113. package/src/route-renderer/route-renderer.ts +36 -1
  114. package/src/router/README.md +26 -0
  115. package/src/router/client/link-intent.d.ts +53 -0
  116. package/src/router/client/link-intent.test.browser.ts +51 -0
  117. package/src/router/client/link-intent.ts +92 -0
  118. package/src/router/client/navigation-coordinator.test.ts +237 -0
  119. package/src/router/client/navigation-coordinator.ts +433 -0
  120. package/src/router/server/fs-router-scanner.test.ts +83 -0
  121. package/src/router/{fs-router-scanner.ts → server/fs-router-scanner.ts} +12 -10
  122. package/src/router/server/fs-router.test.ts +214 -0
  123. package/src/router/{fs-router.ts → server/fs-router.ts} +2 -2
  124. package/src/services/README.md +29 -0
  125. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +385 -0
  126. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset-processing.service.ts +101 -6
  127. package/src/services/assets/asset-processing-service/asset.factory.test.ts +63 -0
  128. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.ts +2 -2
  129. package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.ts +2 -1
  130. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +72 -0
  131. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +95 -0
  132. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +67 -0
  133. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +78 -0
  134. package/src/services/{asset-processing-service → assets/asset-processing-service}/index.ts +2 -0
  135. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.ts +1 -1
  136. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +59 -0
  137. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.ts +11 -5
  138. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-script-processor.ts +17 -27
  139. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +286 -0
  140. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.ts +3 -3
  141. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +227 -0
  142. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.ts +5 -4
  143. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +199 -0
  144. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.ts +4 -1
  145. package/src/services/assets/browser-bundle.service.test.ts +36 -0
  146. package/src/services/assets/browser-bundle.service.ts +53 -0
  147. package/src/services/cache/index.ts +3 -3
  148. package/src/services/cache/memory-cache-store.test.ts +225 -0
  149. package/src/services/cache/memory-cache-store.ts +1 -1
  150. package/src/services/cache/page-cache-service.test.ts +175 -0
  151. package/src/services/cache/page-cache-service.ts +3 -3
  152. package/src/services/cache/page-request-cache-coordinator.service.test.ts +79 -0
  153. package/src/services/{page-request-cache-coordinator.service.ts → cache/page-request-cache-coordinator.service.ts} +9 -6
  154. package/src/services/html/html-rewriter-provider.service.test.ts +183 -0
  155. package/src/services/html/html-rewriter-provider.service.ts +103 -0
  156. package/src/services/html/html-transformer.service.test.ts +378 -0
  157. package/src/services/html/html-transformer.service.ts +279 -0
  158. package/src/services/invalidation/development-invalidation.service.test.ts +77 -0
  159. package/src/services/invalidation/development-invalidation.service.ts +261 -0
  160. package/src/services/module-loading/app-server-module-transpiler.service.ts +52 -0
  161. package/src/services/module-loading/page-module-import.service.test.ts +253 -0
  162. package/src/services/module-loading/page-module-import.service.ts +200 -0
  163. package/src/services/module-loading/server-loader.service.test.ts +161 -0
  164. package/src/services/module-loading/server-loader.service.ts +130 -0
  165. package/src/services/module-loading/server-module-transpiler.service.test.ts +115 -0
  166. package/src/services/module-loading/server-module-transpiler.service.ts +105 -0
  167. package/src/services/runtime-manifest/node-runtime-manifest.service.test.ts +95 -0
  168. package/src/services/runtime-manifest/node-runtime-manifest.service.ts +101 -0
  169. package/src/services/runtime-state/dev-graph.service.ts +217 -0
  170. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +136 -0
  171. package/src/services/runtime-state/runtime-specifier-registry.service.ts +96 -0
  172. package/src/services/runtime-state/server-invalidation-state.service.ts +68 -0
  173. package/src/services/validation/schema-validation-service.test.ts +223 -0
  174. package/src/services/{schema-validation-service.ts → validation/schema-validation-service.ts} +1 -1
  175. package/src/static-site-generator/README.md +26 -0
  176. package/src/static-site-generator/static-site-generator.test.ts +307 -0
  177. package/src/static-site-generator/static-site-generator.ts +109 -6
  178. package/src/utils/deep-merge.test.ts +114 -0
  179. package/src/utils/invariant.test.ts +22 -0
  180. package/src/utils/path-utils.test.ts +15 -0
  181. package/src/utils/resolve-work-dir.ts +45 -0
  182. package/src/utils/server-utils.test.ts +38 -0
  183. package/src/watchers/project-watcher.integration.test.ts +337 -0
  184. package/src/watchers/project-watcher.test-helpers.ts +1 -1
  185. package/src/watchers/project-watcher.test.ts +678 -0
  186. package/src/watchers/project-watcher.ts +130 -111
  187. package/CHANGELOG.md +0 -91
  188. package/src/adapters/abstract/application-adapter.d.ts +0 -168
  189. package/src/adapters/abstract/application-adapter.js +0 -109
  190. package/src/adapters/abstract/router-adapter.d.ts +0 -26
  191. package/src/adapters/abstract/router-adapter.js +0 -5
  192. package/src/adapters/abstract/server-adapter.d.ts +0 -69
  193. package/src/adapters/abstract/server-adapter.js +0 -15
  194. package/src/adapters/bun/client-bridge.d.ts +0 -34
  195. package/src/adapters/bun/client-bridge.js +0 -48
  196. package/src/adapters/bun/create-app.d.ts +0 -60
  197. package/src/adapters/bun/create-app.js +0 -117
  198. package/src/adapters/bun/define-api-handler.d.ts +0 -61
  199. package/src/adapters/bun/define-api-handler.js +0 -15
  200. package/src/adapters/bun/define-api-handler.ts +0 -114
  201. package/src/adapters/bun/hmr-manager.d.ts +0 -85
  202. package/src/adapters/bun/hmr-manager.js +0 -240
  203. package/src/adapters/bun/index.d.ts +0 -3
  204. package/src/adapters/bun/index.js +0 -8
  205. package/src/adapters/bun/server-adapter.d.ts +0 -155
  206. package/src/adapters/bun/server-adapter.js +0 -368
  207. package/src/adapters/bun/server-lifecycle.d.ts +0 -52
  208. package/src/adapters/bun/server-lifecycle.js +0 -120
  209. package/src/adapters/index.d.ts +0 -6
  210. package/src/adapters/index.js +0 -14
  211. package/src/adapters/node/create-app.d.ts +0 -21
  212. package/src/adapters/node/create-app.js +0 -143
  213. package/src/adapters/node/index.d.ts +0 -4
  214. package/src/adapters/node/index.js +0 -8
  215. package/src/adapters/node/node-client-bridge.d.ts +0 -26
  216. package/src/adapters/node/node-client-bridge.js +0 -66
  217. package/src/adapters/node/node-hmr-manager.d.ts +0 -63
  218. package/src/adapters/node/node-hmr-manager.js +0 -237
  219. package/src/adapters/node/server-adapter.d.ts +0 -190
  220. package/src/adapters/node/server-adapter.js +0 -420
  221. package/src/adapters/node/static-content-server.d.ts +0 -24
  222. package/src/adapters/node/static-content-server.js +0 -166
  223. package/src/adapters/shared/api-response.d.ts +0 -52
  224. package/src/adapters/shared/api-response.js +0 -96
  225. package/src/adapters/shared/application-adapter.d.ts +0 -18
  226. package/src/adapters/shared/application-adapter.js +0 -90
  227. package/src/adapters/shared/explicit-static-route-matcher.d.ts +0 -38
  228. package/src/adapters/shared/explicit-static-route-matcher.js +0 -100
  229. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +0 -65
  230. package/src/adapters/shared/file-route-middleware-pipeline.js +0 -98
  231. package/src/adapters/shared/fs-server-response-factory.d.ts +0 -19
  232. package/src/adapters/shared/fs-server-response-factory.js +0 -97
  233. package/src/adapters/shared/fs-server-response-matcher.d.ts +0 -71
  234. package/src/adapters/shared/fs-server-response-matcher.js +0 -155
  235. package/src/adapters/shared/render-context.d.ts +0 -14
  236. package/src/adapters/shared/render-context.js +0 -69
  237. package/src/adapters/shared/server-adapter.d.ts +0 -87
  238. package/src/adapters/shared/server-adapter.js +0 -353
  239. package/src/adapters/shared/server-route-handler.d.ts +0 -89
  240. package/src/adapters/shared/server-route-handler.js +0 -120
  241. package/src/adapters/shared/server-static-builder.d.ts +0 -38
  242. package/src/adapters/shared/server-static-builder.js +0 -46
  243. package/src/build/build-adapter.d.ts +0 -74
  244. package/src/build/build-adapter.js +0 -54
  245. package/src/build/build-types.d.ts +0 -57
  246. package/src/build/build-types.js +0 -0
  247. package/src/build/esbuild-build-adapter.d.ts +0 -69
  248. package/src/build/esbuild-build-adapter.js +0 -390
  249. package/src/config/config-builder.d.ts +0 -227
  250. package/src/config/config-builder.js +0 -392
  251. package/src/constants.d.ts +0 -32
  252. package/src/constants.js +0 -21
  253. package/src/create-app.d.ts +0 -17
  254. package/src/create-app.js +0 -66
  255. package/src/define-api-handler.d.ts +0 -25
  256. package/src/define-api-handler.js +0 -15
  257. package/src/dev/sc-server.d.ts +0 -30
  258. package/src/dev/sc-server.js +0 -111
  259. package/src/eco/component-render-context.d.ts +0 -105
  260. package/src/eco/component-render-context.js +0 -77
  261. package/src/eco/eco.d.ts +0 -9
  262. package/src/eco/eco.js +0 -110
  263. package/src/eco/eco.types.d.ts +0 -170
  264. package/src/eco/eco.types.js +0 -0
  265. package/src/eco/eco.utils.d.ts +0 -40
  266. package/src/eco/eco.utils.js +0 -40
  267. package/src/eco/global-injector-map.d.ts +0 -16
  268. package/src/eco/global-injector-map.js +0 -80
  269. package/src/eco/lazy-injector-map.d.ts +0 -8
  270. package/src/eco/lazy-injector-map.js +0 -70
  271. package/src/eco/module-dependencies.d.ts +0 -18
  272. package/src/eco/module-dependencies.js +0 -49
  273. package/src/errors/http-error.d.ts +0 -31
  274. package/src/errors/http-error.js +0 -50
  275. package/src/errors/index.d.ts +0 -2
  276. package/src/errors/index.js +0 -4
  277. package/src/errors/locals-access-error.d.ts +0 -4
  278. package/src/errors/locals-access-error.js +0 -9
  279. package/src/global/app-logger.d.ts +0 -2
  280. package/src/global/app-logger.js +0 -6
  281. package/src/hmr/client/hmr-runtime.d.ts +0 -10
  282. package/src/hmr/client/hmr-runtime.js +0 -86
  283. package/src/hmr/hmr-strategy.d.ts +0 -159
  284. package/src/hmr/hmr-strategy.js +0 -29
  285. package/src/hmr/hmr.test.e2e.d.ts +0 -1
  286. package/src/hmr/hmr.test.e2e.js +0 -50
  287. package/src/hmr/strategies/default-hmr-strategy.d.ts +0 -43
  288. package/src/hmr/strategies/default-hmr-strategy.js +0 -34
  289. package/src/hmr/strategies/js-hmr-strategy.d.ts +0 -136
  290. package/src/hmr/strategies/js-hmr-strategy.js +0 -188
  291. package/src/index.browser.d.ts +0 -3
  292. package/src/index.browser.js +0 -4
  293. package/src/index.d.ts +0 -5
  294. package/src/index.js +0 -10
  295. package/src/integrations/ghtml/ghtml-renderer.d.ts +0 -15
  296. package/src/integrations/ghtml/ghtml-renderer.js +0 -60
  297. package/src/integrations/ghtml/ghtml.plugin.d.ts +0 -20
  298. package/src/integrations/ghtml/ghtml.plugin.js +0 -21
  299. package/src/internal-types.d.ts +0 -200
  300. package/src/internal-types.js +0 -0
  301. package/src/plugins/alias-resolver-plugin.d.ts +0 -2
  302. package/src/plugins/alias-resolver-plugin.js +0 -39
  303. package/src/plugins/eco-component-meta-plugin.d.ts +0 -95
  304. package/src/plugins/eco-component-meta-plugin.js +0 -157
  305. package/src/plugins/integration-plugin.d.ts +0 -102
  306. package/src/plugins/integration-plugin.js +0 -100
  307. package/src/plugins/processor.d.ts +0 -82
  308. package/src/plugins/processor.js +0 -122
  309. package/src/public-types.d.ts +0 -1098
  310. package/src/public-types.js +0 -0
  311. package/src/route-renderer/component-graph-executor.d.ts +0 -32
  312. package/src/route-renderer/component-graph-executor.js +0 -31
  313. package/src/route-renderer/component-graph.d.ts +0 -42
  314. package/src/route-renderer/component-graph.js +0 -72
  315. package/src/route-renderer/component-marker.d.ts +0 -52
  316. package/src/route-renderer/component-marker.js +0 -46
  317. package/src/route-renderer/dependency-resolver.d.ts +0 -24
  318. package/src/route-renderer/dependency-resolver.js +0 -428
  319. package/src/route-renderer/html-post-processing.service.d.ts +0 -40
  320. package/src/route-renderer/html-post-processing.service.js +0 -86
  321. package/src/route-renderer/html-post-processing.service.ts +0 -103
  322. package/src/route-renderer/integration-renderer.d.ts +0 -339
  323. package/src/route-renderer/integration-renderer.js +0 -526
  324. package/src/route-renderer/marker-graph-resolver.d.ts +0 -76
  325. package/src/route-renderer/marker-graph-resolver.js +0 -93
  326. package/src/route-renderer/page-module-loader.d.ts +0 -61
  327. package/src/route-renderer/page-module-loader.js +0 -102
  328. package/src/route-renderer/render-execution.service.d.ts +0 -69
  329. package/src/route-renderer/render-execution.service.js +0 -91
  330. package/src/route-renderer/render-preparation.service.d.ts +0 -112
  331. package/src/route-renderer/render-preparation.service.js +0 -243
  332. package/src/route-renderer/route-renderer.d.ts +0 -26
  333. package/src/route-renderer/route-renderer.js +0 -68
  334. package/src/router/fs-router-scanner.d.ts +0 -41
  335. package/src/router/fs-router-scanner.js +0 -155
  336. package/src/router/fs-router.d.ts +0 -26
  337. package/src/router/fs-router.js +0 -100
  338. package/src/services/asset-processing-service/asset-processing.service.d.ts +0 -41
  339. package/src/services/asset-processing-service/asset-processing.service.js +0 -250
  340. package/src/services/asset-processing-service/asset.factory.d.ts +0 -17
  341. package/src/services/asset-processing-service/asset.factory.js +0 -82
  342. package/src/services/asset-processing-service/assets.types.d.ts +0 -88
  343. package/src/services/asset-processing-service/assets.types.js +0 -0
  344. package/src/services/asset-processing-service/index.d.ts +0 -3
  345. package/src/services/asset-processing-service/index.js +0 -3
  346. package/src/services/asset-processing-service/processor.interface.d.ts +0 -22
  347. package/src/services/asset-processing-service/processor.interface.js +0 -6
  348. package/src/services/asset-processing-service/processor.registry.d.ts +0 -8
  349. package/src/services/asset-processing-service/processor.registry.js +0 -15
  350. package/src/services/asset-processing-service/processors/base/base-processor.d.ts +0 -24
  351. package/src/services/asset-processing-service/processors/base/base-processor.js +0 -59
  352. package/src/services/asset-processing-service/processors/base/base-script-processor.d.ts +0 -16
  353. package/src/services/asset-processing-service/processors/base/base-script-processor.js +0 -80
  354. package/src/services/asset-processing-service/processors/index.d.ts +0 -5
  355. package/src/services/asset-processing-service/processors/index.js +0 -5
  356. package/src/services/asset-processing-service/processors/script/content-script.processor.d.ts +0 -5
  357. package/src/services/asset-processing-service/processors/script/content-script.processor.js +0 -57
  358. package/src/services/asset-processing-service/processors/script/file-script.processor.d.ts +0 -8
  359. package/src/services/asset-processing-service/processors/script/file-script.processor.js +0 -76
  360. package/src/services/asset-processing-service/processors/script/node-module-script.processor.d.ts +0 -7
  361. package/src/services/asset-processing-service/processors/script/node-module-script.processor.js +0 -74
  362. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +0 -5
  363. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -25
  364. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +0 -9
  365. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +0 -63
  366. package/src/services/cache/cache.types.d.ts +0 -107
  367. package/src/services/cache/cache.types.js +0 -0
  368. package/src/services/cache/index.d.ts +0 -7
  369. package/src/services/cache/index.js +0 -7
  370. package/src/services/cache/memory-cache-store.d.ts +0 -42
  371. package/src/services/cache/memory-cache-store.js +0 -98
  372. package/src/services/cache/page-cache-service.d.ts +0 -70
  373. package/src/services/cache/page-cache-service.js +0 -152
  374. package/src/services/html-transformer.service.d.ts +0 -50
  375. package/src/services/html-transformer.service.js +0 -163
  376. package/src/services/html-transformer.service.ts +0 -217
  377. package/src/services/page-module-import.service.d.ts +0 -37
  378. package/src/services/page-module-import.service.js +0 -88
  379. package/src/services/page-module-import.service.ts +0 -129
  380. package/src/services/page-request-cache-coordinator.service.d.ts +0 -75
  381. package/src/services/page-request-cache-coordinator.service.js +0 -107
  382. package/src/services/schema-validation-service.d.ts +0 -122
  383. package/src/services/schema-validation-service.js +0 -101
  384. package/src/services/validation/standard-schema.types.d.ts +0 -65
  385. package/src/services/validation/standard-schema.types.js +0 -0
  386. package/src/static-site-generator/static-site-generator.d.ts +0 -57
  387. package/src/static-site-generator/static-site-generator.js +0 -272
  388. package/src/utils/css.d.ts +0 -1
  389. package/src/utils/css.js +0 -7
  390. package/src/utils/deep-merge.d.ts +0 -14
  391. package/src/utils/deep-merge.js +0 -32
  392. package/src/utils/hash.d.ts +0 -1
  393. package/src/utils/hash.js +0 -7
  394. package/src/utils/html.d.ts +0 -1
  395. package/src/utils/html.js +0 -4
  396. package/src/utils/invariant.d.ts +0 -5
  397. package/src/utils/invariant.js +0 -11
  398. package/src/utils/locals-utils.d.ts +0 -15
  399. package/src/utils/locals-utils.js +0 -24
  400. package/src/utils/parse-cli-args.d.ts +0 -24
  401. package/src/utils/parse-cli-args.js +0 -47
  402. package/src/utils/path-utils.module.d.ts +0 -5
  403. package/src/utils/path-utils.module.js +0 -14
  404. package/src/utils/runtime.d.ts +0 -11
  405. package/src/utils/runtime.js +0 -40
  406. package/src/utils/server-utils.module.d.ts +0 -19
  407. package/src/utils/server-utils.module.js +0 -56
  408. package/src/watchers/project-watcher.d.ts +0 -125
  409. package/src/watchers/project-watcher.js +0 -265
  410. package/src/watchers/project-watcher.test-helpers.d.ts +0 -4
  411. package/src/watchers/project-watcher.test-helpers.js +0 -52
  412. /package/src/route-renderer/{component-graph-executor.ts → component-graph/component-graph-executor.ts} +0 -0
  413. /package/src/route-renderer/{component-graph.ts → component-graph/component-graph.ts} +0 -0
  414. /package/src/route-renderer/{component-marker.ts → component-graph/component-marker.ts} +0 -0
  415. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.ts +0 -0
  416. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/index.ts +0 -0
  417. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.ts +0 -0
  418. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.ts +0 -0
@@ -0,0 +1,678 @@
1
+ import { describe, expect, test, beforeEach, afterEach, vi } from 'vitest';
2
+ import path from 'node:path';
3
+ import chokidar from 'chokidar';
4
+ import { fileSystem } from '@ecopages/file-system';
5
+ import { ProjectWatcher } from './project-watcher';
6
+ import type { EcoPagesAppConfig, IHmrManager } from '../internal-types';
7
+ import type { ClientBridge } from '../adapters/bun/client-bridge';
8
+ import { ConfigBuilder } from '../config/config-builder';
9
+ import { InMemoryDevGraphService, setAppDevGraphService } from '../services/runtime-state/dev-graph.service';
10
+ import { createMockHmrManager, createMockBridge } from './project-watcher.test-helpers';
11
+
12
+ const createMockConfig = async (rootDir = '/test/project'): Promise<EcoPagesAppConfig> => {
13
+ return await new ConfigBuilder().setRootDir(rootDir).build();
14
+ };
15
+
16
+ describe('ProjectWatcher', () => {
17
+ let watcher: ProjectWatcher;
18
+ let Config: EcoPagesAppConfig;
19
+ let HmrManager: IHmrManager;
20
+ let Bridge: ClientBridge;
21
+ let RefreshCallback: any;
22
+
23
+ beforeEach(async () => {
24
+ Config = await createMockConfig();
25
+ setAppDevGraphService(Config, new InMemoryDevGraphService());
26
+ HmrManager = createMockHmrManager();
27
+ Bridge = createMockBridge();
28
+ RefreshCallback = vi.fn(() => {});
29
+
30
+ watcher = new ProjectWatcher({
31
+ config: Config,
32
+ refreshRouterRoutesCallback: RefreshCallback,
33
+ hmrManager: HmrManager,
34
+ bridge: Bridge,
35
+ });
36
+ });
37
+
38
+ afterEach(() => {
39
+ vi.restoreAllMocks();
40
+ });
41
+
42
+ describe('constructor', () => {
43
+ test('should initialize with provided config', () => {
44
+ expect(watcher).toBeDefined();
45
+ });
46
+
47
+ test('should bind callback methods correctly', () => {
48
+ expect(typeof watcher.triggerRouterRefresh).toBe('function');
49
+ expect(typeof watcher.handleError).toBe('function');
50
+ });
51
+ });
52
+
53
+ describe('triggerRouterRefresh', () => {
54
+ test('should call refresh callback for page directory changes', () => {
55
+ const pagePath = path.join(Config.absolutePaths.pagesDir, 'index.tsx');
56
+ watcher.triggerRouterRefresh(pagePath);
57
+
58
+ expect(RefreshCallback).toHaveBeenCalled();
59
+ });
60
+
61
+ test('should not call refresh callback for stylesheet assets inside the pages directory', () => {
62
+ const stylesheetPath = path.join(Config.absolutePaths.pagesDir, 'index.css');
63
+ watcher.triggerRouterRefresh(stylesheetPath);
64
+
65
+ expect(RefreshCallback).not.toHaveBeenCalled();
66
+ });
67
+
68
+ test('should not call refresh callback for non-page directory changes', () => {
69
+ const nonPagePath = '/test/project/src/components/Button.tsx';
70
+ watcher.triggerRouterRefresh(nonPagePath);
71
+
72
+ expect(RefreshCallback).not.toHaveBeenCalled();
73
+ });
74
+ });
75
+
76
+ describe('handleError', () => {
77
+ test('should broadcast error message and log', () => {
78
+ const error = new Error('Test error');
79
+ watcher.handleError(error);
80
+
81
+ expect(HmrManager.broadcast).toHaveBeenCalledWith({
82
+ type: 'error',
83
+ message: 'Test error',
84
+ });
85
+ });
86
+
87
+ test('should handle non-Error objects', () => {
88
+ watcher.handleError('string error');
89
+
90
+ expect(HmrManager.broadcast).not.toHaveBeenCalled();
91
+ });
92
+ });
93
+ });
94
+
95
+ describe('ProjectWatcher - File Change Handling', () => {
96
+ let watcher: ProjectWatcher;
97
+ let Config: EcoPagesAppConfig;
98
+ let HmrManager: IHmrManager;
99
+ let Bridge: ClientBridge;
100
+ let RefreshCallback: any;
101
+
102
+ beforeEach(async () => {
103
+ Config = await createMockConfig();
104
+ setAppDevGraphService(Config, new InMemoryDevGraphService());
105
+ HmrManager = createMockHmrManager();
106
+ Bridge = createMockBridge();
107
+ RefreshCallback = vi.fn(() => {});
108
+
109
+ watcher = new ProjectWatcher({
110
+ config: Config as EcoPagesAppConfig,
111
+ refreshRouterRoutesCallback: RefreshCallback,
112
+ hmrManager: HmrManager,
113
+ bridge: Bridge,
114
+ });
115
+ });
116
+
117
+ afterEach(() => {
118
+ vi.restoreAllMocks();
119
+ });
120
+
121
+ test('should only invalidate server modules for route and server source changes', async () => {
122
+ const pageFilePath = path.join(Config.absolutePaths.pagesDir, 'about.tsx');
123
+ const cssFilePath = path.join(Config.absolutePaths.srcDir, 'styles', 'main.css');
124
+ const serverInvalidationState = Config.runtime?.serverInvalidationState as InMemoryDevGraphService;
125
+
126
+ Config.processors.set('css', {
127
+ getWatchConfig: vi.fn(() => ({
128
+ paths: ['/test/project/src'],
129
+ extensions: ['.css'],
130
+ })),
131
+ getAssetCapabilities: vi.fn(() => [{ kind: 'stylesheet', extensions: ['*.css'] }]),
132
+ canProcessAsset: vi.fn(
133
+ (kind: string, filepath?: string) => kind === 'stylesheet' && filepath?.endsWith('.css'),
134
+ ),
135
+ matchesFileFilter: vi.fn((filepath: string) => filepath.endsWith('.css')),
136
+ } as never);
137
+
138
+ expect(serverInvalidationState.getServerInvalidationVersion()).toBe(0);
139
+
140
+ await (watcher as any).handleFileChange(pageFilePath);
141
+ expect(serverInvalidationState.getServerInvalidationVersion()).toBe(1);
142
+
143
+ await (watcher as any).handleFileChange(cssFilePath);
144
+ expect(serverInvalidationState.getServerInvalidationVersion()).toBe(1);
145
+ });
146
+
147
+ describe('public directory files', () => {
148
+ test('should handle public file changes with single-file copy', async () => {
149
+ const publicFilePath = path.join(Config.absolutePaths.publicDir, 'favicon.ico');
150
+
151
+ await (watcher as any).handleFileChange(publicFilePath);
152
+
153
+ expect(Bridge.reload).toHaveBeenCalled();
154
+ expect(HmrManager.handleFileChange).not.toHaveBeenCalled();
155
+ });
156
+
157
+ test('should handle public file in subdirectory', async () => {
158
+ const publicFilePath = path.join(Config.absolutePaths.publicDir, 'images', 'logo.png');
159
+
160
+ await (watcher as any).handleFileChange(publicFilePath);
161
+
162
+ expect(Bridge.reload).toHaveBeenCalled();
163
+ });
164
+
165
+ test('should not call uncacheModules for public files', async () => {
166
+ const publicFilePath = path.join(Config.absolutePaths.publicDir, 'robots.txt');
167
+
168
+ await (watcher as any).handleFileChange(publicFilePath);
169
+
170
+ expect(HmrManager.handleFileChange).not.toHaveBeenCalled();
171
+ });
172
+ });
173
+
174
+ describe('page files', () => {
175
+ test('should refresh router for page file changes', async () => {
176
+ const pageFilePath = path.join(Config.absolutePaths.pagesDir, 'about.tsx');
177
+
178
+ await (watcher as any).handleFileChange(pageFilePath);
179
+
180
+ expect(RefreshCallback).toHaveBeenCalled();
181
+ });
182
+
183
+ test('should call HMR manager for page file changes', async () => {
184
+ const pageFilePath = path.join(Config.absolutePaths.pagesDir, 'contact.tsx');
185
+
186
+ await (watcher as any).handleFileChange(pageFilePath);
187
+
188
+ expect(HmrManager.handleFileChange).toHaveBeenCalledWith(path.resolve(pageFilePath));
189
+ });
190
+
191
+ test('should not refresh router for stylesheet changes inside the pages directory', async () => {
192
+ const pageCssPath = path.join(Config.absolutePaths.pagesDir, 'index.css');
193
+
194
+ await (watcher as any).handleFileChange(pageCssPath);
195
+
196
+ expect(RefreshCallback).not.toHaveBeenCalled();
197
+ });
198
+
199
+ test('should ignore duplicate save events for the same page within the debounce window', async () => {
200
+ const pageFilePath = path.join(Config.absolutePaths.pagesDir, 'contact.tsx');
201
+ const nowSpy = vi.spyOn(Date, 'now');
202
+ nowSpy.mockReturnValueOnce(1000).mockReturnValueOnce(1050);
203
+
204
+ await (watcher as any).handleFileChange(pageFilePath);
205
+ await (watcher as any).handleFileChange(pageFilePath);
206
+
207
+ expect(HmrManager.handleFileChange).toHaveBeenCalledTimes(1);
208
+ expect(RefreshCallback).toHaveBeenCalledTimes(1);
209
+ });
210
+ });
211
+
212
+ describe('include files', () => {
213
+ test('should reload for include template changes', async () => {
214
+ const includeFilePath = path.join(Config.absolutePaths.includesDir, 'seo.kita.tsx');
215
+
216
+ await (watcher as any).handleFileChange(includeFilePath);
217
+
218
+ expect(Bridge.reload).toHaveBeenCalledTimes(1);
219
+ expect(HmrManager.handleFileChange).not.toHaveBeenCalled();
220
+ expect(RefreshCallback).not.toHaveBeenCalled();
221
+ });
222
+
223
+ test('should notify processors before reloading include template changes', async () => {
224
+ const onChange = vi.fn(async () => {});
225
+ const Processor = {
226
+ getWatchConfig: vi.fn(() => ({
227
+ paths: ['/test/project/src'],
228
+ extensions: ['.css', '.tsx'],
229
+ onChange,
230
+ })),
231
+ getAssetCapabilities: vi.fn(() => [{ kind: 'stylesheet', extensions: ['*.css'] }]),
232
+ canProcessAsset: vi.fn((kind: string, filepath?: string) => {
233
+ return kind === 'stylesheet' && filepath?.endsWith('.css');
234
+ }),
235
+ matchesFileFilter: vi.fn((filepath: string) => filepath.endsWith('.css')),
236
+ };
237
+ Config.processors.set('css', Processor as any);
238
+
239
+ const includeFilePath = path.join(Config.absolutePaths.includesDir, 'seo.kita.tsx');
240
+
241
+ await (watcher as any).handleFileChange(includeFilePath);
242
+
243
+ expect(onChange).toHaveBeenCalledWith({ path: path.resolve(includeFilePath), bridge: Bridge });
244
+ expect(Bridge.reload).toHaveBeenCalledTimes(1);
245
+ expect(HmrManager.handleFileChange).not.toHaveBeenCalled();
246
+ });
247
+ });
248
+
249
+ describe('additionalWatchPaths', () => {
250
+ test('should reload for files matching additionalWatchPaths pattern', async () => {
251
+ Config.additionalWatchPaths = ['**/*.config.ts'];
252
+ const configFilePath = '/test/project/app.config.ts';
253
+
254
+ await (watcher as any).handleFileChange(configFilePath);
255
+
256
+ expect(Bridge.reload).toHaveBeenCalled();
257
+ expect(HmrManager.handleFileChange).not.toHaveBeenCalled();
258
+ });
259
+
260
+ test('should reload for exact path matches', async () => {
261
+ const exactPath = '/test/project/tailwind.config.ts';
262
+ Config.additionalWatchPaths = [exactPath];
263
+
264
+ await (watcher as any).handleFileChange(exactPath);
265
+
266
+ expect(Bridge.reload).toHaveBeenCalled();
267
+ });
268
+
269
+ test('should not reload for non-matching paths', async () => {
270
+ Config.additionalWatchPaths = ['**/*.config.ts'];
271
+ const nonMatchingPath = '/test/project/src/components/Button.tsx';
272
+
273
+ await (watcher as any).handleFileChange(nonMatchingPath);
274
+
275
+ expect(HmrManager.handleFileChange).toHaveBeenCalled();
276
+ });
277
+ });
278
+
279
+ describe('processor-handled files', () => {
280
+ test('should skip HMR for processor-handled extensions', async () => {
281
+ const onChange = vi.fn(async () => {});
282
+ const Processor = {
283
+ getWatchConfig: vi.fn(() => ({
284
+ paths: ['/test/project/src'],
285
+ extensions: ['.css', '.scss'],
286
+ onChange,
287
+ })),
288
+ };
289
+ Config.processors.set('css', Processor as any);
290
+
291
+ const cssFilePath = '/test/project/src/styles/main.css';
292
+
293
+ await (watcher as any).handleFileChange(cssFilePath);
294
+
295
+ expect(onChange).toHaveBeenCalledWith({ path: path.resolve(cssFilePath), bridge: Bridge });
296
+ expect(HmrManager.handleFileChange).not.toHaveBeenCalled();
297
+ });
298
+
299
+ test('should process files through HMR when not handled by processor', async () => {
300
+ const Processor = {
301
+ getWatchConfig: vi.fn(() => ({
302
+ paths: ['/test/project/src'],
303
+ extensions: ['.css'],
304
+ })),
305
+ };
306
+ Config.processors.set('css', Processor as any);
307
+
308
+ const jsFilePath = '/test/project/src/app.js';
309
+
310
+ await (watcher as any).handleFileChange(jsFilePath);
311
+
312
+ expect(HmrManager.handleFileChange).toHaveBeenCalledWith(path.resolve(jsFilePath));
313
+ });
314
+
315
+ test('should keep TSX changes in HMR when a processor only handles stylesheet assets', async () => {
316
+ const onChange = vi.fn(async () => {});
317
+ const Processor = {
318
+ getWatchConfig: vi.fn(() => ({
319
+ paths: ['/test/project/src'],
320
+ extensions: ['.css', '.tsx'],
321
+ onChange,
322
+ })),
323
+ getAssetCapabilities: vi.fn(() => [{ kind: 'stylesheet', extensions: ['*.css'] }]),
324
+ canProcessAsset: vi.fn((kind: string, filepath?: string) => {
325
+ return kind === 'stylesheet' && filepath?.endsWith('.css');
326
+ }),
327
+ matchesFileFilter: vi.fn((filepath: string) => filepath.endsWith('.css')),
328
+ };
329
+ Config.processors.set('css', Processor as any);
330
+
331
+ const tsxFilePath = '/test/project/src/components/Button.tsx';
332
+
333
+ await (watcher as any).handleFileChange(tsxFilePath);
334
+
335
+ expect(onChange).toHaveBeenCalledWith({ path: path.resolve(tsxFilePath), bridge: Bridge });
336
+ expect(HmrManager.handleFileChange).toHaveBeenCalledWith(path.resolve(tsxFilePath));
337
+ });
338
+
339
+ test('should route TSX through HMR even when no specific strategy matches', async () => {
340
+ const onChange = vi.fn(async () => {});
341
+ const Processor = {
342
+ getWatchConfig: vi.fn(() => ({
343
+ paths: ['/test/project/src'],
344
+ extensions: ['.css', '.tsx'],
345
+ onChange,
346
+ })),
347
+ getAssetCapabilities: vi.fn(() => [{ kind: 'stylesheet', extensions: ['*.css'] }]),
348
+ canProcessAsset: vi.fn((kind: string, filepath?: string) => {
349
+ return kind === 'stylesheet' && filepath?.endsWith('.css');
350
+ }),
351
+ matchesFileFilter: vi.fn((filepath: string) => filepath.endsWith('.css')),
352
+ };
353
+ Config.processors.set('css', Processor as any);
354
+
355
+ const tsxFilePath = '/test/project/src/components/Button.tsx';
356
+
357
+ await (watcher as any).handleFileChange(tsxFilePath);
358
+
359
+ expect(onChange).toHaveBeenCalled();
360
+ expect(HmrManager.handleFileChange).toHaveBeenCalledWith(path.resolve(tsxFilePath));
361
+ expect(HmrManager.broadcast).not.toHaveBeenCalledWith({ type: 'layout-update' });
362
+ });
363
+
364
+ test('should handle processor without watchConfig', async () => {
365
+ const Processor = {
366
+ getWatchConfig: vi.fn(() => null),
367
+ };
368
+ Config.processors.set('no-watch', Processor as any);
369
+
370
+ const filePath = '/test/project/src/app.js';
371
+
372
+ await (watcher as any).handleFileChange(filePath);
373
+
374
+ expect(HmrManager.handleFileChange).toHaveBeenCalled();
375
+ });
376
+ });
377
+
378
+ describe('error handling', () => {
379
+ test('should handle errors during file change processing', async () => {
380
+ HmrManager.handleFileChange = vi.fn(async () => {
381
+ throw new Error('HMR error');
382
+ });
383
+
384
+ const filePath = '/test/project/src/app.js';
385
+
386
+ await (watcher as any).handleFileChange(filePath);
387
+
388
+ expect(Bridge.error).toHaveBeenCalledWith('HMR error');
389
+ });
390
+
391
+ test('should continue processing after error', async () => {
392
+ HmrManager.handleFileChange = vi.fn(async () => {
393
+ throw new Error('Processing failed');
394
+ });
395
+
396
+ const filePath = '/test/project/src/app.js';
397
+
398
+ await (watcher as any).handleFileChange(filePath);
399
+
400
+ expect(Bridge.error).toHaveBeenCalledWith('Processing failed');
401
+ });
402
+ });
403
+ });
404
+
405
+ describe('ProjectWatcher - Priority Rules', () => {
406
+ let watcher: ProjectWatcher;
407
+ let Config: EcoPagesAppConfig;
408
+ let HmrManager: IHmrManager;
409
+ let Bridge: ClientBridge;
410
+
411
+ beforeEach(async () => {
412
+ Config = await createMockConfig();
413
+ setAppDevGraphService(Config, new InMemoryDevGraphService());
414
+ HmrManager = createMockHmrManager();
415
+ Bridge = createMockBridge();
416
+
417
+ watcher = new ProjectWatcher({
418
+ config: Config as EcoPagesAppConfig,
419
+ refreshRouterRoutesCallback: vi.fn(() => {}),
420
+ hmrManager: HmrManager,
421
+ bridge: Bridge,
422
+ });
423
+ });
424
+
425
+ afterEach(() => {
426
+ vi.restoreAllMocks();
427
+ });
428
+
429
+ test('should prioritize public dir over additionalWatchPaths', async () => {
430
+ Config.additionalWatchPaths = ['**/*'];
431
+ const publicFilePath = path.join(Config.absolutePaths.publicDir, 'icon.png');
432
+
433
+ await (watcher as any).handleFileChange(publicFilePath);
434
+
435
+ expect(Bridge.reload).toHaveBeenCalledTimes(1);
436
+ expect(HmrManager.handleFileChange).not.toHaveBeenCalled();
437
+ });
438
+
439
+ test('should prioritize additionalWatchPaths over processors', async () => {
440
+ Config.additionalWatchPaths = ['**/*.config.ts'];
441
+ const Processor = {
442
+ getWatchConfig: vi.fn(() => ({
443
+ paths: ['/test/project'],
444
+ extensions: ['.ts'],
445
+ })),
446
+ };
447
+ Config.processors.set('ts', Processor as any);
448
+
449
+ const configFilePath = '/test/project/app.config.ts';
450
+
451
+ await (watcher as any).handleFileChange(configFilePath);
452
+
453
+ expect(Bridge.reload).toHaveBeenCalled();
454
+ expect(HmrManager.handleFileChange).not.toHaveBeenCalled();
455
+ });
456
+
457
+ test('should prioritize processors over HMR strategies', async () => {
458
+ const Processor = {
459
+ getWatchConfig: vi.fn(() => ({
460
+ paths: ['/test/project/src'],
461
+ extensions: ['.mdx'],
462
+ })),
463
+ };
464
+ Config.processors.set('mdx', Processor as any);
465
+
466
+ const mdxFilePath = '/test/project/src/content.mdx';
467
+
468
+ await (watcher as any).handleFileChange(mdxFilePath);
469
+
470
+ expect(HmrManager.handleFileChange).not.toHaveBeenCalled();
471
+ });
472
+
473
+ test('should use HMR as final fallback', async () => {
474
+ const regularFilePath = '/test/project/src/components/Button.tsx';
475
+
476
+ await (watcher as any).handleFileChange(regularFilePath);
477
+
478
+ expect(HmrManager.handleFileChange).toHaveBeenCalled();
479
+ });
480
+
481
+ test('should notify processor for dependency file before proceeding to HMR', async () => {
482
+ const onChange = vi.fn(async () => {});
483
+ const Processor = {
484
+ getWatchConfig: vi.fn(() => ({
485
+ paths: ['/test/project/src'],
486
+ extensions: ['.css', '.tsx'],
487
+ onChange,
488
+ })),
489
+ getAssetCapabilities: vi.fn(() => [{ kind: 'stylesheet', extensions: ['*.css'] }]),
490
+ canProcessAsset: vi.fn((kind: string, filepath?: string) => {
491
+ return kind === 'stylesheet' && filepath?.endsWith('.css');
492
+ }),
493
+ matchesFileFilter: vi.fn((filepath: string) => filepath.endsWith('.css')),
494
+ };
495
+ Config.processors.set('css', Processor as any);
496
+
497
+ const tsxFilePath = '/test/project/src/components/Button.tsx';
498
+
499
+ await (watcher as any).handleFileChange(tsxFilePath);
500
+
501
+ expect(onChange).toHaveBeenCalledWith({ path: path.resolve(tsxFilePath), bridge: Bridge });
502
+ expect(HmrManager.handleFileChange).toHaveBeenCalledWith(path.resolve(tsxFilePath));
503
+ });
504
+ });
505
+
506
+ describe('ProjectWatcher - Helper Methods', () => {
507
+ let watcher: ProjectWatcher;
508
+ let Config: EcoPagesAppConfig;
509
+
510
+ beforeEach(async () => {
511
+ Config = await createMockConfig();
512
+ setAppDevGraphService(Config, new InMemoryDevGraphService());
513
+ watcher = new ProjectWatcher({
514
+ config: Config as EcoPagesAppConfig,
515
+ refreshRouterRoutesCallback: vi.fn(() => {}),
516
+ hmrManager: createMockHmrManager(),
517
+ bridge: createMockBridge(),
518
+ });
519
+ });
520
+
521
+ describe('isPublicDirFile', () => {
522
+ test('should return true for files in public directory', () => {
523
+ const publicFile = path.join(Config.absolutePaths.publicDir, 'favicon.ico');
524
+ const result = (watcher as any).isPublicDirFile(publicFile);
525
+ expect(result).toBe(true);
526
+ });
527
+
528
+ test('should return false for files outside public directory', () => {
529
+ const srcFile = path.join(Config.absolutePaths.srcDir, 'app.tsx');
530
+ const result = (watcher as any).isPublicDirFile(srcFile);
531
+ expect(result).toBe(false);
532
+ });
533
+ });
534
+
535
+ describe('matchesAdditionalWatchPaths', () => {
536
+ test('should match wildcard patterns', () => {
537
+ Config.additionalWatchPaths = ['**/*.config.ts'];
538
+ const result = (watcher as any).matchesAdditionalWatchPaths('/test/app.config.ts');
539
+ expect(result).toBe(true);
540
+ });
541
+
542
+ test('should match exact paths', () => {
543
+ const exactPath = '/test/project/tailwind.config.ts';
544
+ Config.additionalWatchPaths = [exactPath];
545
+ const result = (watcher as any).matchesAdditionalWatchPaths(exactPath);
546
+ expect(result).toBe(true);
547
+ });
548
+
549
+ test('should return false when no patterns match', () => {
550
+ Config.additionalWatchPaths = ['**/*.config.ts'];
551
+ const result = (watcher as any).matchesAdditionalWatchPaths('/test/app.tsx');
552
+ expect(result).toBe(false);
553
+ });
554
+
555
+ test('should return false when additionalWatchPaths is empty', () => {
556
+ Config.additionalWatchPaths = [];
557
+ const result = (watcher as any).matchesAdditionalWatchPaths('/test/app.tsx');
558
+ expect(result).toBe(false);
559
+ });
560
+ });
561
+
562
+ describe('isIncludeSourceFile', () => {
563
+ test('should return true for files in includes directory', () => {
564
+ const includeFile = path.join(Config.absolutePaths.includesDir, 'seo.kita.tsx');
565
+ const result = (watcher as any).isIncludeSourceFile(includeFile);
566
+ expect(result).toBe(true);
567
+ });
568
+
569
+ test('should return false for files outside includes directory', () => {
570
+ const srcFile = path.join(Config.absolutePaths.srcDir, 'components', 'Button.tsx');
571
+ const result = (watcher as any).isIncludeSourceFile(srcFile);
572
+ expect(result).toBe(false);
573
+ });
574
+ });
575
+
576
+ describe('isHandledByProcessor', () => {
577
+ test('should return true when file extension matches processor', () => {
578
+ const Processor = {
579
+ getWatchConfig: vi.fn(() => ({
580
+ paths: ['/test/project/src'],
581
+ extensions: ['.css', '.scss'],
582
+ })),
583
+ };
584
+ Config.processors.set('css', Processor as any);
585
+
586
+ const result = (watcher as any).isHandledByProcessor('/test/styles/main.css');
587
+ expect(result).toBe(true);
588
+ });
589
+
590
+ test('should return false when no processor handles the extension', () => {
591
+ const Processor = {
592
+ getWatchConfig: vi.fn(() => ({
593
+ paths: ['/test/project/src'],
594
+ extensions: ['.css'],
595
+ })),
596
+ };
597
+ Config.processors.set('css', Processor as any);
598
+
599
+ const result = (watcher as any).isHandledByProcessor('/test/app.tsx');
600
+ expect(result).toBe(false);
601
+ });
602
+
603
+ test('should handle processor without watchConfig', () => {
604
+ const Processor = {
605
+ getWatchConfig: vi.fn(() => null),
606
+ };
607
+ Config.processors.set('no-watch', Processor as any);
608
+
609
+ const result = (watcher as any).isHandledByProcessor('/test/app.tsx');
610
+ expect(result).toBe(false);
611
+ });
612
+
613
+ test('should handle processor with empty extensions array', () => {
614
+ const Processor = {
615
+ getWatchConfig: vi.fn(() => ({
616
+ paths: ['/test/project/src'],
617
+ extensions: [],
618
+ })),
619
+ };
620
+ Config.processors.set('empty', Processor as any);
621
+
622
+ const result = (watcher as any).isHandledByProcessor('/test/app.tsx');
623
+ expect(result).toBe(false);
624
+ });
625
+ });
626
+ });
627
+
628
+ describe('ProjectWatcher - Watch Subscriptions', () => {
629
+ afterEach(() => {
630
+ vi.restoreAllMocks();
631
+ });
632
+
633
+ test('should watch includes and src directories alongside pages and processor paths', async () => {
634
+ const Config = await createMockConfig();
635
+ setAppDevGraphService(Config, new InMemoryDevGraphService());
636
+ const HmrManager = createMockHmrManager();
637
+ const Bridge = createMockBridge();
638
+ vi.spyOn(fileSystem, 'exists').mockImplementation((targetPath) =>
639
+ [Config.absolutePaths.includesDir, Config.absolutePaths.srcDir, Config.absolutePaths.pagesDir].includes(
640
+ String(targetPath),
641
+ ),
642
+ );
643
+ const watcherHandle = {
644
+ add: vi.fn(),
645
+ on: vi.fn().mockReturnThis(),
646
+ close: vi.fn(),
647
+ };
648
+ const chokidarWatch = vi.fn(() => watcherHandle);
649
+
650
+ vi.spyOn(chokidar, 'watch').mockImplementation(chokidarWatch as never);
651
+
652
+ Config.processors.set('css', {
653
+ getWatchConfig: vi.fn(() => ({
654
+ paths: ['/test/project/custom-watch'],
655
+ extensions: ['.css'],
656
+ })),
657
+ } as never);
658
+
659
+ const watcher = new ProjectWatcher({
660
+ config: Config,
661
+ refreshRouterRoutesCallback: vi.fn(() => {}),
662
+ hmrManager: HmrManager,
663
+ bridge: Bridge,
664
+ });
665
+
666
+ await watcher.createWatcherSubscription();
667
+
668
+ expect(chokidarWatch).toHaveBeenCalledWith(
669
+ expect.arrayContaining([
670
+ '/test/project/custom-watch',
671
+ Config.absolutePaths.includesDir,
672
+ Config.absolutePaths.pagesDir,
673
+ ]),
674
+ expect.any(Object),
675
+ );
676
+ expect(watcherHandle.add).toHaveBeenCalledWith(Config.absolutePaths.srcDir);
677
+ });
678
+ });