@ecopages/core 0.2.0-alpha.27 → 0.2.0-alpha.28

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 (546) hide show
  1. package/CHANGELOG.md +91 -0
  2. package/package.json +162 -72
  3. package/src/adapters/abstract/application-adapter.d.ts +194 -0
  4. package/src/adapters/abstract/application-adapter.js +121 -0
  5. package/src/adapters/abstract/router-adapter.d.ts +26 -0
  6. package/src/adapters/abstract/router-adapter.js +5 -0
  7. package/src/adapters/abstract/server-adapter.d.ts +69 -0
  8. package/src/adapters/abstract/server-adapter.js +15 -0
  9. package/src/adapters/bun/client-bridge.d.ts +34 -0
  10. package/src/adapters/bun/client-bridge.js +48 -0
  11. package/src/adapters/bun/create-app.d.ts +53 -0
  12. package/src/adapters/bun/create-app.js +153 -0
  13. package/src/adapters/bun/hmr-manager.d.ts +131 -0
  14. package/src/adapters/bun/hmr-manager.js +312 -0
  15. package/src/adapters/bun/index.d.ts +2 -0
  16. package/src/adapters/bun/index.js +8 -0
  17. package/src/adapters/bun/server-adapter.d.ts +155 -0
  18. package/src/adapters/bun/server-adapter.js +393 -0
  19. package/src/adapters/bun/server-lifecycle.d.ts +63 -0
  20. package/src/adapters/bun/server-lifecycle.js +92 -0
  21. package/src/adapters/create-app.d.ts +20 -0
  22. package/src/adapters/create-app.js +66 -0
  23. package/src/adapters/index.d.ts +2 -0
  24. package/src/adapters/index.js +8 -0
  25. package/src/adapters/node/create-app.d.ts +18 -0
  26. package/src/adapters/node/create-app.js +149 -0
  27. package/src/adapters/node/node-client-bridge.d.ts +26 -0
  28. package/src/adapters/node/node-client-bridge.js +66 -0
  29. package/src/adapters/node/node-hmr-manager.d.ts +121 -0
  30. package/src/adapters/node/node-hmr-manager.js +290 -0
  31. package/src/adapters/node/server-adapter.d.ts +162 -0
  32. package/src/adapters/node/server-adapter.js +368 -0
  33. package/src/adapters/node/static-content-server.d.ts +60 -0
  34. package/src/adapters/node/static-content-server.js +194 -0
  35. package/src/adapters/shared/api-response.d.ts +52 -0
  36. package/src/adapters/shared/api-response.js +96 -0
  37. package/src/adapters/shared/application-adapter.d.ts +18 -0
  38. package/src/adapters/shared/application-adapter.js +90 -0
  39. package/src/adapters/shared/define-api-handler.d.ts +25 -0
  40. package/src/adapters/shared/define-api-handler.js +15 -0
  41. package/src/adapters/shared/explicit-static-render-preparation.d.ts +25 -0
  42. package/src/adapters/shared/explicit-static-render-preparation.js +26 -0
  43. package/src/adapters/shared/explicit-static-route-matcher.d.ts +41 -0
  44. package/src/adapters/shared/explicit-static-route-matcher.js +101 -0
  45. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +62 -0
  46. package/src/adapters/shared/file-route-middleware-pipeline.js +90 -0
  47. package/src/adapters/shared/fs-server-response-factory.d.ts +23 -0
  48. package/src/adapters/shared/fs-server-response-factory.js +81 -0
  49. package/src/adapters/shared/fs-server-response-matcher.d.ts +75 -0
  50. package/src/adapters/shared/fs-server-response-matcher.js +186 -0
  51. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  52. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  53. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  54. package/src/adapters/shared/hmr-html-response.js +32 -0
  55. package/src/adapters/shared/render-context.d.ts +15 -0
  56. package/src/adapters/shared/render-context.js +72 -0
  57. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  58. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  59. package/src/adapters/shared/server-adapter.d.ts +108 -0
  60. package/src/adapters/shared/server-adapter.js +429 -0
  61. package/src/adapters/shared/server-route-handler.d.ts +89 -0
  62. package/src/adapters/shared/server-route-handler.js +111 -0
  63. package/src/adapters/shared/server-static-builder.d.ts +71 -0
  64. package/src/adapters/shared/server-static-builder.js +100 -0
  65. package/src/build/build-adapter.d.ts +239 -0
  66. package/src/build/build-adapter.js +642 -0
  67. package/src/build/build-manifest.d.ts +27 -0
  68. package/src/build/build-manifest.js +30 -0
  69. package/src/build/build-types.d.ts +57 -0
  70. package/src/build/build-types.js +0 -0
  71. package/src/build/dev-build-coordinator.d.ts +72 -0
  72. package/src/build/dev-build-coordinator.js +154 -0
  73. package/src/build/esbuild-build-adapter.d.ts +78 -0
  74. package/src/build/esbuild-build-adapter.js +505 -0
  75. package/src/build/runtime-build-executor.d.ts +14 -0
  76. package/src/build/runtime-build-executor.js +22 -0
  77. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  78. package/src/build/runtime-specifier-alias-plugin.js +35 -0
  79. package/src/build/runtime-specifier-aliases.d.ts +5 -0
  80. package/src/build/runtime-specifier-aliases.js +95 -0
  81. package/src/config/config-builder.d.ts +252 -0
  82. package/src/config/config-builder.js +598 -0
  83. package/src/config/{constants.ts → constants.d.ts} +13 -22
  84. package/src/config/constants.js +25 -0
  85. package/src/dev/host-runtime.d.ts +10 -0
  86. package/src/dev/host-runtime.js +24 -0
  87. package/src/dev/sc-server.d.ts +30 -0
  88. package/src/dev/sc-server.js +111 -0
  89. package/src/eco/eco.browser.d.ts +2 -0
  90. package/src/eco/eco.browser.js +83 -0
  91. package/src/eco/eco.d.ts +9 -0
  92. package/src/eco/eco.js +85 -0
  93. package/src/eco/eco.types.d.ts +178 -0
  94. package/src/eco/eco.types.js +0 -0
  95. package/src/eco/eco.utils.d.ts +1 -0
  96. package/src/eco/eco.utils.js +10 -0
  97. package/src/eco/global-injector-map.d.ts +16 -0
  98. package/src/eco/global-injector-map.js +80 -0
  99. package/src/eco/lazy-injector-map.d.ts +8 -0
  100. package/src/eco/lazy-injector-map.js +70 -0
  101. package/src/eco/module-dependencies.d.ts +18 -0
  102. package/src/eco/module-dependencies.js +49 -0
  103. package/src/errors/http-error.d.ts +31 -0
  104. package/src/errors/http-error.js +50 -0
  105. package/src/errors/index.d.ts +3 -0
  106. package/src/errors/index.js +6 -0
  107. package/src/errors/locals-access-error.d.ts +4 -0
  108. package/src/errors/locals-access-error.js +9 -0
  109. package/src/global/app-logger.d.ts +2 -0
  110. package/src/global/app-logger.js +6 -0
  111. package/src/hmr/client/hmr-runtime.d.ts +5 -0
  112. package/src/hmr/client/hmr-runtime.js +117 -0
  113. package/src/hmr/hmr-strategy.d.ts +162 -0
  114. package/src/hmr/hmr-strategy.js +44 -0
  115. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  116. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  117. package/src/hmr/hmr.test.e2e.d.ts +1 -0
  118. package/src/hmr/hmr.test.e2e.js +43 -0
  119. package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
  120. package/src/hmr/strategies/default-hmr-strategy.js +34 -0
  121. package/src/hmr/strategies/js-hmr-strategy.d.ts +134 -0
  122. package/src/hmr/strategies/js-hmr-strategy.js +178 -0
  123. package/src/index.browser.d.ts +3 -0
  124. package/src/index.browser.js +4 -0
  125. package/src/index.d.ts +6 -0
  126. package/src/index.js +21 -0
  127. package/src/integrations/ghtml/ghtml-renderer.d.ts +16 -0
  128. package/src/integrations/ghtml/ghtml-renderer.js +57 -0
  129. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  130. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  131. package/src/integrations/ghtml/ghtml.plugin.d.ts +16 -0
  132. package/src/integrations/ghtml/ghtml.plugin.js +20 -0
  133. package/src/plugins/alias-resolver-plugin.d.ts +2 -0
  134. package/src/plugins/alias-resolver-plugin.js +53 -0
  135. package/src/plugins/eco-component-meta-plugin.d.ts +108 -0
  136. package/src/plugins/eco-component-meta-plugin.js +162 -0
  137. package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
  138. package/src/plugins/foreign-jsx-override-plugin.js +35 -0
  139. package/src/plugins/integration-plugin.d.ts +215 -0
  140. package/src/plugins/integration-plugin.js +189 -0
  141. package/src/plugins/processor.d.ts +97 -0
  142. package/src/plugins/processor.js +141 -0
  143. package/src/plugins/{runtime-capability.ts → runtime-capability.d.ts} +3 -8
  144. package/src/plugins/runtime-capability.js +0 -0
  145. package/src/plugins/source-transform.d.ts +46 -0
  146. package/src/plugins/source-transform.js +71 -0
  147. package/src/route-renderer/orchestration/component-render-context.d.ts +89 -0
  148. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  149. package/src/route-renderer/orchestration/declared-ownership-graph.d.ts +18 -0
  150. package/src/route-renderer/orchestration/declared-ownership-graph.js +34 -0
  151. package/src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts +108 -0
  152. package/src/route-renderer/orchestration/foreign-subtree-execution.service.js +206 -0
  153. package/src/route-renderer/orchestration/integration-renderer.d.ts +516 -0
  154. package/src/route-renderer/orchestration/integration-renderer.js +909 -0
  155. package/src/route-renderer/orchestration/ownership-planning.service.d.ts +24 -0
  156. package/src/route-renderer/orchestration/ownership-planning.service.js +63 -0
  157. package/src/route-renderer/orchestration/ownership-validation.service.d.ts +29 -0
  158. package/src/route-renderer/orchestration/ownership-validation.service.js +53 -0
  159. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +2 -0
  160. package/src/route-renderer/orchestration/processed-asset-dedupe.js +23 -0
  161. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.d.ts +90 -0
  162. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.js +158 -0
  163. package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
  164. package/src/route-renderer/orchestration/render-output.utils.js +171 -0
  165. package/src/route-renderer/orchestration/route-render-orchestrator.d.ts +120 -0
  166. package/src/route-renderer/orchestration/route-render-orchestrator.js +388 -0
  167. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  168. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  169. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
  170. package/src/route-renderer/page-loading/component-dependency-collection.js +132 -0
  171. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
  172. package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
  173. package/src/route-renderer/page-loading/dependency-resolver.d.ts +35 -0
  174. package/src/route-renderer/page-loading/dependency-resolver.js +115 -0
  175. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
  176. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
  177. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
  178. package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
  179. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
  180. package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
  181. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
  182. package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
  183. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
  184. package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
  185. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
  186. package/src/route-renderer/page-loading/page-dependency-bundling.js +137 -0
  187. package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
  188. package/src/route-renderer/page-loading/page-module-loader.js +127 -0
  189. package/src/route-renderer/route-renderer.d.ts +69 -0
  190. package/src/route-renderer/route-renderer.js +80 -0
  191. package/src/router/client/link-intent.js +34 -0
  192. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  193. package/src/router/client/link-intent.test.browser.js +43 -0
  194. package/src/router/client/navigation-coordinator.d.ts +169 -0
  195. package/src/router/client/navigation-coordinator.js +215 -0
  196. package/src/router/server/route-registry.d.ts +78 -0
  197. package/src/router/server/route-registry.js +262 -0
  198. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
  199. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
  200. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +103 -0
  201. package/src/services/assets/asset-processing-service/asset-processing.service.js +285 -0
  202. package/src/services/assets/asset-processing-service/asset.factory.d.ts +17 -0
  203. package/src/services/assets/asset-processing-service/asset.factory.js +82 -0
  204. package/src/services/assets/asset-processing-service/assets.types.d.ts +103 -0
  205. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  206. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  207. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +49 -0
  208. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  209. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  210. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
  211. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
  212. package/src/services/assets/asset-processing-service/index.d.ts +6 -0
  213. package/src/services/assets/asset-processing-service/index.js +6 -0
  214. package/src/services/assets/asset-processing-service/page-package.d.ts +3 -0
  215. package/src/services/assets/asset-processing-service/page-package.js +74 -0
  216. package/src/services/assets/asset-processing-service/{processor.interface.ts → processor.interface.d.ts} +5 -10
  217. package/src/services/assets/asset-processing-service/processor.interface.js +6 -0
  218. package/src/services/assets/asset-processing-service/processor.registry.d.ts +8 -0
  219. package/src/services/assets/asset-processing-service/processor.registry.js +15 -0
  220. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +24 -0
  221. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +65 -0
  222. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +22 -0
  223. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +136 -0
  224. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  225. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  226. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +6 -0
  227. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +119 -0
  228. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +9 -0
  229. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +97 -0
  230. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
  231. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +79 -0
  232. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +8 -0
  233. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +59 -0
  234. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
  235. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +69 -0
  236. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
  237. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
  238. package/src/services/assets/browser-bundle.service.d.ts +73 -0
  239. package/src/services/assets/browser-bundle.service.js +41 -0
  240. package/src/services/cache/cache.types.d.ts +107 -0
  241. package/src/services/cache/cache.types.js +0 -0
  242. package/src/services/cache/index.d.ts +7 -0
  243. package/src/services/cache/index.js +7 -0
  244. package/src/services/cache/memory-cache-store.d.ts +42 -0
  245. package/src/services/cache/memory-cache-store.js +98 -0
  246. package/src/services/cache/page-cache-service.d.ts +70 -0
  247. package/src/services/cache/page-cache-service.js +152 -0
  248. package/src/services/cache/page-request-cache-coordinator.service.d.ts +75 -0
  249. package/src/services/cache/page-request-cache-coordinator.service.js +109 -0
  250. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  251. package/src/services/html/html-rewriter-provider.service.js +68 -0
  252. package/src/services/html/html-transformer.service.d.ts +87 -0
  253. package/src/services/html/html-transformer.service.js +216 -0
  254. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  255. package/src/services/invalidation/development-invalidation.service.js +190 -0
  256. package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
  257. package/src/services/module-loading/app-module-loader.service.js +0 -0
  258. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
  259. package/src/services/module-loading/app-server-module-transpiler.service.js +115 -0
  260. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  261. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  262. package/src/services/module-loading/{module-loading-types.ts → module-loading-types.d.ts} +0 -1
  263. package/src/services/module-loading/module-loading-types.js +0 -0
  264. package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
  265. package/src/services/module-loading/node-bootstrap-plugin.js +216 -0
  266. package/src/services/module-loading/page-module-import.service.d.ts +76 -0
  267. package/src/services/module-loading/page-module-import.service.js +170 -0
  268. package/src/services/module-loading/server-module-transpiler.service.d.ts +63 -0
  269. package/src/services/module-loading/server-module-transpiler.service.js +64 -0
  270. package/src/services/module-loading/source-module-support.d.ts +5 -0
  271. package/src/services/module-loading/source-module-support.js +8 -0
  272. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  273. package/src/services/runtime-state/dev-graph.service.js +162 -0
  274. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  275. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  276. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  277. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  278. package/src/services/validation/schema-validation-service.d.ts +122 -0
  279. package/src/services/validation/schema-validation-service.js +101 -0
  280. package/src/services/validation/{standard-schema.types.ts → standard-schema.types.d.ts} +17 -20
  281. package/src/services/validation/standard-schema.types.js +0 -0
  282. package/src/static-site-generator/static-site-generator.d.ts +104 -0
  283. package/src/static-site-generator/static-site-generator.js +316 -0
  284. package/src/types/internal-types.d.ts +232 -0
  285. package/src/types/internal-types.js +0 -0
  286. package/src/types/public-types.d.ts +1267 -0
  287. package/src/types/public-types.js +0 -0
  288. package/src/utils/deep-merge.d.ts +14 -0
  289. package/src/utils/deep-merge.js +32 -0
  290. package/src/utils/hash.d.ts +1 -0
  291. package/src/utils/hash.js +7 -0
  292. package/src/utils/html-escaping.d.ts +7 -0
  293. package/src/utils/html-escaping.js +6 -0
  294. package/src/utils/html.js +4 -0
  295. package/src/utils/invariant.d.ts +5 -0
  296. package/src/utils/invariant.js +11 -0
  297. package/src/utils/locals-utils.d.ts +15 -0
  298. package/src/utils/locals-utils.js +24 -0
  299. package/src/utils/parse-cli-args.d.ts +27 -0
  300. package/src/utils/parse-cli-args.js +62 -0
  301. package/src/utils/path-utils.module.d.ts +5 -0
  302. package/src/utils/path-utils.module.js +14 -0
  303. package/src/utils/resolve-work-dir.d.ts +11 -0
  304. package/src/utils/resolve-work-dir.js +31 -0
  305. package/src/utils/runtime.d.ts +11 -0
  306. package/src/utils/runtime.js +40 -0
  307. package/src/utils/server-utils.module.d.ts +19 -0
  308. package/src/utils/server-utils.module.js +56 -0
  309. package/src/watchers/project-watcher.d.ts +136 -0
  310. package/src/watchers/project-watcher.js +275 -0
  311. package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
  312. package/src/watchers/project-watcher.test-helpers.js +52 -0
  313. package/src/adapters/abstract/application-adapter.test.ts +0 -172
  314. package/src/adapters/abstract/application-adapter.ts +0 -379
  315. package/src/adapters/abstract/router-adapter.ts +0 -30
  316. package/src/adapters/abstract/server-adapter.ts +0 -79
  317. package/src/adapters/bun/client-bridge.ts +0 -62
  318. package/src/adapters/bun/create-app.ts +0 -232
  319. package/src/adapters/bun/hmr-manager.test.ts +0 -265
  320. package/src/adapters/bun/hmr-manager.ts +0 -383
  321. package/src/adapters/bun/index.ts +0 -2
  322. package/src/adapters/bun/server-adapter.ts +0 -526
  323. package/src/adapters/bun/server-lifecycle.ts +0 -124
  324. package/src/adapters/create-app.test.ts +0 -10
  325. package/src/adapters/create-app.ts +0 -91
  326. package/src/adapters/index.ts +0 -2
  327. package/src/adapters/node/create-app.test.ts +0 -53
  328. package/src/adapters/node/create-app.ts +0 -183
  329. package/src/adapters/node/node-client-bridge.test.ts +0 -198
  330. package/src/adapters/node/node-client-bridge.ts +0 -79
  331. package/src/adapters/node/node-hmr-manager.test.ts +0 -320
  332. package/src/adapters/node/node-hmr-manager.ts +0 -355
  333. package/src/adapters/node/server-adapter.ts +0 -502
  334. package/src/adapters/node/static-content-server.test.ts +0 -60
  335. package/src/adapters/node/static-content-server.ts +0 -239
  336. package/src/adapters/shared/api-response.test.ts +0 -97
  337. package/src/adapters/shared/api-response.ts +0 -104
  338. package/src/adapters/shared/application-adapter.ts +0 -199
  339. package/src/adapters/shared/define-api-handler.ts +0 -66
  340. package/src/adapters/shared/explicit-static-render-preparation.ts +0 -58
  341. package/src/adapters/shared/explicit-static-route-matcher.test.ts +0 -381
  342. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -131
  343. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +0 -85
  344. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -118
  345. package/src/adapters/shared/fs-server-response-factory.test.ts +0 -176
  346. package/src/adapters/shared/fs-server-response-factory.ts +0 -96
  347. package/src/adapters/shared/fs-server-response-matcher.test.ts +0 -311
  348. package/src/adapters/shared/fs-server-response-matcher.ts +0 -240
  349. package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
  350. package/src/adapters/shared/hmr-html-response.ts +0 -52
  351. package/src/adapters/shared/hmr-manager.contract.test.ts +0 -228
  352. package/src/adapters/shared/hmr-manager.dispatch.test.ts +0 -220
  353. package/src/adapters/shared/render-context.test.ts +0 -150
  354. package/src/adapters/shared/render-context.ts +0 -123
  355. package/src/adapters/shared/runtime-bootstrap.ts +0 -79
  356. package/src/adapters/shared/server-adapter.test.ts +0 -130
  357. package/src/adapters/shared/server-adapter.ts +0 -562
  358. package/src/adapters/shared/server-route-handler.test.ts +0 -111
  359. package/src/adapters/shared/server-route-handler.ts +0 -153
  360. package/src/adapters/shared/server-static-builder.test.ts +0 -338
  361. package/src/adapters/shared/server-static-builder.ts +0 -170
  362. package/src/build/build-adapter-serialization.test.ts +0 -281
  363. package/src/build/build-adapter.test.ts +0 -1240
  364. package/src/build/build-adapter.ts +0 -1012
  365. package/src/build/build-manifest.ts +0 -54
  366. package/src/build/build-types.ts +0 -83
  367. package/src/build/dev-build-coordinator.ts +0 -220
  368. package/src/build/esbuild-build-adapter.ts +0 -660
  369. package/src/build/runtime-build-executor.test.ts +0 -81
  370. package/src/build/runtime-build-executor.ts +0 -40
  371. package/src/build/runtime-specifier-alias-plugin.test.ts +0 -67
  372. package/src/build/runtime-specifier-alias-plugin.ts +0 -62
  373. package/src/build/runtime-specifier-aliases.ts +0 -135
  374. package/src/config/config-builder.test.ts +0 -442
  375. package/src/config/config-builder.ts +0 -737
  376. package/src/config/config-builder.typecheck.test.ts +0 -96
  377. package/src/dev/host-runtime.ts +0 -34
  378. package/src/dev/sc-server.ts +0 -143
  379. package/src/eco/eco.browser.test.ts +0 -43
  380. package/src/eco/eco.browser.ts +0 -118
  381. package/src/eco/eco.test.ts +0 -654
  382. package/src/eco/eco.ts +0 -205
  383. package/src/eco/eco.types.ts +0 -221
  384. package/src/eco/eco.utils.test.ts +0 -219
  385. package/src/eco/eco.utils.ts +0 -5
  386. package/src/eco/global-injector-map.test.ts +0 -42
  387. package/src/eco/global-injector-map.ts +0 -112
  388. package/src/eco/lazy-injector-map.test.ts +0 -66
  389. package/src/eco/lazy-injector-map.ts +0 -120
  390. package/src/eco/module-dependencies.test.ts +0 -30
  391. package/src/eco/module-dependencies.ts +0 -75
  392. package/src/errors/http-error.test.ts +0 -134
  393. package/src/errors/http-error.ts +0 -72
  394. package/src/errors/index.ts +0 -3
  395. package/src/errors/locals-access-error.ts +0 -7
  396. package/src/global/app-logger.ts +0 -4
  397. package/src/global/utils.test.ts +0 -12
  398. 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
  399. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  400. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  401. package/src/hmr/client/hmr-runtime.ts +0 -162
  402. package/src/hmr/hmr-strategy.test.ts +0 -124
  403. package/src/hmr/hmr-strategy.ts +0 -177
  404. package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
  405. package/src/hmr/hmr.test.e2e.ts +0 -66
  406. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  407. package/src/hmr/strategies/js-hmr-strategy.test.ts +0 -334
  408. package/src/hmr/strategies/js-hmr-strategy.ts +0 -314
  409. package/src/index.browser.ts +0 -3
  410. package/src/index.ts +0 -15
  411. package/src/integrations/ghtml/ghtml-renderer.test.ts +0 -253
  412. package/src/integrations/ghtml/ghtml-renderer.ts +0 -87
  413. package/src/integrations/ghtml/ghtml.constants.ts +0 -1
  414. package/src/integrations/ghtml/ghtml.plugin.ts +0 -28
  415. package/src/plugins/alias-resolver-plugin.test.ts +0 -41
  416. package/src/plugins/alias-resolver-plugin.ts +0 -63
  417. package/src/plugins/eco-component-meta-plugin.test.ts +0 -406
  418. package/src/plugins/eco-component-meta-plugin.ts +0 -494
  419. package/src/plugins/foreign-jsx-override-plugin.test.ts +0 -65
  420. package/src/plugins/foreign-jsx-override-plugin.ts +0 -67
  421. package/src/plugins/integration-plugin.test.ts +0 -151
  422. package/src/plugins/integration-plugin.ts +0 -323
  423. package/src/plugins/processor.test.ts +0 -148
  424. package/src/plugins/processor.ts +0 -257
  425. package/src/plugins/source-transform.test.ts +0 -82
  426. package/src/plugins/source-transform.ts +0 -123
  427. package/src/route-renderer/orchestration/component-render-context.ts +0 -325
  428. package/src/route-renderer/orchestration/declared-ownership-graph.ts +0 -62
  429. package/src/route-renderer/orchestration/foreign-subtree-execution.service.ts +0 -383
  430. package/src/route-renderer/orchestration/integration-renderer.test.ts +0 -2085
  431. package/src/route-renderer/orchestration/integration-renderer.ts +0 -1244
  432. package/src/route-renderer/orchestration/ownership-planning.service.ts +0 -97
  433. package/src/route-renderer/orchestration/ownership-validation.service.ts +0 -76
  434. package/src/route-renderer/orchestration/processed-asset-dedupe.ts +0 -25
  435. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.test.ts +0 -324
  436. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.ts +0 -294
  437. package/src/route-renderer/orchestration/render-output.utils.ts +0 -310
  438. package/src/route-renderer/orchestration/route-render-orchestrator.prepare-render-options.test.ts +0 -644
  439. package/src/route-renderer/orchestration/route-render-orchestrator.test.ts +0 -265
  440. package/src/route-renderer/orchestration/route-render-orchestrator.ts +0 -592
  441. package/src/route-renderer/orchestration/template-serialization.test.ts +0 -110
  442. package/src/route-renderer/orchestration/template-serialization.ts +0 -117
  443. package/src/route-renderer/page-loading/component-dependency-collection.ts +0 -202
  444. package/src/route-renderer/page-loading/declared-asset-collection.ts +0 -153
  445. package/src/route-renderer/page-loading/dependency-resolver.test.ts +0 -761
  446. package/src/route-renderer/page-loading/dependency-resolver.ts +0 -144
  447. package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +0 -75
  448. package/src/route-renderer/page-loading/lazy-entry-collection.ts +0 -167
  449. package/src/route-renderer/page-loading/lazy-trigger-planning.ts +0 -74
  450. package/src/route-renderer/page-loading/module-declaration-aggregation.ts +0 -60
  451. package/src/route-renderer/page-loading/module-declaration-scripts.ts +0 -16
  452. package/src/route-renderer/page-loading/page-dependency-bundling.ts +0 -244
  453. package/src/route-renderer/page-loading/page-module-loader.test.ts +0 -183
  454. package/src/route-renderer/page-loading/page-module-loader.ts +0 -184
  455. package/src/route-renderer/route-renderer.ts +0 -133
  456. package/src/router/client/link-intent.test.browser.ts +0 -51
  457. package/src/router/client/link-intent.ts +0 -92
  458. package/src/router/client/navigation-coordinator.test.ts +0 -237
  459. package/src/router/client/navigation-coordinator.ts +0 -453
  460. package/src/router/server/route-registry.test.ts +0 -176
  461. package/src/router/server/route-registry.ts +0 -382
  462. package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +0 -66
  463. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +0 -473
  464. package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -344
  465. package/src/services/assets/asset-processing-service/asset.factory.test.ts +0 -63
  466. package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
  467. package/src/services/assets/asset-processing-service/assets.types.ts +0 -128
  468. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +0 -74
  469. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -96
  470. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +0 -67
  471. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
  472. package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +0 -104
  473. package/src/services/assets/asset-processing-service/index.ts +0 -6
  474. package/src/services/assets/asset-processing-service/page-package.test.ts +0 -100
  475. package/src/services/assets/asset-processing-service/page-package.ts +0 -93
  476. package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
  477. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +0 -59
  478. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -83
  479. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -173
  480. package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
  481. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +0 -195
  482. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -137
  483. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +0 -326
  484. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -116
  485. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +0 -227
  486. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -89
  487. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +0 -261
  488. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -72
  489. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -83
  490. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +0 -65
  491. package/src/services/assets/browser-bundle.service.test.ts +0 -66
  492. package/src/services/assets/browser-bundle.service.ts +0 -109
  493. package/src/services/cache/cache.types.ts +0 -126
  494. package/src/services/cache/index.ts +0 -18
  495. package/src/services/cache/memory-cache-store.test.ts +0 -225
  496. package/src/services/cache/memory-cache-store.ts +0 -130
  497. package/src/services/cache/page-cache-service.test.ts +0 -175
  498. package/src/services/cache/page-cache-service.ts +0 -202
  499. package/src/services/cache/page-request-cache-coordinator.service.test.ts +0 -79
  500. package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
  501. package/src/services/html/html-rewriter-provider.service.test.ts +0 -183
  502. package/src/services/html/html-rewriter-provider.service.ts +0 -104
  503. package/src/services/html/html-transformer.service.test.ts +0 -476
  504. package/src/services/html/html-transformer.service.ts +0 -275
  505. package/src/services/invalidation/development-invalidation.service.test.ts +0 -87
  506. package/src/services/invalidation/development-invalidation.service.ts +0 -262
  507. package/src/services/module-loading/app-module-loader.service.ts +0 -9
  508. package/src/services/module-loading/app-server-module-transpiler.service.test.ts +0 -130
  509. package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -141
  510. package/src/services/module-loading/host-module-loader-registry.ts +0 -15
  511. package/src/services/module-loading/node-bootstrap-plugin.test.ts +0 -335
  512. package/src/services/module-loading/node-bootstrap-plugin.ts +0 -311
  513. package/src/services/module-loading/page-module-import.service.test.ts +0 -504
  514. package/src/services/module-loading/page-module-import.service.ts +0 -251
  515. package/src/services/module-loading/server-module-transpiler.service.test.ts +0 -243
  516. package/src/services/module-loading/server-module-transpiler.service.ts +0 -104
  517. package/src/services/module-loading/source-module-support.ts +0 -19
  518. package/src/services/runtime-state/dev-graph.service.ts +0 -217
  519. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
  520. package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
  521. package/src/services/validation/schema-validation-service.test.ts +0 -223
  522. package/src/services/validation/schema-validation-service.ts +0 -204
  523. package/src/static-site-generator/static-site-generator.test.ts +0 -408
  524. package/src/static-site-generator/static-site-generator.ts +0 -445
  525. package/src/types/internal-types.ts +0 -243
  526. package/src/types/public-types.ts +0 -1459
  527. package/src/utils/deep-merge.test.ts +0 -114
  528. package/src/utils/deep-merge.ts +0 -47
  529. package/src/utils/hash.ts +0 -5
  530. package/src/utils/html-escaping.ts +0 -9
  531. package/src/utils/invariant.test.ts +0 -22
  532. package/src/utils/invariant.ts +0 -15
  533. package/src/utils/locals-utils.ts +0 -37
  534. package/src/utils/parse-cli-args.test.ts +0 -69
  535. package/src/utils/parse-cli-args.ts +0 -105
  536. package/src/utils/path-utils.module.ts +0 -14
  537. package/src/utils/path-utils.test.ts +0 -15
  538. package/src/utils/resolve-work-dir.ts +0 -45
  539. package/src/utils/runtime.ts +0 -44
  540. package/src/utils/server-utils.module.ts +0 -67
  541. package/src/utils/server-utils.test.ts +0 -38
  542. package/src/watchers/project-watcher.integration.test.ts +0 -337
  543. package/src/watchers/project-watcher.test-helpers.ts +0 -42
  544. package/src/watchers/project-watcher.test.ts +0 -768
  545. package/src/watchers/project-watcher.ts +0 -357
  546. /package/src/utils/{html.ts → html.d.ts} +0 -0
@@ -0,0 +1,189 @@
1
+ import { AssetProcessingService } from "../services/assets/asset-processing-service/asset-processing.service.js";
2
+ import { deepMerge } from "../utils/deep-merge.js";
3
+ import { invariant } from "../utils/invariant.js";
4
+ const INTEGRATION_PLUGIN_ERRORS = {
5
+ NOT_INITIALIZED_WITH_APP_CONFIG: "Plugin not initialized with app config",
6
+ NOT_INITIALIZED_WITH_ASSET_SERVICE: "Plugin not initialized with asset dependency service"
7
+ };
8
+ function mergeIntegrationOptions(defaults, overrides) {
9
+ return deepMerge(defaults, overrides);
10
+ }
11
+ function assertIntegrationInvariant(condition, message) {
12
+ invariant(condition, message);
13
+ }
14
+ class IntegrationPlugin {
15
+ name;
16
+ extensions;
17
+ staticBuildStep;
18
+ runtimeCapability;
19
+ jsxImportSource;
20
+ integrationDependencies;
21
+ resolvedIntegrationDependencies = [];
22
+ options;
23
+ appConfig;
24
+ assetProcessingService;
25
+ hmrManager;
26
+ get plugins() {
27
+ return [];
28
+ }
29
+ /**
30
+ * Returns build plugins that should only apply to browser-oriented bundles.
31
+ *
32
+ * @remarks
33
+ * Browser-only transforms such as runtime import aliasing belong here so they
34
+ * do not affect server bundles or static-page module generation.
35
+ */
36
+ get browserBuildPlugins() {
37
+ return [];
38
+ }
39
+ /**
40
+ * Creates the integration with static declaration-only configuration.
41
+ *
42
+ * @remarks
43
+ * Constructors are expected to stay side-effect free. Build-manifest
44
+ * contributions belong in `prepareBuildContributions()` and runtime-only setup
45
+ * belongs in `setup()`.
46
+ */
47
+ constructor(config) {
48
+ this.name = config.name;
49
+ this.extensions = config.extensions;
50
+ this.integrationDependencies = config.integrationDependencies || [];
51
+ this.staticBuildStep = config.staticBuildStep || "render";
52
+ this.runtimeCapability = config.runtimeCapability;
53
+ this.jsxImportSource = config.jsxImportSource;
54
+ }
55
+ /**
56
+ * Attaches the finalized app config to the integration.
57
+ *
58
+ * Core calls this during config finalization before runtime setup so the
59
+ * integration can resolve asset paths and other app-owned services later.
60
+ */
61
+ setConfig(appConfig) {
62
+ this.appConfig = appConfig;
63
+ this.initializeAssetDefinitionService();
64
+ }
65
+ /**
66
+ * Records the runtime origin used for page-module loading and renderer setup.
67
+ */
68
+ setRuntimeOrigin(runtimeOrigin) {
69
+ this.runtimeOrigin = runtimeOrigin;
70
+ }
71
+ /**
72
+ * Attaches the shared HMR manager and registers integration-owned development hooks.
73
+ *
74
+ * @remarks
75
+ * The default implementation registers the optional integration HMR strategy.
76
+ * Integrations should override this only when they need to extend that shared
77
+ * behavior rather than replace it.
78
+ */
79
+ setHmrManager(hmrManager) {
80
+ this.hmrManager = hmrManager;
81
+ const strategy = this.getHmrStrategy?.();
82
+ if (strategy) {
83
+ hmrManager.registerStrategy(strategy);
84
+ }
85
+ if (this.assetProcessingService) {
86
+ this.assetProcessingService.setHmrManager(hmrManager);
87
+ }
88
+ }
89
+ /**
90
+ * Creates the asset-processing service used for global integration dependencies.
91
+ */
92
+ initializeAssetDefinitionService() {
93
+ if (!this.appConfig) throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_APP_CONFIG);
94
+ this.assetProcessingService = AssetProcessingService.createWithDefaultProcessors(this.appConfig);
95
+ if (this.hmrManager) {
96
+ this.assetProcessingService.setHmrManager(this.hmrManager);
97
+ }
98
+ }
99
+ /**
100
+ * Returns processed global assets resolved during `setup()`.
101
+ */
102
+ getResolvedIntegrationDependencies() {
103
+ return this.resolvedIntegrationDependencies;
104
+ }
105
+ /**
106
+ * Creates the shared renderer options owned by core lifecycle setup.
107
+ */
108
+ createRendererOptions(options) {
109
+ if (!this.appConfig) {
110
+ throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_APP_CONFIG);
111
+ }
112
+ const assetProcessingService = AssetProcessingService.createWithDefaultProcessors(this.appConfig);
113
+ if (this.hmrManager) {
114
+ assetProcessingService.setHmrManager(this.hmrManager);
115
+ }
116
+ return {
117
+ appConfig: this.appConfig,
118
+ assetProcessingService,
119
+ resolvedIntegrationDependencies: this.resolvedIntegrationDependencies,
120
+ rendererModules: options?.rendererModules,
121
+ runtimeOrigin: this.runtimeOrigin
122
+ };
123
+ }
124
+ /**
125
+ * Attaches runtime-only services after a renderer instance has been created.
126
+ */
127
+ attachRendererRuntimeServices(renderer) {
128
+ if (typeof renderer.name !== "string" || renderer.name.length === 0) {
129
+ renderer.name = this.name;
130
+ }
131
+ if (this.hmrManager) {
132
+ renderer.setHmrManager(this.hmrManager);
133
+ }
134
+ return renderer;
135
+ }
136
+ /**
137
+ * Instantiates the integration renderer with app-owned services.
138
+ *
139
+ * @remarks
140
+ * Renderers are cheap runtime objects. They receive the finalized app config,
141
+ * a fresh asset-processing service, integration-global processed assets, and
142
+ * any renderer module context supplied by the active runtime.
143
+ renderer.name ||= this.name;
144
+ */
145
+ initializeRenderer(options) {
146
+ const renderer = new this.renderer(this.createRendererOptions(options));
147
+ renderer.name ||= this.name;
148
+ return this.attachRendererRuntimeServices(renderer);
149
+ }
150
+ /**
151
+ * Prepares build-facing contributions before the app build manifest is sealed.
152
+ *
153
+ * @remarks
154
+ * Integrations can override this when runtime or build plugin declarations must
155
+ * be materialized ahead of runtime startup. Runtime-only side effects stay in
156
+ * `setup()`.
157
+ */
158
+ async prepareBuildContributions() {
159
+ }
160
+ /**
161
+ * Performs runtime-only integration setup after config build has already
162
+ * sealed manifest contributions.
163
+ */
164
+ async setup() {
165
+ if (this.integrationDependencies.length === 0) return;
166
+ if (!this.assetProcessingService) throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_ASSET_SERVICE);
167
+ this.resolvedIntegrationDependencies = await this.assetProcessingService.processDependencies(
168
+ this.integrationDependencies,
169
+ this.name
170
+ );
171
+ this.initializeRenderer();
172
+ }
173
+ /**
174
+ * Releases runtime resources owned by the integration.
175
+ *
176
+ * @remarks
177
+ * Most integrations do not need custom teardown. Override this only for
178
+ * explicit cleanup such as watchers, compiler handles, or runtime registries
179
+ * that outlive individual requests.
180
+ */
181
+ async teardown() {
182
+ }
183
+ }
184
+ export {
185
+ INTEGRATION_PLUGIN_ERRORS,
186
+ IntegrationPlugin,
187
+ assertIntegrationInvariant,
188
+ mergeIntegrationOptions
189
+ };
@@ -0,0 +1,97 @@
1
+ import type { EcoBuildPlugin } from '../build/build-types.js';
2
+ import type { EcoPagesAppConfig, IClientBridge } from '../types/internal-types.js';
3
+ import type { AssetDefinition } from '../services/assets/asset-processing-service/assets.types.js';
4
+ import type { RuntimeCapabilityDeclaration } from './runtime-capability.js';
5
+ export type { RuntimeCapabilityDeclaration, RuntimeCapabilityTag } from './runtime-capability.js';
6
+ export type { EcoBuildLoader, EcoBuildOnLoadArgs, EcoBuildOnLoadResult, EcoBuildOnResolveArgs, EcoBuildOnResolveResult, EcoBuildPlugin, EcoBuildPluginBuilder, } from '../build/build-types.js';
7
+ export declare const PROCESSOR_ERRORS: {
8
+ readonly CACHE_DIRECTORY_NOT_SET: "Cache directory not set in context";
9
+ };
10
+ export declare function mergeProcessorOptions<TDefaults, TOverrides>(defaults: TDefaults, overrides: TOverrides): TDefaults & TOverrides;
11
+ export interface ProcessorWatchContext {
12
+ path: string;
13
+ bridge: IClientBridge;
14
+ }
15
+ export interface ProcessorWatchConfig {
16
+ paths: string[];
17
+ extensions?: string[];
18
+ onCreate?: (ctx: ProcessorWatchContext) => Promise<void>;
19
+ onChange?: (ctx: ProcessorWatchContext) => Promise<void>;
20
+ onDelete?: (ctx: ProcessorWatchContext) => Promise<void>;
21
+ onError?: (error: Error) => void;
22
+ }
23
+ export type ProcessorAssetKind = 'script' | 'stylesheet' | 'image';
24
+ export type ProcessorExtensionPattern = string;
25
+ export interface ProcessorAssetCapability {
26
+ kind: ProcessorAssetKind;
27
+ /**
28
+ * Supported patterns:
29
+ * - `*` (all extensions)
30
+ * - `.css` or `css`
31
+ * - `*.css`
32
+ * - `*.{css,scss,sass}`
33
+ *
34
+ * Pattern matching is case-insensitive and trims surrounding spaces,
35
+ * including grouped values (e.g. `*.{ CSS, ScSs }`).
36
+ */
37
+ extensions?: ProcessorExtensionPattern[];
38
+ }
39
+ export interface ProcessorConfig<TOptions = Record<string, unknown>> {
40
+ name: string;
41
+ description?: string;
42
+ options?: TOptions;
43
+ watch?: ProcessorWatchConfig;
44
+ capabilities?: ProcessorAssetCapability[];
45
+ runtimeCapability?: RuntimeCapabilityDeclaration;
46
+ }
47
+ export interface ProcessorContext {
48
+ config: EcoPagesAppConfig;
49
+ rootDir: string;
50
+ srcDir: string;
51
+ distDir: string;
52
+ cache?: string;
53
+ }
54
+ /**
55
+ * Interface for processor build plugins
56
+ * This is used to pass plugins to the build process directly from the processor
57
+ * For instance it can become very handy when dealing with virtual modules that needs to be recognized by the bundler
58
+ * i.e. @ecopages/image-processor
59
+ */
60
+ export declare abstract class Processor<TOptions = Record<string, unknown>> {
61
+ readonly name: string;
62
+ protected dependencies: AssetDefinition[];
63
+ protected context?: ProcessorContext;
64
+ protected options?: TOptions;
65
+ protected watchConfig?: ProcessorWatchConfig;
66
+ protected capabilities: ProcessorAssetCapability[];
67
+ readonly runtimeCapability?: RuntimeCapabilityDeclaration;
68
+ /** Plugins that are only used during the build process */
69
+ abstract buildPlugins?: EcoBuildPlugin[];
70
+ /** Plugins that are used during runtime for file processing */
71
+ abstract plugins?: EcoBuildPlugin[];
72
+ constructor(config: ProcessorConfig<TOptions>);
73
+ setContext(appConfig: EcoPagesAppConfig): void;
74
+ /**
75
+ * Prepares build-facing processor contributions before config finalization.
76
+ *
77
+ * @remarks
78
+ * Override this when a processor must compute runtime/build plugins or other
79
+ * manifest-owned state before startup. Runtime-only work such as cache
80
+ * warming or watcher registration should stay in `setup()`.
81
+ */
82
+ prepareBuildContributions(): Promise<void>;
83
+ abstract setup(): Promise<void>;
84
+ abstract teardown(): Promise<void>;
85
+ abstract process(input: unknown, filePath?: string): Promise<unknown>;
86
+ protected getCachePath(key: string): string;
87
+ protected readCache<T>(key: string): Promise<T | null>;
88
+ protected writeCache<T>(key: string, data: T): Promise<void>;
89
+ getWatchConfig(): ProcessorWatchConfig | undefined;
90
+ getDependencies(): AssetDefinition[];
91
+ getName(): string;
92
+ getAssetCapabilities(): ProcessorAssetCapability[];
93
+ matchesFileFilter(_filepath: string): boolean;
94
+ canProcessAsset(kind: ProcessorAssetKind, filepath?: string): boolean;
95
+ private matchesCapabilityExtensions;
96
+ private normalizeExtensionPattern;
97
+ }
@@ -0,0 +1,141 @@
1
+ import path from "node:path";
2
+ import { fileSystem } from "@ecopages/file-system";
3
+ import { DEFAULT_ECOPAGES_WORK_DIR } from "../config/constants.js";
4
+ import { GENERATED_BASE_PATHS } from "../config/constants.js";
5
+ import { deepMerge } from "../utils/deep-merge.js";
6
+ const PROCESSOR_ERRORS = {
7
+ CACHE_DIRECTORY_NOT_SET: "Cache directory not set in context"
8
+ };
9
+ function mergeProcessorOptions(defaults, overrides) {
10
+ return deepMerge(defaults, overrides);
11
+ }
12
+ function resolveGeneratedPath(type, options) {
13
+ const { root, module, subPath } = options;
14
+ const parts = [root, GENERATED_BASE_PATHS[type], module, subPath].filter(Boolean);
15
+ return path.join(...parts);
16
+ }
17
+ class Processor {
18
+ name;
19
+ dependencies = [];
20
+ context;
21
+ options;
22
+ watchConfig;
23
+ capabilities = [];
24
+ runtimeCapability;
25
+ constructor(config) {
26
+ this.name = config.name;
27
+ this.options = config.options;
28
+ this.watchConfig = config.watch;
29
+ this.capabilities = config.capabilities ?? [];
30
+ this.runtimeCapability = config.runtimeCapability;
31
+ }
32
+ setContext(appConfig) {
33
+ const workDir = appConfig.absolutePaths.workDir ?? path.join(appConfig.rootDir, appConfig.workDir ?? DEFAULT_ECOPAGES_WORK_DIR);
34
+ const cachePath = resolveGeneratedPath("cache", {
35
+ root: workDir,
36
+ module: this.name
37
+ });
38
+ fileSystem.ensureDir(cachePath);
39
+ this.context = {
40
+ config: appConfig,
41
+ rootDir: appConfig.rootDir,
42
+ srcDir: appConfig.absolutePaths.srcDir,
43
+ distDir: appConfig.absolutePaths.distDir,
44
+ cache: cachePath
45
+ };
46
+ }
47
+ /**
48
+ * Prepares build-facing processor contributions before config finalization.
49
+ *
50
+ * @remarks
51
+ * Override this when a processor must compute runtime/build plugins or other
52
+ * manifest-owned state before startup. Runtime-only work such as cache
53
+ * warming or watcher registration should stay in `setup()`.
54
+ */
55
+ async prepareBuildContributions() {
56
+ }
57
+ getCachePath(key) {
58
+ return `${this.context?.cache}/${key}`;
59
+ }
60
+ async readCache(key) {
61
+ const cachePath = this.getCachePath(key);
62
+ try {
63
+ const data = await fileSystem.readFile(cachePath);
64
+ return JSON.parse(data);
65
+ } catch {
66
+ return null;
67
+ }
68
+ }
69
+ async writeCache(key, data) {
70
+ if (!this.context?.cache) {
71
+ throw new Error(PROCESSOR_ERRORS.CACHE_DIRECTORY_NOT_SET);
72
+ }
73
+ const cachePath = this.getCachePath(key);
74
+ fileSystem.write(cachePath, JSON.stringify(data, null, 2));
75
+ }
76
+ getWatchConfig() {
77
+ return this.watchConfig;
78
+ }
79
+ getDependencies() {
80
+ return this.dependencies;
81
+ }
82
+ getName() {
83
+ return this.name;
84
+ }
85
+ getAssetCapabilities() {
86
+ return this.capabilities;
87
+ }
88
+ matchesFileFilter(_filepath) {
89
+ return true;
90
+ }
91
+ canProcessAsset(kind, filepath) {
92
+ const capabilities = this.getAssetCapabilities();
93
+ if (capabilities.length === 0) {
94
+ return false;
95
+ }
96
+ const matchingKind = capabilities.filter((capability) => capability.kind === kind);
97
+ if (matchingKind.length === 0) {
98
+ return false;
99
+ }
100
+ if (!filepath) {
101
+ return true;
102
+ }
103
+ return matchingKind.some((capability) => this.matchesCapabilityExtensions(filepath, capability.extensions));
104
+ }
105
+ matchesCapabilityExtensions(filepath, extensions) {
106
+ if (!extensions || extensions.length === 0) {
107
+ return true;
108
+ }
109
+ const normalizedExt = path.extname(filepath).toLowerCase();
110
+ return extensions.some((rawPattern) => {
111
+ const pattern = this.normalizeExtensionPattern(rawPattern);
112
+ if (!pattern) {
113
+ return false;
114
+ }
115
+ if (pattern === "*") {
116
+ return true;
117
+ }
118
+ const groupedMatch = pattern.match(/^\*\.\{(.+)\}$/);
119
+ if (groupedMatch) {
120
+ const groupItems = groupedMatch[1].split(",").map((item) => this.normalizeExtensionPattern(item)).filter(Boolean);
121
+ return groupItems.some((item) => normalizedExt === item || normalizedExt === `.${item}`);
122
+ }
123
+ if (pattern.startsWith("*")) {
124
+ const suffix = pattern.slice(1);
125
+ return normalizedExt.endsWith(suffix);
126
+ }
127
+ if (pattern.startsWith(".")) {
128
+ return normalizedExt === pattern;
129
+ }
130
+ return normalizedExt === `.${pattern}`;
131
+ });
132
+ }
133
+ normalizeExtensionPattern(rawPattern) {
134
+ return rawPattern.trim().toLowerCase();
135
+ }
136
+ }
137
+ export {
138
+ PROCESSOR_ERRORS,
139
+ Processor,
140
+ mergeProcessorOptions
141
+ };
@@ -1,14 +1,9 @@
1
- export type RuntimeCapabilityTag =
2
- | 'bun-only'
3
- | 'node-compatible'
4
- | 'requires-native-bun-api'
5
- | 'requires-node-builtins';
6
-
1
+ export type RuntimeCapabilityTag = 'bun-only' | 'node-compatible' | 'requires-native-bun-api' | 'requires-node-builtins';
7
2
  /**
8
3
  * Declares the runtime assumptions a plugin makes so config finalization can
9
4
  * reject incompatible startup environments before bootstrapping the app.
10
5
  */
11
6
  export interface RuntimeCapabilityDeclaration {
12
- tags: RuntimeCapabilityTag[];
13
- minRuntimeVersion?: string;
7
+ tags: RuntimeCapabilityTag[];
8
+ minRuntimeVersion?: string;
14
9
  }
File without changes
@@ -0,0 +1,46 @@
1
+ import type { EcoBuildPlugin } from '../build/build-types.js';
2
+ import type { EcoPagesAppConfig } from '../types/internal-types.js';
3
+ export interface EcoSourceTransformResult {
4
+ code: string;
5
+ map?: unknown;
6
+ }
7
+ export interface EcoSourceTransform {
8
+ name: string;
9
+ filter: RegExp;
10
+ enforce?: 'pre' | 'post';
11
+ transform(code: string, id: string): EcoSourceTransformResult | string | undefined;
12
+ }
13
+ export interface EcoViteCompatiblePlugin {
14
+ name: string;
15
+ enforce?: 'pre' | 'post';
16
+ transform(code: string, id: string): EcoSourceTransformResult | string | undefined;
17
+ }
18
+ /**
19
+ * Normalizes bundler module ids so one transform can serve Ecopages loaders,
20
+ * Vite, and future bundler adapters.
21
+ */
22
+ export declare function normalizeTransformId(id: string): string;
23
+ /**
24
+ * Applies one source transform if the normalized id matches its filter.
25
+ */
26
+ export declare function applySourceTransform(transform: EcoSourceTransform, code: string, id: string): EcoSourceTransformResult | string | undefined;
27
+ /**
28
+ * Adapts a source transform into the existing Ecopages build-plugin contract.
29
+ */
30
+ export declare function createEcoBuildPluginFromSourceTransform(transform: EcoSourceTransform): EcoBuildPlugin;
31
+ /**
32
+ * Adapts a source transform into a Vite-compatible plugin object.
33
+ *
34
+ * @remarks
35
+ * This intentionally returns a plain object shape so core does not need a hard
36
+ * dependency on `vite` just to author transform primitives.
37
+ */
38
+ export declare function createVitePluginFromSourceTransform(transform: EcoSourceTransform): EcoViteCompatiblePlugin;
39
+ /**
40
+ * Returns the app-owned source transforms in stable registration order.
41
+ */
42
+ export declare function getAppSourceTransforms(appConfig: EcoPagesAppConfig): EcoSourceTransform[];
43
+ /**
44
+ * Adapts the app-owned source transforms into Vite-compatible plugin objects.
45
+ */
46
+ export declare function createVitePluginsFromAppSourceTransforms(appConfig: EcoPagesAppConfig): EcoViteCompatiblePlugin[];
@@ -0,0 +1,71 @@
1
+ import path from "node:path";
2
+ import { fileSystem } from "@ecopages/file-system";
3
+ function normalizeTransformId(id) {
4
+ const queryIndex = id.indexOf("?");
5
+ const hashIndex = id.indexOf("#");
6
+ const endIndex = [queryIndex, hashIndex].filter((index) => index >= 0).sort((left, right) => left - right)[0];
7
+ return endIndex === void 0 ? id : id.slice(0, endIndex);
8
+ }
9
+ function applySourceTransform(transform, code, id) {
10
+ const normalizedId = normalizeTransformId(id);
11
+ if (!transform.filter.test(normalizedId)) {
12
+ return void 0;
13
+ }
14
+ return transform.transform(code, normalizedId);
15
+ }
16
+ function inferLoaderFromPath(filePath) {
17
+ const extension = path.extname(filePath).toLowerCase();
18
+ switch (extension) {
19
+ case ".ts":
20
+ return "ts";
21
+ case ".tsx":
22
+ return "tsx";
23
+ case ".jsx":
24
+ return "jsx";
25
+ default:
26
+ return "js";
27
+ }
28
+ }
29
+ function createEcoBuildPluginFromSourceTransform(transform) {
30
+ return {
31
+ name: transform.name,
32
+ setup(build) {
33
+ build.onLoad({ filter: transform.filter }, (args) => {
34
+ const filePath = normalizeTransformId(args.path);
35
+ const code = fileSystem.readFileSync(filePath);
36
+ const result = applySourceTransform(transform, code, filePath);
37
+ if (!result) {
38
+ return void 0;
39
+ }
40
+ return {
41
+ contents: typeof result === "string" ? result : result.code,
42
+ loader: inferLoaderFromPath(filePath),
43
+ resolveDir: path.dirname(filePath)
44
+ };
45
+ });
46
+ }
47
+ };
48
+ }
49
+ function createVitePluginFromSourceTransform(transform) {
50
+ return {
51
+ name: transform.name,
52
+ enforce: transform.enforce,
53
+ transform(code, id) {
54
+ return applySourceTransform(transform, code, id);
55
+ }
56
+ };
57
+ }
58
+ function getAppSourceTransforms(appConfig) {
59
+ return Array.from(appConfig.sourceTransforms.values());
60
+ }
61
+ function createVitePluginsFromAppSourceTransforms(appConfig) {
62
+ return getAppSourceTransforms(appConfig).map((transform) => createVitePluginFromSourceTransform(transform));
63
+ }
64
+ export {
65
+ applySourceTransform,
66
+ createEcoBuildPluginFromSourceTransform,
67
+ createVitePluginFromSourceTransform,
68
+ createVitePluginsFromAppSourceTransforms,
69
+ getAppSourceTransforms,
70
+ normalizeTransformId
71
+ };
@@ -0,0 +1,89 @@
1
+ import type { EcoComponent } from '../../types/public-types.js';
2
+ /**
3
+ * Result returned by a renderer-owned foreign-child runtime.
4
+ *
5
+ * `inline` keeps rendering inside the current integration. `resolved` returns a
6
+ * renderer-owned value immediately, which can be final HTML or a renderer-local
7
+ * transport token for later queue resolution.
8
+ */
9
+ export type ForeignChildInterceptionResult = {
10
+ kind: 'inline';
11
+ } | {
12
+ kind: 'resolved';
13
+ value: unknown;
14
+ };
15
+ /**
16
+ * Foreign-child metadata passed into the active renderer-owned runtime.
17
+ */
18
+ export type ForeignChildInterceptionInput = {
19
+ currentIntegration: string;
20
+ targetIntegration?: string;
21
+ component: EcoComponent;
22
+ props: Record<string, unknown>;
23
+ };
24
+ /**
25
+ * Narrow renderer-owned foreign-child runtime injected into one active render
26
+ * context.
27
+ *
28
+ * Integrations implement this contract when foreign children must be handed
29
+ * off inside the renderer instead of being left for route-level reconciliation.
30
+ */
31
+ export interface ForeignChildRuntime {
32
+ /**
33
+ * Intercepts one foreign child during an active render.
34
+ *
35
+ * This runtime is typically installed by the Foreign Subtree execution module,
36
+ * which decides whether the child stays inline or leaves the current renderer.
37
+ */
38
+ interceptForeignChild?(input: ForeignChildInterceptionInput): ForeignChildInterceptionResult | Promise<ForeignChildInterceptionResult>;
39
+ interceptForeignChildSync?(input: ForeignChildInterceptionInput): ForeignChildInterceptionResult;
40
+ }
41
+ type ForeignChildRenderInput = {
42
+ component: EcoComponent;
43
+ props: Record<string, unknown>;
44
+ targetIntegration?: string;
45
+ };
46
+ /**
47
+ * Per-render mutable state used while applying foreign-child interception and lazy
48
+ * output wrapping.
49
+ */
50
+ export type ComponentRenderContext = {
51
+ currentIntegration: string;
52
+ foreignChildRuntime?: ForeignChildRuntime;
53
+ interceptForeignChild(input: ForeignChildRenderInput): Promise<unknown | undefined> | unknown | undefined;
54
+ finalizeComponentRender<T>(component: EcoComponent, content: T): T;
55
+ };
56
+ /**
57
+ * Returns the current component render context, if one is active.
58
+ *
59
+ * @returns Active render context or `undefined` outside render execution.
60
+ */
61
+ export declare function getComponentRenderContext(): ComponentRenderContext | undefined;
62
+ /**
63
+ * Runs foreign-child interception for one component render step.
64
+ *
65
+ * The active runtime may resolve the foreign child immediately or keep it inline.
66
+ */
67
+ export declare function interceptForeignChild(input: ForeignChildRenderInput): Promise<unknown | undefined> | unknown | undefined;
68
+ /**
69
+ * Applies lazy trigger or injector wrapping to completed component output.
70
+ *
71
+ * This helper works both inside render-context execution and in fallback flows
72
+ * where no active context exists.
73
+ */
74
+ export declare function finalizeComponentRender<T>(component: EcoComponent, content: T): T;
75
+ /**
76
+ * Runs render work under a fresh component render context and returns the
77
+ * resulting value.
78
+ *
79
+ * @param input Execution metadata for current integration and foreign-child policy.
80
+ * @param render Async render function to execute inside the context.
81
+ * @returns Render result value.
82
+ */
83
+ export declare function runWithComponentRenderContext<T>(input: {
84
+ currentIntegration: string;
85
+ foreignChildRuntime?: ForeignChildRuntime;
86
+ }, render: () => Promise<T>): Promise<{
87
+ value: T;
88
+ }>;
89
+ export {};