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

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 (546) hide show
  1. package/CHANGELOG.md +91 -0
  2. package/package.json +162 -72
  3. package/src/adapters/abstract/application-adapter.d.ts +194 -0
  4. package/src/adapters/abstract/application-adapter.js +121 -0
  5. package/src/adapters/abstract/router-adapter.d.ts +26 -0
  6. package/src/adapters/abstract/router-adapter.js +5 -0
  7. package/src/adapters/abstract/server-adapter.d.ts +69 -0
  8. package/src/adapters/abstract/server-adapter.js +15 -0
  9. package/src/adapters/bun/client-bridge.d.ts +34 -0
  10. package/src/adapters/bun/client-bridge.js +48 -0
  11. package/src/adapters/bun/create-app.d.ts +53 -0
  12. package/src/adapters/bun/create-app.js +153 -0
  13. package/src/adapters/bun/hmr-manager.d.ts +131 -0
  14. package/src/adapters/bun/hmr-manager.js +312 -0
  15. package/src/adapters/bun/index.d.ts +2 -0
  16. package/src/adapters/bun/index.js +8 -0
  17. package/src/adapters/bun/server-adapter.d.ts +155 -0
  18. package/src/adapters/bun/server-adapter.js +393 -0
  19. package/src/adapters/bun/server-lifecycle.d.ts +63 -0
  20. package/src/adapters/bun/server-lifecycle.js +92 -0
  21. package/src/adapters/create-app.d.ts +20 -0
  22. package/src/adapters/create-app.js +66 -0
  23. package/src/adapters/index.d.ts +2 -0
  24. package/src/adapters/index.js +8 -0
  25. package/src/adapters/node/create-app.d.ts +18 -0
  26. package/src/adapters/node/create-app.js +149 -0
  27. package/src/adapters/node/node-client-bridge.d.ts +26 -0
  28. package/src/adapters/node/node-client-bridge.js +66 -0
  29. package/src/adapters/node/node-hmr-manager.d.ts +121 -0
  30. package/src/adapters/node/node-hmr-manager.js +290 -0
  31. package/src/adapters/node/server-adapter.d.ts +162 -0
  32. package/src/adapters/node/server-adapter.js +368 -0
  33. package/src/adapters/node/static-content-server.d.ts +60 -0
  34. package/src/adapters/node/static-content-server.js +194 -0
  35. package/src/adapters/shared/api-response.d.ts +52 -0
  36. package/src/adapters/shared/api-response.js +96 -0
  37. package/src/adapters/shared/application-adapter.d.ts +18 -0
  38. package/src/adapters/shared/application-adapter.js +90 -0
  39. package/src/adapters/shared/define-api-handler.d.ts +25 -0
  40. package/src/adapters/shared/define-api-handler.js +15 -0
  41. package/src/adapters/shared/explicit-static-render-preparation.d.ts +25 -0
  42. package/src/adapters/shared/explicit-static-render-preparation.js +26 -0
  43. package/src/adapters/shared/explicit-static-route-matcher.d.ts +41 -0
  44. package/src/adapters/shared/explicit-static-route-matcher.js +101 -0
  45. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +62 -0
  46. package/src/adapters/shared/file-route-middleware-pipeline.js +90 -0
  47. package/src/adapters/shared/fs-server-response-factory.d.ts +23 -0
  48. package/src/adapters/shared/fs-server-response-factory.js +81 -0
  49. package/src/adapters/shared/fs-server-response-matcher.d.ts +75 -0
  50. package/src/adapters/shared/fs-server-response-matcher.js +186 -0
  51. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  52. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  53. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  54. package/src/adapters/shared/hmr-html-response.js +32 -0
  55. package/src/adapters/shared/render-context.d.ts +15 -0
  56. package/src/adapters/shared/render-context.js +72 -0
  57. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  58. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  59. package/src/adapters/shared/server-adapter.d.ts +108 -0
  60. package/src/adapters/shared/server-adapter.js +429 -0
  61. package/src/adapters/shared/server-route-handler.d.ts +89 -0
  62. package/src/adapters/shared/server-route-handler.js +111 -0
  63. package/src/adapters/shared/server-static-builder.d.ts +71 -0
  64. package/src/adapters/shared/server-static-builder.js +100 -0
  65. package/src/build/build-adapter.d.ts +239 -0
  66. package/src/build/build-adapter.js +642 -0
  67. package/src/build/build-manifest.d.ts +27 -0
  68. package/src/build/build-manifest.js +30 -0
  69. package/src/build/build-types.d.ts +57 -0
  70. package/src/build/build-types.js +0 -0
  71. package/src/build/dev-build-coordinator.d.ts +72 -0
  72. package/src/build/dev-build-coordinator.js +154 -0
  73. package/src/build/esbuild-build-adapter.d.ts +78 -0
  74. package/src/build/esbuild-build-adapter.js +505 -0
  75. package/src/build/runtime-build-executor.d.ts +14 -0
  76. package/src/build/runtime-build-executor.js +22 -0
  77. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  78. package/src/build/runtime-specifier-alias-plugin.js +35 -0
  79. package/src/build/runtime-specifier-aliases.d.ts +5 -0
  80. package/src/build/runtime-specifier-aliases.js +95 -0
  81. package/src/config/config-builder.d.ts +252 -0
  82. package/src/config/config-builder.js +598 -0
  83. package/src/config/{constants.ts → constants.d.ts} +13 -22
  84. package/src/config/constants.js +25 -0
  85. package/src/dev/host-runtime.d.ts +10 -0
  86. package/src/dev/host-runtime.js +24 -0
  87. package/src/dev/sc-server.d.ts +30 -0
  88. package/src/dev/sc-server.js +111 -0
  89. package/src/eco/eco.browser.d.ts +2 -0
  90. package/src/eco/eco.browser.js +83 -0
  91. package/src/eco/eco.d.ts +9 -0
  92. package/src/eco/eco.js +85 -0
  93. package/src/eco/eco.types.d.ts +178 -0
  94. package/src/eco/eco.types.js +0 -0
  95. package/src/eco/eco.utils.d.ts +1 -0
  96. package/src/eco/eco.utils.js +10 -0
  97. package/src/eco/global-injector-map.d.ts +16 -0
  98. package/src/eco/global-injector-map.js +80 -0
  99. package/src/eco/lazy-injector-map.d.ts +8 -0
  100. package/src/eco/lazy-injector-map.js +70 -0
  101. package/src/eco/module-dependencies.d.ts +18 -0
  102. package/src/eco/module-dependencies.js +49 -0
  103. package/src/errors/http-error.d.ts +31 -0
  104. package/src/errors/http-error.js +50 -0
  105. package/src/errors/index.d.ts +3 -0
  106. package/src/errors/index.js +6 -0
  107. package/src/errors/locals-access-error.d.ts +4 -0
  108. package/src/errors/locals-access-error.js +9 -0
  109. package/src/global/app-logger.d.ts +2 -0
  110. package/src/global/app-logger.js +6 -0
  111. package/src/hmr/client/hmr-runtime.d.ts +5 -0
  112. package/src/hmr/client/hmr-runtime.js +117 -0
  113. package/src/hmr/hmr-strategy.d.ts +162 -0
  114. package/src/hmr/hmr-strategy.js +44 -0
  115. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  116. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  117. package/src/hmr/hmr.test.e2e.d.ts +1 -0
  118. package/src/hmr/hmr.test.e2e.js +43 -0
  119. package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
  120. package/src/hmr/strategies/default-hmr-strategy.js +34 -0
  121. package/src/hmr/strategies/js-hmr-strategy.d.ts +134 -0
  122. package/src/hmr/strategies/js-hmr-strategy.js +178 -0
  123. package/src/index.browser.d.ts +3 -0
  124. package/src/index.browser.js +4 -0
  125. package/src/index.d.ts +6 -0
  126. package/src/index.js +21 -0
  127. package/src/integrations/ghtml/ghtml-renderer.d.ts +16 -0
  128. package/src/integrations/ghtml/ghtml-renderer.js +57 -0
  129. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  130. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  131. package/src/integrations/ghtml/ghtml.plugin.d.ts +16 -0
  132. package/src/integrations/ghtml/ghtml.plugin.js +20 -0
  133. package/src/plugins/alias-resolver-plugin.d.ts +2 -0
  134. package/src/plugins/alias-resolver-plugin.js +53 -0
  135. package/src/plugins/eco-component-meta-plugin.d.ts +108 -0
  136. package/src/plugins/eco-component-meta-plugin.js +162 -0
  137. package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
  138. package/src/plugins/foreign-jsx-override-plugin.js +35 -0
  139. package/src/plugins/integration-plugin.d.ts +215 -0
  140. package/src/plugins/integration-plugin.js +189 -0
  141. package/src/plugins/processor.d.ts +97 -0
  142. package/src/plugins/processor.js +141 -0
  143. package/src/plugins/{runtime-capability.ts → runtime-capability.d.ts} +3 -8
  144. package/src/plugins/runtime-capability.js +0 -0
  145. package/src/plugins/source-transform.d.ts +46 -0
  146. package/src/plugins/source-transform.js +71 -0
  147. package/src/route-renderer/orchestration/component-render-context.d.ts +89 -0
  148. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  149. package/src/route-renderer/orchestration/declared-ownership-graph.d.ts +18 -0
  150. package/src/route-renderer/orchestration/declared-ownership-graph.js +34 -0
  151. package/src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts +108 -0
  152. package/src/route-renderer/orchestration/foreign-subtree-execution.service.js +206 -0
  153. package/src/route-renderer/orchestration/integration-renderer.d.ts +516 -0
  154. package/src/route-renderer/orchestration/integration-renderer.js +909 -0
  155. package/src/route-renderer/orchestration/ownership-planning.service.d.ts +24 -0
  156. package/src/route-renderer/orchestration/ownership-planning.service.js +63 -0
  157. package/src/route-renderer/orchestration/ownership-validation.service.d.ts +29 -0
  158. package/src/route-renderer/orchestration/ownership-validation.service.js +53 -0
  159. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +2 -0
  160. package/src/route-renderer/orchestration/processed-asset-dedupe.js +23 -0
  161. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.d.ts +90 -0
  162. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.js +158 -0
  163. package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
  164. package/src/route-renderer/orchestration/render-output.utils.js +171 -0
  165. package/src/route-renderer/orchestration/route-render-orchestrator.d.ts +120 -0
  166. package/src/route-renderer/orchestration/route-render-orchestrator.js +388 -0
  167. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  168. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  169. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
  170. package/src/route-renderer/page-loading/component-dependency-collection.js +132 -0
  171. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
  172. package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
  173. package/src/route-renderer/page-loading/dependency-resolver.d.ts +35 -0
  174. package/src/route-renderer/page-loading/dependency-resolver.js +115 -0
  175. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
  176. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
  177. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
  178. package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
  179. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
  180. package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
  181. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
  182. package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
  183. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
  184. package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
  185. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
  186. package/src/route-renderer/page-loading/page-dependency-bundling.js +137 -0
  187. package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
  188. package/src/route-renderer/page-loading/page-module-loader.js +127 -0
  189. package/src/route-renderer/route-renderer.d.ts +69 -0
  190. package/src/route-renderer/route-renderer.js +80 -0
  191. package/src/router/client/link-intent.js +34 -0
  192. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  193. package/src/router/client/link-intent.test.browser.js +43 -0
  194. package/src/router/client/navigation-coordinator.d.ts +169 -0
  195. package/src/router/client/navigation-coordinator.js +215 -0
  196. package/src/router/server/route-registry.d.ts +78 -0
  197. package/src/router/server/route-registry.js +262 -0
  198. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
  199. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
  200. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +103 -0
  201. package/src/services/assets/asset-processing-service/asset-processing.service.js +285 -0
  202. package/src/services/assets/asset-processing-service/asset.factory.d.ts +17 -0
  203. package/src/services/assets/asset-processing-service/asset.factory.js +82 -0
  204. package/src/services/assets/asset-processing-service/assets.types.d.ts +103 -0
  205. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  206. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  207. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +49 -0
  208. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  209. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  210. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
  211. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
  212. package/src/services/assets/asset-processing-service/index.d.ts +6 -0
  213. package/src/services/assets/asset-processing-service/index.js +6 -0
  214. package/src/services/assets/asset-processing-service/page-package.d.ts +3 -0
  215. package/src/services/assets/asset-processing-service/page-package.js +74 -0
  216. package/src/services/assets/asset-processing-service/{processor.interface.ts → processor.interface.d.ts} +5 -10
  217. package/src/services/assets/asset-processing-service/processor.interface.js +6 -0
  218. package/src/services/assets/asset-processing-service/processor.registry.d.ts +8 -0
  219. package/src/services/assets/asset-processing-service/processor.registry.js +15 -0
  220. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +24 -0
  221. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +65 -0
  222. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +22 -0
  223. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +136 -0
  224. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  225. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  226. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +6 -0
  227. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +119 -0
  228. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +9 -0
  229. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +97 -0
  230. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
  231. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +79 -0
  232. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +8 -0
  233. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +59 -0
  234. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
  235. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +69 -0
  236. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
  237. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
  238. package/src/services/assets/browser-bundle.service.d.ts +73 -0
  239. package/src/services/assets/browser-bundle.service.js +41 -0
  240. package/src/services/cache/cache.types.d.ts +107 -0
  241. package/src/services/cache/cache.types.js +0 -0
  242. package/src/services/cache/index.d.ts +7 -0
  243. package/src/services/cache/index.js +7 -0
  244. package/src/services/cache/memory-cache-store.d.ts +42 -0
  245. package/src/services/cache/memory-cache-store.js +98 -0
  246. package/src/services/cache/page-cache-service.d.ts +70 -0
  247. package/src/services/cache/page-cache-service.js +152 -0
  248. package/src/services/cache/page-request-cache-coordinator.service.d.ts +75 -0
  249. package/src/services/cache/page-request-cache-coordinator.service.js +109 -0
  250. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  251. package/src/services/html/html-rewriter-provider.service.js +68 -0
  252. package/src/services/html/html-transformer.service.d.ts +87 -0
  253. package/src/services/html/html-transformer.service.js +216 -0
  254. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  255. package/src/services/invalidation/development-invalidation.service.js +190 -0
  256. package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
  257. package/src/services/module-loading/app-module-loader.service.js +0 -0
  258. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
  259. package/src/services/module-loading/app-server-module-transpiler.service.js +115 -0
  260. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  261. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  262. package/src/services/module-loading/{module-loading-types.ts → module-loading-types.d.ts} +0 -1
  263. package/src/services/module-loading/module-loading-types.js +0 -0
  264. package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
  265. package/src/services/module-loading/node-bootstrap-plugin.js +216 -0
  266. package/src/services/module-loading/page-module-import.service.d.ts +76 -0
  267. package/src/services/module-loading/page-module-import.service.js +170 -0
  268. package/src/services/module-loading/server-module-transpiler.service.d.ts +63 -0
  269. package/src/services/module-loading/server-module-transpiler.service.js +64 -0
  270. package/src/services/module-loading/source-module-support.d.ts +5 -0
  271. package/src/services/module-loading/source-module-support.js +8 -0
  272. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  273. package/src/services/runtime-state/dev-graph.service.js +162 -0
  274. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  275. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  276. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  277. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  278. package/src/services/validation/schema-validation-service.d.ts +122 -0
  279. package/src/services/validation/schema-validation-service.js +101 -0
  280. package/src/services/validation/{standard-schema.types.ts → standard-schema.types.d.ts} +17 -20
  281. package/src/services/validation/standard-schema.types.js +0 -0
  282. package/src/static-site-generator/static-site-generator.d.ts +104 -0
  283. package/src/static-site-generator/static-site-generator.js +316 -0
  284. package/src/types/internal-types.d.ts +232 -0
  285. package/src/types/internal-types.js +0 -0
  286. package/src/types/public-types.d.ts +1267 -0
  287. package/src/types/public-types.js +0 -0
  288. package/src/utils/deep-merge.d.ts +14 -0
  289. package/src/utils/deep-merge.js +32 -0
  290. package/src/utils/hash.d.ts +1 -0
  291. package/src/utils/hash.js +7 -0
  292. package/src/utils/html-escaping.d.ts +7 -0
  293. package/src/utils/html-escaping.js +6 -0
  294. package/src/utils/html.js +4 -0
  295. package/src/utils/invariant.d.ts +5 -0
  296. package/src/utils/invariant.js +11 -0
  297. package/src/utils/locals-utils.d.ts +15 -0
  298. package/src/utils/locals-utils.js +24 -0
  299. package/src/utils/parse-cli-args.d.ts +27 -0
  300. package/src/utils/parse-cli-args.js +62 -0
  301. package/src/utils/path-utils.module.d.ts +5 -0
  302. package/src/utils/path-utils.module.js +14 -0
  303. package/src/utils/resolve-work-dir.d.ts +11 -0
  304. package/src/utils/resolve-work-dir.js +31 -0
  305. package/src/utils/runtime.d.ts +11 -0
  306. package/src/utils/runtime.js +40 -0
  307. package/src/utils/server-utils.module.d.ts +19 -0
  308. package/src/utils/server-utils.module.js +56 -0
  309. package/src/watchers/project-watcher.d.ts +136 -0
  310. package/src/watchers/project-watcher.js +275 -0
  311. package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
  312. package/src/watchers/project-watcher.test-helpers.js +52 -0
  313. package/src/adapters/abstract/application-adapter.test.ts +0 -172
  314. package/src/adapters/abstract/application-adapter.ts +0 -379
  315. package/src/adapters/abstract/router-adapter.ts +0 -30
  316. package/src/adapters/abstract/server-adapter.ts +0 -79
  317. package/src/adapters/bun/client-bridge.ts +0 -62
  318. package/src/adapters/bun/create-app.ts +0 -232
  319. package/src/adapters/bun/hmr-manager.test.ts +0 -265
  320. package/src/adapters/bun/hmr-manager.ts +0 -383
  321. package/src/adapters/bun/index.ts +0 -2
  322. package/src/adapters/bun/server-adapter.ts +0 -526
  323. package/src/adapters/bun/server-lifecycle.ts +0 -124
  324. package/src/adapters/create-app.test.ts +0 -10
  325. package/src/adapters/create-app.ts +0 -91
  326. package/src/adapters/index.ts +0 -2
  327. package/src/adapters/node/create-app.test.ts +0 -53
  328. package/src/adapters/node/create-app.ts +0 -183
  329. package/src/adapters/node/node-client-bridge.test.ts +0 -198
  330. package/src/adapters/node/node-client-bridge.ts +0 -79
  331. package/src/adapters/node/node-hmr-manager.test.ts +0 -320
  332. package/src/adapters/node/node-hmr-manager.ts +0 -355
  333. package/src/adapters/node/server-adapter.ts +0 -502
  334. package/src/adapters/node/static-content-server.test.ts +0 -60
  335. package/src/adapters/node/static-content-server.ts +0 -239
  336. package/src/adapters/shared/api-response.test.ts +0 -97
  337. package/src/adapters/shared/api-response.ts +0 -104
  338. package/src/adapters/shared/application-adapter.ts +0 -199
  339. package/src/adapters/shared/define-api-handler.ts +0 -66
  340. package/src/adapters/shared/explicit-static-render-preparation.ts +0 -58
  341. package/src/adapters/shared/explicit-static-route-matcher.test.ts +0 -381
  342. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -131
  343. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +0 -85
  344. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -118
  345. package/src/adapters/shared/fs-server-response-factory.test.ts +0 -176
  346. package/src/adapters/shared/fs-server-response-factory.ts +0 -96
  347. package/src/adapters/shared/fs-server-response-matcher.test.ts +0 -311
  348. package/src/adapters/shared/fs-server-response-matcher.ts +0 -240
  349. package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
  350. package/src/adapters/shared/hmr-html-response.ts +0 -52
  351. package/src/adapters/shared/hmr-manager.contract.test.ts +0 -228
  352. package/src/adapters/shared/hmr-manager.dispatch.test.ts +0 -220
  353. package/src/adapters/shared/render-context.test.ts +0 -150
  354. package/src/adapters/shared/render-context.ts +0 -123
  355. package/src/adapters/shared/runtime-bootstrap.ts +0 -79
  356. package/src/adapters/shared/server-adapter.test.ts +0 -130
  357. package/src/adapters/shared/server-adapter.ts +0 -562
  358. package/src/adapters/shared/server-route-handler.test.ts +0 -111
  359. package/src/adapters/shared/server-route-handler.ts +0 -153
  360. package/src/adapters/shared/server-static-builder.test.ts +0 -338
  361. package/src/adapters/shared/server-static-builder.ts +0 -170
  362. package/src/build/build-adapter-serialization.test.ts +0 -281
  363. package/src/build/build-adapter.test.ts +0 -1240
  364. package/src/build/build-adapter.ts +0 -1012
  365. package/src/build/build-manifest.ts +0 -54
  366. package/src/build/build-types.ts +0 -83
  367. package/src/build/dev-build-coordinator.ts +0 -220
  368. package/src/build/esbuild-build-adapter.ts +0 -660
  369. package/src/build/runtime-build-executor.test.ts +0 -81
  370. package/src/build/runtime-build-executor.ts +0 -40
  371. package/src/build/runtime-specifier-alias-plugin.test.ts +0 -67
  372. package/src/build/runtime-specifier-alias-plugin.ts +0 -62
  373. package/src/build/runtime-specifier-aliases.ts +0 -135
  374. package/src/config/config-builder.test.ts +0 -442
  375. package/src/config/config-builder.ts +0 -737
  376. package/src/config/config-builder.typecheck.test.ts +0 -96
  377. package/src/dev/host-runtime.ts +0 -34
  378. package/src/dev/sc-server.ts +0 -143
  379. package/src/eco/eco.browser.test.ts +0 -43
  380. package/src/eco/eco.browser.ts +0 -118
  381. package/src/eco/eco.test.ts +0 -654
  382. package/src/eco/eco.ts +0 -205
  383. package/src/eco/eco.types.ts +0 -221
  384. package/src/eco/eco.utils.test.ts +0 -219
  385. package/src/eco/eco.utils.ts +0 -5
  386. package/src/eco/global-injector-map.test.ts +0 -42
  387. package/src/eco/global-injector-map.ts +0 -112
  388. package/src/eco/lazy-injector-map.test.ts +0 -66
  389. package/src/eco/lazy-injector-map.ts +0 -120
  390. package/src/eco/module-dependencies.test.ts +0 -30
  391. package/src/eco/module-dependencies.ts +0 -75
  392. package/src/errors/http-error.test.ts +0 -134
  393. package/src/errors/http-error.ts +0 -72
  394. package/src/errors/index.ts +0 -3
  395. package/src/errors/locals-access-error.ts +0 -7
  396. package/src/global/app-logger.ts +0 -4
  397. package/src/global/utils.test.ts +0 -12
  398. 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
  399. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  400. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  401. package/src/hmr/client/hmr-runtime.ts +0 -162
  402. package/src/hmr/hmr-strategy.test.ts +0 -124
  403. package/src/hmr/hmr-strategy.ts +0 -177
  404. package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
  405. package/src/hmr/hmr.test.e2e.ts +0 -66
  406. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  407. package/src/hmr/strategies/js-hmr-strategy.test.ts +0 -334
  408. package/src/hmr/strategies/js-hmr-strategy.ts +0 -314
  409. package/src/index.browser.ts +0 -3
  410. package/src/index.ts +0 -15
  411. package/src/integrations/ghtml/ghtml-renderer.test.ts +0 -253
  412. package/src/integrations/ghtml/ghtml-renderer.ts +0 -87
  413. package/src/integrations/ghtml/ghtml.constants.ts +0 -1
  414. package/src/integrations/ghtml/ghtml.plugin.ts +0 -28
  415. package/src/plugins/alias-resolver-plugin.test.ts +0 -41
  416. package/src/plugins/alias-resolver-plugin.ts +0 -63
  417. package/src/plugins/eco-component-meta-plugin.test.ts +0 -406
  418. package/src/plugins/eco-component-meta-plugin.ts +0 -494
  419. package/src/plugins/foreign-jsx-override-plugin.test.ts +0 -65
  420. package/src/plugins/foreign-jsx-override-plugin.ts +0 -67
  421. package/src/plugins/integration-plugin.test.ts +0 -151
  422. package/src/plugins/integration-plugin.ts +0 -323
  423. package/src/plugins/processor.test.ts +0 -148
  424. package/src/plugins/processor.ts +0 -257
  425. package/src/plugins/source-transform.test.ts +0 -82
  426. package/src/plugins/source-transform.ts +0 -123
  427. package/src/route-renderer/orchestration/component-render-context.ts +0 -325
  428. package/src/route-renderer/orchestration/declared-ownership-graph.ts +0 -62
  429. package/src/route-renderer/orchestration/foreign-subtree-execution.service.ts +0 -383
  430. package/src/route-renderer/orchestration/integration-renderer.test.ts +0 -2085
  431. package/src/route-renderer/orchestration/integration-renderer.ts +0 -1244
  432. package/src/route-renderer/orchestration/ownership-planning.service.ts +0 -97
  433. package/src/route-renderer/orchestration/ownership-validation.service.ts +0 -76
  434. package/src/route-renderer/orchestration/processed-asset-dedupe.ts +0 -25
  435. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.test.ts +0 -324
  436. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.ts +0 -294
  437. package/src/route-renderer/orchestration/render-output.utils.ts +0 -310
  438. package/src/route-renderer/orchestration/route-render-orchestrator.prepare-render-options.test.ts +0 -644
  439. package/src/route-renderer/orchestration/route-render-orchestrator.test.ts +0 -265
  440. package/src/route-renderer/orchestration/route-render-orchestrator.ts +0 -592
  441. package/src/route-renderer/orchestration/template-serialization.test.ts +0 -110
  442. package/src/route-renderer/orchestration/template-serialization.ts +0 -117
  443. package/src/route-renderer/page-loading/component-dependency-collection.ts +0 -202
  444. package/src/route-renderer/page-loading/declared-asset-collection.ts +0 -153
  445. package/src/route-renderer/page-loading/dependency-resolver.test.ts +0 -761
  446. package/src/route-renderer/page-loading/dependency-resolver.ts +0 -144
  447. package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +0 -75
  448. package/src/route-renderer/page-loading/lazy-entry-collection.ts +0 -167
  449. package/src/route-renderer/page-loading/lazy-trigger-planning.ts +0 -74
  450. package/src/route-renderer/page-loading/module-declaration-aggregation.ts +0 -60
  451. package/src/route-renderer/page-loading/module-declaration-scripts.ts +0 -16
  452. package/src/route-renderer/page-loading/page-dependency-bundling.ts +0 -244
  453. package/src/route-renderer/page-loading/page-module-loader.test.ts +0 -183
  454. package/src/route-renderer/page-loading/page-module-loader.ts +0 -184
  455. package/src/route-renderer/route-renderer.ts +0 -133
  456. package/src/router/client/link-intent.test.browser.ts +0 -51
  457. package/src/router/client/link-intent.ts +0 -92
  458. package/src/router/client/navigation-coordinator.test.ts +0 -237
  459. package/src/router/client/navigation-coordinator.ts +0 -453
  460. package/src/router/server/route-registry.test.ts +0 -176
  461. package/src/router/server/route-registry.ts +0 -382
  462. package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +0 -66
  463. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +0 -473
  464. package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -344
  465. package/src/services/assets/asset-processing-service/asset.factory.test.ts +0 -63
  466. package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
  467. package/src/services/assets/asset-processing-service/assets.types.ts +0 -128
  468. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +0 -74
  469. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -96
  470. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +0 -67
  471. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
  472. package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +0 -104
  473. package/src/services/assets/asset-processing-service/index.ts +0 -6
  474. package/src/services/assets/asset-processing-service/page-package.test.ts +0 -100
  475. package/src/services/assets/asset-processing-service/page-package.ts +0 -93
  476. package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
  477. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +0 -59
  478. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -83
  479. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -173
  480. package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
  481. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +0 -195
  482. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -137
  483. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +0 -326
  484. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -116
  485. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +0 -227
  486. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -89
  487. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +0 -261
  488. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -72
  489. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -83
  490. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +0 -65
  491. package/src/services/assets/browser-bundle.service.test.ts +0 -66
  492. package/src/services/assets/browser-bundle.service.ts +0 -109
  493. package/src/services/cache/cache.types.ts +0 -126
  494. package/src/services/cache/index.ts +0 -18
  495. package/src/services/cache/memory-cache-store.test.ts +0 -225
  496. package/src/services/cache/memory-cache-store.ts +0 -130
  497. package/src/services/cache/page-cache-service.test.ts +0 -175
  498. package/src/services/cache/page-cache-service.ts +0 -202
  499. package/src/services/cache/page-request-cache-coordinator.service.test.ts +0 -79
  500. package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
  501. package/src/services/html/html-rewriter-provider.service.test.ts +0 -183
  502. package/src/services/html/html-rewriter-provider.service.ts +0 -104
  503. package/src/services/html/html-transformer.service.test.ts +0 -476
  504. package/src/services/html/html-transformer.service.ts +0 -275
  505. package/src/services/invalidation/development-invalidation.service.test.ts +0 -87
  506. package/src/services/invalidation/development-invalidation.service.ts +0 -262
  507. package/src/services/module-loading/app-module-loader.service.ts +0 -9
  508. package/src/services/module-loading/app-server-module-transpiler.service.test.ts +0 -130
  509. package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -141
  510. package/src/services/module-loading/host-module-loader-registry.ts +0 -15
  511. package/src/services/module-loading/node-bootstrap-plugin.test.ts +0 -335
  512. package/src/services/module-loading/node-bootstrap-plugin.ts +0 -311
  513. package/src/services/module-loading/page-module-import.service.test.ts +0 -504
  514. package/src/services/module-loading/page-module-import.service.ts +0 -251
  515. package/src/services/module-loading/server-module-transpiler.service.test.ts +0 -243
  516. package/src/services/module-loading/server-module-transpiler.service.ts +0 -104
  517. package/src/services/module-loading/source-module-support.ts +0 -19
  518. package/src/services/runtime-state/dev-graph.service.ts +0 -217
  519. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
  520. package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
  521. package/src/services/validation/schema-validation-service.test.ts +0 -223
  522. package/src/services/validation/schema-validation-service.ts +0 -204
  523. package/src/static-site-generator/static-site-generator.test.ts +0 -408
  524. package/src/static-site-generator/static-site-generator.ts +0 -445
  525. package/src/types/internal-types.ts +0 -243
  526. package/src/types/public-types.ts +0 -1459
  527. package/src/utils/deep-merge.test.ts +0 -114
  528. package/src/utils/deep-merge.ts +0 -47
  529. package/src/utils/hash.ts +0 -5
  530. package/src/utils/html-escaping.ts +0 -9
  531. package/src/utils/invariant.test.ts +0 -22
  532. package/src/utils/invariant.ts +0 -15
  533. package/src/utils/locals-utils.ts +0 -37
  534. package/src/utils/parse-cli-args.test.ts +0 -69
  535. package/src/utils/parse-cli-args.ts +0 -105
  536. package/src/utils/path-utils.module.ts +0 -14
  537. package/src/utils/path-utils.test.ts +0 -15
  538. package/src/utils/resolve-work-dir.ts +0 -45
  539. package/src/utils/runtime.ts +0 -44
  540. package/src/utils/server-utils.module.ts +0 -67
  541. package/src/utils/server-utils.test.ts +0 -38
  542. package/src/watchers/project-watcher.integration.test.ts +0 -337
  543. package/src/watchers/project-watcher.test-helpers.ts +0 -42
  544. package/src/watchers/project-watcher.test.ts +0 -768
  545. package/src/watchers/project-watcher.ts +0 -357
  546. /package/src/utils/{html.ts → html.d.ts} +0 -0
@@ -1,592 +0,0 @@
1
- import { createRequire } from 'node:module';
2
- import path from 'node:path';
3
- import type { EcoPagesAppConfig } from '../../types/internal-types.ts';
4
- import type {
5
- ComponentRenderResult,
6
- DependencyAttributes,
7
- EcoComponent,
8
- EcoComponentConfig,
9
- EcoPageComponent,
10
- EcoPageFile,
11
- HtmlTemplateProps,
12
- IntegrationRendererRenderOptions,
13
- PageBrowserGraphResult,
14
- PageMetadataProps,
15
- PageProps,
16
- ResolvedLazyTrigger,
17
- RouteRendererBody,
18
- RouteRendererOptions,
19
- RouteRenderResult,
20
- } from '../../types/public-types.ts';
21
- import {
22
- type AssetProcessingService,
23
- AssetFactory,
24
- createPagePackage,
25
- type ProcessedAsset,
26
- } from '../../services/assets/asset-processing-service/index.ts';
27
- import { buildGlobalInjectorBootstrapContent, buildGlobalInjectorMapScript } from '../../eco/global-injector-map.ts';
28
- import { LocalsAccessError } from '../../errors/locals-access-error.ts';
29
- import { inspectUnresolvedMarkerArtifactHtml } from './render-output.utils.ts';
30
- import { OwnershipValidationService } from './ownership-validation.service.ts';
31
- import { OwnershipPlanningService } from './ownership-planning.service.ts';
32
- import { dedupeProcessedAssets } from './processed-asset-dedupe.ts';
33
-
34
- export type RouteRenderOrchestratorResolvedInputs = {
35
- Page: EcoPageFile['default'] | EcoPageComponent<any>;
36
- HtmlTemplate: EcoComponent<HtmlTemplateProps>;
37
- Layout?: EcoComponent;
38
- props: Record<string, unknown>;
39
- metadata: PageMetadataProps;
40
- integrationSpecificProps: Record<string, unknown>;
41
- };
42
-
43
- export type RouteRenderOrchestratorResolvedAssets = {
44
- resolvedDependencies: ProcessedAsset[];
45
- pageBrowserGraph?: PageBrowserGraphResult;
46
- };
47
-
48
- /**
49
- * Structural HTML work applied after the route body has been fully resolved.
50
- *
51
- * The shared route flow only needs to know whether a post-render HTML step
52
- * exists. When `finalizeHtml` is absent, the captured body can be reused as-is.
53
- */
54
- export type RouteHtmlFinalization = {
55
- finalizeHtml?(html: string): string;
56
- };
57
-
58
- function createPageLocalsProxy(filePath: string): Record<string, never> {
59
- 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.`;
60
-
61
- return new Proxy(
62
- {},
63
- {
64
- get: () => {
65
- throw new LocalsAccessError(errorMessage);
66
- },
67
- set: () => {
68
- throw new LocalsAccessError(errorMessage);
69
- },
70
- has: () => {
71
- throw new LocalsAccessError(errorMessage);
72
- },
73
- ownKeys: () => {
74
- throw new LocalsAccessError(errorMessage);
75
- },
76
- deleteProperty: () => {
77
- throw new LocalsAccessError(errorMessage);
78
- },
79
- defineProperty: () => {
80
- throw new LocalsAccessError(errorMessage);
81
- },
82
- getOwnPropertyDescriptor: () => {
83
- throw new LocalsAccessError(errorMessage);
84
- },
85
- },
86
- );
87
- }
88
-
89
- export interface RouteRenderOrchestratorAdapter<C> {
90
- /**
91
- * Name of the owning Integration for the current route render.
92
- */
93
- readonly name: string;
94
- /**
95
- * Loads the Integration-owned route inputs needed for one Page render.
96
- */
97
- resolveRouteRenderInputs(routeOptions: RouteRendererOptions): Promise<RouteRenderOrchestratorResolvedInputs>;
98
- /**
99
- * Resolves route-owned assets needed before Integration rendering starts.
100
- */
101
- resolveRouteAssets(input: {
102
- routeOptions: RouteRendererOptions;
103
- components: (EcoComponent | Partial<EcoComponent>)[];
104
- }): Promise<RouteRenderOrchestratorResolvedAssets>;
105
- /**
106
- * Resolves the optional page-root render through the foreign-child-aware component contract.
107
- */
108
- resolveRoutePageComponentRender(input: {
109
- Page: EcoComponent;
110
- Layout?: EcoComponent;
111
- props: Record<string, unknown>;
112
- routeOptions: RouteRendererOptions;
113
- }): Promise<ComponentRenderResult | undefined>;
114
- /**
115
- * Executes the Integration-specific route render.
116
- */
117
- renderRouteBody(renderOptions: IntegrationRendererRenderOptions<C>): Promise<RouteRendererBody>;
118
- /**
119
- * Returns the structural Html finalization plan for one prepared route render.
120
- */
121
- getRouteHtmlFinalization(renderOptions: IntegrationRendererRenderOptions<C>): RouteHtmlFinalization;
122
- /**
123
- * Runs SSR-policy response transformation and returns the body value exposed to callers.
124
- */
125
- transformRouteResponse(response: Response): Promise<RouteRendererBody>;
126
- }
127
-
128
- /**
129
- * Captured route-render output in both replayable body and string HTML forms.
130
- */
131
- export interface CapturedHtmlRenderResult {
132
- body: RouteRendererBody;
133
- html: string;
134
- }
135
-
136
- /**
137
- * Optional app-scoped collaborators used by the route render orchestrator.
138
- */
139
- export interface RouteRenderOrchestratorDependencies {
140
- ownershipPlanningService?: OwnershipPlanningService;
141
- ownershipValidationService?: OwnershipValidationService;
142
- }
143
-
144
- /**
145
- * Owns one route render from normalized module loading through final HTML output.
146
- *
147
- * This orchestrator keeps route rendering as one app-scoped unit while still
148
- * delegating integration-specific behavior through the adapter seam. It owns
149
- * route-root validation, dependency aggregation, page package creation, and the
150
- * final HTML/body handling that happens after the integration render returns.
151
- */
152
- export class RouteRenderOrchestrator {
153
- private readonly appConfig: EcoPagesAppConfig;
154
- private readonly assetProcessingService: AssetProcessingService;
155
- private readonly ownershipPlanningService: OwnershipPlanningService;
156
- private readonly ownershipValidationService: OwnershipValidationService;
157
-
158
- constructor(
159
- appConfig: EcoPagesAppConfig,
160
- assetProcessingService: AssetProcessingService,
161
- dependencies: RouteRenderOrchestratorDependencies = {},
162
- ) {
163
- this.appConfig = appConfig;
164
- this.assetProcessingService = assetProcessingService;
165
- this.ownershipPlanningService = dependencies.ownershipPlanningService ?? new OwnershipPlanningService();
166
- this.ownershipValidationService =
167
- dependencies.ownershipValidationService ?? new OwnershipValidationService(appConfig);
168
- }
169
-
170
- /**
171
- * Builds normalized route render options before the integration render runs.
172
- *
173
- * This preparation step validates route-root ownership, resolves page data,
174
- * collects processed assets, captures optional page-root render metadata, and
175
- * produces the page package consumed by downstream HTML transformation.
176
- */
177
- async prepareRenderOptions<C = unknown>(
178
- routeOptions: RouteRendererOptions,
179
- adapter: RouteRenderOrchestratorAdapter<C>,
180
- ): Promise<IntegrationRendererRenderOptions<C>> {
181
- const resolvedInputs = await adapter.resolveRouteRenderInputs(routeOptions);
182
- const { Page, HtmlTemplate, Layout, props, metadata, integrationSpecificProps } = resolvedInputs;
183
- const validationErrors = this.ownershipValidationService.validate({
184
- currentIntegrationName: adapter.name,
185
- roots: [
186
- { component: HtmlTemplate as EcoComponent, source: 'html-template' },
187
- ...(Layout ? [{ component: Layout as EcoComponent, source: 'layout' as const }] : []),
188
- { component: Page as EcoComponent, source: 'page' },
189
- ],
190
- });
191
- const ownershipPlan = this.ownershipPlanningService.buildPlan({
192
- routeFile: routeOptions.file,
193
- currentIntegrationName: adapter.name,
194
- HtmlTemplate: HtmlTemplate as EcoComponent,
195
- Layout,
196
- Page: Page as EcoComponent,
197
- validationErrors,
198
- });
199
-
200
- const componentsToResolve = Layout ? [HtmlTemplate, Layout, Page] : [HtmlTemplate, Page];
201
- const { resolvedDependencies, pageBrowserGraph } = await adapter.resolveRouteAssets({
202
- routeOptions,
203
- components: componentsToResolve,
204
- });
205
- const usedIntegrationDependencies = this.collectUsedIntegrationDependencies(componentsToResolve, adapter.name);
206
- const allDependencies = [
207
- ...resolvedDependencies,
208
- ...usedIntegrationDependencies,
209
- ...(pageBrowserGraph?.assets ?? []),
210
- ];
211
-
212
- const componentRender = await adapter.resolveRoutePageComponentRender({
213
- Page: Page as EcoComponent,
214
- Layout,
215
- props,
216
- routeOptions,
217
- });
218
-
219
- if (componentRender?.assets?.length) {
220
- allDependencies.push(...componentRender.assets);
221
- }
222
-
223
- const triggers = this.collectResolvedTriggers(componentsToResolve);
224
- if (triggers.length > 0) {
225
- const globalAssets = await this.buildGlobalInjectorAssets(triggers, adapter.name);
226
- allDependencies.push(...globalAssets);
227
- }
228
-
229
- const eagerSsrLazyAssets = await this.buildEagerSsrLazyAssets(componentsToResolve, adapter.name);
230
- if (eagerSsrLazyAssets.length > 0) {
231
- allDependencies.push(...eagerSsrLazyAssets);
232
- }
233
-
234
- const dedupedDependencies = dedupeProcessedAssets(allDependencies);
235
- const pagePackage = createPagePackage(dedupedDependencies);
236
- const pageProps = {
237
- ...props,
238
- params: routeOptions.params || {},
239
- query: routeOptions.query || {},
240
- };
241
- const cacheStrategy = (Page as EcoPageComponent<any>).cache;
242
- const defaultCacheStrategy = this.appConfig.cache?.defaultStrategy ?? 'static';
243
- const effectiveCacheStrategy = cacheStrategy ?? defaultCacheStrategy;
244
- const localsAvailable = effectiveCacheStrategy === 'dynamic' && routeOptions.locals !== undefined;
245
-
246
- const pageLocals = localsAvailable
247
- ? routeOptions.locals!
248
- : (createPageLocalsProxy(routeOptions.file) as RouteRendererOptions['locals']);
249
-
250
- const locals = localsAvailable ? routeOptions.locals : undefined;
251
- const preparedOptions: IntegrationRendererRenderOptions<C> = {
252
- ...routeOptions,
253
- resolvedDependencies,
254
- pagePackage,
255
- componentRender,
256
- HtmlTemplate: HtmlTemplate as EcoComponent<HtmlTemplateProps, C>,
257
- Layout,
258
- props,
259
- Page: Page as EcoComponent<PageProps, C>,
260
- metadata,
261
- params: routeOptions.params || {},
262
- query: routeOptions.query || {},
263
- pageProps,
264
- locals,
265
- pageLocals,
266
- cacheStrategy,
267
- ownershipPlan,
268
- };
269
-
270
- return {
271
- ...integrationSpecificProps,
272
- ...preparedOptions,
273
- };
274
- }
275
-
276
- /**
277
- * Captures one route render body as HTML while preserving a replayable body value.
278
- */
279
- async captureHtmlRender(render: () => Promise<RouteRendererBody>): Promise<CapturedHtmlRenderResult> {
280
- const renderedBody = await render();
281
- const capturedRender = await this.captureRenderedBody(renderedBody);
282
-
283
- return {
284
- body: capturedRender.body,
285
- html: capturedRender.html,
286
- };
287
- }
288
-
289
- /**
290
- * Executes the full route-render flow and returns the final body plus cache strategy.
291
- */
292
- async execute<C = unknown>(
293
- options: RouteRendererOptions,
294
- adapter: RouteRenderOrchestratorAdapter<C>,
295
- ): Promise<RouteRenderResult> {
296
- const renderOptions = await this.prepareRenderOptions(options, adapter);
297
- return this.executePrepared(renderOptions, adapter);
298
- }
299
-
300
- /**
301
- * Executes the route-render finalization path for already prepared render options.
302
- */
303
- async executePrepared<C = unknown>(
304
- renderOptions: IntegrationRendererRenderOptions<C>,
305
- adapter: RouteRenderOrchestratorAdapter<C>,
306
- ): Promise<RouteRenderResult> {
307
- const renderExecution = await this.captureHtmlRender(async () => adapter.renderRouteBody(renderOptions));
308
- const unresolvedArtifactInspection = inspectUnresolvedMarkerArtifactHtml(renderExecution.html);
309
- const htmlFinalization = adapter.getRouteHtmlFinalization(renderOptions);
310
- const hasUnresolvedMarkerHtml = unresolvedArtifactInspection.hasUnresolvedMarkerArtifacts;
311
-
312
- if (hasUnresolvedMarkerHtml) {
313
- throw new Error(
314
- '[ecopages] Route render returned unresolved eco-marker artifact HTML. Full-route unresolved-marker fallback has been removed; resolve mixed foreign children inside renderComponentWithForeignChildren().',
315
- );
316
- }
317
-
318
- const canReuseCapturedBody = !hasUnresolvedMarkerHtml && htmlFinalization.finalizeHtml === undefined;
319
-
320
- if (canReuseCapturedBody) {
321
- const body = await adapter.transformRouteResponse(
322
- new Response(renderExecution.body as BodyInit, {
323
- headers: {
324
- 'Content-Type': 'text/html',
325
- },
326
- }),
327
- );
328
-
329
- return {
330
- body,
331
- cacheStrategy: renderOptions.cacheStrategy,
332
- };
333
- }
334
-
335
- const finalization = htmlFinalization.finalizeHtml
336
- ? htmlFinalization.finalizeHtml(unresolvedArtifactInspection.normalizedHtml)
337
- : unresolvedArtifactInspection.normalizedHtml;
338
-
339
- const body = await adapter.transformRouteResponse(
340
- new Response(finalization, {
341
- headers: {
342
- 'Content-Type': 'text/html',
343
- },
344
- }),
345
- );
346
-
347
- return {
348
- body,
349
- cacheStrategy: renderOptions.cacheStrategy,
350
- };
351
- }
352
-
353
- private async captureRenderedBody(body: RouteRendererBody): Promise<{ body: RouteRendererBody; html: string }> {
354
- const response = new Response(body as BodyInit);
355
-
356
- if (typeof body === 'string') {
357
- return {
358
- body,
359
- html: await response.text(),
360
- };
361
- }
362
-
363
- if (!response.body) {
364
- return {
365
- body,
366
- html: await response.text(),
367
- };
368
- }
369
-
370
- const [capturedBody, replayBody] = response.body.tee();
371
-
372
- return {
373
- body: replayBody,
374
- html: await new Response(capturedBody).text(),
375
- };
376
- }
377
-
378
- private collectResolvedTriggers(
379
- components: (EcoComponent | Partial<EcoComponent>)[],
380
- seen = new Set<object>(),
381
- ): ResolvedLazyTrigger[] {
382
- const triggers: ResolvedLazyTrigger[] = [];
383
- for (const comp of components) {
384
- if (!comp) {
385
- continue;
386
- }
387
-
388
- const ecoComp = comp as EcoComponent;
389
- if (seen.has(ecoComp)) {
390
- continue;
391
- }
392
- seen.add(ecoComp);
393
- const ownTriggers = ecoComp.config?._resolvedLazyTriggers;
394
- if (ownTriggers?.length) {
395
- triggers.push(...ownTriggers);
396
- }
397
- const nested = ecoComp.config?.dependencies?.components;
398
- if (nested?.length) {
399
- triggers.push(...this.collectResolvedTriggers(nested, seen));
400
- }
401
- }
402
- return triggers;
403
- }
404
-
405
- private collectUsedIntegrationDependencies(
406
- components: (EcoComponent | Partial<EcoComponent>)[],
407
- currentIntegrationName: string,
408
- ): ProcessedAsset[] {
409
- const integrationNames = this.collectIntegrationNames(components);
410
- const dependencies: ProcessedAsset[] = [];
411
-
412
- for (const integrationName of integrationNames) {
413
- if (integrationName === currentIntegrationName) {
414
- continue;
415
- }
416
-
417
- const integrationPlugin = this.appConfig.integrations.find(
418
- (integration) => integration.name === integrationName,
419
- );
420
- if (!integrationPlugin || typeof integrationPlugin.getResolvedIntegrationDependencies !== 'function') {
421
- continue;
422
- }
423
-
424
- dependencies.push(...integrationPlugin.getResolvedIntegrationDependencies());
425
- }
426
-
427
- return dependencies;
428
- }
429
-
430
- private collectIntegrationNames(
431
- components: (EcoComponent | Partial<EcoComponent>)[],
432
- seen = new Set<object>(),
433
- ): Set<string> {
434
- const integrationNames = new Set<string>();
435
-
436
- for (const comp of components) {
437
- if (!comp) {
438
- continue;
439
- }
440
-
441
- const ecoComp = comp as EcoComponent;
442
- if (seen.has(ecoComp)) {
443
- continue;
444
- }
445
- seen.add(ecoComp);
446
-
447
- const integrationName = ecoComp.config?.integration ?? ecoComp.config?.__eco?.integration;
448
- if (integrationName) {
449
- integrationNames.add(integrationName);
450
- }
451
-
452
- const nested = ecoComp.config?.dependencies?.components;
453
- if (nested?.length) {
454
- const nestedNames = this.collectIntegrationNames(nested, seen);
455
- for (const nestedName of nestedNames) {
456
- integrationNames.add(nestedName);
457
- }
458
- }
459
- }
460
-
461
- return integrationNames;
462
- }
463
-
464
- private async buildGlobalInjectorAssets(
465
- triggers: ResolvedLazyTrigger[],
466
- currentIntegrationName: string,
467
- ): Promise<ProcessedAsset[]> {
468
- const globalInjectorImportPath = createRequire(import.meta.url).resolve('@ecopages/scripts-injector/global');
469
-
470
- const mapScript = AssetFactory.createInlineContentScript({
471
- position: 'head',
472
- name: 'ecopages-global-injector-map',
473
- content: buildGlobalInjectorMapScript(triggers),
474
- attributes: { type: 'ecopages/global-injector-map' },
475
- packageRole: 'keep-separate',
476
- bundle: false,
477
- });
478
- const bootstrapInlineScript = AssetFactory.createInlineContentScript({
479
- position: 'head',
480
- name: 'ecopages-global-injector-bootstrap',
481
- content: buildGlobalInjectorBootstrapContent(globalInjectorImportPath),
482
- attributes: { type: 'module' },
483
- packageRole: 'keep-separate',
484
- bundle: true,
485
- });
486
-
487
- return this.assetProcessingService.processDependencies(
488
- [mapScript, bootstrapInlineScript],
489
- currentIntegrationName,
490
- );
491
- }
492
-
493
- private async buildEagerSsrLazyAssets(
494
- components: (EcoComponent | Partial<EcoComponent>)[],
495
- currentIntegrationName: string,
496
- ): Promise<ProcessedAsset[]> {
497
- const dependencies = this.collectEagerSsrLazyDependencies(components);
498
- if (dependencies.length === 0) {
499
- return [];
500
- }
501
-
502
- return this.assetProcessingService.processDependencies(dependencies, `${currentIntegrationName}:ssr-lazy`);
503
- }
504
-
505
- private collectEagerSsrLazyDependencies(
506
- components: (EcoComponent | Partial<EcoComponent>)[],
507
- ): ReturnType<AssetProcessingService['processDependencies']> extends Promise<infer _>
508
- ? Parameters<AssetProcessingService['processDependencies']>[0]
509
- : never {
510
- const dependencies = [] as Parameters<AssetProcessingService['processDependencies']>[0];
511
- const visitedConfigs = new Set<EcoComponentConfig>();
512
- const seenKeys = new Set<string>();
513
-
514
- const normalizeAttributes = (attributes?: DependencyAttributes) => ({
515
- type: 'module',
516
- defer: '',
517
- ...(attributes ?? {}),
518
- });
519
-
520
- const collect = (config?: EcoComponentConfig) => {
521
- if (!config || visitedConfigs.has(config)) {
522
- return;
523
- }
524
-
525
- visitedConfigs.add(config);
526
-
527
- const componentFile = config.__eco?.file;
528
- if (componentFile) {
529
- const componentDir = path.dirname(componentFile);
530
- for (const script of config.dependencies?.scripts ?? []) {
531
- if (typeof script === 'string' || !script.lazy || script.ssr !== true) {
532
- continue;
533
- }
534
-
535
- const attributes = normalizeAttributes(script.attributes);
536
-
537
- if (script.content) {
538
- const key = `content:${script.content}:${JSON.stringify(attributes)}`;
539
- if (seenKeys.has(key)) {
540
- continue;
541
- }
542
-
543
- seenKeys.add(key);
544
- dependencies.push(
545
- AssetFactory.createContentScript({
546
- position: 'head',
547
- content: script.content,
548
- attributes,
549
- packageRole: 'dynamic-chunk',
550
- }),
551
- );
552
- continue;
553
- }
554
-
555
- if (!script.src) {
556
- continue;
557
- }
558
-
559
- const resolvedPath = path.resolve(componentDir, script.src);
560
- const key = `file:${resolvedPath}:${JSON.stringify(attributes)}`;
561
- if (seenKeys.has(key)) {
562
- continue;
563
- }
564
-
565
- seenKeys.add(key);
566
- dependencies.push(
567
- AssetFactory.createFileScript({
568
- filepath: resolvedPath,
569
- position: 'head',
570
- attributes,
571
- packageRole: 'dynamic-chunk',
572
- }),
573
- );
574
- }
575
- }
576
-
577
- if (config.layout?.config) {
578
- collect(config.layout.config);
579
- }
580
-
581
- for (const nestedComponent of config.dependencies?.components ?? []) {
582
- collect(nestedComponent?.config);
583
- }
584
- };
585
-
586
- for (const component of components) {
587
- collect(component.config);
588
- }
589
-
590
- return dependencies;
591
- }
592
- }
@@ -1,110 +0,0 @@
1
- import { describe, expect, test } from 'vitest';
2
- import {
3
- type DeferredTemplateSerializer,
4
- serializeTemplateShape,
5
- type SerializableTemplateShape,
6
- } from './template-serialization.ts';
7
-
8
- type TestTemplateShape = SerializableTemplateShape & {
9
- __testTemplateType: 'deferred-template';
10
- };
11
-
12
- function createTestTemplate(strings: readonly string[], values: readonly unknown[]): TestTemplateShape {
13
- return {
14
- __testTemplateType: 'deferred-template',
15
- strings,
16
- values,
17
- };
18
- }
19
-
20
- const testDeferredTemplateSerializer: DeferredTemplateSerializer<TestTemplateShape> = {
21
- matches(value: unknown): value is TestTemplateShape {
22
- return (
23
- typeof value === 'object' &&
24
- value !== null &&
25
- (value as { __testTemplateType?: unknown }).__testTemplateType === 'deferred-template' &&
26
- Array.isArray((value as { strings?: unknown }).strings) &&
27
- ((value as { values?: unknown }).values === undefined ||
28
- Array.isArray((value as { values?: unknown }).values))
29
- );
30
- },
31
- serialize(template: TestTemplateShape, serializeValue: (value: unknown) => string | undefined) {
32
- return serializeTemplateShape(template, serializeValue);
33
- },
34
- };
35
-
36
- function serializeTestDeferredTemplateValue(
37
- value: unknown,
38
- serializeValue: (value: unknown) => string | undefined,
39
- ): string | undefined {
40
- if (!testDeferredTemplateSerializer.matches(value)) {
41
- return undefined;
42
- }
43
-
44
- return testDeferredTemplateSerializer.serialize(value, serializeValue);
45
- }
46
-
47
- describe('serializeTemplateLike', () => {
48
- test('preserves quoted attribute values for multi-token class attributes', () => {
49
- const html = serializeTemplateShape(
50
- createTestTemplate(['<div class=', '>', '</div>'], ['grid gap-4 lg:grid-cols-2 xl:grid-cols-4', 'Content']),
51
- (value) => (value == null ? '' : String(value)),
52
- );
53
-
54
- expect(html).toBe('<div class="grid gap-4 lg:grid-cols-2 xl:grid-cols-4">Content</div>');
55
- });
56
-
57
- test('omits falsey boolean attributes and preserves truthy boolean attributes', () => {
58
- const truthyHtml = serializeTemplateShape(
59
- createTestTemplate(['<button ?disabled=', '>x</button>'], ['yes']),
60
- (value) => (value == null ? '' : String(value)),
61
- );
62
- const falseyHtml = serializeTemplateShape(
63
- createTestTemplate(['<button ?disabled=', '>x</button>'], ['']),
64
- (value) => (value == null ? '' : String(value)),
65
- );
66
-
67
- expect(truthyHtml).toBe('<button disabled>x</button>');
68
- expect(falseyHtml).toBe('<button>x</button>');
69
- });
70
-
71
- test('skips event and prop bindings in SSR output', () => {
72
- const html = serializeTemplateShape(
73
- createTestTemplate(['<button @click=', ' .value=', '>x</button>'], ['handler', '1']),
74
- (value) => (value == null ? '' : String(value)),
75
- );
76
-
77
- expect(html).toBe('<button>x</button>');
78
- });
79
-
80
- test('escapes attribute values while preserving child interpolation', () => {
81
- const html = serializeTemplateShape(
82
- createTestTemplate(['<div title=', '>', '</div>'], ['a "quote" & <tag>', '<span>child</span>']),
83
- (value) => (value == null ? '' : String(value)),
84
- );
85
-
86
- expect(html).toBe('<div title="a &quot;quote&quot; &amp; &lt;tag&gt;"><span>child</span></div>');
87
- });
88
-
89
- test('does not serialize unmatched template-like values', () => {
90
- expect(
91
- serializeTestDeferredTemplateValue(
92
- {
93
- strings: ['<div>', '</div>'],
94
- values: ['content'],
95
- _$litType$: 1,
96
- },
97
- (value) => (value == null ? '' : String(value)),
98
- ),
99
- ).toBeUndefined();
100
- });
101
-
102
- test('serializes locally provided template serializers without ambient registration', () => {
103
- expect(
104
- serializeTestDeferredTemplateValue(
105
- createTestTemplate(['<div class=', '>', '</div>'], ['shared gap-4', 'content']),
106
- (value) => (value == null ? '' : String(value)),
107
- ),
108
- ).toBe('<div class="shared gap-4">content</div>');
109
- });
110
- });