@ecopages/core 0.2.0-alpha.53 → 0.2.0-alpha.54

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 (590) hide show
  1. package/README.md +2 -3
  2. package/package.json +97 -182
  3. package/src/adapters/abstract/application-adapter.test.ts +218 -0
  4. package/src/adapters/abstract/application-adapter.ts +379 -0
  5. package/src/adapters/abstract/router-adapter.ts +30 -0
  6. package/src/adapters/abstract/server-adapter.ts +79 -0
  7. package/src/adapters/bun/client-bridge.ts +62 -0
  8. package/src/adapters/bun/create-app.ts +214 -0
  9. package/src/adapters/bun/hmr-manager.test.ts +265 -0
  10. package/src/adapters/bun/hmr-manager.ts +88 -0
  11. package/src/adapters/bun/index.ts +2 -0
  12. package/src/adapters/bun/runtime-host.ts +76 -0
  13. package/src/adapters/bun/server-adapter.ts +605 -0
  14. package/src/adapters/bun/static-preview-host.ts +70 -0
  15. package/src/adapters/create-app.test.ts +10 -0
  16. package/src/adapters/create-app.ts +91 -0
  17. package/src/adapters/index.ts +2 -0
  18. package/src/adapters/node/create-app.test.ts +76 -0
  19. package/src/adapters/node/create-app.ts +116 -0
  20. package/src/adapters/node/http-request-bridge.test.ts +146 -0
  21. package/src/adapters/node/http-request-bridge.ts +176 -0
  22. package/src/adapters/node/node-client-bridge.test.ts +198 -0
  23. package/src/adapters/node/node-client-bridge.ts +79 -0
  24. package/src/adapters/node/node-hmr-manager.test.ts +374 -0
  25. package/src/adapters/node/node-hmr-manager.ts +72 -0
  26. package/src/adapters/node/runtime-host.test.ts +49 -0
  27. package/src/adapters/node/runtime-host.ts +113 -0
  28. package/src/adapters/node/server-adapter-dependencies.ts +28 -0
  29. package/src/adapters/node/server-adapter.test.ts +84 -0
  30. package/src/adapters/node/server-adapter.ts +423 -0
  31. package/src/adapters/node/static-content-server.test.ts +60 -0
  32. package/src/adapters/node/static-content-server.ts +239 -0
  33. package/src/adapters/node/static-preview-host.test.ts +89 -0
  34. package/src/adapters/node/static-preview-host.ts +101 -0
  35. package/src/adapters/shared/api-response.test.ts +97 -0
  36. package/src/adapters/shared/api-response.ts +104 -0
  37. package/src/adapters/shared/application-adapter.ts +199 -0
  38. package/src/adapters/shared/define-api-handler.ts +66 -0
  39. package/src/adapters/shared/explicit-static-render-preparation.ts +58 -0
  40. package/src/adapters/shared/explicit-static-route-matcher.test.ts +381 -0
  41. package/src/adapters/shared/explicit-static-route-matcher.ts +131 -0
  42. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +85 -0
  43. package/src/adapters/shared/file-route-middleware-pipeline.ts +118 -0
  44. package/src/adapters/shared/fs-server-response-factory.test.ts +176 -0
  45. package/src/adapters/shared/fs-server-response-factory.ts +96 -0
  46. package/src/adapters/shared/fs-server-response-matcher.test.ts +311 -0
  47. package/src/adapters/shared/fs-server-response-matcher.ts +240 -0
  48. package/src/adapters/shared/hmr-entrypoint-registrar.ts +149 -0
  49. package/src/adapters/shared/hmr-html-response.ts +54 -0
  50. package/src/adapters/shared/hmr-manager.contract.test.ts +228 -0
  51. package/src/adapters/shared/hmr-manager.dispatch.test.ts +229 -0
  52. package/src/adapters/shared/render-context.test.ts +244 -0
  53. package/src/adapters/shared/render-context.ts +161 -0
  54. package/src/adapters/shared/runtime-app-bootstrap.test.ts +96 -0
  55. package/src/adapters/shared/runtime-app-bootstrap.ts +72 -0
  56. package/src/adapters/shared/runtime-host.ts +11 -0
  57. package/src/adapters/shared/server-adapter.test.ts +130 -0
  58. package/src/adapters/shared/server-adapter.ts +571 -0
  59. package/src/adapters/shared/server-route-handler.test.ts +112 -0
  60. package/src/adapters/shared/server-route-handler.ts +153 -0
  61. package/src/adapters/shared/server-static-builder.test.ts +338 -0
  62. package/src/adapters/shared/server-static-builder.ts +170 -0
  63. package/src/adapters/shared/shared-hmr-manager.ts +298 -0
  64. package/src/adapters/shared/static-preview-host.ts +12 -0
  65. package/src/build/README.md +57 -73
  66. package/src/build/browser-runtime-manifest.test.ts +121 -0
  67. package/src/build/browser-runtime-manifest.ts +105 -0
  68. package/src/build/browser-runtime-plugin-helpers.test.ts +49 -0
  69. package/src/build/browser-runtime-plugin-helpers.ts +37 -0
  70. package/src/build/browser-runtime-plugin.test.ts +256 -0
  71. package/src/build/browser-runtime-plugin.ts +306 -0
  72. package/src/build/build-adapter.test.ts +463 -0
  73. package/src/build/build-adapter.ts +788 -0
  74. package/src/build/build-manifest.ts +79 -0
  75. package/src/build/build-types.ts +83 -0
  76. package/src/build/rolldown-build-adapter.test.ts +352 -0
  77. package/src/build/rolldown-build-adapter.ts +363 -0
  78. package/src/build/rolldown-plugin-bridge.test.ts +256 -0
  79. package/src/build/rolldown-plugin-bridge.ts +309 -0
  80. package/src/build/runtime-build-executor.test.ts +130 -0
  81. package/src/build/runtime-build-executor.ts +37 -0
  82. package/src/build/runtime-build-output-normalizer.ts +137 -0
  83. package/src/build/serialized-build-executor.test.ts +96 -0
  84. package/src/build/serialized-build-executor.ts +90 -0
  85. package/src/build/server-side-css-shim-plugin.ts +77 -0
  86. package/src/cache/index.ts +6 -0
  87. package/src/cache/module-parse-cache.test.ts +73 -0
  88. package/src/cache/module-parse-cache.ts +137 -0
  89. package/src/config/README.md +1 -1
  90. package/src/config/config-builder.test.ts +456 -0
  91. package/src/config/config-builder.ts +728 -0
  92. package/src/config/config-builder.typecheck.test.ts +96 -0
  93. package/src/config/{constants.d.ts → constants.ts} +22 -13
  94. package/src/dev/host-runtime.ts +34 -0
  95. package/src/dev/sc-server.ts +143 -0
  96. package/src/eco/eco.browser.test.ts +43 -0
  97. package/src/eco/eco.browser.ts +137 -0
  98. package/src/eco/eco.test.ts +781 -0
  99. package/src/eco/eco.ts +262 -0
  100. package/src/eco/eco.types.ts +293 -0
  101. package/src/eco/eco.utils.test.ts +219 -0
  102. package/src/eco/eco.utils.ts +5 -0
  103. package/src/eco/global-injector-map.test.ts +42 -0
  104. package/src/eco/global-injector-map.ts +112 -0
  105. package/src/eco/lazy-injector-map.test.ts +66 -0
  106. package/src/eco/lazy-injector-map.ts +120 -0
  107. package/src/eco/module-dependencies.test.ts +30 -0
  108. package/src/eco/module-dependencies.ts +75 -0
  109. package/src/errors/http-error.test.ts +134 -0
  110. package/src/errors/http-error.ts +72 -0
  111. package/src/errors/index.ts +3 -0
  112. package/src/errors/locals-access-error.ts +7 -0
  113. package/src/global/app-logger.ts +4 -0
  114. package/src/global/utils.test.ts +12 -0
  115. 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
  116. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  117. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  118. package/src/hmr/client/hmr-runtime.ts +162 -0
  119. package/src/hmr/hmr-strategy.test.ts +124 -0
  120. package/src/hmr/hmr-strategy.ts +177 -0
  121. package/src/hmr/hmr.postcss.test.e2e.ts +41 -0
  122. package/src/hmr/hmr.test.e2e.ts +66 -0
  123. package/src/hmr/strategies/default-hmr-strategy.ts +60 -0
  124. package/src/hmr/strategies/js-hmr-strategy.test.ts +344 -0
  125. package/src/hmr/strategies/js-hmr-strategy.ts +307 -0
  126. package/src/index.browser.ts +3 -0
  127. package/src/index.ts +15 -0
  128. package/src/integrations/ghtml/ghtml-renderer.test.ts +253 -0
  129. package/src/integrations/ghtml/ghtml-renderer.ts +87 -0
  130. package/src/integrations/ghtml/ghtml.constants.ts +1 -0
  131. package/src/integrations/ghtml/ghtml.plugin.ts +28 -0
  132. package/src/plugins/alias-resolver-cache.test.ts +110 -0
  133. package/src/plugins/alias-resolver-cache.ts +145 -0
  134. package/src/plugins/alias-resolver-plugin.test.ts +41 -0
  135. package/src/plugins/alias-resolver-plugin.ts +75 -0
  136. package/src/plugins/eco-component-meta-plugin.test.ts +421 -0
  137. package/src/plugins/eco-component-meta-plugin.ts +518 -0
  138. package/src/plugins/foreign-jsx-override-plugin.test.ts +65 -0
  139. package/src/plugins/foreign-jsx-override-plugin.ts +76 -0
  140. package/src/plugins/integration-plugin.test.ts +151 -0
  141. package/src/plugins/integration-plugin.ts +344 -0
  142. package/src/plugins/processor.test.ts +148 -0
  143. package/src/plugins/processor.ts +257 -0
  144. package/src/plugins/{runtime-capability.d.ts → runtime-capability.ts} +8 -3
  145. package/src/plugins/source-transform.test.ts +82 -0
  146. package/src/plugins/source-transform.ts +123 -0
  147. package/src/route-renderer/orchestration/component-render-context.ts +338 -0
  148. package/src/route-renderer/orchestration/declared-ownership-graph.ts +62 -0
  149. package/src/route-renderer/orchestration/foreign-subtree-execution.service.ts +431 -0
  150. package/src/route-renderer/orchestration/integration-renderer.test.ts +2251 -0
  151. package/src/route-renderer/orchestration/integration-renderer.ts +1384 -0
  152. package/src/route-renderer/orchestration/ownership-planning.service.ts +97 -0
  153. package/src/route-renderer/orchestration/ownership-validation.service.ts +76 -0
  154. package/src/route-renderer/orchestration/processed-asset-dedupe.ts +29 -0
  155. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.test.ts +435 -0
  156. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.ts +310 -0
  157. package/src/route-renderer/orchestration/render-output.utils.ts +310 -0
  158. package/src/route-renderer/orchestration/route-render-orchestrator.prepare-render-options.test.ts +1365 -0
  159. package/src/route-renderer/orchestration/route-render-orchestrator.test.ts +267 -0
  160. package/src/route-renderer/orchestration/route-render-orchestrator.ts +879 -0
  161. package/src/route-renderer/orchestration/template-serialization.test.ts +110 -0
  162. package/src/route-renderer/orchestration/template-serialization.ts +117 -0
  163. package/src/route-renderer/page-loading/component-dependency-collection.ts +202 -0
  164. package/src/route-renderer/page-loading/declared-asset-collection.ts +153 -0
  165. package/src/route-renderer/page-loading/dependency-resolver.test.ts +761 -0
  166. package/src/route-renderer/page-loading/dependency-resolver.ts +144 -0
  167. package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +75 -0
  168. package/src/route-renderer/page-loading/lazy-entry-collection.ts +167 -0
  169. package/src/route-renderer/page-loading/lazy-trigger-planning.ts +74 -0
  170. package/src/route-renderer/page-loading/module-declaration-aggregation.ts +60 -0
  171. package/src/route-renderer/page-loading/module-declaration-scripts.ts +16 -0
  172. package/src/route-renderer/page-loading/page-dependency-bundling.ts +244 -0
  173. package/src/route-renderer/page-loading/page-module-loader.test.ts +183 -0
  174. package/src/route-renderer/page-loading/page-module-loader.ts +184 -0
  175. package/src/route-renderer/route-renderer.ts +133 -0
  176. package/src/router/client/link-intent.test.browser.ts +51 -0
  177. package/src/router/client/link-intent.ts +92 -0
  178. package/src/router/client/navigation-coordinator.test.ts +237 -0
  179. package/src/router/client/navigation-coordinator.ts +453 -0
  180. package/src/router/server/route-registry.test.ts +176 -0
  181. package/src/router/server/route-registry.ts +382 -0
  182. package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +66 -0
  183. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +473 -0
  184. package/src/services/assets/asset-processing-service/asset-processing.service.ts +344 -0
  185. package/src/services/assets/asset-processing-service/asset.factory.test.ts +63 -0
  186. package/src/services/assets/asset-processing-service/asset.factory.ts +105 -0
  187. package/src/services/assets/asset-processing-service/assets.types.ts +128 -0
  188. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +74 -0
  189. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +98 -0
  190. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +67 -0
  191. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +78 -0
  192. package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +104 -0
  193. package/src/services/assets/asset-processing-service/index.ts +6 -0
  194. package/src/services/assets/asset-processing-service/page-package.test.ts +135 -0
  195. package/src/services/assets/asset-processing-service/page-package.ts +103 -0
  196. package/src/services/assets/asset-processing-service/{processor.interface.d.ts → processor.interface.ts} +10 -5
  197. package/src/services/assets/asset-processing-service/processor.registry.ts +18 -0
  198. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +59 -0
  199. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +83 -0
  200. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +173 -0
  201. package/src/services/assets/asset-processing-service/processors/index.ts +5 -0
  202. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +188 -0
  203. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +138 -0
  204. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +326 -0
  205. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +116 -0
  206. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +270 -0
  207. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +145 -0
  208. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +261 -0
  209. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +72 -0
  210. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +83 -0
  211. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +65 -0
  212. package/src/services/assets/browser-bundle.service.test.ts +66 -0
  213. package/src/services/assets/browser-bundle.service.ts +109 -0
  214. package/src/services/cache/cache.types.ts +126 -0
  215. package/src/services/cache/index.ts +18 -0
  216. package/src/services/cache/memory-cache-store.test.ts +225 -0
  217. package/src/services/cache/memory-cache-store.ts +130 -0
  218. package/src/services/cache/page-cache-service.test.ts +175 -0
  219. package/src/services/cache/page-cache-service.ts +202 -0
  220. package/src/services/cache/page-request-cache-coordinator.service.test.ts +79 -0
  221. package/src/services/cache/page-request-cache-coordinator.service.ts +131 -0
  222. package/src/services/html/html-rewriter-provider.service.test.ts +183 -0
  223. package/src/services/html/html-rewriter-provider.service.ts +105 -0
  224. package/src/services/html/html-transformer.service.test.ts +544 -0
  225. package/src/services/html/html-transformer.service.ts +369 -0
  226. package/src/services/invalidation/development-invalidation.service.test.ts +87 -0
  227. package/src/services/invalidation/development-invalidation.service.ts +262 -0
  228. package/src/services/module-loading/app-module-loader.service.ts +9 -0
  229. package/src/services/module-loading/app-server-module-transpiler.service.test.ts +297 -0
  230. package/src/services/module-loading/app-server-module-transpiler.service.ts +168 -0
  231. package/src/services/module-loading/host-module-loader-registry.ts +15 -0
  232. package/src/services/module-loading/{module-loading-types.d.ts → module-loading-types.ts} +1 -0
  233. package/src/services/module-loading/page-module-import.service.test.ts +652 -0
  234. package/src/services/module-loading/page-module-import.service.ts +302 -0
  235. package/src/services/module-loading/server-module-transpiler.service.test.ts +242 -0
  236. package/src/services/module-loading/server-module-transpiler.service.ts +104 -0
  237. package/src/services/module-loading/source-module-support.ts +19 -0
  238. package/src/services/runtime-state/dev-graph.service.ts +217 -0
  239. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +136 -0
  240. package/src/services/runtime-state/server-invalidation-state.service.ts +68 -0
  241. package/src/services/validation/schema-validation-service.test.ts +223 -0
  242. package/src/services/validation/schema-validation-service.ts +204 -0
  243. package/src/services/validation/{standard-schema.types.d.ts → standard-schema.types.ts} +20 -17
  244. package/src/static-site-generator/static-site-generator.test.ts +408 -0
  245. package/src/static-site-generator/static-site-generator.ts +445 -0
  246. package/src/types/internal-types.ts +243 -0
  247. package/src/types/public-types.ts +1508 -0
  248. package/src/utils/deep-merge.test.ts +114 -0
  249. package/src/utils/deep-merge.ts +47 -0
  250. package/src/utils/hash.ts +5 -0
  251. package/src/utils/html-escaping.ts +9 -0
  252. package/src/utils/invariant.test.ts +22 -0
  253. package/src/utils/invariant.ts +15 -0
  254. package/src/utils/locals-utils.ts +37 -0
  255. package/src/utils/parse-cli-args.test.ts +69 -0
  256. package/src/utils/parse-cli-args.ts +105 -0
  257. package/src/utils/path-utils.module.ts +14 -0
  258. package/src/utils/path-utils.test.ts +15 -0
  259. package/src/utils/resolve-work-dir.ts +45 -0
  260. package/src/utils/runtime.ts +44 -0
  261. package/src/utils/server-utils.module.ts +67 -0
  262. package/src/utils/server-utils.test.ts +38 -0
  263. package/src/watchers/project-watcher.integration.test.ts +337 -0
  264. package/src/watchers/project-watcher.test-helpers.ts +42 -0
  265. package/src/watchers/project-watcher.test.ts +768 -0
  266. package/src/watchers/project-watcher.ts +357 -0
  267. package/src/adapters/abstract/application-adapter.d.ts +0 -194
  268. package/src/adapters/abstract/application-adapter.js +0 -121
  269. package/src/adapters/abstract/router-adapter.d.ts +0 -26
  270. package/src/adapters/abstract/router-adapter.js +0 -5
  271. package/src/adapters/abstract/server-adapter.d.ts +0 -69
  272. package/src/adapters/abstract/server-adapter.js +0 -15
  273. package/src/adapters/bun/client-bridge.d.ts +0 -34
  274. package/src/adapters/bun/client-bridge.js +0 -48
  275. package/src/adapters/bun/create-app.d.ts +0 -60
  276. package/src/adapters/bun/create-app.js +0 -140
  277. package/src/adapters/bun/hmr-manager.d.ts +0 -47
  278. package/src/adapters/bun/hmr-manager.js +0 -58
  279. package/src/adapters/bun/index.d.ts +0 -2
  280. package/src/adapters/bun/index.js +0 -8
  281. package/src/adapters/bun/runtime-host.d.ts +0 -52
  282. package/src/adapters/bun/runtime-host.js +0 -56
  283. package/src/adapters/bun/server-adapter.d.ts +0 -216
  284. package/src/adapters/bun/server-adapter.js +0 -445
  285. package/src/adapters/bun/static-preview-host.d.ts +0 -28
  286. package/src/adapters/bun/static-preview-host.js +0 -45
  287. package/src/adapters/create-app.d.ts +0 -20
  288. package/src/adapters/create-app.js +0 -66
  289. package/src/adapters/index.d.ts +0 -2
  290. package/src/adapters/index.js +0 -8
  291. package/src/adapters/node/create-app.d.ts +0 -24
  292. package/src/adapters/node/create-app.js +0 -92
  293. package/src/adapters/node/http-request-bridge.d.ts +0 -57
  294. package/src/adapters/node/http-request-bridge.js +0 -118
  295. package/src/adapters/node/node-client-bridge.d.ts +0 -26
  296. package/src/adapters/node/node-client-bridge.js +0 -66
  297. package/src/adapters/node/node-hmr-manager.d.ts +0 -52
  298. package/src/adapters/node/node-hmr-manager.js +0 -49
  299. package/src/adapters/node/runtime-host.d.ts +0 -57
  300. package/src/adapters/node/runtime-host.js +0 -92
  301. package/src/adapters/node/server-adapter-dependencies.d.ts +0 -19
  302. package/src/adapters/node/server-adapter-dependencies.js +0 -18
  303. package/src/adapters/node/server-adapter.d.ts +0 -138
  304. package/src/adapters/node/server-adapter.js +0 -315
  305. package/src/adapters/node/static-content-server.d.ts +0 -60
  306. package/src/adapters/node/static-content-server.js +0 -194
  307. package/src/adapters/node/static-preview-host.d.ts +0 -55
  308. package/src/adapters/node/static-preview-host.js +0 -68
  309. package/src/adapters/shared/api-response.d.ts +0 -52
  310. package/src/adapters/shared/api-response.js +0 -96
  311. package/src/adapters/shared/application-adapter.d.ts +0 -18
  312. package/src/adapters/shared/application-adapter.js +0 -90
  313. package/src/adapters/shared/define-api-handler.d.ts +0 -25
  314. package/src/adapters/shared/define-api-handler.js +0 -15
  315. package/src/adapters/shared/explicit-static-render-preparation.d.ts +0 -25
  316. package/src/adapters/shared/explicit-static-render-preparation.js +0 -26
  317. package/src/adapters/shared/explicit-static-route-matcher.d.ts +0 -41
  318. package/src/adapters/shared/explicit-static-route-matcher.js +0 -101
  319. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +0 -62
  320. package/src/adapters/shared/file-route-middleware-pipeline.js +0 -90
  321. package/src/adapters/shared/fs-server-response-factory.d.ts +0 -23
  322. package/src/adapters/shared/fs-server-response-factory.js +0 -81
  323. package/src/adapters/shared/fs-server-response-matcher.d.ts +0 -75
  324. package/src/adapters/shared/fs-server-response-matcher.js +0 -186
  325. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +0 -55
  326. package/src/adapters/shared/hmr-entrypoint-registrar.js +0 -87
  327. package/src/adapters/shared/hmr-html-response.d.ts +0 -22
  328. package/src/adapters/shared/hmr-html-response.js +0 -33
  329. package/src/adapters/shared/render-context.d.ts +0 -16
  330. package/src/adapters/shared/render-context.js +0 -93
  331. package/src/adapters/shared/runtime-app-bootstrap.d.ts +0 -26
  332. package/src/adapters/shared/runtime-app-bootstrap.js +0 -46
  333. package/src/adapters/shared/runtime-host.d.ts +0 -12
  334. package/src/adapters/shared/runtime-host.js +0 -0
  335. package/src/adapters/shared/server-adapter.d.ts +0 -108
  336. package/src/adapters/shared/server-adapter.js +0 -436
  337. package/src/adapters/shared/server-route-handler.d.ts +0 -89
  338. package/src/adapters/shared/server-route-handler.js +0 -111
  339. package/src/adapters/shared/server-static-builder.d.ts +0 -71
  340. package/src/adapters/shared/server-static-builder.js +0 -100
  341. package/src/adapters/shared/shared-hmr-manager.d.ts +0 -59
  342. package/src/adapters/shared/shared-hmr-manager.js +0 -241
  343. package/src/adapters/shared/static-preview-host.d.ts +0 -10
  344. package/src/adapters/shared/static-preview-host.js +0 -0
  345. package/src/build/browser-runtime-import-rewrite-plugin.d.ts +0 -26
  346. package/src/build/browser-runtime-import-rewrite-plugin.js +0 -165
  347. package/src/build/browser-runtime-manifest.d.ts +0 -31
  348. package/src/build/browser-runtime-manifest.js +0 -61
  349. package/src/build/build-adapter.d.ts +0 -247
  350. package/src/build/build-adapter.js +0 -671
  351. package/src/build/build-manifest.d.ts +0 -33
  352. package/src/build/build-manifest.js +0 -52
  353. package/src/build/build-types.d.ts +0 -57
  354. package/src/build/build-types.js +0 -0
  355. package/src/build/dev-build-coordinator.d.ts +0 -72
  356. package/src/build/dev-build-coordinator.js +0 -154
  357. package/src/build/esbuild-build-adapter.d.ts +0 -79
  358. package/src/build/esbuild-build-adapter.js +0 -521
  359. package/src/build/runtime-build-executor.d.ts +0 -14
  360. package/src/build/runtime-build-executor.js +0 -22
  361. package/src/build/runtime-specifier-alias-plugin.d.ts +0 -15
  362. package/src/build/runtime-specifier-alias-plugin.js +0 -31
  363. package/src/config/config-builder.d.ts +0 -252
  364. package/src/config/config-builder.js +0 -598
  365. package/src/config/constants.js +0 -25
  366. package/src/dev/host-runtime.d.ts +0 -10
  367. package/src/dev/host-runtime.js +0 -24
  368. package/src/dev/sc-server.d.ts +0 -30
  369. package/src/dev/sc-server.js +0 -111
  370. package/src/eco/eco.browser.d.ts +0 -2
  371. package/src/eco/eco.browser.js +0 -88
  372. package/src/eco/eco.d.ts +0 -9
  373. package/src/eco/eco.js +0 -119
  374. package/src/eco/eco.types.d.ts +0 -233
  375. package/src/eco/eco.types.js +0 -0
  376. package/src/eco/eco.utils.d.ts +0 -1
  377. package/src/eco/eco.utils.js +0 -10
  378. package/src/eco/global-injector-map.d.ts +0 -16
  379. package/src/eco/global-injector-map.js +0 -80
  380. package/src/eco/lazy-injector-map.d.ts +0 -8
  381. package/src/eco/lazy-injector-map.js +0 -70
  382. package/src/eco/module-dependencies.d.ts +0 -18
  383. package/src/eco/module-dependencies.js +0 -49
  384. package/src/errors/http-error.d.ts +0 -31
  385. package/src/errors/http-error.js +0 -50
  386. package/src/errors/index.d.ts +0 -3
  387. package/src/errors/index.js +0 -6
  388. package/src/errors/locals-access-error.d.ts +0 -4
  389. package/src/errors/locals-access-error.js +0 -9
  390. package/src/global/app-logger.d.ts +0 -2
  391. package/src/global/app-logger.js +0 -6
  392. package/src/hmr/client/hmr-runtime.d.ts +0 -5
  393. package/src/hmr/client/hmr-runtime.js +0 -117
  394. package/src/hmr/hmr-strategy.d.ts +0 -162
  395. package/src/hmr/hmr-strategy.js +0 -44
  396. package/src/hmr/hmr.postcss.test.e2e.d.ts +0 -1
  397. package/src/hmr/hmr.postcss.test.e2e.js +0 -31
  398. package/src/hmr/hmr.test.e2e.d.ts +0 -1
  399. package/src/hmr/hmr.test.e2e.js +0 -43
  400. package/src/hmr/strategies/default-hmr-strategy.d.ts +0 -43
  401. package/src/hmr/strategies/default-hmr-strategy.js +0 -34
  402. package/src/hmr/strategies/js-hmr-strategy.d.ts +0 -134
  403. package/src/hmr/strategies/js-hmr-strategy.js +0 -173
  404. package/src/index.browser.d.ts +0 -3
  405. package/src/index.browser.js +0 -4
  406. package/src/index.d.ts +0 -6
  407. package/src/index.js +0 -21
  408. package/src/integrations/ghtml/ghtml-renderer.d.ts +0 -16
  409. package/src/integrations/ghtml/ghtml-renderer.js +0 -57
  410. package/src/integrations/ghtml/ghtml.constants.d.ts +0 -1
  411. package/src/integrations/ghtml/ghtml.constants.js +0 -4
  412. package/src/integrations/ghtml/ghtml.plugin.d.ts +0 -16
  413. package/src/integrations/ghtml/ghtml.plugin.js +0 -20
  414. package/src/plugins/alias-resolver-plugin.d.ts +0 -3
  415. package/src/plugins/alias-resolver-plugin.js +0 -61
  416. package/src/plugins/eco-component-meta-plugin.d.ts +0 -108
  417. package/src/plugins/eco-component-meta-plugin.js +0 -175
  418. package/src/plugins/foreign-jsx-override-plugin.d.ts +0 -33
  419. package/src/plugins/foreign-jsx-override-plugin.js +0 -41
  420. package/src/plugins/integration-plugin.d.ts +0 -230
  421. package/src/plugins/integration-plugin.js +0 -201
  422. package/src/plugins/processor.d.ts +0 -97
  423. package/src/plugins/processor.js +0 -141
  424. package/src/plugins/runtime-capability.js +0 -0
  425. package/src/plugins/source-transform.d.ts +0 -46
  426. package/src/plugins/source-transform.js +0 -71
  427. package/src/route-renderer/orchestration/component-render-context.d.ts +0 -97
  428. package/src/route-renderer/orchestration/component-render-context.js +0 -147
  429. package/src/route-renderer/orchestration/declared-ownership-graph.d.ts +0 -18
  430. package/src/route-renderer/orchestration/declared-ownership-graph.js +0 -34
  431. package/src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts +0 -110
  432. package/src/route-renderer/orchestration/foreign-subtree-execution.service.js +0 -233
  433. package/src/route-renderer/orchestration/integration-renderer.d.ts +0 -534
  434. package/src/route-renderer/orchestration/integration-renderer.js +0 -991
  435. package/src/route-renderer/orchestration/ownership-planning.service.d.ts +0 -24
  436. package/src/route-renderer/orchestration/ownership-planning.service.js +0 -63
  437. package/src/route-renderer/orchestration/ownership-validation.service.d.ts +0 -29
  438. package/src/route-renderer/orchestration/ownership-validation.service.js +0 -53
  439. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +0 -3
  440. package/src/route-renderer/orchestration/processed-asset-dedupe.js +0 -27
  441. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.d.ts +0 -91
  442. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.js +0 -170
  443. package/src/route-renderer/orchestration/render-output.utils.d.ts +0 -66
  444. package/src/route-renderer/orchestration/render-output.utils.js +0 -171
  445. package/src/route-renderer/orchestration/route-render-orchestrator.d.ts +0 -156
  446. package/src/route-renderer/orchestration/route-render-orchestrator.js +0 -577
  447. package/src/route-renderer/orchestration/template-serialization.d.ts +0 -38
  448. package/src/route-renderer/orchestration/template-serialization.js +0 -45
  449. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +0 -37
  450. package/src/route-renderer/page-loading/component-dependency-collection.js +0 -132
  451. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +0 -24
  452. package/src/route-renderer/page-loading/declared-asset-collection.js +0 -106
  453. package/src/route-renderer/page-loading/dependency-resolver.d.ts +0 -35
  454. package/src/route-renderer/page-loading/dependency-resolver.js +0 -115
  455. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +0 -11
  456. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +0 -57
  457. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +0 -45
  458. package/src/route-renderer/page-loading/lazy-entry-collection.js +0 -105
  459. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +0 -19
  460. package/src/route-renderer/page-loading/lazy-trigger-planning.js +0 -40
  461. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +0 -5
  462. package/src/route-renderer/page-loading/module-declaration-aggregation.js +0 -33
  463. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +0 -3
  464. package/src/route-renderer/page-loading/module-declaration-scripts.js +0 -18
  465. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +0 -13
  466. package/src/route-renderer/page-loading/page-dependency-bundling.js +0 -137
  467. package/src/route-renderer/page-loading/page-module-loader.d.ts +0 -90
  468. package/src/route-renderer/page-loading/page-module-loader.js +0 -127
  469. package/src/route-renderer/route-renderer.d.ts +0 -69
  470. package/src/route-renderer/route-renderer.js +0 -80
  471. package/src/router/client/link-intent.js +0 -34
  472. package/src/router/client/link-intent.test.browser.d.ts +0 -1
  473. package/src/router/client/link-intent.test.browser.js +0 -43
  474. package/src/router/client/navigation-coordinator.d.ts +0 -169
  475. package/src/router/client/navigation-coordinator.js +0 -215
  476. package/src/router/server/route-registry.d.ts +0 -78
  477. package/src/router/server/route-registry.js +0 -262
  478. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +0 -3
  479. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +0 -56
  480. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +0 -103
  481. package/src/services/assets/asset-processing-service/asset-processing.service.js +0 -285
  482. package/src/services/assets/asset-processing-service/asset.factory.d.ts +0 -17
  483. package/src/services/assets/asset-processing-service/asset.factory.js +0 -82
  484. package/src/services/assets/asset-processing-service/assets.types.d.ts +0 -103
  485. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  486. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +0 -57
  487. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +0 -49
  488. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +0 -20
  489. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +0 -41
  490. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +0 -30
  491. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +0 -65
  492. package/src/services/assets/asset-processing-service/index.d.ts +0 -6
  493. package/src/services/assets/asset-processing-service/index.js +0 -6
  494. package/src/services/assets/asset-processing-service/page-package.d.ts +0 -6
  495. package/src/services/assets/asset-processing-service/page-package.js +0 -80
  496. package/src/services/assets/asset-processing-service/processor.interface.js +0 -6
  497. package/src/services/assets/asset-processing-service/processor.registry.d.ts +0 -8
  498. package/src/services/assets/asset-processing-service/processor.registry.js +0 -15
  499. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +0 -24
  500. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +0 -65
  501. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +0 -22
  502. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +0 -136
  503. package/src/services/assets/asset-processing-service/processors/index.d.ts +0 -5
  504. package/src/services/assets/asset-processing-service/processors/index.js +0 -5
  505. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +0 -6
  506. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +0 -120
  507. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +0 -9
  508. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +0 -97
  509. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +0 -42
  510. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +0 -126
  511. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +0 -8
  512. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -59
  513. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +0 -9
  514. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +0 -69
  515. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +0 -18
  516. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +0 -45
  517. package/src/services/assets/browser-bundle.service.d.ts +0 -73
  518. package/src/services/assets/browser-bundle.service.js +0 -41
  519. package/src/services/cache/cache.types.d.ts +0 -107
  520. package/src/services/cache/cache.types.js +0 -0
  521. package/src/services/cache/index.d.ts +0 -7
  522. package/src/services/cache/index.js +0 -7
  523. package/src/services/cache/memory-cache-store.d.ts +0 -42
  524. package/src/services/cache/memory-cache-store.js +0 -98
  525. package/src/services/cache/page-cache-service.d.ts +0 -70
  526. package/src/services/cache/page-cache-service.js +0 -152
  527. package/src/services/cache/page-request-cache-coordinator.service.d.ts +0 -75
  528. package/src/services/cache/page-request-cache-coordinator.service.js +0 -109
  529. package/src/services/html/html-rewriter-provider.service.d.ts +0 -40
  530. package/src/services/html/html-rewriter-provider.service.js +0 -68
  531. package/src/services/html/html-transformer.service.d.ts +0 -96
  532. package/src/services/html/html-transformer.service.js +0 -287
  533. package/src/services/invalidation/development-invalidation.service.d.ts +0 -74
  534. package/src/services/invalidation/development-invalidation.service.js +0 -190
  535. package/src/services/module-loading/app-module-loader.service.d.ts +0 -7
  536. package/src/services/module-loading/app-module-loader.service.js +0 -0
  537. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +0 -24
  538. package/src/services/module-loading/app-server-module-transpiler.service.js +0 -151
  539. package/src/services/module-loading/host-module-loader-registry.d.ts +0 -4
  540. package/src/services/module-loading/host-module-loader-registry.js +0 -15
  541. package/src/services/module-loading/module-loading-types.js +0 -0
  542. package/src/services/module-loading/node-bootstrap-plugin.d.ts +0 -38
  543. package/src/services/module-loading/node-bootstrap-plugin.js +0 -215
  544. package/src/services/module-loading/page-module-import.service.d.ts +0 -95
  545. package/src/services/module-loading/page-module-import.service.js +0 -191
  546. package/src/services/module-loading/server-module-transpiler.service.d.ts +0 -63
  547. package/src/services/module-loading/server-module-transpiler.service.js +0 -64
  548. package/src/services/module-loading/source-module-support.d.ts +0 -5
  549. package/src/services/module-loading/source-module-support.js +0 -8
  550. package/src/services/runtime-state/dev-graph.service.d.ts +0 -118
  551. package/src/services/runtime-state/dev-graph.service.js +0 -162
  552. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +0 -41
  553. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +0 -85
  554. package/src/services/runtime-state/server-invalidation-state.service.d.ts +0 -26
  555. package/src/services/runtime-state/server-invalidation-state.service.js +0 -35
  556. package/src/services/validation/schema-validation-service.d.ts +0 -122
  557. package/src/services/validation/schema-validation-service.js +0 -101
  558. package/src/services/validation/standard-schema.types.js +0 -0
  559. package/src/static-site-generator/static-site-generator.d.ts +0 -104
  560. package/src/static-site-generator/static-site-generator.js +0 -316
  561. package/src/types/internal-types.d.ts +0 -232
  562. package/src/types/internal-types.js +0 -0
  563. package/src/types/public-types.d.ts +0 -1307
  564. package/src/types/public-types.js +0 -0
  565. package/src/utils/deep-merge.d.ts +0 -14
  566. package/src/utils/deep-merge.js +0 -32
  567. package/src/utils/hash.d.ts +0 -1
  568. package/src/utils/hash.js +0 -7
  569. package/src/utils/html-escaping.d.ts +0 -7
  570. package/src/utils/html-escaping.js +0 -6
  571. package/src/utils/html.js +0 -4
  572. package/src/utils/invariant.d.ts +0 -5
  573. package/src/utils/invariant.js +0 -11
  574. package/src/utils/locals-utils.d.ts +0 -15
  575. package/src/utils/locals-utils.js +0 -24
  576. package/src/utils/parse-cli-args.d.ts +0 -27
  577. package/src/utils/parse-cli-args.js +0 -62
  578. package/src/utils/path-utils.module.d.ts +0 -5
  579. package/src/utils/path-utils.module.js +0 -14
  580. package/src/utils/resolve-work-dir.d.ts +0 -11
  581. package/src/utils/resolve-work-dir.js +0 -31
  582. package/src/utils/runtime.d.ts +0 -11
  583. package/src/utils/runtime.js +0 -40
  584. package/src/utils/server-utils.module.d.ts +0 -19
  585. package/src/utils/server-utils.module.js +0 -56
  586. package/src/watchers/project-watcher.d.ts +0 -136
  587. package/src/watchers/project-watcher.js +0 -275
  588. package/src/watchers/project-watcher.test-helpers.d.ts +0 -4
  589. package/src/watchers/project-watcher.test-helpers.js +0 -52
  590. /package/src/utils/{html.d.ts → html.ts} +0 -0
@@ -0,0 +1,151 @@
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
2
+ import { IntegrationPlugin, type IntegrationPluginConfig } from './integration-plugin.ts';
3
+ import type { IHmrManager } from '../types/public-types.ts';
4
+ import type { AssetDefinition } from '../services/assets/asset-processing-service';
5
+ import type { IntegrationRendererRenderOptions, RouteRendererBody } from '../types/public-types.ts';
6
+ import {
7
+ IntegrationRenderer,
8
+ type RenderToResponseContext,
9
+ } from '../route-renderer/orchestration/integration-renderer.ts';
10
+ import type { EcoPagesAppConfig } from '../types/internal-types.ts';
11
+
12
+ class NamelessRenderer extends IntegrationRenderer {
13
+ declare name: string;
14
+
15
+ async render(_options: IntegrationRendererRenderOptions): Promise<RouteRendererBody> {
16
+ return '<div>ok</div>';
17
+ }
18
+
19
+ async renderToResponse(_view: never, _props: never, _ctx: RenderToResponseContext): Promise<Response> {
20
+ return new Response('<div>ok</div>');
21
+ }
22
+ }
23
+
24
+ class TestIntegrationPlugin extends IntegrationPlugin {
25
+ renderer = vi.fn() as any;
26
+ override setup(): Promise<void> {
27
+ return Promise.resolve();
28
+ }
29
+
30
+ override teardown(): Promise<void> {
31
+ return Promise.resolve();
32
+ }
33
+ }
34
+
35
+ class OverrideInitializeRendererPlugin extends TestIntegrationPlugin {
36
+ override initializeRenderer() {
37
+ const renderer = new NamelessRenderer({
38
+ appConfig: this.appConfig as EcoPagesAppConfig,
39
+ assetProcessingService: {} as never,
40
+ resolvedIntegrationDependencies: [],
41
+ runtimeOrigin: this.runtimeOrigin,
42
+ });
43
+
44
+ return this.attachRendererRuntimeServices(renderer);
45
+ }
46
+ }
47
+
48
+ describe('IntegrationPlugin', () => {
49
+ let plugin: TestIntegrationPlugin;
50
+ const config: IntegrationPluginConfig = {
51
+ name: 'test-plugin',
52
+ extensions: ['.test'],
53
+ integrationDependencies: [],
54
+ };
55
+
56
+ beforeEach(() => {
57
+ plugin = new TestIntegrationPlugin(config);
58
+ });
59
+
60
+ it('should initialize with correct config values', () => {
61
+ expect(plugin.name).toBe(config.name);
62
+ expect(plugin.extensions).toEqual(config.extensions);
63
+ expect(plugin.runtimeCapability).toBeUndefined();
64
+ expect(plugin.getResolvedIntegrationDependencies()).toEqual(
65
+ config.integrationDependencies as AssetDefinition[],
66
+ );
67
+ });
68
+
69
+ it('should retain runtime capability declarations', () => {
70
+ const pluginWithRuntimeCapability = new TestIntegrationPlugin({
71
+ name: 'runtime-capable',
72
+ extensions: ['.test'],
73
+ runtimeCapability: {
74
+ tags: ['bun-only'],
75
+ minRuntimeVersion: '1.0.0',
76
+ },
77
+ });
78
+
79
+ expect(pluginWithRuntimeCapability.runtimeCapability).toEqual({
80
+ tags: ['bun-only'],
81
+ minRuntimeVersion: '1.0.0',
82
+ });
83
+ });
84
+
85
+ it('should initialize with empty dependencies if not provided', () => {
86
+ const pluginWithoutDeps = new TestIntegrationPlugin({
87
+ name: 'test',
88
+ extensions: [],
89
+ });
90
+ expect(pluginWithoutDeps.getResolvedIntegrationDependencies()).toEqual([]);
91
+ });
92
+
93
+ it('should implement setup and teardown methods', async () => {
94
+ await expect(plugin.setup()).resolves.toBeUndefined();
95
+ await expect(plugin.teardown()).resolves.toBeUndefined();
96
+ });
97
+
98
+ it('should register HMR strategies through the base HMR setup', () => {
99
+ const registerStrategy = vi.fn();
100
+ const hmrManager = {
101
+ registerStrategy,
102
+ registerEntrypoint: vi.fn(),
103
+ registerScriptEntrypoint: vi.fn(),
104
+ setPlugins: vi.fn(),
105
+ setEnabled: vi.fn(),
106
+ isEnabled: vi.fn(() => true),
107
+ broadcast: vi.fn(),
108
+ getOutputUrl: vi.fn(),
109
+ getWatchedFiles: vi.fn(() => new Map()),
110
+ getDistDir: vi.fn(() => ''),
111
+ getPlugins: vi.fn(() => []),
112
+ getDefaultContext: vi.fn(),
113
+ handleFileChange: vi.fn(),
114
+ } satisfies IHmrManager;
115
+
116
+ const strategy = { matches: vi.fn(() => false), process: vi.fn(), priority: 10, type: 'integration' } as any;
117
+ const pluginWithStrategy = new (class extends TestIntegrationPlugin {
118
+ override getHmrStrategy() {
119
+ return strategy;
120
+ }
121
+ })(config);
122
+
123
+ pluginWithStrategy.setHmrManager(hmrManager);
124
+
125
+ expect(registerStrategy).toHaveBeenCalledWith(strategy);
126
+ });
127
+
128
+ it('should stamp the plugin integration name onto initialized renderers', () => {
129
+ const pluginWithRenderer = new (class extends TestIntegrationPlugin {
130
+ override renderer = NamelessRenderer as TestIntegrationPlugin['renderer'];
131
+ })(config);
132
+
133
+ (pluginWithRenderer as TestIntegrationPlugin & { appConfig?: object; runtimeOrigin: string }).appConfig =
134
+ {} as EcoPagesAppConfig;
135
+ pluginWithRenderer.runtimeOrigin = 'http://localhost:3000';
136
+
137
+ const renderer = pluginWithRenderer.initializeRenderer();
138
+ expect(renderer.name).toBe('test-plugin');
139
+ });
140
+
141
+ it('should stamp the plugin integration name when overrides use shared renderer runtime services', () => {
142
+ const pluginWithOverride = new OverrideInitializeRendererPlugin(config);
143
+
144
+ (pluginWithOverride as TestIntegrationPlugin & { appConfig?: object; runtimeOrigin: string }).appConfig =
145
+ {} as EcoPagesAppConfig;
146
+ pluginWithOverride.runtimeOrigin = 'http://localhost:3000';
147
+
148
+ const renderer = pluginWithOverride.initializeRenderer();
149
+ expect(renderer.name).toBe('test-plugin');
150
+ });
151
+ });
@@ -0,0 +1,344 @@
1
+ import type { EcoBuildPlugin } from '../build/build-types.ts';
2
+ import { createBrowserRuntimeManifest, type BrowserRuntimeManifest } from '../build/browser-runtime-manifest.ts';
3
+ import type { EcoPagesAppConfig, IHmrManager } from '../types/internal-types.ts';
4
+ import type { HmrStrategy } from '../hmr/hmr-strategy.ts';
5
+ import type { EcoPagesElement } from '../types/public-types.ts';
6
+ import type { IntegrationRenderer } from '../route-renderer/orchestration/integration-renderer.ts';
7
+ import { AssetProcessingService } from '../services/assets/asset-processing-service/asset-processing.service.ts';
8
+ import type { AssetDefinition, ProcessedAsset } from '../services/assets/asset-processing-service/assets.types.ts';
9
+ import { deepMerge } from '../utils/deep-merge.ts';
10
+ import { invariant } from '../utils/invariant.ts';
11
+ import type { RuntimeCapabilityDeclaration } from './runtime-capability.ts';
12
+
13
+ export type { RuntimeCapabilityDeclaration, RuntimeCapabilityTag } from './runtime-capability.ts';
14
+ export type {
15
+ EcoBuildLoader,
16
+ EcoBuildOnLoadArgs,
17
+ EcoBuildOnLoadResult,
18
+ EcoBuildOnResolveArgs,
19
+ EcoBuildOnResolveResult,
20
+ EcoBuildPlugin,
21
+ EcoBuildPluginBuilder,
22
+ } from '../build/build-types.ts';
23
+ export type { PageBrowserGraphContribution, PageBrowserGraphContributionContext } from '../types/public-types.ts';
24
+ export type {
25
+ HtmlDocumentContribution,
26
+ HtmlDocumentContributionContext,
27
+ } from '../route-renderer/orchestration/integration-renderer.ts';
28
+
29
+ /**
30
+ * Type-erased integration plugin stored in app-level registries.
31
+ *
32
+ * Ecopages keeps one heterogeneous integration list, while each plugin and
33
+ * renderer still owns its framework-specific render payload type internally.
34
+ */
35
+ export type AnyIntegrationPlugin = IntegrationPlugin<unknown>;
36
+
37
+ export const INTEGRATION_PLUGIN_ERRORS = {
38
+ NOT_INITIALIZED_WITH_APP_CONFIG: 'Plugin not initialized with app config',
39
+ NOT_INITIALIZED_WITH_ASSET_SERVICE: 'Plugin not initialized with asset dependency service',
40
+ } as const;
41
+
42
+ export function mergeIntegrationOptions<TDefaults, TOverrides>(
43
+ defaults: TDefaults,
44
+ overrides: TOverrides,
45
+ ): TDefaults & TOverrides {
46
+ return deepMerge(defaults, overrides);
47
+ }
48
+
49
+ export function assertIntegrationInvariant(condition: boolean, message?: string): asserts condition {
50
+ invariant(condition, message);
51
+ }
52
+
53
+ /**
54
+ * Base configuration shared by all integration plugins.
55
+ *
56
+ * @remarks
57
+ * Integrations declare their file ownership, optional runtime requirements, and
58
+ * any global assets or build-time contributions here. Runtime-only side effects
59
+ * belong in `setup()` rather than the constructor.
60
+ */
61
+ export interface IntegrationPluginConfig {
62
+ /**
63
+ * The name of the integration plugin.
64
+ */
65
+ name: string;
66
+ /**
67
+ * The extensions that this plugin supports (e.g., ['.kita.js', '.kita.tsx']).
68
+ */
69
+ extensions: string[];
70
+ /**
71
+ * The dependencies that this plugin requires on a global level.
72
+ * These dependencies will be resolved during the setup process and injected into the global scope of the application.
73
+ * They are not specific to any particular page or component.
74
+ */
75
+ integrationDependencies?: AssetDefinition[];
76
+ /**
77
+ * The strategy to use for static building.
78
+ * - 'render': Execute component function directly (faster, efficient).
79
+ * - 'fetch': Start server and fetch URL (slower, needed for some SSR like Lit).
80
+ * @default 'render'
81
+ */
82
+ staticBuildStep?: 'render' | 'fetch';
83
+ /**
84
+ * Declares runtime-specific requirements that must be satisfied before the
85
+ * app can start with this integration enabled.
86
+ */
87
+ runtimeCapability?: RuntimeCapabilityDeclaration;
88
+ /**
89
+ * JSX import source owned by this integration.
90
+ *
91
+ * @remarks
92
+ * This is primarily used by mixed-JSX flows where host-owned browser bundles
93
+ * need to preserve the correct JSX runtime for files claimed by the
94
+ * integration.
95
+ */
96
+ jsxImportSource?: string;
97
+ }
98
+
99
+ type RendererClass<C> = new (options: {
100
+ appConfig: EcoPagesAppConfig;
101
+ assetProcessingService: AssetProcessingService;
102
+ resolvedIntegrationDependencies: ProcessedAsset[];
103
+ rendererModules?: unknown;
104
+ runtimeOrigin: string;
105
+ }) => IntegrationRenderer<C>;
106
+
107
+ /**
108
+ * Base class for framework integrations.
109
+ *
110
+ * @remarks
111
+ * An integration owns three main concerns:
112
+ * - which file extensions it claims
113
+ * - which renderer class turns those files into HTML
114
+ * - which build-time or runtime contributions must be registered for that framework
115
+ *
116
+ * Core owns lifecycle ordering. Integrations declare contributions through the
117
+ * hooks on this class, while `ConfigBuilder.build()` and app startup decide when
118
+ * those hooks run. For page-browser and document shaping, integrations should
119
+ * prefer the contribution contracts re-exported from this module:
120
+ * `PageBrowserGraphContribution` / `PageBrowserGraphContributionContext` and
121
+ * `HtmlDocumentContribution` / `HtmlDocumentContributionContext`.
122
+ */
123
+ export abstract class IntegrationPlugin<C = EcoPagesElement> {
124
+ readonly name: string;
125
+ readonly extensions: string[];
126
+ abstract renderer: RendererClass<C>;
127
+ readonly staticBuildStep: 'render' | 'fetch';
128
+ readonly runtimeCapability?: RuntimeCapabilityDeclaration;
129
+ readonly jsxImportSource?: string;
130
+
131
+ protected integrationDependencies: AssetDefinition[];
132
+ protected resolvedIntegrationDependencies: ProcessedAsset[] = [];
133
+ protected options?: Record<string, unknown>;
134
+ protected appConfig?: EcoPagesAppConfig;
135
+ protected assetProcessingService?: AssetProcessingService;
136
+ protected hmrManager?: IHmrManager;
137
+ declare runtimeOrigin: string;
138
+
139
+ get plugins(): EcoBuildPlugin[] {
140
+ return [];
141
+ }
142
+
143
+ /**
144
+ * Returns build plugins that should only apply to browser-oriented bundles.
145
+ *
146
+ * @remarks
147
+ * Browser-only transforms such as runtime import aliasing belong here so they
148
+ * do not affect server bundles or static-page module generation.
149
+ */
150
+ get browserBuildPlugins(): EcoBuildPlugin[] {
151
+ return [];
152
+ }
153
+
154
+ /**
155
+ * Returns shared browser runtime asset declarations owned by this integration.
156
+ *
157
+ * @remarks
158
+ * Core seals these declarations into the app build manifest so app-owned browser
159
+ * bundle paths can rewrite manifest-owned imports even when a specific build
160
+ * request does not install an integration-local runtime rewrite plugin.
161
+ */
162
+ get browserRuntimeManifest(): BrowserRuntimeManifest {
163
+ return createBrowserRuntimeManifest();
164
+ }
165
+
166
+ /**
167
+ * Creates the integration with static declaration-only configuration.
168
+ *
169
+ * @remarks
170
+ * Constructors are expected to stay side-effect free. Build-manifest
171
+ * contributions belong in `prepareBuildContributions()` and runtime-only setup
172
+ * belongs in `setup()`.
173
+ */
174
+ constructor(config: IntegrationPluginConfig) {
175
+ this.name = config.name;
176
+ this.extensions = config.extensions;
177
+ this.integrationDependencies = config.integrationDependencies || [];
178
+ this.staticBuildStep = config.staticBuildStep || 'render';
179
+ this.runtimeCapability = config.runtimeCapability;
180
+ this.jsxImportSource = config.jsxImportSource;
181
+ }
182
+
183
+ /**
184
+ * Attaches the finalized app config to the integration.
185
+ *
186
+ * Core calls this during config finalization before runtime setup so the
187
+ * integration can resolve asset paths and other app-owned services later.
188
+ */
189
+ setConfig(appConfig: EcoPagesAppConfig): void {
190
+ this.appConfig = appConfig;
191
+ this.initializeAssetDefinitionService();
192
+ }
193
+
194
+ /**
195
+ * Records the runtime origin used for page-module loading and renderer setup.
196
+ */
197
+ setRuntimeOrigin(runtimeOrigin: string) {
198
+ this.runtimeOrigin = runtimeOrigin;
199
+ }
200
+
201
+ /**
202
+ * Returns an HMR strategy for this integration, if applicable.
203
+ * The strategy will be registered with the HmrManager during initialization.
204
+ *
205
+ * @returns HmrStrategy instance or undefined if no custom HMR handling needed
206
+ *
207
+ * @example
208
+ * ```typescript
209
+ * getHmrStrategy(): HmrStrategy {
210
+ * const context = this.hmrManager!.getDefaultContext();
211
+ * return new ReactHmrStrategy({ context, pageMetadataCache, runtimeManifest });
212
+ * }
213
+ * ```
214
+ */
215
+ getHmrStrategy?(): HmrStrategy | undefined;
216
+
217
+ /**
218
+ * Attaches the shared HMR manager and registers integration-owned development hooks.
219
+ *
220
+ * @remarks
221
+ * The default implementation registers the optional integration HMR strategy.
222
+ * Integrations should override this only when they need to extend that shared
223
+ * behavior rather than replace it.
224
+ */
225
+ setHmrManager(hmrManager: IHmrManager) {
226
+ this.hmrManager = hmrManager;
227
+
228
+ const strategy = this.getHmrStrategy?.();
229
+ if (strategy) {
230
+ hmrManager.registerStrategy(strategy);
231
+ }
232
+
233
+ if (this.assetProcessingService) {
234
+ this.assetProcessingService.setHmrManager(hmrManager);
235
+ }
236
+ }
237
+
238
+ /**
239
+ * Creates the asset-processing service used for global integration dependencies.
240
+ */
241
+ initializeAssetDefinitionService(): void {
242
+ if (!this.appConfig) throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_APP_CONFIG);
243
+
244
+ this.assetProcessingService = AssetProcessingService.createWithDefaultProcessors(this.appConfig);
245
+ if (this.hmrManager) {
246
+ this.assetProcessingService.setHmrManager(this.hmrManager);
247
+ }
248
+ }
249
+
250
+ /**
251
+ * Returns processed global assets resolved during `setup()`.
252
+ */
253
+ getResolvedIntegrationDependencies(): ProcessedAsset[] {
254
+ return this.resolvedIntegrationDependencies;
255
+ }
256
+
257
+ /**
258
+ * Creates the shared renderer options owned by core lifecycle setup.
259
+ */
260
+ protected createRendererOptions(options?: { rendererModules?: unknown }) {
261
+ if (!this.appConfig) {
262
+ throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_APP_CONFIG);
263
+ }
264
+
265
+ const assetProcessingService = AssetProcessingService.createWithDefaultProcessors(this.appConfig);
266
+ if (this.hmrManager) {
267
+ assetProcessingService.setHmrManager(this.hmrManager);
268
+ }
269
+
270
+ return {
271
+ appConfig: this.appConfig,
272
+ assetProcessingService,
273
+ resolvedIntegrationDependencies: this.resolvedIntegrationDependencies,
274
+ rendererModules: options?.rendererModules,
275
+ runtimeOrigin: this.runtimeOrigin,
276
+ };
277
+ }
278
+
279
+ /**
280
+ * Attaches runtime-only services after a renderer instance has been created.
281
+ */
282
+ protected attachRendererRuntimeServices<T extends IntegrationRenderer<C>>(renderer: T): T {
283
+ if (typeof renderer.name !== 'string' || renderer.name.length === 0) {
284
+ renderer.name = this.name;
285
+ }
286
+
287
+ if (this.hmrManager) {
288
+ renderer.setHmrManager(this.hmrManager);
289
+ }
290
+
291
+ return renderer;
292
+ }
293
+
294
+ /**
295
+ * Instantiates the integration renderer with app-owned services.
296
+ *
297
+ * @remarks
298
+ * Renderers are cheap runtime objects. They receive the finalized app config,
299
+ * a fresh asset-processing service, integration-global processed assets, and
300
+ * any renderer module context supplied by the active runtime.
301
+ renderer.name ||= this.name;
302
+ */
303
+ initializeRenderer(options?: { rendererModules?: unknown }): IntegrationRenderer<C> {
304
+ const renderer = new this.renderer(this.createRendererOptions(options));
305
+ renderer.name ||= this.name;
306
+ return this.attachRendererRuntimeServices(renderer);
307
+ }
308
+
309
+ /**
310
+ * Prepares build-facing contributions before the app build manifest is sealed.
311
+ *
312
+ * @remarks
313
+ * Integrations can override this when runtime or build plugin declarations must
314
+ * be materialized ahead of runtime startup. Runtime-only side effects stay in
315
+ * `setup()`.
316
+ */
317
+ async prepareBuildContributions(): Promise<void> {}
318
+
319
+ /**
320
+ * Performs runtime-only integration setup after config build has already
321
+ * sealed manifest contributions.
322
+ */
323
+ async setup(): Promise<void> {
324
+ if (this.integrationDependencies.length === 0) return;
325
+ if (!this.assetProcessingService) throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_ASSET_SERVICE);
326
+
327
+ this.resolvedIntegrationDependencies = await this.assetProcessingService.processDependencies(
328
+ this.integrationDependencies,
329
+ this.name,
330
+ );
331
+
332
+ this.initializeRenderer();
333
+ }
334
+
335
+ /**
336
+ * Releases runtime resources owned by the integration.
337
+ *
338
+ * @remarks
339
+ * Most integrations do not need custom teardown. Override this only for
340
+ * explicit cleanup such as watchers, compiler handles, or runtime registries
341
+ * that outlive individual requests.
342
+ */
343
+ async teardown(): Promise<void> {}
344
+ }
@@ -0,0 +1,148 @@
1
+ import { afterAll, beforeEach, describe, expect, test } from 'vitest';
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import type { EcoBuildPlugin } from '../build/build-types.ts';
5
+ import type { EcoPagesAppConfig } from '../types/internal-types';
6
+ import { Processor, type ProcessorConfig } from './processor.ts';
7
+
8
+ class TestProcessor extends Processor {
9
+ override buildPlugins?: EcoBuildPlugin[] = [];
10
+ override plugins?: EcoBuildPlugin[] = [];
11
+
12
+ override async setup(): Promise<void> {}
13
+
14
+ override async process(input: unknown, _filePath?: string): Promise<unknown> {
15
+ return input;
16
+ }
17
+
18
+ override async teardown(): Promise<void> {}
19
+ }
20
+
21
+ describe('Processor', () => {
22
+ let processor: TestProcessor;
23
+ let config: ProcessorConfig;
24
+ let appConfig: EcoPagesAppConfig;
25
+
26
+ beforeEach(() => {
27
+ config = {
28
+ name: 'test-processor',
29
+ options: { test: true },
30
+ watch: {
31
+ paths: ['/test'],
32
+ },
33
+ };
34
+
35
+ const testRoot = path.join(process.cwd(), '.test-tmp', 'processor-test');
36
+
37
+ if (fs.existsSync(testRoot)) {
38
+ fs.rmSync(testRoot, { recursive: true, force: true });
39
+ }
40
+
41
+ appConfig = {
42
+ rootDir: testRoot,
43
+ absolutePaths: {
44
+ srcDir: path.join(testRoot, 'src'),
45
+ distDir: path.join(testRoot, 'dist'),
46
+ },
47
+ } as EcoPagesAppConfig;
48
+
49
+ processor = new TestProcessor(config);
50
+ processor.setContext(appConfig);
51
+ });
52
+
53
+ afterAll(() => {
54
+ fs.rmSync(path.join(process.cwd(), '.test-tmp'), { recursive: true, force: true });
55
+ });
56
+
57
+ test('should initialize with correct name', () => {
58
+ expect(processor.getName()).toBe('test-processor');
59
+ });
60
+
61
+ test('should retain runtime capability declarations', () => {
62
+ const runtimeProcessor = new TestProcessor({
63
+ name: 'runtime-processor',
64
+ runtimeCapability: {
65
+ tags: ['requires-node-builtins'],
66
+ minRuntimeVersion: '18.0.0',
67
+ },
68
+ });
69
+
70
+ expect(runtimeProcessor.runtimeCapability).toEqual({
71
+ tags: ['requires-node-builtins'],
72
+ minRuntimeVersion: '18.0.0',
73
+ });
74
+ });
75
+
76
+ test('should return watch config', () => {
77
+ expect(processor.getWatchConfig()).toEqual({
78
+ paths: ['/test'],
79
+ });
80
+ });
81
+ });
82
+
83
+ describe('Processor capability matching', () => {
84
+ test('matches all extensions with * pattern', () => {
85
+ const processor = new TestProcessor({
86
+ name: 'wildcard-all',
87
+ capabilities: [{ kind: 'stylesheet', extensions: ['*'] }],
88
+ });
89
+
90
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.css')).toBe(true);
91
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.scss')).toBe(true);
92
+ });
93
+
94
+ test('matches explicit *.ext patterns', () => {
95
+ const processor = new TestProcessor({
96
+ name: 'wildcard-explicit',
97
+ capabilities: [{ kind: 'stylesheet', extensions: ['*.css'] }],
98
+ });
99
+
100
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.css')).toBe(true);
101
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.scss')).toBe(false);
102
+ });
103
+
104
+ test('matches grouped extension patterns', () => {
105
+ const processor = new TestProcessor({
106
+ name: 'wildcard-group',
107
+ capabilities: [{ kind: 'stylesheet', extensions: ['*.{css,scss,sass}'] }],
108
+ });
109
+
110
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.css')).toBe(true);
111
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.scss')).toBe(true);
112
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.sass')).toBe(true);
113
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.less')).toBe(false);
114
+ });
115
+
116
+ test('matches grouped patterns with mixed case and spacing', () => {
117
+ const processor = new TestProcessor({
118
+ name: 'wildcard-group-normalized',
119
+ capabilities: [{ kind: 'stylesheet', extensions: ['*.{ CSS, ScSs , .SASS }'] }],
120
+ });
121
+
122
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.css')).toBe(true);
123
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.scss')).toBe(true);
124
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.sass')).toBe(true);
125
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.less')).toBe(false);
126
+ });
127
+
128
+ test('matches plain extension and dotted extension forms', () => {
129
+ const processor = new TestProcessor({
130
+ name: 'plain-ext',
131
+ capabilities: [{ kind: 'stylesheet', extensions: ['css', '.scss'] }],
132
+ });
133
+
134
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.css')).toBe(true);
135
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.scss')).toBe(true);
136
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.sass')).toBe(false);
137
+ });
138
+
139
+ test('respects capability kind filtering', () => {
140
+ const processor = new TestProcessor({
141
+ name: 'kind-filter',
142
+ capabilities: [{ kind: 'image', extensions: ['*.png'] }],
143
+ });
144
+
145
+ expect(processor.canProcessAsset('stylesheet', '/src/styles/app.css')).toBe(false);
146
+ expect(processor.canProcessAsset('image', '/src/assets/logo.png')).toBe(true);
147
+ });
148
+ });