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

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 (550) hide show
  1. package/README.md +63 -7
  2. package/package.json +73 -249
  3. package/src/adapters/abstract/application-adapter.test.ts +172 -0
  4. package/src/adapters/abstract/application-adapter.ts +379 -0
  5. package/src/adapters/abstract/router-adapter.ts +30 -0
  6. package/src/adapters/abstract/server-adapter.ts +79 -0
  7. package/src/adapters/bun/client-bridge.ts +62 -0
  8. package/src/adapters/bun/create-app.ts +232 -0
  9. package/src/adapters/bun/hmr-manager.test.ts +265 -0
  10. package/src/adapters/bun/hmr-manager.ts +383 -0
  11. package/src/adapters/bun/index.ts +2 -0
  12. package/src/adapters/bun/server-adapter.ts +526 -0
  13. package/src/adapters/bun/server-lifecycle.ts +124 -0
  14. package/src/adapters/create-app.test.ts +10 -0
  15. package/src/adapters/create-app.ts +91 -0
  16. package/src/adapters/index.ts +2 -0
  17. package/src/adapters/node/create-app.test.ts +53 -0
  18. package/src/adapters/node/create-app.ts +183 -0
  19. package/src/adapters/node/node-client-bridge.test.ts +198 -0
  20. package/src/adapters/node/node-client-bridge.ts +79 -0
  21. package/src/adapters/node/node-hmr-manager.test.ts +320 -0
  22. package/src/adapters/node/node-hmr-manager.ts +355 -0
  23. package/src/adapters/node/server-adapter.ts +502 -0
  24. package/src/adapters/node/static-content-server.test.ts +60 -0
  25. package/src/adapters/node/static-content-server.ts +239 -0
  26. package/src/adapters/shared/api-response.test.ts +97 -0
  27. package/src/adapters/shared/api-response.ts +104 -0
  28. package/src/adapters/shared/application-adapter.ts +199 -0
  29. package/src/adapters/shared/define-api-handler.ts +66 -0
  30. package/src/adapters/shared/explicit-static-render-preparation.ts +58 -0
  31. package/src/adapters/shared/explicit-static-route-matcher.test.ts +381 -0
  32. package/src/adapters/shared/explicit-static-route-matcher.ts +131 -0
  33. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +85 -0
  34. package/src/adapters/shared/file-route-middleware-pipeline.ts +118 -0
  35. package/src/adapters/shared/fs-server-response-factory.test.ts +176 -0
  36. package/src/adapters/shared/fs-server-response-factory.ts +96 -0
  37. package/src/adapters/shared/fs-server-response-matcher.test.ts +311 -0
  38. package/src/adapters/shared/fs-server-response-matcher.ts +240 -0
  39. package/src/adapters/shared/hmr-entrypoint-registrar.ts +149 -0
  40. package/src/adapters/shared/hmr-html-response.ts +52 -0
  41. package/src/adapters/shared/hmr-manager.contract.test.ts +228 -0
  42. package/src/adapters/shared/hmr-manager.dispatch.test.ts +220 -0
  43. package/src/adapters/shared/render-context.test.ts +150 -0
  44. package/src/adapters/shared/render-context.ts +123 -0
  45. package/src/adapters/shared/runtime-bootstrap.ts +79 -0
  46. package/src/adapters/shared/server-adapter.test.ts +130 -0
  47. package/src/adapters/shared/server-adapter.ts +562 -0
  48. package/src/adapters/shared/server-route-handler.test.ts +111 -0
  49. package/src/adapters/shared/server-route-handler.ts +153 -0
  50. package/src/adapters/shared/server-static-builder.test.ts +338 -0
  51. package/src/adapters/shared/server-static-builder.ts +170 -0
  52. package/src/build/build-adapter-serialization.test.ts +281 -0
  53. package/src/build/build-adapter.test.ts +1240 -0
  54. package/src/build/build-adapter.ts +1012 -0
  55. package/src/build/build-manifest.ts +54 -0
  56. package/src/build/build-types.ts +83 -0
  57. package/src/build/dev-build-coordinator.ts +220 -0
  58. package/src/build/esbuild-build-adapter.ts +660 -0
  59. package/src/build/runtime-build-executor.test.ts +81 -0
  60. package/src/build/runtime-build-executor.ts +40 -0
  61. package/src/build/runtime-specifier-alias-plugin.test.ts +67 -0
  62. package/src/build/runtime-specifier-alias-plugin.ts +62 -0
  63. package/src/build/runtime-specifier-aliases.ts +135 -0
  64. package/src/config/README.md +1 -1
  65. package/src/config/config-builder.test.ts +442 -0
  66. package/src/config/config-builder.ts +737 -0
  67. package/src/config/config-builder.typecheck.test.ts +96 -0
  68. package/src/config/{constants.d.ts → constants.ts} +22 -13
  69. package/src/dev/host-runtime.ts +34 -0
  70. package/src/dev/sc-server.ts +143 -0
  71. package/src/eco/eco.browser.test.ts +43 -0
  72. package/src/eco/eco.browser.ts +118 -0
  73. package/src/eco/eco.test.ts +654 -0
  74. package/src/eco/eco.ts +205 -0
  75. package/src/eco/eco.types.ts +221 -0
  76. package/src/eco/eco.utils.test.ts +219 -0
  77. package/src/eco/eco.utils.ts +5 -0
  78. package/src/eco/global-injector-map.test.ts +42 -0
  79. package/src/eco/global-injector-map.ts +112 -0
  80. package/src/eco/lazy-injector-map.test.ts +66 -0
  81. package/src/eco/lazy-injector-map.ts +120 -0
  82. package/src/eco/module-dependencies.test.ts +30 -0
  83. package/src/eco/module-dependencies.ts +75 -0
  84. package/src/errors/http-error.test.ts +134 -0
  85. package/src/errors/http-error.ts +72 -0
  86. package/src/errors/index.ts +3 -0
  87. package/src/errors/locals-access-error.ts +7 -0
  88. package/src/global/app-logger.ts +4 -0
  89. package/src/global/utils.test.ts +12 -0
  90. 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
  91. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  92. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  93. package/src/hmr/client/hmr-runtime.ts +162 -0
  94. package/src/hmr/hmr-strategy.test.ts +124 -0
  95. package/src/hmr/hmr-strategy.ts +177 -0
  96. package/src/hmr/hmr.postcss.test.e2e.ts +41 -0
  97. package/src/hmr/hmr.test.e2e.ts +66 -0
  98. package/src/hmr/strategies/default-hmr-strategy.ts +60 -0
  99. package/src/hmr/strategies/js-hmr-strategy.test.ts +334 -0
  100. package/src/hmr/strategies/js-hmr-strategy.ts +314 -0
  101. package/src/index.browser.ts +3 -0
  102. package/src/index.ts +15 -0
  103. package/src/integrations/ghtml/ghtml-renderer.test.ts +253 -0
  104. package/src/integrations/ghtml/ghtml-renderer.ts +87 -0
  105. package/src/integrations/ghtml/ghtml.constants.ts +1 -0
  106. package/src/integrations/ghtml/ghtml.plugin.ts +28 -0
  107. package/src/plugins/alias-resolver-plugin.test.ts +41 -0
  108. package/src/plugins/alias-resolver-plugin.ts +63 -0
  109. package/src/plugins/eco-component-meta-plugin.test.ts +406 -0
  110. package/src/plugins/eco-component-meta-plugin.ts +494 -0
  111. package/src/plugins/foreign-jsx-override-plugin.test.ts +65 -0
  112. package/src/plugins/foreign-jsx-override-plugin.ts +67 -0
  113. package/src/plugins/integration-plugin.test.ts +151 -0
  114. package/src/plugins/integration-plugin.ts +323 -0
  115. package/src/plugins/processor.test.ts +148 -0
  116. package/src/plugins/processor.ts +257 -0
  117. package/src/plugins/{runtime-capability.d.ts → runtime-capability.ts} +8 -3
  118. package/src/plugins/source-transform.test.ts +82 -0
  119. package/src/plugins/source-transform.ts +123 -0
  120. package/src/route-renderer/GRAPH.md +81 -289
  121. package/src/route-renderer/README.md +67 -105
  122. package/src/route-renderer/orchestration/component-render-context.ts +325 -0
  123. package/src/route-renderer/orchestration/declared-ownership-graph.ts +62 -0
  124. package/src/route-renderer/orchestration/foreign-subtree-execution.service.ts +383 -0
  125. package/src/route-renderer/orchestration/integration-renderer.test.ts +2085 -0
  126. package/src/route-renderer/orchestration/integration-renderer.ts +1244 -0
  127. package/src/route-renderer/orchestration/ownership-planning.service.ts +97 -0
  128. package/src/route-renderer/orchestration/ownership-validation.service.ts +76 -0
  129. package/src/route-renderer/orchestration/processed-asset-dedupe.ts +25 -0
  130. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.test.ts +324 -0
  131. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.ts +294 -0
  132. package/src/route-renderer/orchestration/render-output.utils.ts +310 -0
  133. package/src/route-renderer/orchestration/route-render-orchestrator.prepare-render-options.test.ts +644 -0
  134. package/src/route-renderer/orchestration/route-render-orchestrator.test.ts +265 -0
  135. package/src/route-renderer/orchestration/route-render-orchestrator.ts +592 -0
  136. package/src/route-renderer/orchestration/template-serialization.test.ts +110 -0
  137. package/src/route-renderer/orchestration/template-serialization.ts +117 -0
  138. package/src/route-renderer/page-loading/component-dependency-collection.ts +202 -0
  139. package/src/route-renderer/page-loading/declared-asset-collection.ts +153 -0
  140. package/src/route-renderer/page-loading/dependency-resolver.test.ts +761 -0
  141. package/src/route-renderer/page-loading/dependency-resolver.ts +144 -0
  142. package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +75 -0
  143. package/src/route-renderer/page-loading/lazy-entry-collection.ts +167 -0
  144. package/src/route-renderer/page-loading/lazy-trigger-planning.ts +74 -0
  145. package/src/route-renderer/page-loading/module-declaration-aggregation.ts +60 -0
  146. package/src/route-renderer/page-loading/module-declaration-scripts.ts +16 -0
  147. package/src/route-renderer/page-loading/page-dependency-bundling.ts +244 -0
  148. package/src/route-renderer/page-loading/page-module-loader.test.ts +183 -0
  149. package/src/route-renderer/page-loading/page-module-loader.ts +184 -0
  150. package/src/route-renderer/route-renderer.ts +133 -0
  151. package/src/router/README.md +16 -19
  152. package/src/router/client/link-intent.test.browser.ts +51 -0
  153. package/src/router/client/link-intent.ts +92 -0
  154. package/src/router/client/navigation-coordinator.test.ts +237 -0
  155. package/src/router/client/navigation-coordinator.ts +453 -0
  156. package/src/router/server/route-registry.test.ts +176 -0
  157. package/src/router/server/route-registry.ts +382 -0
  158. package/src/services/README.md +1 -2
  159. package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +66 -0
  160. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +473 -0
  161. package/src/services/assets/asset-processing-service/asset-processing.service.ts +344 -0
  162. package/src/services/assets/asset-processing-service/asset.factory.test.ts +63 -0
  163. package/src/services/assets/asset-processing-service/asset.factory.ts +105 -0
  164. package/src/services/assets/asset-processing-service/assets.types.ts +128 -0
  165. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +74 -0
  166. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +96 -0
  167. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +67 -0
  168. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +78 -0
  169. package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +104 -0
  170. package/src/services/assets/asset-processing-service/index.ts +6 -0
  171. package/src/services/assets/asset-processing-service/page-package.test.ts +100 -0
  172. package/src/services/assets/asset-processing-service/page-package.ts +93 -0
  173. package/src/services/assets/asset-processing-service/{processor.interface.d.ts → processor.interface.ts} +10 -5
  174. package/src/services/assets/asset-processing-service/processor.registry.ts +18 -0
  175. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +59 -0
  176. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +83 -0
  177. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +173 -0
  178. package/src/services/assets/asset-processing-service/processors/index.ts +5 -0
  179. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +195 -0
  180. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +137 -0
  181. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +326 -0
  182. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +116 -0
  183. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +227 -0
  184. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +89 -0
  185. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +261 -0
  186. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +72 -0
  187. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +83 -0
  188. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +65 -0
  189. package/src/services/assets/browser-bundle.service.test.ts +66 -0
  190. package/src/services/assets/browser-bundle.service.ts +109 -0
  191. package/src/services/cache/cache.types.ts +126 -0
  192. package/src/services/cache/index.ts +18 -0
  193. package/src/services/cache/memory-cache-store.test.ts +225 -0
  194. package/src/services/cache/memory-cache-store.ts +130 -0
  195. package/src/services/cache/page-cache-service.test.ts +175 -0
  196. package/src/services/cache/page-cache-service.ts +202 -0
  197. package/src/services/cache/page-request-cache-coordinator.service.test.ts +79 -0
  198. package/src/services/cache/page-request-cache-coordinator.service.ts +131 -0
  199. package/src/services/html/html-rewriter-provider.service.test.ts +183 -0
  200. package/src/services/html/html-rewriter-provider.service.ts +104 -0
  201. package/src/services/html/html-transformer.service.test.ts +476 -0
  202. package/src/services/html/html-transformer.service.ts +275 -0
  203. package/src/services/invalidation/development-invalidation.service.test.ts +87 -0
  204. package/src/services/invalidation/development-invalidation.service.ts +262 -0
  205. package/src/services/module-loading/app-module-loader.service.ts +9 -0
  206. package/src/services/module-loading/app-server-module-transpiler.service.test.ts +130 -0
  207. package/src/services/module-loading/app-server-module-transpiler.service.ts +141 -0
  208. package/src/services/module-loading/host-module-loader-registry.ts +15 -0
  209. package/src/services/module-loading/{module-loading-types.d.ts → module-loading-types.ts} +1 -0
  210. package/src/services/module-loading/node-bootstrap-plugin.test.ts +335 -0
  211. package/src/services/module-loading/node-bootstrap-plugin.ts +311 -0
  212. package/src/services/module-loading/page-module-import.service.test.ts +504 -0
  213. package/src/services/module-loading/page-module-import.service.ts +251 -0
  214. package/src/services/module-loading/server-module-transpiler.service.test.ts +243 -0
  215. package/src/services/module-loading/server-module-transpiler.service.ts +104 -0
  216. package/src/services/module-loading/source-module-support.ts +19 -0
  217. package/src/services/runtime-state/dev-graph.service.ts +217 -0
  218. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +136 -0
  219. package/src/services/runtime-state/server-invalidation-state.service.ts +68 -0
  220. package/src/services/validation/schema-validation-service.test.ts +223 -0
  221. package/src/services/validation/schema-validation-service.ts +204 -0
  222. package/src/services/validation/{standard-schema.types.d.ts → standard-schema.types.ts} +20 -17
  223. package/src/static-site-generator/static-site-generator.test.ts +408 -0
  224. package/src/static-site-generator/static-site-generator.ts +445 -0
  225. package/src/types/internal-types.ts +243 -0
  226. package/src/types/public-types.ts +1459 -0
  227. package/src/utils/deep-merge.test.ts +114 -0
  228. package/src/utils/deep-merge.ts +47 -0
  229. package/src/utils/hash.ts +5 -0
  230. package/src/utils/html-escaping.ts +9 -0
  231. package/src/utils/invariant.test.ts +22 -0
  232. package/src/utils/invariant.ts +15 -0
  233. package/src/utils/locals-utils.ts +37 -0
  234. package/src/utils/parse-cli-args.test.ts +69 -0
  235. package/src/utils/parse-cli-args.ts +105 -0
  236. package/src/utils/path-utils.module.ts +14 -0
  237. package/src/utils/path-utils.test.ts +15 -0
  238. package/src/utils/resolve-work-dir.ts +45 -0
  239. package/src/utils/runtime.ts +44 -0
  240. package/src/utils/server-utils.module.ts +67 -0
  241. package/src/utils/server-utils.test.ts +38 -0
  242. package/src/watchers/project-watcher.integration.test.ts +337 -0
  243. package/src/watchers/project-watcher.test-helpers.ts +42 -0
  244. package/src/watchers/project-watcher.test.ts +768 -0
  245. package/src/watchers/project-watcher.ts +357 -0
  246. package/CHANGELOG.md +0 -66
  247. package/src/adapters/abstract/application-adapter.d.ts +0 -194
  248. package/src/adapters/abstract/application-adapter.js +0 -121
  249. package/src/adapters/abstract/router-adapter.d.ts +0 -26
  250. package/src/adapters/abstract/router-adapter.js +0 -5
  251. package/src/adapters/abstract/server-adapter.d.ts +0 -69
  252. package/src/adapters/abstract/server-adapter.js +0 -15
  253. package/src/adapters/bun/client-bridge.d.ts +0 -34
  254. package/src/adapters/bun/client-bridge.js +0 -48
  255. package/src/adapters/bun/create-app.d.ts +0 -52
  256. package/src/adapters/bun/create-app.js +0 -116
  257. package/src/adapters/bun/hmr-manager.d.ts +0 -143
  258. package/src/adapters/bun/hmr-manager.js +0 -333
  259. package/src/adapters/bun/index.d.ts +0 -2
  260. package/src/adapters/bun/index.js +0 -8
  261. package/src/adapters/bun/server-adapter.d.ts +0 -155
  262. package/src/adapters/bun/server-adapter.js +0 -374
  263. package/src/adapters/bun/server-lifecycle.d.ts +0 -63
  264. package/src/adapters/bun/server-lifecycle.js +0 -92
  265. package/src/adapters/create-app.d.ts +0 -20
  266. package/src/adapters/create-app.js +0 -66
  267. package/src/adapters/index.d.ts +0 -2
  268. package/src/adapters/index.js +0 -8
  269. package/src/adapters/node/create-app.d.ts +0 -18
  270. package/src/adapters/node/create-app.js +0 -149
  271. package/src/adapters/node/node-client-bridge.d.ts +0 -26
  272. package/src/adapters/node/node-client-bridge.js +0 -66
  273. package/src/adapters/node/node-hmr-manager.d.ts +0 -133
  274. package/src/adapters/node/node-hmr-manager.js +0 -311
  275. package/src/adapters/node/server-adapter.d.ts +0 -162
  276. package/src/adapters/node/server-adapter.js +0 -368
  277. package/src/adapters/node/static-content-server.d.ts +0 -60
  278. package/src/adapters/node/static-content-server.js +0 -194
  279. package/src/adapters/shared/api-response.d.ts +0 -52
  280. package/src/adapters/shared/api-response.js +0 -96
  281. package/src/adapters/shared/application-adapter.d.ts +0 -18
  282. package/src/adapters/shared/application-adapter.js +0 -90
  283. package/src/adapters/shared/define-api-handler.d.ts +0 -25
  284. package/src/adapters/shared/define-api-handler.js +0 -15
  285. package/src/adapters/shared/explicit-static-route-matcher.d.ts +0 -38
  286. package/src/adapters/shared/explicit-static-route-matcher.js +0 -103
  287. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +0 -65
  288. package/src/adapters/shared/file-route-middleware-pipeline.js +0 -99
  289. package/src/adapters/shared/fs-server-response-factory.d.ts +0 -19
  290. package/src/adapters/shared/fs-server-response-factory.js +0 -97
  291. package/src/adapters/shared/fs-server-response-matcher.d.ts +0 -67
  292. package/src/adapters/shared/fs-server-response-matcher.js +0 -147
  293. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +0 -55
  294. package/src/adapters/shared/hmr-entrypoint-registrar.js +0 -87
  295. package/src/adapters/shared/hmr-html-response.d.ts +0 -22
  296. package/src/adapters/shared/hmr-html-response.js +0 -32
  297. package/src/adapters/shared/render-context.d.ts +0 -15
  298. package/src/adapters/shared/render-context.js +0 -72
  299. package/src/adapters/shared/runtime-bootstrap.d.ts +0 -38
  300. package/src/adapters/shared/runtime-bootstrap.js +0 -43
  301. package/src/adapters/shared/server-adapter.d.ts +0 -97
  302. package/src/adapters/shared/server-adapter.js +0 -390
  303. package/src/adapters/shared/server-route-handler.d.ts +0 -89
  304. package/src/adapters/shared/server-route-handler.js +0 -111
  305. package/src/adapters/shared/server-static-builder.d.ts +0 -71
  306. package/src/adapters/shared/server-static-builder.js +0 -100
  307. package/src/build/build-adapter.d.ts +0 -239
  308. package/src/build/build-adapter.js +0 -642
  309. package/src/build/build-manifest.d.ts +0 -27
  310. package/src/build/build-manifest.js +0 -30
  311. package/src/build/build-types.d.ts +0 -57
  312. package/src/build/build-types.js +0 -0
  313. package/src/build/dev-build-coordinator.d.ts +0 -72
  314. package/src/build/dev-build-coordinator.js +0 -154
  315. package/src/build/esbuild-build-adapter.d.ts +0 -78
  316. package/src/build/esbuild-build-adapter.js +0 -505
  317. package/src/build/runtime-build-executor.d.ts +0 -14
  318. package/src/build/runtime-build-executor.js +0 -22
  319. package/src/build/runtime-specifier-alias-plugin.d.ts +0 -15
  320. package/src/build/runtime-specifier-alias-plugin.js +0 -35
  321. package/src/build/runtime-specifier-aliases.d.ts +0 -5
  322. package/src/build/runtime-specifier-aliases.js +0 -95
  323. package/src/config/config-builder.d.ts +0 -252
  324. package/src/config/config-builder.js +0 -603
  325. package/src/config/constants.js +0 -25
  326. package/src/dev/sc-server.d.ts +0 -30
  327. package/src/dev/sc-server.js +0 -111
  328. package/src/eco/eco.browser.d.ts +0 -2
  329. package/src/eco/eco.browser.js +0 -83
  330. package/src/eco/eco.d.ts +0 -9
  331. package/src/eco/eco.js +0 -85
  332. package/src/eco/eco.types.d.ts +0 -178
  333. package/src/eco/eco.types.js +0 -0
  334. package/src/eco/eco.utils.d.ts +0 -1
  335. package/src/eco/eco.utils.js +0 -10
  336. package/src/eco/global-injector-map.d.ts +0 -16
  337. package/src/eco/global-injector-map.js +0 -80
  338. package/src/eco/lazy-injector-map.d.ts +0 -8
  339. package/src/eco/lazy-injector-map.js +0 -70
  340. package/src/eco/module-dependencies.d.ts +0 -18
  341. package/src/eco/module-dependencies.js +0 -49
  342. package/src/errors/http-error.d.ts +0 -31
  343. package/src/errors/http-error.js +0 -50
  344. package/src/errors/index.d.ts +0 -2
  345. package/src/errors/index.js +0 -4
  346. package/src/errors/locals-access-error.d.ts +0 -4
  347. package/src/errors/locals-access-error.js +0 -9
  348. package/src/global/app-logger.d.ts +0 -2
  349. package/src/global/app-logger.js +0 -6
  350. package/src/hmr/client/hmr-runtime.d.ts +0 -5
  351. package/src/hmr/client/hmr-runtime.js +0 -117
  352. package/src/hmr/hmr-strategy.d.ts +0 -162
  353. package/src/hmr/hmr-strategy.js +0 -44
  354. package/src/hmr/hmr.postcss.test.e2e.d.ts +0 -1
  355. package/src/hmr/hmr.postcss.test.e2e.js +0 -31
  356. package/src/hmr/hmr.test.e2e.d.ts +0 -1
  357. package/src/hmr/hmr.test.e2e.js +0 -43
  358. package/src/hmr/strategies/default-hmr-strategy.d.ts +0 -43
  359. package/src/hmr/strategies/default-hmr-strategy.js +0 -34
  360. package/src/hmr/strategies/js-hmr-strategy.d.ts +0 -139
  361. package/src/hmr/strategies/js-hmr-strategy.js +0 -178
  362. package/src/index.browser.d.ts +0 -3
  363. package/src/index.browser.js +0 -4
  364. package/src/index.d.ts +0 -6
  365. package/src/index.js +0 -21
  366. package/src/integrations/ghtml/ghtml-renderer.d.ts +0 -20
  367. package/src/integrations/ghtml/ghtml-renderer.js +0 -63
  368. package/src/integrations/ghtml/ghtml.constants.d.ts +0 -1
  369. package/src/integrations/ghtml/ghtml.constants.js +0 -4
  370. package/src/integrations/ghtml/ghtml.plugin.d.ts +0 -16
  371. package/src/integrations/ghtml/ghtml.plugin.js +0 -20
  372. package/src/plugins/alias-resolver-plugin.d.ts +0 -2
  373. package/src/plugins/alias-resolver-plugin.js +0 -53
  374. package/src/plugins/eco-component-meta-plugin.d.ts +0 -108
  375. package/src/plugins/eco-component-meta-plugin.js +0 -163
  376. package/src/plugins/foreign-jsx-override-plugin.d.ts +0 -31
  377. package/src/plugins/foreign-jsx-override-plugin.js +0 -35
  378. package/src/plugins/integration-plugin.d.ts +0 -219
  379. package/src/plugins/integration-plugin.js +0 -196
  380. package/src/plugins/processor.d.ts +0 -95
  381. package/src/plugins/processor.js +0 -136
  382. package/src/plugins/runtime-capability.js +0 -0
  383. package/src/plugins/source-transform.d.ts +0 -46
  384. package/src/plugins/source-transform.js +0 -71
  385. package/src/route-renderer/orchestration/boundary-planning.service.d.ts +0 -25
  386. package/src/route-renderer/orchestration/boundary-planning.service.js +0 -97
  387. package/src/route-renderer/orchestration/component-render-context.d.ts +0 -83
  388. package/src/route-renderer/orchestration/component-render-context.js +0 -147
  389. package/src/route-renderer/orchestration/integration-renderer.d.ts +0 -556
  390. package/src/route-renderer/orchestration/integration-renderer.js +0 -932
  391. package/src/route-renderer/orchestration/page-packaging.service.d.ts +0 -16
  392. package/src/route-renderer/orchestration/page-packaging.service.js +0 -66
  393. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +0 -2
  394. package/src/route-renderer/orchestration/processed-asset-dedupe.js +0 -23
  395. package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +0 -89
  396. package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +0 -155
  397. package/src/route-renderer/orchestration/render-execution.service.d.ts +0 -43
  398. package/src/route-renderer/orchestration/render-execution.service.js +0 -106
  399. package/src/route-renderer/orchestration/render-output.utils.d.ts +0 -66
  400. package/src/route-renderer/orchestration/render-output.utils.js +0 -171
  401. package/src/route-renderer/orchestration/render-preparation.service.d.ts +0 -120
  402. package/src/route-renderer/orchestration/render-preparation.service.js +0 -364
  403. package/src/route-renderer/orchestration/route-shell-composer.service.d.ts +0 -50
  404. package/src/route-renderer/orchestration/route-shell-composer.service.js +0 -81
  405. package/src/route-renderer/orchestration/template-serialization.d.ts +0 -38
  406. package/src/route-renderer/orchestration/template-serialization.js +0 -45
  407. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +0 -37
  408. package/src/route-renderer/page-loading/component-dependency-collection.js +0 -125
  409. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +0 -24
  410. package/src/route-renderer/page-loading/declared-asset-collection.js +0 -106
  411. package/src/route-renderer/page-loading/dependency-resolver.d.ts +0 -35
  412. package/src/route-renderer/page-loading/dependency-resolver.js +0 -117
  413. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +0 -11
  414. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +0 -57
  415. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +0 -45
  416. package/src/route-renderer/page-loading/lazy-entry-collection.js +0 -105
  417. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +0 -19
  418. package/src/route-renderer/page-loading/lazy-trigger-planning.js +0 -40
  419. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +0 -5
  420. package/src/route-renderer/page-loading/module-declaration-aggregation.js +0 -33
  421. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +0 -3
  422. package/src/route-renderer/page-loading/module-declaration-scripts.js +0 -18
  423. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +0 -13
  424. package/src/route-renderer/page-loading/page-dependency-bundling.js +0 -115
  425. package/src/route-renderer/page-loading/page-module-loader.d.ts +0 -90
  426. package/src/route-renderer/page-loading/page-module-loader.js +0 -127
  427. package/src/route-renderer/route-renderer.d.ts +0 -67
  428. package/src/route-renderer/route-renderer.js +0 -103
  429. package/src/router/client/link-intent.js +0 -34
  430. package/src/router/client/link-intent.test.browser.d.ts +0 -1
  431. package/src/router/client/link-intent.test.browser.js +0 -43
  432. package/src/router/client/navigation-coordinator.d.ts +0 -169
  433. package/src/router/client/navigation-coordinator.js +0 -215
  434. package/src/router/server/fs-router-scanner.d.ts +0 -41
  435. package/src/router/server/fs-router-scanner.js +0 -161
  436. package/src/router/server/fs-router.d.ts +0 -26
  437. package/src/router/server/fs-router.js +0 -100
  438. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +0 -3
  439. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +0 -56
  440. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +0 -103
  441. package/src/services/assets/asset-processing-service/asset-processing.service.js +0 -285
  442. package/src/services/assets/asset-processing-service/asset.factory.d.ts +0 -17
  443. package/src/services/assets/asset-processing-service/asset.factory.js +0 -82
  444. package/src/services/assets/asset-processing-service/assets.types.d.ts +0 -100
  445. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  446. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +0 -55
  447. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +0 -49
  448. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +0 -20
  449. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +0 -41
  450. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +0 -30
  451. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +0 -65
  452. package/src/services/assets/asset-processing-service/index.d.ts +0 -5
  453. package/src/services/assets/asset-processing-service/index.js +0 -5
  454. package/src/services/assets/asset-processing-service/processor.interface.js +0 -6
  455. package/src/services/assets/asset-processing-service/processor.registry.d.ts +0 -8
  456. package/src/services/assets/asset-processing-service/processor.registry.js +0 -15
  457. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +0 -24
  458. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +0 -65
  459. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +0 -22
  460. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +0 -136
  461. package/src/services/assets/asset-processing-service/processors/index.d.ts +0 -5
  462. package/src/services/assets/asset-processing-service/processors/index.js +0 -5
  463. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +0 -6
  464. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +0 -116
  465. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +0 -9
  466. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +0 -91
  467. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +0 -7
  468. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +0 -77
  469. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +0 -8
  470. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -58
  471. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +0 -9
  472. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +0 -67
  473. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +0 -18
  474. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +0 -45
  475. package/src/services/assets/browser-bundle.service.d.ts +0 -73
  476. package/src/services/assets/browser-bundle.service.js +0 -41
  477. package/src/services/cache/cache.types.d.ts +0 -107
  478. package/src/services/cache/cache.types.js +0 -0
  479. package/src/services/cache/index.d.ts +0 -7
  480. package/src/services/cache/index.js +0 -7
  481. package/src/services/cache/memory-cache-store.d.ts +0 -42
  482. package/src/services/cache/memory-cache-store.js +0 -98
  483. package/src/services/cache/page-cache-service.d.ts +0 -70
  484. package/src/services/cache/page-cache-service.js +0 -152
  485. package/src/services/cache/page-request-cache-coordinator.service.d.ts +0 -75
  486. package/src/services/cache/page-request-cache-coordinator.service.js +0 -109
  487. package/src/services/html/html-rewriter-provider.service.d.ts +0 -37
  488. package/src/services/html/html-rewriter-provider.service.js +0 -68
  489. package/src/services/html/html-transformer.service.d.ts +0 -87
  490. package/src/services/html/html-transformer.service.js +0 -216
  491. package/src/services/invalidation/development-invalidation.service.d.ts +0 -74
  492. package/src/services/invalidation/development-invalidation.service.js +0 -190
  493. package/src/services/module-loading/app-module-loader.service.d.ts +0 -7
  494. package/src/services/module-loading/app-module-loader.service.js +0 -0
  495. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +0 -24
  496. package/src/services/module-loading/app-server-module-transpiler.service.js +0 -115
  497. package/src/services/module-loading/host-module-loader-registry.d.ts +0 -4
  498. package/src/services/module-loading/host-module-loader-registry.js +0 -15
  499. package/src/services/module-loading/module-loading-types.js +0 -0
  500. package/src/services/module-loading/node-bootstrap-plugin.d.ts +0 -42
  501. package/src/services/module-loading/node-bootstrap-plugin.js +0 -204
  502. package/src/services/module-loading/page-module-import.service.d.ts +0 -76
  503. package/src/services/module-loading/page-module-import.service.js +0 -170
  504. package/src/services/module-loading/server-module-transpiler.service.d.ts +0 -63
  505. package/src/services/module-loading/server-module-transpiler.service.js +0 -64
  506. package/src/services/module-loading/source-module-support.d.ts +0 -5
  507. package/src/services/module-loading/source-module-support.js +0 -8
  508. package/src/services/runtime-state/dev-graph.service.d.ts +0 -118
  509. package/src/services/runtime-state/dev-graph.service.js +0 -162
  510. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +0 -41
  511. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +0 -85
  512. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +0 -69
  513. package/src/services/runtime-state/runtime-specifier-registry.service.js +0 -37
  514. package/src/services/runtime-state/server-invalidation-state.service.d.ts +0 -26
  515. package/src/services/runtime-state/server-invalidation-state.service.js +0 -35
  516. package/src/services/validation/schema-validation-service.d.ts +0 -122
  517. package/src/services/validation/schema-validation-service.js +0 -101
  518. package/src/services/validation/standard-schema.types.js +0 -0
  519. package/src/static-site-generator/static-site-generator.d.ts +0 -105
  520. package/src/static-site-generator/static-site-generator.js +0 -349
  521. package/src/types/internal-types.d.ts +0 -231
  522. package/src/types/internal-types.js +0 -0
  523. package/src/types/public-types.d.ts +0 -1257
  524. package/src/types/public-types.js +0 -0
  525. package/src/utils/deep-merge.d.ts +0 -14
  526. package/src/utils/deep-merge.js +0 -32
  527. package/src/utils/hash.d.ts +0 -1
  528. package/src/utils/hash.js +0 -7
  529. package/src/utils/html-escaping.d.ts +0 -7
  530. package/src/utils/html-escaping.js +0 -6
  531. package/src/utils/html.js +0 -4
  532. package/src/utils/invariant.d.ts +0 -5
  533. package/src/utils/invariant.js +0 -11
  534. package/src/utils/locals-utils.d.ts +0 -15
  535. package/src/utils/locals-utils.js +0 -24
  536. package/src/utils/parse-cli-args.d.ts +0 -27
  537. package/src/utils/parse-cli-args.js +0 -62
  538. package/src/utils/path-utils.module.d.ts +0 -5
  539. package/src/utils/path-utils.module.js +0 -14
  540. package/src/utils/resolve-work-dir.d.ts +0 -11
  541. package/src/utils/resolve-work-dir.js +0 -31
  542. package/src/utils/runtime.d.ts +0 -11
  543. package/src/utils/runtime.js +0 -40
  544. package/src/utils/server-utils.module.d.ts +0 -19
  545. package/src/utils/server-utils.module.js +0 -56
  546. package/src/watchers/project-watcher.d.ts +0 -136
  547. package/src/watchers/project-watcher.js +0 -275
  548. package/src/watchers/project-watcher.test-helpers.d.ts +0 -4
  549. package/src/watchers/project-watcher.test-helpers.js +0 -52
  550. /package/src/utils/{html.d.ts → html.ts} +0 -0
@@ -0,0 +1,644 @@
1
+ import { describe, expect, it, vi } from 'vitest';
2
+ import { eco } from '../../eco/eco.ts';
3
+ import type { EcoPagesAppConfig } from '../../types/internal-types.ts';
4
+ import type {
5
+ OwnershipPlan,
6
+ EcoComponent,
7
+ EcoPageComponent,
8
+ HtmlTemplateProps,
9
+ PageMetadataProps,
10
+ RouteRendererOptions,
11
+ } from '../../types/public-types.ts';
12
+ import { LocalsAccessError } from '../../errors/locals-access-error.ts';
13
+ import { OwnershipPlanningService } from './ownership-planning.service.ts';
14
+ import type {
15
+ AssetDefinition,
16
+ AssetProcessingService,
17
+ ProcessedAsset,
18
+ } from '../../services/assets/asset-processing-service/index.ts';
19
+ import { OwnershipValidationService } from './ownership-validation.service.ts';
20
+ import { type RouteRenderOrchestratorAdapter, RouteRenderOrchestrator } from './route-render-orchestrator.ts';
21
+
22
+ declare module '../../types/public-types.ts' {
23
+ interface RequestLocals {
24
+ user?: string;
25
+ guarded?: boolean;
26
+ }
27
+ }
28
+
29
+ function createFlowAdapter<C>(input: {
30
+ resolvePageModule: (file: string) => Promise<{
31
+ Page: EcoPageComponent<any> | EcoComponent;
32
+ getStaticProps?: unknown;
33
+ getMetadata?: unknown;
34
+ integrationSpecificProps: Record<string, unknown>;
35
+ }>;
36
+ getHtmlTemplate: () => Promise<EcoComponent<HtmlTemplateProps>>;
37
+ resolvePageData: (
38
+ pageModule: {
39
+ getStaticProps?: unknown;
40
+ getMetadata?: unknown;
41
+ },
42
+ routeOptions: RouteRendererOptions,
43
+ ) => Promise<{ props: Record<string, unknown>; metadata: PageMetadataProps }>;
44
+ resolveDependencies: (components: (EcoComponent | Partial<EcoComponent>)[]) => Promise<ProcessedAsset[]>;
45
+ buildPageBrowserGraph: (file: string) => Promise<{ assets: ProcessedAsset[] } | undefined>;
46
+ shouldRenderPageComponent: (input: {
47
+ Page: EcoComponent;
48
+ Layout?: EcoComponent;
49
+ options: RouteRendererOptions;
50
+ }) => boolean;
51
+ renderPageComponent: (input: {
52
+ Page: EcoComponent;
53
+ Layout?: EcoComponent;
54
+ props: Record<string, unknown>;
55
+ routeOptions: RouteRendererOptions;
56
+ }) => Promise<any>;
57
+ }): RouteRenderOrchestratorAdapter<C> {
58
+ return {
59
+ name: 'ghtml',
60
+ resolveRouteRenderInputs: async (routeOptions) => {
61
+ const pageModule = await input.resolvePageModule(routeOptions.file);
62
+ const HtmlTemplate = await input.getHtmlTemplate();
63
+ const Layout = pageModule.Page.config?.layout;
64
+ const { props, metadata } = await input.resolvePageData(pageModule, routeOptions);
65
+
66
+ return {
67
+ Page: pageModule.Page,
68
+ HtmlTemplate,
69
+ Layout,
70
+ props,
71
+ metadata,
72
+ integrationSpecificProps: pageModule.integrationSpecificProps,
73
+ shouldRenderPageComponent: input.shouldRenderPageComponent({
74
+ Page: pageModule.Page as EcoComponent,
75
+ Layout,
76
+ options: routeOptions,
77
+ }),
78
+ };
79
+ },
80
+ resolveRouteAssets: async ({ routeOptions, components }) => ({
81
+ resolvedDependencies: await input.resolveDependencies(components),
82
+ pageBrowserGraph: await input.buildPageBrowserGraph(routeOptions.file),
83
+ }),
84
+ resolveRoutePageComponentRender: async (renderInput) => {
85
+ if (
86
+ !input.shouldRenderPageComponent({
87
+ Page: renderInput.Page,
88
+ Layout: renderInput.Layout,
89
+ options: renderInput.routeOptions,
90
+ })
91
+ ) {
92
+ return undefined;
93
+ }
94
+
95
+ return await input.renderPageComponent(renderInput);
96
+ },
97
+ renderRouteBody: async () => '',
98
+ getRouteHtmlFinalization: () => ({}),
99
+ transformRouteResponse: async (response) => await response.text(),
100
+ };
101
+ }
102
+
103
+ describe('RouteRenderOrchestrator prepareRenderOptions', () => {
104
+ it('should prepare dynamic render options and merge renderer-owned assets', async () => {
105
+ const integrationDependency = {
106
+ kind: 'script',
107
+ srcUrl: '/assets/react-runtime.js',
108
+ position: 'head',
109
+ } as ProcessedAsset;
110
+ const componentAsset = {
111
+ kind: 'script',
112
+ srcUrl: '/assets/page-root.js',
113
+ position: 'head',
114
+ } as ProcessedAsset;
115
+ const resolvedDependency = {
116
+ kind: 'stylesheet',
117
+ srcUrl: '/assets/page.css',
118
+ position: 'head',
119
+ } as ProcessedAsset;
120
+ const pageDependency = {
121
+ kind: 'script',
122
+ srcUrl: '/assets/page-entry.js',
123
+ position: 'head',
124
+ } as ProcessedAsset;
125
+ const assetProcessingService = {
126
+ processDependencies: vi.fn(async () => []),
127
+ } as unknown as AssetProcessingService;
128
+ const appConfig = {
129
+ cache: { defaultStrategy: 'static' },
130
+ integrations: [
131
+ {
132
+ name: 'react',
133
+ initializeRenderer: vi.fn(),
134
+ getResolvedIntegrationDependencies: () => [integrationDependency],
135
+ },
136
+ ],
137
+ } as unknown as EcoPagesAppConfig;
138
+ const flow = new RouteRenderOrchestrator(appConfig, assetProcessingService);
139
+ const HtmlTemplate = (() => '<html></html>') as EcoComponent<HtmlTemplateProps>;
140
+ const Nested = (() => '<aside>Nested</aside>') as EcoComponent<Record<string, unknown>>;
141
+ Nested.config = {
142
+ integration: 'react',
143
+ __eco: { id: 'nested', file: '/app/components/nested.tsx', integration: 'react' },
144
+ };
145
+ const Page = (() => '<main>Page</main>') as unknown as EcoPageComponent<any>;
146
+ Page.cache = 'dynamic';
147
+ Page.config = {
148
+ dependencies: {
149
+ components: [Nested],
150
+ },
151
+ };
152
+ const routeOptions = {
153
+ file: '/app/pages/index.tsx',
154
+ params: { slug: 'hello' },
155
+ query: { preview: '1' },
156
+ locals: { user: 'andee' },
157
+ } as unknown as RouteRendererOptions;
158
+ const result = await flow.prepareRenderOptions(
159
+ routeOptions,
160
+ createFlowAdapter({
161
+ resolvePageModule: async () => ({
162
+ Page,
163
+ integrationSpecificProps: { layoutMode: 'full' },
164
+ }),
165
+ getHtmlTemplate: async () => HtmlTemplate,
166
+ resolvePageData: async () => ({
167
+ props: { title: 'Hello' },
168
+ metadata: { title: 'Hello', description: 'Hello description' },
169
+ }),
170
+ resolveDependencies: async () => [resolvedDependency],
171
+ buildPageBrowserGraph: async () => ({ assets: [pageDependency] }),
172
+ shouldRenderPageComponent: () => true,
173
+ renderPageComponent: async () => ({
174
+ html: '<main>Page</main>',
175
+ canAttachAttributes: true,
176
+ rootTag: 'main',
177
+ integrationName: 'ghtml',
178
+ assets: [componentAsset],
179
+ }),
180
+ }),
181
+ );
182
+
183
+ expect(result.locals).toEqual({ user: 'andee' });
184
+ expect(result.pageLocals).toEqual({ user: 'andee' });
185
+ expect(result.pageProps).toEqual({ title: 'Hello', params: { slug: 'hello' }, query: { preview: '1' } });
186
+ expect((result as typeof result & { layoutMode?: string }).layoutMode).toBe('full');
187
+ expect(result.componentRender?.assets).toEqual([componentAsset]);
188
+ expect(result.pagePackage).toEqual(
189
+ expect.objectContaining({
190
+ assets: [resolvedDependency, integrationDependency, pageDependency, componentAsset],
191
+ }),
192
+ );
193
+ });
194
+
195
+ it('renders page-root output directly during preparation', async () => {
196
+ const assetProcessingService = {
197
+ processDependencies: vi.fn(async () => []),
198
+ } as unknown as AssetProcessingService;
199
+ const appConfig = {
200
+ cache: { defaultStrategy: 'static' },
201
+ integrations: [],
202
+ } as unknown as EcoPagesAppConfig;
203
+ const flow = new RouteRenderOrchestrator(appConfig, assetProcessingService);
204
+ const HtmlTemplate = (() => '<html></html>') as EcoComponent<HtmlTemplateProps>;
205
+ const DeferredChild = eco.component<{}, string>({
206
+ integration: 'react',
207
+ render: () => '<span>Deferred</span>',
208
+ });
209
+ const Page = (() => '<main>Page</main>') as unknown as EcoPageComponent<any>;
210
+
211
+ const result = await flow.prepareRenderOptions(
212
+ { file: '/app/pages/index.tsx', params: {}, query: {} } as unknown as RouteRendererOptions,
213
+ createFlowAdapter({
214
+ resolvePageModule: async () => ({
215
+ Page,
216
+ integrationSpecificProps: {},
217
+ }),
218
+ getHtmlTemplate: async () => HtmlTemplate,
219
+ resolvePageData: async () => ({
220
+ props: {},
221
+ metadata: { title: 'Page', description: 'Page description' },
222
+ }),
223
+ resolveDependencies: async () => [],
224
+ buildPageBrowserGraph: async () => ({ assets: [] }),
225
+ shouldRenderPageComponent: () => true,
226
+ renderPageComponent: async () => ({
227
+ html: DeferredChild({}),
228
+ canAttachAttributes: true,
229
+ rootTag: 'span',
230
+ integrationName: 'ghtml',
231
+ }),
232
+ }),
233
+ );
234
+
235
+ expect(result.componentRender).toEqual(
236
+ expect.objectContaining({
237
+ canAttachAttributes: true,
238
+ rootTag: 'span',
239
+ integrationName: 'ghtml',
240
+ }),
241
+ );
242
+ expect(result.componentRender?.html).toBe('<span>Deferred</span>');
243
+ });
244
+
245
+ it('inlines the global injector bootstrap when resolved lazy triggers are present', async () => {
246
+ const processDependencies = vi.fn<AssetProcessingService['processDependencies']>().mockImplementation(
247
+ async (dependencies) =>
248
+ dependencies.map((dependency) => ({
249
+ kind: dependency.kind,
250
+ position: dependency.position,
251
+ attributes: dependency.attributes,
252
+ content: dependency.source === 'content' ? dependency.content : undefined,
253
+ inline: dependency.inline,
254
+ packageRole: dependency.packageRole,
255
+ })) as ProcessedAsset[],
256
+ );
257
+ const assetProcessingService = {
258
+ processDependencies,
259
+ } as unknown as AssetProcessingService;
260
+ const appConfig = {
261
+ cache: { defaultStrategy: 'static' },
262
+ integrations: [],
263
+ } as unknown as EcoPagesAppConfig;
264
+ const flow = new RouteRenderOrchestrator(appConfig, assetProcessingService);
265
+ const HtmlTemplate = (() => '<html></html>') as EcoComponent<HtmlTemplateProps>;
266
+ const Page = (() => '<main>Page</main>') as unknown as EcoPageComponent<any>;
267
+ Page.config = {
268
+ _resolvedLazyTriggers: [
269
+ {
270
+ triggerId: 'eco-trigger-theme-toggle',
271
+ rules: [{ 'on:interaction': { value: 'click', scripts: ['/assets/lazy-theme-toggle.js'] } }],
272
+ },
273
+ ],
274
+ };
275
+
276
+ await flow.prepareRenderOptions(
277
+ { file: '/app/pages/index.tsx', params: {}, query: {} } as unknown as RouteRendererOptions,
278
+ createFlowAdapter({
279
+ resolvePageModule: async () => ({
280
+ Page,
281
+ integrationSpecificProps: {},
282
+ }),
283
+ getHtmlTemplate: async () => HtmlTemplate,
284
+ resolvePageData: async () => ({
285
+ props: {},
286
+ metadata: { title: 'Page', description: 'Page description' },
287
+ }),
288
+ resolveDependencies: async () => [],
289
+ buildPageBrowserGraph: async () => ({ assets: [] }),
290
+ shouldRenderPageComponent: () => false,
291
+ renderPageComponent: vi.fn(),
292
+ }),
293
+ );
294
+
295
+ expect(processDependencies).toHaveBeenCalledOnce();
296
+ expect(processDependencies).toHaveBeenCalledWith(
297
+ expect.arrayContaining([
298
+ expect.objectContaining({
299
+ name: 'ecopages-global-injector-bootstrap',
300
+ inline: true,
301
+ bundle: true,
302
+ attributes: { type: 'module' },
303
+ }),
304
+ ]),
305
+ 'ghtml',
306
+ );
307
+ });
308
+
309
+ it('should guard page locals for static pages and skip page-root rendering when disabled', async () => {
310
+ const assetProcessingService = {
311
+ processDependencies: vi.fn(async () => []),
312
+ } as unknown as AssetProcessingService;
313
+ const appConfig = {
314
+ cache: { defaultStrategy: 'static' },
315
+ integrations: [],
316
+ } as unknown as EcoPagesAppConfig;
317
+ const flow = new RouteRenderOrchestrator(appConfig, assetProcessingService);
318
+ const HtmlTemplate = (() => '<html></html>') as EcoComponent<HtmlTemplateProps>;
319
+ const Page = (() => '<main>Page</main>') as unknown as EcoPageComponent<any>;
320
+ const renderPageComponent = vi.fn();
321
+
322
+ const result = await flow.prepareRenderOptions(
323
+ {
324
+ file: '/app/pages/index.tsx',
325
+ params: {},
326
+ query: {},
327
+ locals: { hidden: true },
328
+ } as unknown as RouteRendererOptions,
329
+ createFlowAdapter({
330
+ resolvePageModule: async () => ({
331
+ Page,
332
+ integrationSpecificProps: {},
333
+ }),
334
+ getHtmlTemplate: async () => HtmlTemplate,
335
+ resolvePageData: async () => ({
336
+ props: {},
337
+ metadata: { title: 'Static page', description: 'Static page description' },
338
+ }),
339
+ resolveDependencies: async () => [],
340
+ buildPageBrowserGraph: async () => ({ assets: [] }),
341
+ shouldRenderPageComponent: () => false,
342
+ renderPageComponent,
343
+ }),
344
+ );
345
+
346
+ expect(result.locals).toBeUndefined();
347
+ expect(() => Reflect.get(result.pageLocals as object, 'guarded')).toThrow(LocalsAccessError);
348
+ expect(result.componentRender).toBeUndefined();
349
+ expect(renderPageComponent).not.toHaveBeenCalled();
350
+ });
351
+
352
+ it('eagerly emits lazy SSR component scripts for shared non-owning routes', async () => {
353
+ const eagerSsrLazyAsset = {
354
+ kind: 'script',
355
+ srcUrl: '/assets/components/lit-counter.script.js',
356
+ position: 'head',
357
+ packageRole: 'dynamic-chunk',
358
+ } as ProcessedAsset;
359
+ const processDependencies = vi.fn(async (dependencies: AssetDefinition[]) => {
360
+ const hasEagerSsrLazyDependency = dependencies.some((dependency) => {
361
+ if (dependency.kind !== 'script' || dependency.source !== 'file') {
362
+ return false;
363
+ }
364
+
365
+ return String(dependency.filepath).endsWith('/lit-counter.script.ts');
366
+ });
367
+
368
+ return hasEagerSsrLazyDependency ? [eagerSsrLazyAsset] : [];
369
+ });
370
+ const assetProcessingService = {
371
+ processDependencies,
372
+ } as unknown as AssetProcessingService;
373
+ const appConfig = {
374
+ cache: { defaultStrategy: 'static' },
375
+ integrations: [],
376
+ } as unknown as EcoPagesAppConfig;
377
+ const flow = new RouteRenderOrchestrator(appConfig, assetProcessingService);
378
+ const HtmlTemplate = (() => '<html></html>') as EcoComponent<HtmlTemplateProps>;
379
+ const LitCounter = (() => '<lit-counter count="0"></lit-counter>') as unknown as EcoComponent<object>;
380
+ LitCounter.config = {
381
+ __eco: { id: 'lit-counter', file: '/app/components/lit-counter.lit.tsx', integration: 'lit' },
382
+ dependencies: {
383
+ scripts: [{ src: './lit-counter.script.ts', lazy: { 'on:interaction': 'click' }, ssr: true }],
384
+ },
385
+ };
386
+ const Page = (() => '<main>Page</main>') as unknown as EcoPageComponent<any>;
387
+ Page.config = {
388
+ dependencies: {
389
+ components: [LitCounter],
390
+ },
391
+ };
392
+
393
+ await flow.prepareRenderOptions(
394
+ { file: '/app/pages/index.tsx', params: {}, query: {} } as unknown as RouteRendererOptions,
395
+ createFlowAdapter({
396
+ resolvePageModule: async () => ({
397
+ Page,
398
+ integrationSpecificProps: {},
399
+ }),
400
+ getHtmlTemplate: async () => HtmlTemplate,
401
+ resolvePageData: async () => ({
402
+ props: {},
403
+ metadata: { title: 'Static page', description: 'Static page description' },
404
+ }),
405
+ resolveDependencies: async () => [],
406
+ buildPageBrowserGraph: async () => ({ assets: [] }),
407
+ shouldRenderPageComponent: () => false,
408
+ renderPageComponent: vi.fn(),
409
+ }),
410
+ );
411
+
412
+ expect(processDependencies).toHaveBeenCalledOnce();
413
+ expect(processDependencies).toHaveBeenCalledWith(
414
+ [
415
+ expect.objectContaining({
416
+ kind: 'script',
417
+ source: 'file',
418
+ filepath: '/app/components/lit-counter.script.ts',
419
+ packageRole: 'dynamic-chunk',
420
+ }),
421
+ ],
422
+ 'ghtml:ssr-lazy',
423
+ );
424
+ });
425
+
426
+ it('exposes eager lazy SSR assets through the returned page package', async () => {
427
+ const eagerSsrLazyAsset = {
428
+ kind: 'script',
429
+ srcUrl: '/assets/components/lit-counter.script.js',
430
+ position: 'head',
431
+ packageRole: 'dynamic-chunk',
432
+ } as ProcessedAsset;
433
+ const assetProcessingService = {
434
+ processDependencies: vi.fn(async (dependencies: AssetDefinition[]) => {
435
+ const hasEagerSsrLazyDependency = dependencies.some((dependency) => {
436
+ if (dependency.kind !== 'script' || dependency.source !== 'file') {
437
+ return false;
438
+ }
439
+
440
+ return String(dependency.filepath).endsWith('/lit-counter.script.ts');
441
+ });
442
+
443
+ return hasEagerSsrLazyDependency ? [eagerSsrLazyAsset] : [];
444
+ }),
445
+ } as unknown as AssetProcessingService;
446
+ const appConfig = {
447
+ cache: { defaultStrategy: 'static' },
448
+ integrations: [],
449
+ } as unknown as EcoPagesAppConfig;
450
+ const flow = new RouteRenderOrchestrator(appConfig, assetProcessingService);
451
+ const HtmlTemplate = (() => '<html></html>') as EcoComponent<HtmlTemplateProps>;
452
+ const LitCounter = (() => '<lit-counter count="0"></lit-counter>') as unknown as EcoComponent<object>;
453
+ LitCounter.config = {
454
+ __eco: { id: 'lit-counter', file: '/app/components/lit-counter.lit.tsx', integration: 'lit' },
455
+ dependencies: {
456
+ scripts: [{ src: './lit-counter.script.ts', lazy: { 'on:interaction': 'click' }, ssr: true }],
457
+ },
458
+ };
459
+ const Page = (() => '<main>Page</main>') as unknown as EcoPageComponent<any>;
460
+ Page.config = {
461
+ dependencies: {
462
+ components: [LitCounter],
463
+ },
464
+ };
465
+
466
+ const result = await flow.prepareRenderOptions(
467
+ { file: '/app/pages/index.tsx', params: {}, query: {} } as unknown as RouteRendererOptions,
468
+ createFlowAdapter({
469
+ resolvePageModule: async () => ({
470
+ Page,
471
+ integrationSpecificProps: {},
472
+ }),
473
+ getHtmlTemplate: async () => HtmlTemplate,
474
+ resolvePageData: async () => ({
475
+ props: {},
476
+ metadata: { title: 'Static page', description: 'Static page description' },
477
+ }),
478
+ resolveDependencies: async () => [],
479
+ buildPageBrowserGraph: async () => ({ assets: [] }),
480
+ shouldRenderPageComponent: () => false,
481
+ renderPageComponent: vi.fn(),
482
+ }),
483
+ );
484
+
485
+ expect(result.pagePackage).toEqual(
486
+ expect.objectContaining({
487
+ dynamicChunks: [eagerSsrLazyAsset],
488
+ }),
489
+ );
490
+ });
491
+
492
+ it('skips undefined component entries while collecting integration dependencies and triggers', async () => {
493
+ const integrationDependency = {
494
+ kind: 'script',
495
+ srcUrl: '/assets/react-runtime.js',
496
+ position: 'head',
497
+ } as ProcessedAsset;
498
+ const assetProcessingService = {
499
+ processDependencies: vi.fn(async () => []),
500
+ } as unknown as AssetProcessingService;
501
+ const appConfig = {
502
+ cache: { defaultStrategy: 'static' },
503
+ integrations: [
504
+ {
505
+ name: 'react',
506
+ initializeRenderer: vi.fn(),
507
+ getResolvedIntegrationDependencies: () => [integrationDependency],
508
+ },
509
+ ],
510
+ } as unknown as EcoPagesAppConfig;
511
+ const flow = new RouteRenderOrchestrator(appConfig, assetProcessingService);
512
+ const HtmlTemplate = (() => '<html></html>') as EcoComponent<HtmlTemplateProps>;
513
+ const Nested = (() => '<aside>Nested</aside>') as EcoComponent<Record<string, unknown>>;
514
+ Nested.config = {
515
+ integration: 'react',
516
+ __eco: { id: 'nested', file: '/app/components/nested.tsx', integration: 'react' },
517
+ };
518
+ const Page = (() => '<main>Page</main>') as unknown as EcoPageComponent<any>;
519
+ Page.config = {
520
+ dependencies: {
521
+ components: [undefined, Nested] as unknown as EcoComponent[],
522
+ },
523
+ };
524
+ await expect(
525
+ flow.prepareRenderOptions(
526
+ { file: '/app/pages/404.tsx', params: {}, query: {} } as unknown as RouteRendererOptions,
527
+ createFlowAdapter({
528
+ resolvePageModule: async () => ({
529
+ Page,
530
+ integrationSpecificProps: {},
531
+ }),
532
+ getHtmlTemplate: async () => HtmlTemplate,
533
+ resolvePageData: async () => ({
534
+ props: {},
535
+ metadata: { title: '404', description: 'Not found' },
536
+ }),
537
+ resolveDependencies: async () => [],
538
+ buildPageBrowserGraph: async () => ({ assets: [] }),
539
+ shouldRenderPageComponent: () => false,
540
+ renderPageComponent: vi.fn(),
541
+ }),
542
+ ),
543
+ ).resolves.toEqual(
544
+ expect.objectContaining({
545
+ Page,
546
+ }),
547
+ );
548
+
549
+ const result = await flow.prepareRenderOptions(
550
+ { file: '/app/pages/404.tsx', params: {}, query: {} } as unknown as RouteRendererOptions,
551
+ createFlowAdapter({
552
+ resolvePageModule: async () => ({
553
+ Page,
554
+ integrationSpecificProps: {},
555
+ }),
556
+ getHtmlTemplate: async () => HtmlTemplate,
557
+ resolvePageData: async () => ({
558
+ props: {},
559
+ metadata: { title: '404', description: 'Not found' },
560
+ }),
561
+ resolveDependencies: async () => [],
562
+ buildPageBrowserGraph: async () => ({ assets: [] }),
563
+ shouldRenderPageComponent: () => false,
564
+ renderPageComponent: vi.fn(),
565
+ }),
566
+ );
567
+
568
+ expect(result.pagePackage).toEqual(
569
+ expect.objectContaining({
570
+ assets: [integrationDependency],
571
+ }),
572
+ );
573
+ });
574
+
575
+ it('uses an injected ownership planning service when provided', async () => {
576
+ const assetProcessingService = {
577
+ processDependencies: vi.fn(async () => []),
578
+ } as unknown as AssetProcessingService;
579
+ const appConfig = {
580
+ cache: { defaultStrategy: 'static' },
581
+ integrations: [],
582
+ } as unknown as EcoPagesAppConfig;
583
+ const ownershipPlan = {
584
+ root: {
585
+ id: 'route:/app/pages/index.tsx',
586
+ source: 'route',
587
+ ownership: {
588
+ integrationName: 'ghtml',
589
+ componentId: 'route:/app/pages/index.tsx',
590
+ componentFile: '/app/pages/index.tsx',
591
+ isPageEntry: false,
592
+ isForeignToParent: false,
593
+ },
594
+ children: [],
595
+ declaredDependenciesValid: true,
596
+ },
597
+ rendererNames: ['ghtml'],
598
+ foreignEdgeCount: 0,
599
+ hasValidationErrors: false,
600
+ validationErrors: [],
601
+ } satisfies OwnershipPlan;
602
+ const injectedOwnershipPlanningService = {
603
+ buildPlan: vi.fn(() => ownershipPlan),
604
+ } as unknown as OwnershipPlanningService;
605
+ const injectedOwnershipValidationService = {
606
+ validate: vi.fn(() => []),
607
+ } as unknown as OwnershipValidationService;
608
+ const flow = new RouteRenderOrchestrator(appConfig, assetProcessingService, {
609
+ ownershipPlanningService: injectedOwnershipPlanningService,
610
+ ownershipValidationService: injectedOwnershipValidationService,
611
+ });
612
+ const HtmlTemplate = (() => '<html></html>') as EcoComponent<HtmlTemplateProps>;
613
+ const Page = (() => '<main>Page</main>') as unknown as EcoPageComponent<any>;
614
+
615
+ const result = await flow.prepareRenderOptions(
616
+ { file: '/app/pages/index.tsx', params: {}, query: {} } as unknown as RouteRendererOptions,
617
+ createFlowAdapter({
618
+ resolvePageModule: async () => ({
619
+ Page,
620
+ integrationSpecificProps: {},
621
+ }),
622
+ getHtmlTemplate: async () => HtmlTemplate,
623
+ resolvePageData: async () => ({
624
+ props: {},
625
+ metadata: { title: 'Page', description: 'Page description' },
626
+ }),
627
+ resolveDependencies: async () => [],
628
+ buildPageBrowserGraph: async () => ({ assets: [] }),
629
+ shouldRenderPageComponent: () => false,
630
+ renderPageComponent: vi.fn(),
631
+ }),
632
+ );
633
+
634
+ expect(injectedOwnershipPlanningService.buildPlan).toHaveBeenCalledWith({
635
+ routeFile: '/app/pages/index.tsx',
636
+ currentIntegrationName: 'ghtml',
637
+ HtmlTemplate,
638
+ Layout: undefined,
639
+ Page,
640
+ validationErrors: [],
641
+ });
642
+ expect(result.ownershipPlan).toBe(ownershipPlan);
643
+ });
644
+ });