@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
package/CHANGELOG.md CHANGED
@@ -4,28 +4,35 @@ All notable changes to `@ecopages/core` are documented here.
4
4
 
5
5
  > **Note:** Changelog tracking begins at version `0.2.0`. Changes prior to this release are not recorded here but are available in the git history.
6
6
 
7
- ## [UNRELEASED] — TBD
7
+ ## [0.2.1] — 2026-04-16
8
+
9
+ ### Features
10
+
11
+ - Added app-owned runtime and build ownership around `createApp()`, host module loading, the browser-safe `eco` export, `eco.html()`, `eco.layout()`, and the published `EcoPagesAppConfig` surface.
12
+
13
+ ### Refactoring
14
+
15
+ - Consolidated runtime state around shared module-loading services, app-owned build execution, and the universal `createApp()` boundary.
16
+ - Simplified route-renderer orchestration around renderer-owned boundary runtimes, shared string-boundary queue helpers, and a smaller component render context.
17
+ - Removed marker-era compatibility capture, the shared route-level fallback resolver, deprecated `@ecopages/core/node*` escape hatches, and other dead route-renderer internals.
8
18
 
9
19
  ### Bug Fixes
10
20
 
11
- - Fixed npm release packaging to publish rewritten internal dependency versions instead of unresolved `workspace:*` ranges.
21
+ - Fixed mixed-integration page, layout, document, and component rendering to resolve foreign boundaries inside their owning renderer across the built-in integrations.
22
+ - Fixed host/runtime module loading, published build-helper exports, asset output normalization, explicit render flows, and static or preview build stability across Bun, Node, Vite, and Nitro.
12
23
 
13
- ### Features & Architecture
24
+ ### Documentation
14
25
 
15
- - **Experimental Node.js Support**: Introduced a framework-owned thin-host bootstrap and runtime manifest flow for Node.js, providing cross-runtime parity while keeping the core agnostic.
16
- - **Architectural Consolidation**: Unified server-side loading, browser bundling, and HMR strategy orchestration across all runtimes using shared core services (`ServerModuleTranspiler`, `BrowserBundleService`).
17
- - **Build & Asset Refinement**: Introduced an internal `.eco` work directory to isolate development artifacts from production exports, and added `eco.html()`/`eco.layout()` for semantic component definitions.
18
- - **Performance & Reliability**: Refactored internal watchers and HMR dispatching to improve build stability during rapid development cycles.
26
+ - Added architecture and API documentation for config, plugins, services, adapters, HMR, routing, and rendering.
19
27
 
20
- ### Tests & Documentation
28
+ ### Tests
21
29
 
22
- - **Robust Regression Suite**: Added coverage for experimental Node.js paths, the new shared services, and cross-runtime file-change dispatching.
23
- - **Architecture Docs**: Added focused architecture and API documentation for config, plugins, services, adapters, HMR, router, and the rendering lifecycle.
30
+ - Added regression coverage for app-owned runtime services, Node fallback paths, and cross-runtime invalidation behavior.
24
31
 
25
32
  ---
26
33
 
27
34
  ## Migration Notes
28
35
 
29
- - `createApp` is now the recommended entrypoint. Import it from `@ecopages/core`.
36
+ - `createApp` is now the recommended entrypoint. Import it from `@ecopages/core/create-app`.
30
37
  - `defineApiHandler` keeps the same call shape, but the handler context is now explicitly runtime-agnostic.
31
38
  - The old explicit `renderingMode` config option has been removed and full orchestration is always active.
package/README.md CHANGED
@@ -4,10 +4,10 @@ The foundational engine for the Ecopages framework. It provides the core build p
4
4
 
5
5
  ## Overview
6
6
 
7
- Ecopages is an extensible static site generator (SSG) built for universal execution across Bun and Node.js. It embraces a strictly MPA (Multi-Page Application) architecture by default, rendering HTML at build-time or request-time, and hydrating interactive islands only where necessary.
7
+ Ecopages is an extensible static site generator (SSG) built around a Bun-first core with Node fallback support and Vite-hosted compatibility for advanced dev and build orchestration. It embraces a strictly MPA (Multi-Page Application) architecture by default, rendering HTML at build-time or request-time, and hydrating interactive islands only where necessary.
8
8
 
9
- - **Universal Support**: First-class, optimized execution on both **Bun** and **Node.js** runtimes, powered by a unified `createApp` factory.
10
- - **Fast by default**: Uses native ESM, optimized file watching, and esbuild for high-performance bundling and server-side rendering.
9
+ - **Runtime Boundary**: `createApp()` prefers Bun when available and falls back to Node otherwise. Vite and Nitro still own host-side dev and build orchestration.
10
+ - **Build Ownership**: Bun-native execution keeps a core-owned build path. Vite and Nitro own host-side transforms, module graph behavior, and deployment-oriented builds.
11
11
  - **Framework agnostic**: First-class support for KitaJS, Lit, React, and MDX via official integration plugins.
12
12
  - **Extensible**: Hook into the build process with custom processors or rendering integrations.
13
13
 
@@ -32,17 +32,13 @@ flowchart TD
32
32
  B --> E[Build executor]
33
33
  B --> F[Dev graph service]
34
34
  B --> G[Runtime specifier registry]
35
- B --> H[Node runtime manifest]
36
- H --> I[CLI launch plan]
37
- I --> J[Node thin host]
38
- J --> K[Node runtime adapter]
39
- K --> L[TranspilerServerLoader]
40
- L --> M[ServerModuleTranspiler]
41
- M --> N[PageModuleImportService]
42
- K --> O[Loaded app runtime]
43
- D --> P[BrowserBundleService]
44
- E --> M
45
- E --> P
35
+ B --> H[Host module loader boundary]
36
+ H --> I[PageModuleImportService]
37
+ E --> I
38
+ E --> J[BrowserBundleService]
39
+ I --> K[Runtime app adapter]
40
+ K --> L[Bun adapter or Node adapter]
41
+ D --> J
46
42
  ```
47
43
 
48
44
  ### Development Invalidation And HMR Flow
@@ -71,10 +67,11 @@ The manager/orchestration layer is core-owned, but framework-specific strategies
71
67
 
72
68
  ### Practical Summary
73
69
 
74
- - `ConfigBuilder` now seeds one app-owned build adapter, manifest, executor, dev graph, and runtime registry.
70
+ - `ConfigBuilder` now seeds one app-owned build ownership path, adapter, manifest, executor, dev graph, and runtime registry.
75
71
  - `BrowserBundleService` is the shared browser build seam used by HMR and asset-oriented browser output paths.
76
72
  - `ServerModuleTranspiler` is the shared server-side source loading seam used by runtime bootstrap and HMR metadata loading.
77
- - the Node thin-host path exists to keep startup framework-owned without putting source parsing or tsconfig ownership into the host itself.
73
+ - `createApp()` stays the universal runtime entrypoint, while Vite and Nitro hosts own their advanced dev and build workflows.
74
+ - esbuild remains only as a temporary Bun-path implementation detail and is not a strategic core dependency.
78
75
 
79
76
  ## Documentation Map
80
77
 
@@ -134,13 +131,13 @@ export default config;
134
131
 
135
132
  ### 2. Application Entry (`app.ts`)
136
133
 
137
- Start the application using the universal `createApp` factory. It automatically detects your runtime and applies the correct adapter.
134
+ Start the application using `createApp`. It will choose the Bun adapter when Bun is available and fall back to Node otherwise.
138
135
 
139
136
  ```typescript
140
- import { createApp } from '@ecopages/core';
137
+ import { createApp } from '@ecopages/core/create-app';
141
138
  import appConfig from './eco.config';
142
139
 
143
- const app = createApp({ appConfig });
140
+ const app = await createApp({ appConfig });
144
141
 
145
142
  await app.start();
146
143
  ```
@@ -201,11 +198,11 @@ Attach the handler in your `app.ts` entry:
201
198
 
202
199
  ```typescript
203
200
  // app.ts
204
- import { createApp } from '@ecopages/core';
201
+ import { createApp } from '@ecopages/core/create-app';
205
202
  import { helloWorld } from './handlers/hello';
206
203
  import appConfig from './eco.config';
207
204
 
208
- const app = createApp({ appConfig });
205
+ const app = await createApp({ appConfig });
209
206
 
210
207
  app.get(helloWorld); // Register the API handler
211
208
 
@@ -216,18 +213,18 @@ See the [official documentation](https://ecopages.app) for advanced usage, API h
216
213
 
217
214
  ## Import Structure
218
215
 
219
- Use the root package exports for standard authoring. The framework automatically detects your runtime and uses the optimal internal adapter:
216
+ Use the `create-app` subpath for runtime startup and the root package for standard authoring helpers:
220
217
 
221
218
  ```ts
222
- import { createApp, defineApiHandler, defineGroupHandler, eco } from '@ecopages/core';
219
+ import { createApp } from '@ecopages/core/create-app';
220
+ import { defineApiHandler, defineGroupHandler, eco } from '@ecopages/core';
223
221
  ```
224
222
 
225
223
  > [!NOTE]
226
- > `createApp` is now the recommended universal entrypoint over `EcopagesApp`.
224
+ > `createApp` is the recommended entrypoint over `EcopagesApp`.
227
225
 
228
226
  ### Runtime Escape Hatches
229
227
 
230
- Use runtime-specific subpaths only when you explicitly need Bun-native or Node-native APIs that bypass the universal abstractions:
228
+ Use runtime-specific subpaths only when you explicitly need Bun-native APIs that bypass the universal abstractions:
231
229
 
232
230
  - `@ecopages/core/bun`
233
- - `@ecopages/core/node`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ecopages/core",
3
- "version": "0.2.0-alpha.9",
3
+ "version": "0.2.1",
4
4
  "description": "Core package for Ecopages",
5
5
  "keywords": [
6
6
  "ecopages",
@@ -17,14 +17,14 @@
17
17
  "directory": "packages/core"
18
18
  },
19
19
  "dependencies": {
20
- "@ecopages/file-system": "0.2.0-alpha.9",
21
- "@ecopages/logger": "latest",
20
+ "@ecopages/file-system": "0.2.1",
21
+ "@ecopages/logger": "^0.2.3",
22
22
  "@ecopages/scripts-injector": "^0.1.3",
23
23
  "@worker-tools/html-rewriter": "0.1.0-pre.19",
24
- "chokidar": "^4.0.3",
25
- "esbuild": "^0.27.3",
24
+ "chokidar": "^5.0.0",
25
+ "esbuild": "^0.28.0",
26
26
  "ghtml": "^4.0.2",
27
- "oxc-parser": "^0.110.0",
27
+ "oxc-parser": "^0.124.0",
28
28
  "ws": "^8.18.0"
29
29
  },
30
30
  "exports": {
@@ -35,8 +35,9 @@
35
35
  "default": "./src/index.js"
36
36
  },
37
37
  "./create-app": {
38
- "types": "./src/create-app.d.ts",
39
- "default": "./src/create-app.js"
38
+ "import": "./src/adapters/create-app.js",
39
+ "types": "./src/adapters/create-app.d.ts",
40
+ "default": "./src/adapters/create-app.js"
40
41
  },
41
42
  "./route-renderer/integration-renderer": {
42
43
  "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
@@ -59,9 +60,14 @@
59
60
  "default": "./src/errors/locals-access-error.js"
60
61
  },
61
62
  "./eco": {
63
+ "browser": "./src/eco/eco.browser.js",
62
64
  "types": "./src/eco/eco.d.ts",
63
65
  "default": "./src/eco/eco.js"
64
66
  },
67
+ "./route-renderer/template-serialization": {
68
+ "types": "./src/route-renderer/orchestration/template-serialization.d.ts",
69
+ "default": "./src/route-renderer/orchestration/template-serialization.js"
70
+ },
65
71
  "./declarations": {
66
72
  "types": "./src/declarations.d.ts"
67
73
  },
@@ -73,8 +79,8 @@
73
79
  "default": "./src/config/config-builder.js"
74
80
  },
75
81
  "./constants": {
76
- "types": "./src/constants.d.ts",
77
- "default": "./src/constants.js"
82
+ "types": "./src/config/constants.d.ts",
83
+ "default": "./src/config/constants.js"
78
84
  },
79
85
  "./bun": {
80
86
  "types": "./src/adapters/bun/index.d.ts",
@@ -89,12 +95,24 @@
89
95
  "default": "./src/hmr/hmr-strategy.js"
90
96
  },
91
97
  "./internal-types": {
92
- "types": "./src/internal-types.d.ts"
98
+ "types": "./src/types/internal-types.d.ts"
93
99
  },
94
100
  "./services/asset-processing-service": {
95
101
  "types": "./src/services/assets/asset-processing-service/index.d.ts",
96
102
  "default": "./src/services/assets/asset-processing-service/index.js"
97
103
  },
104
+ "./services/invalidation/development-invalidation.service": {
105
+ "types": "./src/services/invalidation/development-invalidation.service.d.ts",
106
+ "default": "./src/services/invalidation/development-invalidation.service.js"
107
+ },
108
+ "./services/module-loading/app-server-module-transpiler.service": {
109
+ "types": "./src/services/module-loading/app-server-module-transpiler.service.d.ts",
110
+ "default": "./src/services/module-loading/app-server-module-transpiler.service.js"
111
+ },
112
+ "./host-module-loader": {
113
+ "types": "./src/services/module-loading/host-module-loader-registry.d.ts",
114
+ "default": "./src/services/module-loading/host-module-loader-registry.js"
115
+ },
98
116
  "./utils/deep-merge": {
99
117
  "types": "./src/utils/deep-merge.d.ts",
100
118
  "default": "./src/utils/deep-merge.js"
@@ -115,6 +133,10 @@
115
133
  "types": "./src/plugins/integration-plugin.d.ts",
116
134
  "default": "./src/plugins/integration-plugin.js"
117
135
  },
136
+ "./plugins/source-transform": {
137
+ "types": "./src/plugins/source-transform.d.ts",
138
+ "default": "./src/plugins/source-transform.js"
139
+ },
118
140
  "./build/build-types": {
119
141
  "types": "./src/build/build-types.d.ts",
120
142
  "default": "./src/build/build-types.js"
@@ -127,36 +149,23 @@
127
149
  "types": "./src/build/runtime-specifier-alias-plugin.d.ts",
128
150
  "default": "./src/build/runtime-specifier-alias-plugin.js"
129
151
  },
152
+ "./build/runtime-specifier-aliases": {
153
+ "types": "./src/build/runtime-specifier-aliases.d.ts",
154
+ "default": "./src/build/runtime-specifier-aliases.js"
155
+ },
156
+ "./plugins/foreign-jsx-override-plugin": {
157
+ "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
158
+ "default": "./src/plugins/foreign-jsx-override-plugin.js"
159
+ },
130
160
  "./adapters/bun/client-bridge": {
131
161
  "types": "./src/adapters/bun/client-bridge.d.ts",
132
162
  "default": "./src/adapters/bun/client-bridge.js"
133
163
  },
134
- "./node": {
135
- "types": "./src/adapters/node/index.d.ts",
136
- "default": "./src/adapters/node/index.js"
137
- },
138
- "./node/server-adapter": {
139
- "types": "./src/adapters/node/server-adapter.d.ts",
140
- "default": "./src/adapters/node/server-adapter.js"
141
- },
142
- "./node/create-app": {
143
- "types": "./src/adapters/node/create-app.d.ts",
144
- "default": "./src/adapters/node/create-app.js"
145
- },
146
- "./node/runtime-adapter": {
147
- "types": "./src/adapters/node/runtime-adapter.d.ts",
148
- "default": "./src/adapters/node/runtime-adapter.js"
149
- },
150
164
  "./html": {
151
165
  "import": "./src/utils/html.js",
152
166
  "default": "./src/utils/html.js",
153
167
  "types": "./src/utils/html.d.ts"
154
168
  },
155
- "./css": {
156
- "import": "./src/utils/css.js",
157
- "default": "./src/utils/css.js",
158
- "types": "./src/utils/css.d.ts"
159
- },
160
169
  "./hash": {
161
170
  "import": "./src/utils/hash.js",
162
171
  "default": "./src/utils/hash.js",
@@ -171,8 +180,9 @@
171
180
  "default": "./src/integrations/ghtml/ghtml.plugin.js"
172
181
  },
173
182
  "./create-app.ts": {
174
- "types": "./src/create-app.d.ts",
175
- "default": "./src/create-app.js"
183
+ "import": "./src/adapters/create-app.js",
184
+ "types": "./src/adapters/create-app.d.ts",
185
+ "default": "./src/adapters/create-app.js"
176
186
  },
177
187
  "./route-renderer/integration-renderer.ts": {
178
188
  "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
@@ -195,9 +205,14 @@
195
205
  "default": "./src/errors/locals-access-error.js"
196
206
  },
197
207
  "./eco.ts": {
208
+ "browser": "./src/eco/eco.browser.js",
198
209
  "types": "./src/eco/eco.d.ts",
199
210
  "default": "./src/eco/eco.js"
200
211
  },
212
+ "./route-renderer/template-serialization.ts": {
213
+ "types": "./src/route-renderer/orchestration/template-serialization.d.ts",
214
+ "default": "./src/route-renderer/orchestration/template-serialization.js"
215
+ },
201
216
  "./declarations.ts": {
202
217
  "types": "./src/declarations.d.ts"
203
218
  },
@@ -209,8 +224,8 @@
209
224
  "default": "./src/config/config-builder.js"
210
225
  },
211
226
  "./constants.ts": {
212
- "types": "./src/constants.d.ts",
213
- "default": "./src/constants.js"
227
+ "types": "./src/config/constants.d.ts",
228
+ "default": "./src/config/constants.js"
214
229
  },
215
230
  "./bun.ts": {
216
231
  "types": "./src/adapters/bun/index.d.ts",
@@ -225,12 +240,24 @@
225
240
  "default": "./src/hmr/hmr-strategy.js"
226
241
  },
227
242
  "./internal-types.ts": {
228
- "types": "./src/internal-types.d.ts"
243
+ "types": "./src/types/internal-types.d.ts"
229
244
  },
230
245
  "./services/asset-processing-service.ts": {
231
246
  "types": "./src/services/assets/asset-processing-service/index.d.ts",
232
247
  "default": "./src/services/assets/asset-processing-service/index.js"
233
248
  },
249
+ "./services/invalidation/development-invalidation.service.ts": {
250
+ "types": "./src/services/invalidation/development-invalidation.service.d.ts",
251
+ "default": "./src/services/invalidation/development-invalidation.service.js"
252
+ },
253
+ "./services/module-loading/app-server-module-transpiler.service.ts": {
254
+ "types": "./src/services/module-loading/app-server-module-transpiler.service.d.ts",
255
+ "default": "./src/services/module-loading/app-server-module-transpiler.service.js"
256
+ },
257
+ "./host-module-loader.ts": {
258
+ "types": "./src/services/module-loading/host-module-loader-registry.d.ts",
259
+ "default": "./src/services/module-loading/host-module-loader-registry.js"
260
+ },
234
261
  "./utils/deep-merge.ts": {
235
262
  "types": "./src/utils/deep-merge.d.ts",
236
263
  "default": "./src/utils/deep-merge.js"
@@ -251,6 +278,10 @@
251
278
  "types": "./src/plugins/integration-plugin.d.ts",
252
279
  "default": "./src/plugins/integration-plugin.js"
253
280
  },
281
+ "./plugins/source-transform.ts": {
282
+ "types": "./src/plugins/source-transform.d.ts",
283
+ "default": "./src/plugins/source-transform.js"
284
+ },
254
285
  "./build/build-types.ts": {
255
286
  "types": "./src/build/build-types.d.ts",
256
287
  "default": "./src/build/build-types.js"
@@ -263,36 +294,23 @@
263
294
  "types": "./src/build/runtime-specifier-alias-plugin.d.ts",
264
295
  "default": "./src/build/runtime-specifier-alias-plugin.js"
265
296
  },
297
+ "./build/runtime-specifier-aliases.ts": {
298
+ "types": "./src/build/runtime-specifier-aliases.d.ts",
299
+ "default": "./src/build/runtime-specifier-aliases.js"
300
+ },
301
+ "./plugins/foreign-jsx-override-plugin.ts": {
302
+ "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
303
+ "default": "./src/plugins/foreign-jsx-override-plugin.js"
304
+ },
266
305
  "./adapters/bun/client-bridge.ts": {
267
306
  "types": "./src/adapters/bun/client-bridge.d.ts",
268
307
  "default": "./src/adapters/bun/client-bridge.js"
269
308
  },
270
- "./node.ts": {
271
- "types": "./src/adapters/node/index.d.ts",
272
- "default": "./src/adapters/node/index.js"
273
- },
274
- "./node/server-adapter.ts": {
275
- "types": "./src/adapters/node/server-adapter.d.ts",
276
- "default": "./src/adapters/node/server-adapter.js"
277
- },
278
- "./node/create-app.ts": {
279
- "types": "./src/adapters/node/create-app.d.ts",
280
- "default": "./src/adapters/node/create-app.js"
281
- },
282
- "./node/runtime-adapter.ts": {
283
- "types": "./src/adapters/node/runtime-adapter.d.ts",
284
- "default": "./src/adapters/node/runtime-adapter.js"
285
- },
286
309
  "./html.ts": {
287
310
  "import": "./src/utils/html.js",
288
311
  "default": "./src/utils/html.js",
289
312
  "types": "./src/utils/html.d.ts"
290
313
  },
291
- "./css.ts": {
292
- "import": "./src/utils/css.js",
293
- "default": "./src/utils/css.js",
294
- "types": "./src/utils/css.d.ts"
295
- },
296
314
  "./hash.ts": {
297
315
  "import": "./src/utils/hash.js",
298
316
  "default": "./src/utils/hash.js",
@@ -4,7 +4,7 @@ This directory contains the runtime-host integration layer for Ecopages.
4
4
 
5
5
  ## Purpose
6
6
 
7
- Adapters translate app-owned core services into concrete runtime behavior on Bun and Node.
7
+ Adapters translate app-owned core services into concrete runtime behavior at the host boundary. Bun remains the direct core runtime, while Node compatibility is driven by the Ecopages CLI thin-host path and reuses internal adapter pieces here.
8
8
 
9
9
  They are responsible for:
10
10
 
@@ -23,7 +23,7 @@ They are not responsible for:
23
23
  ## Main Areas
24
24
 
25
25
  - `bun/`: Bun server adapter, lifecycle coordination, bridge, and HMR transport
26
- - `node/`: Node server adapter plus thin-host runtime bootstrap path
26
+ - `node/`: internal Node compatibility adapter pieces used by the CLI thin-host path
27
27
  - `shared/`: runtime-neutral adapter helpers used by both hosts
28
28
 
29
29
  ## Ownership Boundary
@@ -6,15 +6,40 @@
6
6
  *
7
7
  * @module ApplicationAdapter
8
8
  */
9
- import type { EcoPagesAppConfig } from '../../internal-types.js';
10
- import type { ApiHandler, ApiHandlerContext, ErrorHandler, Middleware, RouteOptions, StaticRoute, ViewLoader } from '../../public-types.js';
9
+ import type { SourceModuleLoader } from '../../services/module-loading/module-loading-types.js';
10
+ import type { EcoPagesAppConfig } from '../../types/internal-types.js';
11
+ import type { ApiHandler, ApiHandlerContext, ErrorHandler, Middleware, RouteOptions, StaticRoute, ViewLoader } from '../../types/public-types.js';
11
12
  import { type ReturnParseCliArgs } from '../../utils/parse-cli-args.js';
13
+ /**
14
+ * Runtime bootstrap options layered on top of the app config.
15
+ *
16
+ * These options let a host runtime embed Ecopages without mutating process
17
+ * globals or app runtime state before calling `createApp()`.
18
+ */
19
+ export interface ApplicationRuntimeOptions {
20
+ /**
21
+ * Forces the app into the embedded-runtime CLI mode used by host
22
+ * environments.
23
+ *
24
+ * When enabled and no explicit `hostModuleLoader` is provided, the
25
+ * adapter auto-detects a host module loader from the global scope.
26
+ */
27
+ embedded?: boolean;
28
+ /**
29
+ * Explicit source module loader for request-time imports.
30
+ *
31
+ * When omitted in embedded mode, the adapter attempts automatic
32
+ * detection from globals set by the host environment.
33
+ */
34
+ hostModuleLoader?: SourceModuleLoader;
35
+ }
12
36
  /**
13
37
  * Configuration options for application adapters
14
38
  */
15
39
  export interface ApplicationAdapterOptions {
16
40
  appConfig: EcoPagesAppConfig;
17
41
  serverOptions?: Record<string, any>;
42
+ runtime?: ApplicationRuntimeOptions;
18
43
  /**
19
44
  * Options for clearing the output directory before starting the server
20
45
  * @default false
@@ -43,6 +68,7 @@ export declare abstract class AbstractApplicationAdapter<TOptions extends Applic
43
68
  protected appConfig: EcoPagesAppConfig;
44
69
  protected serverOptions: Record<string, any>;
45
70
  protected cliArgs: ReturnParseCliArgs;
71
+ protected runtimeOptions: ApplicationRuntimeOptions;
46
72
  protected apiHandlers: ApiHandler[];
47
73
  protected staticRoutes: StaticRoute[];
48
74
  protected errorHandler?: ErrorHandler;
@@ -1,4 +1,9 @@
1
1
  import { appLogger } from "../../global/app-logger.js";
2
+ import {
3
+ getAppModuleLoader,
4
+ setAppHostModuleLoader
5
+ } from "../../services/module-loading/app-server-module-transpiler.service.js";
6
+ import { getHostModuleLoader } from "../../services/module-loading/host-module-loader-registry.js";
2
7
  import { invariant } from "../../utils/invariant.js";
3
8
  import { fileSystem } from "@ecopages/file-system";
4
9
  import { parseCliArgs } from "../../utils/parse-cli-args.js";
@@ -6,20 +11,27 @@ class AbstractApplicationAdapter {
6
11
  appConfig;
7
12
  serverOptions;
8
13
  cliArgs;
14
+ runtimeOptions;
9
15
  apiHandlers = [];
10
16
  staticRoutes = [];
11
17
  errorHandler;
12
18
  constructor(options) {
13
19
  this.appConfig = options.appConfig;
14
20
  this.serverOptions = options.serverOptions || {};
15
- this.cliArgs = parseCliArgs();
21
+ this.runtimeOptions = options.runtime ?? {};
22
+ this.cliArgs = parseCliArgs({ embeddedRuntime: this.runtimeOptions.embedded });
23
+ const hostModuleLoader = this.runtimeOptions.hostModuleLoader ?? (this.runtimeOptions.embedded ? getHostModuleLoader() : void 0);
24
+ if (hostModuleLoader) {
25
+ setAppHostModuleLoader(this.appConfig, hostModuleLoader);
26
+ }
27
+ getAppModuleLoader(this.appConfig);
16
28
  if (options.clearOutput) {
17
29
  this.clearDistFolder().catch((error) => {
18
30
  appLogger.error("Error clearing dist folder", error);
19
31
  });
20
32
  }
21
33
  }
22
- async clearDistFolder(_filter = []) {
34
+ async clearDistFolder() {
23
35
  const distPath = this.appConfig.absolutePaths.distDir;
24
36
  const distExists = fileSystem.exists(distPath);
25
37
  if (!distExists) return;
@@ -6,7 +6,7 @@
6
6
  *
7
7
  * @module RouterAdapter
8
8
  */
9
- import type { Routes } from '../../internal-types.js';
9
+ import type { Routes } from '../../types/internal-types.js';
10
10
  /**
11
11
  * Abstract base class for router adapters across different runtimes
12
12
  */
@@ -6,8 +6,8 @@
6
6
  *
7
7
  * @module ServerAdapter
8
8
  */
9
- import type { EcoPagesAppConfig } from '../../internal-types.js';
10
- import type { ApiHandler } from '../../public-types.js';
9
+ import type { EcoPagesAppConfig } from '../../types/internal-types.js';
10
+ import type { ApiHandler } from '../../types/public-types.js';
11
11
  /**
12
12
  * Configuration options for all server adapters
13
13
  */
@@ -1,5 +1,5 @@
1
1
  import type { ServerWebSocket } from 'bun';
2
- import type { ClientBridgeEvent, IClientBridge } from '../../public-types';
2
+ import type { ClientBridgeEvent, IClientBridge } from '../../types/public-types.js';
3
3
  type BunSocket = ServerWebSocket<unknown>;
4
4
  /**
5
5
  * Manages WebSocket subscribers and broadcasts development events.
@@ -8,18 +8,10 @@
8
8
  * @module EcopagesApp
9
9
  */
10
10
  import type { Server } from 'bun';
11
- import type { EcoPagesAppConfig } from '../../internal-types.js';
12
- import type { ApiHandlerContext, RouteGroupBuilder } from '../../public-types.js';
13
- import { type ApplicationAdapterOptions } from '../abstract/application-adapter.js';
11
+ import type { ApiHandlerContext, RouteGroupBuilder } from '../../types/public-types.js';
14
12
  import { SharedApplicationAdapter } from '../shared/application-adapter.js';
13
+ import type { EcopagesAppOptions } from '../create-app.js';
15
14
  import { type BunServerAdapterResult } from './server-adapter.js';
16
- /**
17
- * Configuration options for the Bun application adapter
18
- */
19
- export interface EcopagesAppOptions extends ApplicationAdapterOptions {
20
- appConfig: EcoPagesAppConfig;
21
- serverOptions?: Record<string, any>;
22
- }
23
15
  /**
24
16
  * Bun-specific route group builder that properly infers route params from path patterns.
25
17
  * When you define a route like `/posts/:slug`, the handler context will have
@@ -34,7 +26,7 @@ export type BunRouteGroupBuilder<WebSocketData = undefined, TContext extends Api
34
26
  * This class extends the {@link AbstractApplicationAdapter}
35
27
  * and provides methods for handling HTTP requests and managing the server.
36
28
  */
37
- export declare class EcopagesApp<WebSocketData = undefined> extends SharedApplicationAdapter<EcopagesAppOptions, Server<WebSocketData>, Request> {
29
+ export declare class BunEcopagesApp<WebSocketData = undefined> extends SharedApplicationAdapter<EcopagesAppOptions, Server<WebSocketData>, Request> {
38
30
  serverAdapter: BunServerAdapterResult | undefined;
39
31
  private server;
40
32
  fetch(request: Request): Promise<Response>;
@@ -57,4 +49,4 @@ export declare class EcopagesApp<WebSocketData = undefined> extends SharedApplic
57
49
  /**
58
50
  * Factory function to create a Bun application
59
51
  */
60
- export declare function createApp<WebSocketData = undefined>(options: EcopagesAppOptions): Promise<EcopagesApp<WebSocketData>>;
52
+ export declare function createApp<WebSocketData = undefined>(options: EcopagesAppOptions): Promise<BunEcopagesApp<WebSocketData>>;
@@ -1,10 +1,9 @@
1
- import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../constants.js";
1
+ import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../config/constants.js";
2
2
  import { appLogger } from "../../global/app-logger.js";
3
3
  import { getBunRuntime } from "../../utils/runtime.js";
4
- import {} from "../abstract/application-adapter.js";
5
4
  import { SharedApplicationAdapter } from "../shared/application-adapter.js";
6
5
  import { createBunServerAdapter } from "./server-adapter.js";
7
- class EcopagesApp extends SharedApplicationAdapter {
6
+ class BunEcopagesApp extends SharedApplicationAdapter {
8
7
  serverAdapter;
9
8
  server = null;
10
9
  async fetch(request) {
@@ -109,9 +108,9 @@ class EcopagesApp extends SharedApplicationAdapter {
109
108
  }
110
109
  }
111
110
  async function createApp(options) {
112
- return new EcopagesApp(options);
111
+ return new BunEcopagesApp(options);
113
112
  }
114
113
  export {
115
- EcopagesApp,
114
+ BunEcopagesApp,
116
115
  createApp
117
116
  };
@@ -1,9 +1,9 @@
1
1
  import type { WebSocketHandler } from 'bun';
2
- import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager } from '../../internal-types';
2
+ import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager } from '../../types/internal-types.js';
3
3
  import type { EcoBuildPlugin } from '../../build/build-types.js';
4
- import { type HmrStrategy } from '../../hmr/hmr-strategy';
5
- import type { ClientBridge } from './client-bridge';
6
- import type { ClientBridgeEvent } from '../../public-types';
4
+ import { type HmrStrategy } from '../../hmr/hmr-strategy.js';
5
+ import type { ClientBridge } from './client-bridge.js';
6
+ import type { ClientBridgeEvent } from '../../types/public-types.js';
7
7
  type BunSocketHandler = WebSocketHandler<unknown>;
8
8
  export interface HmrManagerParams {
9
9
  appConfig: EcoPagesAppConfig;