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

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,103 @@
1
+ import type { EcoPagesAppConfig, IHmrManager } from '../../../types/internal-types.js';
2
+ import type { AssetDefinition, AssetKind, AssetSource, ProcessedAsset } from './assets.types.js';
3
+ import { ProcessorRegistry } from './processor.registry.js';
4
+ /**
5
+ * Processes declared component and page asset dependencies for one app instance.
6
+ *
7
+ * @remarks
8
+ * This service is the shared bridge between dependency declarations and emitted
9
+ * runtime-ready assets. It owns deduplication, processor dispatch, cache reuse,
10
+ * output URL normalization, and production gzip preparation so route rendering
11
+ * and HMR flows do not need to understand processor-specific behavior.
12
+ */
13
+ export declare class AssetProcessingService {
14
+ static readonly RESOLVED_ASSETS_DIR = "assets";
15
+ private registry;
16
+ private hmrManager?;
17
+ private cache;
18
+ private readonly config;
19
+ /**
20
+ * Creates the asset-processing service bound to one finalized app config.
21
+ */
22
+ constructor(config: EcoPagesAppConfig);
23
+ /**
24
+ * Set the HMR manager for the asset processing service.
25
+ * @param hmrManager The HMR manager to set.
26
+ */
27
+ setHmrManager(hmrManager: IHmrManager): void;
28
+ getHmrManager(): IHmrManager | undefined;
29
+ /**
30
+ * Register a processor for a specific asset kind and source.
31
+ * @param kind The asset kind.
32
+ * @param variant The asset source.
33
+ * @param processor The processor to register.
34
+ */
35
+ registerProcessor(kind: AssetKind, variant: AssetSource, processor: any): void;
36
+ /**
37
+ * Processes one dependency list into normalized emitted assets.
38
+ *
39
+ * @remarks
40
+ * Dependencies are deduplicated before processor execution so repeated
41
+ * declarations across the render tree reuse the same emitted outputs and cache
42
+ * entries.
43
+ */
44
+ processDependencies(deps: AssetDefinition[], key: string): Promise<ProcessedAsset[]>;
45
+ /**
46
+ * Processes deduplicated dependencies grouped by processor type.
47
+ *
48
+ * @remarks
49
+ * Grouping keeps cache and processor behavior isolated by asset kind/source
50
+ * pair, while still allowing the overall dependency set to resolve in
51
+ * parallel.
52
+ */
53
+ private processDependenciesParallel;
54
+ /**
55
+ * Groups dependencies by processor bucket.
56
+ */
57
+ private groupDependenciesByType;
58
+ /**
59
+ * Converts a dist-local file path into its public URL.
60
+ */
61
+ private getSrcUrl;
62
+ /**
63
+ * Normalizes the public source URL for one processed asset.
64
+ */
65
+ private resolveProcessedAssetSrcUrl;
66
+ /**
67
+ * Returns whether a value should be interpreted as a filesystem path instead
68
+ * of an already-public URL.
69
+ */
70
+ private isFilesystemPath;
71
+ /**
72
+ * Applies post-processing for emitted production assets.
73
+ *
74
+ * @remarks
75
+ * Current optimization is intentionally conservative: only generated CSS and
76
+ * JavaScript files inside the app dist directory are gzipped.
77
+ */
78
+ private optimizeDependencies;
79
+ /**
80
+ * Returns the cached processed asset for a dependency key when available.
81
+ */
82
+ private getCachedAsset;
83
+ /**
84
+ * Stores one processed asset in the dependency cache.
85
+ */
86
+ private setCachedAsset;
87
+ /**
88
+ * Clears all cached processed assets.
89
+ */
90
+ clearCache(): void;
91
+ /**
92
+ * Removes cached assets that were produced from the given file path.
93
+ */
94
+ invalidateCacheForFile(filepath: string): void;
95
+ /**
96
+ * Creates a service prewired with the default core processors.
97
+ */
98
+ static createWithDefaultProcessors(appConfig: EcoPagesAppConfig): AssetProcessingService;
99
+ /**
100
+ * Returns the processor registry owned by this service.
101
+ */
102
+ getRegistry(): ProcessorRegistry;
103
+ }
@@ -1,25 +1,34 @@
1
1
  import path from "node:path";
2
- import { RESOLVED_ASSETS_DIR } from "../../constants";
3
- import { appLogger } from "../../global/app-logger";
4
- import { rapidhash } from "../../utils/hash";
2
+ import { RESOLVED_ASSETS_DIR } from "../../../config/constants.js";
3
+ import { appLogger } from "../../../global/app-logger.js";
5
4
  import { fileSystem } from "@ecopages/file-system";
6
- import { isHmrAware } from "./processor.interface";
7
- import { ProcessorRegistry } from "./processor.registry";
5
+ import { deduplicateAssetDependencies, getAssetDependencyKey } from "./asset-dependency-keys.js";
6
+ import {
7
+ partitionGroupedContentScriptDependencies,
8
+ processGroupedDependencyBundles
9
+ } from "./grouped-content-bundles.js";
10
+ import { isHmrAware } from "./processor.interface.js";
11
+ import { ProcessorRegistry } from "./processor.registry.js";
12
+ import { processUngroupedDependency } from "./ungrouped-dependency-processing.js";
8
13
  import {
9
14
  ContentScriptProcessor,
10
15
  ContentStylesheetProcessor,
11
16
  FileScriptProcessor,
12
17
  FileStylesheetProcessor,
13
18
  NodeModuleScriptProcessor
14
- } from "./processors";
19
+ } from "./processors/index.js";
15
20
  class AssetProcessingService {
16
- constructor(config) {
17
- this.config = config;
18
- }
19
21
  static RESOLVED_ASSETS_DIR = RESOLVED_ASSETS_DIR;
20
22
  registry = new ProcessorRegistry();
21
23
  hmrManager;
22
24
  cache = /* @__PURE__ */ new Map();
25
+ config;
26
+ /**
27
+ * Creates the asset-processing service bound to one finalized app config.
28
+ */
29
+ constructor(config) {
30
+ this.config = config;
31
+ }
23
32
  /**
24
33
  * Set the HMR manager for the asset processing service.
25
34
  * @param hmrManager The HMR manager to set.
@@ -47,106 +56,87 @@ class AssetProcessingService {
47
56
  }
48
57
  this.registry.register(kind, variant, processor);
49
58
  }
59
+ /**
60
+ * Processes one dependency list into normalized emitted assets.
61
+ *
62
+ * @remarks
63
+ * Dependencies are deduplicated before processor execution so repeated
64
+ * declarations across the render tree reuse the same emitted outputs and cache
65
+ * entries.
66
+ */
50
67
  async processDependencies(deps, key) {
51
68
  const depsDir = path.join(this.config.absolutePaths.distDir, RESOLVED_ASSETS_DIR);
52
69
  fileSystem.ensureDir(depsDir);
53
- const dedupedDeps = this.deduplicateDependencies(deps);
70
+ const dedupedDeps = deduplicateAssetDependencies(deps);
54
71
  const results = await this.processDependenciesParallel(dedupedDeps, key);
55
72
  await this.optimizeDependencies(results);
56
73
  return results;
57
74
  }
58
- deduplicateDependencies(deps) {
59
- const seen = /* @__PURE__ */ new Map();
60
- for (const dep of deps) {
61
- const key = this.getDependencyKey(dep);
62
- if (!seen.has(key)) {
63
- seen.set(key, dep);
64
- }
65
- }
66
- return Array.from(seen.values());
67
- }
68
- getScriptDependencyBuildSignature(dep) {
69
- if (dep.kind !== "script") {
70
- return void 0;
71
- }
72
- const pluginNames = dep.bundleOptions?.plugins?.map((plugin) => plugin.name) ?? [];
73
- const signature = {
74
- bundle: dep.bundle,
75
- inline: dep.inline,
76
- excludeFromHtml: dep.excludeFromHtml,
77
- naming: dep.bundleOptions?.naming,
78
- external: dep.bundleOptions?.external,
79
- minify: dep.bundleOptions?.minify,
80
- plugins: pluginNames
81
- };
82
- return this.generateHash(JSON.stringify(signature));
83
- }
84
- getDependencyKey(dep) {
85
- const parts = [dep.kind, dep.source];
86
- if ("filepath" in dep) {
87
- parts.push(dep.filepath);
88
- } else if ("content" in dep) {
89
- parts.push(`content:${this.generateHash(dep.content)}`);
90
- } else if ("importPath" in dep) {
91
- parts.push(dep.importPath);
92
- }
93
- if ("position" in dep && dep.position) {
94
- parts.push(dep.position);
95
- }
96
- const scriptBuildSignature = this.getScriptDependencyBuildSignature(dep);
97
- if (scriptBuildSignature) {
98
- parts.push(`build:${scriptBuildSignature}`);
99
- }
100
- return parts.join(":");
101
- }
102
- generateHash(content) {
103
- return rapidhash(content).toString();
104
- }
75
+ /**
76
+ * Processes deduplicated dependencies grouped by processor type.
77
+ *
78
+ * @remarks
79
+ * Grouping keeps cache and processor behavior isolated by asset kind/source
80
+ * pair, while still allowing the overall dependency set to resolve in
81
+ * parallel.
82
+ */
105
83
  async processDependenciesParallel(deps, key) {
106
84
  const grouped = this.groupDependenciesByType(deps);
107
85
  const groupPromises = Object.entries(grouped).map(async ([, typeDeps]) => {
108
- const typePromises = typeDeps.map(async (dep) => {
109
- const depKey = this.getDependencyKey(dep);
110
- const cached = this.getCachedAsset(dep, depKey);
111
- if (cached) {
112
- return { key, ...cached };
113
- }
114
- const processor = this.registry.getProcessor(dep.kind, dep.source);
115
- if (!processor) {
116
- appLogger.error(`No processor found for ${dep.kind}/${dep.source}`);
117
- return null;
118
- }
119
- if (dep.source === "file" && "filepath" in dep) {
120
- const fileExists = fileSystem.exists(dep.filepath);
121
- if (!fileExists) {
122
- appLogger.warn(`Skipping missing ${dep.kind} file: ${dep.filepath}`);
123
- return null;
86
+ const { groupedBundleDeps, ungroupedDeps } = partitionGroupedContentScriptDependencies(typeDeps);
87
+ const typePromises = ungroupedDeps.map(
88
+ (dep) => processUngroupedDependency({
89
+ dep,
90
+ key,
91
+ depKey: getAssetDependencyKey(dep),
92
+ getCachedAsset: (assetDep, depKey) => this.getCachedAsset(assetDep, depKey),
93
+ getProcessor: (assetDep) => this.registry.getProcessor(assetDep.kind, assetDep.source),
94
+ resolveProcessedAssetSrcUrl: (processed) => this.resolveProcessedAssetSrcUrl(processed),
95
+ setCachedAsset: (assetDep, depKey, processed) => this.setCachedAsset(assetDep, depKey, processed),
96
+ logMissingProcessor: (assetDep) => {
97
+ appLogger.error(`No processor found for ${assetDep.kind}/${assetDep.source}`);
98
+ },
99
+ logMissingFile: (assetDep) => {
100
+ appLogger.warn(`Skipping missing ${assetDep.kind} file: ${assetDep.filepath}`);
101
+ },
102
+ logProcessingError: (assetDep, error) => {
103
+ appLogger.error(
104
+ `Failed to process dependency: ${error instanceof Error ? error.message : String(error)} for ${assetDep.kind}/${assetDep.source}`
105
+ );
106
+ appLogger.debug(error);
124
107
  }
125
- }
126
- try {
127
- const processed = await processor.process(dep);
128
- const srcUrl = this.resolveProcessedAssetSrcUrl(processed);
129
- const processedWithKey = {
130
- key,
131
- ...processed,
132
- srcUrl
133
- };
134
- this.setCachedAsset(dep, depKey, processedWithKey);
135
- return processedWithKey;
136
- } catch (error) {
108
+ })
109
+ );
110
+ const groupedResults = await processGroupedDependencyBundles({
111
+ bundles: Array.from(groupedBundleDeps.values()),
112
+ key,
113
+ getCachedAsset: (dep, depKey) => this.getCachedAsset(dep, depKey),
114
+ getDependencyKey: getAssetDependencyKey,
115
+ getGroupedProcessor: () => this.registry.getProcessor("script", "content"),
116
+ resolveProcessedAssetSrcUrl: (processed) => this.resolveProcessedAssetSrcUrl(processed),
117
+ setCachedAsset: (dep, depKey, processed) => this.setCachedAsset(dep, depKey, processed),
118
+ logError: (error) => {
137
119
  appLogger.error(
138
- `Failed to process dependency: ${error instanceof Error ? error.message : String(error)} for ${dep.kind}/${dep.source}`
120
+ `Failed to process grouped dependency bundle: ${error instanceof Error ? error.message : String(error)}`
139
121
  );
140
122
  appLogger.debug(error);
141
- return null;
142
123
  }
143
124
  });
144
125
  const typeResults = await Promise.all(typePromises);
145
- return typeResults.filter((result) => result !== null);
126
+ const processedTypeResults = typeResults.flatMap((result) => {
127
+ if (!result) {
128
+ return [];
129
+ }
130
+ return Array.isArray(result) ? result : [result];
131
+ });
132
+ return [...processedTypeResults, ...groupedResults];
146
133
  });
147
134
  const allTypeResults = await Promise.all(groupPromises);
148
135
  return allTypeResults.flat();
149
136
  }
137
+ /**
138
+ * Groups dependencies by processor bucket.
139
+ */
150
140
  groupDependenciesByType(deps) {
151
141
  return deps.reduce(
152
142
  (acc, dep) => {
@@ -158,6 +148,9 @@ class AssetProcessingService {
158
148
  {}
159
149
  );
160
150
  }
151
+ /**
152
+ * Converts a dist-local file path into its public URL.
153
+ */
161
154
  getSrcUrl(filepath) {
162
155
  const distDir = this.config.absolutePaths.distDir;
163
156
  if (!filepath.startsWith(distDir)) return void 0;
@@ -165,6 +158,9 @@ class AssetProcessingService {
165
158
  const urlPath = relativePath.startsWith("/") ? relativePath : `/${relativePath}`;
166
159
  return urlPath.replace(/\\/g, "/");
167
160
  }
161
+ /**
162
+ * Normalizes the public source URL for one processed asset.
163
+ */
168
164
  resolveProcessedAssetSrcUrl(processed) {
169
165
  if (processed.srcUrl) {
170
166
  if (this.isFilesystemPath(processed.srcUrl)) {
@@ -179,6 +175,10 @@ class AssetProcessingService {
179
175
  }
180
176
  return void 0;
181
177
  }
178
+ /**
179
+ * Returns whether a value should be interpreted as a filesystem path instead
180
+ * of an already-public URL.
181
+ */
182
182
  isFilesystemPath(value) {
183
183
  if (value.startsWith("http://") || value.startsWith("https://") || value.startsWith("//")) {
184
184
  return false;
@@ -192,6 +192,13 @@ class AssetProcessingService {
192
192
  }
193
193
  return /^[A-Za-z]:\\/.test(value);
194
194
  }
195
+ /**
196
+ * Applies post-processing for emitted production assets.
197
+ *
198
+ * @remarks
199
+ * Current optimization is intentionally conservative: only generated CSS and
200
+ * JavaScript files inside the app dist directory are gzipped.
201
+ */
195
202
  async optimizeDependencies(processedAssets) {
196
203
  if (process.env.NODE_ENV !== "production") {
197
204
  return;
@@ -215,16 +222,38 @@ class AssetProcessingService {
215
222
  }
216
223
  }
217
224
  }
225
+ /**
226
+ * Returns the cached processed asset for a dependency key when available.
227
+ */
218
228
  getCachedAsset(dep, depKey) {
229
+ if (process.env.NODE_ENV !== "production" && dep.source === "file" && dep.kind === "stylesheet") {
230
+ return null;
231
+ }
219
232
  const cached = this.cache.get(depKey);
220
- return cached?.asset ?? null;
233
+ if (!cached) {
234
+ return null;
235
+ }
236
+ if (cached.asset.filepath && !fileSystem.exists(cached.asset.filepath)) {
237
+ this.cache.delete(depKey);
238
+ return null;
239
+ }
240
+ return cached.asset;
221
241
  }
242
+ /**
243
+ * Stores one processed asset in the dependency cache.
244
+ */
222
245
  setCachedAsset(dep, depKey, asset) {
223
246
  this.cache.set(depKey, { asset });
224
247
  }
248
+ /**
249
+ * Clears all cached processed assets.
250
+ */
225
251
  clearCache() {
226
252
  this.cache.clear();
227
253
  }
254
+ /**
255
+ * Removes cached assets that were produced from the given file path.
256
+ */
228
257
  invalidateCacheForFile(filepath) {
229
258
  for (const [key, value] of this.cache.entries()) {
230
259
  if (value.asset.filepath === filepath) {
@@ -232,6 +261,9 @@ class AssetProcessingService {
232
261
  }
233
262
  }
234
263
  }
264
+ /**
265
+ * Creates a service prewired with the default core processors.
266
+ */
235
267
  static createWithDefaultProcessors(appConfig) {
236
268
  const service = new AssetProcessingService(appConfig);
237
269
  service.registerProcessor("script", "content", new ContentScriptProcessor({ appConfig }));
@@ -241,6 +273,9 @@ class AssetProcessingService {
241
273
  service.registerProcessor("stylesheet", "file", new FileStylesheetProcessor({ appConfig }));
242
274
  return service;
243
275
  }
276
+ /**
277
+ * Returns the processor registry owned by this service.
278
+ */
244
279
  getRegistry() {
245
280
  return this.registry;
246
281
  }
@@ -1,4 +1,4 @@
1
- import type { ContentScriptAsset, ContentStylesheetAsset, FileScriptAsset, FileStylesheetAsset, InlineContentScriptAsset, InlineContentStylesheetAsset, InlineFileScriptAsset, JsonScriptAsset, NodeModuleScriptAsset } from './assets.types';
1
+ import type { ContentScriptAsset, ContentStylesheetAsset, FileScriptAsset, FileStylesheetAsset, InlineContentScriptAsset, InlineContentStylesheetAsset, InlineFileScriptAsset, JsonScriptAsset, NodeModuleScriptAsset } from './assets.types.js';
2
2
  type CreateAssetOptions<T> = Omit<T, 'kind' | 'source' | 'inline'>;
3
3
  export declare class AssetFactory {
4
4
  static readonly RESOLVED_ASSETS_DIR = "assets";
@@ -1,5 +1,5 @@
1
- import { RESOLVED_ASSETS_DIR, RESOLVED_ASSETS_VENDORS_DIR } from "../../constants";
2
- import { deepMerge } from "../../utils/deep-merge";
1
+ import { RESOLVED_ASSETS_DIR, RESOLVED_ASSETS_VENDORS_DIR } from "../../../config/constants.js";
2
+ import { deepMerge } from "../../../utils/deep-merge.js";
3
3
  class AssetFactory {
4
4
  static RESOLVED_ASSETS_DIR = RESOLVED_ASSETS_DIR;
5
5
  static RESOLVED_ASSETS_VENDORS_DIR = RESOLVED_ASSETS_VENDORS_DIR;
@@ -1,20 +1,31 @@
1
- import type { EcoBuildPlugin } from '../../build/build-types.js';
1
+ import type { EcoBuildPlugin } from '../../../build/build-types.js';
2
2
  export type AssetSource = 'content' | 'file' | 'node-module';
3
3
  export type AssetKind = 'script' | 'stylesheet';
4
4
  export type AssetPosition = 'head' | 'body';
5
+ export type AssetPackageRole = 'page-script' | 'page-style' | 'runtime' | 'keep-separate' | 'dynamic-chunk';
6
+ export type GroupedScriptBundle = {
7
+ id: string;
8
+ entryName: string;
9
+ };
5
10
  export interface BaseAsset {
6
11
  kind: AssetKind;
7
12
  source: AssetSource;
8
13
  attributes?: Record<string, string>;
9
14
  position?: AssetPosition;
15
+ packageRole?: AssetPackageRole;
16
+ bundledSourceFilepaths?: string[];
10
17
  }
11
18
  export interface ScriptAsset extends BaseAsset {
12
19
  kind: 'script';
13
20
  inline?: boolean;
14
21
  bundle?: boolean;
22
+ groupedBundle?: GroupedScriptBundle;
15
23
  bundleOptions?: {
24
+ define?: Record<string, string>;
16
25
  minify?: boolean;
17
26
  external?: string[];
27
+ splitting?: boolean;
28
+ excludeAppBuildPlugins?: string[];
18
29
  naming?: string;
19
30
  plugins?: EcoBuildPlugin[];
20
31
  };
@@ -77,6 +88,7 @@ export interface JsonScriptAsset extends ScriptAsset {
77
88
  }
78
89
  export type ProcessedAsset = {
79
90
  filepath?: string;
91
+ sourceFilepath?: string;
80
92
  srcUrl?: string;
81
93
  content?: string;
82
94
  kind: AssetKind;
@@ -84,5 +96,8 @@ export type ProcessedAsset = {
84
96
  attributes?: Record<string, string>;
85
97
  inline?: boolean;
86
98
  excludeFromHtml?: boolean;
99
+ packageRole?: AssetPackageRole;
100
+ groupedBundle?: GroupedScriptBundle;
101
+ bundledSourceFilepaths?: string[];
87
102
  };
88
103
  export type AssetDefinition = ContentScriptAsset | FileScriptAsset | NodeModuleScriptAsset | JsonScriptAsset | ContentStylesheetAsset | FileStylesheetAsset;
@@ -0,0 +1,55 @@
1
+ import type { EcoBuildPlugin } from '../../../build/build-types.js';
2
+ import type { AssetDefinition } from './assets.types.js';
3
+ import { type BrowserRuntimeEntryModuleConfig } from './browser-runtime-entry.factory.js';
4
+ export declare const BROWSER_RUNTIME_SCRIPT_ATTRIBUTES: {
5
+ readonly type: "module";
6
+ readonly defer: "";
7
+ };
8
+ /**
9
+ * Builds the public vendor URL used for generated browser runtime assets.
10
+ */
11
+ export declare function buildBrowserRuntimeAssetUrl(fileName: string): string;
12
+ /**
13
+ * Declares a browser runtime script asset backed by one importable module.
14
+ *
15
+ * @remarks
16
+ * Runtime assets are emitted as excluded head scripts because integrations often
17
+ * need the bundler output and specifier registration without injecting the raw
18
+ * asset directly into HTML during dependency resolution.
19
+ */
20
+ export declare function createBrowserRuntimeScriptAsset(options: {
21
+ importPath: string;
22
+ name: string;
23
+ fileName: string;
24
+ bundleOptions?: {
25
+ define?: Record<string, string>;
26
+ minify?: boolean;
27
+ external?: string[];
28
+ naming?: string;
29
+ plugins?: EcoBuildPlugin[];
30
+ };
31
+ attributes?: Record<string, string>;
32
+ }): AssetDefinition;
33
+ /**
34
+ * Creates a browser runtime asset from a generated re-export entry module.
35
+ *
36
+ * @remarks
37
+ * This is the shared "module list -> generated entry file -> runtime asset"
38
+ * path used by integrations that need browser-side runtime bundles without
39
+ * owning bespoke entry-file generation logic.
40
+ */
41
+ export declare function createBrowserRuntimeModuleAsset(options: {
42
+ modules: BrowserRuntimeEntryModuleConfig[];
43
+ name: string;
44
+ fileName: string;
45
+ cacheDirName?: string;
46
+ rootDir?: string;
47
+ bundleOptions?: {
48
+ define?: Record<string, string>;
49
+ minify?: boolean;
50
+ external?: string[];
51
+ naming?: string;
52
+ plugins?: EcoBuildPlugin[];
53
+ };
54
+ attributes?: Record<string, string>;
55
+ }): AssetDefinition;
@@ -0,0 +1,49 @@
1
+ import { AssetFactory } from "./asset.factory.js";
2
+ import {
3
+ createBrowserRuntimeEntryModule
4
+ } from "./browser-runtime-entry.factory.js";
5
+ const BROWSER_RUNTIME_SCRIPT_ATTRIBUTES = {
6
+ type: "module",
7
+ defer: ""
8
+ };
9
+ function buildBrowserRuntimeAssetUrl(fileName) {
10
+ return `/${AssetFactory.RESOLVED_ASSETS_VENDORS_DIR}/${fileName}`;
11
+ }
12
+ function createBrowserRuntimeScriptAsset(options) {
13
+ return AssetFactory.createNodeModuleScript({
14
+ position: "head",
15
+ importPath: options.importPath,
16
+ name: options.name,
17
+ packageRole: "runtime",
18
+ excludeFromHtml: true,
19
+ bundleOptions: {
20
+ naming: options.fileName,
21
+ ...options.bundleOptions
22
+ },
23
+ attributes: {
24
+ ...BROWSER_RUNTIME_SCRIPT_ATTRIBUTES,
25
+ ...options.attributes ?? {}
26
+ }
27
+ });
28
+ }
29
+ function createBrowserRuntimeModuleAsset(options) {
30
+ const importPath = createBrowserRuntimeEntryModule({
31
+ modules: options.modules,
32
+ fileName: `${options.name}-entry.mjs`,
33
+ rootDir: options.rootDir,
34
+ cacheDirName: options.cacheDirName
35
+ });
36
+ return createBrowserRuntimeScriptAsset({
37
+ importPath,
38
+ name: options.name,
39
+ fileName: options.fileName,
40
+ bundleOptions: options.bundleOptions,
41
+ attributes: options.attributes
42
+ });
43
+ }
44
+ export {
45
+ BROWSER_RUNTIME_SCRIPT_ATTRIBUTES,
46
+ buildBrowserRuntimeAssetUrl,
47
+ createBrowserRuntimeModuleAsset,
48
+ createBrowserRuntimeScriptAsset
49
+ };
@@ -0,0 +1,20 @@
1
+ export type BrowserRuntimeEntryModuleConfig = {
2
+ specifier: string;
3
+ defaultExport?: boolean;
4
+ };
5
+ /**
6
+ * Creates a generated ESM entry module that re-exports runtime modules through
7
+ * one stable file.
8
+ *
9
+ * @remarks
10
+ * Integrations use this helper when they need a browser runtime asset composed
11
+ * from multiple bare specifiers but do not want to own temporary file assembly
12
+ * logic themselves. The generated file lives under a cache directory inside the
13
+ * consuming app root so repeated runs can reuse the same location.
14
+ */
15
+ export declare function createBrowserRuntimeEntryModule(options: {
16
+ modules: BrowserRuntimeEntryModuleConfig[];
17
+ fileName: string;
18
+ rootDir?: string;
19
+ cacheDirName?: string;
20
+ }): string;
@@ -0,0 +1,41 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { createRequire } from "node:module";
4
+ function createBrowserRuntimeEntryModule(options) {
5
+ const rootDir = options.rootDir ?? process.cwd();
6
+ const artifactsDir = path.join(
7
+ rootDir,
8
+ "node_modules",
9
+ ".cache",
10
+ options.cacheDirName ?? "ecopages-browser-runtime"
11
+ );
12
+ fs.mkdirSync(artifactsDir, { recursive: true });
13
+ const requireFromRoot = createRequire(path.join(rootDir, "package.json"));
14
+ const seenExports = /* @__PURE__ */ new Set();
15
+ const statements = [];
16
+ for (const module of options.modules) {
17
+ if (module.defaultExport) {
18
+ statements.push(`import __ecopages_default_export__ from '${module.specifier}';`);
19
+ statements.push("export default __ecopages_default_export__;");
20
+ }
21
+ const exportNames = getModuleExportNames(module.specifier, requireFromRoot).filter(
22
+ (name) => !seenExports.has(name)
23
+ );
24
+ if (exportNames.length > 0) {
25
+ statements.push(`export { ${exportNames.join(", ")} } from '${module.specifier}';`);
26
+ for (const exportName of exportNames) {
27
+ seenExports.add(exportName);
28
+ }
29
+ }
30
+ }
31
+ const filePath = path.join(artifactsDir, options.fileName);
32
+ fs.writeFileSync(filePath, statements.join("\n"), "utf-8");
33
+ return filePath;
34
+ }
35
+ function getModuleExportNames(specifier, requireFromRoot) {
36
+ const moduleExports = requireFromRoot(specifier);
37
+ return Object.keys(moduleExports).filter((name) => name !== "__esModule" && name !== "default").filter((name) => /^[$A-Z_a-z][$\w]*$/.test(name)).sort();
38
+ }
39
+ export {
40
+ createBrowserRuntimeEntryModule
41
+ };