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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (471) hide show
  1. package/README.md +79 -28
  2. package/package.json +94 -116
  3. package/src/adapters/README.md +2 -2
  4. package/src/adapters/abstract/application-adapter.d.ts +28 -2
  5. package/src/adapters/abstract/application-adapter.js +14 -2
  6. package/src/adapters/abstract/router-adapter.d.ts +1 -1
  7. package/src/adapters/abstract/server-adapter.d.ts +2 -2
  8. package/src/adapters/bun/client-bridge.d.ts +1 -1
  9. package/src/adapters/bun/create-app.d.ts +12 -12
  10. package/src/adapters/bun/create-app.js +64 -41
  11. package/src/adapters/bun/hmr-manager.d.ts +19 -115
  12. package/src/adapters/bun/hmr-manager.js +25 -301
  13. package/src/adapters/bun/index.d.ts +1 -1
  14. package/src/adapters/bun/index.js +2 -2
  15. package/src/adapters/bun/runtime-host.d.ts +52 -0
  16. package/src/adapters/bun/runtime-host.js +56 -0
  17. package/src/adapters/bun/server-adapter.d.ts +100 -32
  18. package/src/adapters/bun/server-adapter.js +142 -65
  19. package/src/adapters/bun/static-preview-host.d.ts +28 -0
  20. package/src/adapters/bun/static-preview-host.js +45 -0
  21. package/src/{create-app.d.ts → adapters/create-app.d.ts} +9 -6
  22. package/src/{create-app.js → adapters/create-app.js} +4 -4
  23. package/src/adapters/index.d.ts +1 -5
  24. package/src/adapters/index.js +1 -7
  25. package/src/adapters/node/create-app.d.ts +15 -12
  26. package/src/adapters/node/create-app.js +34 -85
  27. package/src/adapters/node/http-request-bridge.d.ts +57 -0
  28. package/src/adapters/node/http-request-bridge.js +118 -0
  29. package/src/adapters/node/node-client-bridge.d.ts +1 -1
  30. package/src/adapters/node/node-hmr-manager.d.ts +22 -103
  31. package/src/adapters/node/node-hmr-manager.js +26 -289
  32. package/src/adapters/node/runtime-host.d.ts +57 -0
  33. package/src/adapters/node/runtime-host.js +92 -0
  34. package/src/adapters/node/server-adapter-dependencies.d.ts +19 -0
  35. package/src/adapters/node/server-adapter-dependencies.js +18 -0
  36. package/src/adapters/node/server-adapter.d.ts +19 -42
  37. package/src/adapters/node/server-adapter.js +94 -139
  38. package/src/adapters/node/static-content-server.d.ts +1 -1
  39. package/src/adapters/node/static-content-server.js +1 -1
  40. package/src/adapters/node/static-preview-host.d.ts +55 -0
  41. package/src/adapters/node/static-preview-host.js +68 -0
  42. package/src/adapters/shared/application-adapter.d.ts +1 -1
  43. package/src/adapters/shared/define-api-handler.d.ts +1 -1
  44. package/src/adapters/shared/explicit-static-render-preparation.d.ts +25 -0
  45. package/src/adapters/shared/explicit-static-render-preparation.js +26 -0
  46. package/src/adapters/shared/explicit-static-route-matcher.d.ts +7 -4
  47. package/src/adapters/shared/explicit-static-route-matcher.js +14 -16
  48. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +7 -10
  49. package/src/adapters/shared/file-route-middleware-pipeline.js +2 -11
  50. package/src/adapters/shared/fs-server-response-factory.d.ts +14 -10
  51. package/src/adapters/shared/fs-server-response-factory.js +11 -27
  52. package/src/adapters/shared/fs-server-response-matcher.d.ts +18 -18
  53. package/src/adapters/shared/fs-server-response-matcher.js +72 -46
  54. package/src/adapters/shared/hmr-entrypoint-registrar.js +1 -1
  55. package/src/adapters/shared/hmr-html-response.d.ts +1 -1
  56. package/src/adapters/shared/hmr-html-response.js +4 -3
  57. package/src/adapters/shared/render-context.d.ts +5 -3
  58. package/src/adapters/shared/render-context.js +24 -1
  59. package/src/adapters/shared/runtime-app-bootstrap.d.ts +26 -0
  60. package/src/adapters/shared/runtime-app-bootstrap.js +46 -0
  61. package/src/adapters/shared/runtime-host.d.ts +12 -0
  62. package/src/adapters/shared/server-adapter.d.ts +22 -11
  63. package/src/adapters/shared/server-adapter.js +183 -133
  64. package/src/adapters/shared/server-route-handler.d.ts +5 -5
  65. package/src/adapters/shared/server-route-handler.js +4 -4
  66. package/src/adapters/shared/server-static-builder.d.ts +8 -7
  67. package/src/adapters/shared/server-static-builder.js +6 -5
  68. package/src/adapters/shared/shared-hmr-manager.d.ts +59 -0
  69. package/src/adapters/shared/shared-hmr-manager.js +241 -0
  70. package/src/adapters/shared/static-preview-host.d.ts +10 -0
  71. package/src/build/README.md +57 -67
  72. package/src/build/browser-runtime-manifest.d.ts +31 -0
  73. package/src/build/browser-runtime-manifest.js +61 -0
  74. package/src/build/browser-runtime-plugin-helpers.d.ts +26 -0
  75. package/src/build/browser-runtime-plugin-helpers.js +14 -0
  76. package/src/build/browser-runtime-plugin.d.ts +78 -0
  77. package/src/build/browser-runtime-plugin.js +173 -0
  78. package/src/build/build-adapter.d.ts +384 -63
  79. package/src/build/build-adapter.js +129 -54
  80. package/src/build/build-manifest.d.ts +6 -0
  81. package/src/build/build-manifest.js +21 -2
  82. package/src/build/build-types.d.ts +2 -2
  83. package/src/build/rolldown-adapter-helpers.d.ts +58 -0
  84. package/src/build/rolldown-adapter-helpers.js +265 -0
  85. package/src/build/rolldown-build-adapter.d.ts +28 -0
  86. package/src/build/rolldown-build-adapter.js +65 -0
  87. package/src/build/rolldown-dev-build-adapter.d.ts +82 -0
  88. package/src/build/rolldown-dev-build-adapter.js +166 -0
  89. package/src/build/rolldown-plugin-bridge.d.ts +59 -0
  90. package/src/build/rolldown-plugin-bridge.js +199 -0
  91. package/src/build/runtime-build-executor.d.ts +15 -7
  92. package/src/build/runtime-build-executor.js +8 -9
  93. package/src/build/runtime-build-output-normalizer.d.ts +3 -0
  94. package/src/build/runtime-build-output-normalizer.js +111 -0
  95. package/src/build/serialized-build-executor.d.ts +64 -0
  96. package/src/build/serialized-build-executor.js +63 -0
  97. package/src/build/server-side-css-shim-plugin.d.ts +41 -0
  98. package/src/build/server-side-css-shim-plugin.js +35 -0
  99. package/src/cache/index.d.ts +6 -0
  100. package/src/cache/index.js +6 -0
  101. package/src/cache/module-parse-cache.d.ts +65 -0
  102. package/src/cache/module-parse-cache.js +75 -0
  103. package/src/config/README.md +5 -2
  104. package/src/config/config-builder.d.ts +41 -13
  105. package/src/config/config-builder.js +62 -24
  106. package/src/declarations.d.ts +1 -1
  107. package/src/dev/host-runtime.d.ts +10 -0
  108. package/src/dev/host-runtime.js +24 -0
  109. package/src/dev/sc-server.d.ts +1 -1
  110. package/src/dev/sc-server.js +1 -1
  111. package/src/eco/eco.browser.d.ts +2 -0
  112. package/src/eco/eco.browser.js +88 -0
  113. package/src/eco/eco.js +50 -45
  114. package/src/eco/eco.types.d.ts +60 -8
  115. package/src/eco/eco.utils.d.ts +1 -40
  116. package/src/eco/eco.utils.js +5 -35
  117. package/src/eco/global-injector-map.d.ts +3 -3
  118. package/src/eco/global-injector-map.js +2 -2
  119. package/src/eco/lazy-injector-map.d.ts +2 -2
  120. package/src/errors/index.d.ts +1 -0
  121. package/src/errors/index.js +3 -1
  122. package/src/hmr/client/hmr-runtime.js +9 -1
  123. package/src/hmr/hmr-strategy.d.ts +16 -13
  124. package/src/hmr/hmr-strategy.js +22 -7
  125. package/src/hmr/strategies/default-hmr-strategy.d.ts +2 -2
  126. package/src/hmr/strategies/default-hmr-strategy.js +1 -1
  127. package/src/hmr/strategies/js-hmr-strategy.d.ts +4 -9
  128. package/src/hmr/strategies/js-hmr-strategy.js +5 -10
  129. package/src/index.browser.d.ts +2 -2
  130. package/src/index.browser.js +1 -1
  131. package/src/index.d.ts +3 -2
  132. package/src/index.js +15 -4
  133. package/src/integrations/ghtml/ghtml-renderer.d.ts +2 -1
  134. package/src/integrations/ghtml/ghtml-renderer.js +24 -29
  135. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  136. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  137. package/src/integrations/ghtml/ghtml.plugin.d.ts +2 -6
  138. package/src/integrations/ghtml/ghtml.plugin.js +3 -4
  139. package/src/plugins/README.md +1 -0
  140. package/src/plugins/alias-resolver-cache.d.ts +68 -0
  141. package/src/plugins/alias-resolver-cache.js +106 -0
  142. package/src/plugins/alias-resolver-plugin.d.ts +5 -1
  143. package/src/plugins/alias-resolver-plugin.js +19 -7
  144. package/src/plugins/eco-component-meta-plugin.d.ts +12 -1
  145. package/src/plugins/eco-component-meta-plugin.js +43 -25
  146. package/src/plugins/foreign-jsx-override-plugin.d.ts +33 -0
  147. package/src/plugins/foreign-jsx-override-plugin.js +41 -0
  148. package/src/plugins/integration-plugin.d.ts +136 -42
  149. package/src/plugins/integration-plugin.js +99 -31
  150. package/src/plugins/processor.d.ts +4 -2
  151. package/src/plugins/processor.js +8 -3
  152. package/src/plugins/source-transform.d.ts +46 -0
  153. package/src/plugins/source-transform.js +71 -0
  154. package/src/route-renderer/GRAPH.md +80 -318
  155. package/src/route-renderer/README.md +74 -78
  156. package/src/route-renderer/orchestration/component-render-context.d.ts +97 -0
  157. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  158. package/src/route-renderer/orchestration/declared-ownership-graph.d.ts +18 -0
  159. package/src/route-renderer/orchestration/declared-ownership-graph.js +34 -0
  160. package/src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts +110 -0
  161. package/src/route-renderer/orchestration/foreign-subtree-execution.service.js +233 -0
  162. package/src/route-renderer/orchestration/integration-renderer.d.ts +290 -128
  163. package/src/route-renderer/orchestration/integration-renderer.js +660 -258
  164. package/src/route-renderer/orchestration/ownership-planning.service.d.ts +24 -0
  165. package/src/route-renderer/orchestration/ownership-planning.service.js +63 -0
  166. package/src/route-renderer/orchestration/ownership-validation.service.d.ts +29 -0
  167. package/src/route-renderer/orchestration/ownership-validation.service.js +53 -0
  168. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +3 -0
  169. package/src/route-renderer/orchestration/processed-asset-dedupe.js +27 -0
  170. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.d.ts +91 -0
  171. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.js +170 -0
  172. package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
  173. package/src/route-renderer/orchestration/render-output.utils.js +171 -0
  174. package/src/route-renderer/orchestration/route-render-orchestrator.d.ts +156 -0
  175. package/src/route-renderer/orchestration/route-render-orchestrator.js +577 -0
  176. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  177. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  178. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
  179. package/src/route-renderer/page-loading/component-dependency-collection.js +132 -0
  180. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
  181. package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
  182. package/src/route-renderer/page-loading/dependency-resolver.d.ts +2 -2
  183. package/src/route-renderer/page-loading/dependency-resolver.js +27 -354
  184. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
  185. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
  186. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
  187. package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
  188. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
  189. package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
  190. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
  191. package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
  192. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
  193. package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
  194. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
  195. package/src/route-renderer/page-loading/page-dependency-bundling.js +137 -0
  196. package/src/route-renderer/page-loading/page-module-loader.d.ts +7 -4
  197. package/src/route-renderer/page-loading/page-module-loader.js +8 -5
  198. package/src/route-renderer/route-renderer.d.ts +31 -23
  199. package/src/route-renderer/route-renderer.js +17 -24
  200. package/src/router/README.md +76 -8
  201. package/src/router/client/navigation-coordinator.d.ts +20 -0
  202. package/src/router/client/navigation-coordinator.js +2 -2
  203. package/src/router/server/route-registry.d.ts +78 -0
  204. package/src/router/server/route-registry.js +262 -0
  205. package/src/services/README.md +1 -2
  206. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
  207. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
  208. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +3 -20
  209. package/src/services/assets/asset-processing-service/asset-processing.service.js +52 -98
  210. package/src/services/assets/asset-processing-service/asset.factory.d.ts +1 -1
  211. package/src/services/assets/asset-processing-service/asset.factory.js +2 -2
  212. package/src/services/assets/asset-processing-service/assets.types.d.ts +14 -0
  213. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +2 -0
  214. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +1 -0
  215. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
  216. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
  217. package/src/services/assets/asset-processing-service/index.d.ts +6 -5
  218. package/src/services/assets/asset-processing-service/index.js +6 -5
  219. package/src/services/assets/asset-processing-service/page-package.d.ts +6 -0
  220. package/src/services/assets/asset-processing-service/page-package.js +80 -0
  221. package/src/services/assets/asset-processing-service/processor.interface.d.ts +2 -2
  222. package/src/services/assets/asset-processing-service/processor.registry.d.ts +2 -2
  223. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +1 -1
  224. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +3 -2
  225. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +10 -5
  226. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +69 -5
  227. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -5
  228. package/src/services/assets/asset-processing-service/processors/index.js +5 -5
  229. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +3 -2
  230. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +66 -3
  231. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +4 -3
  232. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +27 -6
  233. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +38 -3
  234. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +57 -6
  235. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +5 -2
  236. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +39 -5
  237. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
  238. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +5 -2
  239. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
  240. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
  241. package/src/services/assets/browser-bundle.service.d.ts +44 -3
  242. package/src/services/assets/browser-bundle.service.js +15 -7
  243. package/src/services/html/html-rewriter-provider.service.d.ts +3 -0
  244. package/src/services/html/html-rewriter-provider.service.js +4 -1
  245. package/src/services/html/html-transformer.service.d.ts +22 -3
  246. package/src/services/html/html-transformer.service.js +101 -35
  247. package/src/services/invalidation/development-invalidation.service.d.ts +1 -1
  248. package/src/services/invalidation/development-invalidation.service.js +1 -0
  249. package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
  250. package/src/services/module-loading/app-module-loader.service.js +0 -0
  251. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +9 -1
  252. package/src/services/module-loading/app-server-module-transpiler.service.js +102 -6
  253. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  254. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  255. package/src/services/module-loading/module-loading-types.d.ts +2 -0
  256. package/src/services/module-loading/module-loading-types.js +0 -0
  257. package/src/services/module-loading/page-module-import.service.d.ts +32 -8
  258. package/src/services/module-loading/page-module-import.service.js +83 -22
  259. package/src/services/module-loading/server-module-transpiler.service.d.ts +8 -14
  260. package/src/services/module-loading/server-module-transpiler.service.js +5 -2
  261. package/src/services/module-loading/source-module-support.d.ts +5 -0
  262. package/src/services/module-loading/source-module-support.js +8 -0
  263. package/src/services/runtime-state/dev-graph.service.d.ts +6 -6
  264. package/src/services/runtime-state/dev-graph.service.js +10 -10
  265. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +1 -1
  266. package/src/services/runtime-state/server-invalidation-state.service.d.ts +1 -1
  267. package/src/static-site-generator/static-site-generator.d.ts +23 -28
  268. package/src/static-site-generator/static-site-generator.js +119 -156
  269. package/src/{internal-types.d.ts → types/internal-types.d.ts} +34 -23
  270. package/src/types/internal-types.js +0 -0
  271. package/src/{public-types.d.ts → types/public-types.d.ts} +195 -37
  272. package/src/types/public-types.js +0 -0
  273. package/src/utils/html-escaping.d.ts +7 -0
  274. package/src/utils/html-escaping.js +6 -0
  275. package/src/utils/locals-utils.d.ts +1 -1
  276. package/src/utils/parse-cli-args.d.ts +4 -1
  277. package/src/utils/parse-cli-args.js +16 -1
  278. package/src/utils/resolve-work-dir.js +1 -1
  279. package/src/watchers/project-watcher.d.ts +4 -4
  280. package/src/watchers/project-watcher.js +35 -41
  281. package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
  282. package/src/watchers/project-watcher.test-helpers.js +5 -5
  283. package/CHANGELOG.md +0 -31
  284. package/src/adapters/abstract/application-adapter.ts +0 -337
  285. package/src/adapters/abstract/router-adapter.ts +0 -30
  286. package/src/adapters/abstract/server-adapter.ts +0 -79
  287. package/src/adapters/bun/client-bridge.ts +0 -62
  288. package/src/adapters/bun/create-app.ts +0 -189
  289. package/src/adapters/bun/hmr-manager.ts +0 -409
  290. package/src/adapters/bun/index.ts +0 -2
  291. package/src/adapters/bun/server-adapter.ts +0 -499
  292. package/src/adapters/bun/server-lifecycle.d.ts +0 -63
  293. package/src/adapters/bun/server-lifecycle.js +0 -92
  294. package/src/adapters/bun/server-lifecycle.ts +0 -124
  295. package/src/adapters/index.ts +0 -6
  296. package/src/adapters/node/bootstrap-dependency-resolver.d.ts +0 -44
  297. package/src/adapters/node/bootstrap-dependency-resolver.js +0 -172
  298. package/src/adapters/node/bootstrap-dependency-resolver.ts +0 -301
  299. package/src/adapters/node/create-app.ts +0 -179
  300. package/src/adapters/node/index.d.ts +0 -6
  301. package/src/adapters/node/index.js +0 -11
  302. package/src/adapters/node/index.ts +0 -16
  303. package/src/adapters/node/node-client-bridge.ts +0 -79
  304. package/src/adapters/node/node-hmr-manager.ts +0 -381
  305. package/src/adapters/node/runtime-adapter.d.ts +0 -46
  306. package/src/adapters/node/runtime-adapter.js +0 -306
  307. package/src/adapters/node/runtime-adapter.ts +0 -439
  308. package/src/adapters/node/server-adapter.ts +0 -488
  309. package/src/adapters/node/static-content-server.ts +0 -239
  310. package/src/adapters/node/write-runtime-manifest.d.ts +0 -26
  311. package/src/adapters/node/write-runtime-manifest.js +0 -12
  312. package/src/adapters/node/write-runtime-manifest.ts +0 -38
  313. package/src/adapters/shared/api-response.ts +0 -104
  314. package/src/adapters/shared/application-adapter.ts +0 -199
  315. package/src/adapters/shared/define-api-handler.ts +0 -66
  316. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -140
  317. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -127
  318. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  319. package/src/adapters/shared/fs-server-response-matcher.ts +0 -205
  320. package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
  321. package/src/adapters/shared/hmr-html-response.ts +0 -52
  322. package/src/adapters/shared/render-context.ts +0 -120
  323. package/src/adapters/shared/runtime-bootstrap.d.ts +0 -38
  324. package/src/adapters/shared/runtime-bootstrap.js +0 -43
  325. package/src/adapters/shared/runtime-bootstrap.ts +0 -79
  326. package/src/adapters/shared/server-adapter.ts +0 -489
  327. package/src/adapters/shared/server-route-handler.ts +0 -153
  328. package/src/adapters/shared/server-static-builder.ts +0 -166
  329. package/src/build/build-adapter.ts +0 -361
  330. package/src/build/build-manifest.ts +0 -54
  331. package/src/build/build-types.ts +0 -83
  332. package/src/build/dev-build-coordinator.d.ts +0 -74
  333. package/src/build/dev-build-coordinator.js +0 -161
  334. package/src/build/dev-build-coordinator.ts +0 -221
  335. package/src/build/esbuild-build-adapter.d.ts +0 -72
  336. package/src/build/esbuild-build-adapter.js +0 -422
  337. package/src/build/esbuild-build-adapter.ts +0 -559
  338. package/src/build/runtime-build-executor.ts +0 -34
  339. package/src/build/runtime-specifier-alias-plugin.d.ts +0 -15
  340. package/src/build/runtime-specifier-alias-plugin.js +0 -31
  341. package/src/build/runtime-specifier-alias-plugin.ts +0 -58
  342. package/src/config/config-builder.ts +0 -706
  343. package/src/constants.ts +0 -54
  344. package/src/create-app.ts +0 -87
  345. package/src/dev/sc-server.ts +0 -143
  346. package/src/eco/component-render-context.d.ts +0 -105
  347. package/src/eco/component-render-context.js +0 -87
  348. package/src/eco/component-render-context.ts +0 -224
  349. package/src/eco/eco.ts +0 -242
  350. package/src/eco/eco.types.ts +0 -221
  351. package/src/eco/eco.utils.ts +0 -89
  352. package/src/eco/global-injector-map.ts +0 -112
  353. package/src/eco/lazy-injector-map.ts +0 -120
  354. package/src/eco/module-dependencies.ts +0 -75
  355. package/src/errors/http-error.ts +0 -72
  356. package/src/errors/index.ts +0 -2
  357. package/src/errors/locals-access-error.ts +0 -7
  358. package/src/global/app-logger.ts +0 -4
  359. package/src/hmr/client/hmr-runtime.ts +0 -152
  360. package/src/hmr/hmr-strategy.ts +0 -172
  361. package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
  362. package/src/hmr/hmr.test.e2e.ts +0 -66
  363. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  364. package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
  365. package/src/index.browser.ts +0 -3
  366. package/src/index.ts +0 -5
  367. package/src/integrations/ghtml/ghtml-renderer.ts +0 -96
  368. package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
  369. package/src/internal-types.ts +0 -232
  370. package/src/plugins/alias-resolver-plugin.ts +0 -63
  371. package/src/plugins/eco-component-meta-plugin.ts +0 -481
  372. package/src/plugins/integration-plugin.ts +0 -226
  373. package/src/plugins/processor.ts +0 -240
  374. package/src/plugins/runtime-capability.ts +0 -14
  375. package/src/public-types.ts +0 -1317
  376. package/src/route-renderer/component-graph/component-graph-executor.d.ts +0 -32
  377. package/src/route-renderer/component-graph/component-graph-executor.js +0 -31
  378. package/src/route-renderer/component-graph/component-graph-executor.ts +0 -84
  379. package/src/route-renderer/component-graph/component-graph.d.ts +0 -42
  380. package/src/route-renderer/component-graph/component-graph.js +0 -72
  381. package/src/route-renderer/component-graph/component-graph.ts +0 -159
  382. package/src/route-renderer/component-graph/component-marker.d.ts +0 -52
  383. package/src/route-renderer/component-graph/component-marker.js +0 -46
  384. package/src/route-renderer/component-graph/component-marker.ts +0 -117
  385. package/src/route-renderer/component-graph/component-reference.d.ts +0 -10
  386. package/src/route-renderer/component-graph/component-reference.js +0 -19
  387. package/src/route-renderer/component-graph/component-reference.ts +0 -29
  388. package/src/route-renderer/component-graph/marker-graph-resolver.d.ts +0 -77
  389. package/src/route-renderer/component-graph/marker-graph-resolver.js +0 -95
  390. package/src/route-renderer/component-graph/marker-graph-resolver.ts +0 -155
  391. package/src/route-renderer/orchestration/integration-renderer.ts +0 -790
  392. package/src/route-renderer/orchestration/render-execution.service.d.ts +0 -103
  393. package/src/route-renderer/orchestration/render-execution.service.js +0 -121
  394. package/src/route-renderer/orchestration/render-execution.service.ts +0 -230
  395. package/src/route-renderer/orchestration/render-preparation.service.d.ts +0 -121
  396. package/src/route-renderer/orchestration/render-preparation.service.js +0 -332
  397. package/src/route-renderer/orchestration/render-preparation.service.ts +0 -476
  398. package/src/route-renderer/page-loading/dependency-resolver.ts +0 -612
  399. package/src/route-renderer/page-loading/page-module-loader.ts +0 -181
  400. package/src/route-renderer/route-renderer.ts +0 -115
  401. package/src/router/client/link-intent.test.browser.ts +0 -51
  402. package/src/router/client/link-intent.ts +0 -92
  403. package/src/router/client/navigation-coordinator.ts +0 -433
  404. package/src/router/server/fs-router-scanner.d.ts +0 -41
  405. package/src/router/server/fs-router-scanner.js +0 -156
  406. package/src/router/server/fs-router-scanner.ts +0 -219
  407. package/src/router/server/fs-router.d.ts +0 -26
  408. package/src/router/server/fs-router.js +0 -100
  409. package/src/router/server/fs-router.ts +0 -122
  410. package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -401
  411. package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
  412. package/src/services/assets/asset-processing-service/assets.types.ts +0 -113
  413. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -95
  414. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
  415. package/src/services/assets/asset-processing-service/index.ts +0 -5
  416. package/src/services/assets/asset-processing-service/processor.interface.ts +0 -27
  417. package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
  418. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -82
  419. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -95
  420. package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
  421. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -66
  422. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -88
  423. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -85
  424. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
  425. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -80
  426. package/src/services/assets/browser-bundle.service.ts +0 -53
  427. package/src/services/cache/cache.types.ts +0 -126
  428. package/src/services/cache/index.ts +0 -18
  429. package/src/services/cache/memory-cache-store.ts +0 -130
  430. package/src/services/cache/page-cache-service.ts +0 -202
  431. package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
  432. package/src/services/html/html-rewriter-provider.service.ts +0 -103
  433. package/src/services/html/html-transformer.service.ts +0 -279
  434. package/src/services/invalidation/development-invalidation.service.ts +0 -261
  435. package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -52
  436. package/src/services/module-loading/page-module-import.service.ts +0 -200
  437. package/src/services/module-loading/server-loader.service.d.ts +0 -96
  438. package/src/services/module-loading/server-loader.service.js +0 -32
  439. package/src/services/module-loading/server-loader.service.ts +0 -130
  440. package/src/services/module-loading/server-module-transpiler.service.ts +0 -105
  441. package/src/services/runtime-manifest/node-runtime-manifest.service.d.ts +0 -35
  442. package/src/services/runtime-manifest/node-runtime-manifest.service.js +0 -60
  443. package/src/services/runtime-manifest/node-runtime-manifest.service.ts +0 -101
  444. package/src/services/runtime-state/dev-graph.service.ts +0 -217
  445. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
  446. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +0 -69
  447. package/src/services/runtime-state/runtime-specifier-registry.service.js +0 -37
  448. package/src/services/runtime-state/runtime-specifier-registry.service.ts +0 -96
  449. package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
  450. package/src/services/validation/schema-validation-service.ts +0 -204
  451. package/src/services/validation/standard-schema.types.ts +0 -68
  452. package/src/static-site-generator/static-site-generator.ts +0 -462
  453. package/src/utils/css.d.ts +0 -1
  454. package/src/utils/css.js +0 -7
  455. package/src/utils/css.ts +0 -5
  456. package/src/utils/deep-merge.ts +0 -47
  457. package/src/utils/hash.ts +0 -5
  458. package/src/utils/html.ts +0 -1
  459. package/src/utils/invariant.ts +0 -15
  460. package/src/utils/locals-utils.ts +0 -37
  461. package/src/utils/parse-cli-args.ts +0 -83
  462. package/src/utils/path-utils.module.ts +0 -14
  463. package/src/utils/resolve-work-dir.ts +0 -45
  464. package/src/utils/runtime.ts +0 -44
  465. package/src/utils/server-utils.module.ts +0 -67
  466. package/src/watchers/project-watcher.test-helpers.ts +0 -41
  467. package/src/watchers/project-watcher.ts +0 -363
  468. /package/src/{internal-types.js → adapters/shared/runtime-host.js} +0 -0
  469. /package/src/{public-types.js → adapters/shared/static-preview-host.js} +0 -0
  470. /package/src/{constants.d.ts → config/constants.d.ts} +0 -0
  471. /package/src/{constants.js → config/constants.js} +0 -0
@@ -1,200 +0,0 @@
1
- import path from 'node:path';
2
- import { pathToFileURL } from 'node:url';
3
- import { fileSystem } from '@ecopages/file-system';
4
- import { build, type BuildExecutor, type BuildResult } from '../../build/build-adapter.ts';
5
- import type { EcoBuildPlugin } from '../../build/build-types.ts';
6
-
7
- export interface PageModuleImportOptions {
8
- filePath: string;
9
- rootDir: string;
10
- outdir: string;
11
- buildExecutor?: BuildExecutor;
12
- invalidationVersion?: number;
13
- splitting?: boolean;
14
- externalPackages?: boolean;
15
- plugins?: EcoBuildPlugin[];
16
- transpileErrorMessage?: (details: string) => string;
17
- noOutputMessage?: (filePath: string) => string;
18
- }
19
-
20
- /**
21
- * Minimal runtime dependencies required to load page modules.
22
- *
23
- * @remarks
24
- * This service owns cache and runtime import policy. Hashing and build
25
- * execution are injected so tests can provide explicit fakes without module
26
- * interception.
27
- */
28
- export interface PageModuleImportDependencies {
29
- hashFile(filePath: string): string;
30
- buildModule(options: Parameters<typeof build>[0], buildExecutor?: BuildExecutor): Promise<BuildResult>;
31
- }
32
-
33
- /**
34
- * Loads source page modules in a runtime-agnostic way.
35
- *
36
- * This service centralizes the Bun-vs-Node import strategy used by route
37
- * scanning, page data loading, and request-time page inspection. In Bun it can
38
- * import source files directly; in Node it transpiles the file into a dedicated
39
- * output directory first and then imports the generated module.
40
- *
41
- * Keeping this logic in one place prevents subtle drift in cache-busting,
42
- * transpilation settings, and error semantics across the different callers.
43
- */
44
- export class PageModuleImportService {
45
- private readonly dependencies: PageModuleImportDependencies;
46
- private readonly importCache = new Map<string, Promise<unknown>>();
47
- private developmentInvalidationVersion = 0;
48
-
49
- constructor(dependencies?: Partial<PageModuleImportDependencies>) {
50
- this.dependencies = {
51
- hashFile: dependencies?.hashFile ?? ((filePath) => fileSystem.hash(filePath)),
52
- buildModule: dependencies?.buildModule ?? ((options, buildExecutor) => build(options, buildExecutor)),
53
- };
54
- }
55
-
56
- /**
57
- * Clears the shared import cache used by framework-owned page-module loads.
58
- */
59
- clearImportCache(): void {
60
- this.importCache.clear();
61
- }
62
-
63
- /**
64
- * Invalidates all previously imported modules in development by clearing the
65
- * import cache and incrementing the invalidation version included in cache keys.
66
- *
67
- * This forces all modules to be reloaded on the next import, even if their
68
- * source content hasn't changed. This is necessary to ensure that changes to
69
- * non-content aspects of modules (e.g. dependencies, transpilation output)
70
- * are picked up during development.
71
- */
72
- invalidateDevelopmentGraph(): void {
73
- this.clearImportCache();
74
- this.developmentInvalidationVersion += 1;
75
- }
76
-
77
- /**
78
- * Imports a page-like module from source.
79
- *
80
- * The caller controls the output directory and error wording so different
81
- * subsystems can reuse the same loading mechanism while preserving their
82
- * current diagnostics. Module identities stay stable for unchanged files and
83
- * roll forward automatically when the source hash changes during watch mode.
84
- *
85
- * @typeParam T Expected module shape.
86
- * @param options Runtime-specific import settings.
87
- * @returns The loaded module.
88
- */
89
- async importModule<T = unknown>(options: PageModuleImportOptions): Promise<T> {
90
- const { filePath, rootDir, externalPackages, splitting } = options;
91
- const invalidationVersion = options.invalidationVersion ?? this.developmentInvalidationVersion;
92
-
93
- const fileHash = this.dependencies.hashFile(filePath);
94
- const runtime = typeof Bun !== 'undefined' ? 'bun' : 'node';
95
- const cacheKey = [
96
- runtime,
97
- filePath,
98
- rootDir,
99
- splitting ?? 'default',
100
- externalPackages ?? 'default',
101
- fileHash,
102
- invalidationVersion,
103
- ].join('::');
104
- const cachedModule = this.importCache.get(cacheKey);
105
-
106
- if (cachedModule) {
107
- return (await cachedModule) as T;
108
- }
109
-
110
- const importPromise = this.loadModule<T>({
111
- ...options,
112
- fileHash,
113
- });
114
-
115
- this.importCache.set(cacheKey, importPromise);
116
-
117
- try {
118
- return await importPromise;
119
- } catch (error) {
120
- this.importCache.delete(cacheKey);
121
- throw error;
122
- }
123
- }
124
-
125
- private async loadModule<T = unknown>(
126
- options: PageModuleImportOptions & {
127
- fileHash: string;
128
- },
129
- ): Promise<T> {
130
- /**
131
- * Runtime-specific module loading stays centralized here so callers can share
132
- * one cache-key and invalidation model while still diverging between Bun's
133
- * direct source imports and Node's transpile-then-import path.
134
- */
135
- const {
136
- filePath,
137
- rootDir,
138
- outdir,
139
- invalidationVersion = this.developmentInvalidationVersion,
140
- splitting,
141
- externalPackages,
142
- transpileErrorMessage = (details) => `Error transpiling page module: ${details}`,
143
- noOutputMessage = (targetFilePath) => `No transpiled output generated for page module: ${targetFilePath}`,
144
- fileHash,
145
- } = options;
146
-
147
- if (typeof Bun !== 'undefined') {
148
- const moduleUrl = pathToFileURL(filePath);
149
-
150
- if (process.env.NODE_ENV === 'development') {
151
- moduleUrl.searchParams.set('update', `${fileHash}-${invalidationVersion}`);
152
- }
153
-
154
- return (await import(moduleUrl.href)) as T;
155
- }
156
-
157
- const fileBaseName = path.basename(filePath, path.extname(filePath));
158
- const outputFileName = `${fileBaseName}-${fileHash}.js`;
159
-
160
- const buildResult = await this.dependencies.buildModule(
161
- {
162
- entrypoints: [filePath],
163
- root: rootDir,
164
- outdir,
165
- target: 'node',
166
- format: 'esm',
167
- sourcemap: 'none',
168
- splitting: splitting ?? true,
169
- minify: false,
170
- naming: outputFileName,
171
- externalPackages: true,
172
- plugins: options.plugins,
173
- ...(externalPackages !== undefined ? { externalPackages } : {}),
174
- },
175
- options.buildExecutor,
176
- );
177
-
178
- if (!buildResult.success) {
179
- const details = buildResult.logs.map((log) => log.message).join(' | ');
180
- throw new Error(transpileErrorMessage(details));
181
- }
182
-
183
- const preferredOutputPath = path.join(outdir, outputFileName);
184
- const compiledOutput =
185
- buildResult.outputs.find((output) => output.path === preferredOutputPath)?.path ??
186
- buildResult.outputs.find((output) => output.path.endsWith('.js'))?.path;
187
-
188
- if (!compiledOutput) {
189
- throw new Error(noOutputMessage(filePath));
190
- }
191
-
192
- const compiledOutputUrl = pathToFileURL(compiledOutput);
193
-
194
- if (process.env.NODE_ENV === 'development') {
195
- compiledOutputUrl.searchParams.set('update', `${fileHash}-${invalidationVersion}`);
196
- }
197
-
198
- return (await import(compiledOutputUrl.href)) as T;
199
- }
200
- }
@@ -1,96 +0,0 @@
1
- import type { EcoBuildPlugin } from '../../build/build-types.js';
2
- import { type ServerModuleTranspilerBootstrapArgs, type ServerModuleTranspilerOptions } from './server-module-transpiler.service.js';
3
- /**
4
- * High-level module-loading options owned by the framework loader boundary.
5
- *
6
- * @remarks
7
- * These are the same shape the lower-level transpiler needs, minus the
8
- * root/build-executor ownership that the loader keeps internally.
9
- */
10
- export interface ServerLoaderModuleOptions extends ServerModuleTranspilerOptions {
11
- plugins?: EcoBuildPlugin[];
12
- }
13
- /**
14
- * Mutable app-phase server-loading context.
15
- *
16
- * @remarks
17
- * The loader starts with bootstrap config-loading context. Once a real built
18
- * app config is available, the runtime adapter rebinds the loader so app-entry
19
- * and downstream server modules load through the app-owned executor.
20
- */
21
- export interface ServerLoaderAppContext extends ServerModuleTranspilerBootstrapArgs {
22
- }
23
- /**
24
- * Minimal transpiler dependency required by the server loader.
25
- *
26
- * @remarks
27
- * The loader owns orchestration between bootstrap and app phases, so tests only
28
- * need this narrow import/invalidate/dispose surface rather than the concrete
29
- * transpiler class.
30
- */
31
- export interface ServerLoaderTranspilerDependency {
32
- importModule<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
33
- invalidate(changedFiles?: string[]): void;
34
- dispose(): Promise<void>;
35
- }
36
- /**
37
- * Factory dependency used by the loader to create phase-specific transpilers.
38
- */
39
- export interface ServerLoaderDependencyFactory {
40
- createTranspiler(context: ServerModuleTranspilerBootstrapArgs): ServerLoaderTranspilerDependency;
41
- }
42
- /**
43
- * Framework-owned server loading boundary.
44
- *
45
- * @remarks
46
- * This abstraction owns config loading, app-entry loading, and cache lifecycle
47
- * for the Node thin-host runtime path. Hosts and runtime adapters should depend
48
- * on this boundary rather than coordinating raw transpiler instances directly.
49
- */
50
- export interface ServerLoader {
51
- /**
52
- * Loads the bootstrap config module through the bootstrap server-loading
53
- * context.
54
- */
55
- loadConfig<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
56
- /**
57
- * Loads the app entry module through the currently active app context.
58
- *
59
- * @remarks
60
- * Until app context is rebound, this falls back to the bootstrap context so a
61
- * caller can still load through one boundary during early bootstrap.
62
- */
63
- loadApp<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
64
- /**
65
- * Rebinds the app-phase loading context after a real app config has been
66
- * loaded and app-owned build services are available.
67
- */
68
- rebindAppContext(context: ServerLoaderAppContext): void;
69
- /**
70
- * Invalidates cached server module state for development reloads.
71
- */
72
- invalidate(changedFiles?: string[]): void;
73
- /**
74
- * Releases loader-owned resources.
75
- */
76
- dispose(): Promise<void>;
77
- }
78
- /**
79
- * `ServerLoader` implementation backed by `ServerModuleTranspiler` instances.
80
- *
81
- * @remarks
82
- * This is the first named loader abstraction for Workstream 3. It keeps the
83
- * lower-level transpiler as the implementation detail while moving ownership of
84
- * config/app entry orchestration into one service boundary.
85
- */
86
- export declare class TranspilerServerLoader implements ServerLoader {
87
- private readonly createTranspiler;
88
- private readonly configTranspiler;
89
- private appTranspiler;
90
- constructor(configContext: ServerModuleTranspilerBootstrapArgs, dependencies?: ServerLoaderDependencyFactory);
91
- loadConfig<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
92
- loadApp<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
93
- rebindAppContext(context: ServerLoaderAppContext): void;
94
- invalidate(changedFiles?: string[]): void;
95
- dispose(): Promise<void>;
96
- }
@@ -1,32 +0,0 @@
1
- import {
2
- ServerModuleTranspiler
3
- } from "./server-module-transpiler.service.js";
4
- class TranspilerServerLoader {
5
- createTranspiler;
6
- configTranspiler;
7
- appTranspiler = null;
8
- constructor(configContext, dependencies) {
9
- this.createTranspiler = dependencies?.createTranspiler ?? ((context) => new ServerModuleTranspiler(context));
10
- this.configTranspiler = this.createTranspiler(configContext);
11
- }
12
- async loadConfig(options) {
13
- return await this.configTranspiler.importModule(options);
14
- }
15
- async loadApp(options) {
16
- return await (this.appTranspiler ?? this.configTranspiler).importModule(options);
17
- }
18
- rebindAppContext(context) {
19
- this.appTranspiler = this.createTranspiler(context);
20
- }
21
- invalidate(changedFiles) {
22
- this.configTranspiler.invalidate(changedFiles);
23
- this.appTranspiler?.invalidate(changedFiles);
24
- }
25
- async dispose() {
26
- await this.appTranspiler?.dispose();
27
- await this.configTranspiler.dispose();
28
- }
29
- }
30
- export {
31
- TranspilerServerLoader
32
- };
@@ -1,130 +0,0 @@
1
- import type { EcoBuildPlugin } from '../../build/build-types.js';
2
- import {
3
- ServerModuleTranspiler,
4
- type ServerModuleTranspilerBootstrapArgs,
5
- type ServerModuleTranspilerOptions,
6
- } from './server-module-transpiler.service.ts';
7
-
8
- /**
9
- * High-level module-loading options owned by the framework loader boundary.
10
- *
11
- * @remarks
12
- * These are the same shape the lower-level transpiler needs, minus the
13
- * root/build-executor ownership that the loader keeps internally.
14
- */
15
- export interface ServerLoaderModuleOptions extends ServerModuleTranspilerOptions {
16
- plugins?: EcoBuildPlugin[];
17
- }
18
-
19
- /**
20
- * Mutable app-phase server-loading context.
21
- *
22
- * @remarks
23
- * The loader starts with bootstrap config-loading context. Once a real built
24
- * app config is available, the runtime adapter rebinds the loader so app-entry
25
- * and downstream server modules load through the app-owned executor.
26
- */
27
- export interface ServerLoaderAppContext extends ServerModuleTranspilerBootstrapArgs {}
28
-
29
- /**
30
- * Minimal transpiler dependency required by the server loader.
31
- *
32
- * @remarks
33
- * The loader owns orchestration between bootstrap and app phases, so tests only
34
- * need this narrow import/invalidate/dispose surface rather than the concrete
35
- * transpiler class.
36
- */
37
- export interface ServerLoaderTranspilerDependency {
38
- importModule<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
39
- invalidate(changedFiles?: string[]): void;
40
- dispose(): Promise<void>;
41
- }
42
-
43
- /**
44
- * Factory dependency used by the loader to create phase-specific transpilers.
45
- */
46
- export interface ServerLoaderDependencyFactory {
47
- createTranspiler(context: ServerModuleTranspilerBootstrapArgs): ServerLoaderTranspilerDependency;
48
- }
49
-
50
- /**
51
- * Framework-owned server loading boundary.
52
- *
53
- * @remarks
54
- * This abstraction owns config loading, app-entry loading, and cache lifecycle
55
- * for the Node thin-host runtime path. Hosts and runtime adapters should depend
56
- * on this boundary rather than coordinating raw transpiler instances directly.
57
- */
58
- export interface ServerLoader {
59
- /**
60
- * Loads the bootstrap config module through the bootstrap server-loading
61
- * context.
62
- */
63
- loadConfig<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
64
-
65
- /**
66
- * Loads the app entry module through the currently active app context.
67
- *
68
- * @remarks
69
- * Until app context is rebound, this falls back to the bootstrap context so a
70
- * caller can still load through one boundary during early bootstrap.
71
- */
72
- loadApp<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
73
-
74
- /**
75
- * Rebinds the app-phase loading context after a real app config has been
76
- * loaded and app-owned build services are available.
77
- */
78
- rebindAppContext(context: ServerLoaderAppContext): void;
79
-
80
- /**
81
- * Invalidates cached server module state for development reloads.
82
- */
83
- invalidate(changedFiles?: string[]): void;
84
-
85
- /**
86
- * Releases loader-owned resources.
87
- */
88
- dispose(): Promise<void>;
89
- }
90
-
91
- /**
92
- * `ServerLoader` implementation backed by `ServerModuleTranspiler` instances.
93
- *
94
- * @remarks
95
- * This is the first named loader abstraction for Workstream 3. It keeps the
96
- * lower-level transpiler as the implementation detail while moving ownership of
97
- * config/app entry orchestration into one service boundary.
98
- */
99
- export class TranspilerServerLoader implements ServerLoader {
100
- private readonly createTranspiler: ServerLoaderDependencyFactory['createTranspiler'];
101
- private readonly configTranspiler: ServerLoaderTranspilerDependency;
102
- private appTranspiler: ServerLoaderTranspilerDependency | null = null;
103
-
104
- constructor(configContext: ServerModuleTranspilerBootstrapArgs, dependencies?: ServerLoaderDependencyFactory) {
105
- this.createTranspiler = dependencies?.createTranspiler ?? ((context) => new ServerModuleTranspiler(context));
106
- this.configTranspiler = this.createTranspiler(configContext);
107
- }
108
-
109
- async loadConfig<T = unknown>(options: ServerLoaderModuleOptions): Promise<T> {
110
- return await this.configTranspiler.importModule<T>(options);
111
- }
112
-
113
- async loadApp<T = unknown>(options: ServerLoaderModuleOptions): Promise<T> {
114
- return await (this.appTranspiler ?? this.configTranspiler).importModule<T>(options);
115
- }
116
-
117
- rebindAppContext(context: ServerLoaderAppContext): void {
118
- this.appTranspiler = this.createTranspiler(context);
119
- }
120
-
121
- invalidate(changedFiles?: string[]): void {
122
- this.configTranspiler.invalidate(changedFiles);
123
- this.appTranspiler?.invalidate(changedFiles);
124
- }
125
-
126
- async dispose(): Promise<void> {
127
- await this.appTranspiler?.dispose();
128
- await this.configTranspiler.dispose();
129
- }
130
- }
@@ -1,105 +0,0 @@
1
- import type { BuildExecutor } from '../../build/build-adapter.js';
2
- import type { EcoBuildPlugin } from '../../build/build-types.ts';
3
- import { PageModuleImportService, type PageModuleImportOptions } from './page-module-import.service.ts';
4
-
5
- export type ServerModuleTranspilerOptions = Omit<PageModuleImportOptions, 'rootDir' | 'buildExecutor'>;
6
-
7
- /**
8
- * Minimal import-service dependency required by the server module transpiler.
9
- *
10
- * @remarks
11
- * This keeps the transpiler boundary testable without module-level mocking and
12
- * lets callers provide an app-owned import implementation when needed.
13
- */
14
- export interface ServerModuleImportDependency {
15
- importModule<T = unknown>(options: PageModuleImportOptions): Promise<T>;
16
- invalidateDevelopmentGraph(): void;
17
- }
18
-
19
- /**
20
- * Immutable execution context for one server-transpiler instance.
21
- *
22
- * @remarks
23
- * Callers own when and why a new transpiler is created. This service only owns
24
- * applying the supplied root/build-executor pair consistently to every module
25
- * load that passes through it.
26
- */
27
- export type ServerModuleTranspilerBootstrapArgs = {
28
- rootDir: string;
29
- getBuildExecutor: () => BuildExecutor | undefined;
30
- getInvalidationVersion?: () => number;
31
- invalidateModules?: (changedFiles?: string[]) => void;
32
- pageModuleImportService?: ServerModuleImportDependency;
33
- /** Factory evaluated on each importModule call to produce plugins applied to every load. */
34
- getDefaultPlugins?: () => EcoBuildPlugin[];
35
- };
36
-
37
- /**
38
- * App-owned boundary for server-side source module loading.
39
- *
40
- * @remarks
41
- * This service centralizes server-side module transpilation and import behind
42
- * an explicit caller-owned root and build executor.
43
- */
44
- export class ServerModuleTranspiler {
45
- private readonly pageModuleImportService: ServerModuleImportDependency;
46
- private readonly getRootDir: () => string;
47
- private readonly getBuildExecutor: () => BuildExecutor | undefined;
48
- private readonly getInvalidationVersion: () => number | undefined;
49
- private readonly invalidateModules: (changedFiles?: string[]) => void;
50
- private readonly getDefaultPlugins: () => EcoBuildPlugin[];
51
-
52
- /**
53
- * Creates one explicit server-transpiler boundary for a given execution
54
- * context.
55
- */
56
- constructor(args: ServerModuleTranspilerBootstrapArgs) {
57
- this.pageModuleImportService = args.pageModuleImportService ?? new PageModuleImportService();
58
- this.getRootDir = () => args.rootDir;
59
- this.getBuildExecutor = args.getBuildExecutor;
60
- this.getInvalidationVersion = () => args.getInvalidationVersion?.();
61
- this.getDefaultPlugins = args.getDefaultPlugins ?? (() => []);
62
- this.invalidateModules = (changedFiles) => {
63
- if (args.invalidateModules) {
64
- args.invalidateModules(changedFiles);
65
- return;
66
- }
67
-
68
- this.pageModuleImportService.invalidateDevelopmentGraph();
69
- };
70
- }
71
-
72
- /**
73
- * Loads a server-side source module through the caller-owned transpile
74
- * context.
75
- */
76
- async importModule<T = unknown>(options: ServerModuleTranspilerOptions): Promise<T> {
77
- const mergedPlugins = [...this.getDefaultPlugins(), ...(options.plugins ?? [])];
78
- const { plugins: _plugins, ...baseOptions } = options;
79
- return await this.pageModuleImportService.importModule<T>({
80
- ...baseOptions,
81
- ...(mergedPlugins.length > 0 ? { plugins: mergedPlugins } : {}),
82
- rootDir: this.getRootDir(),
83
- buildExecutor: this.getBuildExecutor(),
84
- invalidationVersion: this.getInvalidationVersion(),
85
- });
86
- }
87
-
88
- /**
89
- * Invalidates cached module state for development reloads.
90
- */
91
- invalidate(changedFiles?: string[]): void {
92
- this.invalidateModules(changedFiles);
93
- }
94
-
95
- /**
96
- * Releases transpiler-owned resources.
97
- *
98
- * @remarks
99
- * The current implementation delegates cache ownership to lower-level module
100
- * loading services, so disposal is intentionally a no-op for now.
101
- */
102
- async dispose(): Promise<void> {
103
- return;
104
- }
105
- }
@@ -1,35 +0,0 @@
1
- import type { EcoPagesAppConfig } from '../../internal-types.js';
2
- export interface NodeRuntimeManifest {
3
- runtime: 'node';
4
- appRootDir: string;
5
- sourceRootDir: string;
6
- distDir: string;
7
- workDir?: string;
8
- modulePaths: {
9
- config: string;
10
- entry?: string;
11
- };
12
- }
13
- /**
14
- * Returns the default file handoff location for the Node runtime manifest.
15
- */
16
- export declare function getNodeRuntimeManifestPath(appConfig: EcoPagesAppConfig): string;
17
- export declare function createNodeRuntimeManifest(appConfig: EcoPagesAppConfig, options?: {
18
- entryModulePath?: string;
19
- }): NodeRuntimeManifest;
20
- /**
21
- * Serializes a Node runtime manifest to the file boundary used by the thin host.
22
- */
23
- export declare function writeNodeRuntimeManifestFile(manifest: NodeRuntimeManifest, manifestFilePath: string): string;
24
- /**
25
- * Derives the app-owned Node manifest and writes it to the runtime handoff path.
26
- */
27
- export declare function writeAppNodeRuntimeManifest(appConfig: EcoPagesAppConfig, options?: {
28
- entryModulePath?: string;
29
- manifestFilePath?: string;
30
- }): {
31
- manifest: NodeRuntimeManifest;
32
- manifestFilePath: string;
33
- };
34
- export declare function getAppNodeRuntimeManifest(appConfig: EcoPagesAppConfig): NodeRuntimeManifest;
35
- export declare function setAppNodeRuntimeManifest(appConfig: EcoPagesAppConfig, nodeRuntimeManifest: NodeRuntimeManifest): void;
@@ -1,60 +0,0 @@
1
- import { mkdirSync, writeFileSync } from "node:fs";
2
- import path from "node:path";
3
- import { DEFAULT_ECOPAGES_WORK_DIR } from "../../constants.js";
4
- const NODE_RUNTIME_MANIFEST_DIRNAME = "runtime";
5
- const NODE_RUNTIME_MANIFEST_FILENAME = "node-runtime-manifest.json";
6
- function getNodeRuntimeManifestPath(appConfig) {
7
- return path.join(resolveWorkDir(appConfig), NODE_RUNTIME_MANIFEST_DIRNAME, NODE_RUNTIME_MANIFEST_FILENAME);
8
- }
9
- function resolveWorkDir(appConfig) {
10
- return appConfig.absolutePaths?.workDir ?? path.join(appConfig.rootDir, appConfig.workDir ?? DEFAULT_ECOPAGES_WORK_DIR);
11
- }
12
- function createNodeRuntimeManifest(appConfig, options) {
13
- return {
14
- runtime: "node",
15
- appRootDir: appConfig.rootDir,
16
- sourceRootDir: appConfig.absolutePaths.srcDir,
17
- distDir: appConfig.absolutePaths.distDir,
18
- workDir: resolveWorkDir(appConfig),
19
- modulePaths: {
20
- config: appConfig.absolutePaths.config,
21
- ...options?.entryModulePath ? { entry: options.entryModulePath } : {}
22
- }
23
- };
24
- }
25
- function writeNodeRuntimeManifestFile(manifest, manifestFilePath) {
26
- mkdirSync(path.dirname(manifestFilePath), { recursive: true });
27
- writeFileSync(manifestFilePath, `${JSON.stringify(manifest, null, 2)}
28
- `, "utf8");
29
- return manifestFilePath;
30
- }
31
- function writeAppNodeRuntimeManifest(appConfig, options) {
32
- const manifest = createNodeRuntimeManifest(appConfig, {
33
- entryModulePath: options?.entryModulePath
34
- });
35
- const manifestFilePath = writeNodeRuntimeManifestFile(
36
- manifest,
37
- options?.manifestFilePath ?? getNodeRuntimeManifestPath(appConfig)
38
- );
39
- return {
40
- manifest,
41
- manifestFilePath
42
- };
43
- }
44
- function getAppNodeRuntimeManifest(appConfig) {
45
- return appConfig.runtime?.nodeRuntimeManifest ?? createNodeRuntimeManifest(appConfig);
46
- }
47
- function setAppNodeRuntimeManifest(appConfig, nodeRuntimeManifest) {
48
- appConfig.runtime = {
49
- ...appConfig.runtime ?? {},
50
- nodeRuntimeManifest
51
- };
52
- }
53
- export {
54
- createNodeRuntimeManifest,
55
- getAppNodeRuntimeManifest,
56
- getNodeRuntimeManifestPath,
57
- setAppNodeRuntimeManifest,
58
- writeAppNodeRuntimeManifest,
59
- writeNodeRuntimeManifestFile
60
- };