@ecopages/core 0.2.0-alpha.24 → 0.2.0-alpha.26

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