@ecopages/core 0.2.0-alpha.24 → 0.2.0-alpha.26

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 (543) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/package.json +226 -93
  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 +52 -0
  12. package/src/adapters/bun/create-app.js +116 -0
  13. package/src/adapters/bun/hmr-manager.d.ts +143 -0
  14. package/src/adapters/bun/hmr-manager.js +333 -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 +374 -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 +133 -0
  30. package/src/adapters/node/node-hmr-manager.js +311 -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-route-matcher.d.ts +38 -0
  42. package/src/adapters/shared/explicit-static-route-matcher.js +103 -0
  43. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +65 -0
  44. package/src/adapters/shared/file-route-middleware-pipeline.js +99 -0
  45. package/src/adapters/shared/fs-server-response-factory.d.ts +19 -0
  46. package/src/adapters/shared/fs-server-response-factory.js +97 -0
  47. package/src/adapters/shared/fs-server-response-matcher.d.ts +67 -0
  48. package/src/adapters/shared/fs-server-response-matcher.js +147 -0
  49. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  50. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  51. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  52. package/src/adapters/shared/hmr-html-response.js +32 -0
  53. package/src/adapters/shared/render-context.d.ts +15 -0
  54. package/src/adapters/shared/render-context.js +72 -0
  55. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  56. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  57. package/src/adapters/shared/server-adapter.d.ts +97 -0
  58. package/src/adapters/shared/server-adapter.js +390 -0
  59. package/src/adapters/shared/server-route-handler.d.ts +89 -0
  60. package/src/adapters/shared/server-route-handler.js +111 -0
  61. package/src/adapters/shared/server-static-builder.d.ts +71 -0
  62. package/src/adapters/shared/server-static-builder.js +100 -0
  63. package/src/build/build-adapter.d.ts +239 -0
  64. package/src/build/build-adapter.js +642 -0
  65. package/src/build/build-manifest.d.ts +27 -0
  66. package/src/build/build-manifest.js +30 -0
  67. package/src/build/build-types.d.ts +57 -0
  68. package/src/build/build-types.js +0 -0
  69. package/src/build/dev-build-coordinator.d.ts +72 -0
  70. package/src/build/dev-build-coordinator.js +154 -0
  71. package/src/build/esbuild-build-adapter.d.ts +78 -0
  72. package/src/build/esbuild-build-adapter.js +505 -0
  73. package/src/build/runtime-build-executor.d.ts +14 -0
  74. package/src/build/runtime-build-executor.js +22 -0
  75. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  76. package/src/build/runtime-specifier-alias-plugin.js +35 -0
  77. package/src/build/runtime-specifier-aliases.d.ts +5 -0
  78. package/src/build/runtime-specifier-aliases.js +95 -0
  79. package/src/config/config-builder.d.ts +252 -0
  80. package/src/config/config-builder.js +603 -0
  81. package/src/config/{constants.ts → constants.d.ts} +13 -22
  82. package/src/config/constants.js +25 -0
  83. package/src/dev/sc-server.d.ts +30 -0
  84. package/src/dev/sc-server.js +111 -0
  85. package/src/eco/eco.browser.d.ts +2 -0
  86. package/src/eco/eco.browser.js +83 -0
  87. package/src/eco/eco.d.ts +9 -0
  88. package/src/eco/eco.js +85 -0
  89. package/src/eco/eco.types.d.ts +178 -0
  90. package/src/eco/eco.types.js +0 -0
  91. package/src/eco/eco.utils.d.ts +1 -0
  92. package/src/eco/eco.utils.js +10 -0
  93. package/src/eco/global-injector-map.d.ts +16 -0
  94. package/src/eco/global-injector-map.js +80 -0
  95. package/src/eco/lazy-injector-map.d.ts +8 -0
  96. package/src/eco/lazy-injector-map.js +70 -0
  97. package/src/eco/module-dependencies.d.ts +18 -0
  98. package/src/eco/module-dependencies.js +49 -0
  99. package/src/errors/http-error.d.ts +31 -0
  100. package/src/errors/http-error.js +50 -0
  101. package/src/errors/{index.ts → index.d.ts} +2 -2
  102. package/src/errors/index.js +4 -0
  103. package/src/errors/locals-access-error.d.ts +4 -0
  104. package/src/errors/locals-access-error.js +9 -0
  105. package/src/global/app-logger.d.ts +2 -0
  106. package/src/global/app-logger.js +6 -0
  107. package/src/hmr/client/hmr-runtime.d.ts +5 -0
  108. package/src/hmr/client/hmr-runtime.js +117 -0
  109. package/src/hmr/hmr-strategy.d.ts +162 -0
  110. package/src/hmr/hmr-strategy.js +44 -0
  111. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  112. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  113. package/src/hmr/hmr.test.e2e.d.ts +1 -0
  114. package/src/hmr/hmr.test.e2e.js +43 -0
  115. package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
  116. package/src/hmr/strategies/default-hmr-strategy.js +34 -0
  117. package/src/hmr/strategies/js-hmr-strategy.d.ts +139 -0
  118. package/src/hmr/strategies/js-hmr-strategy.js +178 -0
  119. package/src/index.browser.d.ts +3 -0
  120. package/src/index.browser.js +4 -0
  121. package/src/index.d.ts +6 -0
  122. package/src/index.js +21 -0
  123. package/src/integrations/ghtml/ghtml-renderer.d.ts +20 -0
  124. package/src/integrations/ghtml/ghtml-renderer.js +63 -0
  125. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  126. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  127. package/src/integrations/ghtml/ghtml.plugin.d.ts +16 -0
  128. package/src/integrations/ghtml/ghtml.plugin.js +20 -0
  129. package/src/plugins/alias-resolver-plugin.d.ts +2 -0
  130. package/src/plugins/alias-resolver-plugin.js +53 -0
  131. package/src/plugins/eco-component-meta-plugin.d.ts +108 -0
  132. package/src/plugins/eco-component-meta-plugin.js +163 -0
  133. package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
  134. package/src/plugins/foreign-jsx-override-plugin.js +35 -0
  135. package/src/plugins/integration-plugin.d.ts +219 -0
  136. package/src/plugins/integration-plugin.js +196 -0
  137. package/src/plugins/processor.d.ts +95 -0
  138. package/src/plugins/processor.js +136 -0
  139. package/src/plugins/{runtime-capability.ts → runtime-capability.d.ts} +3 -8
  140. package/src/plugins/runtime-capability.js +0 -0
  141. package/src/plugins/source-transform.d.ts +46 -0
  142. package/src/plugins/source-transform.js +71 -0
  143. package/src/route-renderer/orchestration/boundary-planning.service.d.ts +25 -0
  144. package/src/route-renderer/orchestration/boundary-planning.service.js +97 -0
  145. package/src/route-renderer/orchestration/component-render-context.d.ts +83 -0
  146. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  147. package/src/route-renderer/orchestration/integration-renderer.d.ts +556 -0
  148. package/src/route-renderer/orchestration/integration-renderer.js +932 -0
  149. package/src/route-renderer/orchestration/page-packaging.service.d.ts +16 -0
  150. package/src/route-renderer/orchestration/page-packaging.service.js +66 -0
  151. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +2 -0
  152. package/src/route-renderer/orchestration/processed-asset-dedupe.js +23 -0
  153. package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +89 -0
  154. package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +155 -0
  155. package/src/route-renderer/orchestration/render-execution.service.d.ts +43 -0
  156. package/src/route-renderer/orchestration/render-execution.service.js +106 -0
  157. package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
  158. package/src/route-renderer/orchestration/render-output.utils.js +171 -0
  159. package/src/route-renderer/orchestration/render-preparation.service.d.ts +120 -0
  160. package/src/route-renderer/orchestration/render-preparation.service.js +364 -0
  161. package/src/route-renderer/orchestration/route-shell-composer.service.d.ts +50 -0
  162. package/src/route-renderer/orchestration/route-shell-composer.service.js +81 -0
  163. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  164. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  165. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
  166. package/src/route-renderer/page-loading/component-dependency-collection.js +125 -0
  167. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
  168. package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
  169. package/src/route-renderer/page-loading/dependency-resolver.d.ts +35 -0
  170. package/src/route-renderer/page-loading/dependency-resolver.js +117 -0
  171. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
  172. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
  173. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
  174. package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
  175. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
  176. package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
  177. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
  178. package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
  179. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
  180. package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
  181. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
  182. package/src/route-renderer/page-loading/page-dependency-bundling.js +115 -0
  183. package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
  184. package/src/route-renderer/page-loading/page-module-loader.js +127 -0
  185. package/src/route-renderer/route-renderer.d.ts +67 -0
  186. package/src/route-renderer/route-renderer.js +103 -0
  187. package/src/router/client/link-intent.js +34 -0
  188. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  189. package/src/router/client/link-intent.test.browser.js +43 -0
  190. package/src/router/client/navigation-coordinator.d.ts +169 -0
  191. package/src/router/client/navigation-coordinator.js +215 -0
  192. package/src/router/server/fs-router-scanner.d.ts +41 -0
  193. package/src/router/server/fs-router-scanner.js +161 -0
  194. package/src/router/server/fs-router.d.ts +26 -0
  195. package/src/router/server/fs-router.js +100 -0
  196. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
  197. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
  198. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +103 -0
  199. package/src/services/assets/asset-processing-service/asset-processing.service.js +285 -0
  200. package/src/services/assets/asset-processing-service/asset.factory.d.ts +17 -0
  201. package/src/services/assets/asset-processing-service/asset.factory.js +82 -0
  202. package/src/services/assets/asset-processing-service/assets.types.d.ts +100 -0
  203. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  204. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  205. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +49 -0
  206. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  207. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  208. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
  209. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
  210. package/src/services/assets/asset-processing-service/index.d.ts +5 -0
  211. package/src/services/assets/asset-processing-service/index.js +5 -0
  212. package/src/services/assets/asset-processing-service/{processor.interface.ts → processor.interface.d.ts} +5 -10
  213. package/src/services/assets/asset-processing-service/processor.interface.js +6 -0
  214. package/src/services/assets/asset-processing-service/processor.registry.d.ts +8 -0
  215. package/src/services/assets/asset-processing-service/processor.registry.js +15 -0
  216. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +24 -0
  217. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +65 -0
  218. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +22 -0
  219. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +136 -0
  220. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  221. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  222. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +6 -0
  223. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +116 -0
  224. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +9 -0
  225. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +91 -0
  226. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
  227. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +77 -0
  228. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +8 -0
  229. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +58 -0
  230. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
  231. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +67 -0
  232. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
  233. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
  234. package/src/services/assets/browser-bundle.service.d.ts +73 -0
  235. package/src/services/assets/browser-bundle.service.js +41 -0
  236. package/src/services/cache/cache.types.d.ts +107 -0
  237. package/src/services/cache/cache.types.js +0 -0
  238. package/src/services/cache/index.d.ts +7 -0
  239. package/src/services/cache/index.js +7 -0
  240. package/src/services/cache/memory-cache-store.d.ts +42 -0
  241. package/src/services/cache/memory-cache-store.js +98 -0
  242. package/src/services/cache/page-cache-service.d.ts +70 -0
  243. package/src/services/cache/page-cache-service.js +152 -0
  244. package/src/services/cache/page-request-cache-coordinator.service.d.ts +75 -0
  245. package/src/services/cache/page-request-cache-coordinator.service.js +109 -0
  246. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  247. package/src/services/html/html-rewriter-provider.service.js +68 -0
  248. package/src/services/html/html-transformer.service.d.ts +87 -0
  249. package/src/services/html/html-transformer.service.js +216 -0
  250. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  251. package/src/services/invalidation/development-invalidation.service.js +190 -0
  252. package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
  253. package/src/services/module-loading/app-module-loader.service.js +0 -0
  254. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
  255. package/src/services/module-loading/app-server-module-transpiler.service.js +115 -0
  256. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  257. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  258. package/src/services/module-loading/{module-loading-types.ts → module-loading-types.d.ts} +0 -1
  259. package/src/services/module-loading/module-loading-types.js +0 -0
  260. package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
  261. package/src/services/module-loading/node-bootstrap-plugin.js +204 -0
  262. package/src/services/module-loading/page-module-import.service.d.ts +76 -0
  263. package/src/services/module-loading/page-module-import.service.js +170 -0
  264. package/src/services/module-loading/server-module-transpiler.service.d.ts +63 -0
  265. package/src/services/module-loading/server-module-transpiler.service.js +64 -0
  266. package/src/services/module-loading/source-module-support.d.ts +5 -0
  267. package/src/services/module-loading/source-module-support.js +8 -0
  268. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  269. package/src/services/runtime-state/dev-graph.service.js +162 -0
  270. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  271. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  272. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +69 -0
  273. package/src/services/runtime-state/runtime-specifier-registry.service.js +37 -0
  274. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  275. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  276. package/src/services/validation/schema-validation-service.d.ts +122 -0
  277. package/src/services/validation/schema-validation-service.js +101 -0
  278. package/src/services/validation/{standard-schema.types.ts → standard-schema.types.d.ts} +17 -20
  279. package/src/services/validation/standard-schema.types.js +0 -0
  280. package/src/static-site-generator/static-site-generator.d.ts +105 -0
  281. package/src/static-site-generator/static-site-generator.js +349 -0
  282. package/src/types/internal-types.d.ts +231 -0
  283. package/src/types/internal-types.js +0 -0
  284. package/src/types/public-types.d.ts +1257 -0
  285. package/src/types/public-types.js +0 -0
  286. package/src/utils/deep-merge.d.ts +14 -0
  287. package/src/utils/deep-merge.js +32 -0
  288. package/src/utils/hash.d.ts +1 -0
  289. package/src/utils/hash.js +7 -0
  290. package/src/utils/html-escaping.d.ts +7 -0
  291. package/src/utils/html-escaping.js +6 -0
  292. package/src/utils/html.js +4 -0
  293. package/src/utils/invariant.d.ts +5 -0
  294. package/src/utils/invariant.js +11 -0
  295. package/src/utils/locals-utils.d.ts +15 -0
  296. package/src/utils/locals-utils.js +24 -0
  297. package/src/utils/parse-cli-args.d.ts +27 -0
  298. package/src/utils/parse-cli-args.js +62 -0
  299. package/src/utils/path-utils.module.d.ts +5 -0
  300. package/src/utils/path-utils.module.js +14 -0
  301. package/src/utils/resolve-work-dir.d.ts +11 -0
  302. package/src/utils/resolve-work-dir.js +31 -0
  303. package/src/utils/runtime.d.ts +11 -0
  304. package/src/utils/runtime.js +40 -0
  305. package/src/utils/server-utils.module.d.ts +19 -0
  306. package/src/utils/server-utils.module.js +56 -0
  307. package/src/watchers/project-watcher.d.ts +136 -0
  308. package/src/watchers/project-watcher.js +275 -0
  309. package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
  310. package/src/watchers/project-watcher.test-helpers.js +52 -0
  311. package/src/adapters/abstract/application-adapter.test.ts +0 -172
  312. package/src/adapters/abstract/application-adapter.ts +0 -379
  313. package/src/adapters/abstract/router-adapter.ts +0 -30
  314. package/src/adapters/abstract/server-adapter.ts +0 -79
  315. package/src/adapters/bun/client-bridge.ts +0 -62
  316. package/src/adapters/bun/create-app.ts +0 -180
  317. package/src/adapters/bun/hmr-manager.test.ts +0 -267
  318. package/src/adapters/bun/hmr-manager.ts +0 -406
  319. package/src/adapters/bun/index.ts +0 -2
  320. package/src/adapters/bun/server-adapter.ts +0 -500
  321. package/src/adapters/bun/server-lifecycle.ts +0 -124
  322. package/src/adapters/create-app.test.ts +0 -10
  323. package/src/adapters/create-app.ts +0 -91
  324. package/src/adapters/index.ts +0 -2
  325. package/src/adapters/node/create-app.test.ts +0 -53
  326. package/src/adapters/node/create-app.ts +0 -183
  327. package/src/adapters/node/node-client-bridge.test.ts +0 -198
  328. package/src/adapters/node/node-client-bridge.ts +0 -79
  329. package/src/adapters/node/node-hmr-manager.test.ts +0 -322
  330. package/src/adapters/node/node-hmr-manager.ts +0 -378
  331. package/src/adapters/node/server-adapter.ts +0 -502
  332. package/src/adapters/node/static-content-server.test.ts +0 -60
  333. package/src/adapters/node/static-content-server.ts +0 -239
  334. package/src/adapters/shared/api-response.test.ts +0 -97
  335. package/src/adapters/shared/api-response.ts +0 -104
  336. package/src/adapters/shared/application-adapter.ts +0 -199
  337. package/src/adapters/shared/define-api-handler.ts +0 -66
  338. package/src/adapters/shared/explicit-static-route-matcher.test.ts +0 -381
  339. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -140
  340. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +0 -90
  341. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -127
  342. package/src/adapters/shared/fs-server-response-factory.test.ts +0 -187
  343. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  344. package/src/adapters/shared/fs-server-response-matcher.test.ts +0 -285
  345. package/src/adapters/shared/fs-server-response-matcher.ts +0 -189
  346. package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
  347. package/src/adapters/shared/hmr-html-response.ts +0 -52
  348. package/src/adapters/shared/hmr-manager.contract.test.ts +0 -232
  349. package/src/adapters/shared/hmr-manager.dispatch.test.ts +0 -220
  350. package/src/adapters/shared/render-context.test.ts +0 -150
  351. package/src/adapters/shared/render-context.ts +0 -123
  352. package/src/adapters/shared/runtime-bootstrap.ts +0 -79
  353. package/src/adapters/shared/server-adapter.test.ts +0 -77
  354. package/src/adapters/shared/server-adapter.ts +0 -493
  355. package/src/adapters/shared/server-route-handler.test.ts +0 -110
  356. package/src/adapters/shared/server-route-handler.ts +0 -153
  357. package/src/adapters/shared/server-static-builder.test.ts +0 -338
  358. package/src/adapters/shared/server-static-builder.ts +0 -170
  359. package/src/build/build-adapter-serialization.test.ts +0 -281
  360. package/src/build/build-adapter.test.ts +0 -1240
  361. package/src/build/build-adapter.ts +0 -1012
  362. package/src/build/build-manifest.ts +0 -54
  363. package/src/build/build-types.ts +0 -83
  364. package/src/build/dev-build-coordinator.ts +0 -220
  365. package/src/build/esbuild-build-adapter.ts +0 -660
  366. package/src/build/runtime-build-executor.test.ts +0 -81
  367. package/src/build/runtime-build-executor.ts +0 -40
  368. package/src/build/runtime-specifier-alias-plugin.test.ts +0 -67
  369. package/src/build/runtime-specifier-alias-plugin.ts +0 -62
  370. package/src/build/runtime-specifier-aliases.ts +0 -135
  371. package/src/config/config-builder.test.ts +0 -443
  372. package/src/config/config-builder.ts +0 -742
  373. package/src/config/config-builder.typecheck.test.ts +0 -96
  374. package/src/dev/sc-server.ts +0 -143
  375. package/src/eco/eco.browser.test.ts +0 -43
  376. package/src/eco/eco.browser.ts +0 -118
  377. package/src/eco/eco.test.ts +0 -654
  378. package/src/eco/eco.ts +0 -205
  379. package/src/eco/eco.types.ts +0 -221
  380. package/src/eco/eco.utils.test.ts +0 -219
  381. package/src/eco/eco.utils.ts +0 -5
  382. package/src/eco/global-injector-map.test.ts +0 -42
  383. package/src/eco/global-injector-map.ts +0 -112
  384. package/src/eco/lazy-injector-map.test.ts +0 -66
  385. package/src/eco/lazy-injector-map.ts +0 -120
  386. package/src/eco/module-dependencies.test.ts +0 -30
  387. package/src/eco/module-dependencies.ts +0 -75
  388. package/src/errors/http-error.test.ts +0 -134
  389. package/src/errors/http-error.ts +0 -72
  390. package/src/errors/locals-access-error.ts +0 -7
  391. package/src/global/app-logger.ts +0 -4
  392. package/src/global/utils.test.ts +0 -12
  393. 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
  394. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  395. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  396. package/src/hmr/client/hmr-runtime.ts +0 -160
  397. package/src/hmr/hmr-strategy.test.ts +0 -124
  398. package/src/hmr/hmr-strategy.ts +0 -177
  399. package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
  400. package/src/hmr/hmr.test.e2e.ts +0 -66
  401. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  402. package/src/hmr/strategies/js-hmr-strategy.test.ts +0 -335
  403. package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
  404. package/src/index.browser.ts +0 -3
  405. package/src/index.ts +0 -15
  406. package/src/integrations/ghtml/ghtml-renderer.test.ts +0 -253
  407. package/src/integrations/ghtml/ghtml-renderer.ts +0 -97
  408. package/src/integrations/ghtml/ghtml.constants.ts +0 -1
  409. package/src/integrations/ghtml/ghtml.plugin.ts +0 -28
  410. package/src/plugins/alias-resolver-plugin.test.ts +0 -41
  411. package/src/plugins/alias-resolver-plugin.ts +0 -63
  412. package/src/plugins/eco-component-meta-plugin.test.ts +0 -406
  413. package/src/plugins/eco-component-meta-plugin.ts +0 -495
  414. package/src/plugins/foreign-jsx-override-plugin.test.ts +0 -65
  415. package/src/plugins/foreign-jsx-override-plugin.ts +0 -67
  416. package/src/plugins/integration-plugin.test.ts +0 -156
  417. package/src/plugins/integration-plugin.ts +0 -311
  418. package/src/plugins/processor.test.ts +0 -148
  419. package/src/plugins/processor.ts +0 -240
  420. package/src/plugins/source-transform.test.ts +0 -82
  421. package/src/plugins/source-transform.ts +0 -123
  422. package/src/route-renderer/orchestration/boundary-planning.service.ts +0 -146
  423. package/src/route-renderer/orchestration/component-render-context.ts +0 -318
  424. package/src/route-renderer/orchestration/integration-renderer.test.ts +0 -2088
  425. package/src/route-renderer/orchestration/integration-renderer.ts +0 -1285
  426. package/src/route-renderer/orchestration/page-packaging.service.test.ts +0 -76
  427. package/src/route-renderer/orchestration/page-packaging.service.ts +0 -85
  428. package/src/route-renderer/orchestration/processed-asset-dedupe.ts +0 -25
  429. package/src/route-renderer/orchestration/queued-boundary-runtime.service.test.ts +0 -319
  430. package/src/route-renderer/orchestration/queued-boundary-runtime.service.ts +0 -289
  431. package/src/route-renderer/orchestration/render-execution.service.test.ts +0 -196
  432. package/src/route-renderer/orchestration/render-execution.service.ts +0 -182
  433. package/src/route-renderer/orchestration/render-output.utils.ts +0 -302
  434. package/src/route-renderer/orchestration/render-preparation.service.test.ts +0 -569
  435. package/src/route-renderer/orchestration/render-preparation.service.ts +0 -508
  436. package/src/route-renderer/orchestration/route-shell-composer.service.ts +0 -162
  437. package/src/route-renderer/orchestration/template-serialization.test.ts +0 -110
  438. package/src/route-renderer/orchestration/template-serialization.ts +0 -117
  439. package/src/route-renderer/page-loading/component-dependency-collection.ts +0 -196
  440. package/src/route-renderer/page-loading/declared-asset-collection.ts +0 -156
  441. package/src/route-renderer/page-loading/dependency-resolver.test.ts +0 -665
  442. package/src/route-renderer/page-loading/dependency-resolver.ts +0 -150
  443. package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +0 -75
  444. package/src/route-renderer/page-loading/lazy-entry-collection.ts +0 -167
  445. package/src/route-renderer/page-loading/lazy-trigger-planning.ts +0 -74
  446. package/src/route-renderer/page-loading/module-declaration-aggregation.ts +0 -60
  447. package/src/route-renderer/page-loading/module-declaration-scripts.ts +0 -16
  448. package/src/route-renderer/page-loading/page-dependency-bundling.ts +0 -205
  449. package/src/route-renderer/page-loading/page-module-loader.test.ts +0 -183
  450. package/src/route-renderer/page-loading/page-module-loader.ts +0 -184
  451. package/src/route-renderer/route-renderer.ts +0 -136
  452. package/src/router/client/link-intent.test.browser.ts +0 -51
  453. package/src/router/client/link-intent.ts +0 -92
  454. package/src/router/client/navigation-coordinator.test.ts +0 -237
  455. package/src/router/client/navigation-coordinator.ts +0 -453
  456. package/src/router/server/fs-router-scanner.test.ts +0 -83
  457. package/src/router/server/fs-router-scanner.ts +0 -224
  458. package/src/router/server/fs-router.test.ts +0 -214
  459. package/src/router/server/fs-router.ts +0 -122
  460. package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +0 -66
  461. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +0 -476
  462. package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -345
  463. package/src/services/assets/asset-processing-service/asset.factory.test.ts +0 -63
  464. package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
  465. package/src/services/assets/asset-processing-service/assets.types.ts +0 -125
  466. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +0 -74
  467. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -96
  468. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +0 -67
  469. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
  470. package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +0 -104
  471. package/src/services/assets/asset-processing-service/index.ts +0 -5
  472. package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
  473. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +0 -59
  474. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -83
  475. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -174
  476. package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
  477. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +0 -192
  478. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -134
  479. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +0 -326
  480. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -110
  481. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +0 -227
  482. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -87
  483. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +0 -261
  484. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -71
  485. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -81
  486. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +0 -65
  487. package/src/services/assets/browser-bundle.service.test.ts +0 -66
  488. package/src/services/assets/browser-bundle.service.ts +0 -109
  489. package/src/services/cache/cache.types.ts +0 -126
  490. package/src/services/cache/index.ts +0 -18
  491. package/src/services/cache/memory-cache-store.test.ts +0 -225
  492. package/src/services/cache/memory-cache-store.ts +0 -130
  493. package/src/services/cache/page-cache-service.test.ts +0 -175
  494. package/src/services/cache/page-cache-service.ts +0 -202
  495. package/src/services/cache/page-request-cache-coordinator.service.test.ts +0 -79
  496. package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
  497. package/src/services/html/html-rewriter-provider.service.test.ts +0 -183
  498. package/src/services/html/html-rewriter-provider.service.ts +0 -104
  499. package/src/services/html/html-transformer.service.test.ts +0 -479
  500. package/src/services/html/html-transformer.service.ts +0 -275
  501. package/src/services/invalidation/development-invalidation.service.test.ts +0 -87
  502. package/src/services/invalidation/development-invalidation.service.ts +0 -262
  503. package/src/services/module-loading/app-module-loader.service.ts +0 -9
  504. package/src/services/module-loading/app-server-module-transpiler.service.test.ts +0 -130
  505. package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -143
  506. package/src/services/module-loading/host-module-loader-registry.ts +0 -15
  507. package/src/services/module-loading/node-bootstrap-plugin.test.ts +0 -335
  508. package/src/services/module-loading/node-bootstrap-plugin.ts +0 -297
  509. package/src/services/module-loading/page-module-import.service.test.ts +0 -504
  510. package/src/services/module-loading/page-module-import.service.ts +0 -252
  511. package/src/services/module-loading/server-module-transpiler.service.test.ts +0 -243
  512. package/src/services/module-loading/server-module-transpiler.service.ts +0 -104
  513. package/src/services/module-loading/source-module-support.ts +0 -19
  514. package/src/services/runtime-state/dev-graph.service.ts +0 -217
  515. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
  516. package/src/services/runtime-state/runtime-specifier-registry.service.ts +0 -96
  517. package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
  518. package/src/services/validation/schema-validation-service.test.ts +0 -223
  519. package/src/services/validation/schema-validation-service.ts +0 -204
  520. package/src/static-site-generator/static-site-generator.test.ts +0 -316
  521. package/src/static-site-generator/static-site-generator.ts +0 -462
  522. package/src/types/internal-types.ts +0 -242
  523. package/src/types/public-types.ts +0 -1443
  524. package/src/utils/deep-merge.test.ts +0 -114
  525. package/src/utils/deep-merge.ts +0 -47
  526. package/src/utils/hash.ts +0 -5
  527. package/src/utils/html-escaping.ts +0 -9
  528. package/src/utils/invariant.test.ts +0 -22
  529. package/src/utils/invariant.ts +0 -15
  530. package/src/utils/locals-utils.ts +0 -37
  531. package/src/utils/parse-cli-args.test.ts +0 -69
  532. package/src/utils/parse-cli-args.ts +0 -105
  533. package/src/utils/path-utils.module.ts +0 -14
  534. package/src/utils/path-utils.test.ts +0 -15
  535. package/src/utils/resolve-work-dir.ts +0 -45
  536. package/src/utils/runtime.ts +0 -44
  537. package/src/utils/server-utils.module.ts +0 -67
  538. package/src/utils/server-utils.test.ts +0 -38
  539. package/src/watchers/project-watcher.integration.test.ts +0 -337
  540. package/src/watchers/project-watcher.test-helpers.ts +0 -41
  541. package/src/watchers/project-watcher.test.ts +0 -768
  542. package/src/watchers/project-watcher.ts +0 -357
  543. /package/src/utils/{html.ts → html.d.ts} +0 -0
@@ -0,0 +1,603 @@
1
+ import path from "node:path";
2
+ import {
3
+ DEFAULT_ECOPAGES_DIST_DIR,
4
+ DEFAULT_ECOPAGES_HOSTNAME,
5
+ DEFAULT_ECOPAGES_PORT,
6
+ DEFAULT_ECOPAGES_WORK_DIR
7
+ } from "../config/constants.js";
8
+ import {
9
+ collectConfiguredAppBuildManifestContributions,
10
+ createBuildAdapter,
11
+ getAppServerBuildPlugins,
12
+ setAppBuildAdapter,
13
+ setAppBuildExecutor,
14
+ updateAppBuildManifest
15
+ } from "../build/build-adapter.js";
16
+ import { createAppBuildExecutor } from "../build/dev-build-coordinator.js";
17
+ import { GHTML_PLUGIN_NAME } from "../integrations/ghtml/ghtml.constants.js";
18
+ import { ghtmlPlugin } from "../integrations/ghtml/ghtml.plugin.js";
19
+ import { createEcoComponentMetaPlugin } from "../plugins/eco-component-meta-plugin.js";
20
+ import { createEcoComponentMetaTransform } from "../plugins/eco-component-meta-plugin.js";
21
+ import {
22
+ NoopEntrypointDependencyGraph,
23
+ setAppEntrypointDependencyGraph
24
+ } from "../services/runtime-state/entrypoint-dependency-graph.service.js";
25
+ import {
26
+ InMemoryRuntimeSpecifierRegistry,
27
+ setAppRuntimeSpecifierRegistry
28
+ } from "../services/runtime-state/runtime-specifier-registry.service.js";
29
+ import {
30
+ CounterServerInvalidationState,
31
+ setAppServerInvalidationState
32
+ } from "../services/runtime-state/server-invalidation-state.service.js";
33
+ import { invariant } from "../utils/invariant.js";
34
+ import { appLogger } from "../global/app-logger.js";
35
+ import { fileSystem } from "@ecopages/file-system";
36
+ const CONFIG_BUILDER_ERRORS = {
37
+ DUPLICATE_INTEGRATION_NAMES: "Integrations names must be unique",
38
+ DUPLICATE_INTEGRATION_EXTENSIONS: "Integrations extensions must be unique",
39
+ MIXED_JSX_ENGINES: "Both kitajs and react integrations are enabled. Use per-file JSX import source/pragma consistently (e.g. `/** @jsxImportSource react */` for React files and `/** @jsxImportSource @kitajs/html */` for Kita files).",
40
+ duplicateProcessorName: (name) => `Processor with name "${name}" already exists`,
41
+ duplicateLoaderName: (name) => `Loader with name "${name}" already exists`,
42
+ duplicateSemanticTemplate: (kind, matches) => `Multiple ${kind} templates found: ${matches.join(", ")}`,
43
+ incompatibleRuntimeCapability: (kind, name, runtime, reason) => `Cannot enable ${kind} "${name}" on ${runtime}: ${reason}`,
44
+ unsupportedRuntimeVersion: (kind, name, runtime, current, min) => `Cannot enable ${kind} "${name}" on ${runtime} ${current}: requires runtime version ${min} or newer`,
45
+ invalidRuntimeVersion: (kind, name, version) => `Cannot validate ${kind} "${name}" runtimeCapability.minRuntimeVersion "${version}" because it is not a dot-separated numeric version`
46
+ };
47
+ class ConfigBuilder {
48
+ buildOwnership = "bun-native";
49
+ config = {
50
+ baseUrl: "",
51
+ rootDir: ".",
52
+ srcDir: "src",
53
+ pagesDir: "pages",
54
+ includesDir: "includes",
55
+ componentsDir: "components",
56
+ layoutsDir: "layouts",
57
+ publicDir: "public",
58
+ robotsTxt: {
59
+ preferences: {
60
+ "*": []
61
+ }
62
+ },
63
+ integrations: [],
64
+ integrationsDependencies: [],
65
+ distDir: DEFAULT_ECOPAGES_DIST_DIR,
66
+ defaultMetadata: {
67
+ title: "Ecopages",
68
+ description: "This is a static site generated with Ecopages"
69
+ },
70
+ additionalWatchPaths: [],
71
+ templatesExt: [],
72
+ absolutePaths: {
73
+ config: "",
74
+ componentsDir: "",
75
+ distDir: "",
76
+ workDir: "",
77
+ includesDir: "",
78
+ layoutsDir: "",
79
+ pagesDir: "",
80
+ projectDir: "",
81
+ publicDir: "",
82
+ srcDir: "",
83
+ htmlTemplatePath: "",
84
+ error404TemplatePath: ""
85
+ },
86
+ processors: /* @__PURE__ */ new Map(),
87
+ loaders: /* @__PURE__ */ new Map(),
88
+ sourceTransforms: /* @__PURE__ */ new Map(),
89
+ workDir: DEFAULT_ECOPAGES_WORK_DIR
90
+ };
91
+ /**
92
+ * Sets the base URL for the application.
93
+ * This URL is used as the root URL for all pages and assets.
94
+ *
95
+ * @param baseUrl - The base URL for the application (e.g., 'https://example.com')
96
+ * @returns The ConfigBuilder instance for method chaining
97
+ */
98
+ setBaseUrl(baseUrl) {
99
+ this.config.baseUrl = baseUrl;
100
+ return this;
101
+ }
102
+ /**
103
+ * Sets the root directory of the project.
104
+ * This is the base directory from which all other paths are resolved.
105
+ *
106
+ * @param rootDir - The root directory path
107
+ * @returns The ConfigBuilder instance for method chaining
108
+ */
109
+ setRootDir(rootDir) {
110
+ this.config.rootDir = rootDir;
111
+ return this;
112
+ }
113
+ /**
114
+ * Sets which runtime path owns build execution for the finalized app config.
115
+ *
116
+ * @remarks
117
+ * Bun-native remains the default. Vite-host ownership should be selected only
118
+ * for host-driven compatibility flows where core must not silently fall back to
119
+ * Bun build execution.
120
+ */
121
+ setBuildOwnership(buildOwnership) {
122
+ this.buildOwnership = buildOwnership;
123
+ return this;
124
+ }
125
+ /**
126
+ * Sets the source directory relative to the root directory.
127
+ * This directory contains all the source files for the application.
128
+ *
129
+ * @param srcDir - The source directory name (default: 'src')
130
+ * @returns The ConfigBuilder instance for method chaining
131
+ */
132
+ setSrcDir(srcDir) {
133
+ this.config.srcDir = srcDir;
134
+ return this;
135
+ }
136
+ /**
137
+ * Sets the pages directory relative to the source directory.
138
+ * This directory contains all the page files for the application.
139
+ *
140
+ * @param pagesDir - The pages directory name (default: 'pages')
141
+ * @returns The ConfigBuilder instance for method chaining
142
+ */
143
+ setPagesDir(pagesDir) {
144
+ this.config.pagesDir = pagesDir;
145
+ return this;
146
+ }
147
+ /**
148
+ * Sets the includes directory relative to the source directory.
149
+ * This directory contains template includes and partials.
150
+ *
151
+ * @param includesDir - The includes directory name (default: 'includes')
152
+ * @returns The ConfigBuilder instance for method chaining
153
+ */
154
+ setIncludesDir(includesDir) {
155
+ this.config.includesDir = includesDir;
156
+ return this;
157
+ }
158
+ /**
159
+ * Sets the components directory relative to the source directory.
160
+ * This directory contains reusable components.
161
+ *
162
+ * @param componentsDir - The components directory name (default: 'components')
163
+ * @returns The ConfigBuilder instance for method chaining
164
+ */
165
+ setComponentsDir(componentsDir) {
166
+ this.config.componentsDir = componentsDir;
167
+ return this;
168
+ }
169
+ /**
170
+ * Sets the layouts directory relative to the source directory.
171
+ * This directory contains layout templates.
172
+ *
173
+ * @param layoutsDir - The layouts directory name (default: 'layouts')
174
+ * @returns The ConfigBuilder instance for method chaining
175
+ */
176
+ setLayoutsDir(layoutsDir) {
177
+ this.config.layoutsDir = layoutsDir;
178
+ return this;
179
+ }
180
+ /**
181
+ * Sets the public directory relative to the source directory.
182
+ * This directory contains static assets that should be served as-is.
183
+ *
184
+ * @param publicDir - The public directory name (default: 'public')
185
+ * @returns The ConfigBuilder instance for method chaining
186
+ */
187
+ setPublicDir(publicDir) {
188
+ this.config.publicDir = publicDir;
189
+ return this;
190
+ }
191
+ /**
192
+ * Sets the robots.txt configuration.
193
+ * This determines which paths are allowed/disallowed for search engines.
194
+ *
195
+ * @param robotsTxt - The robots.txt configuration object
196
+ * @returns The ConfigBuilder instance for method chaining
197
+ */
198
+ setRobotsTxt(robotsTxt) {
199
+ this.config.robotsTxt = robotsTxt;
200
+ return this;
201
+ }
202
+ /**
203
+ * Sets the integration plugins to use.
204
+ * These plugins provide additional functionality to the application.
205
+ *
206
+ * @param integrations - An array of integration plugins
207
+ * @returns The ConfigBuilder instance for method chaining
208
+ */
209
+ setIntegrations(integrations) {
210
+ this.config.integrations = integrations;
211
+ return this;
212
+ }
213
+ /**
214
+ * Sets the output directory for the built application.
215
+ *
216
+ * @param distDir - The distribution directory name (default: 'dist')
217
+ * @returns The ConfigBuilder instance for method chaining
218
+ */
219
+ setDistDir(distDir) {
220
+ this.config.distDir = distDir;
221
+ return this;
222
+ }
223
+ /**
224
+ * Sets the internal work directory for runtime-only artifacts.
225
+ *
226
+ * @remarks
227
+ * Use this when deployable output should stay clean while Ecopages still
228
+ * needs a separate workspace for server transpilation caches, runtime
229
+ * manifests, and other internal build products.
230
+ *
231
+ * @param workDir - The internal work directory name
232
+ * @returns The ConfigBuilder instance for method chaining
233
+ */
234
+ setWorkDir(workDir) {
235
+ this.config.workDir = workDir;
236
+ return this;
237
+ }
238
+ /**
239
+ * Sets the default metadata for pages.
240
+ * This is used when a page doesn't specify its own metadata.
241
+ *
242
+ * @param defaultMetadata - The default metadata object
243
+ * @returns The ConfigBuilder instance for method chaining
244
+ */
245
+ setDefaultMetadata(defaultMetadata) {
246
+ this.config.defaultMetadata = {
247
+ ...this.config.defaultMetadata,
248
+ ...defaultMetadata
249
+ };
250
+ return this;
251
+ }
252
+ /**
253
+ * Sets additional paths to watch for changes during development.
254
+ *
255
+ * @param additionalWatchPaths - An array of additional paths to watch
256
+ * @returns The ConfigBuilder instance for method chaining
257
+ */
258
+ setAdditionalWatchPaths(additionalWatchPaths) {
259
+ this.config.additionalWatchPaths = additionalWatchPaths;
260
+ return this;
261
+ }
262
+ /**
263
+ * Sets the processors to use for the application.
264
+ * This replaces any existing processors.
265
+ *
266
+ * @param processors - An array of processors
267
+ * @returns The ConfigBuilder instance for method chaining
268
+ */
269
+ setProcessors(processors) {
270
+ this.config.processors.clear();
271
+ for (const processor of processors) {
272
+ this.addProcessor(processor);
273
+ }
274
+ return this;
275
+ }
276
+ /**
277
+ * Adds a processor to the application.
278
+ *
279
+ * @param processor - The processor to add
280
+ * @returns The ConfigBuilder instance for method chaining
281
+ * @throws Error if a processor with the same name already exists
282
+ */
283
+ addProcessor(processor) {
284
+ if (this.config.processors.has(processor.name)) {
285
+ throw new Error(CONFIG_BUILDER_ERRORS.duplicateProcessorName(processor.name));
286
+ }
287
+ this.config.processors.set(processor.name, processor);
288
+ return this;
289
+ }
290
+ /**
291
+ * Sets the loaders to use for the application.
292
+ * This replaces any existing loaders.
293
+ *
294
+ * @param loaders - An array of build plugins to use as loaders
295
+ * @returns The ConfigBuilder instance for method chaining
296
+ */
297
+ setLoaders(loaders) {
298
+ this.config.loaders.clear();
299
+ for (const loader of loaders) {
300
+ this.addLoader(loader.name, loader);
301
+ }
302
+ return this;
303
+ }
304
+ /**
305
+ * Sets the source transforms to use for transform-first bundlers such as Vite.
306
+ * This replaces any existing source transforms.
307
+ */
308
+ setSourceTransforms(sourceTransforms) {
309
+ this.config.sourceTransforms.clear();
310
+ for (const sourceTransform of sourceTransforms) {
311
+ this.addSourceTransform(sourceTransform.name, sourceTransform);
312
+ }
313
+ return this;
314
+ }
315
+ /**
316
+ * Adds a loader to the application.
317
+ *
318
+ * @param name - The name of the loader
319
+ * @param loader - The build plugin to use as a loader
320
+ * @returns The ConfigBuilder instance for method chaining
321
+ * @throws Error if a loader with the same name already exists
322
+ */
323
+ addLoader(name, loader) {
324
+ if (this.config.loaders.has(name)) {
325
+ throw new Error(CONFIG_BUILDER_ERRORS.duplicateLoaderName(name));
326
+ }
327
+ this.config.loaders.set(name, loader);
328
+ return this;
329
+ }
330
+ /**
331
+ * Adds a source transform to the application.
332
+ *
333
+ * @throws Error if a source transform with the same name already exists.
334
+ */
335
+ addSourceTransform(name, sourceTransform) {
336
+ if (this.config.sourceTransforms.has(name)) {
337
+ throw new Error(CONFIG_BUILDER_ERRORS.duplicateLoaderName(name));
338
+ }
339
+ this.config.sourceTransforms.set(name, sourceTransform);
340
+ return this;
341
+ }
342
+ /**
343
+ * Sets the cache configuration for ISR and page caching.
344
+ *
345
+ * @param cacheConfig - The cache configuration object
346
+ * @returns The ConfigBuilder instance for method chaining
347
+ */
348
+ setCacheConfig(cacheConfig) {
349
+ this.config.cache = cacheConfig;
350
+ return this;
351
+ }
352
+ setExperimental(experimental) {
353
+ this.config.experimental = experimental;
354
+ return this;
355
+ }
356
+ createAbsolutePaths(config) {
357
+ const { srcDir, componentsDir, includesDir, layoutsDir, pagesDir, publicDir, distDir, workDir } = config;
358
+ const projectDir = config.rootDir;
359
+ const absoluteSrcDir = path.resolve(projectDir, srcDir);
360
+ const absoluteDistDir = path.resolve(projectDir, distDir);
361
+ const absoluteWorkDir = path.resolve(projectDir, workDir);
362
+ const absoluteIncludesDir = path.join(absoluteSrcDir, includesDir);
363
+ const absolutePagesDir = path.join(absoluteSrcDir, pagesDir);
364
+ this.config.absolutePaths = {
365
+ config: path.join(projectDir, "eco.config.ts"),
366
+ projectDir,
367
+ srcDir: absoluteSrcDir,
368
+ distDir: absoluteDistDir,
369
+ workDir: absoluteWorkDir,
370
+ componentsDir: path.join(absoluteSrcDir, componentsDir),
371
+ includesDir: absoluteIncludesDir,
372
+ layoutsDir: path.join(absoluteSrcDir, layoutsDir),
373
+ pagesDir: absolutePagesDir,
374
+ publicDir: path.join(absoluteSrcDir, publicDir),
375
+ htmlTemplatePath: this.resolveSemanticTemplatePath({
376
+ dirPath: absoluteIncludesDir,
377
+ basename: "html"
378
+ }),
379
+ error404TemplatePath: this.resolveSemanticTemplatePath({
380
+ dirPath: absolutePagesDir,
381
+ basename: "404"
382
+ })
383
+ };
384
+ return this;
385
+ }
386
+ resolveSemanticTemplatePath({ dirPath, basename }) {
387
+ const extensions = this.config.templatesExt.length > 0 ? this.config.templatesExt : [".ghtml.ts"];
388
+ const matches = extensions.map((extension) => path.join(dirPath, `${basename}${extension}`)).filter((candidate) => fileSystem.exists(candidate));
389
+ invariant(matches.length <= 1, CONFIG_BUILDER_ERRORS.duplicateSemanticTemplate(basename, matches));
390
+ if (matches.length === 1) {
391
+ return matches[0];
392
+ }
393
+ return path.join(dirPath, `${basename}${extensions[0]}`);
394
+ }
395
+ createIntegrationTemplatesExt(integrations) {
396
+ const integrationName = integrations.map((integration) => integration.name);
397
+ const uniqueName = new Set(integrationName);
398
+ invariant(integrationName.length === uniqueName.size, CONFIG_BUILDER_ERRORS.DUPLICATE_INTEGRATION_NAMES);
399
+ const hasKitaJs = uniqueName.has("kitajs");
400
+ const hasReact = uniqueName.has("react");
401
+ if (hasKitaJs && hasReact) {
402
+ appLogger.warn(CONFIG_BUILDER_ERRORS.MIXED_JSX_ENGINES);
403
+ }
404
+ const integrationsExtensions = integrations.flatMap((integration) => integration.extensions);
405
+ const uniqueExtensions = new Set(integrationsExtensions);
406
+ invariant(
407
+ integrationsExtensions.length === uniqueExtensions.size,
408
+ CONFIG_BUILDER_ERRORS.DUPLICATE_INTEGRATION_EXTENSIONS
409
+ );
410
+ this.config.templatesExt = integrationsExtensions;
411
+ }
412
+ initializeProcessors() {
413
+ for (const processor of this.config.processors.values()) {
414
+ processor.setContext(this.config);
415
+ }
416
+ }
417
+ validateRuntimeCapabilities() {
418
+ const runtimeEnvironment = this.detectRuntimeEnvironment();
419
+ const contributors = [
420
+ ...this.config.integrations.map((integration) => ({
421
+ kind: "integration",
422
+ name: integration.name,
423
+ runtimeCapability: integration.runtimeCapability
424
+ })),
425
+ ...Array.from(this.config.processors.values(), (processor) => ({
426
+ kind: "processor",
427
+ name: processor.name,
428
+ runtimeCapability: processor.runtimeCapability
429
+ }))
430
+ ];
431
+ for (const contributor of contributors) {
432
+ this.validateRuntimeCapability(contributor, runtimeEnvironment);
433
+ }
434
+ }
435
+ validateRuntimeCapability(contributor, environment) {
436
+ const declaration = contributor.runtimeCapability;
437
+ if (!declaration) {
438
+ return;
439
+ }
440
+ for (const tag of declaration.tags) {
441
+ if (environment.supportedTags.has(tag)) {
442
+ continue;
443
+ }
444
+ throw new Error(
445
+ CONFIG_BUILDER_ERRORS.incompatibleRuntimeCapability(
446
+ contributor.kind,
447
+ contributor.name,
448
+ environment.runtime,
449
+ this.describeUnsupportedRuntimeTag(tag)
450
+ )
451
+ );
452
+ }
453
+ if (!declaration.minRuntimeVersion) {
454
+ return;
455
+ }
456
+ const minVersion = this.parseVersion(declaration.minRuntimeVersion);
457
+ if (!minVersion) {
458
+ throw new Error(
459
+ CONFIG_BUILDER_ERRORS.invalidRuntimeVersion(
460
+ contributor.kind,
461
+ contributor.name,
462
+ declaration.minRuntimeVersion
463
+ )
464
+ );
465
+ }
466
+ const currentVersion = this.parseVersion(environment.version);
467
+ if (!currentVersion) {
468
+ return;
469
+ }
470
+ if (this.compareVersions(currentVersion, minVersion) >= 0) {
471
+ return;
472
+ }
473
+ throw new Error(
474
+ CONFIG_BUILDER_ERRORS.unsupportedRuntimeVersion(
475
+ contributor.kind,
476
+ contributor.name,
477
+ environment.runtime,
478
+ environment.version,
479
+ declaration.minRuntimeVersion
480
+ )
481
+ );
482
+ }
483
+ detectRuntimeEnvironment() {
484
+ const bunVersion = this.getBunVersion();
485
+ if (bunVersion) {
486
+ return {
487
+ runtime: "bun",
488
+ version: bunVersion,
489
+ supportedTags: /* @__PURE__ */ new Set([
490
+ "bun-only",
491
+ "node-compatible",
492
+ "requires-native-bun-api",
493
+ "requires-node-builtins"
494
+ ])
495
+ };
496
+ }
497
+ return {
498
+ runtime: "node",
499
+ version: process.versions.node,
500
+ supportedTags: /* @__PURE__ */ new Set(["node-compatible", "requires-node-builtins"])
501
+ };
502
+ }
503
+ getBunVersion() {
504
+ const bun = globalThis;
505
+ return typeof bun.Bun?.version === "string" ? bun.Bun.version : void 0;
506
+ }
507
+ describeUnsupportedRuntimeTag(tag) {
508
+ switch (tag) {
509
+ case "bun-only":
510
+ return "it is Bun-only";
511
+ case "requires-native-bun-api":
512
+ return "it requires the native Bun API";
513
+ case "requires-node-builtins":
514
+ return "it requires Node builtins";
515
+ case "node-compatible":
516
+ return "it requires a Node-compatible runtime";
517
+ }
518
+ }
519
+ parseVersion(version) {
520
+ const normalized = version.trim().replace(/^v/i, "");
521
+ if (!/^\d+(?:\.\d+)*$/.test(normalized)) {
522
+ return void 0;
523
+ }
524
+ return normalized.split(".").map((segment) => Number(segment));
525
+ }
526
+ compareVersions(left, right) {
527
+ const maxLength = Math.max(left.length, right.length);
528
+ for (let index = 0; index < maxLength; index += 1) {
529
+ const leftValue = left[index] ?? 0;
530
+ const rightValue = right[index] ?? 0;
531
+ if (leftValue > rightValue) {
532
+ return 1;
533
+ }
534
+ if (leftValue < rightValue) {
535
+ return -1;
536
+ }
537
+ }
538
+ return 0;
539
+ }
540
+ /**
541
+ * Initializes default loaders that are required for EcoPages to function.
542
+ * This includes the eco-component-meta-plugin which auto-injects __eco metadata into component configs.
543
+ */
544
+ async initializeDefaultLoaders() {
545
+ const componentMetaTransform = createEcoComponentMetaTransform({ config: this.config });
546
+ if (!this.config.sourceTransforms.has(componentMetaTransform.name)) {
547
+ this.config.sourceTransforms.set(componentMetaTransform.name, componentMetaTransform);
548
+ }
549
+ const componentMetaPlugin = createEcoComponentMetaPlugin({ config: this.config });
550
+ if (!this.config.loaders.has(componentMetaPlugin.name)) {
551
+ this.config.loaders.set(componentMetaPlugin.name, componentMetaPlugin);
552
+ }
553
+ }
554
+ reviewBaseUrl(baseUrl) {
555
+ if (baseUrl) {
556
+ this.config.baseUrl = baseUrl;
557
+ return;
558
+ }
559
+ const envBaseUrl = process.env.ECOPAGES_BASE_URL;
560
+ if (envBaseUrl) {
561
+ this.config.baseUrl = envBaseUrl;
562
+ } else if (!this.config.baseUrl) {
563
+ this.config.baseUrl = `http://${DEFAULT_ECOPAGES_HOSTNAME}:${DEFAULT_ECOPAGES_PORT}`;
564
+ }
565
+ }
566
+ /**
567
+ * Builds and returns the final configuration object.
568
+ * This performs validation and initialization of the configuration.
569
+ *
570
+ * @returns A promise that resolves to the final EcoPagesAppConfig
571
+ * @throws Error if required configuration is missing (e.g., baseUrl)
572
+ */
573
+ async build() {
574
+ this.reviewBaseUrl(this.config.baseUrl);
575
+ if (!this.config.integrations.some((integration) => integration.name === GHTML_PLUGIN_NAME)) {
576
+ this.config.integrations.push(ghtmlPlugin());
577
+ }
578
+ this.createIntegrationTemplatesExt(this.config.integrations);
579
+ this.createAbsolutePaths(this.config);
580
+ await this.initializeDefaultLoaders();
581
+ this.initializeProcessors();
582
+ this.validateRuntimeCapabilities();
583
+ const buildAdapter = createBuildAdapter({ ownership: this.buildOwnership });
584
+ setAppBuildAdapter(this.config, buildAdapter);
585
+ updateAppBuildManifest(this.config, await collectConfiguredAppBuildManifestContributions(this.config));
586
+ setAppServerInvalidationState(this.config, new CounterServerInvalidationState());
587
+ setAppEntrypointDependencyGraph(this.config, new NoopEntrypointDependencyGraph());
588
+ setAppRuntimeSpecifierRegistry(this.config, new InMemoryRuntimeSpecifierRegistry());
589
+ setAppBuildExecutor(
590
+ this.config,
591
+ createAppBuildExecutor({
592
+ development: false,
593
+ adapter: buildAdapter,
594
+ getPlugins: () => getAppServerBuildPlugins(this.config)
595
+ })
596
+ );
597
+ return this.config;
598
+ }
599
+ }
600
+ export {
601
+ CONFIG_BUILDER_ERRORS,
602
+ ConfigBuilder
603
+ };
@@ -2,47 +2,38 @@
2
2
  * This file contains constants used throughout the project.
3
3
  * @module constants
4
4
  **/
5
-
6
5
  /**
7
6
  * Collection of status messages used in the application.
8
7
  */
9
- export const STATUS_MESSAGE = {
10
- 404: '404 Not Found',
8
+ export declare const STATUS_MESSAGE: {
9
+ 404: string;
11
10
  };
12
-
13
11
  /**
14
12
  *Variables used to determine if the app is running on Bun
15
13
  */
16
- export const IS_BUN = typeof Bun !== 'undefined';
17
-
14
+ export declare const IS_BUN: boolean;
18
15
  /**
19
16
  * Directory used for storing assets.
20
17
  */
21
- export const RESOLVED_ASSETS_DIR = 'assets';
22
-
18
+ export declare const RESOLVED_ASSETS_DIR = "assets";
23
19
  /**
24
20
  * Directory used for storing vendor assets.
25
21
  * This is a subdirectory of the assets directory.
26
22
  */
27
- export const RESOLVED_ASSETS_VENDORS_DIR: string = `${RESOLVED_ASSETS_DIR}/vendors`;
28
-
23
+ export declare const RESOLVED_ASSETS_VENDORS_DIR: string;
29
24
  /**
30
25
  * Base paths for generated project files.
31
26
  */
32
- export const GENERATED_BASE_PATHS = {
33
- types: 'node_modules/@types',
34
- cache: 'cache',
35
- } as const;
36
-
37
- export const DEFAULT_ECOPAGES_PORT = 3000;
38
-
39
- export const DEFAULT_ECOPAGES_HOSTNAME = 'localhost';
40
-
27
+ export declare const GENERATED_BASE_PATHS: {
28
+ readonly types: "node_modules/@types";
29
+ readonly cache: "cache";
30
+ };
31
+ export declare const DEFAULT_ECOPAGES_PORT = 3000;
32
+ export declare const DEFAULT_ECOPAGES_HOSTNAME = "localhost";
41
33
  /**
42
34
  * Default directory used for deployable output.
43
35
  */
44
- export const DEFAULT_ECOPAGES_DIST_DIR = 'dist';
45
-
36
+ export declare const DEFAULT_ECOPAGES_DIST_DIR = "dist";
46
37
  /**
47
38
  * Default internal working directory used for runtime-only artifacts.
48
39
  *
@@ -51,4 +42,4 @@ export const DEFAULT_ECOPAGES_DIST_DIR = 'dist';
51
42
  * It owns transpiled server modules, runtime manifests, and processor caches
52
43
  * so the export directory can remain a clean deployable tree.
53
44
  */
54
- export const DEFAULT_ECOPAGES_WORK_DIR = '.eco';
45
+ export declare const DEFAULT_ECOPAGES_WORK_DIR = ".eco";
@@ -0,0 +1,25 @@
1
+ const STATUS_MESSAGE = {
2
+ 404: "404 Not Found"
3
+ };
4
+ const IS_BUN = typeof Bun !== "undefined";
5
+ const RESOLVED_ASSETS_DIR = "assets";
6
+ const RESOLVED_ASSETS_VENDORS_DIR = `${RESOLVED_ASSETS_DIR}/vendors`;
7
+ const GENERATED_BASE_PATHS = {
8
+ types: "node_modules/@types",
9
+ cache: "cache"
10
+ };
11
+ const DEFAULT_ECOPAGES_PORT = 3e3;
12
+ const DEFAULT_ECOPAGES_HOSTNAME = "localhost";
13
+ const DEFAULT_ECOPAGES_DIST_DIR = "dist";
14
+ const DEFAULT_ECOPAGES_WORK_DIR = ".eco";
15
+ export {
16
+ DEFAULT_ECOPAGES_DIST_DIR,
17
+ DEFAULT_ECOPAGES_HOSTNAME,
18
+ DEFAULT_ECOPAGES_PORT,
19
+ DEFAULT_ECOPAGES_WORK_DIR,
20
+ GENERATED_BASE_PATHS,
21
+ IS_BUN,
22
+ RESOLVED_ASSETS_DIR,
23
+ RESOLVED_ASSETS_VENDORS_DIR,
24
+ STATUS_MESSAGE
25
+ };