@ecopages/core 0.2.0-alpha.2 → 0.2.0-alpha.20

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 (391) hide show
  1. package/CHANGELOG.md +26 -64
  2. package/README.md +212 -14
  3. package/package.json +116 -66
  4. package/src/adapters/README.md +39 -0
  5. package/src/adapters/abstract/application-adapter.d.ts +28 -2
  6. package/src/adapters/abstract/application-adapter.js +14 -2
  7. package/src/adapters/abstract/router-adapter.d.ts +1 -1
  8. package/src/adapters/abstract/server-adapter.d.ts +2 -2
  9. package/src/adapters/bun/client-bridge.d.ts +1 -1
  10. package/src/adapters/bun/create-app.d.ts +4 -12
  11. package/src/adapters/bun/create-app.js +4 -5
  12. package/src/adapters/bun/hmr-manager.d.ts +80 -21
  13. package/src/adapters/bun/hmr-manager.js +168 -62
  14. package/src/adapters/bun/index.d.ts +2 -3
  15. package/src/adapters/bun/index.js +3 -3
  16. package/src/adapters/bun/server-adapter.d.ts +5 -5
  17. package/src/adapters/bun/server-adapter.js +40 -34
  18. package/src/adapters/bun/server-lifecycle.d.ts +28 -17
  19. package/src/adapters/bun/server-lifecycle.js +34 -62
  20. package/src/{create-app.d.ts → adapters/create-app.d.ts} +9 -6
  21. package/src/{create-app.js → adapters/create-app.js} +4 -4
  22. package/src/adapters/index.d.ts +2 -6
  23. package/src/adapters/index.js +2 -8
  24. package/src/adapters/node/create-app.d.ts +6 -9
  25. package/src/adapters/node/create-app.js +12 -6
  26. package/src/adapters/node/node-client-bridge.d.ts +1 -1
  27. package/src/adapters/node/node-hmr-manager.d.ts +89 -18
  28. package/src/adapters/node/node-hmr-manager.js +185 -95
  29. package/src/adapters/node/server-adapter.d.ts +6 -35
  30. package/src/adapters/node/server-adapter.js +44 -105
  31. package/src/adapters/node/static-content-server.d.ts +37 -1
  32. package/src/adapters/node/static-content-server.js +29 -1
  33. package/src/adapters/shared/application-adapter.d.ts +1 -1
  34. package/src/{define-api-handler.d.ts → adapters/shared/define-api-handler.d.ts} +1 -1
  35. package/src/adapters/shared/explicit-static-route-matcher.d.ts +2 -2
  36. package/src/adapters/shared/explicit-static-route-matcher.js +4 -1
  37. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +1 -1
  38. package/src/adapters/shared/file-route-middleware-pipeline.js +1 -0
  39. package/src/adapters/shared/fs-server-response-factory.d.ts +2 -2
  40. package/src/adapters/shared/fs-server-response-factory.js +1 -1
  41. package/src/adapters/shared/fs-server-response-matcher.d.ts +8 -12
  42. package/src/adapters/shared/fs-server-response-matcher.js +10 -18
  43. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  44. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  45. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  46. package/src/adapters/shared/hmr-html-response.js +32 -0
  47. package/src/adapters/shared/render-context.d.ts +2 -1
  48. package/src/adapters/shared/render-context.js +6 -3
  49. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  50. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  51. package/src/adapters/shared/server-adapter.d.ts +13 -3
  52. package/src/adapters/shared/server-adapter.js +42 -5
  53. package/src/adapters/shared/server-route-handler.d.ts +4 -4
  54. package/src/adapters/shared/server-route-handler.js +6 -15
  55. package/src/adapters/shared/server-static-builder.d.ts +38 -6
  56. package/src/adapters/shared/server-static-builder.js +64 -10
  57. package/src/build/README.md +107 -0
  58. package/src/build/build-adapter.d.ts +168 -3
  59. package/src/build/build-adapter.js +604 -16
  60. package/src/build/build-manifest.d.ts +27 -0
  61. package/src/build/build-manifest.js +30 -0
  62. package/src/build/dev-build-coordinator.d.ts +72 -0
  63. package/src/build/dev-build-coordinator.js +154 -0
  64. package/src/build/esbuild-build-adapter.d.ts +15 -6
  65. package/src/build/esbuild-build-adapter.js +189 -74
  66. package/src/build/runtime-build-executor.d.ts +14 -0
  67. package/src/build/runtime-build-executor.js +22 -0
  68. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  69. package/src/build/runtime-specifier-alias-plugin.js +35 -0
  70. package/src/build/runtime-specifier-aliases.d.ts +5 -0
  71. package/src/build/runtime-specifier-aliases.js +95 -0
  72. package/src/config/README.md +36 -0
  73. package/src/config/config-builder.d.ts +52 -27
  74. package/src/config/config-builder.js +260 -49
  75. package/src/{constants.d.ts → config/constants.d.ts} +13 -0
  76. package/src/{constants.js → config/constants.js} +4 -0
  77. package/src/declarations.d.ts +19 -14
  78. package/src/dev/sc-server.d.ts +1 -1
  79. package/src/dev/sc-server.js +1 -1
  80. package/src/eco/README.md +70 -16
  81. package/src/eco/eco.browser.d.ts +2 -0
  82. package/src/eco/eco.browser.js +83 -0
  83. package/src/eco/eco.js +32 -57
  84. package/src/eco/eco.types.d.ts +12 -4
  85. package/src/eco/eco.utils.d.ts +1 -40
  86. package/src/eco/eco.utils.js +5 -35
  87. package/src/eco/global-injector-map.d.ts +1 -1
  88. package/src/eco/lazy-injector-map.d.ts +1 -1
  89. package/src/hmr/README.md +26 -0
  90. package/src/hmr/client/hmr-runtime.d.ts +1 -6
  91. package/src/hmr/client/hmr-runtime.js +30 -7
  92. package/src/hmr/hmr-strategy.d.ts +16 -13
  93. package/src/hmr/hmr-strategy.js +22 -7
  94. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  95. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  96. package/src/hmr/hmr.test.e2e.js +26 -33
  97. package/src/hmr/strategies/default-hmr-strategy.d.ts +2 -2
  98. package/src/hmr/strategies/default-hmr-strategy.js +1 -1
  99. package/src/hmr/strategies/js-hmr-strategy.d.ts +46 -43
  100. package/src/hmr/strategies/js-hmr-strategy.js +72 -73
  101. package/src/index.browser.d.ts +2 -2
  102. package/src/index.browser.js +1 -1
  103. package/src/index.d.ts +4 -3
  104. package/src/index.js +16 -5
  105. package/src/integrations/ghtml/ghtml-renderer.d.ts +7 -2
  106. package/src/integrations/ghtml/ghtml-renderer.js +33 -30
  107. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  108. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  109. package/src/integrations/ghtml/ghtml.plugin.d.ts +2 -6
  110. package/src/integrations/ghtml/ghtml.plugin.js +3 -4
  111. package/src/plugins/README.md +35 -0
  112. package/src/plugins/alias-resolver-plugin.js +17 -3
  113. package/src/plugins/eco-component-meta-plugin.d.ts +14 -1
  114. package/src/plugins/eco-component-meta-plugin.js +27 -21
  115. package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
  116. package/src/plugins/foreign-jsx-override-plugin.js +35 -0
  117. package/src/plugins/integration-plugin.d.ts +145 -28
  118. package/src/plugins/integration-plugin.js +109 -13
  119. package/src/plugins/processor.d.ts +15 -2
  120. package/src/plugins/processor.js +16 -2
  121. package/src/plugins/runtime-capability.d.ts +9 -0
  122. package/src/plugins/source-transform.d.ts +46 -0
  123. package/src/plugins/source-transform.js +71 -0
  124. package/src/route-renderer/GRAPH.md +64 -98
  125. package/src/route-renderer/README.md +67 -46
  126. package/src/route-renderer/orchestration/boundary-planning.service.d.ts +25 -0
  127. package/src/route-renderer/orchestration/boundary-planning.service.js +97 -0
  128. package/src/route-renderer/orchestration/component-render-context.d.ts +83 -0
  129. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  130. package/src/route-renderer/orchestration/integration-renderer.d.ts +554 -0
  131. package/src/route-renderer/orchestration/integration-renderer.js +957 -0
  132. package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +89 -0
  133. package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +155 -0
  134. package/src/route-renderer/orchestration/render-execution.service.d.ts +43 -0
  135. package/src/route-renderer/orchestration/render-execution.service.js +106 -0
  136. package/src/{eco/eco.utils.ts → route-renderer/orchestration/render-output.utils.d.ts} +10 -53
  137. package/src/route-renderer/orchestration/render-output.utils.js +65 -0
  138. package/src/route-renderer/{render-preparation.service.d.ts → orchestration/render-preparation.service.d.ts} +18 -10
  139. package/src/route-renderer/{render-preparation.service.js → orchestration/render-preparation.service.js} +115 -17
  140. package/src/route-renderer/orchestration/route-shell-composer.service.d.ts +50 -0
  141. package/src/route-renderer/orchestration/route-shell-composer.service.js +81 -0
  142. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  143. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  144. package/src/route-renderer/{dependency-resolver.d.ts → page-loading/dependency-resolver.d.ts} +15 -4
  145. package/src/route-renderer/{dependency-resolver.js → page-loading/dependency-resolver.js} +28 -12
  146. package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
  147. package/src/route-renderer/{page-module-loader.js → page-loading/page-module-loader.js} +39 -14
  148. package/src/route-renderer/route-renderer.d.ts +45 -4
  149. package/src/route-renderer/route-renderer.js +38 -3
  150. package/src/router/README.md +97 -0
  151. package/src/router/client/link-intent.d.ts +53 -0
  152. package/src/router/client/link-intent.js +34 -0
  153. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  154. package/src/router/client/link-intent.test.browser.js +43 -0
  155. package/src/router/client/navigation-coordinator.d.ts +149 -0
  156. package/src/router/client/navigation-coordinator.js +215 -0
  157. package/src/router/{fs-router-scanner.d.ts → server/fs-router-scanner.d.ts} +3 -3
  158. package/src/router/{fs-router-scanner.js → server/fs-router-scanner.js} +14 -8
  159. package/src/router/{fs-router.d.ts → server/fs-router.d.ts} +1 -1
  160. package/src/router/{fs-router.js → server/fs-router.js} +1 -1
  161. package/src/services/README.md +29 -0
  162. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +120 -0
  163. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset-processing.service.js +91 -10
  164. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.d.ts +1 -1
  165. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.js +2 -2
  166. package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.d.ts +2 -1
  167. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  168. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +48 -0
  169. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  170. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  171. package/src/services/assets/asset-processing-service/index.d.ts +5 -0
  172. package/src/services/assets/asset-processing-service/index.js +5 -0
  173. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.d.ts +2 -2
  174. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.d.ts +2 -2
  175. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.d.ts +1 -1
  176. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.js +9 -4
  177. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-script-processor.d.ts +5 -4
  178. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-script-processor.js +15 -23
  179. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  180. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  181. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.d.ts +2 -2
  182. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.js +1 -1
  183. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.d.ts +4 -3
  184. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.js +16 -4
  185. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.d.ts +3 -3
  186. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.js +6 -5
  187. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.d.ts +2 -2
  188. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.js +1 -1
  189. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
  190. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.js +5 -2
  191. package/src/services/assets/browser-bundle.service.d.ts +32 -0
  192. package/src/services/assets/browser-bundle.service.js +33 -0
  193. package/src/services/{page-request-cache-coordinator.service.d.ts → cache/page-request-cache-coordinator.service.d.ts} +2 -2
  194. package/src/services/{page-request-cache-coordinator.service.js → cache/page-request-cache-coordinator.service.js} +3 -1
  195. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  196. package/src/services/html/html-rewriter-provider.service.js +68 -0
  197. package/src/services/html/html-transformer.service.d.ts +77 -0
  198. package/src/services/html/html-transformer.service.js +215 -0
  199. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  200. package/src/services/invalidation/development-invalidation.service.js +190 -0
  201. package/src/services/module-loading/app-module-loader.service.d.ts +28 -0
  202. package/src/services/module-loading/app-module-loader.service.js +35 -0
  203. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
  204. package/src/services/module-loading/app-server-module-transpiler.service.js +109 -0
  205. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  206. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  207. package/src/services/module-loading/module-loading-types.d.ts +2 -0
  208. package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
  209. package/src/services/module-loading/node-bootstrap-plugin.js +204 -0
  210. package/src/services/module-loading/page-module-import.service.d.ts +76 -0
  211. package/src/services/module-loading/page-module-import.service.js +173 -0
  212. package/src/services/module-loading/server-module-transpiler.service.d.ts +72 -0
  213. package/src/services/module-loading/server-module-transpiler.service.js +64 -0
  214. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  215. package/src/services/runtime-state/dev-graph.service.js +162 -0
  216. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  217. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  218. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +69 -0
  219. package/src/services/runtime-state/runtime-specifier-registry.service.js +37 -0
  220. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  221. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  222. package/src/services/{schema-validation-service.d.ts → validation/schema-validation-service.d.ts} +1 -1
  223. package/src/static-site-generator/README.md +26 -0
  224. package/src/static-site-generator/static-site-generator.d.ts +50 -3
  225. package/src/static-site-generator/static-site-generator.js +71 -5
  226. package/src/{internal-types.d.ts → types/internal-types.d.ts} +53 -22
  227. package/src/types/internal-types.js +0 -0
  228. package/src/{public-types.d.ts → types/public-types.d.ts} +146 -21
  229. package/src/types/public-types.js +0 -0
  230. package/src/utils/html-escaping.d.ts +7 -0
  231. package/src/utils/html-escaping.js +6 -0
  232. package/src/utils/locals-utils.d.ts +1 -1
  233. package/src/utils/parse-cli-args.d.ts +4 -1
  234. package/src/utils/parse-cli-args.js +16 -1
  235. package/src/utils/resolve-work-dir.d.ts +11 -0
  236. package/src/utils/resolve-work-dir.js +31 -0
  237. package/src/watchers/project-watcher.d.ts +40 -24
  238. package/src/watchers/project-watcher.js +129 -92
  239. package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
  240. package/src/watchers/project-watcher.test-helpers.js +1 -0
  241. package/src/adapters/abstract/application-adapter.ts +0 -337
  242. package/src/adapters/abstract/router-adapter.ts +0 -30
  243. package/src/adapters/abstract/server-adapter.ts +0 -79
  244. package/src/adapters/bun/client-bridge.ts +0 -62
  245. package/src/adapters/bun/create-app.ts +0 -189
  246. package/src/adapters/bun/define-api-handler.d.ts +0 -61
  247. package/src/adapters/bun/define-api-handler.ts +0 -114
  248. package/src/adapters/bun/hmr-manager.ts +0 -281
  249. package/src/adapters/bun/index.ts +0 -3
  250. package/src/adapters/bun/server-adapter.ts +0 -492
  251. package/src/adapters/bun/server-lifecycle.ts +0 -154
  252. package/src/adapters/index.ts +0 -6
  253. package/src/adapters/node/create-app.ts +0 -179
  254. package/src/adapters/node/index.d.ts +0 -4
  255. package/src/adapters/node/index.js +0 -8
  256. package/src/adapters/node/index.ts +0 -9
  257. package/src/adapters/node/node-client-bridge.ts +0 -79
  258. package/src/adapters/node/node-hmr-manager.ts +0 -271
  259. package/src/adapters/node/server-adapter.ts +0 -561
  260. package/src/adapters/node/static-content-server.ts +0 -203
  261. package/src/adapters/shared/api-response.ts +0 -104
  262. package/src/adapters/shared/application-adapter.ts +0 -199
  263. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -134
  264. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -123
  265. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  266. package/src/adapters/shared/fs-server-response-matcher.ts +0 -198
  267. package/src/adapters/shared/render-context.ts +0 -105
  268. package/src/adapters/shared/server-adapter.ts +0 -442
  269. package/src/adapters/shared/server-route-handler.ts +0 -166
  270. package/src/adapters/shared/server-static-builder.ts +0 -82
  271. package/src/build/build-adapter.ts +0 -132
  272. package/src/build/build-types.ts +0 -83
  273. package/src/build/esbuild-build-adapter.ts +0 -510
  274. package/src/config/config-builder.ts +0 -474
  275. package/src/constants.ts +0 -39
  276. package/src/create-app.ts +0 -87
  277. package/src/define-api-handler.js +0 -15
  278. package/src/define-api-handler.ts +0 -66
  279. package/src/dev/sc-server.ts +0 -143
  280. package/src/eco/component-render-context.d.ts +0 -105
  281. package/src/eco/component-render-context.js +0 -77
  282. package/src/eco/component-render-context.ts +0 -202
  283. package/src/eco/eco.ts +0 -221
  284. package/src/eco/eco.types.ts +0 -202
  285. package/src/eco/global-injector-map.ts +0 -112
  286. package/src/eco/lazy-injector-map.ts +0 -120
  287. package/src/eco/module-dependencies.ts +0 -75
  288. package/src/errors/http-error.ts +0 -72
  289. package/src/errors/index.ts +0 -2
  290. package/src/errors/locals-access-error.ts +0 -7
  291. package/src/global/app-logger.ts +0 -4
  292. 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
  293. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  294. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  295. package/src/hmr/client/hmr-runtime.ts +0 -121
  296. package/src/hmr/hmr-strategy.ts +0 -172
  297. package/src/hmr/hmr.test.e2e.ts +0 -75
  298. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  299. package/src/hmr/strategies/js-hmr-strategy.ts +0 -308
  300. package/src/index.browser.ts +0 -3
  301. package/src/index.ts +0 -5
  302. package/src/integrations/ghtml/ghtml-renderer.ts +0 -93
  303. package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
  304. package/src/internal-types.ts +0 -212
  305. package/src/plugins/alias-resolver-plugin.ts +0 -45
  306. package/src/plugins/eco-component-meta-plugin.ts +0 -474
  307. package/src/plugins/integration-plugin.ts +0 -184
  308. package/src/plugins/processor.ts +0 -220
  309. package/src/public-types.ts +0 -1255
  310. package/src/route-renderer/component-graph-executor.d.ts +0 -32
  311. package/src/route-renderer/component-graph-executor.js +0 -31
  312. package/src/route-renderer/component-graph-executor.ts +0 -84
  313. package/src/route-renderer/component-graph.d.ts +0 -42
  314. package/src/route-renderer/component-graph.js +0 -72
  315. package/src/route-renderer/component-graph.ts +0 -159
  316. package/src/route-renderer/component-marker.d.ts +0 -52
  317. package/src/route-renderer/component-marker.js +0 -46
  318. package/src/route-renderer/component-marker.ts +0 -117
  319. package/src/route-renderer/dependency-resolver.ts +0 -596
  320. package/src/route-renderer/html-post-processing.service.d.ts +0 -40
  321. package/src/route-renderer/html-post-processing.service.js +0 -86
  322. package/src/route-renderer/html-post-processing.service.ts +0 -103
  323. package/src/route-renderer/integration-renderer.d.ts +0 -339
  324. package/src/route-renderer/integration-renderer.js +0 -526
  325. package/src/route-renderer/integration-renderer.ts +0 -696
  326. package/src/route-renderer/marker-graph-resolver.d.ts +0 -76
  327. package/src/route-renderer/marker-graph-resolver.js +0 -93
  328. package/src/route-renderer/marker-graph-resolver.ts +0 -153
  329. package/src/route-renderer/page-module-loader.d.ts +0 -61
  330. package/src/route-renderer/page-module-loader.ts +0 -153
  331. package/src/route-renderer/render-execution.service.d.ts +0 -69
  332. package/src/route-renderer/render-execution.service.js +0 -91
  333. package/src/route-renderer/render-execution.service.ts +0 -158
  334. package/src/route-renderer/render-preparation.service.ts +0 -358
  335. package/src/route-renderer/route-renderer.ts +0 -80
  336. package/src/router/fs-router-scanner.ts +0 -217
  337. package/src/router/fs-router.ts +0 -122
  338. package/src/services/asset-processing-service/asset-processing.service.d.ts +0 -41
  339. package/src/services/asset-processing-service/asset-processing.service.ts +0 -306
  340. package/src/services/asset-processing-service/asset.factory.ts +0 -105
  341. package/src/services/asset-processing-service/assets.types.ts +0 -112
  342. package/src/services/asset-processing-service/index.d.ts +0 -3
  343. package/src/services/asset-processing-service/index.js +0 -3
  344. package/src/services/asset-processing-service/index.ts +0 -3
  345. package/src/services/asset-processing-service/processor.interface.ts +0 -27
  346. package/src/services/asset-processing-service/processor.registry.ts +0 -18
  347. package/src/services/asset-processing-service/processors/base/base-processor.ts +0 -76
  348. package/src/services/asset-processing-service/processors/base/base-script-processor.ts +0 -105
  349. package/src/services/asset-processing-service/processors/index.d.ts +0 -5
  350. package/src/services/asset-processing-service/processors/index.js +0 -5
  351. package/src/services/asset-processing-service/processors/index.ts +0 -5
  352. package/src/services/asset-processing-service/processors/script/content-script.processor.ts +0 -66
  353. package/src/services/asset-processing-service/processors/script/file-script.processor.ts +0 -88
  354. package/src/services/asset-processing-service/processors/script/node-module-script.processor.ts +0 -84
  355. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
  356. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -77
  357. package/src/services/cache/cache.types.ts +0 -126
  358. package/src/services/cache/index.ts +0 -18
  359. package/src/services/cache/memory-cache-store.ts +0 -130
  360. package/src/services/cache/page-cache-service.ts +0 -202
  361. package/src/services/html-transformer.service.d.ts +0 -50
  362. package/src/services/html-transformer.service.js +0 -163
  363. package/src/services/html-transformer.service.ts +0 -217
  364. package/src/services/page-module-import.service.d.ts +0 -37
  365. package/src/services/page-module-import.service.js +0 -88
  366. package/src/services/page-module-import.service.ts +0 -129
  367. package/src/services/page-request-cache-coordinator.service.ts +0 -128
  368. package/src/services/schema-validation-service.ts +0 -204
  369. package/src/services/validation/standard-schema.types.ts +0 -68
  370. package/src/static-site-generator/static-site-generator.ts +0 -359
  371. package/src/utils/css.d.ts +0 -1
  372. package/src/utils/css.js +0 -7
  373. package/src/utils/css.ts +0 -5
  374. package/src/utils/deep-merge.ts +0 -47
  375. package/src/utils/hash.ts +0 -5
  376. package/src/utils/html.ts +0 -1
  377. package/src/utils/invariant.ts +0 -15
  378. package/src/utils/locals-utils.ts +0 -37
  379. package/src/utils/parse-cli-args.ts +0 -83
  380. package/src/utils/path-utils.module.ts +0 -14
  381. package/src/utils/runtime.ts +0 -44
  382. package/src/utils/server-utils.module.ts +0 -67
  383. package/src/watchers/project-watcher.test-helpers.ts +0 -40
  384. package/src/watchers/project-watcher.ts +0 -306
  385. /package/src/adapters/{bun → shared}/define-api-handler.js +0 -0
  386. /package/src/{internal-types.js → plugins/runtime-capability.js} +0 -0
  387. /package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.js +0 -0
  388. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.js +0 -0
  389. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.js +0 -0
  390. /package/src/{public-types.js → services/module-loading/module-loading-types.js} +0 -0
  391. /package/src/services/{schema-validation-service.js → validation/schema-validation-service.js} +0 -0
@@ -0,0 +1,554 @@
1
+ /**
2
+ * This module contains the abstract class for the Integration Renderer
3
+ * Every integration renderer should extend this class
4
+ * @module
5
+ */
6
+ import type { EcoPagesAppConfig, IHmrManager } from '../../types/internal-types.js';
7
+ import type { ComponentRenderInput, ComponentRenderResult, BoundaryRenderPayload, EcoComponent, EcoComponentDependencies, EcoPageComponent, EcoPageFile, EcoPagesElement, GetMetadata, GetMetadataContext, GetStaticProps, BaseIntegrationContext, HtmlTemplateProps, IntegrationRendererRenderOptions, PageMetadataProps, RouteRendererBody, RouteRendererOptions, RouteRenderResult } from '../../types/public-types.js';
8
+ import { type AssetProcessingService, type ProcessedAsset } from '../../services/assets/asset-processing-service/index.js';
9
+ import { HtmlTransformerService } from '../../services/html/html-transformer.service.js';
10
+ import { HttpError } from '../../errors/http-error.js';
11
+ import { DependencyResolverService } from '../page-loading/dependency-resolver.js';
12
+ import { PageModuleLoaderService } from '../page-loading/page-module-loader.js';
13
+ import { RenderExecutionService } from './render-execution.service.js';
14
+ import { RenderPreparationService } from './render-preparation.service.js';
15
+ import { RouteShellComposer } from './route-shell-composer.service.js';
16
+ import type { ComponentBoundaryRuntime } from './component-render-context.js';
17
+ import { QueuedBoundaryRuntimeService, type QueuedBoundaryResolution, type QueuedBoundaryRuntimeContext } from './queued-boundary-runtime.service.js';
18
+ type BoundaryRenderDecisionInput = {
19
+ currentIntegration: string;
20
+ targetIntegration?: string;
21
+ };
22
+ /**
23
+ * Controls how one route module is loaded outside the normal render path.
24
+ *
25
+ * Request-time metadata inspection and static-generation probes use these
26
+ * options to isolate their module identity from the main render cache while
27
+ * still going through the owning integration's import setup.
28
+ */
29
+ export type RouteModuleLoadOptions = {
30
+ bypassCache?: boolean;
31
+ cacheScope?: string;
32
+ };
33
+ /**
34
+ * Context for renderToResponse method.
35
+ */
36
+ export interface RenderToResponseContext {
37
+ partial?: boolean;
38
+ status?: number;
39
+ headers?: HeadersInit;
40
+ }
41
+ /**
42
+ * The IntegrationRenderer class is an abstract class that provides a base for rendering integration-specific components in the EcoPages framework.
43
+ * It handles the import of page files, collection of dependencies, and preparation of render options.
44
+ * The class is designed to be extended by specific integration renderers.
45
+ */
46
+ export declare abstract class IntegrationRenderer<C = EcoPagesElement> {
47
+ abstract name: string;
48
+ protected appConfig: EcoPagesAppConfig;
49
+ protected assetProcessingService: AssetProcessingService;
50
+ protected htmlTransformer: HtmlTransformerService;
51
+ protected hmrManager?: IHmrManager;
52
+ protected resolvedIntegrationDependencies: ProcessedAsset[];
53
+ protected rendererModules?: unknown;
54
+ protected options: Required<IntegrationRendererRenderOptions>;
55
+ protected runtimeOrigin: string;
56
+ protected dependencyResolverService: DependencyResolverService;
57
+ protected pageModuleLoaderService: PageModuleLoaderService;
58
+ protected renderPreparationService: RenderPreparationService;
59
+ protected renderExecutionService: RenderExecutionService;
60
+ protected readonly routeShellComposer: RouteShellComposer;
61
+ protected readonly queuedBoundaryRuntimeService: QueuedBoundaryRuntimeService;
62
+ protected DOC_TYPE: string;
63
+ /**
64
+ * Loads one route module through the owning renderer's import path.
65
+ *
66
+ * Request-time infrastructure may need page metadata such as cache strategy or
67
+ * middleware before full rendering starts. Exposing this narrow entrypoint lets
68
+ * those callers reuse integration-specific import setup instead of bypassing it
69
+ * with raw transpiler access.
70
+ */
71
+ loadPageModule(file: string, options?: RouteModuleLoadOptions): Promise<EcoPageFile>;
72
+ /**
73
+ * Reads the execution-scoped foreign renderer cache from one boundary input.
74
+ *
75
+ * Shared page/layout/document shell helpers pass one cache through
76
+ * `integrationContext` so repeated delegation to the same foreign integration
77
+ * can reuse a single initialized renderer instance during one render flow.
78
+ * The cache is deliberately scoped to the current render execution rather than
79
+ * stored on the renderer, which avoids leaking mutable integration state across
80
+ * requests while still preventing redundant renderer initialization.
81
+ *
82
+ * @param integrationContext - Optional boundary context carried with one render input.
83
+ * @returns The current execution cache when present.
84
+ */
85
+ private getBoundaryRendererCache;
86
+ private getRegisteredBoundaryOwner;
87
+ /**
88
+ * Attaches an execution-scoped foreign renderer cache to one boundary input.
89
+ *
90
+ * Foreign-owned page, layout, or document shells may delegate several times in
91
+ * the same render flow. Threading the cache through `integrationContext`
92
+ * preserves renderer reuse without changing the public boundary input contract.
93
+ * Existing integration-specific context is preserved and augmented.
94
+ *
95
+ * @param input - Original boundary render input.
96
+ * @param rendererCache - Execution-scoped renderer cache to propagate.
97
+ * @returns Boundary input augmented with the shared renderer cache.
98
+ */
99
+ private withBoundaryRendererCache;
100
+ protected getRendererModuleValue(key: string): unknown;
101
+ protected getRendererModuleString(key: string): string | undefined;
102
+ protected getRendererBootstrapDependencies(partial?: boolean): ProcessedAsset[];
103
+ setHmrManager(hmrManager: IHmrManager): void;
104
+ /**
105
+ * Build response headers with optional custom headers.
106
+ * @param contentType - The Content-Type header value
107
+ * @param customHeaders - Optional custom headers to merge
108
+ * @returns Headers object
109
+ */
110
+ protected buildHeaders(contentType: string, customHeaders?: HeadersInit): Headers;
111
+ /**
112
+ * Create an HTML Response.
113
+ * @param body - Response body (string or ReadableStream)
114
+ * @param ctx - Render context with status and headers
115
+ * @returns Response object
116
+ */
117
+ protected createHtmlResponse(body: BodyInit, ctx: RenderToResponseContext): Response;
118
+ /**
119
+ * Create an HttpError for render failures.
120
+ * @param message - Error message
121
+ * @param cause - Original error if available
122
+ * @returns HttpError with 500 status
123
+ */
124
+ protected createRenderError(message: string, cause?: unknown): HttpError;
125
+ /**
126
+ * Prepares dependencies for renderToResponse by resolving component dependencies
127
+ * and configuring the HTML transformer.
128
+ * @param view - The view component being rendered
129
+ * @param layout - Optional layout component
130
+ * @returns Resolved processed assets
131
+ */
132
+ protected prepareViewDependencies(view: EcoComponent, layout?: EcoComponent): Promise<ProcessedAsset[]>;
133
+ /**
134
+ * Merges component-scoped assets into the active HTML transformer state.
135
+ *
136
+ * Explicit page, layout, and document shell composition can produce assets at
137
+ * each boundary. This helper deduplicates those groups and folds them back into
138
+ * the transformer so downstream HTML finalization sees one canonical asset set.
139
+ *
140
+ * @param assetGroups - Optional groups of processed assets to merge.
141
+ * @returns The deduplicated asset subset contributed by this merge operation.
142
+ */
143
+ protected appendProcessedDependencies(...assetGroups: Array<readonly ProcessedAsset[] | undefined>): ProcessedAsset[];
144
+ /**
145
+ * Resolves metadata for explicit view rendering.
146
+ *
147
+ * When a view declares a `metadata()` function, that contract owns the final
148
+ * metadata for the explicit render. Otherwise the app-level default metadata is
149
+ * reused so explicit routes and page-module routes share the same fallback.
150
+ *
151
+ * @param view - View component being rendered.
152
+ * @param props - Props passed to the view.
153
+ * @returns Resolved metadata for the final document shell.
154
+ */
155
+ protected resolveViewMetadata<P>(view: EcoComponent<P>, props: P): Promise<PageMetadataProps>;
156
+ /**
157
+ * Renders one explicit view response in partial mode.
158
+ *
159
+ * Same-integration views can optionally stream or render inline via the caller's
160
+ * `renderInline()` hook. Once a view may cross integration boundaries, this
161
+ * helper routes the render through `renderComponentBoundary()` instead so mixed
162
+ * shells can reuse the execution-scoped renderer cache and resolve nested
163
+ * foreign ownership before the partial response is returned.
164
+ *
165
+ * @param input - View render options for the partial response.
166
+ * @returns HTML response for the partial render.
167
+ */
168
+ protected renderPartialViewResponse<P>(input: {
169
+ view: EcoComponent<P>;
170
+ props: P;
171
+ ctx: RenderToResponseContext;
172
+ renderInline?: () => Promise<BodyInit>;
173
+ transformHtml?: (html: string) => string;
174
+ }): Promise<Response>;
175
+ /**
176
+ * Renders an explicit view through optional layout and document shells.
177
+ *
178
+ * This helper is the shared explicit-route path for string-oriented and mixed
179
+ * integrations. It prepares view dependencies, resolves metadata, and composes
180
+ * view, layout, and html template boundaries with one execution-scoped renderer
181
+ * cache so repeated foreign shell delegation can reuse initialized renderers
182
+ * during the same render flow.
183
+ *
184
+ * @param input - View, props, and optional layout metadata for the render.
185
+ * @returns HTML response for the explicit view render.
186
+ */
187
+ protected renderViewWithDocumentShell<P>(input: {
188
+ view: EcoComponent<P>;
189
+ props: P;
190
+ ctx: RenderToResponseContext;
191
+ layout?: EcoComponent;
192
+ }): Promise<Response>;
193
+ /**
194
+ * Renders a route page through optional layout and document shells.
195
+ *
196
+ * Route rendering and explicit view rendering now share the same boundary-owned
197
+ * shell composition model. This helper composes page, layout, and html template
198
+ * boundaries while threading one execution-scoped renderer cache through every
199
+ * delegated boundary so foreign shell ownership remains stable and renderer
200
+ * initialization is reused inside the current request.
201
+ *
202
+ * @param input - Page, layout, document, and metadata inputs for the route render.
203
+ * @returns Final serialized document HTML including the doctype prefix.
204
+ */
205
+ protected renderPageWithDocumentShell(input: {
206
+ page: {
207
+ component: EcoComponent;
208
+ props: Record<string, unknown>;
209
+ };
210
+ layout?: {
211
+ component: EcoComponent;
212
+ props?: Record<string, unknown>;
213
+ };
214
+ htmlTemplate: EcoComponent;
215
+ metadata: PageMetadataProps;
216
+ pageProps: Record<string, unknown>;
217
+ documentProps?: Record<string, unknown>;
218
+ transformDocumentHtml?: (html: string) => string;
219
+ }): Promise<string>;
220
+ /**
221
+ * Renders one string-first component boundary and collects its assets.
222
+ *
223
+ * String-oriented integrations frequently share the same boundary contract:
224
+ * pass serialized children through props, coerce the render result to HTML, and
225
+ * attach any component-scoped dependencies. This helper centralizes that flow
226
+ * so integrations can opt into shared orchestration without repeating the same
227
+ * boundary boilerplate.
228
+ *
229
+ * @param input - Boundary render input.
230
+ * @param component - String-oriented component implementation to execute.
231
+ * @returns Structured component render result for orchestration paths.
232
+ */
233
+ protected renderStringComponentBoundary(input: ComponentRenderInput, component: (props: Record<string, unknown>) => Promise<EcoPagesElement> | EcoPagesElement): Promise<ComponentRenderResult>;
234
+ protected getBoundaryTokenPrefix(): string;
235
+ protected getBoundaryRuntimeContextKey(): string;
236
+ protected getQueuedBoundaryRuntime<TContext extends QueuedBoundaryRuntimeContext>(input: ComponentRenderInput, runtimeContextKey?: string): TContext | undefined;
237
+ protected resolveQueuedBoundaryTokens(html: string, queuedResolutionsByToken: Map<string, QueuedBoundaryResolution>, resolveToken: (token: string) => Promise<string>): Promise<string>;
238
+ protected createQueuedBoundaryRuntime<TContext extends QueuedBoundaryRuntimeContext>(options: {
239
+ boundaryInput: ComponentRenderInput;
240
+ rendererCache: Map<string, IntegrationRenderer<any>>;
241
+ runtimeContextKey?: string;
242
+ tokenPrefix?: string;
243
+ createRuntimeContext?: (integrationContext: BaseIntegrationContext & Record<string, unknown>, rendererCache: Map<string, unknown>) => TContext;
244
+ }): ComponentBoundaryRuntime;
245
+ protected resolveRendererOwnedQueuedBoundaryHtml<TContext extends QueuedBoundaryRuntimeContext>(options: {
246
+ html: string;
247
+ runtimeContext?: TContext;
248
+ queueLabel: string;
249
+ renderQueuedChildren: (children: unknown, runtimeContext: TContext, queuedResolutionsByToken: Map<string, QueuedBoundaryResolution>, resolveToken: (token: string) => Promise<string>) => Promise<{
250
+ assets: ProcessedAsset[];
251
+ html?: string;
252
+ }>;
253
+ }): Promise<{
254
+ assets: ProcessedAsset[];
255
+ html: string;
256
+ }>;
257
+ /**
258
+ * Renders a string-first component, then resolves any queued foreign
259
+ * boundaries before returning final component HTML.
260
+ */
261
+ protected renderStringComponentBoundaryWithQueuedForeignBoundaries(input: ComponentRenderInput, component: (props: Record<string, unknown>) => Promise<EcoPagesElement> | EcoPagesElement): Promise<ComponentRenderResult>;
262
+ constructor({ appConfig, assetProcessingService, resolvedIntegrationDependencies, rendererModules, runtimeOrigin, }: {
263
+ appConfig: EcoPagesAppConfig;
264
+ assetProcessingService: AssetProcessingService;
265
+ resolvedIntegrationDependencies?: ProcessedAsset[];
266
+ rendererModules?: unknown;
267
+ runtimeOrigin: string;
268
+ });
269
+ /**
270
+ * Returns the HTML path from the provided file path.
271
+ * It extracts the path relative to the pages directory and removes the 'index' part if present.
272
+ *
273
+ * @param file - The file path to extract the HTML path from.
274
+ * @returns The extracted HTML path.
275
+ */
276
+ protected getHtmlPath({ file }: {
277
+ file: string;
278
+ }): string;
279
+ /**
280
+ * Returns the HTML template component.
281
+ * It imports the HTML template from the specified path in the app configuration.
282
+ *
283
+ * @returns The HTML template component.
284
+ */
285
+ protected getHtmlTemplate(): Promise<EcoComponent<HtmlTemplateProps>>;
286
+ /**
287
+ * Returns the static props for the page.
288
+ * It calls the provided getStaticProps function with the given options.
289
+ *
290
+ * @param getStaticProps - The function to get static props.
291
+ * @param options - The options to pass to the getStaticProps function.
292
+ * @returns The static props and metadata.
293
+ */
294
+ protected getStaticProps(getStaticProps?: GetStaticProps<Record<string, unknown>>, options?: Pick<RouteRendererOptions, 'params'>): Promise<{
295
+ props: Record<string, unknown>;
296
+ metadata?: PageMetadataProps;
297
+ }>;
298
+ /**
299
+ * Returns the metadata properties for the page.
300
+ * It calls the provided getMetadata function with the given context.
301
+ *
302
+ * @param getMetadata - The function to get metadata.
303
+ * @param context - The context to pass to the getMetadata function.
304
+ * @returns The metadata properties.
305
+ */
306
+ protected getMetadataProps(getMetadata: GetMetadata | undefined, { props, params, query }: GetMetadataContext): Promise<PageMetadataProps>;
307
+ protected usesIntegrationPageImporter(_file: string): boolean;
308
+ protected importIntegrationPageFile(_file: string, _options?: RouteModuleLoadOptions): Promise<EcoPageFile>;
309
+ protected normalizeImportedPageFile<TPageModule extends EcoPageFile>(_file: string, pageModule: TPageModule): TPageModule;
310
+ /**
311
+ * Imports the page file from the specified path.
312
+ * It uses dynamic import to load the file and returns the imported module.
313
+ *
314
+ * @param file - The file path to import.
315
+ * @returns The imported module.
316
+ */
317
+ protected importPageFile(file: string, options?: RouteModuleLoadOptions): Promise<EcoPageFile>;
318
+ /**
319
+ * Resolves the dependency path based on the component directory.
320
+ * It combines the component directory with the provided path URL.
321
+ *
322
+ * @param componentDir - The component directory path.
323
+ * @param pathUrl - The path URL to resolve.
324
+ * @returns The resolved dependency path.
325
+ */
326
+ protected resolveDependencyPath(componentDir: string, pathUrl: string): string;
327
+ /**
328
+ * Extracts the dependencies from the provided component configuration.
329
+ * It resolves the paths for scripts and stylesheets based on the component directory.
330
+ *
331
+ * @param componentDir - The component directory path.
332
+ * @param scripts - The scripts to extract.
333
+ * @param stylesheets - The stylesheets to extract.
334
+ * @returns The extracted dependencies.
335
+ */
336
+ protected extractDependencies({ componentDir, scripts, stylesheets, }: {
337
+ componentDir: string;
338
+ } & EcoComponentDependencies): EcoComponentDependencies;
339
+ /**
340
+ * Resolves lazy script paths to public asset URLs.
341
+ * Converts source paths to their final bundled output paths.
342
+ *
343
+ * @param componentDir - The component directory path.
344
+ * @param scripts - The lazy script paths to resolve.
345
+ * @returns Comma-separated string of resolved public script paths.
346
+ */
347
+ protected resolveLazyScripts(componentDir: string, scripts: string[]): string;
348
+ /**
349
+ * Collects the dependencies for the provided components.
350
+ * Combines component-specific dependencies with global integration dependencies.
351
+ *
352
+ * @param components - The components to collect dependencies from.
353
+ */
354
+ protected resolveDependencies(components: (EcoComponent | Partial<EcoComponent>)[]): Promise<ProcessedAsset[]>;
355
+ /**
356
+ * Processes component-specific dependencies WITHOUT prepending global integration dependencies.
357
+ * Use this method when you need only the component's own assets.
358
+ *
359
+ * @param components - The components to collect dependencies from.
360
+ */
361
+ protected processComponentDependencies(components: (EcoComponent | Partial<EcoComponent>)[]): Promise<ProcessedAsset[]>;
362
+ /**
363
+ * Prepares the render options for the integration renderer.
364
+ * It imports the page file, collects dependencies, and prepares the render options.
365
+ *
366
+ * @param options - The route renderer options.
367
+ * @returns The prepared render options.
368
+ */
369
+ protected prepareRenderOptions(options: RouteRendererOptions): Promise<IntegrationRendererRenderOptions>;
370
+ /**
371
+ * Controls whether the page root should be rendered through `renderComponent()`
372
+ * during route option preparation in component-capable modes.
373
+ *
374
+ * Integrations that already own page-level hydration (for example router-driven
375
+ * React rendering) can override this and return `false` to avoid duplicate root
376
+ * mount assets and competing hydration entrypoints.
377
+ */
378
+ protected shouldRenderPageComponent(_input: {
379
+ Page: EcoComponent;
380
+ Layout?: EcoComponent;
381
+ options: RouteRendererOptions;
382
+ }): boolean;
383
+ /**
384
+ * Resolves the page module and normalizes exports.
385
+ */
386
+ protected resolvePageModule(file: string): Promise<{
387
+ Page: EcoPageFile['default'] | EcoPageComponent<any>;
388
+ getStaticProps?: GetStaticProps<Record<string, unknown>>;
389
+ getMetadata?: GetMetadata;
390
+ integrationSpecificProps: Record<string, unknown>;
391
+ }>;
392
+ /**
393
+ * Resolves static props and metadata for the page.
394
+ */
395
+ protected resolvePageData(pageModule: {
396
+ getStaticProps?: GetStaticProps<Record<string, unknown>>;
397
+ getMetadata?: GetMetadata;
398
+ }, options: RouteRendererOptions): Promise<{
399
+ props: Record<string, unknown>;
400
+ metadata: PageMetadataProps;
401
+ }>;
402
+ /**
403
+ * Executes the integration renderer with the provided options.
404
+ *
405
+ * Execution flow:
406
+ * 1. Build normalized render options (`prepareRenderOptions`).
407
+ * 2. Render the route body once.
408
+ * 3. Reject unresolved route-level boundary artifacts.
409
+ * 4. Optionally apply root attributes for page/component root boundaries.
410
+ * 5. Run HTML transformer with final dependency set.
411
+ *
412
+ * Stream-safety note: the first render result is normalized to a string once,
413
+ * then the pipeline continues with that immutable HTML value to avoid disturbed
414
+ * response-body errors.
415
+ *
416
+ * @param options Route renderer options.
417
+ * @returns Rendered route body plus effective cache strategy.
418
+ */
419
+ execute(options: RouteRendererOptions): Promise<RouteRenderResult>;
420
+ /**
421
+ * Finalizes already-resolved HTML for explicit renderer-owned paths.
422
+ *
423
+ * This keeps document and root-attribute stamping plus HTML transformation
424
+ * available after a renderer has completed nested boundary resolution without
425
+ * routing back through shared route execution.
426
+ */
427
+ protected finalizeResolvedHtml(options: {
428
+ html: string;
429
+ partial?: boolean;
430
+ componentRootAttributes?: Record<string, string>;
431
+ documentAttributes?: Record<string, string>;
432
+ transformHtml?: boolean;
433
+ }): Promise<string>;
434
+ /**
435
+ * Returns document-level attributes to stamp onto the rendered `<html>` tag.
436
+ *
437
+ * Integrations can override this to expose explicit document ownership or
438
+ * other runtime coordination markers without relying on script sniffing.
439
+ */
440
+ protected getDocumentAttributes(_renderOptions: IntegrationRendererRenderOptions<C>): Record<string, string> | undefined;
441
+ /**
442
+ * Returns a renderer instance for a given integration name.
443
+ *
444
+ * Uses a per-execution cache to avoid repeated renderer initialization.
445
+ *
446
+ * @param integrationName Target integration name.
447
+ * @param cache Render-pass renderer cache.
448
+ * @returns Renderer for the requested integration.
449
+ * @throws Error when no integration plugin matches `integrationName`.
450
+ */
451
+ private getIntegrationRendererForName;
452
+ /**
453
+ * Abstract method to render the integration-specific component.
454
+ * This method should be implemented by the specific integration renderer.
455
+ *
456
+ * @param options - The integration renderer render options.
457
+ * @returns The rendered body.
458
+ */
459
+ abstract render(options: IntegrationRendererRenderOptions<C>): Promise<RouteRendererBody>;
460
+ protected resolveBoundaryInOwningRenderer(input: ComponentRenderInput, rendererCache: Map<string, IntegrationRenderer<any>>): Promise<ComponentRenderResult | undefined>;
461
+ protected resolveBoundaryPayloadInOwningRenderer(input: ComponentRenderInput, rendererCache: Map<string, IntegrationRenderer<any>>): Promise<BoundaryRenderPayload | undefined>;
462
+ /**
463
+ * Renders one component under this integration's boundary runtime and resolves
464
+ * any nested foreign boundaries captured during that render.
465
+ *
466
+ * Without this wrapper, a component tree with foreign-owned descendants would
467
+ * render them with no active boundary runtime, which bypasses the owning
468
+ * renderer's nested-boundary handoff.
469
+ */
470
+ renderComponentBoundary(input: ComponentRenderInput): Promise<ComponentRenderResult>;
471
+ /**
472
+ * Compatibility boundary contract that exposes a narrower payload shape for
473
+ * future route-composition work while preserving the current
474
+ * `renderComponentBoundary()` runtime semantics.
475
+ */
476
+ renderBoundary(input: ComponentRenderInput): Promise<BoundaryRenderPayload>;
477
+ private normalizeComponentBoundaryRender;
478
+ protected normalizeBoundaryArtifactHtml(html: string): string;
479
+ /**
480
+ * Returns whether the component dependency tree crosses into another
481
+ * integration.
482
+ *
483
+ * This keeps boundary-runtime setup narrow: same-integration trees can render
484
+ * directly without paying the queue orchestration cost.
485
+ */
486
+ protected hasForeignBoundaryDescendants(component: EcoComponent): boolean;
487
+ /**
488
+ * Render a view directly to a Response object.
489
+ * Used for explicit routing where views are rendered from route handlers.
490
+ *
491
+ * @param view - The eco.page component to render
492
+ * @param props - Props to pass to the view
493
+ * @param ctx - Render context with partial flag and response options
494
+ * @returns A Response object with the rendered content
495
+ */
496
+ abstract renderToResponse<P = Record<string, unknown>>(view: EcoComponent<P>, props: P, ctx: RenderToResponseContext): Promise<Response>;
497
+ /**
498
+ * Render a single component and return structured output for orchestration paths.
499
+ *
500
+ * Default behavior delegates to `renderToResponse` in partial mode and wraps
501
+ * the resulting HTML into the `ComponentRenderResult` contract.
502
+ *
503
+ * In boundary resolution, this method is the integration-owned step that turns an
504
+ * already-resolved deferred boundary into concrete HTML, assets, and optional
505
+ * root attributes.
506
+ *
507
+ * Integrations can override this for richer behavior (asset emission,
508
+ * root attributes, integration-specific hydration metadata).
509
+ *
510
+ * @param input Component render request.
511
+ * @returns Structured render result used by component/page orchestration.
512
+ */
513
+ renderComponent(input: ComponentRenderInput): Promise<ComponentRenderResult>;
514
+ /**
515
+ * Extracts the first root element tag name from HTML output.
516
+ *
517
+ * @param html HTML fragment.
518
+ * @returns Root tag name when present; otherwise `undefined`.
519
+ */
520
+ protected getRootTagName(html: string): string | undefined;
521
+ /**
522
+ * Method to build route render assets.
523
+ * This method can be optionally overridden by the specific integration renderer.
524
+ *
525
+ * @param file - The file path to build assets for.
526
+ * @returns The processed assets or undefined.
527
+ */
528
+ protected buildRouteRenderAssets(_file: string): Promise<ProcessedAsset[]> | undefined;
529
+ /**
530
+ * Creates the per-render boundary runtime adopted by the shared component
531
+ * render context.
532
+ *
533
+ * Real mixed-integration renderers should override this and keep foreign
534
+ * boundary resolution inside their own renderer-owned queue. The base runtime
535
+ * fails fast when a renderer crosses into a foreign owner without providing its
536
+ * own handoff mechanism.
537
+ */
538
+ protected createComponentBoundaryRuntime(_options: {
539
+ boundaryInput: ComponentRenderInput;
540
+ rendererCache: Map<string, IntegrationRenderer<any>>;
541
+ }): ComponentBoundaryRuntime;
542
+ /**
543
+ * Resolves whether a boundary should leave the current render pass and be
544
+ * resolved by its owning renderer.
545
+ *
546
+ * Boundaries owned by the current integration always render inline. Foreign-
547
+ * owned boundaries must be handed off by a renderer-owned runtime.
548
+ *
549
+ * @param input Boundary metadata for the active render pass.
550
+ * @returns `true` when the boundary should leave the current pass; otherwise `false`.
551
+ */
552
+ protected shouldResolveBoundaryInOwningRenderer(input: BoundaryRenderDecisionInput): boolean;
553
+ }
554
+ export {};