@ecopages/core 0.2.0-alpha.3 → 0.2.0-alpha.31

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 (436) hide show
  1. package/CHANGELOG.md +66 -66
  2. package/README.md +268 -14
  3. package/package.json +72 -108
  4. package/src/adapters/README.md +39 -0
  5. package/src/adapters/abstract/application-adapter.d.ts +28 -2
  6. package/src/adapters/abstract/application-adapter.js +14 -2
  7. package/src/adapters/abstract/router-adapter.d.ts +1 -1
  8. package/src/adapters/abstract/server-adapter.d.ts +2 -2
  9. package/src/adapters/bun/client-bridge.d.ts +1 -1
  10. package/src/adapters/bun/create-app.d.ts +5 -12
  11. package/src/adapters/bun/create-app.js +43 -7
  12. package/src/adapters/bun/hmr-manager.d.ts +72 -26
  13. package/src/adapters/bun/hmr-manager.js +153 -81
  14. package/src/adapters/bun/index.d.ts +2 -3
  15. package/src/adapters/bun/index.js +3 -3
  16. package/src/adapters/bun/server-adapter.d.ts +5 -5
  17. package/src/adapters/bun/server-adapter.js +63 -38
  18. package/src/adapters/bun/server-lifecycle.d.ts +28 -17
  19. package/src/adapters/bun/server-lifecycle.js +34 -62
  20. package/src/{create-app.d.ts → adapters/create-app.d.ts} +9 -6
  21. package/src/{create-app.js → adapters/create-app.js} +4 -4
  22. package/src/adapters/index.d.ts +2 -6
  23. package/src/adapters/index.js +2 -8
  24. package/src/adapters/node/create-app.d.ts +6 -9
  25. package/src/adapters/node/create-app.js +12 -6
  26. package/src/adapters/node/node-client-bridge.d.ts +1 -1
  27. package/src/adapters/node/node-hmr-manager.d.ts +79 -21
  28. package/src/adapters/node/node-hmr-manager.js +167 -114
  29. package/src/adapters/node/server-adapter.d.ts +7 -35
  30. package/src/adapters/node/server-adapter.js +55 -107
  31. package/src/adapters/node/static-content-server.d.ts +37 -1
  32. package/src/adapters/node/static-content-server.js +29 -1
  33. package/src/adapters/shared/application-adapter.d.ts +1 -1
  34. package/src/{define-api-handler.d.ts → adapters/shared/define-api-handler.d.ts} +1 -1
  35. package/src/adapters/shared/explicit-static-render-preparation.d.ts +25 -0
  36. package/src/adapters/shared/explicit-static-render-preparation.js +26 -0
  37. package/src/adapters/shared/explicit-static-route-matcher.d.ts +7 -4
  38. package/src/adapters/shared/explicit-static-route-matcher.js +14 -13
  39. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +7 -10
  40. package/src/adapters/shared/file-route-middleware-pipeline.js +3 -11
  41. package/src/adapters/shared/fs-server-response-factory.d.ts +14 -10
  42. package/src/adapters/shared/fs-server-response-factory.js +11 -27
  43. package/src/adapters/shared/fs-server-response-matcher.d.ts +20 -16
  44. package/src/adapters/shared/fs-server-response-matcher.js +76 -45
  45. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  46. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  47. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  48. package/src/adapters/shared/hmr-html-response.js +32 -0
  49. package/src/adapters/shared/render-context.d.ts +4 -3
  50. package/src/adapters/shared/render-context.js +6 -3
  51. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  52. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  53. package/src/adapters/shared/server-adapter.d.ts +33 -12
  54. package/src/adapters/shared/server-adapter.js +208 -132
  55. package/src/adapters/shared/server-route-handler.d.ts +5 -5
  56. package/src/adapters/shared/server-route-handler.js +7 -16
  57. package/src/adapters/shared/server-static-builder.d.ts +41 -8
  58. package/src/adapters/shared/server-static-builder.js +65 -11
  59. package/src/build/README.md +107 -0
  60. package/src/build/build-adapter.d.ts +168 -3
  61. package/src/build/build-adapter.js +604 -16
  62. package/src/build/build-manifest.d.ts +27 -0
  63. package/src/build/build-manifest.js +30 -0
  64. package/src/build/dev-build-coordinator.d.ts +72 -0
  65. package/src/build/dev-build-coordinator.js +154 -0
  66. package/src/build/esbuild-build-adapter.d.ts +15 -6
  67. package/src/build/esbuild-build-adapter.js +189 -74
  68. package/src/build/runtime-build-executor.d.ts +14 -0
  69. package/src/build/runtime-build-executor.js +22 -0
  70. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  71. package/src/build/runtime-specifier-alias-plugin.js +35 -0
  72. package/src/build/runtime-specifier-aliases.d.ts +5 -0
  73. package/src/build/runtime-specifier-aliases.js +95 -0
  74. package/src/config/README.md +36 -0
  75. package/src/config/config-builder.d.ts +54 -29
  76. package/src/config/config-builder.js +255 -49
  77. package/src/{constants.d.ts → config/constants.d.ts} +13 -0
  78. package/src/{constants.js → config/constants.js} +4 -0
  79. package/src/declarations.d.ts +19 -14
  80. package/src/dev/host-runtime.d.ts +10 -0
  81. package/src/dev/host-runtime.js +24 -0
  82. package/src/dev/sc-server.d.ts +1 -1
  83. package/src/dev/sc-server.js +1 -1
  84. package/src/eco/README.md +70 -16
  85. package/src/eco/eco.browser.d.ts +2 -0
  86. package/src/eco/eco.browser.js +83 -0
  87. package/src/eco/eco.js +32 -57
  88. package/src/eco/eco.types.d.ts +14 -6
  89. package/src/eco/eco.utils.d.ts +1 -40
  90. package/src/eco/eco.utils.js +5 -35
  91. package/src/eco/global-injector-map.d.ts +3 -3
  92. package/src/eco/global-injector-map.js +2 -2
  93. package/src/eco/lazy-injector-map.d.ts +2 -2
  94. package/src/errors/index.d.ts +1 -0
  95. package/src/errors/index.js +3 -1
  96. package/src/hmr/README.md +26 -0
  97. package/src/hmr/client/hmr-runtime.d.ts +1 -6
  98. package/src/hmr/client/hmr-runtime.js +38 -7
  99. package/src/hmr/hmr-strategy.d.ts +16 -13
  100. package/src/hmr/hmr-strategy.js +22 -7
  101. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  102. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  103. package/src/hmr/hmr.test.e2e.js +26 -33
  104. package/src/hmr/strategies/default-hmr-strategy.d.ts +2 -2
  105. package/src/hmr/strategies/default-hmr-strategy.js +1 -1
  106. package/src/hmr/strategies/js-hmr-strategy.d.ts +46 -48
  107. package/src/hmr/strategies/js-hmr-strategy.js +64 -74
  108. package/src/index.browser.d.ts +2 -2
  109. package/src/index.browser.js +1 -1
  110. package/src/index.d.ts +4 -3
  111. package/src/index.js +16 -5
  112. package/src/integrations/ghtml/ghtml-renderer.d.ts +3 -2
  113. package/src/integrations/ghtml/ghtml-renderer.js +27 -30
  114. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  115. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  116. package/src/integrations/ghtml/ghtml.plugin.d.ts +2 -6
  117. package/src/integrations/ghtml/ghtml.plugin.js +3 -4
  118. package/src/plugins/README.md +35 -0
  119. package/src/plugins/alias-resolver-plugin.js +17 -3
  120. package/src/plugins/eco-component-meta-plugin.d.ts +14 -1
  121. package/src/plugins/eco-component-meta-plugin.js +27 -22
  122. package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
  123. package/src/plugins/foreign-jsx-override-plugin.js +35 -0
  124. package/src/plugins/integration-plugin.d.ts +142 -29
  125. package/src/plugins/integration-plugin.js +103 -14
  126. package/src/plugins/processor.d.ts +17 -2
  127. package/src/plugins/processor.js +22 -3
  128. package/src/plugins/runtime-capability.d.ts +9 -0
  129. package/src/plugins/source-transform.d.ts +46 -0
  130. package/src/plugins/source-transform.js +71 -0
  131. package/src/route-renderer/GRAPH.md +83 -325
  132. package/src/route-renderer/README.md +73 -90
  133. package/src/route-renderer/orchestration/component-render-context.d.ts +89 -0
  134. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  135. package/src/route-renderer/orchestration/declared-ownership-graph.d.ts +18 -0
  136. package/src/route-renderer/orchestration/declared-ownership-graph.js +34 -0
  137. package/src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts +108 -0
  138. package/src/route-renderer/orchestration/foreign-subtree-execution.service.js +206 -0
  139. package/src/route-renderer/orchestration/integration-renderer.d.ts +516 -0
  140. package/src/route-renderer/orchestration/integration-renderer.js +909 -0
  141. package/src/route-renderer/orchestration/ownership-planning.service.d.ts +24 -0
  142. package/src/route-renderer/orchestration/ownership-planning.service.js +63 -0
  143. package/src/route-renderer/orchestration/ownership-validation.service.d.ts +29 -0
  144. package/src/route-renderer/orchestration/ownership-validation.service.js +53 -0
  145. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +2 -0
  146. package/src/route-renderer/orchestration/processed-asset-dedupe.js +23 -0
  147. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.d.ts +90 -0
  148. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.js +158 -0
  149. package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
  150. package/src/route-renderer/orchestration/render-output.utils.js +171 -0
  151. package/src/route-renderer/orchestration/route-render-orchestrator.d.ts +120 -0
  152. package/src/route-renderer/orchestration/route-render-orchestrator.js +388 -0
  153. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  154. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  155. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
  156. package/src/route-renderer/page-loading/component-dependency-collection.js +132 -0
  157. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
  158. package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
  159. package/src/route-renderer/{dependency-resolver.d.ts → page-loading/dependency-resolver.d.ts} +15 -4
  160. package/src/route-renderer/page-loading/dependency-resolver.js +115 -0
  161. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
  162. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
  163. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
  164. package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
  165. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
  166. package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
  167. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
  168. package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
  169. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
  170. package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
  171. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
  172. package/src/route-renderer/page-loading/page-dependency-bundling.js +137 -0
  173. package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
  174. package/src/route-renderer/{page-module-loader.js → page-loading/page-module-loader.js} +39 -14
  175. package/src/route-renderer/route-renderer.d.ts +57 -14
  176. package/src/route-renderer/route-renderer.js +30 -18
  177. package/src/router/README.md +94 -0
  178. package/src/router/client/link-intent.d.ts +53 -0
  179. package/src/router/client/link-intent.js +34 -0
  180. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  181. package/src/router/client/link-intent.test.browser.js +43 -0
  182. package/src/router/client/navigation-coordinator.d.ts +169 -0
  183. package/src/router/client/navigation-coordinator.js +215 -0
  184. package/src/router/server/route-registry.d.ts +78 -0
  185. package/src/router/server/route-registry.js +262 -0
  186. package/src/services/README.md +28 -0
  187. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
  188. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
  189. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +103 -0
  190. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset-processing.service.js +124 -89
  191. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.d.ts +1 -1
  192. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.js +2 -2
  193. package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.d.ts +16 -1
  194. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  195. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +49 -0
  196. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  197. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  198. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
  199. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
  200. package/src/services/assets/asset-processing-service/index.d.ts +6 -0
  201. package/src/services/assets/asset-processing-service/index.js +6 -0
  202. package/src/services/assets/asset-processing-service/page-package.d.ts +3 -0
  203. package/src/services/assets/asset-processing-service/page-package.js +74 -0
  204. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.d.ts +2 -2
  205. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.d.ts +2 -2
  206. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.d.ts +1 -1
  207. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.js +11 -5
  208. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +22 -0
  209. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +136 -0
  210. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  211. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  212. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.d.ts +3 -2
  213. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +119 -0
  214. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.d.ts +4 -3
  215. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.js +28 -7
  216. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.d.ts +3 -3
  217. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.js +12 -7
  218. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.d.ts +5 -2
  219. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +59 -0
  220. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
  221. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.js +9 -3
  222. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
  223. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
  224. package/src/services/assets/browser-bundle.service.d.ts +73 -0
  225. package/src/services/assets/browser-bundle.service.js +41 -0
  226. package/src/services/{page-request-cache-coordinator.service.d.ts → cache/page-request-cache-coordinator.service.d.ts} +2 -2
  227. package/src/services/{page-request-cache-coordinator.service.js → cache/page-request-cache-coordinator.service.js} +3 -1
  228. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  229. package/src/services/html/html-rewriter-provider.service.js +68 -0
  230. package/src/services/html/html-transformer.service.d.ts +87 -0
  231. package/src/services/html/html-transformer.service.js +216 -0
  232. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  233. package/src/services/invalidation/development-invalidation.service.js +190 -0
  234. package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
  235. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
  236. package/src/services/module-loading/app-server-module-transpiler.service.js +115 -0
  237. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  238. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  239. package/src/services/module-loading/module-loading-types.d.ts +2 -0
  240. package/src/services/module-loading/module-loading-types.js +0 -0
  241. package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
  242. package/src/services/module-loading/node-bootstrap-plugin.js +216 -0
  243. package/src/services/module-loading/page-module-import.service.d.ts +76 -0
  244. package/src/services/module-loading/page-module-import.service.js +170 -0
  245. package/src/services/module-loading/server-module-transpiler.service.d.ts +63 -0
  246. package/src/services/module-loading/server-module-transpiler.service.js +64 -0
  247. package/src/services/module-loading/source-module-support.d.ts +5 -0
  248. package/src/services/module-loading/source-module-support.js +8 -0
  249. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  250. package/src/services/runtime-state/dev-graph.service.js +162 -0
  251. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  252. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  253. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  254. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  255. package/src/services/{schema-validation-service.d.ts → validation/schema-validation-service.d.ts} +1 -1
  256. package/src/static-site-generator/README.md +26 -0
  257. package/src/static-site-generator/static-site-generator.d.ts +67 -20
  258. package/src/static-site-generator/static-site-generator.js +182 -138
  259. package/src/{internal-types.d.ts → types/internal-types.d.ts} +62 -30
  260. package/src/types/internal-types.js +0 -0
  261. package/src/{public-types.d.ts → types/public-types.d.ts} +201 -32
  262. package/src/types/public-types.js +0 -0
  263. package/src/utils/html-escaping.d.ts +7 -0
  264. package/src/utils/html-escaping.js +6 -0
  265. package/src/utils/locals-utils.d.ts +1 -1
  266. package/src/utils/parse-cli-args.d.ts +4 -1
  267. package/src/utils/parse-cli-args.js +16 -1
  268. package/src/utils/resolve-work-dir.d.ts +11 -0
  269. package/src/utils/resolve-work-dir.js +31 -0
  270. package/src/watchers/project-watcher.d.ts +40 -29
  271. package/src/watchers/project-watcher.js +126 -116
  272. package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
  273. package/src/watchers/project-watcher.test-helpers.js +6 -6
  274. package/src/adapters/abstract/application-adapter.ts +0 -337
  275. package/src/adapters/abstract/router-adapter.ts +0 -30
  276. package/src/adapters/abstract/server-adapter.ts +0 -79
  277. package/src/adapters/bun/client-bridge.ts +0 -62
  278. package/src/adapters/bun/create-app.ts +0 -189
  279. package/src/adapters/bun/define-api-handler.d.ts +0 -61
  280. package/src/adapters/bun/define-api-handler.ts +0 -114
  281. package/src/adapters/bun/hmr-manager.ts +0 -296
  282. package/src/adapters/bun/index.ts +0 -3
  283. package/src/adapters/bun/server-adapter.ts +0 -492
  284. package/src/adapters/bun/server-lifecycle.ts +0 -154
  285. package/src/adapters/index.ts +0 -6
  286. package/src/adapters/node/create-app.ts +0 -179
  287. package/src/adapters/node/index.d.ts +0 -4
  288. package/src/adapters/node/index.js +0 -8
  289. package/src/adapters/node/index.ts +0 -9
  290. package/src/adapters/node/node-client-bridge.ts +0 -79
  291. package/src/adapters/node/node-hmr-manager.ts +0 -289
  292. package/src/adapters/node/server-adapter.ts +0 -561
  293. package/src/adapters/node/static-content-server.ts +0 -203
  294. package/src/adapters/shared/api-response.ts +0 -104
  295. package/src/adapters/shared/application-adapter.ts +0 -199
  296. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -134
  297. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -123
  298. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  299. package/src/adapters/shared/fs-server-response-matcher.ts +0 -198
  300. package/src/adapters/shared/render-context.ts +0 -105
  301. package/src/adapters/shared/server-adapter.ts +0 -442
  302. package/src/adapters/shared/server-route-handler.ts +0 -166
  303. package/src/adapters/shared/server-static-builder.ts +0 -82
  304. package/src/build/build-adapter.ts +0 -132
  305. package/src/build/build-types.ts +0 -83
  306. package/src/build/esbuild-build-adapter.ts +0 -510
  307. package/src/config/config-builder.ts +0 -474
  308. package/src/constants.ts +0 -39
  309. package/src/create-app.ts +0 -87
  310. package/src/define-api-handler.js +0 -15
  311. package/src/define-api-handler.ts +0 -66
  312. package/src/dev/sc-server.ts +0 -143
  313. package/src/eco/component-render-context.d.ts +0 -105
  314. package/src/eco/component-render-context.js +0 -77
  315. package/src/eco/component-render-context.ts +0 -202
  316. package/src/eco/eco.ts +0 -221
  317. package/src/eco/eco.types.ts +0 -202
  318. package/src/eco/eco.utils.ts +0 -89
  319. package/src/eco/global-injector-map.ts +0 -112
  320. package/src/eco/lazy-injector-map.ts +0 -120
  321. package/src/eco/module-dependencies.ts +0 -75
  322. package/src/errors/http-error.ts +0 -72
  323. package/src/errors/index.ts +0 -2
  324. package/src/errors/locals-access-error.ts +0 -7
  325. package/src/global/app-logger.ts +0 -4
  326. 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
  327. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  328. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  329. package/src/hmr/client/hmr-runtime.ts +0 -121
  330. package/src/hmr/hmr-strategy.ts +0 -172
  331. package/src/hmr/hmr.test.e2e.ts +0 -75
  332. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  333. package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
  334. package/src/index.browser.ts +0 -3
  335. package/src/index.ts +0 -5
  336. package/src/integrations/ghtml/ghtml-renderer.ts +0 -93
  337. package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
  338. package/src/internal-types.ts +0 -212
  339. package/src/plugins/alias-resolver-plugin.ts +0 -45
  340. package/src/plugins/eco-component-meta-plugin.ts +0 -474
  341. package/src/plugins/integration-plugin.ts +0 -184
  342. package/src/plugins/processor.ts +0 -220
  343. package/src/public-types.ts +0 -1260
  344. package/src/route-renderer/component-graph-executor.d.ts +0 -32
  345. package/src/route-renderer/component-graph-executor.js +0 -31
  346. package/src/route-renderer/component-graph-executor.ts +0 -84
  347. package/src/route-renderer/component-graph.d.ts +0 -42
  348. package/src/route-renderer/component-graph.js +0 -72
  349. package/src/route-renderer/component-graph.ts +0 -159
  350. package/src/route-renderer/component-marker.d.ts +0 -52
  351. package/src/route-renderer/component-marker.js +0 -46
  352. package/src/route-renderer/component-marker.ts +0 -117
  353. package/src/route-renderer/dependency-resolver.js +0 -428
  354. package/src/route-renderer/dependency-resolver.ts +0 -596
  355. package/src/route-renderer/html-post-processing.service.d.ts +0 -40
  356. package/src/route-renderer/html-post-processing.service.js +0 -86
  357. package/src/route-renderer/html-post-processing.service.ts +0 -103
  358. package/src/route-renderer/integration-renderer.d.ts +0 -339
  359. package/src/route-renderer/integration-renderer.js +0 -526
  360. package/src/route-renderer/integration-renderer.ts +0 -696
  361. package/src/route-renderer/marker-graph-resolver.d.ts +0 -76
  362. package/src/route-renderer/marker-graph-resolver.js +0 -93
  363. package/src/route-renderer/marker-graph-resolver.ts +0 -153
  364. package/src/route-renderer/page-module-loader.d.ts +0 -61
  365. package/src/route-renderer/page-module-loader.ts +0 -153
  366. package/src/route-renderer/render-execution.service.d.ts +0 -69
  367. package/src/route-renderer/render-execution.service.js +0 -91
  368. package/src/route-renderer/render-execution.service.ts +0 -158
  369. package/src/route-renderer/render-preparation.service.d.ts +0 -112
  370. package/src/route-renderer/render-preparation.service.js +0 -243
  371. package/src/route-renderer/render-preparation.service.ts +0 -358
  372. package/src/route-renderer/route-renderer.ts +0 -80
  373. package/src/router/fs-router-scanner.d.ts +0 -41
  374. package/src/router/fs-router-scanner.js +0 -155
  375. package/src/router/fs-router-scanner.ts +0 -217
  376. package/src/router/fs-router.d.ts +0 -26
  377. package/src/router/fs-router.js +0 -100
  378. package/src/router/fs-router.ts +0 -122
  379. package/src/services/asset-processing-service/asset-processing.service.d.ts +0 -41
  380. package/src/services/asset-processing-service/asset-processing.service.ts +0 -306
  381. package/src/services/asset-processing-service/asset.factory.ts +0 -105
  382. package/src/services/asset-processing-service/assets.types.ts +0 -112
  383. package/src/services/asset-processing-service/index.d.ts +0 -3
  384. package/src/services/asset-processing-service/index.js +0 -3
  385. package/src/services/asset-processing-service/index.ts +0 -3
  386. package/src/services/asset-processing-service/processor.interface.ts +0 -27
  387. package/src/services/asset-processing-service/processor.registry.ts +0 -18
  388. package/src/services/asset-processing-service/processors/base/base-processor.ts +0 -76
  389. package/src/services/asset-processing-service/processors/base/base-script-processor.d.ts +0 -16
  390. package/src/services/asset-processing-service/processors/base/base-script-processor.js +0 -80
  391. package/src/services/asset-processing-service/processors/base/base-script-processor.ts +0 -105
  392. package/src/services/asset-processing-service/processors/index.d.ts +0 -5
  393. package/src/services/asset-processing-service/processors/index.js +0 -5
  394. package/src/services/asset-processing-service/processors/index.ts +0 -5
  395. package/src/services/asset-processing-service/processors/script/content-script.processor.js +0 -57
  396. package/src/services/asset-processing-service/processors/script/content-script.processor.ts +0 -66
  397. package/src/services/asset-processing-service/processors/script/file-script.processor.ts +0 -88
  398. package/src/services/asset-processing-service/processors/script/node-module-script.processor.ts +0 -84
  399. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -25
  400. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
  401. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -77
  402. package/src/services/cache/cache.types.ts +0 -126
  403. package/src/services/cache/index.ts +0 -18
  404. package/src/services/cache/memory-cache-store.ts +0 -130
  405. package/src/services/cache/page-cache-service.ts +0 -202
  406. package/src/services/html-transformer.service.d.ts +0 -50
  407. package/src/services/html-transformer.service.js +0 -163
  408. package/src/services/html-transformer.service.ts +0 -217
  409. package/src/services/page-module-import.service.d.ts +0 -37
  410. package/src/services/page-module-import.service.js +0 -88
  411. package/src/services/page-module-import.service.ts +0 -129
  412. package/src/services/page-request-cache-coordinator.service.ts +0 -128
  413. package/src/services/schema-validation-service.ts +0 -204
  414. package/src/services/validation/standard-schema.types.ts +0 -68
  415. package/src/static-site-generator/static-site-generator.ts +0 -359
  416. package/src/utils/css.d.ts +0 -1
  417. package/src/utils/css.js +0 -7
  418. package/src/utils/css.ts +0 -5
  419. package/src/utils/deep-merge.ts +0 -47
  420. package/src/utils/hash.ts +0 -5
  421. package/src/utils/html.ts +0 -1
  422. package/src/utils/invariant.ts +0 -15
  423. package/src/utils/locals-utils.ts +0 -37
  424. package/src/utils/parse-cli-args.ts +0 -83
  425. package/src/utils/path-utils.module.ts +0 -14
  426. package/src/utils/runtime.ts +0 -44
  427. package/src/utils/server-utils.module.ts +0 -67
  428. package/src/watchers/project-watcher.test-helpers.ts +0 -41
  429. package/src/watchers/project-watcher.ts +0 -344
  430. /package/src/adapters/{bun → shared}/define-api-handler.js +0 -0
  431. /package/src/{internal-types.js → plugins/runtime-capability.js} +0 -0
  432. /package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.js +0 -0
  433. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.js +0 -0
  434. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.js +0 -0
  435. /package/src/{public-types.js → services/module-loading/app-module-loader.service.js} +0 -0
  436. /package/src/services/{schema-validation-service.js → validation/schema-validation-service.js} +0 -0
@@ -0,0 +1,171 @@
1
+ import { buildInjectorMapScript } from "../../eco/lazy-injector-map.js";
2
+ function cloneTemplateStrings(strings, firstString) {
3
+ const nextStrings = [...strings];
4
+ nextStrings[0] = firstString;
5
+ const rawDescriptor = Object.getOwnPropertyDescriptor(strings, "raw");
6
+ if (rawDescriptor && Array.isArray(rawDescriptor.value)) {
7
+ const rawStrings = [...rawDescriptor.value];
8
+ rawStrings[0] = firstString;
9
+ Object.defineProperty(nextStrings, "raw", {
10
+ ...rawDescriptor,
11
+ value: rawStrings
12
+ });
13
+ }
14
+ return nextStrings;
15
+ }
16
+ function cloneTemplateContentWithUpdatedFirstString(content, firstString) {
17
+ const descriptors = Object.getOwnPropertyDescriptors(content);
18
+ const clonedContent = Object.create(Object.getPrototypeOf(content));
19
+ const stringsDescriptor = descriptors.strings;
20
+ Object.defineProperties(clonedContent, {
21
+ ...descriptors,
22
+ strings: {
23
+ ...stringsDescriptor,
24
+ value: cloneTemplateStrings(content.strings, firstString)
25
+ }
26
+ });
27
+ return clonedContent;
28
+ }
29
+ function cloneMarkupNodeLikeWithUpdatedOuterHtml(content, outerHTML) {
30
+ const descriptors = Object.getOwnPropertyDescriptors(content);
31
+ const clonedContent = Object.create(Object.getPrototypeOf(content));
32
+ const outerHTMLDescriptor = descriptors.outerHTML;
33
+ Object.defineProperties(clonedContent, {
34
+ ...descriptors,
35
+ outerHTML: {
36
+ configurable: outerHTMLDescriptor?.configurable ?? true,
37
+ enumerable: outerHTMLDescriptor?.enumerable ?? true,
38
+ writable: true,
39
+ value: outerHTML
40
+ }
41
+ });
42
+ return clonedContent;
43
+ }
44
+ function wrapWithScriptsInjectorMarkup(content, injectorMapScript) {
45
+ return `<scripts-injector><script type="ecopages/injector-map">${injectorMapScript}<\/script>${content}<\/scripts-injector>`;
46
+ }
47
+ function cloneTemplateContentWithWrappedInjector(content, injectorMapScript) {
48
+ if (content.strings.length === 0) {
49
+ return wrapWithScriptsInjectorMarkup(String(content), injectorMapScript);
50
+ }
51
+ const nextStrings = [...content.strings];
52
+ nextStrings[0] = wrapWithScriptsInjectorMarkup(nextStrings[0] ?? "", injectorMapScript);
53
+ nextStrings[nextStrings.length - 1] = `${nextStrings[nextStrings.length - 1] ?? ""}<\/scripts-injector>`;
54
+ const rawDescriptor = Object.getOwnPropertyDescriptor(content.strings, "raw");
55
+ if (rawDescriptor && Array.isArray(rawDescriptor.value)) {
56
+ const rawStrings = [...rawDescriptor.value];
57
+ rawStrings[0] = wrapWithScriptsInjectorMarkup(rawStrings[0] ?? "", injectorMapScript);
58
+ rawStrings[rawStrings.length - 1] = `${rawStrings[rawStrings.length - 1] ?? ""}<\/scripts-injector>`;
59
+ Object.defineProperty(nextStrings, "raw", {
60
+ ...rawDescriptor,
61
+ value: rawStrings
62
+ });
63
+ }
64
+ const descriptors = Object.getOwnPropertyDescriptors(content);
65
+ const clonedContent = Object.create(Object.getPrototypeOf(content));
66
+ const stringsDescriptor = descriptors.strings;
67
+ Object.defineProperties(clonedContent, {
68
+ ...descriptors,
69
+ strings: {
70
+ ...stringsDescriptor,
71
+ value: nextStrings
72
+ }
73
+ });
74
+ return clonedContent;
75
+ }
76
+ function isThenable(value) {
77
+ return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
78
+ }
79
+ function isTemplateContentShape(value) {
80
+ return typeof value === "object" && value !== null && Array.isArray(value.strings) && ((value.values ?? void 0) === void 0 || Array.isArray(value.values));
81
+ }
82
+ function isMarkupNodeLikeShape(value) {
83
+ return typeof value === "object" && value !== null && typeof value.nodeType === "number";
84
+ }
85
+ function injectTriggerAttributeIntoString(content, triggerId) {
86
+ const str = content;
87
+ let i = 0;
88
+ while (i < str.length) {
89
+ if (str[i] !== "<") {
90
+ i++;
91
+ continue;
92
+ }
93
+ const next = str[i + 1];
94
+ if (next === "!" || next === "?") {
95
+ const end = str.indexOf(">", i);
96
+ if (end === -1) break;
97
+ i = end + 1;
98
+ continue;
99
+ }
100
+ if (next && /[a-zA-Z]/.test(next)) {
101
+ const tagSlice = str.slice(i + 1);
102
+ const nameEnd = tagSlice.search(/[\s/>]/);
103
+ if (nameEnd === -1) break;
104
+ const insertAt = i + 1 + nameEnd;
105
+ return `${str.slice(0, insertAt)} data-eco-trigger="${triggerId}"${str.slice(insertAt)}`;
106
+ }
107
+ break;
108
+ }
109
+ return str;
110
+ }
111
+ function addTriggerAttribute(content, triggerId) {
112
+ if (isTemplateContentShape(content)) {
113
+ if (content.strings.length === 0) {
114
+ return String(content);
115
+ }
116
+ return cloneTemplateContentWithUpdatedFirstString(
117
+ content,
118
+ injectTriggerAttributeIntoString(content.strings[0] ?? "", triggerId)
119
+ );
120
+ }
121
+ if (isMarkupNodeLikeShape(content) && typeof content.outerHTML === "string") {
122
+ return cloneMarkupNodeLikeWithUpdatedOuterHtml(
123
+ content,
124
+ injectTriggerAttributeIntoString(content.outerHTML, triggerId)
125
+ );
126
+ }
127
+ return injectTriggerAttributeIntoString(String(content), triggerId);
128
+ }
129
+ function wrapWithScriptsInjector(content, lazyGroups) {
130
+ const injectorMapScript = buildInjectorMapScript(lazyGroups ?? []);
131
+ if (isTemplateContentShape(content)) {
132
+ return cloneTemplateContentWithWrappedInjector(content, injectorMapScript);
133
+ }
134
+ if (isMarkupNodeLikeShape(content) && typeof content.outerHTML === "string") {
135
+ return cloneMarkupNodeLikeWithUpdatedOuterHtml(
136
+ content,
137
+ wrapWithScriptsInjectorMarkup(content.outerHTML, injectorMapScript)
138
+ );
139
+ }
140
+ return wrapWithScriptsInjectorMarkup(String(content), injectorMapScript);
141
+ }
142
+ function decodeHtmlEntities(value) {
143
+ let decoded = value;
144
+ let previous;
145
+ do {
146
+ previous = decoded;
147
+ decoded = decoded.replaceAll("&quot;", '"').replaceAll("&#39;", "'").replaceAll("&#x27;", "'").replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&amp;", "&");
148
+ } while (decoded !== previous);
149
+ return decoded;
150
+ }
151
+ function normalizeUnresolvedMarkerArtifactHtml(html) {
152
+ return html.replace(
153
+ /&(?:amp;)?lt;eco-marker\b[\s\S]*?&(?:amp;)?gt;&(?:amp;)?lt;\/eco-marker&(?:amp;)?gt;/g,
154
+ (marker) => decodeHtmlEntities(marker)
155
+ );
156
+ }
157
+ function inspectUnresolvedMarkerArtifactHtml(html) {
158
+ const normalizedHtml = normalizeUnresolvedMarkerArtifactHtml(html);
159
+ return {
160
+ normalizedHtml,
161
+ hasUnresolvedMarkerArtifacts: normalizedHtml.includes("<eco-marker")
162
+ };
163
+ }
164
+ export {
165
+ addTriggerAttribute,
166
+ decodeHtmlEntities,
167
+ inspectUnresolvedMarkerArtifactHtml,
168
+ isThenable,
169
+ normalizeUnresolvedMarkerArtifactHtml,
170
+ wrapWithScriptsInjector
171
+ };
@@ -0,0 +1,120 @@
1
+ import type { EcoPagesAppConfig } from '../../types/internal-types.js';
2
+ import type { ComponentRenderResult, EcoComponent, EcoPageComponent, EcoPageFile, HtmlTemplateProps, IntegrationRendererRenderOptions, PageBrowserGraphResult, PageMetadataProps, RouteRendererBody, RouteRendererOptions, RouteRenderResult } from '../../types/public-types.js';
3
+ import { type AssetProcessingService, type ProcessedAsset } from '../../services/assets/asset-processing-service/index.js';
4
+ import { OwnershipValidationService } from './ownership-validation.service.js';
5
+ import { OwnershipPlanningService } from './ownership-planning.service.js';
6
+ export type RouteRenderOrchestratorResolvedInputs = {
7
+ Page: EcoPageFile['default'] | EcoPageComponent<any>;
8
+ HtmlTemplate: EcoComponent<HtmlTemplateProps>;
9
+ Layout?: EcoComponent;
10
+ props: Record<string, unknown>;
11
+ metadata: PageMetadataProps;
12
+ integrationSpecificProps: Record<string, unknown>;
13
+ };
14
+ export type RouteRenderOrchestratorResolvedAssets = {
15
+ resolvedDependencies: ProcessedAsset[];
16
+ pageBrowserGraph?: PageBrowserGraphResult;
17
+ };
18
+ /**
19
+ * Structural HTML work applied after the route body has been fully resolved.
20
+ *
21
+ * The shared route flow only needs to know whether a post-render HTML step
22
+ * exists. When `finalizeHtml` is absent, the captured body can be reused as-is.
23
+ */
24
+ export type RouteHtmlFinalization = {
25
+ finalizeHtml?(html: string): string;
26
+ };
27
+ export interface RouteRenderOrchestratorAdapter<C> {
28
+ /**
29
+ * Name of the owning Integration for the current route render.
30
+ */
31
+ readonly name: string;
32
+ /**
33
+ * Loads the Integration-owned route inputs needed for one Page render.
34
+ */
35
+ resolveRouteRenderInputs(routeOptions: RouteRendererOptions): Promise<RouteRenderOrchestratorResolvedInputs>;
36
+ /**
37
+ * Resolves route-owned assets needed before Integration rendering starts.
38
+ */
39
+ resolveRouteAssets(input: {
40
+ routeOptions: RouteRendererOptions;
41
+ components: (EcoComponent | Partial<EcoComponent>)[];
42
+ }): Promise<RouteRenderOrchestratorResolvedAssets>;
43
+ /**
44
+ * Resolves the optional page-root render through the foreign-child-aware component contract.
45
+ */
46
+ resolveRoutePageComponentRender(input: {
47
+ Page: EcoComponent;
48
+ Layout?: EcoComponent;
49
+ props: Record<string, unknown>;
50
+ routeOptions: RouteRendererOptions;
51
+ }): Promise<ComponentRenderResult | undefined>;
52
+ /**
53
+ * Executes the Integration-specific route render.
54
+ */
55
+ renderRouteBody(renderOptions: IntegrationRendererRenderOptions<C>): Promise<RouteRendererBody>;
56
+ /**
57
+ * Returns the structural Html finalization plan for one prepared route render.
58
+ */
59
+ getRouteHtmlFinalization(renderOptions: IntegrationRendererRenderOptions<C>): RouteHtmlFinalization;
60
+ /**
61
+ * Runs SSR-policy response transformation and returns the body value exposed to callers.
62
+ */
63
+ transformRouteResponse(response: Response): Promise<RouteRendererBody>;
64
+ }
65
+ /**
66
+ * Captured route-render output in both replayable body and string HTML forms.
67
+ */
68
+ export interface CapturedHtmlRenderResult {
69
+ body: RouteRendererBody;
70
+ html: string;
71
+ }
72
+ /**
73
+ * Optional app-scoped collaborators used by the route render orchestrator.
74
+ */
75
+ export interface RouteRenderOrchestratorDependencies {
76
+ ownershipPlanningService?: OwnershipPlanningService;
77
+ ownershipValidationService?: OwnershipValidationService;
78
+ }
79
+ /**
80
+ * Owns one route render from normalized module loading through final HTML output.
81
+ *
82
+ * This orchestrator keeps route rendering as one app-scoped unit while still
83
+ * delegating integration-specific behavior through the adapter seam. It owns
84
+ * route-root validation, dependency aggregation, page package creation, and the
85
+ * final HTML/body handling that happens after the integration render returns.
86
+ */
87
+ export declare class RouteRenderOrchestrator {
88
+ private readonly appConfig;
89
+ private readonly assetProcessingService;
90
+ private readonly ownershipPlanningService;
91
+ private readonly ownershipValidationService;
92
+ constructor(appConfig: EcoPagesAppConfig, assetProcessingService: AssetProcessingService, dependencies?: RouteRenderOrchestratorDependencies);
93
+ /**
94
+ * Builds normalized route render options before the integration render runs.
95
+ *
96
+ * This preparation step validates route-root ownership, resolves page data,
97
+ * collects processed assets, captures optional page-root render metadata, and
98
+ * produces the page package consumed by downstream HTML transformation.
99
+ */
100
+ prepareRenderOptions<C = unknown>(routeOptions: RouteRendererOptions, adapter: RouteRenderOrchestratorAdapter<C>): Promise<IntegrationRendererRenderOptions<C>>;
101
+ /**
102
+ * Captures one route render body as HTML while preserving a replayable body value.
103
+ */
104
+ captureHtmlRender(render: () => Promise<RouteRendererBody>): Promise<CapturedHtmlRenderResult>;
105
+ /**
106
+ * Executes the full route-render flow and returns the final body plus cache strategy.
107
+ */
108
+ execute<C = unknown>(options: RouteRendererOptions, adapter: RouteRenderOrchestratorAdapter<C>): Promise<RouteRenderResult>;
109
+ /**
110
+ * Executes the route-render finalization path for already prepared render options.
111
+ */
112
+ executePrepared<C = unknown>(renderOptions: IntegrationRendererRenderOptions<C>, adapter: RouteRenderOrchestratorAdapter<C>): Promise<RouteRenderResult>;
113
+ private captureRenderedBody;
114
+ private collectResolvedTriggers;
115
+ private collectUsedIntegrationDependencies;
116
+ private collectIntegrationNames;
117
+ private buildGlobalInjectorAssets;
118
+ private buildEagerSsrLazyAssets;
119
+ private collectEagerSsrLazyDependencies;
120
+ }
@@ -0,0 +1,388 @@
1
+ import { createRequire } from "node:module";
2
+ import path from "node:path";
3
+ import {
4
+ AssetFactory,
5
+ createPagePackage
6
+ } from "../../services/assets/asset-processing-service/index.js";
7
+ import { buildGlobalInjectorBootstrapContent, buildGlobalInjectorMapScript } from "../../eco/global-injector-map.js";
8
+ import { LocalsAccessError } from "../../errors/locals-access-error.js";
9
+ import { inspectUnresolvedMarkerArtifactHtml } from "./render-output.utils.js";
10
+ import { OwnershipValidationService } from "./ownership-validation.service.js";
11
+ import { OwnershipPlanningService } from "./ownership-planning.service.js";
12
+ import { dedupeProcessedAssets } from "./processed-asset-dedupe.js";
13
+ function createPageLocalsProxy(filePath) {
14
+ const errorMessage = `[ecopages] Request locals are only available during request-time rendering with cache: 'dynamic'. Page: ${filePath}. If you meant to use locals here, set cache: 'dynamic' and provide locals from route middleware/handlers.`;
15
+ return new Proxy(
16
+ {},
17
+ {
18
+ get: () => {
19
+ throw new LocalsAccessError(errorMessage);
20
+ },
21
+ set: () => {
22
+ throw new LocalsAccessError(errorMessage);
23
+ },
24
+ has: () => {
25
+ throw new LocalsAccessError(errorMessage);
26
+ },
27
+ ownKeys: () => {
28
+ throw new LocalsAccessError(errorMessage);
29
+ },
30
+ deleteProperty: () => {
31
+ throw new LocalsAccessError(errorMessage);
32
+ },
33
+ defineProperty: () => {
34
+ throw new LocalsAccessError(errorMessage);
35
+ },
36
+ getOwnPropertyDescriptor: () => {
37
+ throw new LocalsAccessError(errorMessage);
38
+ }
39
+ }
40
+ );
41
+ }
42
+ class RouteRenderOrchestrator {
43
+ appConfig;
44
+ assetProcessingService;
45
+ ownershipPlanningService;
46
+ ownershipValidationService;
47
+ constructor(appConfig, assetProcessingService, dependencies = {}) {
48
+ this.appConfig = appConfig;
49
+ this.assetProcessingService = assetProcessingService;
50
+ this.ownershipPlanningService = dependencies.ownershipPlanningService ?? new OwnershipPlanningService();
51
+ this.ownershipValidationService = dependencies.ownershipValidationService ?? new OwnershipValidationService(appConfig);
52
+ }
53
+ /**
54
+ * Builds normalized route render options before the integration render runs.
55
+ *
56
+ * This preparation step validates route-root ownership, resolves page data,
57
+ * collects processed assets, captures optional page-root render metadata, and
58
+ * produces the page package consumed by downstream HTML transformation.
59
+ */
60
+ async prepareRenderOptions(routeOptions, adapter) {
61
+ const resolvedInputs = await adapter.resolveRouteRenderInputs(routeOptions);
62
+ const { Page, HtmlTemplate, Layout, props, metadata, integrationSpecificProps } = resolvedInputs;
63
+ const validationErrors = this.ownershipValidationService.validate({
64
+ currentIntegrationName: adapter.name,
65
+ roots: [
66
+ { component: HtmlTemplate, source: "html-template" },
67
+ ...Layout ? [{ component: Layout, source: "layout" }] : [],
68
+ { component: Page, source: "page" }
69
+ ]
70
+ });
71
+ const ownershipPlan = this.ownershipPlanningService.buildPlan({
72
+ routeFile: routeOptions.file,
73
+ currentIntegrationName: adapter.name,
74
+ HtmlTemplate,
75
+ Layout,
76
+ Page,
77
+ validationErrors
78
+ });
79
+ const componentsToResolve = Layout ? [HtmlTemplate, Layout, Page] : [HtmlTemplate, Page];
80
+ const { resolvedDependencies, pageBrowserGraph } = await adapter.resolveRouteAssets({
81
+ routeOptions,
82
+ components: componentsToResolve
83
+ });
84
+ const usedIntegrationDependencies = this.collectUsedIntegrationDependencies(componentsToResolve, adapter.name);
85
+ const allDependencies = [
86
+ ...resolvedDependencies,
87
+ ...usedIntegrationDependencies,
88
+ ...pageBrowserGraph?.assets ?? []
89
+ ];
90
+ const componentRender = await adapter.resolveRoutePageComponentRender({
91
+ Page,
92
+ Layout,
93
+ props,
94
+ routeOptions
95
+ });
96
+ if (componentRender?.assets?.length) {
97
+ allDependencies.push(...componentRender.assets);
98
+ }
99
+ const triggers = this.collectResolvedTriggers(componentsToResolve);
100
+ if (triggers.length > 0) {
101
+ const globalAssets = await this.buildGlobalInjectorAssets(triggers, adapter.name);
102
+ allDependencies.push(...globalAssets);
103
+ }
104
+ const eagerSsrLazyAssets = await this.buildEagerSsrLazyAssets(componentsToResolve, adapter.name);
105
+ if (eagerSsrLazyAssets.length > 0) {
106
+ allDependencies.push(...eagerSsrLazyAssets);
107
+ }
108
+ const dedupedDependencies = dedupeProcessedAssets(allDependencies);
109
+ const pagePackage = createPagePackage(dedupedDependencies);
110
+ const pageProps = {
111
+ ...props,
112
+ params: routeOptions.params || {},
113
+ query: routeOptions.query || {}
114
+ };
115
+ const cacheStrategy = Page.cache;
116
+ const defaultCacheStrategy = this.appConfig.cache?.defaultStrategy ?? "static";
117
+ const effectiveCacheStrategy = cacheStrategy ?? defaultCacheStrategy;
118
+ const localsAvailable = effectiveCacheStrategy === "dynamic" && routeOptions.locals !== void 0;
119
+ const pageLocals = localsAvailable ? routeOptions.locals : createPageLocalsProxy(routeOptions.file);
120
+ const locals = localsAvailable ? routeOptions.locals : void 0;
121
+ const preparedOptions = {
122
+ ...routeOptions,
123
+ resolvedDependencies,
124
+ pagePackage,
125
+ componentRender,
126
+ HtmlTemplate,
127
+ Layout,
128
+ props,
129
+ Page,
130
+ metadata,
131
+ params: routeOptions.params || {},
132
+ query: routeOptions.query || {},
133
+ pageProps,
134
+ locals,
135
+ pageLocals,
136
+ cacheStrategy,
137
+ ownershipPlan
138
+ };
139
+ return {
140
+ ...integrationSpecificProps,
141
+ ...preparedOptions
142
+ };
143
+ }
144
+ /**
145
+ * Captures one route render body as HTML while preserving a replayable body value.
146
+ */
147
+ async captureHtmlRender(render) {
148
+ const renderedBody = await render();
149
+ const capturedRender = await this.captureRenderedBody(renderedBody);
150
+ return {
151
+ body: capturedRender.body,
152
+ html: capturedRender.html
153
+ };
154
+ }
155
+ /**
156
+ * Executes the full route-render flow and returns the final body plus cache strategy.
157
+ */
158
+ async execute(options, adapter) {
159
+ const renderOptions = await this.prepareRenderOptions(options, adapter);
160
+ return this.executePrepared(renderOptions, adapter);
161
+ }
162
+ /**
163
+ * Executes the route-render finalization path for already prepared render options.
164
+ */
165
+ async executePrepared(renderOptions, adapter) {
166
+ const renderExecution = await this.captureHtmlRender(async () => adapter.renderRouteBody(renderOptions));
167
+ const unresolvedArtifactInspection = inspectUnresolvedMarkerArtifactHtml(renderExecution.html);
168
+ const htmlFinalization = adapter.getRouteHtmlFinalization(renderOptions);
169
+ const hasUnresolvedMarkerHtml = unresolvedArtifactInspection.hasUnresolvedMarkerArtifacts;
170
+ if (hasUnresolvedMarkerHtml) {
171
+ throw new Error(
172
+ "[ecopages] Route render returned unresolved eco-marker artifact HTML. Full-route unresolved-marker fallback has been removed; resolve mixed foreign children inside renderComponentWithForeignChildren()."
173
+ );
174
+ }
175
+ const canReuseCapturedBody = !hasUnresolvedMarkerHtml && htmlFinalization.finalizeHtml === void 0;
176
+ if (canReuseCapturedBody) {
177
+ const body2 = await adapter.transformRouteResponse(
178
+ new Response(renderExecution.body, {
179
+ headers: {
180
+ "Content-Type": "text/html"
181
+ }
182
+ })
183
+ );
184
+ return {
185
+ body: body2,
186
+ cacheStrategy: renderOptions.cacheStrategy
187
+ };
188
+ }
189
+ const finalization = htmlFinalization.finalizeHtml ? htmlFinalization.finalizeHtml(unresolvedArtifactInspection.normalizedHtml) : unresolvedArtifactInspection.normalizedHtml;
190
+ const body = await adapter.transformRouteResponse(
191
+ new Response(finalization, {
192
+ headers: {
193
+ "Content-Type": "text/html"
194
+ }
195
+ })
196
+ );
197
+ return {
198
+ body,
199
+ cacheStrategy: renderOptions.cacheStrategy
200
+ };
201
+ }
202
+ async captureRenderedBody(body) {
203
+ const response = new Response(body);
204
+ if (typeof body === "string") {
205
+ return {
206
+ body,
207
+ html: await response.text()
208
+ };
209
+ }
210
+ if (!response.body) {
211
+ return {
212
+ body,
213
+ html: await response.text()
214
+ };
215
+ }
216
+ const [capturedBody, replayBody] = response.body.tee();
217
+ return {
218
+ body: replayBody,
219
+ html: await new Response(capturedBody).text()
220
+ };
221
+ }
222
+ collectResolvedTriggers(components, seen = /* @__PURE__ */ new Set()) {
223
+ const triggers = [];
224
+ for (const comp of components) {
225
+ if (!comp) {
226
+ continue;
227
+ }
228
+ const ecoComp = comp;
229
+ if (seen.has(ecoComp)) {
230
+ continue;
231
+ }
232
+ seen.add(ecoComp);
233
+ const ownTriggers = ecoComp.config?._resolvedLazyTriggers;
234
+ if (ownTriggers?.length) {
235
+ triggers.push(...ownTriggers);
236
+ }
237
+ const nested = ecoComp.config?.dependencies?.components;
238
+ if (nested?.length) {
239
+ triggers.push(...this.collectResolvedTriggers(nested, seen));
240
+ }
241
+ }
242
+ return triggers;
243
+ }
244
+ collectUsedIntegrationDependencies(components, currentIntegrationName) {
245
+ const integrationNames = this.collectIntegrationNames(components);
246
+ const dependencies = [];
247
+ for (const integrationName of integrationNames) {
248
+ if (integrationName === currentIntegrationName) {
249
+ continue;
250
+ }
251
+ const integrationPlugin = this.appConfig.integrations.find(
252
+ (integration) => integration.name === integrationName
253
+ );
254
+ if (!integrationPlugin || typeof integrationPlugin.getResolvedIntegrationDependencies !== "function") {
255
+ continue;
256
+ }
257
+ dependencies.push(...integrationPlugin.getResolvedIntegrationDependencies());
258
+ }
259
+ return dependencies;
260
+ }
261
+ collectIntegrationNames(components, seen = /* @__PURE__ */ new Set()) {
262
+ const integrationNames = /* @__PURE__ */ new Set();
263
+ for (const comp of components) {
264
+ if (!comp) {
265
+ continue;
266
+ }
267
+ const ecoComp = comp;
268
+ if (seen.has(ecoComp)) {
269
+ continue;
270
+ }
271
+ seen.add(ecoComp);
272
+ const integrationName = ecoComp.config?.integration ?? ecoComp.config?.__eco?.integration;
273
+ if (integrationName) {
274
+ integrationNames.add(integrationName);
275
+ }
276
+ const nested = ecoComp.config?.dependencies?.components;
277
+ if (nested?.length) {
278
+ const nestedNames = this.collectIntegrationNames(nested, seen);
279
+ for (const nestedName of nestedNames) {
280
+ integrationNames.add(nestedName);
281
+ }
282
+ }
283
+ }
284
+ return integrationNames;
285
+ }
286
+ async buildGlobalInjectorAssets(triggers, currentIntegrationName) {
287
+ const globalInjectorImportPath = createRequire(import.meta.url).resolve("@ecopages/scripts-injector/global");
288
+ const mapScript = AssetFactory.createInlineContentScript({
289
+ position: "head",
290
+ name: "ecopages-global-injector-map",
291
+ content: buildGlobalInjectorMapScript(triggers),
292
+ attributes: { type: "ecopages/global-injector-map" },
293
+ packageRole: "keep-separate",
294
+ bundle: false
295
+ });
296
+ const bootstrapInlineScript = AssetFactory.createInlineContentScript({
297
+ position: "head",
298
+ name: "ecopages-global-injector-bootstrap",
299
+ content: buildGlobalInjectorBootstrapContent(globalInjectorImportPath),
300
+ attributes: { type: "module" },
301
+ packageRole: "keep-separate",
302
+ bundle: true
303
+ });
304
+ return this.assetProcessingService.processDependencies(
305
+ [mapScript, bootstrapInlineScript],
306
+ currentIntegrationName
307
+ );
308
+ }
309
+ async buildEagerSsrLazyAssets(components, currentIntegrationName) {
310
+ const dependencies = this.collectEagerSsrLazyDependencies(components);
311
+ if (dependencies.length === 0) {
312
+ return [];
313
+ }
314
+ return this.assetProcessingService.processDependencies(dependencies, `${currentIntegrationName}:ssr-lazy`);
315
+ }
316
+ collectEagerSsrLazyDependencies(components) {
317
+ const dependencies = [];
318
+ const visitedConfigs = /* @__PURE__ */ new Set();
319
+ const seenKeys = /* @__PURE__ */ new Set();
320
+ const normalizeAttributes = (attributes) => ({
321
+ type: "module",
322
+ defer: "",
323
+ ...attributes ?? {}
324
+ });
325
+ const collect = (config) => {
326
+ if (!config || visitedConfigs.has(config)) {
327
+ return;
328
+ }
329
+ visitedConfigs.add(config);
330
+ const componentFile = config.__eco?.file;
331
+ if (componentFile) {
332
+ const componentDir = path.dirname(componentFile);
333
+ for (const script of config.dependencies?.scripts ?? []) {
334
+ if (typeof script === "string" || !script.lazy || script.ssr !== true) {
335
+ continue;
336
+ }
337
+ const attributes = normalizeAttributes(script.attributes);
338
+ if (script.content) {
339
+ const key2 = `content:${script.content}:${JSON.stringify(attributes)}`;
340
+ if (seenKeys.has(key2)) {
341
+ continue;
342
+ }
343
+ seenKeys.add(key2);
344
+ dependencies.push(
345
+ AssetFactory.createContentScript({
346
+ position: "head",
347
+ content: script.content,
348
+ attributes,
349
+ packageRole: "dynamic-chunk"
350
+ })
351
+ );
352
+ continue;
353
+ }
354
+ if (!script.src) {
355
+ continue;
356
+ }
357
+ const resolvedPath = path.resolve(componentDir, script.src);
358
+ const key = `file:${resolvedPath}:${JSON.stringify(attributes)}`;
359
+ if (seenKeys.has(key)) {
360
+ continue;
361
+ }
362
+ seenKeys.add(key);
363
+ dependencies.push(
364
+ AssetFactory.createFileScript({
365
+ filepath: resolvedPath,
366
+ position: "head",
367
+ attributes,
368
+ packageRole: "dynamic-chunk"
369
+ })
370
+ );
371
+ }
372
+ }
373
+ if (config.layout?.config) {
374
+ collect(config.layout.config);
375
+ }
376
+ for (const nestedComponent of config.dependencies?.components ?? []) {
377
+ collect(nestedComponent?.config);
378
+ }
379
+ };
380
+ for (const component of components) {
381
+ collect(component.config);
382
+ }
383
+ return dependencies;
384
+ }
385
+ }
386
+ export {
387
+ RouteRenderOrchestrator
388
+ };