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

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 (515) hide show
  1. package/package.json +93 -226
  2. package/src/adapters/abstract/application-adapter.test.ts +172 -0
  3. package/src/adapters/abstract/application-adapter.ts +379 -0
  4. package/src/adapters/abstract/router-adapter.ts +30 -0
  5. package/src/adapters/abstract/server-adapter.ts +79 -0
  6. package/src/adapters/bun/client-bridge.ts +62 -0
  7. package/src/adapters/bun/create-app.ts +180 -0
  8. package/src/adapters/bun/hmr-manager.test.ts +267 -0
  9. package/src/adapters/bun/hmr-manager.ts +406 -0
  10. package/src/adapters/bun/index.ts +2 -0
  11. package/src/adapters/bun/server-adapter.ts +500 -0
  12. package/src/adapters/bun/server-lifecycle.ts +124 -0
  13. package/src/adapters/create-app.test.ts +10 -0
  14. package/src/adapters/create-app.ts +91 -0
  15. package/src/adapters/index.ts +2 -0
  16. package/src/adapters/node/create-app.test.ts +53 -0
  17. package/src/adapters/node/create-app.ts +183 -0
  18. package/src/adapters/node/node-client-bridge.test.ts +198 -0
  19. package/src/adapters/node/node-client-bridge.ts +79 -0
  20. package/src/adapters/node/node-hmr-manager.test.ts +322 -0
  21. package/src/adapters/node/node-hmr-manager.ts +378 -0
  22. package/src/adapters/node/server-adapter.ts +502 -0
  23. package/src/adapters/node/static-content-server.test.ts +60 -0
  24. package/src/adapters/node/static-content-server.ts +239 -0
  25. package/src/adapters/shared/api-response.test.ts +97 -0
  26. package/src/adapters/shared/api-response.ts +104 -0
  27. package/src/adapters/shared/application-adapter.ts +199 -0
  28. package/src/adapters/shared/define-api-handler.ts +66 -0
  29. package/src/adapters/shared/explicit-static-route-matcher.test.ts +381 -0
  30. package/src/adapters/shared/explicit-static-route-matcher.ts +140 -0
  31. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +90 -0
  32. package/src/adapters/shared/file-route-middleware-pipeline.ts +127 -0
  33. package/src/adapters/shared/fs-server-response-factory.test.ts +187 -0
  34. package/src/adapters/shared/fs-server-response-factory.ts +118 -0
  35. package/src/adapters/shared/fs-server-response-matcher.test.ts +285 -0
  36. package/src/adapters/shared/fs-server-response-matcher.ts +189 -0
  37. package/src/adapters/shared/hmr-entrypoint-registrar.ts +149 -0
  38. package/src/adapters/shared/hmr-html-response.ts +52 -0
  39. package/src/adapters/shared/hmr-manager.contract.test.ts +232 -0
  40. package/src/adapters/shared/hmr-manager.dispatch.test.ts +220 -0
  41. package/src/adapters/shared/render-context.test.ts +150 -0
  42. package/src/adapters/shared/render-context.ts +123 -0
  43. package/src/adapters/shared/runtime-bootstrap.ts +79 -0
  44. package/src/adapters/shared/server-adapter.test.ts +77 -0
  45. package/src/adapters/shared/server-adapter.ts +493 -0
  46. package/src/adapters/shared/server-route-handler.test.ts +110 -0
  47. package/src/adapters/shared/server-route-handler.ts +153 -0
  48. package/src/adapters/shared/server-static-builder.test.ts +338 -0
  49. package/src/adapters/shared/server-static-builder.ts +170 -0
  50. package/src/build/build-adapter-serialization.test.ts +281 -0
  51. package/src/build/build-adapter.test.ts +1240 -0
  52. package/src/build/build-adapter.ts +1012 -0
  53. package/src/build/build-manifest.ts +54 -0
  54. package/src/build/build-types.ts +83 -0
  55. package/src/build/dev-build-coordinator.ts +220 -0
  56. package/src/build/esbuild-build-adapter.ts +660 -0
  57. package/src/build/runtime-build-executor.test.ts +81 -0
  58. package/src/build/runtime-build-executor.ts +40 -0
  59. package/src/build/runtime-specifier-alias-plugin.test.ts +67 -0
  60. package/src/build/runtime-specifier-alias-plugin.ts +62 -0
  61. package/src/build/runtime-specifier-aliases.ts +135 -0
  62. package/src/config/config-builder.test.ts +443 -0
  63. package/src/config/config-builder.ts +742 -0
  64. package/src/config/config-builder.typecheck.test.ts +96 -0
  65. package/src/config/{constants.d.ts → constants.ts} +22 -13
  66. package/src/dev/sc-server.ts +143 -0
  67. package/src/eco/eco.browser.test.ts +43 -0
  68. package/src/eco/eco.browser.ts +118 -0
  69. package/src/eco/eco.test.ts +654 -0
  70. package/src/eco/eco.ts +205 -0
  71. package/src/eco/eco.types.ts +221 -0
  72. package/src/eco/eco.utils.test.ts +219 -0
  73. package/src/eco/eco.utils.ts +5 -0
  74. package/src/eco/global-injector-map.test.ts +42 -0
  75. package/src/eco/global-injector-map.ts +112 -0
  76. package/src/eco/lazy-injector-map.test.ts +66 -0
  77. package/src/eco/lazy-injector-map.ts +120 -0
  78. package/src/eco/module-dependencies.test.ts +30 -0
  79. package/src/eco/module-dependencies.ts +75 -0
  80. package/src/errors/http-error.test.ts +134 -0
  81. package/src/errors/http-error.ts +72 -0
  82. package/src/errors/{index.d.ts → index.ts} +2 -2
  83. package/src/errors/locals-access-error.ts +7 -0
  84. package/src/global/app-logger.ts +4 -0
  85. package/src/global/utils.test.ts +12 -0
  86. 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
  87. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  88. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  89. package/src/hmr/client/hmr-runtime.ts +160 -0
  90. package/src/hmr/hmr-strategy.test.ts +124 -0
  91. package/src/hmr/hmr-strategy.ts +177 -0
  92. package/src/hmr/hmr.postcss.test.e2e.ts +41 -0
  93. package/src/hmr/hmr.test.e2e.ts +66 -0
  94. package/src/hmr/strategies/default-hmr-strategy.ts +60 -0
  95. package/src/hmr/strategies/js-hmr-strategy.test.ts +335 -0
  96. package/src/hmr/strategies/js-hmr-strategy.ts +320 -0
  97. package/src/index.browser.ts +3 -0
  98. package/src/index.ts +15 -0
  99. package/src/integrations/ghtml/ghtml-renderer.test.ts +253 -0
  100. package/src/integrations/ghtml/ghtml-renderer.ts +97 -0
  101. package/src/integrations/ghtml/ghtml.constants.ts +1 -0
  102. package/src/integrations/ghtml/ghtml.plugin.ts +28 -0
  103. package/src/plugins/alias-resolver-plugin.test.ts +41 -0
  104. package/src/plugins/alias-resolver-plugin.ts +63 -0
  105. package/src/plugins/eco-component-meta-plugin.test.ts +406 -0
  106. package/src/plugins/eco-component-meta-plugin.ts +495 -0
  107. package/src/plugins/foreign-jsx-override-plugin.test.ts +65 -0
  108. package/src/plugins/foreign-jsx-override-plugin.ts +67 -0
  109. package/src/plugins/integration-plugin.test.ts +156 -0
  110. package/src/plugins/integration-plugin.ts +311 -0
  111. package/src/plugins/processor.test.ts +148 -0
  112. package/src/plugins/processor.ts +240 -0
  113. package/src/plugins/{runtime-capability.d.ts → runtime-capability.ts} +8 -3
  114. package/src/plugins/source-transform.test.ts +82 -0
  115. package/src/plugins/source-transform.ts +123 -0
  116. package/src/route-renderer/orchestration/boundary-planning.service.ts +146 -0
  117. package/src/route-renderer/orchestration/component-render-context.ts +318 -0
  118. package/src/route-renderer/orchestration/integration-renderer.test.ts +2088 -0
  119. package/src/route-renderer/orchestration/integration-renderer.ts +1285 -0
  120. package/src/route-renderer/orchestration/page-packaging.service.test.ts +76 -0
  121. package/src/route-renderer/orchestration/page-packaging.service.ts +85 -0
  122. package/src/route-renderer/orchestration/processed-asset-dedupe.ts +25 -0
  123. package/src/route-renderer/orchestration/queued-boundary-runtime.service.test.ts +319 -0
  124. package/src/route-renderer/orchestration/queued-boundary-runtime.service.ts +289 -0
  125. package/src/route-renderer/orchestration/render-execution.service.test.ts +196 -0
  126. package/src/route-renderer/orchestration/render-execution.service.ts +182 -0
  127. package/src/route-renderer/orchestration/render-output.utils.ts +302 -0
  128. package/src/route-renderer/orchestration/render-preparation.service.test.ts +569 -0
  129. package/src/route-renderer/orchestration/render-preparation.service.ts +508 -0
  130. package/src/route-renderer/orchestration/route-shell-composer.service.ts +162 -0
  131. package/src/route-renderer/orchestration/template-serialization.test.ts +110 -0
  132. package/src/route-renderer/orchestration/template-serialization.ts +117 -0
  133. package/src/route-renderer/page-loading/component-dependency-collection.ts +196 -0
  134. package/src/route-renderer/page-loading/declared-asset-collection.ts +156 -0
  135. package/src/route-renderer/page-loading/dependency-resolver.test.ts +665 -0
  136. package/src/route-renderer/page-loading/dependency-resolver.ts +150 -0
  137. package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +75 -0
  138. package/src/route-renderer/page-loading/lazy-entry-collection.ts +167 -0
  139. package/src/route-renderer/page-loading/lazy-trigger-planning.ts +74 -0
  140. package/src/route-renderer/page-loading/module-declaration-aggregation.ts +60 -0
  141. package/src/route-renderer/page-loading/module-declaration-scripts.ts +16 -0
  142. package/src/route-renderer/page-loading/page-dependency-bundling.ts +205 -0
  143. package/src/route-renderer/page-loading/page-module-loader.test.ts +183 -0
  144. package/src/route-renderer/page-loading/page-module-loader.ts +184 -0
  145. package/src/route-renderer/route-renderer.ts +136 -0
  146. package/src/router/client/link-intent.test.browser.ts +51 -0
  147. package/src/router/client/link-intent.ts +92 -0
  148. package/src/router/client/navigation-coordinator.test.ts +237 -0
  149. package/src/router/client/navigation-coordinator.ts +453 -0
  150. package/src/router/server/fs-router-scanner.test.ts +83 -0
  151. package/src/router/server/fs-router-scanner.ts +224 -0
  152. package/src/router/server/fs-router.test.ts +214 -0
  153. package/src/router/server/fs-router.ts +122 -0
  154. package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +66 -0
  155. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +476 -0
  156. package/src/services/assets/asset-processing-service/asset-processing.service.ts +345 -0
  157. package/src/services/assets/asset-processing-service/asset.factory.test.ts +63 -0
  158. package/src/services/assets/asset-processing-service/asset.factory.ts +105 -0
  159. package/src/services/assets/asset-processing-service/assets.types.ts +125 -0
  160. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +74 -0
  161. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +96 -0
  162. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +67 -0
  163. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +78 -0
  164. package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +104 -0
  165. package/src/services/assets/asset-processing-service/index.ts +5 -0
  166. package/src/services/assets/asset-processing-service/{processor.interface.d.ts → processor.interface.ts} +10 -5
  167. package/src/services/assets/asset-processing-service/processor.registry.ts +18 -0
  168. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +59 -0
  169. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +83 -0
  170. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +174 -0
  171. package/src/services/assets/asset-processing-service/processors/index.ts +5 -0
  172. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +192 -0
  173. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +134 -0
  174. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +326 -0
  175. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +110 -0
  176. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +227 -0
  177. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +87 -0
  178. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +261 -0
  179. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +71 -0
  180. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +81 -0
  181. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +65 -0
  182. package/src/services/assets/browser-bundle.service.test.ts +66 -0
  183. package/src/services/assets/browser-bundle.service.ts +109 -0
  184. package/src/services/cache/cache.types.ts +126 -0
  185. package/src/services/cache/index.ts +18 -0
  186. package/src/services/cache/memory-cache-store.test.ts +225 -0
  187. package/src/services/cache/memory-cache-store.ts +130 -0
  188. package/src/services/cache/page-cache-service.test.ts +175 -0
  189. package/src/services/cache/page-cache-service.ts +202 -0
  190. package/src/services/cache/page-request-cache-coordinator.service.test.ts +79 -0
  191. package/src/services/cache/page-request-cache-coordinator.service.ts +131 -0
  192. package/src/services/html/html-rewriter-provider.service.test.ts +183 -0
  193. package/src/services/html/html-rewriter-provider.service.ts +104 -0
  194. package/src/services/html/html-transformer.service.test.ts +479 -0
  195. package/src/services/html/html-transformer.service.ts +275 -0
  196. package/src/services/invalidation/development-invalidation.service.test.ts +87 -0
  197. package/src/services/invalidation/development-invalidation.service.ts +262 -0
  198. package/src/services/module-loading/app-module-loader.service.ts +9 -0
  199. package/src/services/module-loading/app-server-module-transpiler.service.test.ts +130 -0
  200. package/src/services/module-loading/app-server-module-transpiler.service.ts +143 -0
  201. package/src/services/module-loading/host-module-loader-registry.ts +15 -0
  202. package/src/services/module-loading/{module-loading-types.d.ts → module-loading-types.ts} +1 -0
  203. package/src/services/module-loading/node-bootstrap-plugin.test.ts +335 -0
  204. package/src/services/module-loading/node-bootstrap-plugin.ts +297 -0
  205. package/src/services/module-loading/page-module-import.service.test.ts +504 -0
  206. package/src/services/module-loading/page-module-import.service.ts +252 -0
  207. package/src/services/module-loading/server-module-transpiler.service.test.ts +243 -0
  208. package/src/services/module-loading/server-module-transpiler.service.ts +104 -0
  209. package/src/services/module-loading/source-module-support.ts +19 -0
  210. package/src/services/runtime-state/dev-graph.service.ts +217 -0
  211. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +136 -0
  212. package/src/services/runtime-state/runtime-specifier-registry.service.ts +96 -0
  213. package/src/services/runtime-state/server-invalidation-state.service.ts +68 -0
  214. package/src/services/validation/schema-validation-service.test.ts +223 -0
  215. package/src/services/validation/schema-validation-service.ts +204 -0
  216. package/src/services/validation/{standard-schema.types.d.ts → standard-schema.types.ts} +20 -17
  217. package/src/static-site-generator/static-site-generator.test.ts +316 -0
  218. package/src/static-site-generator/static-site-generator.ts +462 -0
  219. package/src/types/internal-types.ts +242 -0
  220. package/src/types/public-types.ts +1443 -0
  221. package/src/utils/deep-merge.test.ts +114 -0
  222. package/src/utils/deep-merge.ts +47 -0
  223. package/src/utils/hash.ts +5 -0
  224. package/src/utils/html-escaping.ts +9 -0
  225. package/src/utils/invariant.test.ts +22 -0
  226. package/src/utils/invariant.ts +15 -0
  227. package/src/utils/locals-utils.ts +37 -0
  228. package/src/utils/parse-cli-args.test.ts +69 -0
  229. package/src/utils/parse-cli-args.ts +105 -0
  230. package/src/utils/path-utils.module.ts +14 -0
  231. package/src/utils/path-utils.test.ts +15 -0
  232. package/src/utils/resolve-work-dir.ts +45 -0
  233. package/src/utils/runtime.ts +44 -0
  234. package/src/utils/server-utils.module.ts +67 -0
  235. package/src/utils/server-utils.test.ts +38 -0
  236. package/src/watchers/project-watcher.integration.test.ts +337 -0
  237. package/src/watchers/project-watcher.test-helpers.ts +41 -0
  238. package/src/watchers/project-watcher.test.ts +768 -0
  239. package/src/watchers/project-watcher.ts +357 -0
  240. package/CHANGELOG.md +0 -51
  241. package/src/adapters/abstract/application-adapter.d.ts +0 -194
  242. package/src/adapters/abstract/application-adapter.js +0 -121
  243. package/src/adapters/abstract/router-adapter.d.ts +0 -26
  244. package/src/adapters/abstract/router-adapter.js +0 -5
  245. package/src/adapters/abstract/server-adapter.d.ts +0 -69
  246. package/src/adapters/abstract/server-adapter.js +0 -15
  247. package/src/adapters/bun/client-bridge.d.ts +0 -34
  248. package/src/adapters/bun/client-bridge.js +0 -48
  249. package/src/adapters/bun/create-app.d.ts +0 -52
  250. package/src/adapters/bun/create-app.js +0 -116
  251. package/src/adapters/bun/hmr-manager.d.ts +0 -143
  252. package/src/adapters/bun/hmr-manager.js +0 -333
  253. package/src/adapters/bun/index.d.ts +0 -2
  254. package/src/adapters/bun/index.js +0 -8
  255. package/src/adapters/bun/server-adapter.d.ts +0 -155
  256. package/src/adapters/bun/server-adapter.js +0 -374
  257. package/src/adapters/bun/server-lifecycle.d.ts +0 -63
  258. package/src/adapters/bun/server-lifecycle.js +0 -92
  259. package/src/adapters/create-app.d.ts +0 -20
  260. package/src/adapters/create-app.js +0 -66
  261. package/src/adapters/index.d.ts +0 -2
  262. package/src/adapters/index.js +0 -8
  263. package/src/adapters/node/create-app.d.ts +0 -18
  264. package/src/adapters/node/create-app.js +0 -149
  265. package/src/adapters/node/node-client-bridge.d.ts +0 -26
  266. package/src/adapters/node/node-client-bridge.js +0 -66
  267. package/src/adapters/node/node-hmr-manager.d.ts +0 -133
  268. package/src/adapters/node/node-hmr-manager.js +0 -311
  269. package/src/adapters/node/server-adapter.d.ts +0 -161
  270. package/src/adapters/node/server-adapter.js +0 -359
  271. package/src/adapters/node/static-content-server.d.ts +0 -60
  272. package/src/adapters/node/static-content-server.js +0 -194
  273. package/src/adapters/shared/api-response.d.ts +0 -52
  274. package/src/adapters/shared/api-response.js +0 -96
  275. package/src/adapters/shared/application-adapter.d.ts +0 -18
  276. package/src/adapters/shared/application-adapter.js +0 -90
  277. package/src/adapters/shared/define-api-handler.d.ts +0 -25
  278. package/src/adapters/shared/define-api-handler.js +0 -15
  279. package/src/adapters/shared/explicit-static-route-matcher.d.ts +0 -38
  280. package/src/adapters/shared/explicit-static-route-matcher.js +0 -103
  281. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +0 -65
  282. package/src/adapters/shared/file-route-middleware-pipeline.js +0 -99
  283. package/src/adapters/shared/fs-server-response-factory.d.ts +0 -19
  284. package/src/adapters/shared/fs-server-response-factory.js +0 -97
  285. package/src/adapters/shared/fs-server-response-matcher.d.ts +0 -67
  286. package/src/adapters/shared/fs-server-response-matcher.js +0 -147
  287. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +0 -55
  288. package/src/adapters/shared/hmr-entrypoint-registrar.js +0 -87
  289. package/src/adapters/shared/hmr-html-response.d.ts +0 -22
  290. package/src/adapters/shared/hmr-html-response.js +0 -32
  291. package/src/adapters/shared/render-context.d.ts +0 -15
  292. package/src/adapters/shared/render-context.js +0 -72
  293. package/src/adapters/shared/runtime-bootstrap.d.ts +0 -38
  294. package/src/adapters/shared/runtime-bootstrap.js +0 -43
  295. package/src/adapters/shared/server-adapter.d.ts +0 -97
  296. package/src/adapters/shared/server-adapter.js +0 -390
  297. package/src/adapters/shared/server-route-handler.d.ts +0 -89
  298. package/src/adapters/shared/server-route-handler.js +0 -111
  299. package/src/adapters/shared/server-static-builder.d.ts +0 -70
  300. package/src/adapters/shared/server-static-builder.js +0 -100
  301. package/src/build/build-adapter.d.ts +0 -239
  302. package/src/build/build-adapter.js +0 -642
  303. package/src/build/build-manifest.d.ts +0 -27
  304. package/src/build/build-manifest.js +0 -30
  305. package/src/build/build-types.d.ts +0 -57
  306. package/src/build/build-types.js +0 -0
  307. package/src/build/dev-build-coordinator.d.ts +0 -72
  308. package/src/build/dev-build-coordinator.js +0 -154
  309. package/src/build/esbuild-build-adapter.d.ts +0 -78
  310. package/src/build/esbuild-build-adapter.js +0 -505
  311. package/src/build/runtime-build-executor.d.ts +0 -14
  312. package/src/build/runtime-build-executor.js +0 -22
  313. package/src/build/runtime-specifier-alias-plugin.d.ts +0 -15
  314. package/src/build/runtime-specifier-alias-plugin.js +0 -35
  315. package/src/build/runtime-specifier-aliases.d.ts +0 -5
  316. package/src/build/runtime-specifier-aliases.js +0 -95
  317. package/src/config/config-builder.d.ts +0 -252
  318. package/src/config/config-builder.js +0 -603
  319. package/src/config/constants.js +0 -25
  320. package/src/dev/sc-server.d.ts +0 -30
  321. package/src/dev/sc-server.js +0 -111
  322. package/src/eco/eco.browser.d.ts +0 -2
  323. package/src/eco/eco.browser.js +0 -83
  324. package/src/eco/eco.d.ts +0 -9
  325. package/src/eco/eco.js +0 -85
  326. package/src/eco/eco.types.d.ts +0 -178
  327. package/src/eco/eco.types.js +0 -0
  328. package/src/eco/eco.utils.d.ts +0 -1
  329. package/src/eco/eco.utils.js +0 -10
  330. package/src/eco/global-injector-map.d.ts +0 -16
  331. package/src/eco/global-injector-map.js +0 -80
  332. package/src/eco/lazy-injector-map.d.ts +0 -8
  333. package/src/eco/lazy-injector-map.js +0 -70
  334. package/src/eco/module-dependencies.d.ts +0 -18
  335. package/src/eco/module-dependencies.js +0 -49
  336. package/src/errors/http-error.d.ts +0 -31
  337. package/src/errors/http-error.js +0 -50
  338. package/src/errors/index.js +0 -4
  339. package/src/errors/locals-access-error.d.ts +0 -4
  340. package/src/errors/locals-access-error.js +0 -9
  341. package/src/global/app-logger.d.ts +0 -2
  342. package/src/global/app-logger.js +0 -6
  343. package/src/hmr/client/hmr-runtime.d.ts +0 -5
  344. package/src/hmr/client/hmr-runtime.js +0 -109
  345. package/src/hmr/hmr-strategy.d.ts +0 -162
  346. package/src/hmr/hmr-strategy.js +0 -44
  347. package/src/hmr/hmr.postcss.test.e2e.d.ts +0 -1
  348. package/src/hmr/hmr.postcss.test.e2e.js +0 -31
  349. package/src/hmr/hmr.test.e2e.d.ts +0 -1
  350. package/src/hmr/hmr.test.e2e.js +0 -43
  351. package/src/hmr/strategies/default-hmr-strategy.d.ts +0 -43
  352. package/src/hmr/strategies/default-hmr-strategy.js +0 -34
  353. package/src/hmr/strategies/js-hmr-strategy.d.ts +0 -139
  354. package/src/hmr/strategies/js-hmr-strategy.js +0 -178
  355. package/src/index.browser.d.ts +0 -3
  356. package/src/index.browser.js +0 -4
  357. package/src/index.d.ts +0 -6
  358. package/src/index.js +0 -21
  359. package/src/integrations/ghtml/ghtml-renderer.d.ts +0 -20
  360. package/src/integrations/ghtml/ghtml-renderer.js +0 -63
  361. package/src/integrations/ghtml/ghtml.constants.d.ts +0 -1
  362. package/src/integrations/ghtml/ghtml.constants.js +0 -4
  363. package/src/integrations/ghtml/ghtml.plugin.d.ts +0 -16
  364. package/src/integrations/ghtml/ghtml.plugin.js +0 -20
  365. package/src/plugins/alias-resolver-plugin.d.ts +0 -2
  366. package/src/plugins/alias-resolver-plugin.js +0 -53
  367. package/src/plugins/eco-component-meta-plugin.d.ts +0 -108
  368. package/src/plugins/eco-component-meta-plugin.js +0 -163
  369. package/src/plugins/foreign-jsx-override-plugin.d.ts +0 -31
  370. package/src/plugins/foreign-jsx-override-plugin.js +0 -35
  371. package/src/plugins/integration-plugin.d.ts +0 -219
  372. package/src/plugins/integration-plugin.js +0 -196
  373. package/src/plugins/processor.d.ts +0 -95
  374. package/src/plugins/processor.js +0 -136
  375. package/src/plugins/runtime-capability.js +0 -0
  376. package/src/plugins/source-transform.d.ts +0 -46
  377. package/src/plugins/source-transform.js +0 -71
  378. package/src/route-renderer/orchestration/boundary-planning.service.d.ts +0 -25
  379. package/src/route-renderer/orchestration/boundary-planning.service.js +0 -97
  380. package/src/route-renderer/orchestration/component-render-context.d.ts +0 -83
  381. package/src/route-renderer/orchestration/component-render-context.js +0 -147
  382. package/src/route-renderer/orchestration/integration-renderer.d.ts +0 -554
  383. package/src/route-renderer/orchestration/integration-renderer.js +0 -957
  384. package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +0 -89
  385. package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +0 -155
  386. package/src/route-renderer/orchestration/render-execution.service.d.ts +0 -43
  387. package/src/route-renderer/orchestration/render-execution.service.js +0 -106
  388. package/src/route-renderer/orchestration/render-output.utils.d.ts +0 -46
  389. package/src/route-renderer/orchestration/render-output.utils.js +0 -65
  390. package/src/route-renderer/orchestration/render-preparation.service.d.ts +0 -120
  391. package/src/route-renderer/orchestration/render-preparation.service.js +0 -341
  392. package/src/route-renderer/orchestration/route-shell-composer.service.d.ts +0 -50
  393. package/src/route-renderer/orchestration/route-shell-composer.service.js +0 -81
  394. package/src/route-renderer/orchestration/template-serialization.d.ts +0 -38
  395. package/src/route-renderer/orchestration/template-serialization.js +0 -45
  396. package/src/route-renderer/page-loading/dependency-resolver.d.ts +0 -35
  397. package/src/route-renderer/page-loading/dependency-resolver.js +0 -444
  398. package/src/route-renderer/page-loading/page-module-loader.d.ts +0 -90
  399. package/src/route-renderer/page-loading/page-module-loader.js +0 -127
  400. package/src/route-renderer/route-renderer.d.ts +0 -67
  401. package/src/route-renderer/route-renderer.js +0 -103
  402. package/src/router/client/link-intent.js +0 -34
  403. package/src/router/client/link-intent.test.browser.d.ts +0 -1
  404. package/src/router/client/link-intent.test.browser.js +0 -43
  405. package/src/router/client/navigation-coordinator.d.ts +0 -149
  406. package/src/router/client/navigation-coordinator.js +0 -215
  407. package/src/router/server/fs-router-scanner.d.ts +0 -41
  408. package/src/router/server/fs-router-scanner.js +0 -161
  409. package/src/router/server/fs-router.d.ts +0 -26
  410. package/src/router/server/fs-router.js +0 -100
  411. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +0 -120
  412. package/src/services/assets/asset-processing-service/asset-processing.service.js +0 -331
  413. package/src/services/assets/asset-processing-service/asset.factory.d.ts +0 -17
  414. package/src/services/assets/asset-processing-service/asset.factory.js +0 -82
  415. package/src/services/assets/asset-processing-service/assets.types.d.ts +0 -89
  416. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  417. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +0 -55
  418. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +0 -48
  419. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +0 -20
  420. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +0 -41
  421. package/src/services/assets/asset-processing-service/index.d.ts +0 -5
  422. package/src/services/assets/asset-processing-service/index.js +0 -5
  423. package/src/services/assets/asset-processing-service/processor.interface.js +0 -6
  424. package/src/services/assets/asset-processing-service/processor.registry.d.ts +0 -8
  425. package/src/services/assets/asset-processing-service/processor.registry.js +0 -15
  426. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +0 -24
  427. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +0 -64
  428. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +0 -17
  429. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +0 -72
  430. package/src/services/assets/asset-processing-service/processors/index.d.ts +0 -5
  431. package/src/services/assets/asset-processing-service/processors/index.js +0 -5
  432. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +0 -5
  433. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +0 -57
  434. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +0 -9
  435. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +0 -88
  436. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +0 -7
  437. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +0 -75
  438. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +0 -5
  439. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -25
  440. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +0 -9
  441. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +0 -66
  442. package/src/services/assets/browser-bundle.service.d.ts +0 -32
  443. package/src/services/assets/browser-bundle.service.js +0 -33
  444. package/src/services/cache/cache.types.d.ts +0 -107
  445. package/src/services/cache/cache.types.js +0 -0
  446. package/src/services/cache/index.d.ts +0 -7
  447. package/src/services/cache/index.js +0 -7
  448. package/src/services/cache/memory-cache-store.d.ts +0 -42
  449. package/src/services/cache/memory-cache-store.js +0 -98
  450. package/src/services/cache/page-cache-service.d.ts +0 -70
  451. package/src/services/cache/page-cache-service.js +0 -152
  452. package/src/services/cache/page-request-cache-coordinator.service.d.ts +0 -75
  453. package/src/services/cache/page-request-cache-coordinator.service.js +0 -109
  454. package/src/services/html/html-rewriter-provider.service.d.ts +0 -37
  455. package/src/services/html/html-rewriter-provider.service.js +0 -68
  456. package/src/services/html/html-transformer.service.d.ts +0 -77
  457. package/src/services/html/html-transformer.service.js +0 -215
  458. package/src/services/invalidation/development-invalidation.service.d.ts +0 -74
  459. package/src/services/invalidation/development-invalidation.service.js +0 -190
  460. package/src/services/module-loading/app-module-loader.service.d.ts +0 -28
  461. package/src/services/module-loading/app-module-loader.service.js +0 -35
  462. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +0 -24
  463. package/src/services/module-loading/app-server-module-transpiler.service.js +0 -109
  464. package/src/services/module-loading/host-module-loader-registry.d.ts +0 -4
  465. package/src/services/module-loading/host-module-loader-registry.js +0 -15
  466. package/src/services/module-loading/module-loading-types.js +0 -0
  467. package/src/services/module-loading/node-bootstrap-plugin.d.ts +0 -42
  468. package/src/services/module-loading/node-bootstrap-plugin.js +0 -204
  469. package/src/services/module-loading/page-module-import.service.d.ts +0 -76
  470. package/src/services/module-loading/page-module-import.service.js +0 -173
  471. package/src/services/module-loading/server-module-transpiler.service.d.ts +0 -72
  472. package/src/services/module-loading/server-module-transpiler.service.js +0 -64
  473. package/src/services/runtime-state/dev-graph.service.d.ts +0 -118
  474. package/src/services/runtime-state/dev-graph.service.js +0 -162
  475. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +0 -41
  476. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +0 -85
  477. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +0 -69
  478. package/src/services/runtime-state/runtime-specifier-registry.service.js +0 -37
  479. package/src/services/runtime-state/server-invalidation-state.service.d.ts +0 -26
  480. package/src/services/runtime-state/server-invalidation-state.service.js +0 -35
  481. package/src/services/validation/schema-validation-service.d.ts +0 -122
  482. package/src/services/validation/schema-validation-service.js +0 -101
  483. package/src/services/validation/standard-schema.types.js +0 -0
  484. package/src/static-site-generator/static-site-generator.d.ts +0 -104
  485. package/src/static-site-generator/static-site-generator.js +0 -338
  486. package/src/types/internal-types.d.ts +0 -231
  487. package/src/types/internal-types.js +0 -0
  488. package/src/types/public-types.d.ts +0 -1219
  489. package/src/types/public-types.js +0 -0
  490. package/src/utils/deep-merge.d.ts +0 -14
  491. package/src/utils/deep-merge.js +0 -32
  492. package/src/utils/hash.d.ts +0 -1
  493. package/src/utils/hash.js +0 -7
  494. package/src/utils/html-escaping.d.ts +0 -7
  495. package/src/utils/html-escaping.js +0 -6
  496. package/src/utils/html.js +0 -4
  497. package/src/utils/invariant.d.ts +0 -5
  498. package/src/utils/invariant.js +0 -11
  499. package/src/utils/locals-utils.d.ts +0 -15
  500. package/src/utils/locals-utils.js +0 -24
  501. package/src/utils/parse-cli-args.d.ts +0 -27
  502. package/src/utils/parse-cli-args.js +0 -62
  503. package/src/utils/path-utils.module.d.ts +0 -5
  504. package/src/utils/path-utils.module.js +0 -14
  505. package/src/utils/resolve-work-dir.d.ts +0 -11
  506. package/src/utils/resolve-work-dir.js +0 -31
  507. package/src/utils/runtime.d.ts +0 -11
  508. package/src/utils/runtime.js +0 -40
  509. package/src/utils/server-utils.module.d.ts +0 -19
  510. package/src/utils/server-utils.module.js +0 -56
  511. package/src/watchers/project-watcher.d.ts +0 -136
  512. package/src/watchers/project-watcher.js +0 -275
  513. package/src/watchers/project-watcher.test-helpers.d.ts +0 -4
  514. package/src/watchers/project-watcher.test-helpers.js +0 -52
  515. /package/src/utils/{html.d.ts → html.ts} +0 -0
@@ -1,163 +0,0 @@
1
- import path from "node:path";
2
- import { parseSync } from "oxc-parser";
3
- import { rapidhash } from "../utils/hash.js";
4
- import {
5
- createEcoBuildPluginFromSourceTransform,
6
- createVitePluginFromSourceTransform
7
- } from "./source-transform.js";
8
- const REGEX_SPECIAL_CHARS = /[.*+?^${}()|[\]\\]/g;
9
- const VALID_LOADER_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx"]);
10
- function hasValidLoaderExtension(ext) {
11
- for (const validExt of VALID_LOADER_EXTENSIONS) {
12
- if (ext.endsWith(validExt)) {
13
- return true;
14
- }
15
- }
16
- return false;
17
- }
18
- function buildExtensionToIntegrationMap(integrations) {
19
- const mapping = [];
20
- for (const integration of integrations) {
21
- for (const ext of integration.extensions) {
22
- mapping.push([ext, integration.name]);
23
- }
24
- }
25
- mapping.sort((a, b) => b[0].length - a[0].length);
26
- return mapping;
27
- }
28
- function detectIntegration(filePath, extensionToIntegration) {
29
- for (const [ext, integration] of extensionToIntegration) {
30
- if (filePath.endsWith(ext)) {
31
- return integration;
32
- }
33
- }
34
- return "ghtml";
35
- }
36
- function createExtensionPattern(extensions) {
37
- if (extensions.length === 0) {
38
- throw new Error("[eco-component-meta-plugin] No extensions configured. At least one integration is required.");
39
- }
40
- const uniqueExtensions = [...new Set(extensions)];
41
- const escaped = uniqueExtensions.map((ext) => ext.replace(REGEX_SPECIAL_CHARS, "\\$&"));
42
- return new RegExp(`(${escaped.join("|")})(\\?.*)?$`);
43
- }
44
- function createEcoComponentMetaTransform(options) {
45
- const allExtensions = options.config.integrations.flatMap((integration) => integration.extensions).filter(hasValidLoaderExtension);
46
- if (allExtensions.length === 0) {
47
- throw new Error("[eco-component-meta-plugin] No extensions configured. At least one integration is required.");
48
- }
49
- const extensionPattern = createExtensionPattern(allExtensions);
50
- const extensionToIntegration = buildExtensionToIntegrationMap(options.config.integrations);
51
- return {
52
- name: "eco-component-meta-plugin",
53
- enforce: "pre",
54
- filter: extensionPattern,
55
- transform(code, id) {
56
- const integration = detectIntegration(id, extensionToIntegration);
57
- return {
58
- code: injectEcoMeta(code, id, integration)
59
- };
60
- }
61
- };
62
- }
63
- function createEcoComponentMetaPlugin(options) {
64
- return createEcoBuildPluginFromSourceTransform(createEcoComponentMetaTransform(options));
65
- }
66
- function createEcoComponentMetaVitePlugin(options) {
67
- return createVitePluginFromSourceTransform(createEcoComponentMetaTransform(options));
68
- }
69
- function findInjectionPoints(node, insertions, injection, isInsideEcoComponent = false) {
70
- if (!node || typeof node !== "object") return;
71
- const n = node;
72
- if (n.type === "CallExpression") {
73
- const callee = n.callee;
74
- if (callee?.type === "MemberExpression" || callee?.type === "StaticMemberExpression") {
75
- const obj = callee.object;
76
- const prop = callee.property;
77
- if (obj?.type === "Identifier" && obj?.name === "eco" && (prop?.name === "page" || prop?.name === "component" || prop?.name === "html" || prop?.name === "layout")) {
78
- const args = n.arguments;
79
- const firstArg = args?.[0];
80
- if (firstArg?.type === "ObjectExpression") {
81
- const start = firstArg.start;
82
- if (typeof start === "number") {
83
- insertions.push({ position: start + 1, text: injection });
84
- }
85
- }
86
- }
87
- }
88
- }
89
- if (n.type === "AssignmentExpression") {
90
- const left = n.left;
91
- const right = n.right;
92
- if (left?.type === "MemberExpression" || left?.type === "StaticMemberExpression") {
93
- const prop = left.property;
94
- if (prop?.name === "config" && right?.type === "ObjectExpression") {
95
- const start = right.start;
96
- if (typeof start === "number") {
97
- insertions.push({ position: start + 1, text: injection });
98
- }
99
- }
100
- }
101
- }
102
- if (n.type === "ObjectProperty" || n.type === "Property") {
103
- const key = n.key;
104
- const value = n.value;
105
- if ((key?.type === "Identifier" || key?.type === "IdentifierName") && key?.name === "config" && value?.type === "ObjectExpression" && isInsideEcoComponent) {
106
- const start = value.start;
107
- if (typeof start === "number") {
108
- insertions.push({ position: start + 1, text: injection });
109
- }
110
- }
111
- }
112
- let childIsInsideEcoComponent = isInsideEcoComponent;
113
- if (n.type === "VariableDeclarator") {
114
- const id = n.id;
115
- const typeAnnotation = id?.typeAnnotation;
116
- if (typeAnnotation) {
117
- const typeStr = JSON.stringify(typeAnnotation);
118
- if (typeStr.includes("EcoComponent")) {
119
- childIsInsideEcoComponent = true;
120
- }
121
- }
122
- }
123
- for (const key in n) {
124
- if (key === "start" || key === "end" || key === "type") continue;
125
- const value = n[key];
126
- if (Array.isArray(value)) {
127
- for (const child of value) {
128
- findInjectionPoints(child, insertions, injection, childIsInsideEcoComponent);
129
- }
130
- } else if (typeof value === "object" && value !== null) {
131
- findInjectionPoints(value, insertions, injection, childIsInsideEcoComponent);
132
- }
133
- }
134
- }
135
- function injectEcoMeta(contents, filePath, integration) {
136
- const result = parseSync(filePath, contents);
137
- if (result.errors.length > 0) {
138
- console.warn(`[eco-component-meta-plugin] Parse errors in ${filePath}:`, result.errors);
139
- return contents;
140
- }
141
- const ast = result.program;
142
- const id = rapidhash(filePath).toString(36);
143
- const injection = ` __eco: { id: "${id}", file: "${filePath}", integration: "${integration}" },`;
144
- const insertions = [];
145
- findInjectionPoints(ast, insertions, injection);
146
- if (insertions.length === 0) {
147
- return contents;
148
- }
149
- insertions.sort((a, b) => b.position - a.position);
150
- let transformed = contents;
151
- for (const { position, text } of insertions) {
152
- transformed = transformed.slice(0, position) + text + transformed.slice(position);
153
- }
154
- return transformed;
155
- }
156
- var eco_component_meta_plugin_default = createEcoComponentMetaPlugin;
157
- export {
158
- createEcoComponentMetaPlugin,
159
- createEcoComponentMetaTransform,
160
- createEcoComponentMetaVitePlugin,
161
- eco_component_meta_plugin_default as default,
162
- injectEcoMeta
163
- };
@@ -1,31 +0,0 @@
1
- import type { EcoBuildPlugin } from '../build/build-types.js';
2
- /**
3
- * Options for the shared foreign-JSX override build plugin.
4
- */
5
- export interface ForeignJsxOverrideOptions {
6
- /** JSX runtime that should own the transformed foreign files. */
7
- hostJsxImportSource: string;
8
- /** Extensions claimed by other JSX integrations that may appear in the host graph. */
9
- foreignExtensions: string[];
10
- /** Optional plugin name override for debug output. */
11
- name?: string;
12
- }
13
- /**
14
- * Build plugin that prepends a `@jsxImportSource` pragma to foreign integration
15
- * files bundled into a host integration's client graph.
16
- *
17
- * When a host integration (e.g. React) bundles a component file that belongs to
18
- * another JSX integration (e.g. `.kita.tsx`), that file inherits the project
19
- * `tsconfig` JSX runtime which produces the wrong output (HTML strings instead
20
- * of framework elements). This plugin rewrites the source to explicitly target
21
- * the host's JSX factory so esbuild compiles every JSX expression into the
22
- * correct element creation calls.
23
- *
24
- * The plugin is intentionally framework-agnostic: any integration that does
25
- * client-side bundling can use it by passing its own `jsxImportSource` and the
26
- * set of foreign extensions collected from the app config.
27
- *
28
- * When no JSX-bearing foreign extensions are present, the returned plugin is a
29
- * no-op so integrations can register it unconditionally.
30
- */
31
- export declare function createForeignJsxOverridePlugin(options: ForeignJsxOverrideOptions): EcoBuildPlugin;
@@ -1,35 +0,0 @@
1
- import { readFileSync } from "node:fs";
2
- import path from "node:path";
3
- function createForeignJsxOverridePlugin(options) {
4
- const extensions = options.foreignExtensions.filter((ext) => ext.endsWith(".tsx") || ext.endsWith(".jsx"));
5
- if (extensions.length === 0) {
6
- return {
7
- name: options.name ?? "foreign-jsx-override",
8
- setup() {
9
- }
10
- };
11
- }
12
- const pragma = `/** @jsxImportSource ${options.hostJsxImportSource} */
13
- `;
14
- const filter = new RegExp(`(${extensions.map((e) => e.replace(".", "\\.")).join("|")})$`);
15
- return {
16
- name: options.name ?? "foreign-jsx-override",
17
- setup(build) {
18
- build.onLoad({ filter }, (args) => {
19
- const source = readFileSync(args.path, "utf-8");
20
- const loader = args.path.endsWith(".jsx") ? "jsx" : "tsx";
21
- if (source.includes("@jsxImportSource")) {
22
- return void 0;
23
- }
24
- return {
25
- contents: pragma + source,
26
- loader,
27
- resolveDir: path.dirname(args.path)
28
- };
29
- });
30
- }
31
- };
32
- }
33
- export {
34
- createForeignJsxOverridePlugin
35
- };
@@ -1,219 +0,0 @@
1
- import type { EcoBuildPlugin } from '../build/build-types.js';
2
- import type { EcoPagesAppConfig, IHmrManager } from '../types/internal-types.js';
3
- import type { HmrStrategy } from '../hmr/hmr-strategy.js';
4
- import type { EcoPagesElement } from '../types/public-types.js';
5
- import type { IntegrationRenderer } from '../route-renderer/orchestration/integration-renderer.js';
6
- import { AssetProcessingService } from '../services/assets/asset-processing-service/asset-processing.service.js';
7
- import type { AssetDefinition, ProcessedAsset } from '../services/assets/asset-processing-service/assets.types.js';
8
- import type { RuntimeCapabilityDeclaration } from './runtime-capability.js';
9
- export type { RuntimeCapabilityDeclaration, RuntimeCapabilityTag } from './runtime-capability.js';
10
- export declare const INTEGRATION_PLUGIN_ERRORS: {
11
- readonly NOT_INITIALIZED_WITH_APP_CONFIG: "Plugin not initialized with app config";
12
- readonly NOT_INITIALIZED_WITH_ASSET_SERVICE: "Plugin not initialized with asset dependency service";
13
- };
14
- /**
15
- * Base configuration shared by all integration plugins.
16
- *
17
- * @remarks
18
- * Integrations declare their file ownership, optional runtime requirements, and
19
- * any global assets or build-time contributions here. Runtime-only side effects
20
- * belong in `setup()` rather than the constructor.
21
- */
22
- export interface IntegrationPluginConfig {
23
- /**
24
- * The name of the integration plugin.
25
- */
26
- name: string;
27
- /**
28
- * The extensions that this plugin supports (e.g., ['.kita.js', '.kita.tsx']).
29
- */
30
- extensions: string[];
31
- /**
32
- * The dependencies that this plugin requires on a global level.
33
- * These dependencies will be resolved during the setup process and injected into the global scope of the application.
34
- * They are not specific to any particular page or component.
35
- */
36
- integrationDependencies?: AssetDefinition[];
37
- /**
38
- * The strategy to use for static building.
39
- * - 'render': Execute component function directly (faster, efficient).
40
- * - 'fetch': Start server and fetch URL (slower, needed for some SSR like Lit).
41
- * @default 'render'
42
- */
43
- staticBuildStep?: 'render' | 'fetch';
44
- /**
45
- * Declares runtime-specific requirements that must be satisfied before the
46
- * app can start with this integration enabled.
47
- */
48
- runtimeCapability?: RuntimeCapabilityDeclaration;
49
- /**
50
- * JSX import source owned by this integration.
51
- *
52
- * @remarks
53
- * This is primarily used by mixed-JSX flows where host-owned browser bundles
54
- * need to preserve the correct JSX runtime for files claimed by the
55
- * integration.
56
- */
57
- jsxImportSource?: string;
58
- }
59
- type RendererClass<C> = new (options: {
60
- appConfig: EcoPagesAppConfig;
61
- assetProcessingService: AssetProcessingService;
62
- resolvedIntegrationDependencies: ProcessedAsset[];
63
- rendererModules?: unknown;
64
- runtimeOrigin: string;
65
- }) => IntegrationRenderer<C>;
66
- /**
67
- * Base class for framework integrations.
68
- *
69
- * @remarks
70
- * An integration owns three main concerns:
71
- * - which file extensions it claims
72
- * - which renderer class turns those files into HTML
73
- * - which build-time or runtime contributions must be registered for that framework
74
- *
75
- * Core owns lifecycle ordering. Integrations declare contributions through the
76
- * hooks on this class, while `ConfigBuilder.build()` and app startup decide when
77
- * those hooks run.
78
- */
79
- export declare abstract class IntegrationPlugin<C = EcoPagesElement> {
80
- readonly name: string;
81
- readonly extensions: string[];
82
- abstract renderer: RendererClass<C>;
83
- readonly staticBuildStep: 'render' | 'fetch';
84
- readonly runtimeCapability?: RuntimeCapabilityDeclaration;
85
- readonly jsxImportSource?: string;
86
- protected integrationDependencies: AssetDefinition[];
87
- protected resolvedIntegrationDependencies: ProcessedAsset[];
88
- protected options?: Record<string, unknown>;
89
- protected appConfig?: EcoPagesAppConfig;
90
- protected assetProcessingService?: AssetProcessingService;
91
- protected hmrManager?: IHmrManager;
92
- runtimeOrigin: string;
93
- get plugins(): EcoBuildPlugin[];
94
- /**
95
- * Returns build plugins that should only apply to browser-oriented bundles.
96
- *
97
- * @remarks
98
- * Browser-only transforms such as runtime import aliasing belong here so they
99
- * do not affect server bundles or static-page module generation.
100
- */
101
- get browserBuildPlugins(): EcoBuildPlugin[];
102
- /**
103
- * Creates the integration with static declaration-only configuration.
104
- *
105
- * @remarks
106
- * Constructors are expected to stay side-effect free. Build-manifest
107
- * contributions belong in `prepareBuildContributions()` and runtime-only setup
108
- * belongs in `setup()`.
109
- */
110
- constructor(config: IntegrationPluginConfig);
111
- /**
112
- * Attaches the finalized app config to the integration.
113
- *
114
- * Core calls this during config finalization before runtime setup so the
115
- * integration can resolve asset paths and other app-owned services later.
116
- */
117
- setConfig(appConfig: EcoPagesAppConfig): void;
118
- /**
119
- * Records the runtime origin used for page-module loading and renderer setup.
120
- */
121
- setRuntimeOrigin(runtimeOrigin: string): void;
122
- /**
123
- * Returns an HMR strategy for this integration, if applicable.
124
- * The strategy will be registered with the HmrManager during initialization.
125
- *
126
- * @returns HmrStrategy instance or undefined if no custom HMR handling needed
127
- *
128
- * @example
129
- * ```typescript
130
- * getHmrStrategy(): HmrStrategy {
131
- * const context = this.hmrManager!.getDefaultContext();
132
- * return new ReactHmrStrategy(context);
133
- * }
134
- * ```
135
- */
136
- getHmrStrategy?(): HmrStrategy | undefined;
137
- /**
138
- * Returns bare-specifier mappings that should be registered in the active
139
- * runtime specifier registry.
140
- *
141
- * @remarks
142
- * Integrations that own browser runtime bundles can override this to expose
143
- * stable bare specifiers for client-side imports.
144
- *
145
- * Today these mappings are consumed by the development runtime and browser
146
- * bundle aliasing path. They are intentionally generic enough to grow into a
147
- * broader import-map-style facility later without moving framework-specific
148
- * map contents into core.
149
- */
150
- getRuntimeSpecifierMap(): Record<string, string>;
151
- /**
152
- * Attaches the shared HMR manager and registers integration-owned development hooks.
153
- *
154
- * @remarks
155
- * The default implementation registers both runtime bare-specifier mappings and
156
- * the optional integration HMR strategy. Integrations should override this only
157
- * when they need to extend that shared behavior rather than replace it.
158
- */
159
- setHmrManager(hmrManager: IHmrManager): void;
160
- /**
161
- * Creates the asset-processing service used for global integration dependencies.
162
- */
163
- initializeAssetDefinitionService(): void;
164
- /**
165
- * Returns processed global assets resolved during `setup()`.
166
- */
167
- getResolvedIntegrationDependencies(): ProcessedAsset[];
168
- /**
169
- * Creates the shared renderer options owned by core lifecycle setup.
170
- */
171
- protected createRendererOptions(options?: {
172
- rendererModules?: unknown;
173
- }): {
174
- appConfig: EcoPagesAppConfig;
175
- assetProcessingService: AssetProcessingService;
176
- resolvedIntegrationDependencies: ProcessedAsset[];
177
- rendererModules: unknown;
178
- runtimeOrigin: string;
179
- };
180
- /**
181
- * Attaches runtime-only services after a renderer instance has been created.
182
- */
183
- protected attachRendererRuntimeServices<T extends IntegrationRenderer<C>>(renderer: T): T;
184
- /**
185
- * Instantiates the integration renderer with app-owned services.
186
- *
187
- * @remarks
188
- * Renderers are cheap runtime objects. They receive the finalized app config,
189
- * a fresh asset-processing service, integration-global processed assets, and
190
- * any renderer module context supplied by the active runtime.
191
- renderer.name ||= this.name;
192
- */
193
- initializeRenderer(options?: {
194
- rendererModules?: unknown;
195
- }): IntegrationRenderer<C>;
196
- /**
197
- * Prepares build-facing contributions before the app build manifest is sealed.
198
- *
199
- * @remarks
200
- * Integrations can override this when runtime or build plugin declarations must
201
- * be materialized ahead of runtime startup. Runtime-only side effects stay in
202
- * `setup()`.
203
- */
204
- prepareBuildContributions(): Promise<void>;
205
- /**
206
- * Performs runtime-only integration setup after config build has already
207
- * sealed manifest contributions.
208
- */
209
- setup(): Promise<void>;
210
- /**
211
- * Releases runtime resources owned by the integration.
212
- *
213
- * @remarks
214
- * Most integrations do not need custom teardown. Override this only for
215
- * explicit cleanup such as watchers, compiler handles, or runtime registries
216
- * that outlive individual requests.
217
- */
218
- teardown(): Promise<void>;
219
- }
@@ -1,196 +0,0 @@
1
- import { AssetProcessingService } from "../services/assets/asset-processing-service/asset-processing.service.js";
2
- const INTEGRATION_PLUGIN_ERRORS = {
3
- NOT_INITIALIZED_WITH_APP_CONFIG: "Plugin not initialized with app config",
4
- NOT_INITIALIZED_WITH_ASSET_SERVICE: "Plugin not initialized with asset dependency service"
5
- };
6
- class IntegrationPlugin {
7
- name;
8
- extensions;
9
- staticBuildStep;
10
- runtimeCapability;
11
- jsxImportSource;
12
- integrationDependencies;
13
- resolvedIntegrationDependencies = [];
14
- options;
15
- appConfig;
16
- assetProcessingService;
17
- hmrManager;
18
- get plugins() {
19
- return [];
20
- }
21
- /**
22
- * Returns build plugins that should only apply to browser-oriented bundles.
23
- *
24
- * @remarks
25
- * Browser-only transforms such as runtime import aliasing belong here so they
26
- * do not affect server bundles or static-page module generation.
27
- */
28
- get browserBuildPlugins() {
29
- return [];
30
- }
31
- /**
32
- * Creates the integration with static declaration-only configuration.
33
- *
34
- * @remarks
35
- * Constructors are expected to stay side-effect free. Build-manifest
36
- * contributions belong in `prepareBuildContributions()` and runtime-only setup
37
- * belongs in `setup()`.
38
- */
39
- constructor(config) {
40
- this.name = config.name;
41
- this.extensions = config.extensions;
42
- this.integrationDependencies = config.integrationDependencies || [];
43
- this.staticBuildStep = config.staticBuildStep || "render";
44
- this.runtimeCapability = config.runtimeCapability;
45
- this.jsxImportSource = config.jsxImportSource;
46
- }
47
- /**
48
- * Attaches the finalized app config to the integration.
49
- *
50
- * Core calls this during config finalization before runtime setup so the
51
- * integration can resolve asset paths and other app-owned services later.
52
- */
53
- setConfig(appConfig) {
54
- this.appConfig = appConfig;
55
- this.initializeAssetDefinitionService();
56
- }
57
- /**
58
- * Records the runtime origin used for page-module loading and renderer setup.
59
- */
60
- setRuntimeOrigin(runtimeOrigin) {
61
- this.runtimeOrigin = runtimeOrigin;
62
- }
63
- /**
64
- * Returns bare-specifier mappings that should be registered in the active
65
- * runtime specifier registry.
66
- *
67
- * @remarks
68
- * Integrations that own browser runtime bundles can override this to expose
69
- * stable bare specifiers for client-side imports.
70
- *
71
- * Today these mappings are consumed by the development runtime and browser
72
- * bundle aliasing path. They are intentionally generic enough to grow into a
73
- * broader import-map-style facility later without moving framework-specific
74
- * map contents into core.
75
- */
76
- getRuntimeSpecifierMap() {
77
- return {};
78
- }
79
- /**
80
- * Attaches the shared HMR manager and registers integration-owned development hooks.
81
- *
82
- * @remarks
83
- * The default implementation registers both runtime bare-specifier mappings and
84
- * the optional integration HMR strategy. Integrations should override this only
85
- * when they need to extend that shared behavior rather than replace it.
86
- */
87
- setHmrManager(hmrManager) {
88
- this.hmrManager = hmrManager;
89
- hmrManager.registerSpecifierMap(this.getRuntimeSpecifierMap());
90
- const strategy = this.getHmrStrategy?.();
91
- if (strategy) {
92
- hmrManager.registerStrategy(strategy);
93
- }
94
- if (this.assetProcessingService) {
95
- this.assetProcessingService.setHmrManager(hmrManager);
96
- }
97
- }
98
- /**
99
- * Creates the asset-processing service used for global integration dependencies.
100
- */
101
- initializeAssetDefinitionService() {
102
- if (!this.appConfig) throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_APP_CONFIG);
103
- this.assetProcessingService = AssetProcessingService.createWithDefaultProcessors(this.appConfig);
104
- if (this.hmrManager) {
105
- this.assetProcessingService.setHmrManager(this.hmrManager);
106
- }
107
- }
108
- /**
109
- * Returns processed global assets resolved during `setup()`.
110
- */
111
- getResolvedIntegrationDependencies() {
112
- return this.resolvedIntegrationDependencies;
113
- }
114
- /**
115
- * Creates the shared renderer options owned by core lifecycle setup.
116
- */
117
- createRendererOptions(options) {
118
- if (!this.appConfig) {
119
- throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_APP_CONFIG);
120
- }
121
- const assetProcessingService = AssetProcessingService.createWithDefaultProcessors(this.appConfig);
122
- if (this.hmrManager) {
123
- assetProcessingService.setHmrManager(this.hmrManager);
124
- }
125
- return {
126
- appConfig: this.appConfig,
127
- assetProcessingService,
128
- resolvedIntegrationDependencies: this.resolvedIntegrationDependencies,
129
- rendererModules: options?.rendererModules,
130
- runtimeOrigin: this.runtimeOrigin
131
- };
132
- }
133
- /**
134
- * Attaches runtime-only services after a renderer instance has been created.
135
- */
136
- attachRendererRuntimeServices(renderer) {
137
- if (typeof renderer.name !== "string" || renderer.name.length === 0) {
138
- renderer.name = this.name;
139
- }
140
- if (this.hmrManager) {
141
- renderer.setHmrManager(this.hmrManager);
142
- }
143
- return renderer;
144
- }
145
- /**
146
- * Instantiates the integration renderer with app-owned services.
147
- *
148
- * @remarks
149
- * Renderers are cheap runtime objects. They receive the finalized app config,
150
- * a fresh asset-processing service, integration-global processed assets, and
151
- * any renderer module context supplied by the active runtime.
152
- renderer.name ||= this.name;
153
- */
154
- initializeRenderer(options) {
155
- const renderer = new this.renderer(this.createRendererOptions(options));
156
- renderer.name ||= this.name;
157
- return this.attachRendererRuntimeServices(renderer);
158
- }
159
- /**
160
- * Prepares build-facing contributions before the app build manifest is sealed.
161
- *
162
- * @remarks
163
- * Integrations can override this when runtime or build plugin declarations must
164
- * be materialized ahead of runtime startup. Runtime-only side effects stay in
165
- * `setup()`.
166
- */
167
- async prepareBuildContributions() {
168
- }
169
- /**
170
- * Performs runtime-only integration setup after config build has already
171
- * sealed manifest contributions.
172
- */
173
- async setup() {
174
- if (this.integrationDependencies.length === 0) return;
175
- if (!this.assetProcessingService) throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_ASSET_SERVICE);
176
- this.resolvedIntegrationDependencies = await this.assetProcessingService.processDependencies(
177
- this.integrationDependencies,
178
- this.name
179
- );
180
- this.initializeRenderer();
181
- }
182
- /**
183
- * Releases runtime resources owned by the integration.
184
- *
185
- * @remarks
186
- * Most integrations do not need custom teardown. Override this only for
187
- * explicit cleanup such as watchers, compiler handles, or runtime registries
188
- * that outlive individual requests.
189
- */
190
- async teardown() {
191
- }
192
- }
193
- export {
194
- INTEGRATION_PLUGIN_ERRORS,
195
- IntegrationPlugin
196
- };