@ecopages/core 0.2.0-alpha.3 → 0.2.0-alpha.31

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 (436) hide show
  1. package/CHANGELOG.md +66 -66
  2. package/README.md +268 -14
  3. package/package.json +72 -108
  4. package/src/adapters/README.md +39 -0
  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 +5 -12
  11. package/src/adapters/bun/create-app.js +43 -7
  12. package/src/adapters/bun/hmr-manager.d.ts +72 -26
  13. package/src/adapters/bun/hmr-manager.js +153 -81
  14. package/src/adapters/bun/index.d.ts +2 -3
  15. package/src/adapters/bun/index.js +3 -3
  16. package/src/adapters/bun/server-adapter.d.ts +5 -5
  17. package/src/adapters/bun/server-adapter.js +63 -38
  18. package/src/adapters/bun/server-lifecycle.d.ts +28 -17
  19. package/src/adapters/bun/server-lifecycle.js +34 -62
  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 +2 -6
  23. package/src/adapters/index.js +2 -8
  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 +79 -21
  28. package/src/adapters/node/node-hmr-manager.js +167 -114
  29. package/src/adapters/node/server-adapter.d.ts +7 -35
  30. package/src/adapters/node/server-adapter.js +55 -107
  31. package/src/adapters/node/static-content-server.d.ts +37 -1
  32. package/src/adapters/node/static-content-server.js +29 -1
  33. package/src/adapters/shared/application-adapter.d.ts +1 -1
  34. package/src/{define-api-handler.d.ts → adapters/shared/define-api-handler.d.ts} +1 -1
  35. package/src/adapters/shared/explicit-static-render-preparation.d.ts +25 -0
  36. package/src/adapters/shared/explicit-static-render-preparation.js +26 -0
  37. package/src/adapters/shared/explicit-static-route-matcher.d.ts +7 -4
  38. package/src/adapters/shared/explicit-static-route-matcher.js +14 -13
  39. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +7 -10
  40. package/src/adapters/shared/file-route-middleware-pipeline.js +3 -11
  41. package/src/adapters/shared/fs-server-response-factory.d.ts +14 -10
  42. package/src/adapters/shared/fs-server-response-factory.js +11 -27
  43. package/src/adapters/shared/fs-server-response-matcher.d.ts +20 -16
  44. package/src/adapters/shared/fs-server-response-matcher.js +76 -45
  45. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  46. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  47. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  48. package/src/adapters/shared/hmr-html-response.js +32 -0
  49. package/src/adapters/shared/render-context.d.ts +4 -3
  50. package/src/adapters/shared/render-context.js +6 -3
  51. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  52. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  53. package/src/adapters/shared/server-adapter.d.ts +33 -12
  54. package/src/adapters/shared/server-adapter.js +208 -132
  55. package/src/adapters/shared/server-route-handler.d.ts +5 -5
  56. package/src/adapters/shared/server-route-handler.js +7 -16
  57. package/src/adapters/shared/server-static-builder.d.ts +41 -8
  58. package/src/adapters/shared/server-static-builder.js +65 -11
  59. package/src/build/README.md +107 -0
  60. package/src/build/build-adapter.d.ts +168 -3
  61. package/src/build/build-adapter.js +604 -16
  62. package/src/build/build-manifest.d.ts +27 -0
  63. package/src/build/build-manifest.js +30 -0
  64. package/src/build/dev-build-coordinator.d.ts +72 -0
  65. package/src/build/dev-build-coordinator.js +154 -0
  66. package/src/build/esbuild-build-adapter.d.ts +15 -6
  67. package/src/build/esbuild-build-adapter.js +189 -74
  68. package/src/build/runtime-build-executor.d.ts +14 -0
  69. package/src/build/runtime-build-executor.js +22 -0
  70. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  71. package/src/build/runtime-specifier-alias-plugin.js +35 -0
  72. package/src/build/runtime-specifier-aliases.d.ts +5 -0
  73. package/src/build/runtime-specifier-aliases.js +95 -0
  74. package/src/config/README.md +36 -0
  75. package/src/config/config-builder.d.ts +54 -29
  76. package/src/config/config-builder.js +255 -49
  77. package/src/{constants.d.ts → config/constants.d.ts} +13 -0
  78. package/src/{constants.js → config/constants.js} +4 -0
  79. package/src/declarations.d.ts +19 -14
  80. package/src/dev/host-runtime.d.ts +10 -0
  81. package/src/dev/host-runtime.js +24 -0
  82. package/src/dev/sc-server.d.ts +1 -1
  83. package/src/dev/sc-server.js +1 -1
  84. package/src/eco/README.md +70 -16
  85. package/src/eco/eco.browser.d.ts +2 -0
  86. package/src/eco/eco.browser.js +83 -0
  87. package/src/eco/eco.js +32 -57
  88. package/src/eco/eco.types.d.ts +14 -6
  89. package/src/eco/eco.utils.d.ts +1 -40
  90. package/src/eco/eco.utils.js +5 -35
  91. package/src/eco/global-injector-map.d.ts +3 -3
  92. package/src/eco/global-injector-map.js +2 -2
  93. package/src/eco/lazy-injector-map.d.ts +2 -2
  94. package/src/errors/index.d.ts +1 -0
  95. package/src/errors/index.js +3 -1
  96. package/src/hmr/README.md +26 -0
  97. package/src/hmr/client/hmr-runtime.d.ts +1 -6
  98. package/src/hmr/client/hmr-runtime.js +38 -7
  99. package/src/hmr/hmr-strategy.d.ts +16 -13
  100. package/src/hmr/hmr-strategy.js +22 -7
  101. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  102. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  103. package/src/hmr/hmr.test.e2e.js +26 -33
  104. package/src/hmr/strategies/default-hmr-strategy.d.ts +2 -2
  105. package/src/hmr/strategies/default-hmr-strategy.js +1 -1
  106. package/src/hmr/strategies/js-hmr-strategy.d.ts +46 -48
  107. package/src/hmr/strategies/js-hmr-strategy.js +64 -74
  108. package/src/index.browser.d.ts +2 -2
  109. package/src/index.browser.js +1 -1
  110. package/src/index.d.ts +4 -3
  111. package/src/index.js +16 -5
  112. package/src/integrations/ghtml/ghtml-renderer.d.ts +3 -2
  113. package/src/integrations/ghtml/ghtml-renderer.js +27 -30
  114. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  115. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  116. package/src/integrations/ghtml/ghtml.plugin.d.ts +2 -6
  117. package/src/integrations/ghtml/ghtml.plugin.js +3 -4
  118. package/src/plugins/README.md +35 -0
  119. package/src/plugins/alias-resolver-plugin.js +17 -3
  120. package/src/plugins/eco-component-meta-plugin.d.ts +14 -1
  121. package/src/plugins/eco-component-meta-plugin.js +27 -22
  122. package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
  123. package/src/plugins/foreign-jsx-override-plugin.js +35 -0
  124. package/src/plugins/integration-plugin.d.ts +142 -29
  125. package/src/plugins/integration-plugin.js +103 -14
  126. package/src/plugins/processor.d.ts +17 -2
  127. package/src/plugins/processor.js +22 -3
  128. package/src/plugins/runtime-capability.d.ts +9 -0
  129. package/src/plugins/source-transform.d.ts +46 -0
  130. package/src/plugins/source-transform.js +71 -0
  131. package/src/route-renderer/GRAPH.md +83 -325
  132. package/src/route-renderer/README.md +73 -90
  133. package/src/route-renderer/orchestration/component-render-context.d.ts +89 -0
  134. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  135. package/src/route-renderer/orchestration/declared-ownership-graph.d.ts +18 -0
  136. package/src/route-renderer/orchestration/declared-ownership-graph.js +34 -0
  137. package/src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts +108 -0
  138. package/src/route-renderer/orchestration/foreign-subtree-execution.service.js +206 -0
  139. package/src/route-renderer/orchestration/integration-renderer.d.ts +516 -0
  140. package/src/route-renderer/orchestration/integration-renderer.js +909 -0
  141. package/src/route-renderer/orchestration/ownership-planning.service.d.ts +24 -0
  142. package/src/route-renderer/orchestration/ownership-planning.service.js +63 -0
  143. package/src/route-renderer/orchestration/ownership-validation.service.d.ts +29 -0
  144. package/src/route-renderer/orchestration/ownership-validation.service.js +53 -0
  145. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +2 -0
  146. package/src/route-renderer/orchestration/processed-asset-dedupe.js +23 -0
  147. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.d.ts +90 -0
  148. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.js +158 -0
  149. package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
  150. package/src/route-renderer/orchestration/render-output.utils.js +171 -0
  151. package/src/route-renderer/orchestration/route-render-orchestrator.d.ts +120 -0
  152. package/src/route-renderer/orchestration/route-render-orchestrator.js +388 -0
  153. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  154. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  155. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
  156. package/src/route-renderer/page-loading/component-dependency-collection.js +132 -0
  157. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
  158. package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
  159. package/src/route-renderer/{dependency-resolver.d.ts → page-loading/dependency-resolver.d.ts} +15 -4
  160. package/src/route-renderer/page-loading/dependency-resolver.js +115 -0
  161. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
  162. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
  163. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
  164. package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
  165. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
  166. package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
  167. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
  168. package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
  169. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
  170. package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
  171. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
  172. package/src/route-renderer/page-loading/page-dependency-bundling.js +137 -0
  173. package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
  174. package/src/route-renderer/{page-module-loader.js → page-loading/page-module-loader.js} +39 -14
  175. package/src/route-renderer/route-renderer.d.ts +57 -14
  176. package/src/route-renderer/route-renderer.js +30 -18
  177. package/src/router/README.md +94 -0
  178. package/src/router/client/link-intent.d.ts +53 -0
  179. package/src/router/client/link-intent.js +34 -0
  180. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  181. package/src/router/client/link-intent.test.browser.js +43 -0
  182. package/src/router/client/navigation-coordinator.d.ts +169 -0
  183. package/src/router/client/navigation-coordinator.js +215 -0
  184. package/src/router/server/route-registry.d.ts +78 -0
  185. package/src/router/server/route-registry.js +262 -0
  186. package/src/services/README.md +28 -0
  187. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
  188. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
  189. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +103 -0
  190. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset-processing.service.js +124 -89
  191. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.d.ts +1 -1
  192. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.js +2 -2
  193. package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.d.ts +16 -1
  194. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  195. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +49 -0
  196. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  197. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  198. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
  199. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
  200. package/src/services/assets/asset-processing-service/index.d.ts +6 -0
  201. package/src/services/assets/asset-processing-service/index.js +6 -0
  202. package/src/services/assets/asset-processing-service/page-package.d.ts +3 -0
  203. package/src/services/assets/asset-processing-service/page-package.js +74 -0
  204. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.d.ts +2 -2
  205. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.d.ts +2 -2
  206. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.d.ts +1 -1
  207. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.js +11 -5
  208. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +22 -0
  209. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +136 -0
  210. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  211. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  212. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.d.ts +3 -2
  213. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +119 -0
  214. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.d.ts +4 -3
  215. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.js +28 -7
  216. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.d.ts +3 -3
  217. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.js +12 -7
  218. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.d.ts +5 -2
  219. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +59 -0
  220. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
  221. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.js +9 -3
  222. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
  223. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
  224. package/src/services/assets/browser-bundle.service.d.ts +73 -0
  225. package/src/services/assets/browser-bundle.service.js +41 -0
  226. package/src/services/{page-request-cache-coordinator.service.d.ts → cache/page-request-cache-coordinator.service.d.ts} +2 -2
  227. package/src/services/{page-request-cache-coordinator.service.js → cache/page-request-cache-coordinator.service.js} +3 -1
  228. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  229. package/src/services/html/html-rewriter-provider.service.js +68 -0
  230. package/src/services/html/html-transformer.service.d.ts +87 -0
  231. package/src/services/html/html-transformer.service.js +216 -0
  232. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  233. package/src/services/invalidation/development-invalidation.service.js +190 -0
  234. package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
  235. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
  236. package/src/services/module-loading/app-server-module-transpiler.service.js +115 -0
  237. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  238. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  239. package/src/services/module-loading/module-loading-types.d.ts +2 -0
  240. package/src/services/module-loading/module-loading-types.js +0 -0
  241. package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
  242. package/src/services/module-loading/node-bootstrap-plugin.js +216 -0
  243. package/src/services/module-loading/page-module-import.service.d.ts +76 -0
  244. package/src/services/module-loading/page-module-import.service.js +170 -0
  245. package/src/services/module-loading/server-module-transpiler.service.d.ts +63 -0
  246. package/src/services/module-loading/server-module-transpiler.service.js +64 -0
  247. package/src/services/module-loading/source-module-support.d.ts +5 -0
  248. package/src/services/module-loading/source-module-support.js +8 -0
  249. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  250. package/src/services/runtime-state/dev-graph.service.js +162 -0
  251. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  252. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  253. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  254. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  255. package/src/services/{schema-validation-service.d.ts → validation/schema-validation-service.d.ts} +1 -1
  256. package/src/static-site-generator/README.md +26 -0
  257. package/src/static-site-generator/static-site-generator.d.ts +67 -20
  258. package/src/static-site-generator/static-site-generator.js +182 -138
  259. package/src/{internal-types.d.ts → types/internal-types.d.ts} +62 -30
  260. package/src/types/internal-types.js +0 -0
  261. package/src/{public-types.d.ts → types/public-types.d.ts} +201 -32
  262. package/src/types/public-types.js +0 -0
  263. package/src/utils/html-escaping.d.ts +7 -0
  264. package/src/utils/html-escaping.js +6 -0
  265. package/src/utils/locals-utils.d.ts +1 -1
  266. package/src/utils/parse-cli-args.d.ts +4 -1
  267. package/src/utils/parse-cli-args.js +16 -1
  268. package/src/utils/resolve-work-dir.d.ts +11 -0
  269. package/src/utils/resolve-work-dir.js +31 -0
  270. package/src/watchers/project-watcher.d.ts +40 -29
  271. package/src/watchers/project-watcher.js +126 -116
  272. package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
  273. package/src/watchers/project-watcher.test-helpers.js +6 -6
  274. package/src/adapters/abstract/application-adapter.ts +0 -337
  275. package/src/adapters/abstract/router-adapter.ts +0 -30
  276. package/src/adapters/abstract/server-adapter.ts +0 -79
  277. package/src/adapters/bun/client-bridge.ts +0 -62
  278. package/src/adapters/bun/create-app.ts +0 -189
  279. package/src/adapters/bun/define-api-handler.d.ts +0 -61
  280. package/src/adapters/bun/define-api-handler.ts +0 -114
  281. package/src/adapters/bun/hmr-manager.ts +0 -296
  282. package/src/adapters/bun/index.ts +0 -3
  283. package/src/adapters/bun/server-adapter.ts +0 -492
  284. package/src/adapters/bun/server-lifecycle.ts +0 -154
  285. package/src/adapters/index.ts +0 -6
  286. package/src/adapters/node/create-app.ts +0 -179
  287. package/src/adapters/node/index.d.ts +0 -4
  288. package/src/adapters/node/index.js +0 -8
  289. package/src/adapters/node/index.ts +0 -9
  290. package/src/adapters/node/node-client-bridge.ts +0 -79
  291. package/src/adapters/node/node-hmr-manager.ts +0 -289
  292. package/src/adapters/node/server-adapter.ts +0 -561
  293. package/src/adapters/node/static-content-server.ts +0 -203
  294. package/src/adapters/shared/api-response.ts +0 -104
  295. package/src/adapters/shared/application-adapter.ts +0 -199
  296. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -134
  297. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -123
  298. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  299. package/src/adapters/shared/fs-server-response-matcher.ts +0 -198
  300. package/src/adapters/shared/render-context.ts +0 -105
  301. package/src/adapters/shared/server-adapter.ts +0 -442
  302. package/src/adapters/shared/server-route-handler.ts +0 -166
  303. package/src/adapters/shared/server-static-builder.ts +0 -82
  304. package/src/build/build-adapter.ts +0 -132
  305. package/src/build/build-types.ts +0 -83
  306. package/src/build/esbuild-build-adapter.ts +0 -510
  307. package/src/config/config-builder.ts +0 -474
  308. package/src/constants.ts +0 -39
  309. package/src/create-app.ts +0 -87
  310. package/src/define-api-handler.js +0 -15
  311. package/src/define-api-handler.ts +0 -66
  312. package/src/dev/sc-server.ts +0 -143
  313. package/src/eco/component-render-context.d.ts +0 -105
  314. package/src/eco/component-render-context.js +0 -77
  315. package/src/eco/component-render-context.ts +0 -202
  316. package/src/eco/eco.ts +0 -221
  317. package/src/eco/eco.types.ts +0 -202
  318. package/src/eco/eco.utils.ts +0 -89
  319. package/src/eco/global-injector-map.ts +0 -112
  320. package/src/eco/lazy-injector-map.ts +0 -120
  321. package/src/eco/module-dependencies.ts +0 -75
  322. package/src/errors/http-error.ts +0 -72
  323. package/src/errors/index.ts +0 -2
  324. package/src/errors/locals-access-error.ts +0 -7
  325. package/src/global/app-logger.ts +0 -4
  326. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-have-HMR-script-injected-in-page-1.png +0 -0
  327. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  328. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  329. package/src/hmr/client/hmr-runtime.ts +0 -121
  330. package/src/hmr/hmr-strategy.ts +0 -172
  331. package/src/hmr/hmr.test.e2e.ts +0 -75
  332. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  333. package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
  334. package/src/index.browser.ts +0 -3
  335. package/src/index.ts +0 -5
  336. package/src/integrations/ghtml/ghtml-renderer.ts +0 -93
  337. package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
  338. package/src/internal-types.ts +0 -212
  339. package/src/plugins/alias-resolver-plugin.ts +0 -45
  340. package/src/plugins/eco-component-meta-plugin.ts +0 -474
  341. package/src/plugins/integration-plugin.ts +0 -184
  342. package/src/plugins/processor.ts +0 -220
  343. package/src/public-types.ts +0 -1260
  344. package/src/route-renderer/component-graph-executor.d.ts +0 -32
  345. package/src/route-renderer/component-graph-executor.js +0 -31
  346. package/src/route-renderer/component-graph-executor.ts +0 -84
  347. package/src/route-renderer/component-graph.d.ts +0 -42
  348. package/src/route-renderer/component-graph.js +0 -72
  349. package/src/route-renderer/component-graph.ts +0 -159
  350. package/src/route-renderer/component-marker.d.ts +0 -52
  351. package/src/route-renderer/component-marker.js +0 -46
  352. package/src/route-renderer/component-marker.ts +0 -117
  353. package/src/route-renderer/dependency-resolver.js +0 -428
  354. package/src/route-renderer/dependency-resolver.ts +0 -596
  355. package/src/route-renderer/html-post-processing.service.d.ts +0 -40
  356. package/src/route-renderer/html-post-processing.service.js +0 -86
  357. package/src/route-renderer/html-post-processing.service.ts +0 -103
  358. package/src/route-renderer/integration-renderer.d.ts +0 -339
  359. package/src/route-renderer/integration-renderer.js +0 -526
  360. package/src/route-renderer/integration-renderer.ts +0 -696
  361. package/src/route-renderer/marker-graph-resolver.d.ts +0 -76
  362. package/src/route-renderer/marker-graph-resolver.js +0 -93
  363. package/src/route-renderer/marker-graph-resolver.ts +0 -153
  364. package/src/route-renderer/page-module-loader.d.ts +0 -61
  365. package/src/route-renderer/page-module-loader.ts +0 -153
  366. package/src/route-renderer/render-execution.service.d.ts +0 -69
  367. package/src/route-renderer/render-execution.service.js +0 -91
  368. package/src/route-renderer/render-execution.service.ts +0 -158
  369. package/src/route-renderer/render-preparation.service.d.ts +0 -112
  370. package/src/route-renderer/render-preparation.service.js +0 -243
  371. package/src/route-renderer/render-preparation.service.ts +0 -358
  372. package/src/route-renderer/route-renderer.ts +0 -80
  373. package/src/router/fs-router-scanner.d.ts +0 -41
  374. package/src/router/fs-router-scanner.js +0 -155
  375. package/src/router/fs-router-scanner.ts +0 -217
  376. package/src/router/fs-router.d.ts +0 -26
  377. package/src/router/fs-router.js +0 -100
  378. package/src/router/fs-router.ts +0 -122
  379. package/src/services/asset-processing-service/asset-processing.service.d.ts +0 -41
  380. package/src/services/asset-processing-service/asset-processing.service.ts +0 -306
  381. package/src/services/asset-processing-service/asset.factory.ts +0 -105
  382. package/src/services/asset-processing-service/assets.types.ts +0 -112
  383. package/src/services/asset-processing-service/index.d.ts +0 -3
  384. package/src/services/asset-processing-service/index.js +0 -3
  385. package/src/services/asset-processing-service/index.ts +0 -3
  386. package/src/services/asset-processing-service/processor.interface.ts +0 -27
  387. package/src/services/asset-processing-service/processor.registry.ts +0 -18
  388. package/src/services/asset-processing-service/processors/base/base-processor.ts +0 -76
  389. package/src/services/asset-processing-service/processors/base/base-script-processor.d.ts +0 -16
  390. package/src/services/asset-processing-service/processors/base/base-script-processor.js +0 -80
  391. package/src/services/asset-processing-service/processors/base/base-script-processor.ts +0 -105
  392. package/src/services/asset-processing-service/processors/index.d.ts +0 -5
  393. package/src/services/asset-processing-service/processors/index.js +0 -5
  394. package/src/services/asset-processing-service/processors/index.ts +0 -5
  395. package/src/services/asset-processing-service/processors/script/content-script.processor.js +0 -57
  396. package/src/services/asset-processing-service/processors/script/content-script.processor.ts +0 -66
  397. package/src/services/asset-processing-service/processors/script/file-script.processor.ts +0 -88
  398. package/src/services/asset-processing-service/processors/script/node-module-script.processor.ts +0 -84
  399. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -25
  400. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
  401. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -77
  402. package/src/services/cache/cache.types.ts +0 -126
  403. package/src/services/cache/index.ts +0 -18
  404. package/src/services/cache/memory-cache-store.ts +0 -130
  405. package/src/services/cache/page-cache-service.ts +0 -202
  406. package/src/services/html-transformer.service.d.ts +0 -50
  407. package/src/services/html-transformer.service.js +0 -163
  408. package/src/services/html-transformer.service.ts +0 -217
  409. package/src/services/page-module-import.service.d.ts +0 -37
  410. package/src/services/page-module-import.service.js +0 -88
  411. package/src/services/page-module-import.service.ts +0 -129
  412. package/src/services/page-request-cache-coordinator.service.ts +0 -128
  413. package/src/services/schema-validation-service.ts +0 -204
  414. package/src/services/validation/standard-schema.types.ts +0 -68
  415. package/src/static-site-generator/static-site-generator.ts +0 -359
  416. package/src/utils/css.d.ts +0 -1
  417. package/src/utils/css.js +0 -7
  418. package/src/utils/css.ts +0 -5
  419. package/src/utils/deep-merge.ts +0 -47
  420. package/src/utils/hash.ts +0 -5
  421. package/src/utils/html.ts +0 -1
  422. package/src/utils/invariant.ts +0 -15
  423. package/src/utils/locals-utils.ts +0 -37
  424. package/src/utils/parse-cli-args.ts +0 -83
  425. package/src/utils/path-utils.module.ts +0 -14
  426. package/src/utils/runtime.ts +0 -44
  427. package/src/utils/server-utils.module.ts +0 -67
  428. package/src/watchers/project-watcher.test-helpers.ts +0 -41
  429. package/src/watchers/project-watcher.ts +0 -344
  430. /package/src/adapters/{bun → shared}/define-api-handler.js +0 -0
  431. /package/src/{internal-types.js → plugins/runtime-capability.js} +0 -0
  432. /package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.js +0 -0
  433. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.js +0 -0
  434. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.js +0 -0
  435. /package/src/{public-types.js → services/module-loading/app-module-loader.service.js} +0 -0
  436. /package/src/services/{schema-validation-service.js → validation/schema-validation-service.js} +0 -0
@@ -0,0 +1,216 @@
1
+ import {
2
+ DefaultHtmlRewriterProvider
3
+ } from "./html-rewriter-provider.service.js";
4
+ import { dedupeProcessedAssets } from "../../route-renderer/orchestration/processed-asset-dedupe.js";
5
+ class HtmlTransformerService {
6
+ processedDependencies = [];
7
+ pagePackage;
8
+ htmlRewriterProvider;
9
+ constructor(options = {}) {
10
+ this.htmlRewriterProvider = options.htmlRewriterProvider ?? new DefaultHtmlRewriterProvider();
11
+ if (options.htmlRewriterMode) {
12
+ this.htmlRewriterProvider.setMode(options.htmlRewriterMode);
13
+ }
14
+ }
15
+ /**
16
+ * Overrides the HTML rewriter runtime selection.
17
+ *
18
+ * This is intended for internal/runtime tests that need deterministic
19
+ * selection between native, worker-tools, and string fallback behavior.
20
+ *
21
+ * @param mode Requested runtime selection strategy.
22
+ */
23
+ setHtmlRewriterMode(mode) {
24
+ this.htmlRewriterProvider.setMode(mode);
25
+ }
26
+ formatAttributes(attrs) {
27
+ if (!attrs) return "";
28
+ return ` ${Object.entries(attrs).map(([key, value]) => `${key}="${value}"`).join(" ")}`;
29
+ }
30
+ generateScriptTag(dep) {
31
+ return dep.inline ? `<script${this.formatAttributes(dep.attributes)}>${dep.content}<\/script>` : `<script src="${dep.srcUrl}"${this.formatAttributes(dep.attributes)}><\/script>`;
32
+ }
33
+ generateStylesheetTag(dep) {
34
+ return dep.inline ? `<style${this.formatAttributes(dep.attributes)}>${dep.content}</style>` : `<link rel="stylesheet" href="${dep.srcUrl}"${this.formatAttributes(dep.attributes)}>`;
35
+ }
36
+ appendDependencies(element, dependencies) {
37
+ for (const dep of dependencies) {
38
+ const tag = dep.kind === "script" ? this.generateScriptTag(dep) : this.generateStylesheetTag(dep);
39
+ element.append(tag, { html: true });
40
+ }
41
+ }
42
+ buildDependencyTags(dependencies) {
43
+ return dependencies.map(
44
+ (dep) => dep.kind === "script" ? this.generateScriptTag(dep) : this.generateStylesheetTag(dep)
45
+ ).join("");
46
+ }
47
+ /**
48
+ * Injects generated markup immediately before the closing HTML tag when it is
49
+ * present, or appends/prepends a fallback insertion otherwise.
50
+ */
51
+ injectBeforeClosingTag(html, tag, content) {
52
+ if (!content) {
53
+ return html;
54
+ }
55
+ const closingTag = `</${tag}>`;
56
+ const lowerHtml = html.toLowerCase();
57
+ const closingTagIndex = lowerHtml.lastIndexOf(closingTag);
58
+ if (closingTagIndex !== -1) {
59
+ return `${html.slice(0, closingTagIndex)}${content}${html.slice(closingTagIndex)}`;
60
+ }
61
+ if (tag === "head") {
62
+ return `${content}${html}`;
63
+ }
64
+ return `${html}${content}`;
65
+ }
66
+ /**
67
+ * Replaces the current processed dependency set used during HTML finalization.
68
+ */
69
+ setProcessedDependencies(processedDependencies) {
70
+ this.pagePackage = void 0;
71
+ this.processedDependencies = processedDependencies;
72
+ }
73
+ /**
74
+ * Replaces the current structured page package used during HTML finalization.
75
+ */
76
+ setPagePackage(pagePackage) {
77
+ this.pagePackage = pagePackage;
78
+ this.processedDependencies = pagePackage.htmlAssets;
79
+ }
80
+ /**
81
+ * Returns the processed dependencies queued for the next transform pass.
82
+ */
83
+ getProcessedDependencies() {
84
+ return this.processedDependencies;
85
+ }
86
+ /**
87
+ * Returns the structured page package queued for the next transform pass.
88
+ */
89
+ getPagePackage() {
90
+ return this.pagePackage;
91
+ }
92
+ /**
93
+ * Applies attributes to the opening `<html>` tag when present.
94
+ */
95
+ applyAttributesToHtmlElement(html, attributes) {
96
+ const htmlTagMatch = html.match(/<html\b[^>]*>/i);
97
+ if (!htmlTagMatch || htmlTagMatch.index === void 0) {
98
+ return html;
99
+ }
100
+ const attrs = this.buildAttributeString(attributes);
101
+ if (attrs.length === 0) {
102
+ return html;
103
+ }
104
+ const injectionOffset = htmlTagMatch.index + htmlTagMatch[0].length - 1;
105
+ return `${html.slice(0, injectionOffset)}${attrs}${html.slice(injectionOffset)}`;
106
+ }
107
+ /**
108
+ * Applies attributes to the first element nested directly under `<body>`.
109
+ */
110
+ applyAttributesToFirstBodyElement(html, attributes) {
111
+ const bodyMatch = html.match(/<body\b[^>]*>/i);
112
+ if (!bodyMatch || bodyMatch.index === void 0) {
113
+ return html;
114
+ }
115
+ const bodyOpenEnd = bodyMatch.index + bodyMatch[0].length;
116
+ const afterBody = html.slice(bodyOpenEnd);
117
+ const firstTagMatch = afterBody.match(/^(\s*<)([a-zA-Z][a-zA-Z0-9:-]*)(\b[^>]*>)/);
118
+ if (!firstTagMatch || firstTagMatch.index === void 0) {
119
+ return html;
120
+ }
121
+ const attrs = this.buildAttributeString(attributes);
122
+ if (attrs.length === 0) {
123
+ return html;
124
+ }
125
+ const injectionOffset = bodyOpenEnd + firstTagMatch[1].length + firstTagMatch[2].length;
126
+ return `${html.slice(0, injectionOffset)}${attrs}${html.slice(injectionOffset)}`;
127
+ }
128
+ /**
129
+ * Applies attributes to the first element in a fragment or full-document HTML
130
+ * string.
131
+ */
132
+ applyAttributesToFirstElement(html, attributes) {
133
+ const firstTagMatch = html.match(/^(\s*<)([a-zA-Z][a-zA-Z0-9:-]*)(\b[^>]*>)/);
134
+ if (!firstTagMatch || firstTagMatch.index === void 0) {
135
+ return html;
136
+ }
137
+ const attrs = this.buildAttributeString(attributes);
138
+ if (attrs.length === 0) {
139
+ return html;
140
+ }
141
+ const injectionOffset = firstTagMatch[1].length + firstTagMatch[2].length;
142
+ return `${html.slice(0, injectionOffset)}${attrs}${html.slice(injectionOffset)}`;
143
+ }
144
+ /**
145
+ * Removes duplicate processed assets while preserving first-seen order.
146
+ *
147
+ * @remarks
148
+ * Dedupe keys include structural asset fields and HTML attributes so repeated
149
+ * orchestration passes can merge assets safely without collapsing distinct tag
150
+ * variants.
151
+ */
152
+ dedupeProcessedAssets(assets) {
153
+ return dedupeProcessedAssets(assets);
154
+ }
155
+ /**
156
+ * Injects the currently processed dependencies into an HTML response.
157
+ *
158
+ * @remarks
159
+ * Native or worker-tools HTML rewriter support is preferred when available. A
160
+ * string-based fallback remains in place for runtimes that cannot provide one
161
+ * of those rewriter implementations.
162
+ */
163
+ async transform(res) {
164
+ const { head, body } = this.groupDependenciesByPosition();
165
+ const htmlRewriter = await this.htmlRewriterProvider.createHtmlRewriter();
166
+ if (htmlRewriter) {
167
+ htmlRewriter.on("head", {
168
+ element: (element) => this.appendDependencies(element, head)
169
+ }).on("body", {
170
+ element: (element) => this.appendDependencies(element, body)
171
+ });
172
+ return htmlRewriter.transform(res);
173
+ }
174
+ const html = await res.text();
175
+ const headers = new Headers(res.headers);
176
+ const withHeadDependencies = this.injectBeforeClosingTag(html, "head", this.buildDependencyTags(head));
177
+ const transformedHtml = this.injectBeforeClosingTag(
178
+ withHeadDependencies,
179
+ "body",
180
+ this.buildDependencyTags(body)
181
+ );
182
+ return new Response(transformedHtml, {
183
+ headers,
184
+ status: res.status,
185
+ statusText: res.statusText
186
+ });
187
+ }
188
+ /**
189
+ * Splits processed assets into head and body injection groups.
190
+ */
191
+ groupDependenciesByPosition() {
192
+ const dependencies = this.pagePackage?.htmlAssets ?? this.processedDependencies;
193
+ return dependencies.reduce(
194
+ (acc, dep) => {
195
+ if (dep.kind === "script") {
196
+ if (dep.excludeFromHtml) return acc;
197
+ const position = dep.position || "body";
198
+ acc[position].push(dep);
199
+ } else if (dep.kind === "stylesheet") {
200
+ acc.head.push(dep);
201
+ }
202
+ return acc;
203
+ },
204
+ { head: [], body: [] }
205
+ );
206
+ }
207
+ /**
208
+ * Builds a serialized HTML attribute string from an attribute object.
209
+ */
210
+ buildAttributeString(attributes) {
211
+ return Object.entries(attributes).filter(([key, value]) => key.length > 0 && value.length > 0).map(([key, value]) => ` ${key}="${value}"`).join("");
212
+ }
213
+ }
214
+ export {
215
+ HtmlTransformerService
216
+ };
@@ -0,0 +1,74 @@
1
+ import type { EcoPagesAppConfig } from '../../types/internal-types.js';
2
+ export type DevelopmentInvalidationCategory = 'public-asset' | 'additional-watch' | 'include-source' | 'route-source' | 'processor-owned-asset' | 'server-source' | 'other';
3
+ /**
4
+ * Framework-owned invalidation plan for one changed file.
5
+ *
6
+ * @remarks
7
+ * This is the explicit invalidation matrix Workstream 4 needs. Watchers and
8
+ * runtime adapters consume this plan instead of encoding file-category rules in
9
+ * host-specific control flow.
10
+ */
11
+ export interface DevelopmentInvalidationPlan {
12
+ category: DevelopmentInvalidationCategory;
13
+ invalidateServerModules: boolean;
14
+ refreshRoutes: boolean;
15
+ reloadBrowser: boolean;
16
+ delegateToHmr: boolean;
17
+ processorHandledAsset: boolean;
18
+ }
19
+ /**
20
+ * Framework-owned development invalidation service.
21
+ *
22
+ * @remarks
23
+ * This service centralizes two responsibilities:
24
+ * - file-change classification for watcher behavior
25
+ * - app-owned server-module invalidation versioning backed by the dev graph
26
+ *
27
+ * Hosts and watchers should ask this service what a file change means instead
28
+ * of deciding invalidation semantics inline.
29
+ */
30
+ export declare class DevelopmentInvalidationService {
31
+ private readonly appConfig;
32
+ constructor(appConfig: EcoPagesAppConfig);
33
+ /**
34
+ * Returns the current app-owned server-module invalidation version.
35
+ */
36
+ getServerModuleInvalidationVersion(): number;
37
+ /**
38
+ * Invalidates the app-owned server-module graph.
39
+ */
40
+ invalidateServerModules(changedFiles?: string[]): void;
41
+ /**
42
+ * Resets runtime-owned graph state and invalidates server modules.
43
+ */
44
+ resetRuntimeState(changedFiles?: string[]): void;
45
+ /**
46
+ * Classifies one changed file into an explicit framework invalidation plan.
47
+ */
48
+ planFileChange(filePath: string): DevelopmentInvalidationPlan;
49
+ /**
50
+ * Returns whether the file lives under the public directory.
51
+ */
52
+ isPublicDirFile(filePath: string): boolean;
53
+ /**
54
+ * Returns whether the file matches `additionalWatchPaths`.
55
+ */
56
+ matchesAdditionalWatchPaths(filePath: string): boolean;
57
+ /**
58
+ * Returns whether the file is a route source file.
59
+ */
60
+ isRouteSourceFile(filePath: string): boolean;
61
+ /**
62
+ * Returns whether the file is an include/template source file.
63
+ */
64
+ isIncludeSourceFile(filePath: string): boolean;
65
+ /**
66
+ * Returns whether the file is a server-executed source module outside the
67
+ * special route/include buckets.
68
+ */
69
+ isServerModuleSourceFile(filePath: string): boolean;
70
+ /**
71
+ * Returns whether a processor owns the changed file as an asset input.
72
+ */
73
+ isProcessorOwnedAsset(filePath: string): boolean;
74
+ }
@@ -0,0 +1,190 @@
1
+ import path from "node:path";
2
+ import { getAppServerInvalidationState } from "../runtime-state/server-invalidation-state.service.js";
3
+ class DevelopmentInvalidationService {
4
+ appConfig;
5
+ constructor(appConfig) {
6
+ this.appConfig = appConfig;
7
+ }
8
+ /**
9
+ * Returns the current app-owned server-module invalidation version.
10
+ */
11
+ getServerModuleInvalidationVersion() {
12
+ return getAppServerInvalidationState(this.appConfig).getServerInvalidationVersion();
13
+ }
14
+ /**
15
+ * Invalidates the app-owned server-module graph.
16
+ */
17
+ invalidateServerModules(changedFiles) {
18
+ getAppServerInvalidationState(this.appConfig).invalidateServerModules(changedFiles);
19
+ this.appConfig.runtime?.appModuleLoader?.invalidateDevelopmentGraph();
20
+ }
21
+ /**
22
+ * Resets runtime-owned graph state and invalidates server modules.
23
+ */
24
+ resetRuntimeState(changedFiles) {
25
+ const serverInvalidationState = getAppServerInvalidationState(this.appConfig);
26
+ serverInvalidationState.invalidateServerModules(changedFiles);
27
+ serverInvalidationState.reset();
28
+ }
29
+ /**
30
+ * Classifies one changed file into an explicit framework invalidation plan.
31
+ */
32
+ planFileChange(filePath) {
33
+ if (this.isPublicDirFile(filePath)) {
34
+ return {
35
+ category: "public-asset",
36
+ invalidateServerModules: false,
37
+ refreshRoutes: false,
38
+ reloadBrowser: true,
39
+ delegateToHmr: false,
40
+ processorHandledAsset: false
41
+ };
42
+ }
43
+ if (this.matchesAdditionalWatchPaths(filePath)) {
44
+ return {
45
+ category: "additional-watch",
46
+ invalidateServerModules: false,
47
+ refreshRoutes: false,
48
+ reloadBrowser: true,
49
+ delegateToHmr: false,
50
+ processorHandledAsset: false
51
+ };
52
+ }
53
+ if (this.isIncludeSourceFile(filePath)) {
54
+ return {
55
+ category: "include-source",
56
+ invalidateServerModules: true,
57
+ refreshRoutes: false,
58
+ reloadBrowser: true,
59
+ delegateToHmr: false,
60
+ processorHandledAsset: false
61
+ };
62
+ }
63
+ if (this.isRouteSourceFile(filePath)) {
64
+ return {
65
+ category: "route-source",
66
+ invalidateServerModules: true,
67
+ refreshRoutes: true,
68
+ reloadBrowser: false,
69
+ delegateToHmr: true,
70
+ processorHandledAsset: false
71
+ };
72
+ }
73
+ if (this.isProcessorOwnedAsset(filePath)) {
74
+ return {
75
+ category: "processor-owned-asset",
76
+ invalidateServerModules: false,
77
+ refreshRoutes: false,
78
+ reloadBrowser: false,
79
+ delegateToHmr: false,
80
+ processorHandledAsset: true
81
+ };
82
+ }
83
+ if (this.isServerModuleSourceFile(filePath)) {
84
+ return {
85
+ category: "server-source",
86
+ invalidateServerModules: true,
87
+ refreshRoutes: false,
88
+ reloadBrowser: false,
89
+ delegateToHmr: true,
90
+ processorHandledAsset: false
91
+ };
92
+ }
93
+ return {
94
+ category: "other",
95
+ invalidateServerModules: false,
96
+ refreshRoutes: false,
97
+ reloadBrowser: false,
98
+ delegateToHmr: true,
99
+ processorHandledAsset: false
100
+ };
101
+ }
102
+ /**
103
+ * Returns whether the file lives under the public directory.
104
+ */
105
+ isPublicDirFile(filePath) {
106
+ return path.resolve(filePath).startsWith(this.appConfig.absolutePaths.publicDir);
107
+ }
108
+ /**
109
+ * Returns whether the file matches `additionalWatchPaths`.
110
+ */
111
+ matchesAdditionalWatchPaths(filePath) {
112
+ const normalizedPath = path.resolve(filePath);
113
+ const patterns = this.appConfig.additionalWatchPaths;
114
+ if (!patterns.length) return false;
115
+ for (const pattern of patterns) {
116
+ if (pattern.includes("*")) {
117
+ const ext = pattern.replace(/\*\*?\/\*/, "");
118
+ if (normalizedPath.endsWith(ext)) return true;
119
+ } else if (normalizedPath.endsWith(pattern) || normalizedPath === path.resolve(pattern)) {
120
+ return true;
121
+ }
122
+ }
123
+ return false;
124
+ }
125
+ /**
126
+ * Returns whether the file is a route source file.
127
+ */
128
+ isRouteSourceFile(filePath) {
129
+ const resolvedPath = path.resolve(filePath);
130
+ if (!resolvedPath.startsWith(this.appConfig.absolutePaths.pagesDir)) {
131
+ return false;
132
+ }
133
+ if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
134
+ return true;
135
+ }
136
+ return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
137
+ }
138
+ /**
139
+ * Returns whether the file is an include/template source file.
140
+ */
141
+ isIncludeSourceFile(filePath) {
142
+ const resolvedPath = path.resolve(filePath);
143
+ if (!resolvedPath.startsWith(this.appConfig.absolutePaths.includesDir)) {
144
+ return false;
145
+ }
146
+ if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
147
+ return true;
148
+ }
149
+ return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
150
+ }
151
+ /**
152
+ * Returns whether the file is a server-executed source module outside the
153
+ * special route/include buckets.
154
+ */
155
+ isServerModuleSourceFile(filePath) {
156
+ const resolvedPath = path.resolve(filePath);
157
+ if (!resolvedPath.startsWith(this.appConfig.absolutePaths.srcDir)) {
158
+ return false;
159
+ }
160
+ if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
161
+ return true;
162
+ }
163
+ return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
164
+ }
165
+ /**
166
+ * Returns whether a processor owns the changed file as an asset input.
167
+ */
168
+ isProcessorOwnedAsset(filePath) {
169
+ for (const processor of this.appConfig.processors.values()) {
170
+ const capabilities = processor.getAssetCapabilities?.() ?? [];
171
+ if (capabilities.length > 0) {
172
+ const matchesConfiguredAsset = typeof processor.matchesFileFilter !== "function" || processor.matchesFileFilter(filePath);
173
+ if (matchesConfiguredAsset && capabilities.some((capability) => processor.canProcessAsset?.(capability.kind, filePath))) {
174
+ return true;
175
+ }
176
+ continue;
177
+ }
178
+ const watchConfig = processor.getWatchConfig();
179
+ if (!watchConfig) continue;
180
+ const { extensions = [] } = watchConfig;
181
+ if (extensions.length && extensions.some((ext) => filePath.endsWith(ext))) {
182
+ return true;
183
+ }
184
+ }
185
+ return false;
186
+ }
187
+ }
188
+ export {
189
+ DevelopmentInvalidationService
190
+ };
@@ -0,0 +1,7 @@
1
+ import type { PageModuleImportOptions } from './page-module-import.service.js';
2
+ export type AppModuleLoaderOwner = 'bun' | 'host';
3
+ export interface AppModuleLoader {
4
+ readonly owner: AppModuleLoaderOwner;
5
+ importModule<T = unknown>(options: PageModuleImportOptions): Promise<T>;
6
+ invalidateDevelopmentGraph(): void;
7
+ }
@@ -0,0 +1,24 @@
1
+ import type { EcoPagesAppConfig } from '../../types/internal-types.js';
2
+ import { type AppModuleLoader } from './app-module-loader.service.js';
3
+ import type { SourceModuleLoader } from './module-loading-types.js';
4
+ import { ServerModuleTranspiler } from './server-module-transpiler.service.js';
5
+ export declare function shouldAppUseHostModuleLoader(appConfig: EcoPagesAppConfig, filePath: string): boolean;
6
+ export declare function getAppHostModuleLoader(appConfig: EcoPagesAppConfig): SourceModuleLoader | undefined;
7
+ export declare function setAppHostModuleLoader(appConfig: EcoPagesAppConfig, hostModuleLoader?: SourceModuleLoader): void;
8
+ export declare function createAppModuleLoader(appConfig: EcoPagesAppConfig): AppModuleLoader;
9
+ export declare function getAppModuleLoader(appConfig: EcoPagesAppConfig): AppModuleLoader;
10
+ export declare function setAppModuleLoader(appConfig: EcoPagesAppConfig, appModuleLoader: AppModuleLoader): void;
11
+ /**
12
+ * Creates the shared app-scoped server-module transpiler for one runtime
13
+ * instance.
14
+ */
15
+ export declare function createAppServerModuleTranspiler(appConfig: EcoPagesAppConfig): ServerModuleTranspiler;
16
+ /**
17
+ * Returns the app-owned server-module transpiler, creating it lazily when the
18
+ * runtime first needs one.
19
+ */
20
+ export declare function getAppServerModuleTranspiler(appConfig: EcoPagesAppConfig): ServerModuleTranspiler;
21
+ /**
22
+ * Installs the server-module transpiler that should serve one app instance.
23
+ */
24
+ export declare function setAppServerModuleTranspiler(appConfig: EcoPagesAppConfig, serverModuleTranspiler: ServerModuleTranspiler): void;
@@ -0,0 +1,115 @@
1
+ import { getAppBuildExecutor } from "../../build/build-adapter.js";
2
+ import path from "node:path";
3
+ import { DevelopmentInvalidationService } from "../invalidation/development-invalidation.service.js";
4
+ import {} from "./app-module-loader.service.js";
5
+ import { createAppNodeBootstrapPlugin } from "./node-bootstrap-plugin.js";
6
+ import { PageModuleImportService } from "./page-module-import.service.js";
7
+ import { supportsSourceModuleLoading } from "./source-module-support.js";
8
+ import { ServerModuleTranspiler } from "./server-module-transpiler.service.js";
9
+ function shouldAppUseHostModuleLoader(appConfig, filePath) {
10
+ if (appConfig.runtime?.hostModuleLoader) {
11
+ return supportsSourceModuleLoading(filePath);
12
+ }
13
+ const normalizedFilePath = path.normalize(filePath);
14
+ const frameworkOwnedDirectories = [
15
+ appConfig.absolutePaths.pagesDir,
16
+ appConfig.absolutePaths.includesDir,
17
+ appConfig.absolutePaths.layoutsDir,
18
+ appConfig.absolutePaths.componentsDir
19
+ ].map((directoryPath) => path.normalize(directoryPath));
20
+ const isFrameworkOwnedModule = frameworkOwnedDirectories.some((directoryPath) => {
21
+ return normalizedFilePath === directoryPath || normalizedFilePath.startsWith(`${directoryPath}${path.sep}`);
22
+ });
23
+ const isConfiguredTemplateModule = appConfig.templatesExt.some(
24
+ (extension) => normalizedFilePath.endsWith(extension)
25
+ );
26
+ return !(isFrameworkOwnedModule && isConfiguredTemplateModule);
27
+ }
28
+ function getAppHostModuleLoader(appConfig) {
29
+ return appConfig.runtime?.hostModuleLoader;
30
+ }
31
+ function getAppModuleLoaderOwner(appConfig) {
32
+ return getAppHostModuleLoader(appConfig) ? "host" : "bun";
33
+ }
34
+ function setAppHostModuleLoader(appConfig, hostModuleLoader) {
35
+ appConfig.runtime = {
36
+ ...appConfig.runtime ?? {},
37
+ hostModuleLoader
38
+ };
39
+ }
40
+ function createAppModuleLoader(appConfig) {
41
+ const invalidationService = new DevelopmentInvalidationService(appConfig);
42
+ const pageModuleImportService = new PageModuleImportService({
43
+ canLoadSourceModuleFromHost: (filePath) => shouldAppUseHostModuleLoader(appConfig, filePath),
44
+ getHostModuleLoader: () => getAppHostModuleLoader(appConfig)
45
+ });
46
+ const getDefaultPlugins = typeof Bun === "undefined" && appConfig.rootDir ? () => [createAppNodeBootstrapPlugin(appConfig)] : () => [];
47
+ const appModuleLoader = {
48
+ get owner() {
49
+ return getAppModuleLoaderOwner(appConfig);
50
+ },
51
+ pageModuleImportService,
52
+ async importModule(options) {
53
+ const mergedPlugins = [...getDefaultPlugins(), ...options.plugins ?? []];
54
+ return await pageModuleImportService.importModule({
55
+ ...options,
56
+ ...mergedPlugins.length > 0 ? { plugins: mergedPlugins } : {},
57
+ buildExecutor: options.buildExecutor ?? getAppBuildExecutor(appConfig),
58
+ invalidationVersion: options.invalidationVersion ?? invalidationService.getServerModuleInvalidationVersion()
59
+ });
60
+ },
61
+ invalidateDevelopmentGraph() {
62
+ pageModuleImportService.invalidateDevelopmentGraph();
63
+ }
64
+ };
65
+ return appModuleLoader;
66
+ }
67
+ function getAppModuleLoader(appConfig) {
68
+ const existingModuleLoader = appConfig.runtime?.appModuleLoader;
69
+ if (existingModuleLoader) {
70
+ return existingModuleLoader;
71
+ }
72
+ const appModuleLoader = createAppModuleLoader(appConfig);
73
+ setAppModuleLoader(appConfig, appModuleLoader);
74
+ return appModuleLoader;
75
+ }
76
+ function setAppModuleLoader(appConfig, appModuleLoader) {
77
+ appConfig.runtime = {
78
+ ...appConfig.runtime ?? {},
79
+ appModuleLoader
80
+ };
81
+ }
82
+ function createAppServerModuleTranspiler(appConfig) {
83
+ const invalidationService = new DevelopmentInvalidationService(appConfig);
84
+ return new ServerModuleTranspiler({
85
+ rootDir: appConfig.rootDir,
86
+ invalidateModules: (changedFiles) => invalidationService.invalidateServerModules(changedFiles),
87
+ pageModuleImportService: getAppModuleLoader(appConfig)
88
+ });
89
+ }
90
+ function getAppServerModuleTranspiler(appConfig) {
91
+ const existingTranspiler = appConfig.runtime?.serverModuleTranspiler;
92
+ if (existingTranspiler) {
93
+ return existingTranspiler;
94
+ }
95
+ const serverModuleTranspiler = createAppServerModuleTranspiler(appConfig);
96
+ setAppServerModuleTranspiler(appConfig, serverModuleTranspiler);
97
+ return serverModuleTranspiler;
98
+ }
99
+ function setAppServerModuleTranspiler(appConfig, serverModuleTranspiler) {
100
+ appConfig.runtime = {
101
+ ...appConfig.runtime ?? {},
102
+ serverModuleTranspiler
103
+ };
104
+ }
105
+ export {
106
+ createAppModuleLoader,
107
+ createAppServerModuleTranspiler,
108
+ getAppHostModuleLoader,
109
+ getAppModuleLoader,
110
+ getAppServerModuleTranspiler,
111
+ setAppHostModuleLoader,
112
+ setAppModuleLoader,
113
+ setAppServerModuleTranspiler,
114
+ shouldAppUseHostModuleLoader
115
+ };
@@ -0,0 +1,4 @@
1
+ import type { SourceModuleLoader } from './module-loading-types.js';
2
+ export declare function setHostModuleLoader(loader: SourceModuleLoader): void;
3
+ export declare function getHostModuleLoader(): SourceModuleLoader | undefined;
4
+ export declare function clearHostModuleLoader(): void;
@@ -0,0 +1,15 @@
1
+ let hostModuleLoader;
2
+ function setHostModuleLoader(loader) {
3
+ hostModuleLoader = loader;
4
+ }
5
+ function getHostModuleLoader() {
6
+ return hostModuleLoader;
7
+ }
8
+ function clearHostModuleLoader() {
9
+ hostModuleLoader = void 0;
10
+ }
11
+ export {
12
+ clearHostModuleLoader,
13
+ getHostModuleLoader,
14
+ setHostModuleLoader
15
+ };
@@ -0,0 +1,2 @@
1
+ export type SourceModuleLoader = (id: string) => Promise<unknown>;
2
+ export type SourceModuleLoaderFactory = () => SourceModuleLoader | undefined;