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

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 (550) hide show
  1. package/README.md +63 -7
  2. package/package.json +73 -249
  3. package/src/adapters/abstract/application-adapter.test.ts +172 -0
  4. package/src/adapters/abstract/application-adapter.ts +379 -0
  5. package/src/adapters/abstract/router-adapter.ts +30 -0
  6. package/src/adapters/abstract/server-adapter.ts +79 -0
  7. package/src/adapters/bun/client-bridge.ts +62 -0
  8. package/src/adapters/bun/create-app.ts +232 -0
  9. package/src/adapters/bun/hmr-manager.test.ts +265 -0
  10. package/src/adapters/bun/hmr-manager.ts +383 -0
  11. package/src/adapters/bun/index.ts +2 -0
  12. package/src/adapters/bun/server-adapter.ts +526 -0
  13. package/src/adapters/bun/server-lifecycle.ts +124 -0
  14. package/src/adapters/create-app.test.ts +10 -0
  15. package/src/adapters/create-app.ts +91 -0
  16. package/src/adapters/index.ts +2 -0
  17. package/src/adapters/node/create-app.test.ts +53 -0
  18. package/src/adapters/node/create-app.ts +183 -0
  19. package/src/adapters/node/node-client-bridge.test.ts +198 -0
  20. package/src/adapters/node/node-client-bridge.ts +79 -0
  21. package/src/adapters/node/node-hmr-manager.test.ts +320 -0
  22. package/src/adapters/node/node-hmr-manager.ts +355 -0
  23. package/src/adapters/node/server-adapter.ts +502 -0
  24. package/src/adapters/node/static-content-server.test.ts +60 -0
  25. package/src/adapters/node/static-content-server.ts +239 -0
  26. package/src/adapters/shared/api-response.test.ts +97 -0
  27. package/src/adapters/shared/api-response.ts +104 -0
  28. package/src/adapters/shared/application-adapter.ts +199 -0
  29. package/src/adapters/shared/define-api-handler.ts +66 -0
  30. package/src/adapters/shared/explicit-static-render-preparation.ts +58 -0
  31. package/src/adapters/shared/explicit-static-route-matcher.test.ts +381 -0
  32. package/src/adapters/shared/explicit-static-route-matcher.ts +131 -0
  33. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +85 -0
  34. package/src/adapters/shared/file-route-middleware-pipeline.ts +118 -0
  35. package/src/adapters/shared/fs-server-response-factory.test.ts +176 -0
  36. package/src/adapters/shared/fs-server-response-factory.ts +96 -0
  37. package/src/adapters/shared/fs-server-response-matcher.test.ts +311 -0
  38. package/src/adapters/shared/fs-server-response-matcher.ts +240 -0
  39. package/src/adapters/shared/hmr-entrypoint-registrar.ts +149 -0
  40. package/src/adapters/shared/hmr-html-response.ts +52 -0
  41. package/src/adapters/shared/hmr-manager.contract.test.ts +228 -0
  42. package/src/adapters/shared/hmr-manager.dispatch.test.ts +220 -0
  43. package/src/adapters/shared/render-context.test.ts +150 -0
  44. package/src/adapters/shared/render-context.ts +123 -0
  45. package/src/adapters/shared/runtime-bootstrap.ts +79 -0
  46. package/src/adapters/shared/server-adapter.test.ts +130 -0
  47. package/src/adapters/shared/server-adapter.ts +562 -0
  48. package/src/adapters/shared/server-route-handler.test.ts +111 -0
  49. package/src/adapters/shared/server-route-handler.ts +153 -0
  50. package/src/adapters/shared/server-static-builder.test.ts +338 -0
  51. package/src/adapters/shared/server-static-builder.ts +170 -0
  52. package/src/build/build-adapter-serialization.test.ts +281 -0
  53. package/src/build/build-adapter.test.ts +1240 -0
  54. package/src/build/build-adapter.ts +1012 -0
  55. package/src/build/build-manifest.ts +54 -0
  56. package/src/build/build-types.ts +83 -0
  57. package/src/build/dev-build-coordinator.ts +220 -0
  58. package/src/build/esbuild-build-adapter.ts +660 -0
  59. package/src/build/runtime-build-executor.test.ts +81 -0
  60. package/src/build/runtime-build-executor.ts +40 -0
  61. package/src/build/runtime-specifier-alias-plugin.test.ts +67 -0
  62. package/src/build/runtime-specifier-alias-plugin.ts +62 -0
  63. package/src/build/runtime-specifier-aliases.ts +135 -0
  64. package/src/config/README.md +1 -1
  65. package/src/config/config-builder.test.ts +442 -0
  66. package/src/config/config-builder.ts +737 -0
  67. package/src/config/config-builder.typecheck.test.ts +96 -0
  68. package/src/config/{constants.d.ts → constants.ts} +22 -13
  69. package/src/dev/host-runtime.ts +34 -0
  70. package/src/dev/sc-server.ts +143 -0
  71. package/src/eco/eco.browser.test.ts +43 -0
  72. package/src/eco/eco.browser.ts +118 -0
  73. package/src/eco/eco.test.ts +654 -0
  74. package/src/eco/eco.ts +205 -0
  75. package/src/eco/eco.types.ts +221 -0
  76. package/src/eco/eco.utils.test.ts +219 -0
  77. package/src/eco/eco.utils.ts +5 -0
  78. package/src/eco/global-injector-map.test.ts +42 -0
  79. package/src/eco/global-injector-map.ts +112 -0
  80. package/src/eco/lazy-injector-map.test.ts +66 -0
  81. package/src/eco/lazy-injector-map.ts +120 -0
  82. package/src/eco/module-dependencies.test.ts +30 -0
  83. package/src/eco/module-dependencies.ts +75 -0
  84. package/src/errors/http-error.test.ts +134 -0
  85. package/src/errors/http-error.ts +72 -0
  86. package/src/errors/index.ts +3 -0
  87. package/src/errors/locals-access-error.ts +7 -0
  88. package/src/global/app-logger.ts +4 -0
  89. package/src/global/utils.test.ts +12 -0
  90. 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
  91. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  92. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  93. package/src/hmr/client/hmr-runtime.ts +162 -0
  94. package/src/hmr/hmr-strategy.test.ts +124 -0
  95. package/src/hmr/hmr-strategy.ts +177 -0
  96. package/src/hmr/hmr.postcss.test.e2e.ts +41 -0
  97. package/src/hmr/hmr.test.e2e.ts +66 -0
  98. package/src/hmr/strategies/default-hmr-strategy.ts +60 -0
  99. package/src/hmr/strategies/js-hmr-strategy.test.ts +334 -0
  100. package/src/hmr/strategies/js-hmr-strategy.ts +314 -0
  101. package/src/index.browser.ts +3 -0
  102. package/src/index.ts +15 -0
  103. package/src/integrations/ghtml/ghtml-renderer.test.ts +253 -0
  104. package/src/integrations/ghtml/ghtml-renderer.ts +87 -0
  105. package/src/integrations/ghtml/ghtml.constants.ts +1 -0
  106. package/src/integrations/ghtml/ghtml.plugin.ts +28 -0
  107. package/src/plugins/alias-resolver-plugin.test.ts +41 -0
  108. package/src/plugins/alias-resolver-plugin.ts +63 -0
  109. package/src/plugins/eco-component-meta-plugin.test.ts +406 -0
  110. package/src/plugins/eco-component-meta-plugin.ts +494 -0
  111. package/src/plugins/foreign-jsx-override-plugin.test.ts +65 -0
  112. package/src/plugins/foreign-jsx-override-plugin.ts +67 -0
  113. package/src/plugins/integration-plugin.test.ts +151 -0
  114. package/src/plugins/integration-plugin.ts +323 -0
  115. package/src/plugins/processor.test.ts +148 -0
  116. package/src/plugins/processor.ts +257 -0
  117. package/src/plugins/{runtime-capability.d.ts → runtime-capability.ts} +8 -3
  118. package/src/plugins/source-transform.test.ts +82 -0
  119. package/src/plugins/source-transform.ts +123 -0
  120. package/src/route-renderer/GRAPH.md +81 -289
  121. package/src/route-renderer/README.md +67 -105
  122. package/src/route-renderer/orchestration/component-render-context.ts +325 -0
  123. package/src/route-renderer/orchestration/declared-ownership-graph.ts +62 -0
  124. package/src/route-renderer/orchestration/foreign-subtree-execution.service.ts +383 -0
  125. package/src/route-renderer/orchestration/integration-renderer.test.ts +2085 -0
  126. package/src/route-renderer/orchestration/integration-renderer.ts +1244 -0
  127. package/src/route-renderer/orchestration/ownership-planning.service.ts +97 -0
  128. package/src/route-renderer/orchestration/ownership-validation.service.ts +76 -0
  129. package/src/route-renderer/orchestration/processed-asset-dedupe.ts +25 -0
  130. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.test.ts +324 -0
  131. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.ts +294 -0
  132. package/src/route-renderer/orchestration/render-output.utils.ts +310 -0
  133. package/src/route-renderer/orchestration/route-render-orchestrator.prepare-render-options.test.ts +644 -0
  134. package/src/route-renderer/orchestration/route-render-orchestrator.test.ts +265 -0
  135. package/src/route-renderer/orchestration/route-render-orchestrator.ts +592 -0
  136. package/src/route-renderer/orchestration/template-serialization.test.ts +110 -0
  137. package/src/route-renderer/orchestration/template-serialization.ts +117 -0
  138. package/src/route-renderer/page-loading/component-dependency-collection.ts +202 -0
  139. package/src/route-renderer/page-loading/declared-asset-collection.ts +153 -0
  140. package/src/route-renderer/page-loading/dependency-resolver.test.ts +761 -0
  141. package/src/route-renderer/page-loading/dependency-resolver.ts +144 -0
  142. package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +75 -0
  143. package/src/route-renderer/page-loading/lazy-entry-collection.ts +167 -0
  144. package/src/route-renderer/page-loading/lazy-trigger-planning.ts +74 -0
  145. package/src/route-renderer/page-loading/module-declaration-aggregation.ts +60 -0
  146. package/src/route-renderer/page-loading/module-declaration-scripts.ts +16 -0
  147. package/src/route-renderer/page-loading/page-dependency-bundling.ts +244 -0
  148. package/src/route-renderer/page-loading/page-module-loader.test.ts +183 -0
  149. package/src/route-renderer/page-loading/page-module-loader.ts +184 -0
  150. package/src/route-renderer/route-renderer.ts +133 -0
  151. package/src/router/README.md +16 -19
  152. package/src/router/client/link-intent.test.browser.ts +51 -0
  153. package/src/router/client/link-intent.ts +92 -0
  154. package/src/router/client/navigation-coordinator.test.ts +237 -0
  155. package/src/router/client/navigation-coordinator.ts +453 -0
  156. package/src/router/server/route-registry.test.ts +176 -0
  157. package/src/router/server/route-registry.ts +382 -0
  158. package/src/services/README.md +1 -2
  159. package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +66 -0
  160. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +473 -0
  161. package/src/services/assets/asset-processing-service/asset-processing.service.ts +344 -0
  162. package/src/services/assets/asset-processing-service/asset.factory.test.ts +63 -0
  163. package/src/services/assets/asset-processing-service/asset.factory.ts +105 -0
  164. package/src/services/assets/asset-processing-service/assets.types.ts +128 -0
  165. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +74 -0
  166. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +96 -0
  167. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +67 -0
  168. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +78 -0
  169. package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +104 -0
  170. package/src/services/assets/asset-processing-service/index.ts +6 -0
  171. package/src/services/assets/asset-processing-service/page-package.test.ts +100 -0
  172. package/src/services/assets/asset-processing-service/page-package.ts +93 -0
  173. package/src/services/assets/asset-processing-service/{processor.interface.d.ts → processor.interface.ts} +10 -5
  174. package/src/services/assets/asset-processing-service/processor.registry.ts +18 -0
  175. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +59 -0
  176. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +83 -0
  177. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +173 -0
  178. package/src/services/assets/asset-processing-service/processors/index.ts +5 -0
  179. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +195 -0
  180. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +137 -0
  181. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +326 -0
  182. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +116 -0
  183. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +227 -0
  184. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +89 -0
  185. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +261 -0
  186. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +72 -0
  187. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +83 -0
  188. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +65 -0
  189. package/src/services/assets/browser-bundle.service.test.ts +66 -0
  190. package/src/services/assets/browser-bundle.service.ts +109 -0
  191. package/src/services/cache/cache.types.ts +126 -0
  192. package/src/services/cache/index.ts +18 -0
  193. package/src/services/cache/memory-cache-store.test.ts +225 -0
  194. package/src/services/cache/memory-cache-store.ts +130 -0
  195. package/src/services/cache/page-cache-service.test.ts +175 -0
  196. package/src/services/cache/page-cache-service.ts +202 -0
  197. package/src/services/cache/page-request-cache-coordinator.service.test.ts +79 -0
  198. package/src/services/cache/page-request-cache-coordinator.service.ts +131 -0
  199. package/src/services/html/html-rewriter-provider.service.test.ts +183 -0
  200. package/src/services/html/html-rewriter-provider.service.ts +104 -0
  201. package/src/services/html/html-transformer.service.test.ts +476 -0
  202. package/src/services/html/html-transformer.service.ts +275 -0
  203. package/src/services/invalidation/development-invalidation.service.test.ts +87 -0
  204. package/src/services/invalidation/development-invalidation.service.ts +262 -0
  205. package/src/services/module-loading/app-module-loader.service.ts +9 -0
  206. package/src/services/module-loading/app-server-module-transpiler.service.test.ts +130 -0
  207. package/src/services/module-loading/app-server-module-transpiler.service.ts +141 -0
  208. package/src/services/module-loading/host-module-loader-registry.ts +15 -0
  209. package/src/services/module-loading/{module-loading-types.d.ts → module-loading-types.ts} +1 -0
  210. package/src/services/module-loading/node-bootstrap-plugin.test.ts +335 -0
  211. package/src/services/module-loading/node-bootstrap-plugin.ts +311 -0
  212. package/src/services/module-loading/page-module-import.service.test.ts +504 -0
  213. package/src/services/module-loading/page-module-import.service.ts +251 -0
  214. package/src/services/module-loading/server-module-transpiler.service.test.ts +243 -0
  215. package/src/services/module-loading/server-module-transpiler.service.ts +104 -0
  216. package/src/services/module-loading/source-module-support.ts +19 -0
  217. package/src/services/runtime-state/dev-graph.service.ts +217 -0
  218. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +136 -0
  219. package/src/services/runtime-state/server-invalidation-state.service.ts +68 -0
  220. package/src/services/validation/schema-validation-service.test.ts +223 -0
  221. package/src/services/validation/schema-validation-service.ts +204 -0
  222. package/src/services/validation/{standard-schema.types.d.ts → standard-schema.types.ts} +20 -17
  223. package/src/static-site-generator/static-site-generator.test.ts +408 -0
  224. package/src/static-site-generator/static-site-generator.ts +445 -0
  225. package/src/types/internal-types.ts +243 -0
  226. package/src/types/public-types.ts +1459 -0
  227. package/src/utils/deep-merge.test.ts +114 -0
  228. package/src/utils/deep-merge.ts +47 -0
  229. package/src/utils/hash.ts +5 -0
  230. package/src/utils/html-escaping.ts +9 -0
  231. package/src/utils/invariant.test.ts +22 -0
  232. package/src/utils/invariant.ts +15 -0
  233. package/src/utils/locals-utils.ts +37 -0
  234. package/src/utils/parse-cli-args.test.ts +69 -0
  235. package/src/utils/parse-cli-args.ts +105 -0
  236. package/src/utils/path-utils.module.ts +14 -0
  237. package/src/utils/path-utils.test.ts +15 -0
  238. package/src/utils/resolve-work-dir.ts +45 -0
  239. package/src/utils/runtime.ts +44 -0
  240. package/src/utils/server-utils.module.ts +67 -0
  241. package/src/utils/server-utils.test.ts +38 -0
  242. package/src/watchers/project-watcher.integration.test.ts +337 -0
  243. package/src/watchers/project-watcher.test-helpers.ts +42 -0
  244. package/src/watchers/project-watcher.test.ts +768 -0
  245. package/src/watchers/project-watcher.ts +357 -0
  246. package/CHANGELOG.md +0 -66
  247. package/src/adapters/abstract/application-adapter.d.ts +0 -194
  248. package/src/adapters/abstract/application-adapter.js +0 -121
  249. package/src/adapters/abstract/router-adapter.d.ts +0 -26
  250. package/src/adapters/abstract/router-adapter.js +0 -5
  251. package/src/adapters/abstract/server-adapter.d.ts +0 -69
  252. package/src/adapters/abstract/server-adapter.js +0 -15
  253. package/src/adapters/bun/client-bridge.d.ts +0 -34
  254. package/src/adapters/bun/client-bridge.js +0 -48
  255. package/src/adapters/bun/create-app.d.ts +0 -52
  256. package/src/adapters/bun/create-app.js +0 -116
  257. package/src/adapters/bun/hmr-manager.d.ts +0 -143
  258. package/src/adapters/bun/hmr-manager.js +0 -333
  259. package/src/adapters/bun/index.d.ts +0 -2
  260. package/src/adapters/bun/index.js +0 -8
  261. package/src/adapters/bun/server-adapter.d.ts +0 -155
  262. package/src/adapters/bun/server-adapter.js +0 -374
  263. package/src/adapters/bun/server-lifecycle.d.ts +0 -63
  264. package/src/adapters/bun/server-lifecycle.js +0 -92
  265. package/src/adapters/create-app.d.ts +0 -20
  266. package/src/adapters/create-app.js +0 -66
  267. package/src/adapters/index.d.ts +0 -2
  268. package/src/adapters/index.js +0 -8
  269. package/src/adapters/node/create-app.d.ts +0 -18
  270. package/src/adapters/node/create-app.js +0 -149
  271. package/src/adapters/node/node-client-bridge.d.ts +0 -26
  272. package/src/adapters/node/node-client-bridge.js +0 -66
  273. package/src/adapters/node/node-hmr-manager.d.ts +0 -133
  274. package/src/adapters/node/node-hmr-manager.js +0 -311
  275. package/src/adapters/node/server-adapter.d.ts +0 -162
  276. package/src/adapters/node/server-adapter.js +0 -368
  277. package/src/adapters/node/static-content-server.d.ts +0 -60
  278. package/src/adapters/node/static-content-server.js +0 -194
  279. package/src/adapters/shared/api-response.d.ts +0 -52
  280. package/src/adapters/shared/api-response.js +0 -96
  281. package/src/adapters/shared/application-adapter.d.ts +0 -18
  282. package/src/adapters/shared/application-adapter.js +0 -90
  283. package/src/adapters/shared/define-api-handler.d.ts +0 -25
  284. package/src/adapters/shared/define-api-handler.js +0 -15
  285. package/src/adapters/shared/explicit-static-route-matcher.d.ts +0 -38
  286. package/src/adapters/shared/explicit-static-route-matcher.js +0 -103
  287. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +0 -65
  288. package/src/adapters/shared/file-route-middleware-pipeline.js +0 -99
  289. package/src/adapters/shared/fs-server-response-factory.d.ts +0 -19
  290. package/src/adapters/shared/fs-server-response-factory.js +0 -97
  291. package/src/adapters/shared/fs-server-response-matcher.d.ts +0 -67
  292. package/src/adapters/shared/fs-server-response-matcher.js +0 -147
  293. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +0 -55
  294. package/src/adapters/shared/hmr-entrypoint-registrar.js +0 -87
  295. package/src/adapters/shared/hmr-html-response.d.ts +0 -22
  296. package/src/adapters/shared/hmr-html-response.js +0 -32
  297. package/src/adapters/shared/render-context.d.ts +0 -15
  298. package/src/adapters/shared/render-context.js +0 -72
  299. package/src/adapters/shared/runtime-bootstrap.d.ts +0 -38
  300. package/src/adapters/shared/runtime-bootstrap.js +0 -43
  301. package/src/adapters/shared/server-adapter.d.ts +0 -97
  302. package/src/adapters/shared/server-adapter.js +0 -390
  303. package/src/adapters/shared/server-route-handler.d.ts +0 -89
  304. package/src/adapters/shared/server-route-handler.js +0 -111
  305. package/src/adapters/shared/server-static-builder.d.ts +0 -71
  306. package/src/adapters/shared/server-static-builder.js +0 -100
  307. package/src/build/build-adapter.d.ts +0 -239
  308. package/src/build/build-adapter.js +0 -642
  309. package/src/build/build-manifest.d.ts +0 -27
  310. package/src/build/build-manifest.js +0 -30
  311. package/src/build/build-types.d.ts +0 -57
  312. package/src/build/build-types.js +0 -0
  313. package/src/build/dev-build-coordinator.d.ts +0 -72
  314. package/src/build/dev-build-coordinator.js +0 -154
  315. package/src/build/esbuild-build-adapter.d.ts +0 -78
  316. package/src/build/esbuild-build-adapter.js +0 -505
  317. package/src/build/runtime-build-executor.d.ts +0 -14
  318. package/src/build/runtime-build-executor.js +0 -22
  319. package/src/build/runtime-specifier-alias-plugin.d.ts +0 -15
  320. package/src/build/runtime-specifier-alias-plugin.js +0 -35
  321. package/src/build/runtime-specifier-aliases.d.ts +0 -5
  322. package/src/build/runtime-specifier-aliases.js +0 -95
  323. package/src/config/config-builder.d.ts +0 -252
  324. package/src/config/config-builder.js +0 -603
  325. package/src/config/constants.js +0 -25
  326. package/src/dev/sc-server.d.ts +0 -30
  327. package/src/dev/sc-server.js +0 -111
  328. package/src/eco/eco.browser.d.ts +0 -2
  329. package/src/eco/eco.browser.js +0 -83
  330. package/src/eco/eco.d.ts +0 -9
  331. package/src/eco/eco.js +0 -85
  332. package/src/eco/eco.types.d.ts +0 -178
  333. package/src/eco/eco.types.js +0 -0
  334. package/src/eco/eco.utils.d.ts +0 -1
  335. package/src/eco/eco.utils.js +0 -10
  336. package/src/eco/global-injector-map.d.ts +0 -16
  337. package/src/eco/global-injector-map.js +0 -80
  338. package/src/eco/lazy-injector-map.d.ts +0 -8
  339. package/src/eco/lazy-injector-map.js +0 -70
  340. package/src/eco/module-dependencies.d.ts +0 -18
  341. package/src/eco/module-dependencies.js +0 -49
  342. package/src/errors/http-error.d.ts +0 -31
  343. package/src/errors/http-error.js +0 -50
  344. package/src/errors/index.d.ts +0 -2
  345. package/src/errors/index.js +0 -4
  346. package/src/errors/locals-access-error.d.ts +0 -4
  347. package/src/errors/locals-access-error.js +0 -9
  348. package/src/global/app-logger.d.ts +0 -2
  349. package/src/global/app-logger.js +0 -6
  350. package/src/hmr/client/hmr-runtime.d.ts +0 -5
  351. package/src/hmr/client/hmr-runtime.js +0 -117
  352. package/src/hmr/hmr-strategy.d.ts +0 -162
  353. package/src/hmr/hmr-strategy.js +0 -44
  354. package/src/hmr/hmr.postcss.test.e2e.d.ts +0 -1
  355. package/src/hmr/hmr.postcss.test.e2e.js +0 -31
  356. package/src/hmr/hmr.test.e2e.d.ts +0 -1
  357. package/src/hmr/hmr.test.e2e.js +0 -43
  358. package/src/hmr/strategies/default-hmr-strategy.d.ts +0 -43
  359. package/src/hmr/strategies/default-hmr-strategy.js +0 -34
  360. package/src/hmr/strategies/js-hmr-strategy.d.ts +0 -139
  361. package/src/hmr/strategies/js-hmr-strategy.js +0 -178
  362. package/src/index.browser.d.ts +0 -3
  363. package/src/index.browser.js +0 -4
  364. package/src/index.d.ts +0 -6
  365. package/src/index.js +0 -21
  366. package/src/integrations/ghtml/ghtml-renderer.d.ts +0 -20
  367. package/src/integrations/ghtml/ghtml-renderer.js +0 -63
  368. package/src/integrations/ghtml/ghtml.constants.d.ts +0 -1
  369. package/src/integrations/ghtml/ghtml.constants.js +0 -4
  370. package/src/integrations/ghtml/ghtml.plugin.d.ts +0 -16
  371. package/src/integrations/ghtml/ghtml.plugin.js +0 -20
  372. package/src/plugins/alias-resolver-plugin.d.ts +0 -2
  373. package/src/plugins/alias-resolver-plugin.js +0 -53
  374. package/src/plugins/eco-component-meta-plugin.d.ts +0 -108
  375. package/src/plugins/eco-component-meta-plugin.js +0 -163
  376. package/src/plugins/foreign-jsx-override-plugin.d.ts +0 -31
  377. package/src/plugins/foreign-jsx-override-plugin.js +0 -35
  378. package/src/plugins/integration-plugin.d.ts +0 -219
  379. package/src/plugins/integration-plugin.js +0 -196
  380. package/src/plugins/processor.d.ts +0 -95
  381. package/src/plugins/processor.js +0 -136
  382. package/src/plugins/runtime-capability.js +0 -0
  383. package/src/plugins/source-transform.d.ts +0 -46
  384. package/src/plugins/source-transform.js +0 -71
  385. package/src/route-renderer/orchestration/boundary-planning.service.d.ts +0 -25
  386. package/src/route-renderer/orchestration/boundary-planning.service.js +0 -97
  387. package/src/route-renderer/orchestration/component-render-context.d.ts +0 -83
  388. package/src/route-renderer/orchestration/component-render-context.js +0 -147
  389. package/src/route-renderer/orchestration/integration-renderer.d.ts +0 -556
  390. package/src/route-renderer/orchestration/integration-renderer.js +0 -932
  391. package/src/route-renderer/orchestration/page-packaging.service.d.ts +0 -16
  392. package/src/route-renderer/orchestration/page-packaging.service.js +0 -66
  393. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +0 -2
  394. package/src/route-renderer/orchestration/processed-asset-dedupe.js +0 -23
  395. package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +0 -89
  396. package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +0 -155
  397. package/src/route-renderer/orchestration/render-execution.service.d.ts +0 -43
  398. package/src/route-renderer/orchestration/render-execution.service.js +0 -106
  399. package/src/route-renderer/orchestration/render-output.utils.d.ts +0 -66
  400. package/src/route-renderer/orchestration/render-output.utils.js +0 -171
  401. package/src/route-renderer/orchestration/render-preparation.service.d.ts +0 -120
  402. package/src/route-renderer/orchestration/render-preparation.service.js +0 -364
  403. package/src/route-renderer/orchestration/route-shell-composer.service.d.ts +0 -50
  404. package/src/route-renderer/orchestration/route-shell-composer.service.js +0 -81
  405. package/src/route-renderer/orchestration/template-serialization.d.ts +0 -38
  406. package/src/route-renderer/orchestration/template-serialization.js +0 -45
  407. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +0 -37
  408. package/src/route-renderer/page-loading/component-dependency-collection.js +0 -125
  409. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +0 -24
  410. package/src/route-renderer/page-loading/declared-asset-collection.js +0 -106
  411. package/src/route-renderer/page-loading/dependency-resolver.d.ts +0 -35
  412. package/src/route-renderer/page-loading/dependency-resolver.js +0 -117
  413. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +0 -11
  414. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +0 -57
  415. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +0 -45
  416. package/src/route-renderer/page-loading/lazy-entry-collection.js +0 -105
  417. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +0 -19
  418. package/src/route-renderer/page-loading/lazy-trigger-planning.js +0 -40
  419. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +0 -5
  420. package/src/route-renderer/page-loading/module-declaration-aggregation.js +0 -33
  421. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +0 -3
  422. package/src/route-renderer/page-loading/module-declaration-scripts.js +0 -18
  423. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +0 -13
  424. package/src/route-renderer/page-loading/page-dependency-bundling.js +0 -115
  425. package/src/route-renderer/page-loading/page-module-loader.d.ts +0 -90
  426. package/src/route-renderer/page-loading/page-module-loader.js +0 -127
  427. package/src/route-renderer/route-renderer.d.ts +0 -67
  428. package/src/route-renderer/route-renderer.js +0 -103
  429. package/src/router/client/link-intent.js +0 -34
  430. package/src/router/client/link-intent.test.browser.d.ts +0 -1
  431. package/src/router/client/link-intent.test.browser.js +0 -43
  432. package/src/router/client/navigation-coordinator.d.ts +0 -169
  433. package/src/router/client/navigation-coordinator.js +0 -215
  434. package/src/router/server/fs-router-scanner.d.ts +0 -41
  435. package/src/router/server/fs-router-scanner.js +0 -161
  436. package/src/router/server/fs-router.d.ts +0 -26
  437. package/src/router/server/fs-router.js +0 -100
  438. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +0 -3
  439. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +0 -56
  440. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +0 -103
  441. package/src/services/assets/asset-processing-service/asset-processing.service.js +0 -285
  442. package/src/services/assets/asset-processing-service/asset.factory.d.ts +0 -17
  443. package/src/services/assets/asset-processing-service/asset.factory.js +0 -82
  444. package/src/services/assets/asset-processing-service/assets.types.d.ts +0 -100
  445. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  446. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +0 -55
  447. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +0 -49
  448. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +0 -20
  449. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +0 -41
  450. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +0 -30
  451. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +0 -65
  452. package/src/services/assets/asset-processing-service/index.d.ts +0 -5
  453. package/src/services/assets/asset-processing-service/index.js +0 -5
  454. package/src/services/assets/asset-processing-service/processor.interface.js +0 -6
  455. package/src/services/assets/asset-processing-service/processor.registry.d.ts +0 -8
  456. package/src/services/assets/asset-processing-service/processor.registry.js +0 -15
  457. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +0 -24
  458. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +0 -65
  459. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +0 -22
  460. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +0 -136
  461. package/src/services/assets/asset-processing-service/processors/index.d.ts +0 -5
  462. package/src/services/assets/asset-processing-service/processors/index.js +0 -5
  463. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +0 -6
  464. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +0 -116
  465. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +0 -9
  466. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +0 -91
  467. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +0 -7
  468. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +0 -77
  469. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +0 -8
  470. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -58
  471. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +0 -9
  472. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +0 -67
  473. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +0 -18
  474. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +0 -45
  475. package/src/services/assets/browser-bundle.service.d.ts +0 -73
  476. package/src/services/assets/browser-bundle.service.js +0 -41
  477. package/src/services/cache/cache.types.d.ts +0 -107
  478. package/src/services/cache/cache.types.js +0 -0
  479. package/src/services/cache/index.d.ts +0 -7
  480. package/src/services/cache/index.js +0 -7
  481. package/src/services/cache/memory-cache-store.d.ts +0 -42
  482. package/src/services/cache/memory-cache-store.js +0 -98
  483. package/src/services/cache/page-cache-service.d.ts +0 -70
  484. package/src/services/cache/page-cache-service.js +0 -152
  485. package/src/services/cache/page-request-cache-coordinator.service.d.ts +0 -75
  486. package/src/services/cache/page-request-cache-coordinator.service.js +0 -109
  487. package/src/services/html/html-rewriter-provider.service.d.ts +0 -37
  488. package/src/services/html/html-rewriter-provider.service.js +0 -68
  489. package/src/services/html/html-transformer.service.d.ts +0 -87
  490. package/src/services/html/html-transformer.service.js +0 -216
  491. package/src/services/invalidation/development-invalidation.service.d.ts +0 -74
  492. package/src/services/invalidation/development-invalidation.service.js +0 -190
  493. package/src/services/module-loading/app-module-loader.service.d.ts +0 -7
  494. package/src/services/module-loading/app-module-loader.service.js +0 -0
  495. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +0 -24
  496. package/src/services/module-loading/app-server-module-transpiler.service.js +0 -115
  497. package/src/services/module-loading/host-module-loader-registry.d.ts +0 -4
  498. package/src/services/module-loading/host-module-loader-registry.js +0 -15
  499. package/src/services/module-loading/module-loading-types.js +0 -0
  500. package/src/services/module-loading/node-bootstrap-plugin.d.ts +0 -42
  501. package/src/services/module-loading/node-bootstrap-plugin.js +0 -204
  502. package/src/services/module-loading/page-module-import.service.d.ts +0 -76
  503. package/src/services/module-loading/page-module-import.service.js +0 -170
  504. package/src/services/module-loading/server-module-transpiler.service.d.ts +0 -63
  505. package/src/services/module-loading/server-module-transpiler.service.js +0 -64
  506. package/src/services/module-loading/source-module-support.d.ts +0 -5
  507. package/src/services/module-loading/source-module-support.js +0 -8
  508. package/src/services/runtime-state/dev-graph.service.d.ts +0 -118
  509. package/src/services/runtime-state/dev-graph.service.js +0 -162
  510. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +0 -41
  511. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +0 -85
  512. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +0 -69
  513. package/src/services/runtime-state/runtime-specifier-registry.service.js +0 -37
  514. package/src/services/runtime-state/server-invalidation-state.service.d.ts +0 -26
  515. package/src/services/runtime-state/server-invalidation-state.service.js +0 -35
  516. package/src/services/validation/schema-validation-service.d.ts +0 -122
  517. package/src/services/validation/schema-validation-service.js +0 -101
  518. package/src/services/validation/standard-schema.types.js +0 -0
  519. package/src/static-site-generator/static-site-generator.d.ts +0 -105
  520. package/src/static-site-generator/static-site-generator.js +0 -349
  521. package/src/types/internal-types.d.ts +0 -231
  522. package/src/types/internal-types.js +0 -0
  523. package/src/types/public-types.d.ts +0 -1257
  524. package/src/types/public-types.js +0 -0
  525. package/src/utils/deep-merge.d.ts +0 -14
  526. package/src/utils/deep-merge.js +0 -32
  527. package/src/utils/hash.d.ts +0 -1
  528. package/src/utils/hash.js +0 -7
  529. package/src/utils/html-escaping.d.ts +0 -7
  530. package/src/utils/html-escaping.js +0 -6
  531. package/src/utils/html.js +0 -4
  532. package/src/utils/invariant.d.ts +0 -5
  533. package/src/utils/invariant.js +0 -11
  534. package/src/utils/locals-utils.d.ts +0 -15
  535. package/src/utils/locals-utils.js +0 -24
  536. package/src/utils/parse-cli-args.d.ts +0 -27
  537. package/src/utils/parse-cli-args.js +0 -62
  538. package/src/utils/path-utils.module.d.ts +0 -5
  539. package/src/utils/path-utils.module.js +0 -14
  540. package/src/utils/resolve-work-dir.d.ts +0 -11
  541. package/src/utils/resolve-work-dir.js +0 -31
  542. package/src/utils/runtime.d.ts +0 -11
  543. package/src/utils/runtime.js +0 -40
  544. package/src/utils/server-utils.module.d.ts +0 -19
  545. package/src/utils/server-utils.module.js +0 -56
  546. package/src/watchers/project-watcher.d.ts +0 -136
  547. package/src/watchers/project-watcher.js +0 -275
  548. package/src/watchers/project-watcher.test-helpers.d.ts +0 -4
  549. package/src/watchers/project-watcher.test-helpers.js +0 -52
  550. /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
- };