@ecopages/core 0.2.0-alpha.1

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 (342) hide show
  1. package/CHANGELOG.md +89 -0
  2. package/LICENSE +21 -0
  3. package/README.md +32 -0
  4. package/package.json +279 -0
  5. package/src/adapters/abstract/application-adapter.d.ts +168 -0
  6. package/src/adapters/abstract/application-adapter.js +109 -0
  7. package/src/adapters/abstract/application-adapter.ts +337 -0
  8. package/src/adapters/abstract/router-adapter.d.ts +26 -0
  9. package/src/adapters/abstract/router-adapter.js +5 -0
  10. package/src/adapters/abstract/router-adapter.ts +30 -0
  11. package/src/adapters/abstract/server-adapter.d.ts +69 -0
  12. package/src/adapters/abstract/server-adapter.js +15 -0
  13. package/src/adapters/abstract/server-adapter.ts +79 -0
  14. package/src/adapters/bun/client-bridge.d.ts +34 -0
  15. package/src/adapters/bun/client-bridge.js +48 -0
  16. package/src/adapters/bun/client-bridge.ts +62 -0
  17. package/src/adapters/bun/create-app.d.ts +60 -0
  18. package/src/adapters/bun/create-app.js +117 -0
  19. package/src/adapters/bun/create-app.ts +189 -0
  20. package/src/adapters/bun/define-api-handler.d.ts +61 -0
  21. package/src/adapters/bun/define-api-handler.js +15 -0
  22. package/src/adapters/bun/define-api-handler.ts +114 -0
  23. package/src/adapters/bun/hmr-manager.d.ts +84 -0
  24. package/src/adapters/bun/hmr-manager.js +227 -0
  25. package/src/adapters/bun/hmr-manager.ts +281 -0
  26. package/src/adapters/bun/index.d.ts +3 -0
  27. package/src/adapters/bun/index.js +8 -0
  28. package/src/adapters/bun/index.ts +3 -0
  29. package/src/adapters/bun/server-adapter.d.ts +155 -0
  30. package/src/adapters/bun/server-adapter.js +368 -0
  31. package/src/adapters/bun/server-adapter.ts +492 -0
  32. package/src/adapters/bun/server-lifecycle.d.ts +52 -0
  33. package/src/adapters/bun/server-lifecycle.js +120 -0
  34. package/src/adapters/bun/server-lifecycle.ts +154 -0
  35. package/src/adapters/index.d.ts +6 -0
  36. package/src/adapters/index.js +14 -0
  37. package/src/adapters/index.ts +6 -0
  38. package/src/adapters/node/create-app.d.ts +21 -0
  39. package/src/adapters/node/create-app.js +143 -0
  40. package/src/adapters/node/create-app.ts +179 -0
  41. package/src/adapters/node/index.d.ts +4 -0
  42. package/src/adapters/node/index.js +8 -0
  43. package/src/adapters/node/index.ts +9 -0
  44. package/src/adapters/node/node-client-bridge.d.ts +26 -0
  45. package/src/adapters/node/node-client-bridge.js +66 -0
  46. package/src/adapters/node/node-client-bridge.ts +79 -0
  47. package/src/adapters/node/node-hmr-manager.d.ts +62 -0
  48. package/src/adapters/node/node-hmr-manager.js +221 -0
  49. package/src/adapters/node/node-hmr-manager.ts +271 -0
  50. package/src/adapters/node/server-adapter.d.ts +190 -0
  51. package/src/adapters/node/server-adapter.js +420 -0
  52. package/src/adapters/node/server-adapter.ts +561 -0
  53. package/src/adapters/node/static-content-server.d.ts +24 -0
  54. package/src/adapters/node/static-content-server.js +166 -0
  55. package/src/adapters/node/static-content-server.ts +203 -0
  56. package/src/adapters/shared/api-response.d.ts +52 -0
  57. package/src/adapters/shared/api-response.js +96 -0
  58. package/src/adapters/shared/api-response.ts +104 -0
  59. package/src/adapters/shared/application-adapter.d.ts +18 -0
  60. package/src/adapters/shared/application-adapter.js +90 -0
  61. package/src/adapters/shared/application-adapter.ts +199 -0
  62. package/src/adapters/shared/explicit-static-route-matcher.d.ts +38 -0
  63. package/src/adapters/shared/explicit-static-route-matcher.js +100 -0
  64. package/src/adapters/shared/explicit-static-route-matcher.ts +134 -0
  65. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +65 -0
  66. package/src/adapters/shared/file-route-middleware-pipeline.js +98 -0
  67. package/src/adapters/shared/file-route-middleware-pipeline.ts +123 -0
  68. package/src/adapters/shared/fs-server-response-factory.d.ts +19 -0
  69. package/src/adapters/shared/fs-server-response-factory.js +97 -0
  70. package/src/adapters/shared/fs-server-response-factory.ts +118 -0
  71. package/src/adapters/shared/fs-server-response-matcher.d.ts +71 -0
  72. package/src/adapters/shared/fs-server-response-matcher.js +155 -0
  73. package/src/adapters/shared/fs-server-response-matcher.ts +198 -0
  74. package/src/adapters/shared/render-context.d.ts +14 -0
  75. package/src/adapters/shared/render-context.js +69 -0
  76. package/src/adapters/shared/render-context.ts +105 -0
  77. package/src/adapters/shared/server-adapter.d.ts +87 -0
  78. package/src/adapters/shared/server-adapter.js +353 -0
  79. package/src/adapters/shared/server-adapter.ts +442 -0
  80. package/src/adapters/shared/server-route-handler.d.ts +89 -0
  81. package/src/adapters/shared/server-route-handler.js +120 -0
  82. package/src/adapters/shared/server-route-handler.ts +166 -0
  83. package/src/adapters/shared/server-static-builder.d.ts +38 -0
  84. package/src/adapters/shared/server-static-builder.js +46 -0
  85. package/src/adapters/shared/server-static-builder.ts +82 -0
  86. package/src/build/build-adapter.d.ts +74 -0
  87. package/src/build/build-adapter.js +54 -0
  88. package/src/build/build-adapter.ts +132 -0
  89. package/src/build/build-types.d.ts +57 -0
  90. package/src/build/build-types.js +0 -0
  91. package/src/build/build-types.ts +83 -0
  92. package/src/build/esbuild-build-adapter.d.ts +69 -0
  93. package/src/build/esbuild-build-adapter.js +390 -0
  94. package/src/build/esbuild-build-adapter.ts +510 -0
  95. package/src/config/config-builder.d.ts +227 -0
  96. package/src/config/config-builder.js +392 -0
  97. package/src/config/config-builder.ts +474 -0
  98. package/src/constants.d.ts +32 -0
  99. package/src/constants.js +21 -0
  100. package/src/constants.ts +39 -0
  101. package/src/create-app.d.ts +17 -0
  102. package/src/create-app.js +66 -0
  103. package/src/create-app.ts +87 -0
  104. package/src/declarations.d.ts +26 -0
  105. package/src/define-api-handler.d.ts +25 -0
  106. package/src/define-api-handler.js +15 -0
  107. package/src/define-api-handler.ts +66 -0
  108. package/src/dev/sc-server.d.ts +30 -0
  109. package/src/dev/sc-server.js +111 -0
  110. package/src/dev/sc-server.ts +143 -0
  111. package/src/eco/README.md +636 -0
  112. package/src/eco/component-render-context.d.ts +105 -0
  113. package/src/eco/component-render-context.js +77 -0
  114. package/src/eco/component-render-context.ts +202 -0
  115. package/src/eco/eco.d.ts +9 -0
  116. package/src/eco/eco.js +110 -0
  117. package/src/eco/eco.ts +221 -0
  118. package/src/eco/eco.types.d.ts +170 -0
  119. package/src/eco/eco.types.js +0 -0
  120. package/src/eco/eco.types.ts +202 -0
  121. package/src/eco/eco.utils.d.ts +40 -0
  122. package/src/eco/eco.utils.js +40 -0
  123. package/src/eco/eco.utils.ts +89 -0
  124. package/src/eco/global-injector-map.d.ts +16 -0
  125. package/src/eco/global-injector-map.js +80 -0
  126. package/src/eco/global-injector-map.ts +112 -0
  127. package/src/eco/lazy-injector-map.d.ts +8 -0
  128. package/src/eco/lazy-injector-map.js +70 -0
  129. package/src/eco/lazy-injector-map.ts +120 -0
  130. package/src/eco/module-dependencies.d.ts +18 -0
  131. package/src/eco/module-dependencies.js +49 -0
  132. package/src/eco/module-dependencies.ts +75 -0
  133. package/src/env.d.ts +20 -0
  134. package/src/errors/http-error.d.ts +31 -0
  135. package/src/errors/http-error.js +50 -0
  136. package/src/errors/http-error.ts +72 -0
  137. package/src/errors/index.d.ts +2 -0
  138. package/src/errors/index.js +4 -0
  139. package/src/errors/index.ts +2 -0
  140. package/src/errors/locals-access-error.d.ts +4 -0
  141. package/src/errors/locals-access-error.js +9 -0
  142. package/src/errors/locals-access-error.ts +7 -0
  143. package/src/global/app-logger.d.ts +2 -0
  144. package/src/global/app-logger.js +6 -0
  145. package/src/global/app-logger.ts +4 -0
  146. 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
  147. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  148. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  149. package/src/hmr/client/hmr-runtime.d.ts +10 -0
  150. package/src/hmr/client/hmr-runtime.js +86 -0
  151. package/src/hmr/client/hmr-runtime.ts +121 -0
  152. package/src/hmr/hmr-strategy.d.ts +159 -0
  153. package/src/hmr/hmr-strategy.js +29 -0
  154. package/src/hmr/hmr-strategy.ts +172 -0
  155. package/src/hmr/hmr.test.e2e.d.ts +1 -0
  156. package/src/hmr/hmr.test.e2e.js +50 -0
  157. package/src/hmr/hmr.test.e2e.ts +75 -0
  158. package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
  159. package/src/hmr/strategies/default-hmr-strategy.js +34 -0
  160. package/src/hmr/strategies/default-hmr-strategy.ts +60 -0
  161. package/src/hmr/strategies/js-hmr-strategy.d.ts +136 -0
  162. package/src/hmr/strategies/js-hmr-strategy.js +179 -0
  163. package/src/hmr/strategies/js-hmr-strategy.ts +308 -0
  164. package/src/index.browser.d.ts +3 -0
  165. package/src/index.browser.js +4 -0
  166. package/src/index.browser.ts +3 -0
  167. package/src/index.d.ts +5 -0
  168. package/src/index.js +10 -0
  169. package/src/index.ts +5 -0
  170. package/src/integrations/ghtml/ghtml-renderer.d.ts +15 -0
  171. package/src/integrations/ghtml/ghtml-renderer.js +60 -0
  172. package/src/integrations/ghtml/ghtml-renderer.ts +93 -0
  173. package/src/integrations/ghtml/ghtml.plugin.d.ts +20 -0
  174. package/src/integrations/ghtml/ghtml.plugin.js +21 -0
  175. package/src/integrations/ghtml/ghtml.plugin.ts +32 -0
  176. package/src/internal-types.d.ts +200 -0
  177. package/src/internal-types.js +0 -0
  178. package/src/internal-types.ts +212 -0
  179. package/src/plugins/alias-resolver-plugin.d.ts +2 -0
  180. package/src/plugins/alias-resolver-plugin.js +39 -0
  181. package/src/plugins/alias-resolver-plugin.ts +45 -0
  182. package/src/plugins/eco-component-meta-plugin.d.ts +95 -0
  183. package/src/plugins/eco-component-meta-plugin.js +157 -0
  184. package/src/plugins/eco-component-meta-plugin.ts +474 -0
  185. package/src/plugins/integration-plugin.d.ts +102 -0
  186. package/src/plugins/integration-plugin.js +100 -0
  187. package/src/plugins/integration-plugin.ts +184 -0
  188. package/src/plugins/processor.d.ts +82 -0
  189. package/src/plugins/processor.js +122 -0
  190. package/src/plugins/processor.ts +220 -0
  191. package/src/public-types.d.ts +1094 -0
  192. package/src/public-types.js +0 -0
  193. package/src/public-types.ts +1255 -0
  194. package/src/route-renderer/GRAPH.md +387 -0
  195. package/src/route-renderer/README.md +135 -0
  196. package/src/route-renderer/component-graph-executor.d.ts +32 -0
  197. package/src/route-renderer/component-graph-executor.js +31 -0
  198. package/src/route-renderer/component-graph-executor.ts +84 -0
  199. package/src/route-renderer/component-graph.d.ts +42 -0
  200. package/src/route-renderer/component-graph.js +72 -0
  201. package/src/route-renderer/component-graph.ts +159 -0
  202. package/src/route-renderer/component-marker.d.ts +52 -0
  203. package/src/route-renderer/component-marker.js +46 -0
  204. package/src/route-renderer/component-marker.ts +117 -0
  205. package/src/route-renderer/dependency-resolver.d.ts +24 -0
  206. package/src/route-renderer/dependency-resolver.js +428 -0
  207. package/src/route-renderer/dependency-resolver.ts +596 -0
  208. package/src/route-renderer/html-post-processing.service.d.ts +40 -0
  209. package/src/route-renderer/html-post-processing.service.js +86 -0
  210. package/src/route-renderer/html-post-processing.service.ts +103 -0
  211. package/src/route-renderer/integration-renderer.d.ts +339 -0
  212. package/src/route-renderer/integration-renderer.js +526 -0
  213. package/src/route-renderer/integration-renderer.ts +696 -0
  214. package/src/route-renderer/marker-graph-resolver.d.ts +76 -0
  215. package/src/route-renderer/marker-graph-resolver.js +93 -0
  216. package/src/route-renderer/marker-graph-resolver.ts +153 -0
  217. package/src/route-renderer/page-module-loader.d.ts +61 -0
  218. package/src/route-renderer/page-module-loader.js +102 -0
  219. package/src/route-renderer/page-module-loader.ts +153 -0
  220. package/src/route-renderer/render-execution.service.d.ts +69 -0
  221. package/src/route-renderer/render-execution.service.js +91 -0
  222. package/src/route-renderer/render-execution.service.ts +158 -0
  223. package/src/route-renderer/render-preparation.service.d.ts +112 -0
  224. package/src/route-renderer/render-preparation.service.js +243 -0
  225. package/src/route-renderer/render-preparation.service.ts +358 -0
  226. package/src/route-renderer/route-renderer.d.ts +26 -0
  227. package/src/route-renderer/route-renderer.js +68 -0
  228. package/src/route-renderer/route-renderer.ts +80 -0
  229. package/src/router/fs-router-scanner.d.ts +41 -0
  230. package/src/router/fs-router-scanner.js +155 -0
  231. package/src/router/fs-router-scanner.ts +217 -0
  232. package/src/router/fs-router.d.ts +26 -0
  233. package/src/router/fs-router.js +100 -0
  234. package/src/router/fs-router.ts +122 -0
  235. package/src/services/asset-processing-service/asset-processing.service.d.ts +41 -0
  236. package/src/services/asset-processing-service/asset-processing.service.js +250 -0
  237. package/src/services/asset-processing-service/asset-processing.service.ts +306 -0
  238. package/src/services/asset-processing-service/asset.factory.d.ts +17 -0
  239. package/src/services/asset-processing-service/asset.factory.js +82 -0
  240. package/src/services/asset-processing-service/asset.factory.ts +105 -0
  241. package/src/services/asset-processing-service/assets.types.d.ts +88 -0
  242. package/src/services/asset-processing-service/assets.types.js +0 -0
  243. package/src/services/asset-processing-service/assets.types.ts +112 -0
  244. package/src/services/asset-processing-service/index.d.ts +3 -0
  245. package/src/services/asset-processing-service/index.js +3 -0
  246. package/src/services/asset-processing-service/index.ts +3 -0
  247. package/src/services/asset-processing-service/processor.interface.d.ts +22 -0
  248. package/src/services/asset-processing-service/processor.interface.js +6 -0
  249. package/src/services/asset-processing-service/processor.interface.ts +27 -0
  250. package/src/services/asset-processing-service/processor.registry.d.ts +8 -0
  251. package/src/services/asset-processing-service/processor.registry.js +15 -0
  252. package/src/services/asset-processing-service/processor.registry.ts +18 -0
  253. package/src/services/asset-processing-service/processors/base/base-processor.d.ts +24 -0
  254. package/src/services/asset-processing-service/processors/base/base-processor.js +59 -0
  255. package/src/services/asset-processing-service/processors/base/base-processor.ts +76 -0
  256. package/src/services/asset-processing-service/processors/base/base-script-processor.d.ts +16 -0
  257. package/src/services/asset-processing-service/processors/base/base-script-processor.js +80 -0
  258. package/src/services/asset-processing-service/processors/base/base-script-processor.ts +105 -0
  259. package/src/services/asset-processing-service/processors/index.d.ts +5 -0
  260. package/src/services/asset-processing-service/processors/index.js +5 -0
  261. package/src/services/asset-processing-service/processors/index.ts +5 -0
  262. package/src/services/asset-processing-service/processors/script/content-script.processor.d.ts +5 -0
  263. package/src/services/asset-processing-service/processors/script/content-script.processor.js +57 -0
  264. package/src/services/asset-processing-service/processors/script/content-script.processor.ts +66 -0
  265. package/src/services/asset-processing-service/processors/script/file-script.processor.d.ts +8 -0
  266. package/src/services/asset-processing-service/processors/script/file-script.processor.js +76 -0
  267. package/src/services/asset-processing-service/processors/script/file-script.processor.ts +88 -0
  268. package/src/services/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
  269. package/src/services/asset-processing-service/processors/script/node-module-script.processor.js +74 -0
  270. package/src/services/asset-processing-service/processors/script/node-module-script.processor.ts +84 -0
  271. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +5 -0
  272. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +25 -0
  273. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +27 -0
  274. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
  275. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +63 -0
  276. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +77 -0
  277. package/src/services/cache/cache.types.d.ts +107 -0
  278. package/src/services/cache/cache.types.js +0 -0
  279. package/src/services/cache/cache.types.ts +126 -0
  280. package/src/services/cache/index.d.ts +7 -0
  281. package/src/services/cache/index.js +7 -0
  282. package/src/services/cache/index.ts +18 -0
  283. package/src/services/cache/memory-cache-store.d.ts +42 -0
  284. package/src/services/cache/memory-cache-store.js +98 -0
  285. package/src/services/cache/memory-cache-store.ts +130 -0
  286. package/src/services/cache/page-cache-service.d.ts +70 -0
  287. package/src/services/cache/page-cache-service.js +152 -0
  288. package/src/services/cache/page-cache-service.ts +202 -0
  289. package/src/services/html-transformer.service.d.ts +50 -0
  290. package/src/services/html-transformer.service.js +163 -0
  291. package/src/services/html-transformer.service.ts +217 -0
  292. package/src/services/page-module-import.service.d.ts +37 -0
  293. package/src/services/page-module-import.service.js +88 -0
  294. package/src/services/page-module-import.service.ts +129 -0
  295. package/src/services/page-request-cache-coordinator.service.d.ts +75 -0
  296. package/src/services/page-request-cache-coordinator.service.js +107 -0
  297. package/src/services/page-request-cache-coordinator.service.ts +128 -0
  298. package/src/services/schema-validation-service.d.ts +122 -0
  299. package/src/services/schema-validation-service.js +101 -0
  300. package/src/services/schema-validation-service.ts +204 -0
  301. package/src/services/validation/standard-schema.types.d.ts +65 -0
  302. package/src/services/validation/standard-schema.types.js +0 -0
  303. package/src/services/validation/standard-schema.types.ts +68 -0
  304. package/src/static-site-generator/static-site-generator.d.ts +57 -0
  305. package/src/static-site-generator/static-site-generator.js +272 -0
  306. package/src/static-site-generator/static-site-generator.ts +359 -0
  307. package/src/utils/css.d.ts +1 -0
  308. package/src/utils/css.js +7 -0
  309. package/src/utils/css.ts +5 -0
  310. package/src/utils/deep-merge.d.ts +14 -0
  311. package/src/utils/deep-merge.js +32 -0
  312. package/src/utils/deep-merge.ts +47 -0
  313. package/src/utils/hash.d.ts +1 -0
  314. package/src/utils/hash.js +7 -0
  315. package/src/utils/hash.ts +5 -0
  316. package/src/utils/html.d.ts +1 -0
  317. package/src/utils/html.js +4 -0
  318. package/src/utils/html.ts +1 -0
  319. package/src/utils/invariant.d.ts +5 -0
  320. package/src/utils/invariant.js +11 -0
  321. package/src/utils/invariant.ts +15 -0
  322. package/src/utils/locals-utils.d.ts +15 -0
  323. package/src/utils/locals-utils.js +24 -0
  324. package/src/utils/locals-utils.ts +37 -0
  325. package/src/utils/parse-cli-args.d.ts +24 -0
  326. package/src/utils/parse-cli-args.js +47 -0
  327. package/src/utils/parse-cli-args.ts +83 -0
  328. package/src/utils/path-utils.module.d.ts +5 -0
  329. package/src/utils/path-utils.module.js +14 -0
  330. package/src/utils/path-utils.module.ts +14 -0
  331. package/src/utils/runtime.d.ts +11 -0
  332. package/src/utils/runtime.js +40 -0
  333. package/src/utils/runtime.ts +44 -0
  334. package/src/utils/server-utils.module.d.ts +19 -0
  335. package/src/utils/server-utils.module.js +56 -0
  336. package/src/utils/server-utils.module.ts +67 -0
  337. package/src/watchers/project-watcher.d.ts +120 -0
  338. package/src/watchers/project-watcher.js +238 -0
  339. package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
  340. package/src/watchers/project-watcher.test-helpers.js +51 -0
  341. package/src/watchers/project-watcher.test-helpers.ts +40 -0
  342. package/src/watchers/project-watcher.ts +306 -0
package/src/route-renderer/html-post-processing.service.js ADDED
@@ -0,0 +1,86 @@
1
+ class HtmlPostProcessingService {
2
+ /**
3
+ * Applies attributes to the first element immediately inside the document
4
+ * `<body>`.
5
+ *
6
+ * @param html Full HTML document.
7
+ * @param attributes Attribute map to inject.
8
+ * @returns Updated HTML document.
9
+ */
10
+ applyAttributesToFirstBodyElement(html, attributes) {
11
+ const bodyMatch = html.match(/<body\b[^>]*>/i);
12
+ if (!bodyMatch || bodyMatch.index === void 0) {
13
+ return html;
14
+ }
15
+ const bodyOpenEnd = bodyMatch.index + bodyMatch[0].length;
16
+ const afterBody = html.slice(bodyOpenEnd);
17
+ const firstTagMatch = afterBody.match(/^(\s*<)([a-zA-Z][a-zA-Z0-9:-]*)(\b[^>]*>)/);
18
+ if (!firstTagMatch || firstTagMatch.index === void 0) {
19
+ return html;
20
+ }
21
+ const attrs = this.buildAttributeString(attributes);
22
+ if (attrs.length === 0) {
23
+ return html;
24
+ }
25
+ const injectionOffset = bodyOpenEnd + firstTagMatch[1].length + firstTagMatch[2].length;
26
+ return `${html.slice(0, injectionOffset)}${attrs}${html.slice(injectionOffset)}`;
27
+ }
28
+ /**
29
+ * Applies attributes to the first top-level element in an HTML fragment.
30
+ *
31
+ * @param html HTML fragment.
32
+ * @param attributes Attribute map to inject.
33
+ * @returns Updated HTML fragment.
34
+ */
35
+ applyAttributesToFirstElement(html, attributes) {
36
+ const firstTagMatch = html.match(/^(\s*<)([a-zA-Z][a-zA-Z0-9:-]*)(\b[^>]*>)/);
37
+ if (!firstTagMatch || firstTagMatch.index === void 0) {
38
+ return html;
39
+ }
40
+ const attrs = this.buildAttributeString(attributes);
41
+ if (attrs.length === 0) {
42
+ return html;
43
+ }
44
+ const injectionOffset = firstTagMatch[1].length + firstTagMatch[2].length;
45
+ return `${html.slice(0, injectionOffset)}${attrs}${html.slice(injectionOffset)}`;
46
+ }
47
+ /**
48
+ * Deduplicates processed assets using a stable composite key while preserving
49
+ * first-seen order.
50
+ *
51
+ * @param assets Candidate processed assets.
52
+ * @returns Deduplicated processed asset list.
53
+ */
54
+ dedupeProcessedAssets(assets) {
55
+ const unique = /* @__PURE__ */ new Map();
56
+ for (const asset of assets) {
57
+ const key = [
58
+ asset.kind,
59
+ asset.position ?? "",
60
+ asset.srcUrl ?? "",
61
+ asset.filepath ?? "",
62
+ asset.content ?? "",
63
+ asset.inline ? "inline" : "external",
64
+ asset.excludeFromHtml ? "excluded" : "included",
65
+ JSON.stringify(asset.attributes ?? {})
66
+ ].join("|");
67
+ if (!unique.has(key)) {
68
+ unique.set(key, asset);
69
+ }
70
+ }
71
+ return [...unique.values()];
72
+ }
73
+ /**
74
+ * Converts an attribute map into an HTML attribute string, skipping empty
75
+ * keys and values.
76
+ *
77
+ * @param attributes Attribute map to serialize.
78
+ * @returns Serialized attributes prefixed with spaces.
79
+ */
80
+ buildAttributeString(attributes) {
81
+ return Object.entries(attributes).filter(([key, value]) => key.length > 0 && value.length > 0).map(([key, value]) => ` ${key}="${value}"`).join("");
82
+ }
83
+ }
84
+ export {
85
+ HtmlPostProcessingService
86
+ };
package/src/route-renderer/html-post-processing.service.ts ADDED
@@ -0,0 +1,103 @@
1
+ import type { ProcessedAsset } from '../services/asset-processing-service/index.ts';
2
+
3
+ /**
4
+ * Encapsulates HTML mutation and processed-asset normalization helpers used in
5
+ * the final stages of route rendering.
6
+ */
7
+ export class HtmlPostProcessingService {
8
+ /**
9
+ * Applies attributes to the first element immediately inside the document
10
+ * `<body>`.
11
+ *
12
+ * @param html Full HTML document.
13
+ * @param attributes Attribute map to inject.
14
+ * @returns Updated HTML document.
15
+ */
16
+ applyAttributesToFirstBodyElement(html: string, attributes: Record<string, string>): string {
17
+ const bodyMatch = html.match(/<body\b[^>]*>/i);
18
+ if (!bodyMatch || bodyMatch.index === undefined) {
19
+ return html;
20
+ }
21
+
22
+ const bodyOpenEnd = bodyMatch.index + bodyMatch[0].length;
23
+ const afterBody = html.slice(bodyOpenEnd);
24
+ const firstTagMatch = afterBody.match(/^(\s*<)([a-zA-Z][a-zA-Z0-9:-]*)(\b[^>]*>)/);
25
+ if (!firstTagMatch || firstTagMatch.index === undefined) {
26
+ return html;
27
+ }
28
+
29
+ const attrs = this.buildAttributeString(attributes);
30
+ if (attrs.length === 0) {
31
+ return html;
32
+ }
33
+
34
+ const injectionOffset = bodyOpenEnd + firstTagMatch[1].length + firstTagMatch[2].length;
35
+ return `${html.slice(0, injectionOffset)}${attrs}${html.slice(injectionOffset)}`;
36
+ }
37
+
38
+ /**
39
+ * Applies attributes to the first top-level element in an HTML fragment.
40
+ *
41
+ * @param html HTML fragment.
42
+ * @param attributes Attribute map to inject.
43
+ * @returns Updated HTML fragment.
44
+ */
45
+ applyAttributesToFirstElement(html: string, attributes: Record<string, string>): string {
46
+ const firstTagMatch = html.match(/^(\s*<)([a-zA-Z][a-zA-Z0-9:-]*)(\b[^>]*>)/);
47
+ if (!firstTagMatch || firstTagMatch.index === undefined) {
48
+ return html;
49
+ }
50
+
51
+ const attrs = this.buildAttributeString(attributes);
52
+ if (attrs.length === 0) {
53
+ return html;
54
+ }
55
+
56
+ const injectionOffset = firstTagMatch[1].length + firstTagMatch[2].length;
57
+ return `${html.slice(0, injectionOffset)}${attrs}${html.slice(injectionOffset)}`;
58
+ }
59
+
60
+ /**
61
+ * Deduplicates processed assets using a stable composite key while preserving
62
+ * first-seen order.
63
+ *
64
+ * @param assets Candidate processed assets.
65
+ * @returns Deduplicated processed asset list.
66
+ */
67
+ dedupeProcessedAssets(assets: ProcessedAsset[]): ProcessedAsset[] {
68
+ const unique = new Map<string, ProcessedAsset>();
69
+
70
+ for (const asset of assets) {
71
+ const key = [
72
+ asset.kind,
73
+ asset.position ?? '',
74
+ asset.srcUrl ?? '',
75
+ asset.filepath ?? '',
76
+ asset.content ?? '',
77
+ asset.inline ? 'inline' : 'external',
78
+ asset.excludeFromHtml ? 'excluded' : 'included',
79
+ JSON.stringify(asset.attributes ?? {}),
80
+ ].join('|');
81
+
82
+ if (!unique.has(key)) {
83
+ unique.set(key, asset);
84
+ }
85
+ }
86
+
87
+ return [...unique.values()];
88
+ }
89
+
90
+ /**
91
+ * Converts an attribute map into an HTML attribute string, skipping empty
92
+ * keys and values.
93
+ *
94
+ * @param attributes Attribute map to serialize.
95
+ * @returns Serialized attributes prefixed with spaces.
96
+ */
97
+ private buildAttributeString(attributes: Record<string, string>): string {
98
+ return Object.entries(attributes)
99
+ .filter(([key, value]) => key.length > 0 && value.length > 0)
100
+ .map(([key, value]) => ` ${key}="${value}"`)
101
+ .join('');
102
+ }
103
+ }
package/src/route-renderer/integration-renderer.d.ts ADDED
@@ -0,0 +1,339 @@
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 '../internal-types.js';
7
+ import type { ComponentRenderInput, ComponentRenderResult, EcoComponent, EcoComponentDependencies, EcoPageComponent, EcoPageFile, EcoPagesElement, GetMetadata, GetMetadataContext, GetStaticProps, HtmlTemplateProps, IntegrationRendererRenderOptions, PageMetadataProps, RouteRendererBody, RouteRendererOptions, RouteRenderResult } from '../public-types.js';
8
+ import { type AssetProcessingService, type ProcessedAsset } from '../services/asset-processing-service/index.js';
9
+ import { HtmlTransformerService } from '../services/html-transformer.service.js';
10
+ import { HttpError } from '../errors/http-error.js';
11
+ import { DependencyResolverService } from './dependency-resolver.js';
12
+ import { HtmlPostProcessingService } from './html-post-processing.service.js';
13
+ import { PageModuleLoaderService } from './page-module-loader.js';
14
+ import { MarkerGraphResolver } from './marker-graph-resolver.js';
15
+ import { RenderExecutionService } from './render-execution.service.js';
16
+ import { RenderPreparationService } from './render-preparation.service.js';
17
+ import type { BoundaryRenderDecisionInput, ComponentRenderBoundaryContext } from '../eco/component-render-context.js';
18
+ /**
19
+ * Context for renderToResponse method.
20
+ */
21
+ export interface RenderToResponseContext {
22
+ partial?: boolean;
23
+ status?: number;
24
+ headers?: HeadersInit;
25
+ }
26
+ /**
27
+ * The IntegrationRenderer class is an abstract class that provides a base for rendering integration-specific components in the EcoPages framework.
28
+ * It handles the import of page files, collection of dependencies, and preparation of render options.
29
+ * The class is designed to be extended by specific integration renderers.
30
+ */
31
+ export declare abstract class IntegrationRenderer<C = EcoPagesElement> {
32
+ abstract name: string;
33
+ protected appConfig: EcoPagesAppConfig;
34
+ protected assetProcessingService: AssetProcessingService;
35
+ protected htmlTransformer: HtmlTransformerService;
36
+ protected hmrManager?: IHmrManager;
37
+ protected resolvedIntegrationDependencies: ProcessedAsset[];
38
+ protected options: Required<IntegrationRendererRenderOptions>;
39
+ protected runtimeOrigin: string;
40
+ protected dependencyResolverService: DependencyResolverService;
41
+ protected pageModuleLoaderService: PageModuleLoaderService;
42
+ protected markerGraphResolver: MarkerGraphResolver;
43
+ protected renderPreparationService: RenderPreparationService;
44
+ protected htmlPostProcessingService: HtmlPostProcessingService;
45
+ protected renderExecutionService: RenderExecutionService;
46
+ protected DOC_TYPE: string;
47
+ setHmrManager(hmrManager: IHmrManager): void;
48
+ /**
49
+ * Build response headers with optional custom headers.
50
+ * @param contentType - The Content-Type header value
51
+ * @param customHeaders - Optional custom headers to merge
52
+ * @returns Headers object
53
+ */
54
+ protected buildHeaders(contentType: string, customHeaders?: HeadersInit): Headers;
55
+ /**
56
+ * Create an HTML Response.
57
+ * @param body - Response body (string or ReadableStream)
58
+ * @param ctx - Render context with status and headers
59
+ * @returns Response object
60
+ */
61
+ protected createHtmlResponse(body: BodyInit, ctx: RenderToResponseContext): Response;
62
+ /**
63
+ * Create an HttpError for render failures.
64
+ * @param message - Error message
65
+ * @param cause - Original error if available
66
+ * @returns HttpError with 500 status
67
+ */
68
+ protected createRenderError(message: string, cause?: unknown): HttpError;
69
+ /**
70
+ * Prepares dependencies for renderToResponse by resolving component dependencies
71
+ * and configuring the HTML transformer.
72
+ * @param view - The view component being rendered
73
+ * @param layout - Optional layout component
74
+ * @returns Resolved processed assets
75
+ */
76
+ protected prepareViewDependencies(view: EcoComponent, layout?: EcoComponent): Promise<ProcessedAsset[]>;
77
+ constructor({ appConfig, assetProcessingService, resolvedIntegrationDependencies, runtimeOrigin, }: {
78
+ appConfig: EcoPagesAppConfig;
79
+ assetProcessingService: AssetProcessingService;
80
+ resolvedIntegrationDependencies?: ProcessedAsset[];
81
+ runtimeOrigin: string;
82
+ });
83
+ /**
84
+ * Returns the HTML path from the provided file path.
85
+ * It extracts the path relative to the pages directory and removes the 'index' part if present.
86
+ *
87
+ * @param file - The file path to extract the HTML path from.
88
+ * @returns The extracted HTML path.
89
+ */
90
+ protected getHtmlPath({ file }: {
91
+ file: string;
92
+ }): string;
93
+ /**
94
+ * Returns the HTML template component.
95
+ * It imports the HTML template from the specified path in the app configuration.
96
+ *
97
+ * @returns The HTML template component.
98
+ */
99
+ protected getHtmlTemplate(): Promise<EcoComponent<HtmlTemplateProps>>;
100
+ /**
101
+ * Returns the static props for the page.
102
+ * It calls the provided getStaticProps function with the given options.
103
+ *
104
+ * @param getStaticProps - The function to get static props.
105
+ * @param options - The options to pass to the getStaticProps function.
106
+ * @returns The static props and metadata.
107
+ */
108
+ protected getStaticProps(getStaticProps?: GetStaticProps<Record<string, unknown>>, options?: Pick<RouteRendererOptions, 'params'>): Promise<{
109
+ props: Record<string, unknown>;
110
+ metadata?: PageMetadataProps;
111
+ }>;
112
+ /**
113
+ * Returns the metadata properties for the page.
114
+ * It calls the provided getMetadata function with the given context.
115
+ *
116
+ * @param getMetadata - The function to get metadata.
117
+ * @param context - The context to pass to the getMetadata function.
118
+ * @returns The metadata properties.
119
+ */
120
+ protected getMetadataProps(getMetadata: GetMetadata | undefined, { props, params, query }: GetMetadataContext): Promise<PageMetadataProps>;
121
+ /**
122
+ * Imports the page file from the specified path.
123
+ * It uses dynamic import to load the file and returns the imported module.
124
+ *
125
+ * @param file - The file path to import.
126
+ * @returns The imported module.
127
+ */
128
+ protected importPageFile(file: string): Promise<EcoPageFile>;
129
+ /**
130
+ * Resolves the dependency path based on the component directory.
131
+ * It combines the component directory with the provided path URL.
132
+ *
133
+ * @param componentDir - The component directory path.
134
+ * @param pathUrl - The path URL to resolve.
135
+ * @returns The resolved dependency path.
136
+ */
137
+ protected resolveDependencyPath(componentDir: string, pathUrl: string): string;
138
+ /**
139
+ * Extracts the dependencies from the provided component configuration.
140
+ * It resolves the paths for scripts and stylesheets based on the component directory.
141
+ *
142
+ * @param componentDir - The component directory path.
143
+ * @param scripts - The scripts to extract.
144
+ * @param stylesheets - The stylesheets to extract.
145
+ * @returns The extracted dependencies.
146
+ */
147
+ protected extractDependencies({ componentDir, scripts, stylesheets, }: {
148
+ componentDir: string;
149
+ } & EcoComponentDependencies): EcoComponentDependencies;
150
+ /**
151
+ * Resolves lazy script paths to public asset URLs.
152
+ * Converts source paths to their final bundled output paths.
153
+ *
154
+ * @param componentDir - The component directory path.
155
+ * @param scripts - The lazy script paths to resolve.
156
+ * @returns Comma-separated string of resolved public script paths.
157
+ */
158
+ protected resolveLazyScripts(componentDir: string, scripts: string[]): string;
159
+ /**
160
+ * Collects the dependencies for the provided components.
161
+ * Combines component-specific dependencies with global integration dependencies.
162
+ *
163
+ * @param components - The components to collect dependencies from.
164
+ */
165
+ protected resolveDependencies(components: (EcoComponent | Partial<EcoComponent>)[]): Promise<ProcessedAsset[]>;
166
+ /**
167
+ * Processes component-specific dependencies WITHOUT prepending global integration dependencies.
168
+ * Use this method when you need only the component's own assets.
169
+ *
170
+ * @param components - The components to collect dependencies from.
171
+ */
172
+ protected processComponentDependencies(components: (EcoComponent | Partial<EcoComponent>)[]): Promise<ProcessedAsset[]>;
173
+ /**
174
+ * Prepares the render options for the integration renderer.
175
+ * It imports the page file, collects dependencies, and prepares the render options.
176
+ *
177
+ * @param options - The route renderer options.
178
+ * @returns The prepared render options.
179
+ */
180
+ protected prepareRenderOptions(options: RouteRendererOptions): Promise<IntegrationRendererRenderOptions>;
181
+ /**
182
+ * Controls whether the page root should be rendered through `renderComponent()`
183
+ * during route option preparation in component-capable modes.
184
+ *
185
+ * Integrations that already own page-level hydration (for example router-driven
186
+ * React rendering) can override this and return `false` to avoid duplicate root
187
+ * mount assets and competing hydration entrypoints.
188
+ */
189
+ protected shouldRenderPageComponent(_input: {
190
+ Page: EcoComponent;
191
+ Layout?: EcoComponent;
192
+ options: RouteRendererOptions;
193
+ }): boolean;
194
+ /**
195
+ * Resolves the page module and normalizes exports.
196
+ */
197
+ protected resolvePageModule(file: string): Promise<{
198
+ Page: EcoPageFile['default'] | EcoPageComponent<any>;
199
+ getStaticProps?: GetStaticProps<Record<string, unknown>>;
200
+ getMetadata?: GetMetadata;
201
+ integrationSpecificProps: Record<string, unknown>;
202
+ }>;
203
+ /**
204
+ * Resolves static props and metadata for the page.
205
+ */
206
+ protected resolvePageData(pageModule: {
207
+ getStaticProps?: GetStaticProps<Record<string, unknown>>;
208
+ getMetadata?: GetMetadata;
209
+ }, options: RouteRendererOptions): Promise<{
210
+ props: Record<string, unknown>;
211
+ metadata: PageMetadataProps;
212
+ }>;
213
+ /**
214
+ * Executes the integration renderer with the provided options.
215
+ *
216
+ * Execution flow:
217
+ * 1. Build normalized render options (`prepareRenderOptions`).
218
+ * 2. Render once inside component render context to capture marker graph refs.
219
+ * 3. Merge captured refs with optional explicit page-module graph context.
220
+ * 4. Resolve any `eco-marker` graph bottom-up and merge produced assets.
221
+ * 5. Optionally apply root attributes for page/component root boundaries.
222
+ * 6. Run HTML transformer with final dependency set.
223
+ *
224
+ * Stream-safety note: the first render result is normalized to a string once,
225
+ * then the pipeline continues with that immutable HTML value to avoid disturbed
226
+ * response-body errors.
227
+ *
228
+ * @param options Route renderer options.
229
+ * @returns Rendered route body plus effective cache strategy.
230
+ */
231
+ execute(options: RouteRendererOptions): Promise<RouteRenderResult>;
232
+ /**
233
+ * Resolves all `eco-marker` placeholders in rendered HTML using integration
234
+ * dispatch and bottom-up graph execution.
235
+ *
236
+ * Responsibility split:
237
+ * - core decodes markers into component refs, props, slot children, and target
238
+ * integration dispatch
239
+ * - the selected integration renderer performs the actual component render via
240
+ * `renderComponent()`
241
+ *
242
+ * Resolver callback behavior per marker:
243
+ * - resolve component definition by `componentRef`
244
+ * - resolve serialized props by `propsRef`
245
+ * - stitch resolved child HTML when `slotRef` is present
246
+ * - dispatch to target integration `renderComponent`
247
+ * - collect produced assets and apply root attributes when attachable
248
+ *
249
+ * @param options.html HTML that may still contain marker tokens.
250
+ * @param options.componentsToResolve Component set used to build component ref registry.
251
+ * @param options.graphContext Props/slot linkage captured during render.
252
+ * @returns Resolved HTML plus any component-scoped assets produced while resolving nodes.
253
+ * @throws Error when marker component refs or props refs cannot be resolved.
254
+ */
255
+ private resolveMarkerGraphHtml;
256
+ /**
257
+ * Returns a renderer instance for a given integration name.
258
+ *
259
+ * Uses a per-execution cache to avoid repeated renderer initialization.
260
+ *
261
+ * @param integrationName Target integration name.
262
+ * @param cache Render-pass renderer cache.
263
+ * @returns Renderer for the requested integration.
264
+ * @throws Error when no integration plugin matches `integrationName`.
265
+ */
266
+ private getIntegrationRendererForName;
267
+ /**
268
+ * Abstract method to render the integration-specific component.
269
+ * This method should be implemented by the specific integration renderer.
270
+ *
271
+ * @param options - The integration renderer render options.
272
+ * @returns The rendered body.
273
+ */
274
+ abstract render(options: IntegrationRendererRenderOptions<C>): Promise<RouteRendererBody>;
275
+ /**
276
+ * Render a view directly to a Response object.
277
+ * Used for explicit routing where views are rendered from route handlers.
278
+ *
279
+ * @param view - The eco.page component to render
280
+ * @param props - Props to pass to the view
281
+ * @param ctx - Render context with partial flag and response options
282
+ * @returns A Response object with the rendered content
283
+ */
284
+ abstract renderToResponse<P = Record<string, unknown>>(view: EcoComponent<P>, props: P, ctx: RenderToResponseContext): Promise<Response>;
285
+ /**
286
+ * Render a single component and return structured output for orchestration paths.
287
+ *
288
+ * Default behavior delegates to `renderToResponse` in partial mode and wraps
289
+ * the resulting HTML into the `ComponentRenderResult` contract.
290
+ *
291
+ * In marker resolution, this method is the integration-owned step that turns an
292
+ * already-resolved deferred boundary into concrete HTML, assets, and optional
293
+ * root attributes.
294
+ *
295
+ * Integrations can override this for richer behavior (asset emission,
296
+ * root attributes, integration-specific hydration metadata).
297
+ *
298
+ * @param input Component render request.
299
+ * @returns Structured render result used by marker/page orchestration.
300
+ */
301
+ renderComponent(input: ComponentRenderInput): Promise<ComponentRenderResult>;
302
+ /**
303
+ * Extracts the first root element tag name from HTML output.
304
+ *
305
+ * @param html HTML fragment.
306
+ * @returns Root tag name when present; otherwise `undefined`.
307
+ */
308
+ protected getRootTagName(html: string): string | undefined;
309
+ /**
310
+ * Method to build route render assets.
311
+ * This method can be optionally overridden by the specific integration renderer.
312
+ *
313
+ * @param file - The file path to build assets for.
314
+ * @returns The processed assets or undefined.
315
+ */
316
+ protected buildRouteRenderAssets(_file: string): Promise<ProcessedAsset[]> | undefined;
317
+ /**
318
+ * Builds the narrow boundary policy facade injected into component render
319
+ * context for this render pass.
320
+ *
321
+ * `eco.component()` consumes this facade without knowing about integration
322
+ * registries or plugin instances.
323
+ *
324
+ * @returns Boundary policy context for the active integration renderer.
325
+ */
326
+ protected getComponentRenderBoundaryContext(): ComponentRenderBoundaryContext;
327
+ /**
328
+ * Resolves whether a component boundary should be deferred by consulting the
329
+ * target integration plugin.
330
+ *
331
+ * Boundaries targeting the current integration always render inline. Cross-
332
+ * integration boundaries delegate the decision to the target integration's
333
+ * `shouldDeferComponentBoundary()` policy.
334
+ *
335
+ * @param input Boundary metadata for the active render pass.
336
+ * @returns `true` when the boundary should emit a marker; otherwise `false`.
337
+ */
338
+ protected shouldDeferComponentBoundary(input: BoundaryRenderDecisionInput): boolean;
339
+ }