@ecopages/core 0.2.0-alpha.9 → 0.2.1-beta.0

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 (471) hide show
  1. package/README.md +79 -28
  2. package/package.json +94 -116
  3. package/src/adapters/README.md +2 -2
  4. package/src/adapters/abstract/application-adapter.d.ts +28 -2
  5. package/src/adapters/abstract/application-adapter.js +14 -2
  6. package/src/adapters/abstract/router-adapter.d.ts +1 -1
  7. package/src/adapters/abstract/server-adapter.d.ts +2 -2
  8. package/src/adapters/bun/client-bridge.d.ts +1 -1
  9. package/src/adapters/bun/create-app.d.ts +12 -12
  10. package/src/adapters/bun/create-app.js +64 -41
  11. package/src/adapters/bun/hmr-manager.d.ts +19 -115
  12. package/src/adapters/bun/hmr-manager.js +25 -301
  13. package/src/adapters/bun/index.d.ts +1 -1
  14. package/src/adapters/bun/index.js +2 -2
  15. package/src/adapters/bun/runtime-host.d.ts +52 -0
  16. package/src/adapters/bun/runtime-host.js +56 -0
  17. package/src/adapters/bun/server-adapter.d.ts +100 -32
  18. package/src/adapters/bun/server-adapter.js +142 -65
  19. package/src/adapters/bun/static-preview-host.d.ts +28 -0
  20. package/src/adapters/bun/static-preview-host.js +45 -0
  21. package/src/{create-app.d.ts → adapters/create-app.d.ts} +9 -6
  22. package/src/{create-app.js → adapters/create-app.js} +4 -4
  23. package/src/adapters/index.d.ts +1 -5
  24. package/src/adapters/index.js +1 -7
  25. package/src/adapters/node/create-app.d.ts +15 -12
  26. package/src/adapters/node/create-app.js +34 -85
  27. package/src/adapters/node/http-request-bridge.d.ts +57 -0
  28. package/src/adapters/node/http-request-bridge.js +118 -0
  29. package/src/adapters/node/node-client-bridge.d.ts +1 -1
  30. package/src/adapters/node/node-hmr-manager.d.ts +22 -103
  31. package/src/adapters/node/node-hmr-manager.js +26 -289
  32. package/src/adapters/node/runtime-host.d.ts +57 -0
  33. package/src/adapters/node/runtime-host.js +92 -0
  34. package/src/adapters/node/server-adapter-dependencies.d.ts +19 -0
  35. package/src/adapters/node/server-adapter-dependencies.js +18 -0
  36. package/src/adapters/node/server-adapter.d.ts +19 -42
  37. package/src/adapters/node/server-adapter.js +94 -139
  38. package/src/adapters/node/static-content-server.d.ts +1 -1
  39. package/src/adapters/node/static-content-server.js +1 -1
  40. package/src/adapters/node/static-preview-host.d.ts +55 -0
  41. package/src/adapters/node/static-preview-host.js +68 -0
  42. package/src/adapters/shared/application-adapter.d.ts +1 -1
  43. package/src/adapters/shared/define-api-handler.d.ts +1 -1
  44. package/src/adapters/shared/explicit-static-render-preparation.d.ts +25 -0
  45. package/src/adapters/shared/explicit-static-render-preparation.js +26 -0
  46. package/src/adapters/shared/explicit-static-route-matcher.d.ts +7 -4
  47. package/src/adapters/shared/explicit-static-route-matcher.js +14 -16
  48. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +7 -10
  49. package/src/adapters/shared/file-route-middleware-pipeline.js +2 -11
  50. package/src/adapters/shared/fs-server-response-factory.d.ts +14 -10
  51. package/src/adapters/shared/fs-server-response-factory.js +11 -27
  52. package/src/adapters/shared/fs-server-response-matcher.d.ts +18 -18
  53. package/src/adapters/shared/fs-server-response-matcher.js +72 -46
  54. package/src/adapters/shared/hmr-entrypoint-registrar.js +1 -1
  55. package/src/adapters/shared/hmr-html-response.d.ts +1 -1
  56. package/src/adapters/shared/hmr-html-response.js +4 -3
  57. package/src/adapters/shared/render-context.d.ts +5 -3
  58. package/src/adapters/shared/render-context.js +24 -1
  59. package/src/adapters/shared/runtime-app-bootstrap.d.ts +26 -0
  60. package/src/adapters/shared/runtime-app-bootstrap.js +46 -0
  61. package/src/adapters/shared/runtime-host.d.ts +12 -0
  62. package/src/adapters/shared/server-adapter.d.ts +22 -11
  63. package/src/adapters/shared/server-adapter.js +183 -133
  64. package/src/adapters/shared/server-route-handler.d.ts +5 -5
  65. package/src/adapters/shared/server-route-handler.js +4 -4
  66. package/src/adapters/shared/server-static-builder.d.ts +8 -7
  67. package/src/adapters/shared/server-static-builder.js +6 -5
  68. package/src/adapters/shared/shared-hmr-manager.d.ts +59 -0
  69. package/src/adapters/shared/shared-hmr-manager.js +241 -0
  70. package/src/adapters/shared/static-preview-host.d.ts +10 -0
  71. package/src/build/README.md +57 -67
  72. package/src/build/browser-runtime-manifest.d.ts +31 -0
  73. package/src/build/browser-runtime-manifest.js +61 -0
  74. package/src/build/browser-runtime-plugin-helpers.d.ts +26 -0
  75. package/src/build/browser-runtime-plugin-helpers.js +14 -0
  76. package/src/build/browser-runtime-plugin.d.ts +78 -0
  77. package/src/build/browser-runtime-plugin.js +173 -0
  78. package/src/build/build-adapter.d.ts +384 -63
  79. package/src/build/build-adapter.js +129 -54
  80. package/src/build/build-manifest.d.ts +6 -0
  81. package/src/build/build-manifest.js +21 -2
  82. package/src/build/build-types.d.ts +2 -2
  83. package/src/build/rolldown-adapter-helpers.d.ts +58 -0
  84. package/src/build/rolldown-adapter-helpers.js +265 -0
  85. package/src/build/rolldown-build-adapter.d.ts +28 -0
  86. package/src/build/rolldown-build-adapter.js +65 -0
  87. package/src/build/rolldown-dev-build-adapter.d.ts +82 -0
  88. package/src/build/rolldown-dev-build-adapter.js +166 -0
  89. package/src/build/rolldown-plugin-bridge.d.ts +59 -0
  90. package/src/build/rolldown-plugin-bridge.js +199 -0
  91. package/src/build/runtime-build-executor.d.ts +15 -7
  92. package/src/build/runtime-build-executor.js +8 -9
  93. package/src/build/runtime-build-output-normalizer.d.ts +3 -0
  94. package/src/build/runtime-build-output-normalizer.js +111 -0
  95. package/src/build/serialized-build-executor.d.ts +64 -0
  96. package/src/build/serialized-build-executor.js +63 -0
  97. package/src/build/server-side-css-shim-plugin.d.ts +41 -0
  98. package/src/build/server-side-css-shim-plugin.js +35 -0
  99. package/src/cache/index.d.ts +6 -0
  100. package/src/cache/index.js +6 -0
  101. package/src/cache/module-parse-cache.d.ts +65 -0
  102. package/src/cache/module-parse-cache.js +75 -0
  103. package/src/config/README.md +5 -2
  104. package/src/config/config-builder.d.ts +41 -13
  105. package/src/config/config-builder.js +62 -24
  106. package/src/declarations.d.ts +1 -1
  107. package/src/dev/host-runtime.d.ts +10 -0
  108. package/src/dev/host-runtime.js +24 -0
  109. package/src/dev/sc-server.d.ts +1 -1
  110. package/src/dev/sc-server.js +1 -1
  111. package/src/eco/eco.browser.d.ts +2 -0
  112. package/src/eco/eco.browser.js +88 -0
  113. package/src/eco/eco.js +50 -45
  114. package/src/eco/eco.types.d.ts +60 -8
  115. package/src/eco/eco.utils.d.ts +1 -40
  116. package/src/eco/eco.utils.js +5 -35
  117. package/src/eco/global-injector-map.d.ts +3 -3
  118. package/src/eco/global-injector-map.js +2 -2
  119. package/src/eco/lazy-injector-map.d.ts +2 -2
  120. package/src/errors/index.d.ts +1 -0
  121. package/src/errors/index.js +3 -1
  122. package/src/hmr/client/hmr-runtime.js +9 -1
  123. package/src/hmr/hmr-strategy.d.ts +16 -13
  124. package/src/hmr/hmr-strategy.js +22 -7
  125. package/src/hmr/strategies/default-hmr-strategy.d.ts +2 -2
  126. package/src/hmr/strategies/default-hmr-strategy.js +1 -1
  127. package/src/hmr/strategies/js-hmr-strategy.d.ts +4 -9
  128. package/src/hmr/strategies/js-hmr-strategy.js +5 -10
  129. package/src/index.browser.d.ts +2 -2
  130. package/src/index.browser.js +1 -1
  131. package/src/index.d.ts +3 -2
  132. package/src/index.js +15 -4
  133. package/src/integrations/ghtml/ghtml-renderer.d.ts +2 -1
  134. package/src/integrations/ghtml/ghtml-renderer.js +24 -29
  135. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  136. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  137. package/src/integrations/ghtml/ghtml.plugin.d.ts +2 -6
  138. package/src/integrations/ghtml/ghtml.plugin.js +3 -4
  139. package/src/plugins/README.md +1 -0
  140. package/src/plugins/alias-resolver-cache.d.ts +68 -0
  141. package/src/plugins/alias-resolver-cache.js +106 -0
  142. package/src/plugins/alias-resolver-plugin.d.ts +5 -1
  143. package/src/plugins/alias-resolver-plugin.js +19 -7
  144. package/src/plugins/eco-component-meta-plugin.d.ts +12 -1
  145. package/src/plugins/eco-component-meta-plugin.js +43 -25
  146. package/src/plugins/foreign-jsx-override-plugin.d.ts +33 -0
  147. package/src/plugins/foreign-jsx-override-plugin.js +41 -0
  148. package/src/plugins/integration-plugin.d.ts +136 -42
  149. package/src/plugins/integration-plugin.js +99 -31
  150. package/src/plugins/processor.d.ts +4 -2
  151. package/src/plugins/processor.js +8 -3
  152. package/src/plugins/source-transform.d.ts +46 -0
  153. package/src/plugins/source-transform.js +71 -0
  154. package/src/route-renderer/GRAPH.md +80 -318
  155. package/src/route-renderer/README.md +74 -78
  156. package/src/route-renderer/orchestration/component-render-context.d.ts +97 -0
  157. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  158. package/src/route-renderer/orchestration/declared-ownership-graph.d.ts +18 -0
  159. package/src/route-renderer/orchestration/declared-ownership-graph.js +34 -0
  160. package/src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts +110 -0
  161. package/src/route-renderer/orchestration/foreign-subtree-execution.service.js +233 -0
  162. package/src/route-renderer/orchestration/integration-renderer.d.ts +290 -128
  163. package/src/route-renderer/orchestration/integration-renderer.js +660 -258
  164. package/src/route-renderer/orchestration/ownership-planning.service.d.ts +24 -0
  165. package/src/route-renderer/orchestration/ownership-planning.service.js +63 -0
  166. package/src/route-renderer/orchestration/ownership-validation.service.d.ts +29 -0
  167. package/src/route-renderer/orchestration/ownership-validation.service.js +53 -0
  168. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +3 -0
  169. package/src/route-renderer/orchestration/processed-asset-dedupe.js +27 -0
  170. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.d.ts +91 -0
  171. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.js +170 -0
  172. package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
  173. package/src/route-renderer/orchestration/render-output.utils.js +171 -0
  174. package/src/route-renderer/orchestration/route-render-orchestrator.d.ts +156 -0
  175. package/src/route-renderer/orchestration/route-render-orchestrator.js +577 -0
  176. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  177. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  178. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
  179. package/src/route-renderer/page-loading/component-dependency-collection.js +132 -0
  180. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
  181. package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
  182. package/src/route-renderer/page-loading/dependency-resolver.d.ts +2 -2
  183. package/src/route-renderer/page-loading/dependency-resolver.js +27 -354
  184. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
  185. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
  186. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
  187. package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
  188. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
  189. package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
  190. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
  191. package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
  192. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
  193. package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
  194. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
  195. package/src/route-renderer/page-loading/page-dependency-bundling.js +137 -0
  196. package/src/route-renderer/page-loading/page-module-loader.d.ts +7 -4
  197. package/src/route-renderer/page-loading/page-module-loader.js +8 -5
  198. package/src/route-renderer/route-renderer.d.ts +31 -23
  199. package/src/route-renderer/route-renderer.js +17 -24
  200. package/src/router/README.md +76 -8
  201. package/src/router/client/navigation-coordinator.d.ts +20 -0
  202. package/src/router/client/navigation-coordinator.js +2 -2
  203. package/src/router/server/route-registry.d.ts +78 -0
  204. package/src/router/server/route-registry.js +262 -0
  205. package/src/services/README.md +1 -2
  206. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
  207. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
  208. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +3 -20
  209. package/src/services/assets/asset-processing-service/asset-processing.service.js +52 -98
  210. package/src/services/assets/asset-processing-service/asset.factory.d.ts +1 -1
  211. package/src/services/assets/asset-processing-service/asset.factory.js +2 -2
  212. package/src/services/assets/asset-processing-service/assets.types.d.ts +14 -0
  213. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +2 -0
  214. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +1 -0
  215. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
  216. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
  217. package/src/services/assets/asset-processing-service/index.d.ts +6 -5
  218. package/src/services/assets/asset-processing-service/index.js +6 -5
  219. package/src/services/assets/asset-processing-service/page-package.d.ts +6 -0
  220. package/src/services/assets/asset-processing-service/page-package.js +80 -0
  221. package/src/services/assets/asset-processing-service/processor.interface.d.ts +2 -2
  222. package/src/services/assets/asset-processing-service/processor.registry.d.ts +2 -2
  223. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +1 -1
  224. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +3 -2
  225. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +10 -5
  226. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +69 -5
  227. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -5
  228. package/src/services/assets/asset-processing-service/processors/index.js +5 -5
  229. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +3 -2
  230. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +66 -3
  231. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +4 -3
  232. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +27 -6
  233. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +38 -3
  234. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +57 -6
  235. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +5 -2
  236. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +39 -5
  237. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
  238. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +5 -2
  239. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
  240. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
  241. package/src/services/assets/browser-bundle.service.d.ts +44 -3
  242. package/src/services/assets/browser-bundle.service.js +15 -7
  243. package/src/services/html/html-rewriter-provider.service.d.ts +3 -0
  244. package/src/services/html/html-rewriter-provider.service.js +4 -1
  245. package/src/services/html/html-transformer.service.d.ts +22 -3
  246. package/src/services/html/html-transformer.service.js +101 -35
  247. package/src/services/invalidation/development-invalidation.service.d.ts +1 -1
  248. package/src/services/invalidation/development-invalidation.service.js +1 -0
  249. package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
  250. package/src/services/module-loading/app-module-loader.service.js +0 -0
  251. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +9 -1
  252. package/src/services/module-loading/app-server-module-transpiler.service.js +102 -6
  253. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  254. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  255. package/src/services/module-loading/module-loading-types.d.ts +2 -0
  256. package/src/services/module-loading/module-loading-types.js +0 -0
  257. package/src/services/module-loading/page-module-import.service.d.ts +32 -8
  258. package/src/services/module-loading/page-module-import.service.js +83 -22
  259. package/src/services/module-loading/server-module-transpiler.service.d.ts +8 -14
  260. package/src/services/module-loading/server-module-transpiler.service.js +5 -2
  261. package/src/services/module-loading/source-module-support.d.ts +5 -0
  262. package/src/services/module-loading/source-module-support.js +8 -0
  263. package/src/services/runtime-state/dev-graph.service.d.ts +6 -6
  264. package/src/services/runtime-state/dev-graph.service.js +10 -10
  265. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +1 -1
  266. package/src/services/runtime-state/server-invalidation-state.service.d.ts +1 -1
  267. package/src/static-site-generator/static-site-generator.d.ts +23 -28
  268. package/src/static-site-generator/static-site-generator.js +119 -156
  269. package/src/{internal-types.d.ts → types/internal-types.d.ts} +34 -23
  270. package/src/types/internal-types.js +0 -0
  271. package/src/{public-types.d.ts → types/public-types.d.ts} +195 -37
  272. package/src/types/public-types.js +0 -0
  273. package/src/utils/html-escaping.d.ts +7 -0
  274. package/src/utils/html-escaping.js +6 -0
  275. package/src/utils/locals-utils.d.ts +1 -1
  276. package/src/utils/parse-cli-args.d.ts +4 -1
  277. package/src/utils/parse-cli-args.js +16 -1
  278. package/src/utils/resolve-work-dir.js +1 -1
  279. package/src/watchers/project-watcher.d.ts +4 -4
  280. package/src/watchers/project-watcher.js +35 -41
  281. package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
  282. package/src/watchers/project-watcher.test-helpers.js +5 -5
  283. package/CHANGELOG.md +0 -31
  284. package/src/adapters/abstract/application-adapter.ts +0 -337
  285. package/src/adapters/abstract/router-adapter.ts +0 -30
  286. package/src/adapters/abstract/server-adapter.ts +0 -79
  287. package/src/adapters/bun/client-bridge.ts +0 -62
  288. package/src/adapters/bun/create-app.ts +0 -189
  289. package/src/adapters/bun/hmr-manager.ts +0 -409
  290. package/src/adapters/bun/index.ts +0 -2
  291. package/src/adapters/bun/server-adapter.ts +0 -499
  292. package/src/adapters/bun/server-lifecycle.d.ts +0 -63
  293. package/src/adapters/bun/server-lifecycle.js +0 -92
  294. package/src/adapters/bun/server-lifecycle.ts +0 -124
  295. package/src/adapters/index.ts +0 -6
  296. package/src/adapters/node/bootstrap-dependency-resolver.d.ts +0 -44
  297. package/src/adapters/node/bootstrap-dependency-resolver.js +0 -172
  298. package/src/adapters/node/bootstrap-dependency-resolver.ts +0 -301
  299. package/src/adapters/node/create-app.ts +0 -179
  300. package/src/adapters/node/index.d.ts +0 -6
  301. package/src/adapters/node/index.js +0 -11
  302. package/src/adapters/node/index.ts +0 -16
  303. package/src/adapters/node/node-client-bridge.ts +0 -79
  304. package/src/adapters/node/node-hmr-manager.ts +0 -381
  305. package/src/adapters/node/runtime-adapter.d.ts +0 -46
  306. package/src/adapters/node/runtime-adapter.js +0 -306
  307. package/src/adapters/node/runtime-adapter.ts +0 -439
  308. package/src/adapters/node/server-adapter.ts +0 -488
  309. package/src/adapters/node/static-content-server.ts +0 -239
  310. package/src/adapters/node/write-runtime-manifest.d.ts +0 -26
  311. package/src/adapters/node/write-runtime-manifest.js +0 -12
  312. package/src/adapters/node/write-runtime-manifest.ts +0 -38
  313. package/src/adapters/shared/api-response.ts +0 -104
  314. package/src/adapters/shared/application-adapter.ts +0 -199
  315. package/src/adapters/shared/define-api-handler.ts +0 -66
  316. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -140
  317. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -127
  318. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  319. package/src/adapters/shared/fs-server-response-matcher.ts +0 -205
  320. package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
  321. package/src/adapters/shared/hmr-html-response.ts +0 -52
  322. package/src/adapters/shared/render-context.ts +0 -120
  323. package/src/adapters/shared/runtime-bootstrap.d.ts +0 -38
  324. package/src/adapters/shared/runtime-bootstrap.js +0 -43
  325. package/src/adapters/shared/runtime-bootstrap.ts +0 -79
  326. package/src/adapters/shared/server-adapter.ts +0 -489
  327. package/src/adapters/shared/server-route-handler.ts +0 -153
  328. package/src/adapters/shared/server-static-builder.ts +0 -166
  329. package/src/build/build-adapter.ts +0 -361
  330. package/src/build/build-manifest.ts +0 -54
  331. package/src/build/build-types.ts +0 -83
  332. package/src/build/dev-build-coordinator.d.ts +0 -74
  333. package/src/build/dev-build-coordinator.js +0 -161
  334. package/src/build/dev-build-coordinator.ts +0 -221
  335. package/src/build/esbuild-build-adapter.d.ts +0 -72
  336. package/src/build/esbuild-build-adapter.js +0 -422
  337. package/src/build/esbuild-build-adapter.ts +0 -559
  338. package/src/build/runtime-build-executor.ts +0 -34
  339. package/src/build/runtime-specifier-alias-plugin.d.ts +0 -15
  340. package/src/build/runtime-specifier-alias-plugin.js +0 -31
  341. package/src/build/runtime-specifier-alias-plugin.ts +0 -58
  342. package/src/config/config-builder.ts +0 -706
  343. package/src/constants.ts +0 -54
  344. package/src/create-app.ts +0 -87
  345. package/src/dev/sc-server.ts +0 -143
  346. package/src/eco/component-render-context.d.ts +0 -105
  347. package/src/eco/component-render-context.js +0 -87
  348. package/src/eco/component-render-context.ts +0 -224
  349. package/src/eco/eco.ts +0 -242
  350. package/src/eco/eco.types.ts +0 -221
  351. package/src/eco/eco.utils.ts +0 -89
  352. package/src/eco/global-injector-map.ts +0 -112
  353. package/src/eco/lazy-injector-map.ts +0 -120
  354. package/src/eco/module-dependencies.ts +0 -75
  355. package/src/errors/http-error.ts +0 -72
  356. package/src/errors/index.ts +0 -2
  357. package/src/errors/locals-access-error.ts +0 -7
  358. package/src/global/app-logger.ts +0 -4
  359. package/src/hmr/client/hmr-runtime.ts +0 -152
  360. package/src/hmr/hmr-strategy.ts +0 -172
  361. package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
  362. package/src/hmr/hmr.test.e2e.ts +0 -66
  363. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  364. package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
  365. package/src/index.browser.ts +0 -3
  366. package/src/index.ts +0 -5
  367. package/src/integrations/ghtml/ghtml-renderer.ts +0 -96
  368. package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
  369. package/src/internal-types.ts +0 -232
  370. package/src/plugins/alias-resolver-plugin.ts +0 -63
  371. package/src/plugins/eco-component-meta-plugin.ts +0 -481
  372. package/src/plugins/integration-plugin.ts +0 -226
  373. package/src/plugins/processor.ts +0 -240
  374. package/src/plugins/runtime-capability.ts +0 -14
  375. package/src/public-types.ts +0 -1317
  376. package/src/route-renderer/component-graph/component-graph-executor.d.ts +0 -32
  377. package/src/route-renderer/component-graph/component-graph-executor.js +0 -31
  378. package/src/route-renderer/component-graph/component-graph-executor.ts +0 -84
  379. package/src/route-renderer/component-graph/component-graph.d.ts +0 -42
  380. package/src/route-renderer/component-graph/component-graph.js +0 -72
  381. package/src/route-renderer/component-graph/component-graph.ts +0 -159
  382. package/src/route-renderer/component-graph/component-marker.d.ts +0 -52
  383. package/src/route-renderer/component-graph/component-marker.js +0 -46
  384. package/src/route-renderer/component-graph/component-marker.ts +0 -117
  385. package/src/route-renderer/component-graph/component-reference.d.ts +0 -10
  386. package/src/route-renderer/component-graph/component-reference.js +0 -19
  387. package/src/route-renderer/component-graph/component-reference.ts +0 -29
  388. package/src/route-renderer/component-graph/marker-graph-resolver.d.ts +0 -77
  389. package/src/route-renderer/component-graph/marker-graph-resolver.js +0 -95
  390. package/src/route-renderer/component-graph/marker-graph-resolver.ts +0 -155
  391. package/src/route-renderer/orchestration/integration-renderer.ts +0 -790
  392. package/src/route-renderer/orchestration/render-execution.service.d.ts +0 -103
  393. package/src/route-renderer/orchestration/render-execution.service.js +0 -121
  394. package/src/route-renderer/orchestration/render-execution.service.ts +0 -230
  395. package/src/route-renderer/orchestration/render-preparation.service.d.ts +0 -121
  396. package/src/route-renderer/orchestration/render-preparation.service.js +0 -332
  397. package/src/route-renderer/orchestration/render-preparation.service.ts +0 -476
  398. package/src/route-renderer/page-loading/dependency-resolver.ts +0 -612
  399. package/src/route-renderer/page-loading/page-module-loader.ts +0 -181
  400. package/src/route-renderer/route-renderer.ts +0 -115
  401. package/src/router/client/link-intent.test.browser.ts +0 -51
  402. package/src/router/client/link-intent.ts +0 -92
  403. package/src/router/client/navigation-coordinator.ts +0 -433
  404. package/src/router/server/fs-router-scanner.d.ts +0 -41
  405. package/src/router/server/fs-router-scanner.js +0 -156
  406. package/src/router/server/fs-router-scanner.ts +0 -219
  407. package/src/router/server/fs-router.d.ts +0 -26
  408. package/src/router/server/fs-router.js +0 -100
  409. package/src/router/server/fs-router.ts +0 -122
  410. package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -401
  411. package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
  412. package/src/services/assets/asset-processing-service/assets.types.ts +0 -113
  413. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -95
  414. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
  415. package/src/services/assets/asset-processing-service/index.ts +0 -5
  416. package/src/services/assets/asset-processing-service/processor.interface.ts +0 -27
  417. package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
  418. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -82
  419. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -95
  420. package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
  421. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -66
  422. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -88
  423. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -85
  424. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
  425. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -80
  426. package/src/services/assets/browser-bundle.service.ts +0 -53
  427. package/src/services/cache/cache.types.ts +0 -126
  428. package/src/services/cache/index.ts +0 -18
  429. package/src/services/cache/memory-cache-store.ts +0 -130
  430. package/src/services/cache/page-cache-service.ts +0 -202
  431. package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
  432. package/src/services/html/html-rewriter-provider.service.ts +0 -103
  433. package/src/services/html/html-transformer.service.ts +0 -279
  434. package/src/services/invalidation/development-invalidation.service.ts +0 -261
  435. package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -52
  436. package/src/services/module-loading/page-module-import.service.ts +0 -200
  437. package/src/services/module-loading/server-loader.service.d.ts +0 -96
  438. package/src/services/module-loading/server-loader.service.js +0 -32
  439. package/src/services/module-loading/server-loader.service.ts +0 -130
  440. package/src/services/module-loading/server-module-transpiler.service.ts +0 -105
  441. package/src/services/runtime-manifest/node-runtime-manifest.service.d.ts +0 -35
  442. package/src/services/runtime-manifest/node-runtime-manifest.service.js +0 -60
  443. package/src/services/runtime-manifest/node-runtime-manifest.service.ts +0 -101
  444. package/src/services/runtime-state/dev-graph.service.ts +0 -217
  445. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
  446. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +0 -69
  447. package/src/services/runtime-state/runtime-specifier-registry.service.js +0 -37
  448. package/src/services/runtime-state/runtime-specifier-registry.service.ts +0 -96
  449. package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
  450. package/src/services/validation/schema-validation-service.ts +0 -204
  451. package/src/services/validation/standard-schema.types.ts +0 -68
  452. package/src/static-site-generator/static-site-generator.ts +0 -462
  453. package/src/utils/css.d.ts +0 -1
  454. package/src/utils/css.js +0 -7
  455. package/src/utils/css.ts +0 -5
  456. package/src/utils/deep-merge.ts +0 -47
  457. package/src/utils/hash.ts +0 -5
  458. package/src/utils/html.ts +0 -1
  459. package/src/utils/invariant.ts +0 -15
  460. package/src/utils/locals-utils.ts +0 -37
  461. package/src/utils/parse-cli-args.ts +0 -83
  462. package/src/utils/path-utils.module.ts +0 -14
  463. package/src/utils/resolve-work-dir.ts +0 -45
  464. package/src/utils/runtime.ts +0 -44
  465. package/src/utils/server-utils.module.ts +0 -67
  466. package/src/watchers/project-watcher.test-helpers.ts +0 -41
  467. package/src/watchers/project-watcher.ts +0 -363
  468. /package/src/{internal-types.js → adapters/shared/runtime-host.js} +0 -0
  469. /package/src/{public-types.js → adapters/shared/static-preview-host.js} +0 -0
  470. /package/src/{constants.d.ts → config/constants.d.ts} +0 -0
  471. /package/src/{constants.js → config/constants.js} +0 -0
@@ -1,706 +0,0 @@
1
- /**
2
- * This module contains the ConfigBuilder class, which is used to build the EcoPagesAppConfig object.
3
- * @module
4
- */
5
-
6
- import path from 'node:path';
7
- import {
8
- DEFAULT_ECOPAGES_DIST_DIR,
9
- DEFAULT_ECOPAGES_HOSTNAME,
10
- DEFAULT_ECOPAGES_PORT,
11
- DEFAULT_ECOPAGES_WORK_DIR,
12
- } from '../constants.ts';
13
- import {
14
- collectConfiguredAppBuildManifestContributions,
15
- createBuildAdapter,
16
- getAppServerBuildPlugins,
17
- setAppBuildAdapter,
18
- setAppBuildExecutor,
19
- updateAppBuildManifest,
20
- } from '../build/build-adapter.ts';
21
- import type { EcoBuildPlugin } from '../build/build-types.ts';
22
- import { createAppBuildExecutor } from '../build/dev-build-coordinator.ts';
23
- import { GHTML_PLUGIN_NAME, ghtmlPlugin } from '../integrations/ghtml/ghtml.plugin.ts';
24
- import type { EcoPagesAppConfig, RobotsPreference } from '../internal-types.ts';
25
- import { createEcoComponentMetaPlugin } from '../plugins/eco-component-meta-plugin.ts';
26
- import type { IntegrationPlugin } from '../plugins/integration-plugin.ts';
27
- import type { Processor } from '../plugins/processor.ts';
28
- import type { RuntimeCapabilityDeclaration, RuntimeCapabilityTag } from '../plugins/runtime-capability.ts';
29
- import type { PageMetadataProps } from '../public-types.ts';
30
- import type { CacheConfig } from '../services/cache/cache.types.ts';
31
- import {
32
- NoopEntrypointDependencyGraph,
33
- setAppEntrypointDependencyGraph,
34
- } from '../services/runtime-state/entrypoint-dependency-graph.service.ts';
35
- import {
36
- createNodeRuntimeManifest,
37
- setAppNodeRuntimeManifest,
38
- } from '../services/runtime-manifest/node-runtime-manifest.service.ts';
39
- import {
40
- InMemoryRuntimeSpecifierRegistry,
41
- setAppRuntimeSpecifierRegistry,
42
- } from '../services/runtime-state/runtime-specifier-registry.service.ts';
43
- import {
44
- CounterServerInvalidationState,
45
- setAppServerInvalidationState,
46
- } from '../services/runtime-state/server-invalidation-state.service.ts';
47
- import { invariant } from '../utils/invariant.ts';
48
- import { appLogger } from '../global/app-logger.ts';
49
- import { fileSystem } from '@ecopages/file-system';
50
-
51
- export const CONFIG_BUILDER_ERRORS = {
52
- DUPLICATE_INTEGRATION_NAMES: 'Integrations names must be unique',
53
- DUPLICATE_INTEGRATION_EXTENSIONS: 'Integrations extensions must be unique',
54
- MIXED_JSX_ENGINES:
55
- 'Both kitajs and react integrations are enabled. Use per-file JSX import source/pragma consistently (e.g. `/** @jsxImportSource react */` for React files and `/** @jsxImportSource @kitajs/html */` for Kita files).',
56
- duplicateProcessorName: (name: string) => `Processor with name "${name}" already exists`,
57
- duplicateLoaderName: (name: string) => `Loader with name "${name}" already exists`,
58
- duplicateSemanticTemplate: (kind: 'html' | '404', matches: string[]) =>
59
- `Multiple ${kind} templates found: ${matches.join(', ')}`,
60
- incompatibleRuntimeCapability: (
61
- kind: 'integration' | 'processor',
62
- name: string,
63
- runtime: RuntimeKind,
64
- reason: string,
65
- ) => `Cannot enable ${kind} "${name}" on ${runtime}: ${reason}`,
66
- unsupportedRuntimeVersion: (
67
- kind: 'integration' | 'processor',
68
- name: string,
69
- runtime: RuntimeKind,
70
- current: string,
71
- min: string,
72
- ) => `Cannot enable ${kind} "${name}" on ${runtime} ${current}: requires runtime version ${min} or newer`,
73
- invalidRuntimeVersion: (kind: 'integration' | 'processor', name: string, version: string) =>
74
- `Cannot validate ${kind} "${name}" runtimeCapability.minRuntimeVersion "${version}" because it is not a dot-separated numeric version`,
75
- } as const;
76
-
77
- type RuntimeKind = 'node' | 'bun';
78
-
79
- type RuntimeEnvironment = {
80
- runtime: RuntimeKind;
81
- version: string;
82
- supportedTags: Set<RuntimeCapabilityTag>;
83
- };
84
-
85
- type RuntimeCapabilityOwner = {
86
- kind: 'integration' | 'processor';
87
- name: string;
88
- runtimeCapability?: RuntimeCapabilityDeclaration;
89
- };
90
-
91
- /**
92
- * A builder class for creating and configuring EcoPages application configuration.
93
- * Provides a fluent interface for setting various configuration options and managing
94
- * application settings.
95
- *
96
- * @example
97
- * ```typescript
98
- * const config = new ConfigBuilder()
99
- * .setBaseUrl('https://example.com')
100
- * .setRootDir('./myproject')
101
- * .setSrcDir('source')
102
- * .build();
103
- * ```
104
- *
105
- * @remarks
106
- * The ConfigBuilder follows the builder pattern and allows for:
107
- * - Setting directory paths for various components (pages, includes, layouts, etc.)
108
- * - Configuring templates and includes
109
- * - Managing integrations and plugins
110
- * - Setting up processors and loaders
111
- * - Configuring API handlers
112
- * - Managing metadata and robots.txt preferences
113
- *
114
- * All setter methods return the instance of the builder for method chaining.
115
- * The configuration is finalized by calling the `build()` method, which performs
116
- * validation and initialization of the configuration.
117
- *
118
- * @throws {Error} When building configuration without required fields (e.g., baseUrl)
119
- * @throws {Error} When adding duplicate processors or loaders
120
- */
121
- export class ConfigBuilder {
122
- public config: EcoPagesAppConfig = {
123
- baseUrl: '',
124
- rootDir: '.',
125
- srcDir: 'src',
126
- pagesDir: 'pages',
127
- includesDir: 'includes',
128
- componentsDir: 'components',
129
- layoutsDir: 'layouts',
130
- publicDir: 'public',
131
- robotsTxt: {
132
- preferences: {
133
- '*': [],
134
- },
135
- },
136
- integrations: [],
137
- integrationsDependencies: [],
138
- distDir: DEFAULT_ECOPAGES_DIST_DIR,
139
- defaultMetadata: {
140
- title: 'Ecopages',
141
- description: 'This is a static site generated with Ecopages',
142
- },
143
- additionalWatchPaths: [],
144
- templatesExt: [],
145
- absolutePaths: {
146
- config: '',
147
- componentsDir: '',
148
- distDir: '',
149
- workDir: '',
150
- includesDir: '',
151
- layoutsDir: '',
152
- pagesDir: '',
153
- projectDir: '',
154
- publicDir: '',
155
- srcDir: '',
156
- htmlTemplatePath: '',
157
- error404TemplatePath: '',
158
- },
159
- processors: new Map(),
160
- loaders: new Map(),
161
- workDir: DEFAULT_ECOPAGES_WORK_DIR,
162
- };
163
-
164
- /**
165
- * Sets the base URL for the application.
166
- * This URL is used as the root URL for all pages and assets.
167
- *
168
- * @param baseUrl - The base URL for the application (e.g., 'https://example.com')
169
- * @returns The ConfigBuilder instance for method chaining
170
- */
171
- setBaseUrl(baseUrl: string): this {
172
- this.config.baseUrl = baseUrl;
173
- return this;
174
- }
175
-
176
- /**
177
- * Sets the root directory of the project.
178
- * This is the base directory from which all other paths are resolved.
179
- *
180
- * @param rootDir - The root directory path
181
- * @returns The ConfigBuilder instance for method chaining
182
- */
183
- setRootDir(rootDir: string): this {
184
- this.config.rootDir = rootDir;
185
- return this;
186
- }
187
-
188
- /**
189
- * Sets the source directory relative to the root directory.
190
- * This directory contains all the source files for the application.
191
- *
192
- * @param srcDir - The source directory name (default: 'src')
193
- * @returns The ConfigBuilder instance for method chaining
194
- */
195
- setSrcDir(srcDir: string): this {
196
- this.config.srcDir = srcDir;
197
- return this;
198
- }
199
-
200
- /**
201
- * Sets the pages directory relative to the source directory.
202
- * This directory contains all the page files for the application.
203
- *
204
- * @param pagesDir - The pages directory name (default: 'pages')
205
- * @returns The ConfigBuilder instance for method chaining
206
- */
207
- setPagesDir(pagesDir: string): this {
208
- this.config.pagesDir = pagesDir;
209
- return this;
210
- }
211
-
212
- /**
213
- * Sets the includes directory relative to the source directory.
214
- * This directory contains template includes and partials.
215
- *
216
- * @param includesDir - The includes directory name (default: 'includes')
217
- * @returns The ConfigBuilder instance for method chaining
218
- */
219
- setIncludesDir(includesDir: string): this {
220
- this.config.includesDir = includesDir;
221
- return this;
222
- }
223
-
224
- /**
225
- * Sets the components directory relative to the source directory.
226
- * This directory contains reusable components.
227
- *
228
- * @param componentsDir - The components directory name (default: 'components')
229
- * @returns The ConfigBuilder instance for method chaining
230
- */
231
- setComponentsDir(componentsDir: string): this {
232
- this.config.componentsDir = componentsDir;
233
- return this;
234
- }
235
-
236
- /**
237
- * Sets the layouts directory relative to the source directory.
238
- * This directory contains layout templates.
239
- *
240
- * @param layoutsDir - The layouts directory name (default: 'layouts')
241
- * @returns The ConfigBuilder instance for method chaining
242
- */
243
- setLayoutsDir(layoutsDir: string): this {
244
- this.config.layoutsDir = layoutsDir;
245
- return this;
246
- }
247
-
248
- /**
249
- * Sets the public directory relative to the source directory.
250
- * This directory contains static assets that should be served as-is.
251
- *
252
- * @param publicDir - The public directory name (default: 'public')
253
- * @returns The ConfigBuilder instance for method chaining
254
- */
255
- setPublicDir(publicDir: string): this {
256
- this.config.publicDir = publicDir;
257
- return this;
258
- }
259
-
260
- /**
261
- * Sets the robots.txt configuration.
262
- * This determines which paths are allowed/disallowed for search engines.
263
- *
264
- * @param robotsTxt - The robots.txt configuration object
265
- * @returns The ConfigBuilder instance for method chaining
266
- */
267
- setRobotsTxt(robotsTxt: { preferences: RobotsPreference }): this {
268
- this.config.robotsTxt = robotsTxt;
269
- return this;
270
- }
271
-
272
- /**
273
- * Sets the integration plugins to use.
274
- * These plugins provide additional functionality to the application.
275
- *
276
- * @param integrations - An array of integration plugins
277
- * @returns The ConfigBuilder instance for method chaining
278
- */
279
- setIntegrations(integrations: IntegrationPlugin<unknown>[]): this {
280
- this.config.integrations = integrations;
281
- return this;
282
- }
283
-
284
- /**
285
- * Sets the output directory for the built application.
286
- *
287
- * @param distDir - The distribution directory name (default: 'dist')
288
- * @returns The ConfigBuilder instance for method chaining
289
- */
290
- setDistDir(distDir: string): this {
291
- this.config.distDir = distDir;
292
- return this;
293
- }
294
-
295
- /**
296
- * Sets the internal work directory for runtime-only artifacts.
297
- *
298
- * @remarks
299
- * Use this when deployable output should stay clean while Ecopages still
300
- * needs a separate workspace for server transpilation caches, runtime
301
- * manifests, and other internal build products.
302
- *
303
- * @param workDir - The internal work directory name
304
- * @returns The ConfigBuilder instance for method chaining
305
- */
306
- setWorkDir(workDir: string): this {
307
- this.config.workDir = workDir;
308
- return this;
309
- }
310
-
311
- /**
312
- * Sets the default metadata for pages.
313
- * This is used when a page doesn't specify its own metadata.
314
- *
315
- * @param defaultMetadata - The default metadata object
316
- * @returns The ConfigBuilder instance for method chaining
317
- */
318
- setDefaultMetadata(defaultMetadata: PageMetadataProps): this {
319
- this.config.defaultMetadata = {
320
- ...this.config.defaultMetadata,
321
- ...defaultMetadata,
322
- };
323
- return this;
324
- }
325
-
326
- /**
327
- * Sets additional paths to watch for changes during development.
328
- *
329
- * @param additionalWatchPaths - An array of additional paths to watch
330
- * @returns The ConfigBuilder instance for method chaining
331
- */
332
- setAdditionalWatchPaths(additionalWatchPaths: string[]): this {
333
- this.config.additionalWatchPaths = additionalWatchPaths;
334
- return this;
335
- }
336
-
337
- /**
338
- * Sets the processors to use for the application.
339
- * This replaces any existing processors.
340
- *
341
- * @param processors - An array of processors
342
- * @returns The ConfigBuilder instance for method chaining
343
- */
344
- setProcessors(processors: Processor<any>[]): this {
345
- this.config.processors.clear();
346
- for (const processor of processors) {
347
- this.addProcessor(processor);
348
- }
349
- return this;
350
- }
351
-
352
- /**
353
- * Adds a processor to the application.
354
- *
355
- * @param processor - The processor to add
356
- * @returns The ConfigBuilder instance for method chaining
357
- * @throws Error if a processor with the same name already exists
358
- */
359
- addProcessor(processor: Processor): this {
360
- if (this.config.processors.has(processor.name)) {
361
- throw new Error(CONFIG_BUILDER_ERRORS.duplicateProcessorName(processor.name));
362
- }
363
- this.config.processors.set(processor.name, processor);
364
- return this;
365
- }
366
-
367
- /**
368
- * Sets the loaders to use for the application.
369
- * This replaces any existing loaders.
370
- *
371
- * @param loaders - An array of build plugins to use as loaders
372
- * @returns The ConfigBuilder instance for method chaining
373
- */
374
- setLoaders(loaders: EcoBuildPlugin[]): this {
375
- this.config.loaders.clear();
376
- for (const loader of loaders) {
377
- this.addLoader(loader.name, loader);
378
- }
379
- return this;
380
- }
381
-
382
- /**
383
- * Adds a loader to the application.
384
- *
385
- * @param name - The name of the loader
386
- * @param loader - The build plugin to use as a loader
387
- * @returns The ConfigBuilder instance for method chaining
388
- * @throws Error if a loader with the same name already exists
389
- */
390
- addLoader(name: string, loader: EcoBuildPlugin): this {
391
- if (this.config.loaders.has(name)) {
392
- throw new Error(CONFIG_BUILDER_ERRORS.duplicateLoaderName(name));
393
- }
394
- this.config.loaders.set(name, loader);
395
- return this;
396
- }
397
-
398
- /**
399
- * Sets the cache configuration for ISR and page caching.
400
- *
401
- * @param cacheConfig - The cache configuration object
402
- * @returns The ConfigBuilder instance for method chaining
403
- */
404
- setCacheConfig(cacheConfig: CacheConfig): this {
405
- this.config.cache = cacheConfig;
406
- return this;
407
- }
408
-
409
- setExperimental(experimental: NonNullable<EcoPagesAppConfig['experimental']>): this {
410
- this.config.experimental = experimental;
411
- return this;
412
- }
413
-
414
- private createAbsolutePaths(config: EcoPagesAppConfig): this {
415
- const { srcDir, componentsDir, includesDir, layoutsDir, pagesDir, publicDir, distDir, workDir } = config;
416
-
417
- const projectDir = config.rootDir;
418
-
419
- const absoluteSrcDir = path.resolve(projectDir, srcDir);
420
- const absoluteDistDir = path.resolve(projectDir, distDir);
421
- const absoluteWorkDir = path.resolve(projectDir, workDir);
422
-
423
- const absoluteIncludesDir = path.join(absoluteSrcDir, includesDir);
424
- const absolutePagesDir = path.join(absoluteSrcDir, pagesDir);
425
-
426
- this.config.absolutePaths = {
427
- config: path.join(projectDir, 'eco.config.ts'),
428
- projectDir: projectDir,
429
- srcDir: absoluteSrcDir,
430
- distDir: absoluteDistDir,
431
- workDir: absoluteWorkDir,
432
- componentsDir: path.join(absoluteSrcDir, componentsDir),
433
- includesDir: absoluteIncludesDir,
434
- layoutsDir: path.join(absoluteSrcDir, layoutsDir),
435
- pagesDir: absolutePagesDir,
436
- publicDir: path.join(absoluteSrcDir, publicDir),
437
- htmlTemplatePath: this.resolveSemanticTemplatePath({
438
- dirPath: absoluteIncludesDir,
439
- basename: 'html',
440
- }),
441
- error404TemplatePath: this.resolveSemanticTemplatePath({
442
- dirPath: absolutePagesDir,
443
- basename: '404',
444
- }),
445
- };
446
-
447
- return this;
448
- }
449
-
450
- private resolveSemanticTemplatePath({ dirPath, basename }: { dirPath: string; basename: 'html' | '404' }): string {
451
- const extensions = this.config.templatesExt.length > 0 ? this.config.templatesExt : ['.ghtml.ts'];
452
- const matches = extensions
453
- .map((extension) => path.join(dirPath, `${basename}${extension}`))
454
- .filter((candidate) => fileSystem.exists(candidate));
455
-
456
- invariant(matches.length <= 1, CONFIG_BUILDER_ERRORS.duplicateSemanticTemplate(basename, matches));
457
-
458
- if (matches.length === 1) {
459
- return matches[0]!;
460
- }
461
-
462
- return path.join(dirPath, `${basename}${extensions[0]}`);
463
- }
464
-
465
- private createIntegrationTemplatesExt(integrations: EcoPagesAppConfig['integrations']) {
466
- const integrationName = integrations.map((integration) => integration.name);
467
- const uniqueName = new Set(integrationName);
468
-
469
- invariant(integrationName.length === uniqueName.size, CONFIG_BUILDER_ERRORS.DUPLICATE_INTEGRATION_NAMES);
470
-
471
- const hasKitaJs = uniqueName.has('kitajs');
472
- const hasReact = uniqueName.has('react');
473
- if (hasKitaJs && hasReact) {
474
- appLogger.warn(CONFIG_BUILDER_ERRORS.MIXED_JSX_ENGINES);
475
- }
476
-
477
- const integrationsExtensions = integrations.flatMap((integration) => integration.extensions);
478
- const uniqueExtensions = new Set(integrationsExtensions);
479
-
480
- invariant(
481
- integrationsExtensions.length === uniqueExtensions.size,
482
- CONFIG_BUILDER_ERRORS.DUPLICATE_INTEGRATION_EXTENSIONS,
483
- );
484
-
485
- this.config.templatesExt = integrationsExtensions;
486
- }
487
-
488
- private initializeProcessors(): void {
489
- for (const processor of this.config.processors.values()) {
490
- processor.setContext(this.config);
491
- }
492
- }
493
-
494
- private validateRuntimeCapabilities(): void {
495
- const runtimeEnvironment = this.detectRuntimeEnvironment();
496
- const contributors: RuntimeCapabilityOwner[] = [
497
- ...this.config.integrations.map((integration) => ({
498
- kind: 'integration' as const,
499
- name: integration.name,
500
- runtimeCapability: integration.runtimeCapability,
501
- })),
502
- ...Array.from(this.config.processors.values(), (processor) => ({
503
- kind: 'processor' as const,
504
- name: processor.name,
505
- runtimeCapability: processor.runtimeCapability,
506
- })),
507
- ];
508
-
509
- for (const contributor of contributors) {
510
- this.validateRuntimeCapability(contributor, runtimeEnvironment);
511
- }
512
- }
513
-
514
- private validateRuntimeCapability(contributor: RuntimeCapabilityOwner, environment: RuntimeEnvironment): void {
515
- const declaration = contributor.runtimeCapability;
516
- if (!declaration) {
517
- return;
518
- }
519
-
520
- for (const tag of declaration.tags) {
521
- if (environment.supportedTags.has(tag)) {
522
- continue;
523
- }
524
-
525
- throw new Error(
526
- CONFIG_BUILDER_ERRORS.incompatibleRuntimeCapability(
527
- contributor.kind,
528
- contributor.name,
529
- environment.runtime,
530
- this.describeUnsupportedRuntimeTag(tag),
531
- ),
532
- );
533
- }
534
-
535
- if (!declaration.minRuntimeVersion) {
536
- return;
537
- }
538
-
539
- const minVersion = this.parseVersion(declaration.minRuntimeVersion);
540
- if (!minVersion) {
541
- throw new Error(
542
- CONFIG_BUILDER_ERRORS.invalidRuntimeVersion(
543
- contributor.kind,
544
- contributor.name,
545
- declaration.minRuntimeVersion,
546
- ),
547
- );
548
- }
549
-
550
- const currentVersion = this.parseVersion(environment.version);
551
- if (!currentVersion) {
552
- return;
553
- }
554
-
555
- if (this.compareVersions(currentVersion, minVersion) >= 0) {
556
- return;
557
- }
558
-
559
- throw new Error(
560
- CONFIG_BUILDER_ERRORS.unsupportedRuntimeVersion(
561
- contributor.kind,
562
- contributor.name,
563
- environment.runtime,
564
- environment.version,
565
- declaration.minRuntimeVersion,
566
- ),
567
- );
568
- }
569
-
570
- private detectRuntimeEnvironment(): RuntimeEnvironment {
571
- const bunVersion = this.getBunVersion();
572
- if (bunVersion) {
573
- return {
574
- runtime: 'bun',
575
- version: bunVersion,
576
- supportedTags: new Set<RuntimeCapabilityTag>([
577
- 'bun-only',
578
- 'node-compatible',
579
- 'requires-native-bun-api',
580
- 'requires-node-builtins',
581
- ]),
582
- };
583
- }
584
-
585
- return {
586
- runtime: 'node',
587
- version: process.versions.node,
588
- supportedTags: new Set<RuntimeCapabilityTag>(['node-compatible', 'requires-node-builtins']),
589
- };
590
- }
591
-
592
- private getBunVersion(): string | undefined {
593
- const bun = globalThis as typeof globalThis & {
594
- Bun?: {
595
- version?: string;
596
- };
597
- };
598
-
599
- return typeof bun.Bun?.version === 'string' ? bun.Bun.version : undefined;
600
- }
601
-
602
- private describeUnsupportedRuntimeTag(tag: RuntimeCapabilityTag): string {
603
- switch (tag) {
604
- case 'bun-only':
605
- return 'it is Bun-only';
606
- case 'requires-native-bun-api':
607
- return 'it requires the native Bun API';
608
- case 'requires-node-builtins':
609
- return 'it requires Node builtins';
610
- case 'node-compatible':
611
- return 'it requires a Node-compatible runtime';
612
- }
613
- }
614
-
615
- private parseVersion(version: string): number[] | undefined {
616
- const normalized = version.trim().replace(/^v/i, '');
617
- if (!/^\d+(?:\.\d+)*$/.test(normalized)) {
618
- return undefined;
619
- }
620
-
621
- return normalized.split('.').map((segment) => Number(segment));
622
- }
623
-
624
- private compareVersions(left: number[], right: number[]): number {
625
- const maxLength = Math.max(left.length, right.length);
626
- for (let index = 0; index < maxLength; index += 1) {
627
- const leftValue = left[index] ?? 0;
628
- const rightValue = right[index] ?? 0;
629
-
630
- if (leftValue > rightValue) {
631
- return 1;
632
- }
633
-
634
- if (leftValue < rightValue) {
635
- return -1;
636
- }
637
- }
638
-
639
- return 0;
640
- }
641
-
642
- /**
643
- * Initializes default loaders that are required for EcoPages to function.
644
- * This includes the eco-component-meta-plugin which auto-injects __eco metadata into component configs.
645
- */
646
- private async initializeDefaultLoaders(): Promise<void> {
647
- const componentMetaPlugin = createEcoComponentMetaPlugin({ config: this.config });
648
- if (!this.config.loaders.has(componentMetaPlugin.name)) {
649
- this.config.loaders.set(componentMetaPlugin.name, componentMetaPlugin);
650
- }
651
- }
652
-
653
- private reviewBaseUrl(baseUrl: string): void {
654
- if (baseUrl) {
655
- this.config.baseUrl = baseUrl;
656
- return;
657
- }
658
-
659
- const envBaseUrl = process.env.ECOPAGES_BASE_URL;
660
-
661
- if (envBaseUrl) {
662
- this.config.baseUrl = envBaseUrl;
663
- } else if (!this.config.baseUrl) {
664
- this.config.baseUrl = `http://${DEFAULT_ECOPAGES_HOSTNAME}:${DEFAULT_ECOPAGES_PORT}`;
665
- }
666
- }
667
-
668
- /**
669
- * Builds and returns the final configuration object.
670
- * This performs validation and initialization of the configuration.
671
- *
672
- * @returns A promise that resolves to the final EcoPagesAppConfig
673
- * @throws Error if required configuration is missing (e.g., baseUrl)
674
- */
675
- async build(): Promise<EcoPagesAppConfig> {
676
- this.reviewBaseUrl(this.config.baseUrl);
677
-
678
- if (!this.config.integrations.some((integration) => integration.name === GHTML_PLUGIN_NAME)) {
679
- this.config.integrations.push(ghtmlPlugin());
680
- }
681
-
682
- this.createIntegrationTemplatesExt(this.config.integrations);
683
- this.createAbsolutePaths(this.config);
684
-
685
- await this.initializeDefaultLoaders();
686
- this.initializeProcessors();
687
- this.validateRuntimeCapabilities();
688
- const buildAdapter = createBuildAdapter();
689
- setAppBuildAdapter(this.config, buildAdapter);
690
- updateAppBuildManifest(this.config, await collectConfiguredAppBuildManifestContributions(this.config));
691
- setAppServerInvalidationState(this.config, new CounterServerInvalidationState());
692
- setAppEntrypointDependencyGraph(this.config, new NoopEntrypointDependencyGraph());
693
- setAppRuntimeSpecifierRegistry(this.config, new InMemoryRuntimeSpecifierRegistry());
694
- setAppBuildExecutor(
695
- this.config,
696
- createAppBuildExecutor({
697
- development: false,
698
- adapter: buildAdapter,
699
- getPlugins: () => getAppServerBuildPlugins(this.config),
700
- }),
701
- );
702
- setAppNodeRuntimeManifest(this.config, createNodeRuntimeManifest(this.config));
703
-
704
- return this.config;
705
- }
706
- }