@ecopages/core 0.2.0-alpha.9 → 0.2.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 (357) hide show
  1. package/CHANGELOG.md +18 -11
  2. package/README.md +23 -26
  3. package/package.json +76 -58
  4. package/src/adapters/README.md +2 -2
  5. package/src/adapters/abstract/application-adapter.d.ts +28 -2
  6. package/src/adapters/abstract/application-adapter.js +14 -2
  7. package/src/adapters/abstract/router-adapter.d.ts +1 -1
  8. package/src/adapters/abstract/server-adapter.d.ts +2 -2
  9. package/src/adapters/bun/client-bridge.d.ts +1 -1
  10. package/src/adapters/bun/create-app.d.ts +4 -12
  11. package/src/adapters/bun/create-app.js +4 -5
  12. package/src/adapters/bun/hmr-manager.d.ts +4 -4
  13. package/src/adapters/bun/hmr-manager.js +8 -8
  14. package/src/adapters/bun/index.d.ts +1 -1
  15. package/src/adapters/bun/index.js +2 -2
  16. package/src/adapters/bun/server-adapter.d.ts +5 -5
  17. package/src/adapters/bun/server-adapter.js +6 -5
  18. package/src/adapters/bun/server-lifecycle.d.ts +4 -4
  19. package/src/adapters/bun/server-lifecycle.js +2 -2
  20. package/src/{create-app.d.ts → adapters/create-app.d.ts} +9 -6
  21. package/src/{create-app.js → adapters/create-app.js} +4 -4
  22. package/src/adapters/index.d.ts +1 -5
  23. package/src/adapters/index.js +1 -7
  24. package/src/adapters/node/create-app.d.ts +6 -9
  25. package/src/adapters/node/create-app.js +12 -6
  26. package/src/adapters/node/node-client-bridge.d.ts +1 -1
  27. package/src/adapters/node/node-hmr-manager.d.ts +2 -2
  28. package/src/adapters/node/node-hmr-manager.js +3 -3
  29. package/src/adapters/node/server-adapter.d.ts +4 -4
  30. package/src/adapters/node/server-adapter.js +13 -12
  31. package/src/adapters/node/static-content-server.d.ts +1 -1
  32. package/src/adapters/node/static-content-server.js +1 -1
  33. package/src/adapters/shared/application-adapter.d.ts +1 -1
  34. package/src/adapters/shared/define-api-handler.d.ts +1 -1
  35. package/src/adapters/shared/explicit-static-route-matcher.d.ts +2 -2
  36. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +1 -1
  37. package/src/adapters/shared/fs-server-response-factory.d.ts +2 -2
  38. package/src/adapters/shared/fs-server-response-factory.js +1 -1
  39. package/src/adapters/shared/fs-server-response-matcher.d.ts +1 -1
  40. package/src/adapters/shared/hmr-entrypoint-registrar.js +1 -1
  41. package/src/adapters/shared/hmr-html-response.d.ts +1 -1
  42. package/src/adapters/shared/render-context.d.ts +2 -1
  43. package/src/adapters/shared/render-context.js +3 -1
  44. package/src/adapters/shared/runtime-bootstrap.d.ts +1 -1
  45. package/src/adapters/shared/runtime-bootstrap.js +1 -1
  46. package/src/adapters/shared/server-adapter.d.ts +1 -1
  47. package/src/adapters/shared/server-adapter.js +5 -1
  48. package/src/adapters/shared/server-route-handler.d.ts +4 -4
  49. package/src/adapters/shared/server-route-handler.js +3 -3
  50. package/src/adapters/shared/server-static-builder.d.ts +5 -5
  51. package/src/adapters/shared/server-static-builder.js +5 -4
  52. package/src/build/README.md +19 -13
  53. package/src/build/build-adapter.d.ts +67 -20
  54. package/src/build/build-adapter.js +420 -19
  55. package/src/build/dev-build-coordinator.d.ts +10 -12
  56. package/src/build/dev-build-coordinator.js +8 -15
  57. package/src/build/esbuild-build-adapter.d.ts +6 -0
  58. package/src/build/esbuild-build-adapter.js +94 -11
  59. package/src/build/runtime-build-executor.d.ts +5 -4
  60. package/src/build/runtime-build-executor.js +5 -3
  61. package/src/build/runtime-specifier-alias-plugin.js +19 -15
  62. package/src/build/runtime-specifier-aliases.d.ts +5 -0
  63. package/src/build/runtime-specifier-aliases.js +95 -0
  64. package/src/config/README.md +5 -2
  65. package/src/config/config-builder.d.ts +25 -2
  66. package/src/config/config-builder.js +44 -7
  67. package/src/declarations.d.ts +1 -1
  68. package/src/dev/sc-server.d.ts +1 -1
  69. package/src/dev/sc-server.js +1 -1
  70. package/src/eco/eco.browser.d.ts +2 -0
  71. package/src/eco/eco.browser.js +83 -0
  72. package/src/eco/eco.js +19 -48
  73. package/src/eco/eco.types.d.ts +1 -1
  74. package/src/eco/eco.utils.d.ts +1 -40
  75. package/src/eco/eco.utils.js +5 -35
  76. package/src/eco/global-injector-map.d.ts +1 -1
  77. package/src/eco/lazy-injector-map.d.ts +1 -1
  78. package/src/hmr/hmr-strategy.d.ts +16 -13
  79. package/src/hmr/hmr-strategy.js +22 -7
  80. package/src/hmr/strategies/default-hmr-strategy.d.ts +2 -2
  81. package/src/hmr/strategies/default-hmr-strategy.js +1 -1
  82. package/src/hmr/strategies/js-hmr-strategy.d.ts +2 -2
  83. package/src/hmr/strategies/js-hmr-strategy.js +2 -2
  84. package/src/index.browser.d.ts +2 -2
  85. package/src/index.browser.js +1 -1
  86. package/src/index.d.ts +3 -2
  87. package/src/index.js +15 -4
  88. package/src/integrations/ghtml/ghtml-renderer.d.ts +6 -1
  89. package/src/integrations/ghtml/ghtml-renderer.js +29 -28
  90. package/src/integrations/ghtml/ghtml.plugin.d.ts +2 -2
  91. package/src/integrations/ghtml/ghtml.plugin.js +2 -2
  92. package/src/plugins/README.md +1 -0
  93. package/src/plugins/eco-component-meta-plugin.d.ts +12 -1
  94. package/src/plugins/eco-component-meta-plugin.js +26 -20
  95. package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
  96. package/src/plugins/foreign-jsx-override-plugin.js +35 -0
  97. package/src/plugins/integration-plugin.d.ts +99 -33
  98. package/src/plugins/integration-plugin.js +68 -21
  99. package/src/plugins/processor.d.ts +2 -2
  100. package/src/plugins/processor.js +2 -2
  101. package/src/plugins/source-transform.d.ts +46 -0
  102. package/src/plugins/source-transform.js +71 -0
  103. package/src/route-renderer/GRAPH.md +54 -84
  104. package/src/route-renderer/README.md +14 -20
  105. package/src/route-renderer/orchestration/component-render-context.d.ts +83 -0
  106. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  107. package/src/route-renderer/orchestration/integration-renderer.d.ts +233 -76
  108. package/src/route-renderer/orchestration/integration-renderer.js +500 -143
  109. package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +93 -0
  110. package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +155 -0
  111. package/src/route-renderer/orchestration/render-execution.service.d.ts +11 -71
  112. package/src/route-renderer/orchestration/render-execution.service.js +65 -80
  113. package/src/{eco/eco.utils.ts → route-renderer/orchestration/render-output.utils.d.ts} +10 -53
  114. package/src/route-renderer/orchestration/render-output.utils.js +65 -0
  115. package/src/route-renderer/orchestration/render-preparation.service.d.ts +2 -8
  116. package/src/route-renderer/orchestration/render-preparation.service.js +10 -17
  117. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  118. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  119. package/src/route-renderer/page-loading/dependency-resolver.d.ts +2 -2
  120. package/src/route-renderer/page-loading/dependency-resolver.js +10 -8
  121. package/src/route-renderer/page-loading/page-module-loader.d.ts +6 -4
  122. package/src/route-renderer/page-loading/page-module-loader.js +7 -5
  123. package/src/route-renderer/route-renderer.d.ts +5 -3
  124. package/src/route-renderer/route-renderer.js +13 -3
  125. package/src/router/README.md +79 -8
  126. package/src/router/client/navigation-coordinator.js +2 -2
  127. package/src/router/server/fs-router-scanner.d.ts +1 -1
  128. package/src/router/server/fs-router-scanner.js +6 -1
  129. package/src/router/server/fs-router.d.ts +1 -1
  130. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +3 -3
  131. package/src/services/assets/asset-processing-service/asset-processing.service.js +6 -6
  132. package/src/services/assets/asset-processing-service/asset.factory.d.ts +1 -1
  133. package/src/services/assets/asset-processing-service/asset.factory.js +2 -2
  134. package/src/services/assets/asset-processing-service/index.d.ts +5 -5
  135. package/src/services/assets/asset-processing-service/index.js +5 -5
  136. package/src/services/assets/asset-processing-service/processor.interface.d.ts +2 -2
  137. package/src/services/assets/asset-processing-service/processor.registry.d.ts +2 -2
  138. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +1 -1
  139. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +1 -1
  140. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +3 -3
  141. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +2 -2
  142. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -5
  143. package/src/services/assets/asset-processing-service/processors/index.js +5 -5
  144. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +2 -2
  145. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +1 -1
  146. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +4 -3
  147. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +15 -3
  148. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +3 -3
  149. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +1 -1
  150. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +2 -2
  151. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +1 -1
  152. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
  153. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +1 -1
  154. package/src/services/assets/browser-bundle.service.d.ts +1 -1
  155. package/src/services/assets/browser-bundle.service.js +2 -2
  156. package/src/services/html/html-rewriter-provider.service.js +4 -1
  157. package/src/services/html/html-transformer.service.d.ts +2 -2
  158. package/src/services/html/html-transformer.service.js +4 -10
  159. package/src/services/invalidation/development-invalidation.service.d.ts +1 -1
  160. package/src/services/invalidation/development-invalidation.service.js +1 -0
  161. package/src/services/module-loading/app-module-loader.service.d.ts +25 -0
  162. package/src/services/module-loading/app-module-loader.service.js +31 -0
  163. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +9 -1
  164. package/src/services/module-loading/app-server-module-transpiler.service.js +77 -2
  165. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  166. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  167. package/src/services/module-loading/module-loading-types.d.ts +2 -0
  168. package/src/{adapters/node/bootstrap-dependency-resolver.d.ts → services/module-loading/node-bootstrap-plugin.d.ts} +2 -24
  169. package/src/{adapters/node/bootstrap-dependency-resolver.js → services/module-loading/node-bootstrap-plugin.js} +42 -22
  170. package/src/services/module-loading/page-module-import.service.d.ts +4 -0
  171. package/src/services/module-loading/page-module-import.service.js +38 -9
  172. package/src/services/module-loading/server-module-transpiler.service.d.ts +3 -0
  173. package/src/services/module-loading/server-module-transpiler.service.js +4 -1
  174. package/src/services/runtime-state/dev-graph.service.d.ts +6 -6
  175. package/src/services/runtime-state/dev-graph.service.js +10 -10
  176. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +1 -1
  177. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +1 -1
  178. package/src/services/runtime-state/server-invalidation-state.service.d.ts +1 -1
  179. package/src/static-site-generator/static-site-generator.d.ts +2 -2
  180. package/src/static-site-generator/static-site-generator.js +1 -1
  181. package/src/{internal-types.d.ts → types/internal-types.d.ts} +24 -14
  182. package/src/{public-types.d.ts → types/public-types.d.ts} +30 -14
  183. package/src/types/public-types.js +0 -0
  184. package/src/utils/html-escaping.d.ts +7 -0
  185. package/src/utils/html-escaping.js +6 -0
  186. package/src/utils/locals-utils.d.ts +1 -1
  187. package/src/utils/parse-cli-args.d.ts +4 -1
  188. package/src/utils/parse-cli-args.js +16 -1
  189. package/src/utils/resolve-work-dir.js +1 -1
  190. package/src/watchers/project-watcher.d.ts +4 -4
  191. package/src/watchers/project-watcher.js +4 -10
  192. package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
  193. package/src/adapters/abstract/application-adapter.ts +0 -337
  194. package/src/adapters/abstract/router-adapter.ts +0 -30
  195. package/src/adapters/abstract/server-adapter.ts +0 -79
  196. package/src/adapters/bun/client-bridge.ts +0 -62
  197. package/src/adapters/bun/create-app.ts +0 -189
  198. package/src/adapters/bun/hmr-manager.ts +0 -409
  199. package/src/adapters/bun/index.ts +0 -2
  200. package/src/adapters/bun/server-adapter.ts +0 -499
  201. package/src/adapters/bun/server-lifecycle.ts +0 -124
  202. package/src/adapters/index.ts +0 -6
  203. package/src/adapters/node/bootstrap-dependency-resolver.ts +0 -301
  204. package/src/adapters/node/create-app.ts +0 -179
  205. package/src/adapters/node/index.d.ts +0 -6
  206. package/src/adapters/node/index.js +0 -11
  207. package/src/adapters/node/index.ts +0 -16
  208. package/src/adapters/node/node-client-bridge.ts +0 -79
  209. package/src/adapters/node/node-hmr-manager.ts +0 -381
  210. package/src/adapters/node/runtime-adapter.d.ts +0 -46
  211. package/src/adapters/node/runtime-adapter.js +0 -306
  212. package/src/adapters/node/runtime-adapter.ts +0 -439
  213. package/src/adapters/node/server-adapter.ts +0 -488
  214. package/src/adapters/node/static-content-server.ts +0 -239
  215. package/src/adapters/node/write-runtime-manifest.d.ts +0 -26
  216. package/src/adapters/node/write-runtime-manifest.js +0 -12
  217. package/src/adapters/node/write-runtime-manifest.ts +0 -38
  218. package/src/adapters/shared/api-response.ts +0 -104
  219. package/src/adapters/shared/application-adapter.ts +0 -199
  220. package/src/adapters/shared/define-api-handler.ts +0 -66
  221. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -140
  222. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -127
  223. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  224. package/src/adapters/shared/fs-server-response-matcher.ts +0 -205
  225. package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
  226. package/src/adapters/shared/hmr-html-response.ts +0 -52
  227. package/src/adapters/shared/render-context.ts +0 -120
  228. package/src/adapters/shared/runtime-bootstrap.ts +0 -79
  229. package/src/adapters/shared/server-adapter.ts +0 -489
  230. package/src/adapters/shared/server-route-handler.ts +0 -153
  231. package/src/adapters/shared/server-static-builder.ts +0 -166
  232. package/src/build/build-adapter.ts +0 -361
  233. package/src/build/build-manifest.ts +0 -54
  234. package/src/build/build-types.ts +0 -83
  235. package/src/build/dev-build-coordinator.ts +0 -221
  236. package/src/build/esbuild-build-adapter.ts +0 -559
  237. package/src/build/runtime-build-executor.ts +0 -34
  238. package/src/build/runtime-specifier-alias-plugin.ts +0 -58
  239. package/src/config/config-builder.ts +0 -706
  240. package/src/constants.ts +0 -54
  241. package/src/create-app.ts +0 -87
  242. package/src/dev/sc-server.ts +0 -143
  243. package/src/eco/component-render-context.d.ts +0 -105
  244. package/src/eco/component-render-context.js +0 -87
  245. package/src/eco/component-render-context.ts +0 -224
  246. package/src/eco/eco.ts +0 -242
  247. package/src/eco/eco.types.ts +0 -221
  248. package/src/eco/global-injector-map.ts +0 -112
  249. package/src/eco/lazy-injector-map.ts +0 -120
  250. package/src/eco/module-dependencies.ts +0 -75
  251. package/src/errors/http-error.ts +0 -72
  252. package/src/errors/index.ts +0 -2
  253. package/src/errors/locals-access-error.ts +0 -7
  254. package/src/global/app-logger.ts +0 -4
  255. package/src/hmr/client/hmr-runtime.ts +0 -152
  256. package/src/hmr/hmr-strategy.ts +0 -172
  257. package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
  258. package/src/hmr/hmr.test.e2e.ts +0 -66
  259. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  260. package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
  261. package/src/index.browser.ts +0 -3
  262. package/src/index.ts +0 -5
  263. package/src/integrations/ghtml/ghtml-renderer.ts +0 -96
  264. package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
  265. package/src/internal-types.ts +0 -232
  266. package/src/plugins/alias-resolver-plugin.ts +0 -63
  267. package/src/plugins/eco-component-meta-plugin.ts +0 -481
  268. package/src/plugins/integration-plugin.ts +0 -226
  269. package/src/plugins/processor.ts +0 -240
  270. package/src/plugins/runtime-capability.ts +0 -14
  271. package/src/public-types.ts +0 -1317
  272. package/src/route-renderer/component-graph/component-graph-executor.d.ts +0 -32
  273. package/src/route-renderer/component-graph/component-graph-executor.js +0 -31
  274. package/src/route-renderer/component-graph/component-graph-executor.ts +0 -84
  275. package/src/route-renderer/component-graph/component-graph.d.ts +0 -42
  276. package/src/route-renderer/component-graph/component-graph.js +0 -72
  277. package/src/route-renderer/component-graph/component-graph.ts +0 -159
  278. package/src/route-renderer/component-graph/component-marker.d.ts +0 -52
  279. package/src/route-renderer/component-graph/component-marker.js +0 -46
  280. package/src/route-renderer/component-graph/component-marker.ts +0 -117
  281. package/src/route-renderer/component-graph/component-reference.d.ts +0 -10
  282. package/src/route-renderer/component-graph/component-reference.js +0 -19
  283. package/src/route-renderer/component-graph/component-reference.ts +0 -29
  284. package/src/route-renderer/component-graph/marker-graph-resolver.d.ts +0 -77
  285. package/src/route-renderer/component-graph/marker-graph-resolver.js +0 -95
  286. package/src/route-renderer/component-graph/marker-graph-resolver.ts +0 -155
  287. package/src/route-renderer/orchestration/integration-renderer.ts +0 -790
  288. package/src/route-renderer/orchestration/render-execution.service.ts +0 -230
  289. package/src/route-renderer/orchestration/render-preparation.service.ts +0 -476
  290. package/src/route-renderer/page-loading/dependency-resolver.ts +0 -612
  291. package/src/route-renderer/page-loading/page-module-loader.ts +0 -181
  292. package/src/route-renderer/route-renderer.ts +0 -115
  293. package/src/router/client/link-intent.test.browser.ts +0 -51
  294. package/src/router/client/link-intent.ts +0 -92
  295. package/src/router/client/navigation-coordinator.ts +0 -433
  296. package/src/router/server/fs-router-scanner.ts +0 -219
  297. package/src/router/server/fs-router.ts +0 -122
  298. package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -401
  299. package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
  300. package/src/services/assets/asset-processing-service/assets.types.ts +0 -113
  301. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -95
  302. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
  303. package/src/services/assets/asset-processing-service/index.ts +0 -5
  304. package/src/services/assets/asset-processing-service/processor.interface.ts +0 -27
  305. package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
  306. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -82
  307. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -95
  308. package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
  309. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -66
  310. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -88
  311. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -85
  312. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
  313. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -80
  314. package/src/services/assets/browser-bundle.service.ts +0 -53
  315. package/src/services/cache/cache.types.ts +0 -126
  316. package/src/services/cache/index.ts +0 -18
  317. package/src/services/cache/memory-cache-store.ts +0 -130
  318. package/src/services/cache/page-cache-service.ts +0 -202
  319. package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
  320. package/src/services/html/html-rewriter-provider.service.ts +0 -103
  321. package/src/services/html/html-transformer.service.ts +0 -279
  322. package/src/services/invalidation/development-invalidation.service.ts +0 -261
  323. package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -52
  324. package/src/services/module-loading/page-module-import.service.ts +0 -200
  325. package/src/services/module-loading/server-loader.service.d.ts +0 -96
  326. package/src/services/module-loading/server-loader.service.js +0 -32
  327. package/src/services/module-loading/server-loader.service.ts +0 -130
  328. package/src/services/module-loading/server-module-transpiler.service.ts +0 -105
  329. package/src/services/runtime-manifest/node-runtime-manifest.service.d.ts +0 -35
  330. package/src/services/runtime-manifest/node-runtime-manifest.service.js +0 -60
  331. package/src/services/runtime-manifest/node-runtime-manifest.service.ts +0 -101
  332. package/src/services/runtime-state/dev-graph.service.ts +0 -217
  333. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
  334. package/src/services/runtime-state/runtime-specifier-registry.service.ts +0 -96
  335. package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
  336. package/src/services/validation/schema-validation-service.ts +0 -204
  337. package/src/services/validation/standard-schema.types.ts +0 -68
  338. package/src/static-site-generator/static-site-generator.ts +0 -462
  339. package/src/utils/css.d.ts +0 -1
  340. package/src/utils/css.js +0 -7
  341. package/src/utils/css.ts +0 -5
  342. package/src/utils/deep-merge.ts +0 -47
  343. package/src/utils/hash.ts +0 -5
  344. package/src/utils/html.ts +0 -1
  345. package/src/utils/invariant.ts +0 -15
  346. package/src/utils/locals-utils.ts +0 -37
  347. package/src/utils/parse-cli-args.ts +0 -83
  348. package/src/utils/path-utils.module.ts +0 -14
  349. package/src/utils/resolve-work-dir.ts +0 -45
  350. package/src/utils/runtime.ts +0 -44
  351. package/src/utils/server-utils.module.ts +0 -67
  352. package/src/watchers/project-watcher.test-helpers.ts +0 -41
  353. package/src/watchers/project-watcher.ts +0 -363
  354. /package/src/{constants.d.ts → config/constants.d.ts} +0 -0
  355. /package/src/{constants.js → config/constants.js} +0 -0
  356. /package/src/{internal-types.js → services/module-loading/module-loading-types.js} +0 -0
  357. /package/src/{public-types.js → types/internal-types.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
- }