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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (543) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/package.json +226 -93
  3. package/src/adapters/abstract/application-adapter.d.ts +194 -0
  4. package/src/adapters/abstract/application-adapter.js +121 -0
  5. package/src/adapters/abstract/router-adapter.d.ts +26 -0
  6. package/src/adapters/abstract/router-adapter.js +5 -0
  7. package/src/adapters/abstract/server-adapter.d.ts +69 -0
  8. package/src/adapters/abstract/server-adapter.js +15 -0
  9. package/src/adapters/bun/client-bridge.d.ts +34 -0
  10. package/src/adapters/bun/client-bridge.js +48 -0
  11. package/src/adapters/bun/create-app.d.ts +52 -0
  12. package/src/adapters/bun/create-app.js +116 -0
  13. package/src/adapters/bun/hmr-manager.d.ts +143 -0
  14. package/src/adapters/bun/hmr-manager.js +333 -0
  15. package/src/adapters/bun/index.d.ts +2 -0
  16. package/src/adapters/bun/index.js +8 -0
  17. package/src/adapters/bun/server-adapter.d.ts +155 -0
  18. package/src/adapters/bun/server-adapter.js +374 -0
  19. package/src/adapters/bun/server-lifecycle.d.ts +63 -0
  20. package/src/adapters/bun/server-lifecycle.js +92 -0
  21. package/src/adapters/create-app.d.ts +20 -0
  22. package/src/adapters/create-app.js +66 -0
  23. package/src/adapters/index.d.ts +2 -0
  24. package/src/adapters/index.js +8 -0
  25. package/src/adapters/node/create-app.d.ts +18 -0
  26. package/src/adapters/node/create-app.js +149 -0
  27. package/src/adapters/node/node-client-bridge.d.ts +26 -0
  28. package/src/adapters/node/node-client-bridge.js +66 -0
  29. package/src/adapters/node/node-hmr-manager.d.ts +133 -0
  30. package/src/adapters/node/node-hmr-manager.js +311 -0
  31. package/src/adapters/node/server-adapter.d.ts +162 -0
  32. package/src/adapters/node/server-adapter.js +368 -0
  33. package/src/adapters/node/static-content-server.d.ts +60 -0
  34. package/src/adapters/node/static-content-server.js +194 -0
  35. package/src/adapters/shared/api-response.d.ts +52 -0
  36. package/src/adapters/shared/api-response.js +96 -0
  37. package/src/adapters/shared/application-adapter.d.ts +18 -0
  38. package/src/adapters/shared/application-adapter.js +90 -0
  39. package/src/adapters/shared/define-api-handler.d.ts +25 -0
  40. package/src/adapters/shared/define-api-handler.js +15 -0
  41. package/src/adapters/shared/explicit-static-route-matcher.d.ts +38 -0
  42. package/src/adapters/shared/explicit-static-route-matcher.js +103 -0
  43. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +65 -0
  44. package/src/adapters/shared/file-route-middleware-pipeline.js +99 -0
  45. package/src/adapters/shared/fs-server-response-factory.d.ts +19 -0
  46. package/src/adapters/shared/fs-server-response-factory.js +97 -0
  47. package/src/adapters/shared/fs-server-response-matcher.d.ts +67 -0
  48. package/src/adapters/shared/fs-server-response-matcher.js +147 -0
  49. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  50. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  51. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  52. package/src/adapters/shared/hmr-html-response.js +32 -0
  53. package/src/adapters/shared/render-context.d.ts +15 -0
  54. package/src/adapters/shared/render-context.js +72 -0
  55. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  56. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  57. package/src/adapters/shared/server-adapter.d.ts +97 -0
  58. package/src/adapters/shared/server-adapter.js +390 -0
  59. package/src/adapters/shared/server-route-handler.d.ts +89 -0
  60. package/src/adapters/shared/server-route-handler.js +111 -0
  61. package/src/adapters/shared/server-static-builder.d.ts +71 -0
  62. package/src/adapters/shared/server-static-builder.js +100 -0
  63. package/src/build/build-adapter.d.ts +239 -0
  64. package/src/build/build-adapter.js +642 -0
  65. package/src/build/build-manifest.d.ts +27 -0
  66. package/src/build/build-manifest.js +30 -0
  67. package/src/build/build-types.d.ts +57 -0
  68. package/src/build/build-types.js +0 -0
  69. package/src/build/dev-build-coordinator.d.ts +72 -0
  70. package/src/build/dev-build-coordinator.js +154 -0
  71. package/src/build/esbuild-build-adapter.d.ts +78 -0
  72. package/src/build/esbuild-build-adapter.js +505 -0
  73. package/src/build/runtime-build-executor.d.ts +14 -0
  74. package/src/build/runtime-build-executor.js +22 -0
  75. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  76. package/src/build/runtime-specifier-alias-plugin.js +35 -0
  77. package/src/build/runtime-specifier-aliases.d.ts +5 -0
  78. package/src/build/runtime-specifier-aliases.js +95 -0
  79. package/src/config/config-builder.d.ts +252 -0
  80. package/src/config/config-builder.js +603 -0
  81. package/src/config/{constants.ts → constants.d.ts} +13 -22
  82. package/src/config/constants.js +25 -0
  83. package/src/dev/sc-server.d.ts +30 -0
  84. package/src/dev/sc-server.js +111 -0
  85. package/src/eco/eco.browser.d.ts +2 -0
  86. package/src/eco/eco.browser.js +83 -0
  87. package/src/eco/eco.d.ts +9 -0
  88. package/src/eco/eco.js +85 -0
  89. package/src/eco/eco.types.d.ts +178 -0
  90. package/src/eco/eco.types.js +0 -0
  91. package/src/eco/eco.utils.d.ts +1 -0
  92. package/src/eco/eco.utils.js +10 -0
  93. package/src/eco/global-injector-map.d.ts +16 -0
  94. package/src/eco/global-injector-map.js +80 -0
  95. package/src/eco/lazy-injector-map.d.ts +8 -0
  96. package/src/eco/lazy-injector-map.js +70 -0
  97. package/src/eco/module-dependencies.d.ts +18 -0
  98. package/src/eco/module-dependencies.js +49 -0
  99. package/src/errors/http-error.d.ts +31 -0
  100. package/src/errors/http-error.js +50 -0
  101. package/src/errors/{index.ts → index.d.ts} +2 -2
  102. package/src/errors/index.js +4 -0
  103. package/src/errors/locals-access-error.d.ts +4 -0
  104. package/src/errors/locals-access-error.js +9 -0
  105. package/src/global/app-logger.d.ts +2 -0
  106. package/src/global/app-logger.js +6 -0
  107. package/src/hmr/client/hmr-runtime.d.ts +5 -0
  108. package/src/hmr/client/hmr-runtime.js +117 -0
  109. package/src/hmr/hmr-strategy.d.ts +162 -0
  110. package/src/hmr/hmr-strategy.js +44 -0
  111. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  112. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  113. package/src/hmr/hmr.test.e2e.d.ts +1 -0
  114. package/src/hmr/hmr.test.e2e.js +43 -0
  115. package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
  116. package/src/hmr/strategies/default-hmr-strategy.js +34 -0
  117. package/src/hmr/strategies/js-hmr-strategy.d.ts +139 -0
  118. package/src/hmr/strategies/js-hmr-strategy.js +178 -0
  119. package/src/index.browser.d.ts +3 -0
  120. package/src/index.browser.js +4 -0
  121. package/src/index.d.ts +6 -0
  122. package/src/index.js +21 -0
  123. package/src/integrations/ghtml/ghtml-renderer.d.ts +20 -0
  124. package/src/integrations/ghtml/ghtml-renderer.js +63 -0
  125. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  126. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  127. package/src/integrations/ghtml/ghtml.plugin.d.ts +16 -0
  128. package/src/integrations/ghtml/ghtml.plugin.js +20 -0
  129. package/src/plugins/alias-resolver-plugin.d.ts +2 -0
  130. package/src/plugins/alias-resolver-plugin.js +53 -0
  131. package/src/plugins/eco-component-meta-plugin.d.ts +108 -0
  132. package/src/plugins/eco-component-meta-plugin.js +163 -0
  133. package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
  134. package/src/plugins/foreign-jsx-override-plugin.js +35 -0
  135. package/src/plugins/integration-plugin.d.ts +219 -0
  136. package/src/plugins/integration-plugin.js +196 -0
  137. package/src/plugins/processor.d.ts +95 -0
  138. package/src/plugins/processor.js +136 -0
  139. package/src/plugins/{runtime-capability.ts → runtime-capability.d.ts} +3 -8
  140. package/src/plugins/runtime-capability.js +0 -0
  141. package/src/plugins/source-transform.d.ts +46 -0
  142. package/src/plugins/source-transform.js +71 -0
  143. package/src/route-renderer/orchestration/boundary-planning.service.d.ts +25 -0
  144. package/src/route-renderer/orchestration/boundary-planning.service.js +97 -0
  145. package/src/route-renderer/orchestration/component-render-context.d.ts +83 -0
  146. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  147. package/src/route-renderer/orchestration/integration-renderer.d.ts +556 -0
  148. package/src/route-renderer/orchestration/integration-renderer.js +932 -0
  149. package/src/route-renderer/orchestration/page-packaging.service.d.ts +16 -0
  150. package/src/route-renderer/orchestration/page-packaging.service.js +66 -0
  151. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +2 -0
  152. package/src/route-renderer/orchestration/processed-asset-dedupe.js +23 -0
  153. package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +89 -0
  154. package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +155 -0
  155. package/src/route-renderer/orchestration/render-execution.service.d.ts +43 -0
  156. package/src/route-renderer/orchestration/render-execution.service.js +106 -0
  157. package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
  158. package/src/route-renderer/orchestration/render-output.utils.js +171 -0
  159. package/src/route-renderer/orchestration/render-preparation.service.d.ts +120 -0
  160. package/src/route-renderer/orchestration/render-preparation.service.js +364 -0
  161. package/src/route-renderer/orchestration/route-shell-composer.service.d.ts +50 -0
  162. package/src/route-renderer/orchestration/route-shell-composer.service.js +81 -0
  163. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  164. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  165. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
  166. package/src/route-renderer/page-loading/component-dependency-collection.js +125 -0
  167. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
  168. package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
  169. package/src/route-renderer/page-loading/dependency-resolver.d.ts +35 -0
  170. package/src/route-renderer/page-loading/dependency-resolver.js +117 -0
  171. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
  172. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
  173. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
  174. package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
  175. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
  176. package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
  177. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
  178. package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
  179. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
  180. package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
  181. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
  182. package/src/route-renderer/page-loading/page-dependency-bundling.js +115 -0
  183. package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
  184. package/src/route-renderer/page-loading/page-module-loader.js +127 -0
  185. package/src/route-renderer/route-renderer.d.ts +67 -0
  186. package/src/route-renderer/route-renderer.js +103 -0
  187. package/src/router/client/link-intent.js +34 -0
  188. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  189. package/src/router/client/link-intent.test.browser.js +43 -0
  190. package/src/router/client/navigation-coordinator.d.ts +169 -0
  191. package/src/router/client/navigation-coordinator.js +215 -0
  192. package/src/router/server/fs-router-scanner.d.ts +41 -0
  193. package/src/router/server/fs-router-scanner.js +161 -0
  194. package/src/router/server/fs-router.d.ts +26 -0
  195. package/src/router/server/fs-router.js +100 -0
  196. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
  197. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
  198. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +103 -0
  199. package/src/services/assets/asset-processing-service/asset-processing.service.js +285 -0
  200. package/src/services/assets/asset-processing-service/asset.factory.d.ts +17 -0
  201. package/src/services/assets/asset-processing-service/asset.factory.js +82 -0
  202. package/src/services/assets/asset-processing-service/assets.types.d.ts +100 -0
  203. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  204. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  205. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +49 -0
  206. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  207. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  208. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
  209. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
  210. package/src/services/assets/asset-processing-service/index.d.ts +5 -0
  211. package/src/services/assets/asset-processing-service/index.js +5 -0
  212. package/src/services/assets/asset-processing-service/{processor.interface.ts → processor.interface.d.ts} +5 -10
  213. package/src/services/assets/asset-processing-service/processor.interface.js +6 -0
  214. package/src/services/assets/asset-processing-service/processor.registry.d.ts +8 -0
  215. package/src/services/assets/asset-processing-service/processor.registry.js +15 -0
  216. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +24 -0
  217. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +65 -0
  218. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +22 -0
  219. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +136 -0
  220. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  221. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  222. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +6 -0
  223. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +116 -0
  224. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +9 -0
  225. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +91 -0
  226. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
  227. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +77 -0
  228. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +8 -0
  229. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +58 -0
  230. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
  231. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +67 -0
  232. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
  233. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
  234. package/src/services/assets/browser-bundle.service.d.ts +73 -0
  235. package/src/services/assets/browser-bundle.service.js +41 -0
  236. package/src/services/cache/cache.types.d.ts +107 -0
  237. package/src/services/cache/cache.types.js +0 -0
  238. package/src/services/cache/index.d.ts +7 -0
  239. package/src/services/cache/index.js +7 -0
  240. package/src/services/cache/memory-cache-store.d.ts +42 -0
  241. package/src/services/cache/memory-cache-store.js +98 -0
  242. package/src/services/cache/page-cache-service.d.ts +70 -0
  243. package/src/services/cache/page-cache-service.js +152 -0
  244. package/src/services/cache/page-request-cache-coordinator.service.d.ts +75 -0
  245. package/src/services/cache/page-request-cache-coordinator.service.js +109 -0
  246. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  247. package/src/services/html/html-rewriter-provider.service.js +68 -0
  248. package/src/services/html/html-transformer.service.d.ts +87 -0
  249. package/src/services/html/html-transformer.service.js +216 -0
  250. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  251. package/src/services/invalidation/development-invalidation.service.js +190 -0
  252. package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
  253. package/src/services/module-loading/app-module-loader.service.js +0 -0
  254. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
  255. package/src/services/module-loading/app-server-module-transpiler.service.js +115 -0
  256. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  257. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  258. package/src/services/module-loading/{module-loading-types.ts → module-loading-types.d.ts} +0 -1
  259. package/src/services/module-loading/module-loading-types.js +0 -0
  260. package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
  261. package/src/services/module-loading/node-bootstrap-plugin.js +204 -0
  262. package/src/services/module-loading/page-module-import.service.d.ts +76 -0
  263. package/src/services/module-loading/page-module-import.service.js +170 -0
  264. package/src/services/module-loading/server-module-transpiler.service.d.ts +63 -0
  265. package/src/services/module-loading/server-module-transpiler.service.js +64 -0
  266. package/src/services/module-loading/source-module-support.d.ts +5 -0
  267. package/src/services/module-loading/source-module-support.js +8 -0
  268. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  269. package/src/services/runtime-state/dev-graph.service.js +162 -0
  270. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  271. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  272. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +69 -0
  273. package/src/services/runtime-state/runtime-specifier-registry.service.js +37 -0
  274. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  275. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  276. package/src/services/validation/schema-validation-service.d.ts +122 -0
  277. package/src/services/validation/schema-validation-service.js +101 -0
  278. package/src/services/validation/{standard-schema.types.ts → standard-schema.types.d.ts} +17 -20
  279. package/src/services/validation/standard-schema.types.js +0 -0
  280. package/src/static-site-generator/static-site-generator.d.ts +105 -0
  281. package/src/static-site-generator/static-site-generator.js +349 -0
  282. package/src/types/internal-types.d.ts +231 -0
  283. package/src/types/internal-types.js +0 -0
  284. package/src/types/public-types.d.ts +1257 -0
  285. package/src/types/public-types.js +0 -0
  286. package/src/utils/deep-merge.d.ts +14 -0
  287. package/src/utils/deep-merge.js +32 -0
  288. package/src/utils/hash.d.ts +1 -0
  289. package/src/utils/hash.js +7 -0
  290. package/src/utils/html-escaping.d.ts +7 -0
  291. package/src/utils/html-escaping.js +6 -0
  292. package/src/utils/html.js +4 -0
  293. package/src/utils/invariant.d.ts +5 -0
  294. package/src/utils/invariant.js +11 -0
  295. package/src/utils/locals-utils.d.ts +15 -0
  296. package/src/utils/locals-utils.js +24 -0
  297. package/src/utils/parse-cli-args.d.ts +27 -0
  298. package/src/utils/parse-cli-args.js +62 -0
  299. package/src/utils/path-utils.module.d.ts +5 -0
  300. package/src/utils/path-utils.module.js +14 -0
  301. package/src/utils/resolve-work-dir.d.ts +11 -0
  302. package/src/utils/resolve-work-dir.js +31 -0
  303. package/src/utils/runtime.d.ts +11 -0
  304. package/src/utils/runtime.js +40 -0
  305. package/src/utils/server-utils.module.d.ts +19 -0
  306. package/src/utils/server-utils.module.js +56 -0
  307. package/src/watchers/project-watcher.d.ts +136 -0
  308. package/src/watchers/project-watcher.js +275 -0
  309. package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
  310. package/src/watchers/project-watcher.test-helpers.js +52 -0
  311. package/src/adapters/abstract/application-adapter.test.ts +0 -172
  312. package/src/adapters/abstract/application-adapter.ts +0 -379
  313. package/src/adapters/abstract/router-adapter.ts +0 -30
  314. package/src/adapters/abstract/server-adapter.ts +0 -79
  315. package/src/adapters/bun/client-bridge.ts +0 -62
  316. package/src/adapters/bun/create-app.ts +0 -180
  317. package/src/adapters/bun/hmr-manager.test.ts +0 -267
  318. package/src/adapters/bun/hmr-manager.ts +0 -406
  319. package/src/adapters/bun/index.ts +0 -2
  320. package/src/adapters/bun/server-adapter.ts +0 -500
  321. package/src/adapters/bun/server-lifecycle.ts +0 -124
  322. package/src/adapters/create-app.test.ts +0 -10
  323. package/src/adapters/create-app.ts +0 -91
  324. package/src/adapters/index.ts +0 -2
  325. package/src/adapters/node/create-app.test.ts +0 -53
  326. package/src/adapters/node/create-app.ts +0 -183
  327. package/src/adapters/node/node-client-bridge.test.ts +0 -198
  328. package/src/adapters/node/node-client-bridge.ts +0 -79
  329. package/src/adapters/node/node-hmr-manager.test.ts +0 -322
  330. package/src/adapters/node/node-hmr-manager.ts +0 -378
  331. package/src/adapters/node/server-adapter.ts +0 -502
  332. package/src/adapters/node/static-content-server.test.ts +0 -60
  333. package/src/adapters/node/static-content-server.ts +0 -239
  334. package/src/adapters/shared/api-response.test.ts +0 -97
  335. package/src/adapters/shared/api-response.ts +0 -104
  336. package/src/adapters/shared/application-adapter.ts +0 -199
  337. package/src/adapters/shared/define-api-handler.ts +0 -66
  338. package/src/adapters/shared/explicit-static-route-matcher.test.ts +0 -381
  339. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -140
  340. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +0 -90
  341. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -127
  342. package/src/adapters/shared/fs-server-response-factory.test.ts +0 -187
  343. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  344. package/src/adapters/shared/fs-server-response-matcher.test.ts +0 -285
  345. package/src/adapters/shared/fs-server-response-matcher.ts +0 -189
  346. package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
  347. package/src/adapters/shared/hmr-html-response.ts +0 -52
  348. package/src/adapters/shared/hmr-manager.contract.test.ts +0 -232
  349. package/src/adapters/shared/hmr-manager.dispatch.test.ts +0 -220
  350. package/src/adapters/shared/render-context.test.ts +0 -150
  351. package/src/adapters/shared/render-context.ts +0 -123
  352. package/src/adapters/shared/runtime-bootstrap.ts +0 -79
  353. package/src/adapters/shared/server-adapter.test.ts +0 -77
  354. package/src/adapters/shared/server-adapter.ts +0 -493
  355. package/src/adapters/shared/server-route-handler.test.ts +0 -110
  356. package/src/adapters/shared/server-route-handler.ts +0 -153
  357. package/src/adapters/shared/server-static-builder.test.ts +0 -338
  358. package/src/adapters/shared/server-static-builder.ts +0 -170
  359. package/src/build/build-adapter-serialization.test.ts +0 -281
  360. package/src/build/build-adapter.test.ts +0 -1240
  361. package/src/build/build-adapter.ts +0 -1012
  362. package/src/build/build-manifest.ts +0 -54
  363. package/src/build/build-types.ts +0 -83
  364. package/src/build/dev-build-coordinator.ts +0 -220
  365. package/src/build/esbuild-build-adapter.ts +0 -660
  366. package/src/build/runtime-build-executor.test.ts +0 -81
  367. package/src/build/runtime-build-executor.ts +0 -40
  368. package/src/build/runtime-specifier-alias-plugin.test.ts +0 -67
  369. package/src/build/runtime-specifier-alias-plugin.ts +0 -62
  370. package/src/build/runtime-specifier-aliases.ts +0 -135
  371. package/src/config/config-builder.test.ts +0 -443
  372. package/src/config/config-builder.ts +0 -742
  373. package/src/config/config-builder.typecheck.test.ts +0 -96
  374. package/src/dev/sc-server.ts +0 -143
  375. package/src/eco/eco.browser.test.ts +0 -43
  376. package/src/eco/eco.browser.ts +0 -118
  377. package/src/eco/eco.test.ts +0 -654
  378. package/src/eco/eco.ts +0 -205
  379. package/src/eco/eco.types.ts +0 -221
  380. package/src/eco/eco.utils.test.ts +0 -219
  381. package/src/eco/eco.utils.ts +0 -5
  382. package/src/eco/global-injector-map.test.ts +0 -42
  383. package/src/eco/global-injector-map.ts +0 -112
  384. package/src/eco/lazy-injector-map.test.ts +0 -66
  385. package/src/eco/lazy-injector-map.ts +0 -120
  386. package/src/eco/module-dependencies.test.ts +0 -30
  387. package/src/eco/module-dependencies.ts +0 -75
  388. package/src/errors/http-error.test.ts +0 -134
  389. package/src/errors/http-error.ts +0 -72
  390. package/src/errors/locals-access-error.ts +0 -7
  391. package/src/global/app-logger.ts +0 -4
  392. package/src/global/utils.test.ts +0 -12
  393. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-have-HMR-script-injected-in-page-1.png +0 -0
  394. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  395. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  396. package/src/hmr/client/hmr-runtime.ts +0 -160
  397. package/src/hmr/hmr-strategy.test.ts +0 -124
  398. package/src/hmr/hmr-strategy.ts +0 -177
  399. package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
  400. package/src/hmr/hmr.test.e2e.ts +0 -66
  401. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  402. package/src/hmr/strategies/js-hmr-strategy.test.ts +0 -335
  403. package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
  404. package/src/index.browser.ts +0 -3
  405. package/src/index.ts +0 -15
  406. package/src/integrations/ghtml/ghtml-renderer.test.ts +0 -253
  407. package/src/integrations/ghtml/ghtml-renderer.ts +0 -97
  408. package/src/integrations/ghtml/ghtml.constants.ts +0 -1
  409. package/src/integrations/ghtml/ghtml.plugin.ts +0 -28
  410. package/src/plugins/alias-resolver-plugin.test.ts +0 -41
  411. package/src/plugins/alias-resolver-plugin.ts +0 -63
  412. package/src/plugins/eco-component-meta-plugin.test.ts +0 -406
  413. package/src/plugins/eco-component-meta-plugin.ts +0 -495
  414. package/src/plugins/foreign-jsx-override-plugin.test.ts +0 -65
  415. package/src/plugins/foreign-jsx-override-plugin.ts +0 -67
  416. package/src/plugins/integration-plugin.test.ts +0 -156
  417. package/src/plugins/integration-plugin.ts +0 -311
  418. package/src/plugins/processor.test.ts +0 -148
  419. package/src/plugins/processor.ts +0 -240
  420. package/src/plugins/source-transform.test.ts +0 -82
  421. package/src/plugins/source-transform.ts +0 -123
  422. package/src/route-renderer/orchestration/boundary-planning.service.ts +0 -146
  423. package/src/route-renderer/orchestration/component-render-context.ts +0 -318
  424. package/src/route-renderer/orchestration/integration-renderer.test.ts +0 -2088
  425. package/src/route-renderer/orchestration/integration-renderer.ts +0 -1285
  426. package/src/route-renderer/orchestration/page-packaging.service.test.ts +0 -76
  427. package/src/route-renderer/orchestration/page-packaging.service.ts +0 -85
  428. package/src/route-renderer/orchestration/processed-asset-dedupe.ts +0 -25
  429. package/src/route-renderer/orchestration/queued-boundary-runtime.service.test.ts +0 -319
  430. package/src/route-renderer/orchestration/queued-boundary-runtime.service.ts +0 -289
  431. package/src/route-renderer/orchestration/render-execution.service.test.ts +0 -196
  432. package/src/route-renderer/orchestration/render-execution.service.ts +0 -182
  433. package/src/route-renderer/orchestration/render-output.utils.ts +0 -302
  434. package/src/route-renderer/orchestration/render-preparation.service.test.ts +0 -569
  435. package/src/route-renderer/orchestration/render-preparation.service.ts +0 -508
  436. package/src/route-renderer/orchestration/route-shell-composer.service.ts +0 -162
  437. package/src/route-renderer/orchestration/template-serialization.test.ts +0 -110
  438. package/src/route-renderer/orchestration/template-serialization.ts +0 -117
  439. package/src/route-renderer/page-loading/component-dependency-collection.ts +0 -196
  440. package/src/route-renderer/page-loading/declared-asset-collection.ts +0 -156
  441. package/src/route-renderer/page-loading/dependency-resolver.test.ts +0 -665
  442. package/src/route-renderer/page-loading/dependency-resolver.ts +0 -150
  443. package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +0 -75
  444. package/src/route-renderer/page-loading/lazy-entry-collection.ts +0 -167
  445. package/src/route-renderer/page-loading/lazy-trigger-planning.ts +0 -74
  446. package/src/route-renderer/page-loading/module-declaration-aggregation.ts +0 -60
  447. package/src/route-renderer/page-loading/module-declaration-scripts.ts +0 -16
  448. package/src/route-renderer/page-loading/page-dependency-bundling.ts +0 -205
  449. package/src/route-renderer/page-loading/page-module-loader.test.ts +0 -183
  450. package/src/route-renderer/page-loading/page-module-loader.ts +0 -184
  451. package/src/route-renderer/route-renderer.ts +0 -136
  452. package/src/router/client/link-intent.test.browser.ts +0 -51
  453. package/src/router/client/link-intent.ts +0 -92
  454. package/src/router/client/navigation-coordinator.test.ts +0 -237
  455. package/src/router/client/navigation-coordinator.ts +0 -453
  456. package/src/router/server/fs-router-scanner.test.ts +0 -83
  457. package/src/router/server/fs-router-scanner.ts +0 -224
  458. package/src/router/server/fs-router.test.ts +0 -214
  459. package/src/router/server/fs-router.ts +0 -122
  460. package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +0 -66
  461. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +0 -476
  462. package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -345
  463. package/src/services/assets/asset-processing-service/asset.factory.test.ts +0 -63
  464. package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
  465. package/src/services/assets/asset-processing-service/assets.types.ts +0 -125
  466. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +0 -74
  467. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -96
  468. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +0 -67
  469. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
  470. package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +0 -104
  471. package/src/services/assets/asset-processing-service/index.ts +0 -5
  472. package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
  473. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +0 -59
  474. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -83
  475. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -174
  476. package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
  477. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +0 -192
  478. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -134
  479. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +0 -326
  480. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -110
  481. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +0 -227
  482. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -87
  483. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +0 -261
  484. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -71
  485. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -81
  486. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +0 -65
  487. package/src/services/assets/browser-bundle.service.test.ts +0 -66
  488. package/src/services/assets/browser-bundle.service.ts +0 -109
  489. package/src/services/cache/cache.types.ts +0 -126
  490. package/src/services/cache/index.ts +0 -18
  491. package/src/services/cache/memory-cache-store.test.ts +0 -225
  492. package/src/services/cache/memory-cache-store.ts +0 -130
  493. package/src/services/cache/page-cache-service.test.ts +0 -175
  494. package/src/services/cache/page-cache-service.ts +0 -202
  495. package/src/services/cache/page-request-cache-coordinator.service.test.ts +0 -79
  496. package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
  497. package/src/services/html/html-rewriter-provider.service.test.ts +0 -183
  498. package/src/services/html/html-rewriter-provider.service.ts +0 -104
  499. package/src/services/html/html-transformer.service.test.ts +0 -479
  500. package/src/services/html/html-transformer.service.ts +0 -275
  501. package/src/services/invalidation/development-invalidation.service.test.ts +0 -87
  502. package/src/services/invalidation/development-invalidation.service.ts +0 -262
  503. package/src/services/module-loading/app-module-loader.service.ts +0 -9
  504. package/src/services/module-loading/app-server-module-transpiler.service.test.ts +0 -130
  505. package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -143
  506. package/src/services/module-loading/host-module-loader-registry.ts +0 -15
  507. package/src/services/module-loading/node-bootstrap-plugin.test.ts +0 -335
  508. package/src/services/module-loading/node-bootstrap-plugin.ts +0 -297
  509. package/src/services/module-loading/page-module-import.service.test.ts +0 -504
  510. package/src/services/module-loading/page-module-import.service.ts +0 -252
  511. package/src/services/module-loading/server-module-transpiler.service.test.ts +0 -243
  512. package/src/services/module-loading/server-module-transpiler.service.ts +0 -104
  513. package/src/services/module-loading/source-module-support.ts +0 -19
  514. package/src/services/runtime-state/dev-graph.service.ts +0 -217
  515. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
  516. package/src/services/runtime-state/runtime-specifier-registry.service.ts +0 -96
  517. package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
  518. package/src/services/validation/schema-validation-service.test.ts +0 -223
  519. package/src/services/validation/schema-validation-service.ts +0 -204
  520. package/src/static-site-generator/static-site-generator.test.ts +0 -316
  521. package/src/static-site-generator/static-site-generator.ts +0 -462
  522. package/src/types/internal-types.ts +0 -242
  523. package/src/types/public-types.ts +0 -1443
  524. package/src/utils/deep-merge.test.ts +0 -114
  525. package/src/utils/deep-merge.ts +0 -47
  526. package/src/utils/hash.ts +0 -5
  527. package/src/utils/html-escaping.ts +0 -9
  528. package/src/utils/invariant.test.ts +0 -22
  529. package/src/utils/invariant.ts +0 -15
  530. package/src/utils/locals-utils.ts +0 -37
  531. package/src/utils/parse-cli-args.test.ts +0 -69
  532. package/src/utils/parse-cli-args.ts +0 -105
  533. package/src/utils/path-utils.module.ts +0 -14
  534. package/src/utils/path-utils.test.ts +0 -15
  535. package/src/utils/resolve-work-dir.ts +0 -45
  536. package/src/utils/runtime.ts +0 -44
  537. package/src/utils/server-utils.module.ts +0 -67
  538. package/src/utils/server-utils.test.ts +0 -38
  539. package/src/watchers/project-watcher.integration.test.ts +0 -337
  540. package/src/watchers/project-watcher.test-helpers.ts +0 -41
  541. package/src/watchers/project-watcher.test.ts +0 -768
  542. package/src/watchers/project-watcher.ts +0 -357
  543. /package/src/utils/{html.ts → html.d.ts} +0 -0
@@ -1,289 +0,0 @@
1
- import type { ProcessedAsset } from '../../services/assets/asset-processing-service/index.ts';
2
- import type {
3
- BaseIntegrationContext,
4
- BoundaryRenderPayload,
5
- ComponentRenderInput,
6
- EcoComponent,
7
- } from '../../types/public-types.ts';
8
- import type { ComponentBoundaryRuntime } from './component-render-context.ts';
9
-
10
- export type QueuedBoundaryDecisionInput = {
11
- currentIntegration: string;
12
- targetIntegration?: string;
13
- component: EcoComponent;
14
- props: Record<string, unknown>;
15
- };
16
-
17
- export type QueuedBoundaryResolution = {
18
- token: string;
19
- component: EcoComponent;
20
- props: Record<string, unknown>;
21
- componentInstanceId: string;
22
- };
23
-
24
- /**
25
- * Shared mutable state for one renderer-owned queued boundary runtime.
26
- *
27
- * Renderers that cannot resolve foreign boundaries inline can enqueue transport
28
- * tokens during their initial render, then resolve those tokens against the
29
- * owning renderer before returning final HTML.
30
- */
31
- export type QueuedBoundaryRuntimeContext = {
32
- rendererCache: Map<string, unknown>;
33
- componentInstanceScope?: string;
34
- nextBoundaryId: number;
35
- queuedResolutions: QueuedBoundaryResolution[];
36
- };
37
-
38
- type QueuedBoundaryIntegrationContext = BaseIntegrationContext & Record<string, unknown>;
39
-
40
- type QueuedBoundaryChildRenderResult = {
41
- assets: ProcessedAsset[];
42
- html?: string;
43
- };
44
-
45
- /**
46
- * Shared queue orchestration for renderer-owned boundary runtimes that emit
47
- * temporary transport tokens during one render pass.
48
- *
49
- * The service keeps three responsibilities in one place:
50
- * - storing per-render queue state on the active integration context
51
- * - creating a `ComponentBoundaryRuntime` that enqueues foreign boundaries
52
- * - resolving queued tokens back through the owning renderer before final HTML
53
- * leaves the current renderer
54
- *
55
- * Renderers still own framework-specific child rendering. This service only
56
- * handles queue bookkeeping, recursion, cycle detection, and asset merging.
57
- */
58
- export class QueuedBoundaryRuntimeService {
59
- /**
60
- * Reads the queued boundary runtime state previously attached to one render.
61
- */
62
- getRuntimeContext<TContext extends QueuedBoundaryRuntimeContext>(
63
- input: ComponentRenderInput,
64
- runtimeContextKey: string,
65
- ): TContext | undefined {
66
- const integrationContext = input.integrationContext as QueuedBoundaryIntegrationContext | undefined;
67
- const runtimeContext = integrationContext?.[runtimeContextKey];
68
-
69
- if (typeof runtimeContext !== 'object' || runtimeContext === null) {
70
- return undefined;
71
- }
72
-
73
- return runtimeContext as TContext;
74
- }
75
-
76
- /**
77
- * Creates the runtime hook used by `runWithComponentRenderContext()` for one
78
- * renderer-owned queue.
79
- *
80
- * When the renderer decides a boundary must be handed off, the runtime returns
81
- * a resolved transport token instead of rendering the foreign component inline.
82
- */
83
- createRuntime<TContext extends QueuedBoundaryRuntimeContext>(options: {
84
- boundaryInput: ComponentRenderInput;
85
- rendererCache: Map<string, unknown>;
86
- runtimeContextKey: string;
87
- tokenPrefix: string;
88
- shouldQueueBoundary: (input: QueuedBoundaryDecisionInput) => boolean;
89
- createRuntimeContext?: (
90
- integrationContext: QueuedBoundaryIntegrationContext,
91
- rendererCache: Map<string, unknown>,
92
- ) => TContext;
93
- }): ComponentBoundaryRuntime {
94
- const runtimeContext = this.ensureRuntimeContext(options);
95
-
96
- const interceptBoundary = (input: QueuedBoundaryDecisionInput) => {
97
- if (!options.shouldQueueBoundary(input)) {
98
- return { kind: 'inline' as const };
99
- }
100
-
101
- runtimeContext.nextBoundaryId += 1;
102
- const boundaryId = runtimeContext.nextBoundaryId;
103
- const token = this.createBoundaryToken(options.tokenPrefix, runtimeContext, boundaryId);
104
- runtimeContext.queuedResolutions.push({
105
- token,
106
- component: input.component,
107
- props: { ...input.props },
108
- componentInstanceId: runtimeContext.componentInstanceScope
109
- ? `${runtimeContext.componentInstanceScope}_n_${boundaryId}`
110
- : `n_${boundaryId}`,
111
- });
112
-
113
- return {
114
- kind: 'resolved' as const,
115
- value: token,
116
- };
117
- };
118
-
119
- return {
120
- interceptBoundary,
121
- interceptBoundarySync: interceptBoundary,
122
- };
123
- }
124
-
125
- /**
126
- * Resolves every queued transport token in one renderer-owned HTML fragment.
127
- *
128
- * The caller supplies framework-specific child rendering, while this service
129
- * handles recursive token replacement, cycle detection, root-attribute
130
- * application, and merged asset collection.
131
- */
132
- async resolveQueuedHtml<TContext extends QueuedBoundaryRuntimeContext>(options: {
133
- html: string;
134
- runtimeContext?: TContext;
135
- queueLabel: string;
136
- renderQueuedChildren: (
137
- children: unknown,
138
- runtimeContext: TContext,
139
- queuedResolutionsByToken: Map<string, QueuedBoundaryResolution>,
140
- resolveToken: (token: string) => Promise<string>,
141
- ) => Promise<QueuedBoundaryChildRenderResult>;
142
- resolveBoundary: (
143
- input: ComponentRenderInput,
144
- rendererCache: Map<string, unknown>,
145
- ) => Promise<BoundaryRenderPayload | undefined>;
146
- applyAttributesToFirstElement: (html: string, attributes: Record<string, string>) => string;
147
- dedupeProcessedAssets: (assets: ProcessedAsset[]) => ProcessedAsset[];
148
- }): Promise<{ assets: ProcessedAsset[]; html: string }> {
149
- if (!options.runtimeContext || options.runtimeContext.queuedResolutions.length === 0) {
150
- return { assets: [], html: options.html };
151
- }
152
-
153
- const runtimeContext = options.runtimeContext;
154
- const queuedResolutionsByToken = new Map(
155
- runtimeContext.queuedResolutions.map((resolution) => [resolution.token, resolution]),
156
- );
157
- const resolvedHtmlByToken = new Map<string, string>();
158
- const resolvingTokens = new Set<string>();
159
- const collectedAssets: ProcessedAsset[] = [];
160
-
161
- const resolveToken = async (token: string): Promise<string> => {
162
- const cachedHtml = resolvedHtmlByToken.get(token);
163
- if (cachedHtml) {
164
- return cachedHtml;
165
- }
166
-
167
- const resolution = queuedResolutionsByToken.get(token);
168
- if (!resolution) {
169
- return token;
170
- }
171
-
172
- if (resolvingTokens.has(token)) {
173
- throw new Error(
174
- `[ecopages] ${options.queueLabel} boundary queue contains a cycle or unresolved dependency links.`,
175
- );
176
- }
177
-
178
- resolvingTokens.add(token);
179
-
180
- try {
181
- const renderedChildren = await options.renderQueuedChildren(
182
- resolution.props.children,
183
- runtimeContext,
184
- queuedResolutionsByToken,
185
- resolveToken,
186
- );
187
-
188
- if (renderedChildren.assets.length > 0) {
189
- collectedAssets.push(...renderedChildren.assets);
190
- }
191
-
192
- const boundaryRender = await options.resolveBoundary(
193
- {
194
- component: resolution.component,
195
- props: { ...resolution.props },
196
- children: renderedChildren.html,
197
- integrationContext: {
198
- rendererCache: runtimeContext.rendererCache,
199
- componentInstanceId: resolution.componentInstanceId,
200
- },
201
- },
202
- runtimeContext.rendererCache,
203
- );
204
-
205
- if (!boundaryRender) {
206
- throw new Error(
207
- `[ecopages] ${options.queueLabel} queued boundary could not resolve its owning renderer.`,
208
- );
209
- }
210
-
211
- if ((boundaryRender.assets?.length ?? 0) > 0) {
212
- collectedAssets.push(...(boundaryRender.assets ?? []));
213
- }
214
-
215
- const resolvedHtml =
216
- boundaryRender.attachmentPolicy.kind === 'first-element' && boundaryRender.rootAttributes
217
- ? options.applyAttributesToFirstElement(boundaryRender.html, boundaryRender.rootAttributes)
218
- : boundaryRender.html;
219
-
220
- resolvedHtmlByToken.set(token, resolvedHtml);
221
- return resolvedHtml;
222
- } finally {
223
- resolvingTokens.delete(token);
224
- }
225
- };
226
-
227
- let resolvedHtml = options.html;
228
-
229
- for (const resolution of runtimeContext.queuedResolutions) {
230
- if (!resolvedHtml.includes(resolution.token)) {
231
- continue;
232
- }
233
-
234
- resolvedHtml = resolvedHtml.split(resolution.token).join(await resolveToken(resolution.token));
235
- }
236
-
237
- return {
238
- assets: options.dedupeProcessedAssets(collectedAssets),
239
- html: resolvedHtml,
240
- };
241
- }
242
-
243
- private createBoundaryToken(
244
- tokenPrefix: string,
245
- runtimeContext: QueuedBoundaryRuntimeContext,
246
- boundaryId: number,
247
- ): string {
248
- return `${tokenPrefix}${runtimeContext.componentInstanceScope ?? 'root'}__${boundaryId}__`;
249
- }
250
-
251
- private ensureRuntimeContext<TContext extends QueuedBoundaryRuntimeContext>(options: {
252
- boundaryInput: ComponentRenderInput;
253
- rendererCache: Map<string, unknown>;
254
- runtimeContextKey: string;
255
- createRuntimeContext?: (
256
- integrationContext: QueuedBoundaryIntegrationContext,
257
- rendererCache: Map<string, unknown>,
258
- ) => TContext;
259
- }): TContext {
260
- let integrationContext: QueuedBoundaryIntegrationContext;
261
- if (
262
- typeof options.boundaryInput.integrationContext === 'object' &&
263
- options.boundaryInput.integrationContext !== null
264
- ) {
265
- integrationContext = options.boundaryInput.integrationContext as QueuedBoundaryIntegrationContext;
266
- } else {
267
- integrationContext = {};
268
- }
269
-
270
- const existingRuntimeContext = integrationContext[options.runtimeContextKey];
271
- if (typeof existingRuntimeContext !== 'object' || existingRuntimeContext === null) {
272
- integrationContext[options.runtimeContextKey] =
273
- options.createRuntimeContext?.(integrationContext, options.rendererCache) ??
274
- ({
275
- rendererCache: options.rendererCache,
276
- componentInstanceScope: integrationContext.componentInstanceId,
277
- nextBoundaryId: 0,
278
- queuedResolutions: [],
279
- } satisfies QueuedBoundaryRuntimeContext);
280
- } else {
281
- (existingRuntimeContext as QueuedBoundaryRuntimeContext).rendererCache = options.rendererCache;
282
- }
283
-
284
- integrationContext.rendererCache = options.rendererCache;
285
- options.boundaryInput.integrationContext = integrationContext;
286
-
287
- return integrationContext[options.runtimeContextKey] as TContext;
288
- }
289
- }
@@ -1,196 +0,0 @@
1
- import { describe, expect, it, vi } from 'vitest';
2
- import { getComponentRenderContext } from './component-render-context.ts';
3
- import type {
4
- EcoComponent,
5
- IntegrationRendererRenderOptions,
6
- RouteRendererBody,
7
- RouteRendererOptions,
8
- } from '../../types/public-types.ts';
9
- import { RenderExecutionService } from './render-execution.service.ts';
10
-
11
- describe('RenderExecutionService', () => {
12
- it('captures streamed render bodies before final HTML handling', async () => {
13
- const service = new RenderExecutionService();
14
- const encoder = new TextEncoder();
15
-
16
- const result = await service.captureHtmlRender(
17
- async () =>
18
- new ReadableStream({
19
- start(controller) {
20
- controller.enqueue(encoder.encode('<html><body><main>Streamed</main></body></html>'));
21
- controller.close();
22
- },
23
- }) as unknown as BodyInit,
24
- );
25
-
26
- expect(result.body).toBeInstanceOf(ReadableStream);
27
- expect(result.html).toContain('<main>Streamed</main>');
28
- });
29
-
30
- it('preserves streamed bodies when no boundary resolution or attribute stamping is required', async () => {
31
- const service = new RenderExecutionService();
32
- const HtmlTemplate = (() => '<html></html>') as EcoComponent<Record<string, unknown>>;
33
- const Page = (() => '<main>Page</main>') as EcoComponent<Record<string, unknown>>;
34
- const encoder = new TextEncoder();
35
-
36
- const result = await service.execute(
37
- {
38
- file: '/app/pages/index.tsx',
39
- params: {},
40
- query: {},
41
- } as unknown as RouteRendererOptions,
42
- {
43
- prepareRenderOptions: async () =>
44
- ({
45
- HtmlTemplate,
46
- Page,
47
- cacheStrategy: { revalidate: 60 },
48
- }) as unknown as IntegrationRendererRenderOptions<unknown>,
49
- render: async () =>
50
- new ReadableStream({
51
- start(controller) {
52
- controller.enqueue(encoder.encode('<html><body><main>Streamed</main></body></html>'));
53
- controller.close();
54
- },
55
- }) as unknown as BodyInit,
56
- getDocumentAttributes: () => undefined,
57
- applyAttributesToHtmlElement: (html) => html,
58
- applyAttributesToFirstBodyElement: (html) => html,
59
- transformResponse: async (response) => response.body as RouteRendererBody,
60
- },
61
- );
62
-
63
- expect(result.cacheStrategy).toEqual({ revalidate: 60 });
64
- expect(result.body).toBeInstanceOf(ReadableStream);
65
- expect(await new Response(result.body as BodyInit).text()).toContain('<main>Streamed</main>');
66
- });
67
-
68
- it('applies root and document attributes to fully resolved route HTML', async () => {
69
- const service = new RenderExecutionService();
70
- const HtmlTemplate = (() => '<html></html>') as EcoComponent<Record<string, unknown>>;
71
- const Page = (() => '<main>Page</main>') as EcoComponent<Record<string, unknown>>;
72
-
73
- const result = await service.execute(
74
- {
75
- file: '/app/pages/index.tsx',
76
- params: {},
77
- query: {},
78
- } as unknown as RouteRendererOptions,
79
- {
80
- prepareRenderOptions: async () =>
81
- ({
82
- HtmlTemplate,
83
- Page,
84
- cacheStrategy: { revalidate: 60 },
85
- componentRender: {
86
- canAttachAttributes: true,
87
- rootAttributes: { 'data-eco-component-id': 'eco-page-root' },
88
- },
89
- }) as unknown as IntegrationRendererRenderOptions<unknown>,
90
- render: async () => '<html><body><main>Resolved</main></body></html>',
91
- getDocumentAttributes: () => ({ 'data-eco-document-owner': 'react-router' }),
92
- applyAttributesToHtmlElement: (html, attributes) =>
93
- html.replace('<html', `<html data-eco-document-owner="${attributes['data-eco-document-owner']}"`),
94
- applyAttributesToFirstBodyElement: (html, attributes) =>
95
- html.replace('<main', `<main data-eco-component-id="${attributes['data-eco-component-id']}"`),
96
- transformResponse: async (response) => await response.text(),
97
- },
98
- );
99
-
100
- expect(result.cacheStrategy).toEqual({ revalidate: 60 });
101
- expect(result.body).toContain('<html data-eco-document-owner="react-router"><body>');
102
- expect(result.body).toContain('<main data-eco-component-id="eco-page-root">Resolved</main>');
103
- });
104
-
105
- it('throws when route HTML contains escaped unresolved boundary artifacts', async () => {
106
- const service = new RenderExecutionService();
107
- const HtmlTemplate = (() => '<html></html>') as EcoComponent<Record<string, unknown>>;
108
- const Page = (() => '<main>Page</main>') as EcoComponent<Record<string, unknown>>;
109
-
110
- await expect(
111
- service.execute(
112
- {
113
- file: '/app/pages/index.tsx',
114
- params: {},
115
- query: {},
116
- } as unknown as RouteRendererOptions,
117
- {
118
- prepareRenderOptions: async () =>
119
- ({
120
- HtmlTemplate,
121
- Page,
122
- cacheStrategy: 'dynamic',
123
- }) as unknown as IntegrationRendererRenderOptions<unknown>,
124
- render: async () =>
125
- '<html><body>&amp;lt;eco-marker data-eco-node-id=&quot;n_2&quot; data-eco-component-ref=&quot;page-component&quot; data-eco-props-ref=&quot;p_2&quot;&amp;gt;&amp;lt;/eco-marker&amp;gt;</body></html>',
126
- getDocumentAttributes: () => undefined,
127
- applyAttributesToHtmlElement: (html) => html,
128
- applyAttributesToFirstBodyElement: (html) => html,
129
- transformResponse: async (response) => await response.text(),
130
- },
131
- ),
132
- ).rejects.toThrow('Full-route unresolved-boundary fallback has been removed');
133
- });
134
-
135
- it('renders routes with no active component render context', async () => {
136
- const service = new RenderExecutionService();
137
- const HtmlTemplate = (() => '<html></html>') as EcoComponent<Record<string, unknown>>;
138
- const Page = (() => '<main>Page</main>') as EcoComponent<Record<string, unknown>>;
139
-
140
- const result = await service.execute(
141
- {
142
- file: '/app/pages/index.tsx',
143
- params: {},
144
- query: {},
145
- } as unknown as RouteRendererOptions,
146
- {
147
- prepareRenderOptions: async () =>
148
- ({
149
- HtmlTemplate,
150
- Page,
151
- cacheStrategy: 'dynamic',
152
- }) as unknown as IntegrationRendererRenderOptions<unknown>,
153
- render: async () => {
154
- expect(getComponentRenderContext()).toBeUndefined();
155
- return '<html><body><main>Plain render</main></body></html>';
156
- },
157
- getDocumentAttributes: () => undefined,
158
- applyAttributesToHtmlElement: (html) => html,
159
- applyAttributesToFirstBodyElement: (html) => html,
160
- transformResponse: async (response) => await response.text(),
161
- },
162
- );
163
-
164
- expect(result.body).toContain('<main>Plain render</main>');
165
- });
166
-
167
- it('throws when route HTML returns unresolved boundary artifact HTML', async () => {
168
- const service = new RenderExecutionService();
169
- const HtmlTemplate = (() => '<html></html>') as EcoComponent<Record<string, unknown>>;
170
- const Page = (() => '<main>Page</main>') as EcoComponent<Record<string, unknown>>;
171
-
172
- await expect(
173
- service.execute(
174
- {
175
- file: '/app/pages/index.tsx',
176
- params: {},
177
- query: {},
178
- } as unknown as RouteRendererOptions,
179
- {
180
- prepareRenderOptions: async () =>
181
- ({
182
- HtmlTemplate,
183
- Page,
184
- cacheStrategy: 'dynamic',
185
- }) as unknown as IntegrationRendererRenderOptions<unknown>,
186
- render: async () =>
187
- '<html><body><eco-marker data-eco-node-id="n_1" data-eco-component-ref="unexpected-marker" data-eco-props-ref="p_1"></eco-marker></body></html>',
188
- getDocumentAttributes: () => undefined,
189
- applyAttributesToHtmlElement: (html) => html,
190
- applyAttributesToFirstBodyElement: (html) => html,
191
- transformResponse: async (response) => await response.text(),
192
- },
193
- ),
194
- ).rejects.toThrow('Full-route unresolved-boundary fallback has been removed');
195
- });
196
- });
@@ -1,182 +0,0 @@
1
- import { inspectBoundaryArtifactHtml } from './render-output.utils.ts';
2
- import type {
3
- IntegrationRendererRenderOptions,
4
- RouteRendererBody,
5
- RouteRendererOptions,
6
- RouteRenderResult,
7
- } from '../../types/public-types.ts';
8
-
9
- export interface CapturedHtmlRenderResult {
10
- body: RouteRendererBody;
11
- html: string;
12
- }
13
-
14
- export interface FinalizeHtmlRenderOptions {
15
- html: string;
16
- componentRootAttributes?: Record<string, string>;
17
- documentAttributes?: Record<string, string>;
18
- }
19
-
20
- export interface RenderExecutionCallbacks<C> {
21
- prepareRenderOptions(options: RouteRendererOptions): Promise<IntegrationRendererRenderOptions<C>>;
22
- render(renderOptions: IntegrationRendererRenderOptions<C>): Promise<RouteRendererBody>;
23
- getDocumentAttributes(renderOptions: IntegrationRendererRenderOptions<C>): Record<string, string> | undefined;
24
- applyAttributesToHtmlElement(html: string, attributes: Record<string, string>): string;
25
- applyAttributesToFirstBodyElement(html: string, attributes: Record<string, string>): string;
26
- transformResponse(response: Response): Promise<RouteRendererBody>;
27
- }
28
-
29
- /**
30
- * Executes the main post-preparation rendering flow for integration renderers.
31
- *
32
- * This service owns the orchestration that happens after normalized render
33
- * options have been prepared: one render pass, unresolved boundary-marker
34
- * enforcement, root-attribute application, and final HTML transformation into
35
- * a response body stream.
36
- */
37
- export class RenderExecutionService {
38
- async captureHtmlRender(render: () => Promise<RouteRendererBody>): Promise<CapturedHtmlRenderResult> {
39
- const renderedBody = await render();
40
- const capturedRender = await this.captureRenderedBody(renderedBody);
41
-
42
- return {
43
- body: capturedRender.body,
44
- html: capturedRender.html,
45
- };
46
- }
47
-
48
- /**
49
- * Executes one integration render pass and returns the final route render
50
- * result.
51
- *
52
- * @typeParam C Integration render output element type.
53
- * @param options Route-level render options.
54
- * @param currentIntegrationName Active integration name for this render pass.
55
- * @param callbacks Renderer-specific hooks required during execution.
56
- * @returns Final route render output with body and cache strategy.
57
- */
58
- async execute<C = unknown>(
59
- options: RouteRendererOptions,
60
- callbacks: RenderExecutionCallbacks<C>,
61
- ): Promise<RouteRenderResult> {
62
- const renderOptions = await callbacks.prepareRenderOptions(options);
63
- const shouldApplyComponentRootAttributes =
64
- renderOptions.componentRender?.canAttachAttributes &&
65
- renderOptions.componentRender.rootAttributes &&
66
- Object.keys(renderOptions.componentRender.rootAttributes).length > 0;
67
-
68
- const renderExecution = await this.captureHtmlRender(async () => callbacks.render(renderOptions));
69
- const boundaryArtifacts = inspectBoundaryArtifactHtml(renderExecution.html);
70
- const documentAttributes = callbacks.getDocumentAttributes(renderOptions);
71
- const hasBoundaryMarkerHtml = boundaryArtifacts.hasUnresolvedBoundaryArtifacts;
72
-
73
- if (hasBoundaryMarkerHtml) {
74
- throw new Error(
75
- '[ecopages] Route render returned unresolved boundary artifact HTML. Full-route unresolved-boundary fallback has been removed; resolve mixed boundaries inside renderComponentBoundary().',
76
- );
77
- }
78
-
79
- const canReuseCapturedBody =
80
- !hasBoundaryMarkerHtml &&
81
- !shouldApplyComponentRootAttributes &&
82
- !(documentAttributes && Object.keys(documentAttributes).length > 0);
83
-
84
- if (canReuseCapturedBody) {
85
- const body = await callbacks.transformResponse(
86
- new Response(renderExecution.body as BodyInit, {
87
- headers: {
88
- 'Content-Type': 'text/html',
89
- },
90
- }),
91
- );
92
-
93
- return {
94
- body,
95
- cacheStrategy: renderOptions.cacheStrategy,
96
- };
97
- }
98
-
99
- const finalization = await this.finalizeHtmlRender(
100
- {
101
- html: boundaryArtifacts.normalizedHtml,
102
- componentRootAttributes: shouldApplyComponentRootAttributes
103
- ? (renderOptions.componentRender?.rootAttributes as Record<string, string>)
104
- : undefined,
105
- documentAttributes,
106
- },
107
- {
108
- applyAttributesToHtmlElement: callbacks.applyAttributesToHtmlElement,
109
- applyAttributesToFirstBodyElement: callbacks.applyAttributesToFirstBodyElement,
110
- },
111
- );
112
-
113
- const body = await callbacks.transformResponse(
114
- new Response(finalization, {
115
- headers: {
116
- 'Content-Type': 'text/html',
117
- },
118
- }),
119
- );
120
-
121
- return {
122
- body,
123
- cacheStrategy: renderOptions.cacheStrategy,
124
- };
125
- }
126
-
127
- private async captureRenderedBody(body: RouteRendererBody): Promise<{ body: RouteRendererBody; html: string }> {
128
- const response = new Response(body as BodyInit);
129
-
130
- if (typeof body === 'string') {
131
- return {
132
- body,
133
- html: await response.text(),
134
- };
135
- }
136
-
137
- if (!response.body) {
138
- return {
139
- body,
140
- html: await response.text(),
141
- };
142
- }
143
-
144
- const [capturedBody, replayBody] = response.body.tee();
145
-
146
- return {
147
- body: replayBody,
148
- html: await new Response(capturedBody).text(),
149
- };
150
- }
151
-
152
- async finalizeHtmlRender(
153
- options: FinalizeHtmlRenderOptions,
154
- callbacks: Pick<
155
- RenderExecutionCallbacks<unknown>,
156
- 'applyAttributesToHtmlElement' | 'applyAttributesToFirstBodyElement'
157
- >,
158
- ): Promise<string> {
159
- return this.applyFinalHtmlAttributes(options.html, options, callbacks);
160
- }
161
-
162
- private applyFinalHtmlAttributes(
163
- html: string,
164
- options: FinalizeHtmlRenderOptions,
165
- callbacks: Pick<
166
- RenderExecutionCallbacks<unknown>,
167
- 'applyAttributesToHtmlElement' | 'applyAttributesToFirstBodyElement'
168
- >,
169
- ): string {
170
- let renderedHtml = html;
171
-
172
- if (options.componentRootAttributes && Object.keys(options.componentRootAttributes).length > 0) {
173
- renderedHtml = callbacks.applyAttributesToFirstBodyElement(renderedHtml, options.componentRootAttributes);
174
- }
175
-
176
- if (options.documentAttributes && Object.keys(options.documentAttributes).length > 0) {
177
- renderedHtml = callbacks.applyAttributesToHtmlElement(renderedHtml, options.documentAttributes);
178
- }
179
-
180
- return renderedHtml;
181
- }
182
- }