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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (543) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/package.json +226 -93
  3. package/src/adapters/abstract/application-adapter.d.ts +194 -0
  4. package/src/adapters/abstract/application-adapter.js +121 -0
  5. package/src/adapters/abstract/router-adapter.d.ts +26 -0
  6. package/src/adapters/abstract/router-adapter.js +5 -0
  7. package/src/adapters/abstract/server-adapter.d.ts +69 -0
  8. package/src/adapters/abstract/server-adapter.js +15 -0
  9. package/src/adapters/bun/client-bridge.d.ts +34 -0
  10. package/src/adapters/bun/client-bridge.js +48 -0
  11. package/src/adapters/bun/create-app.d.ts +52 -0
  12. package/src/adapters/bun/create-app.js +116 -0
  13. package/src/adapters/bun/hmr-manager.d.ts +143 -0
  14. package/src/adapters/bun/hmr-manager.js +333 -0
  15. package/src/adapters/bun/index.d.ts +2 -0
  16. package/src/adapters/bun/index.js +8 -0
  17. package/src/adapters/bun/server-adapter.d.ts +155 -0
  18. package/src/adapters/bun/server-adapter.js +374 -0
  19. package/src/adapters/bun/server-lifecycle.d.ts +63 -0
  20. package/src/adapters/bun/server-lifecycle.js +92 -0
  21. package/src/adapters/create-app.d.ts +20 -0
  22. package/src/adapters/create-app.js +66 -0
  23. package/src/adapters/index.d.ts +2 -0
  24. package/src/adapters/index.js +8 -0
  25. package/src/adapters/node/create-app.d.ts +18 -0
  26. package/src/adapters/node/create-app.js +149 -0
  27. package/src/adapters/node/node-client-bridge.d.ts +26 -0
  28. package/src/adapters/node/node-client-bridge.js +66 -0
  29. package/src/adapters/node/node-hmr-manager.d.ts +133 -0
  30. package/src/adapters/node/node-hmr-manager.js +311 -0
  31. package/src/adapters/node/server-adapter.d.ts +162 -0
  32. package/src/adapters/node/server-adapter.js +368 -0
  33. package/src/adapters/node/static-content-server.d.ts +60 -0
  34. package/src/adapters/node/static-content-server.js +194 -0
  35. package/src/adapters/shared/api-response.d.ts +52 -0
  36. package/src/adapters/shared/api-response.js +96 -0
  37. package/src/adapters/shared/application-adapter.d.ts +18 -0
  38. package/src/adapters/shared/application-adapter.js +90 -0
  39. package/src/adapters/shared/define-api-handler.d.ts +25 -0
  40. package/src/adapters/shared/define-api-handler.js +15 -0
  41. package/src/adapters/shared/explicit-static-route-matcher.d.ts +38 -0
  42. package/src/adapters/shared/explicit-static-route-matcher.js +103 -0
  43. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +65 -0
  44. package/src/adapters/shared/file-route-middleware-pipeline.js +99 -0
  45. package/src/adapters/shared/fs-server-response-factory.d.ts +19 -0
  46. package/src/adapters/shared/fs-server-response-factory.js +97 -0
  47. package/src/adapters/shared/fs-server-response-matcher.d.ts +67 -0
  48. package/src/adapters/shared/fs-server-response-matcher.js +147 -0
  49. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  50. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  51. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  52. package/src/adapters/shared/hmr-html-response.js +32 -0
  53. package/src/adapters/shared/render-context.d.ts +15 -0
  54. package/src/adapters/shared/render-context.js +72 -0
  55. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  56. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  57. package/src/adapters/shared/server-adapter.d.ts +97 -0
  58. package/src/adapters/shared/server-adapter.js +390 -0
  59. package/src/adapters/shared/server-route-handler.d.ts +89 -0
  60. package/src/adapters/shared/server-route-handler.js +111 -0
  61. package/src/adapters/shared/server-static-builder.d.ts +71 -0
  62. package/src/adapters/shared/server-static-builder.js +100 -0
  63. package/src/build/build-adapter.d.ts +239 -0
  64. package/src/build/build-adapter.js +642 -0
  65. package/src/build/build-manifest.d.ts +27 -0
  66. package/src/build/build-manifest.js +30 -0
  67. package/src/build/build-types.d.ts +57 -0
  68. package/src/build/build-types.js +0 -0
  69. package/src/build/dev-build-coordinator.d.ts +72 -0
  70. package/src/build/dev-build-coordinator.js +154 -0
  71. package/src/build/esbuild-build-adapter.d.ts +78 -0
  72. package/src/build/esbuild-build-adapter.js +505 -0
  73. package/src/build/runtime-build-executor.d.ts +14 -0
  74. package/src/build/runtime-build-executor.js +22 -0
  75. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  76. package/src/build/runtime-specifier-alias-plugin.js +35 -0
  77. package/src/build/runtime-specifier-aliases.d.ts +5 -0
  78. package/src/build/runtime-specifier-aliases.js +95 -0
  79. package/src/config/config-builder.d.ts +252 -0
  80. package/src/config/config-builder.js +603 -0
  81. package/src/config/{constants.ts → constants.d.ts} +13 -22
  82. package/src/config/constants.js +25 -0
  83. package/src/dev/sc-server.d.ts +30 -0
  84. package/src/dev/sc-server.js +111 -0
  85. package/src/eco/eco.browser.d.ts +2 -0
  86. package/src/eco/eco.browser.js +83 -0
  87. package/src/eco/eco.d.ts +9 -0
  88. package/src/eco/eco.js +85 -0
  89. package/src/eco/eco.types.d.ts +178 -0
  90. package/src/eco/eco.types.js +0 -0
  91. package/src/eco/eco.utils.d.ts +1 -0
  92. package/src/eco/eco.utils.js +10 -0
  93. package/src/eco/global-injector-map.d.ts +16 -0
  94. package/src/eco/global-injector-map.js +80 -0
  95. package/src/eco/lazy-injector-map.d.ts +8 -0
  96. package/src/eco/lazy-injector-map.js +70 -0
  97. package/src/eco/module-dependencies.d.ts +18 -0
  98. package/src/eco/module-dependencies.js +49 -0
  99. package/src/errors/http-error.d.ts +31 -0
  100. package/src/errors/http-error.js +50 -0
  101. package/src/errors/{index.ts → index.d.ts} +2 -2
  102. package/src/errors/index.js +4 -0
  103. package/src/errors/locals-access-error.d.ts +4 -0
  104. package/src/errors/locals-access-error.js +9 -0
  105. package/src/global/app-logger.d.ts +2 -0
  106. package/src/global/app-logger.js +6 -0
  107. package/src/hmr/client/hmr-runtime.d.ts +5 -0
  108. package/src/hmr/client/hmr-runtime.js +117 -0
  109. package/src/hmr/hmr-strategy.d.ts +162 -0
  110. package/src/hmr/hmr-strategy.js +44 -0
  111. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  112. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  113. package/src/hmr/hmr.test.e2e.d.ts +1 -0
  114. package/src/hmr/hmr.test.e2e.js +43 -0
  115. package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
  116. package/src/hmr/strategies/default-hmr-strategy.js +34 -0
  117. package/src/hmr/strategies/js-hmr-strategy.d.ts +139 -0
  118. package/src/hmr/strategies/js-hmr-strategy.js +178 -0
  119. package/src/index.browser.d.ts +3 -0
  120. package/src/index.browser.js +4 -0
  121. package/src/index.d.ts +6 -0
  122. package/src/index.js +21 -0
  123. package/src/integrations/ghtml/ghtml-renderer.d.ts +20 -0
  124. package/src/integrations/ghtml/ghtml-renderer.js +63 -0
  125. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  126. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  127. package/src/integrations/ghtml/ghtml.plugin.d.ts +16 -0
  128. package/src/integrations/ghtml/ghtml.plugin.js +20 -0
  129. package/src/plugins/alias-resolver-plugin.d.ts +2 -0
  130. package/src/plugins/alias-resolver-plugin.js +53 -0
  131. package/src/plugins/eco-component-meta-plugin.d.ts +108 -0
  132. package/src/plugins/eco-component-meta-plugin.js +163 -0
  133. package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
  134. package/src/plugins/foreign-jsx-override-plugin.js +35 -0
  135. package/src/plugins/integration-plugin.d.ts +219 -0
  136. package/src/plugins/integration-plugin.js +196 -0
  137. package/src/plugins/processor.d.ts +95 -0
  138. package/src/plugins/processor.js +136 -0
  139. package/src/plugins/{runtime-capability.ts → runtime-capability.d.ts} +3 -8
  140. package/src/plugins/runtime-capability.js +0 -0
  141. package/src/plugins/source-transform.d.ts +46 -0
  142. package/src/plugins/source-transform.js +71 -0
  143. package/src/route-renderer/orchestration/boundary-planning.service.d.ts +25 -0
  144. package/src/route-renderer/orchestration/boundary-planning.service.js +97 -0
  145. package/src/route-renderer/orchestration/component-render-context.d.ts +83 -0
  146. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  147. package/src/route-renderer/orchestration/integration-renderer.d.ts +556 -0
  148. package/src/route-renderer/orchestration/integration-renderer.js +932 -0
  149. package/src/route-renderer/orchestration/page-packaging.service.d.ts +16 -0
  150. package/src/route-renderer/orchestration/page-packaging.service.js +66 -0
  151. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +2 -0
  152. package/src/route-renderer/orchestration/processed-asset-dedupe.js +23 -0
  153. package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +89 -0
  154. package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +155 -0
  155. package/src/route-renderer/orchestration/render-execution.service.d.ts +43 -0
  156. package/src/route-renderer/orchestration/render-execution.service.js +106 -0
  157. package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
  158. package/src/route-renderer/orchestration/render-output.utils.js +171 -0
  159. package/src/route-renderer/orchestration/render-preparation.service.d.ts +120 -0
  160. package/src/route-renderer/orchestration/render-preparation.service.js +364 -0
  161. package/src/route-renderer/orchestration/route-shell-composer.service.d.ts +50 -0
  162. package/src/route-renderer/orchestration/route-shell-composer.service.js +81 -0
  163. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  164. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  165. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
  166. package/src/route-renderer/page-loading/component-dependency-collection.js +125 -0
  167. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
  168. package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
  169. package/src/route-renderer/page-loading/dependency-resolver.d.ts +35 -0
  170. package/src/route-renderer/page-loading/dependency-resolver.js +117 -0
  171. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
  172. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
  173. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
  174. package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
  175. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
  176. package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
  177. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
  178. package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
  179. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
  180. package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
  181. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
  182. package/src/route-renderer/page-loading/page-dependency-bundling.js +115 -0
  183. package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
  184. package/src/route-renderer/page-loading/page-module-loader.js +127 -0
  185. package/src/route-renderer/route-renderer.d.ts +67 -0
  186. package/src/route-renderer/route-renderer.js +103 -0
  187. package/src/router/client/link-intent.js +34 -0
  188. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  189. package/src/router/client/link-intent.test.browser.js +43 -0
  190. package/src/router/client/navigation-coordinator.d.ts +169 -0
  191. package/src/router/client/navigation-coordinator.js +215 -0
  192. package/src/router/server/fs-router-scanner.d.ts +41 -0
  193. package/src/router/server/fs-router-scanner.js +161 -0
  194. package/src/router/server/fs-router.d.ts +26 -0
  195. package/src/router/server/fs-router.js +100 -0
  196. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
  197. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
  198. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +103 -0
  199. package/src/services/assets/asset-processing-service/asset-processing.service.js +285 -0
  200. package/src/services/assets/asset-processing-service/asset.factory.d.ts +17 -0
  201. package/src/services/assets/asset-processing-service/asset.factory.js +82 -0
  202. package/src/services/assets/asset-processing-service/assets.types.d.ts +100 -0
  203. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  204. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  205. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +49 -0
  206. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  207. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  208. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
  209. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
  210. package/src/services/assets/asset-processing-service/index.d.ts +5 -0
  211. package/src/services/assets/asset-processing-service/index.js +5 -0
  212. package/src/services/assets/asset-processing-service/{processor.interface.ts → processor.interface.d.ts} +5 -10
  213. package/src/services/assets/asset-processing-service/processor.interface.js +6 -0
  214. package/src/services/assets/asset-processing-service/processor.registry.d.ts +8 -0
  215. package/src/services/assets/asset-processing-service/processor.registry.js +15 -0
  216. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +24 -0
  217. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +65 -0
  218. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +22 -0
  219. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +136 -0
  220. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  221. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  222. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +6 -0
  223. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +116 -0
  224. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +9 -0
  225. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +91 -0
  226. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
  227. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +77 -0
  228. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +8 -0
  229. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +58 -0
  230. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
  231. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +67 -0
  232. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
  233. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
  234. package/src/services/assets/browser-bundle.service.d.ts +73 -0
  235. package/src/services/assets/browser-bundle.service.js +41 -0
  236. package/src/services/cache/cache.types.d.ts +107 -0
  237. package/src/services/cache/cache.types.js +0 -0
  238. package/src/services/cache/index.d.ts +7 -0
  239. package/src/services/cache/index.js +7 -0
  240. package/src/services/cache/memory-cache-store.d.ts +42 -0
  241. package/src/services/cache/memory-cache-store.js +98 -0
  242. package/src/services/cache/page-cache-service.d.ts +70 -0
  243. package/src/services/cache/page-cache-service.js +152 -0
  244. package/src/services/cache/page-request-cache-coordinator.service.d.ts +75 -0
  245. package/src/services/cache/page-request-cache-coordinator.service.js +109 -0
  246. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  247. package/src/services/html/html-rewriter-provider.service.js +68 -0
  248. package/src/services/html/html-transformer.service.d.ts +87 -0
  249. package/src/services/html/html-transformer.service.js +216 -0
  250. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  251. package/src/services/invalidation/development-invalidation.service.js +190 -0
  252. package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
  253. package/src/services/module-loading/app-module-loader.service.js +0 -0
  254. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
  255. package/src/services/module-loading/app-server-module-transpiler.service.js +115 -0
  256. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  257. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  258. package/src/services/module-loading/{module-loading-types.ts → module-loading-types.d.ts} +0 -1
  259. package/src/services/module-loading/module-loading-types.js +0 -0
  260. package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
  261. package/src/services/module-loading/node-bootstrap-plugin.js +204 -0
  262. package/src/services/module-loading/page-module-import.service.d.ts +76 -0
  263. package/src/services/module-loading/page-module-import.service.js +170 -0
  264. package/src/services/module-loading/server-module-transpiler.service.d.ts +63 -0
  265. package/src/services/module-loading/server-module-transpiler.service.js +64 -0
  266. package/src/services/module-loading/source-module-support.d.ts +5 -0
  267. package/src/services/module-loading/source-module-support.js +8 -0
  268. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  269. package/src/services/runtime-state/dev-graph.service.js +162 -0
  270. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  271. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  272. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +69 -0
  273. package/src/services/runtime-state/runtime-specifier-registry.service.js +37 -0
  274. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  275. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  276. package/src/services/validation/schema-validation-service.d.ts +122 -0
  277. package/src/services/validation/schema-validation-service.js +101 -0
  278. package/src/services/validation/{standard-schema.types.ts → standard-schema.types.d.ts} +17 -20
  279. package/src/services/validation/standard-schema.types.js +0 -0
  280. package/src/static-site-generator/static-site-generator.d.ts +105 -0
  281. package/src/static-site-generator/static-site-generator.js +349 -0
  282. package/src/types/internal-types.d.ts +231 -0
  283. package/src/types/internal-types.js +0 -0
  284. package/src/types/public-types.d.ts +1257 -0
  285. package/src/types/public-types.js +0 -0
  286. package/src/utils/deep-merge.d.ts +14 -0
  287. package/src/utils/deep-merge.js +32 -0
  288. package/src/utils/hash.d.ts +1 -0
  289. package/src/utils/hash.js +7 -0
  290. package/src/utils/html-escaping.d.ts +7 -0
  291. package/src/utils/html-escaping.js +6 -0
  292. package/src/utils/html.js +4 -0
  293. package/src/utils/invariant.d.ts +5 -0
  294. package/src/utils/invariant.js +11 -0
  295. package/src/utils/locals-utils.d.ts +15 -0
  296. package/src/utils/locals-utils.js +24 -0
  297. package/src/utils/parse-cli-args.d.ts +27 -0
  298. package/src/utils/parse-cli-args.js +62 -0
  299. package/src/utils/path-utils.module.d.ts +5 -0
  300. package/src/utils/path-utils.module.js +14 -0
  301. package/src/utils/resolve-work-dir.d.ts +11 -0
  302. package/src/utils/resolve-work-dir.js +31 -0
  303. package/src/utils/runtime.d.ts +11 -0
  304. package/src/utils/runtime.js +40 -0
  305. package/src/utils/server-utils.module.d.ts +19 -0
  306. package/src/utils/server-utils.module.js +56 -0
  307. package/src/watchers/project-watcher.d.ts +136 -0
  308. package/src/watchers/project-watcher.js +275 -0
  309. package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
  310. package/src/watchers/project-watcher.test-helpers.js +52 -0
  311. package/src/adapters/abstract/application-adapter.test.ts +0 -172
  312. package/src/adapters/abstract/application-adapter.ts +0 -379
  313. package/src/adapters/abstract/router-adapter.ts +0 -30
  314. package/src/adapters/abstract/server-adapter.ts +0 -79
  315. package/src/adapters/bun/client-bridge.ts +0 -62
  316. package/src/adapters/bun/create-app.ts +0 -180
  317. package/src/adapters/bun/hmr-manager.test.ts +0 -267
  318. package/src/adapters/bun/hmr-manager.ts +0 -406
  319. package/src/adapters/bun/index.ts +0 -2
  320. package/src/adapters/bun/server-adapter.ts +0 -500
  321. package/src/adapters/bun/server-lifecycle.ts +0 -124
  322. package/src/adapters/create-app.test.ts +0 -10
  323. package/src/adapters/create-app.ts +0 -91
  324. package/src/adapters/index.ts +0 -2
  325. package/src/adapters/node/create-app.test.ts +0 -53
  326. package/src/adapters/node/create-app.ts +0 -183
  327. package/src/adapters/node/node-client-bridge.test.ts +0 -198
  328. package/src/adapters/node/node-client-bridge.ts +0 -79
  329. package/src/adapters/node/node-hmr-manager.test.ts +0 -322
  330. package/src/adapters/node/node-hmr-manager.ts +0 -378
  331. package/src/adapters/node/server-adapter.ts +0 -502
  332. package/src/adapters/node/static-content-server.test.ts +0 -60
  333. package/src/adapters/node/static-content-server.ts +0 -239
  334. package/src/adapters/shared/api-response.test.ts +0 -97
  335. package/src/adapters/shared/api-response.ts +0 -104
  336. package/src/adapters/shared/application-adapter.ts +0 -199
  337. package/src/adapters/shared/define-api-handler.ts +0 -66
  338. package/src/adapters/shared/explicit-static-route-matcher.test.ts +0 -381
  339. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -140
  340. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +0 -90
  341. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -127
  342. package/src/adapters/shared/fs-server-response-factory.test.ts +0 -187
  343. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  344. package/src/adapters/shared/fs-server-response-matcher.test.ts +0 -285
  345. package/src/adapters/shared/fs-server-response-matcher.ts +0 -189
  346. package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
  347. package/src/adapters/shared/hmr-html-response.ts +0 -52
  348. package/src/adapters/shared/hmr-manager.contract.test.ts +0 -232
  349. package/src/adapters/shared/hmr-manager.dispatch.test.ts +0 -220
  350. package/src/adapters/shared/render-context.test.ts +0 -150
  351. package/src/adapters/shared/render-context.ts +0 -123
  352. package/src/adapters/shared/runtime-bootstrap.ts +0 -79
  353. package/src/adapters/shared/server-adapter.test.ts +0 -77
  354. package/src/adapters/shared/server-adapter.ts +0 -493
  355. package/src/adapters/shared/server-route-handler.test.ts +0 -110
  356. package/src/adapters/shared/server-route-handler.ts +0 -153
  357. package/src/adapters/shared/server-static-builder.test.ts +0 -338
  358. package/src/adapters/shared/server-static-builder.ts +0 -170
  359. package/src/build/build-adapter-serialization.test.ts +0 -281
  360. package/src/build/build-adapter.test.ts +0 -1240
  361. package/src/build/build-adapter.ts +0 -1012
  362. package/src/build/build-manifest.ts +0 -54
  363. package/src/build/build-types.ts +0 -83
  364. package/src/build/dev-build-coordinator.ts +0 -220
  365. package/src/build/esbuild-build-adapter.ts +0 -660
  366. package/src/build/runtime-build-executor.test.ts +0 -81
  367. package/src/build/runtime-build-executor.ts +0 -40
  368. package/src/build/runtime-specifier-alias-plugin.test.ts +0 -67
  369. package/src/build/runtime-specifier-alias-plugin.ts +0 -62
  370. package/src/build/runtime-specifier-aliases.ts +0 -135
  371. package/src/config/config-builder.test.ts +0 -443
  372. package/src/config/config-builder.ts +0 -742
  373. package/src/config/config-builder.typecheck.test.ts +0 -96
  374. package/src/dev/sc-server.ts +0 -143
  375. package/src/eco/eco.browser.test.ts +0 -43
  376. package/src/eco/eco.browser.ts +0 -118
  377. package/src/eco/eco.test.ts +0 -654
  378. package/src/eco/eco.ts +0 -205
  379. package/src/eco/eco.types.ts +0 -221
  380. package/src/eco/eco.utils.test.ts +0 -219
  381. package/src/eco/eco.utils.ts +0 -5
  382. package/src/eco/global-injector-map.test.ts +0 -42
  383. package/src/eco/global-injector-map.ts +0 -112
  384. package/src/eco/lazy-injector-map.test.ts +0 -66
  385. package/src/eco/lazy-injector-map.ts +0 -120
  386. package/src/eco/module-dependencies.test.ts +0 -30
  387. package/src/eco/module-dependencies.ts +0 -75
  388. package/src/errors/http-error.test.ts +0 -134
  389. package/src/errors/http-error.ts +0 -72
  390. package/src/errors/locals-access-error.ts +0 -7
  391. package/src/global/app-logger.ts +0 -4
  392. package/src/global/utils.test.ts +0 -12
  393. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-have-HMR-script-injected-in-page-1.png +0 -0
  394. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  395. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  396. package/src/hmr/client/hmr-runtime.ts +0 -160
  397. package/src/hmr/hmr-strategy.test.ts +0 -124
  398. package/src/hmr/hmr-strategy.ts +0 -177
  399. package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
  400. package/src/hmr/hmr.test.e2e.ts +0 -66
  401. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  402. package/src/hmr/strategies/js-hmr-strategy.test.ts +0 -335
  403. package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
  404. package/src/index.browser.ts +0 -3
  405. package/src/index.ts +0 -15
  406. package/src/integrations/ghtml/ghtml-renderer.test.ts +0 -253
  407. package/src/integrations/ghtml/ghtml-renderer.ts +0 -97
  408. package/src/integrations/ghtml/ghtml.constants.ts +0 -1
  409. package/src/integrations/ghtml/ghtml.plugin.ts +0 -28
  410. package/src/plugins/alias-resolver-plugin.test.ts +0 -41
  411. package/src/plugins/alias-resolver-plugin.ts +0 -63
  412. package/src/plugins/eco-component-meta-plugin.test.ts +0 -406
  413. package/src/plugins/eco-component-meta-plugin.ts +0 -495
  414. package/src/plugins/foreign-jsx-override-plugin.test.ts +0 -65
  415. package/src/plugins/foreign-jsx-override-plugin.ts +0 -67
  416. package/src/plugins/integration-plugin.test.ts +0 -156
  417. package/src/plugins/integration-plugin.ts +0 -311
  418. package/src/plugins/processor.test.ts +0 -148
  419. package/src/plugins/processor.ts +0 -240
  420. package/src/plugins/source-transform.test.ts +0 -82
  421. package/src/plugins/source-transform.ts +0 -123
  422. package/src/route-renderer/orchestration/boundary-planning.service.ts +0 -146
  423. package/src/route-renderer/orchestration/component-render-context.ts +0 -318
  424. package/src/route-renderer/orchestration/integration-renderer.test.ts +0 -2088
  425. package/src/route-renderer/orchestration/integration-renderer.ts +0 -1285
  426. package/src/route-renderer/orchestration/page-packaging.service.test.ts +0 -76
  427. package/src/route-renderer/orchestration/page-packaging.service.ts +0 -85
  428. package/src/route-renderer/orchestration/processed-asset-dedupe.ts +0 -25
  429. package/src/route-renderer/orchestration/queued-boundary-runtime.service.test.ts +0 -319
  430. package/src/route-renderer/orchestration/queued-boundary-runtime.service.ts +0 -289
  431. package/src/route-renderer/orchestration/render-execution.service.test.ts +0 -196
  432. package/src/route-renderer/orchestration/render-execution.service.ts +0 -182
  433. package/src/route-renderer/orchestration/render-output.utils.ts +0 -302
  434. package/src/route-renderer/orchestration/render-preparation.service.test.ts +0 -569
  435. package/src/route-renderer/orchestration/render-preparation.service.ts +0 -508
  436. package/src/route-renderer/orchestration/route-shell-composer.service.ts +0 -162
  437. package/src/route-renderer/orchestration/template-serialization.test.ts +0 -110
  438. package/src/route-renderer/orchestration/template-serialization.ts +0 -117
  439. package/src/route-renderer/page-loading/component-dependency-collection.ts +0 -196
  440. package/src/route-renderer/page-loading/declared-asset-collection.ts +0 -156
  441. package/src/route-renderer/page-loading/dependency-resolver.test.ts +0 -665
  442. package/src/route-renderer/page-loading/dependency-resolver.ts +0 -150
  443. package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +0 -75
  444. package/src/route-renderer/page-loading/lazy-entry-collection.ts +0 -167
  445. package/src/route-renderer/page-loading/lazy-trigger-planning.ts +0 -74
  446. package/src/route-renderer/page-loading/module-declaration-aggregation.ts +0 -60
  447. package/src/route-renderer/page-loading/module-declaration-scripts.ts +0 -16
  448. package/src/route-renderer/page-loading/page-dependency-bundling.ts +0 -205
  449. package/src/route-renderer/page-loading/page-module-loader.test.ts +0 -183
  450. package/src/route-renderer/page-loading/page-module-loader.ts +0 -184
  451. package/src/route-renderer/route-renderer.ts +0 -136
  452. package/src/router/client/link-intent.test.browser.ts +0 -51
  453. package/src/router/client/link-intent.ts +0 -92
  454. package/src/router/client/navigation-coordinator.test.ts +0 -237
  455. package/src/router/client/navigation-coordinator.ts +0 -453
  456. package/src/router/server/fs-router-scanner.test.ts +0 -83
  457. package/src/router/server/fs-router-scanner.ts +0 -224
  458. package/src/router/server/fs-router.test.ts +0 -214
  459. package/src/router/server/fs-router.ts +0 -122
  460. package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +0 -66
  461. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +0 -476
  462. package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -345
  463. package/src/services/assets/asset-processing-service/asset.factory.test.ts +0 -63
  464. package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
  465. package/src/services/assets/asset-processing-service/assets.types.ts +0 -125
  466. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +0 -74
  467. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -96
  468. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +0 -67
  469. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
  470. package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +0 -104
  471. package/src/services/assets/asset-processing-service/index.ts +0 -5
  472. package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
  473. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +0 -59
  474. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -83
  475. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -174
  476. package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
  477. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +0 -192
  478. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -134
  479. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +0 -326
  480. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -110
  481. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +0 -227
  482. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -87
  483. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +0 -261
  484. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -71
  485. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -81
  486. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +0 -65
  487. package/src/services/assets/browser-bundle.service.test.ts +0 -66
  488. package/src/services/assets/browser-bundle.service.ts +0 -109
  489. package/src/services/cache/cache.types.ts +0 -126
  490. package/src/services/cache/index.ts +0 -18
  491. package/src/services/cache/memory-cache-store.test.ts +0 -225
  492. package/src/services/cache/memory-cache-store.ts +0 -130
  493. package/src/services/cache/page-cache-service.test.ts +0 -175
  494. package/src/services/cache/page-cache-service.ts +0 -202
  495. package/src/services/cache/page-request-cache-coordinator.service.test.ts +0 -79
  496. package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
  497. package/src/services/html/html-rewriter-provider.service.test.ts +0 -183
  498. package/src/services/html/html-rewriter-provider.service.ts +0 -104
  499. package/src/services/html/html-transformer.service.test.ts +0 -479
  500. package/src/services/html/html-transformer.service.ts +0 -275
  501. package/src/services/invalidation/development-invalidation.service.test.ts +0 -87
  502. package/src/services/invalidation/development-invalidation.service.ts +0 -262
  503. package/src/services/module-loading/app-module-loader.service.ts +0 -9
  504. package/src/services/module-loading/app-server-module-transpiler.service.test.ts +0 -130
  505. package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -143
  506. package/src/services/module-loading/host-module-loader-registry.ts +0 -15
  507. package/src/services/module-loading/node-bootstrap-plugin.test.ts +0 -335
  508. package/src/services/module-loading/node-bootstrap-plugin.ts +0 -297
  509. package/src/services/module-loading/page-module-import.service.test.ts +0 -504
  510. package/src/services/module-loading/page-module-import.service.ts +0 -252
  511. package/src/services/module-loading/server-module-transpiler.service.test.ts +0 -243
  512. package/src/services/module-loading/server-module-transpiler.service.ts +0 -104
  513. package/src/services/module-loading/source-module-support.ts +0 -19
  514. package/src/services/runtime-state/dev-graph.service.ts +0 -217
  515. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
  516. package/src/services/runtime-state/runtime-specifier-registry.service.ts +0 -96
  517. package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
  518. package/src/services/validation/schema-validation-service.test.ts +0 -223
  519. package/src/services/validation/schema-validation-service.ts +0 -204
  520. package/src/static-site-generator/static-site-generator.test.ts +0 -316
  521. package/src/static-site-generator/static-site-generator.ts +0 -462
  522. package/src/types/internal-types.ts +0 -242
  523. package/src/types/public-types.ts +0 -1443
  524. package/src/utils/deep-merge.test.ts +0 -114
  525. package/src/utils/deep-merge.ts +0 -47
  526. package/src/utils/hash.ts +0 -5
  527. package/src/utils/html-escaping.ts +0 -9
  528. package/src/utils/invariant.test.ts +0 -22
  529. package/src/utils/invariant.ts +0 -15
  530. package/src/utils/locals-utils.ts +0 -37
  531. package/src/utils/parse-cli-args.test.ts +0 -69
  532. package/src/utils/parse-cli-args.ts +0 -105
  533. package/src/utils/path-utils.module.ts +0 -14
  534. package/src/utils/path-utils.test.ts +0 -15
  535. package/src/utils/resolve-work-dir.ts +0 -45
  536. package/src/utils/runtime.ts +0 -44
  537. package/src/utils/server-utils.module.ts +0 -67
  538. package/src/utils/server-utils.test.ts +0 -38
  539. package/src/watchers/project-watcher.integration.test.ts +0 -337
  540. package/src/watchers/project-watcher.test-helpers.ts +0 -41
  541. package/src/watchers/project-watcher.test.ts +0 -768
  542. package/src/watchers/project-watcher.ts +0 -357
  543. /package/src/utils/{html.ts → html.d.ts} +0 -0
package/src/eco/eco.ts DELETED
@@ -1,205 +0,0 @@
1
- /**
2
- * The eco namespace - unified component and page factory API
3
- * @module
4
- */
5
-
6
- import type {
7
- EcoComponent,
8
- EcoHtmlComponent,
9
- EcoLayoutComponent,
10
- EcoPagesElement,
11
- EcoPageComponent,
12
- GetMetadata,
13
- GetStaticPaths,
14
- GetStaticProps,
15
- Middleware,
16
- RequestLocals,
17
- RequestPageContext,
18
- } from '../types/public-types.ts';
19
- import type { CacheStrategy } from '../services/cache/cache.types.ts';
20
- import type {
21
- ComponentOptions,
22
- Eco,
23
- HtmlOptions,
24
- LayoutOptions,
25
- PageOptions,
26
- PageOptionsBase,
27
- PagePropsFor,
28
- PagePropsForWithLocals,
29
- PageRequires,
30
- } from './eco.types.ts';
31
- import {
32
- finalizeComponentRender,
33
- interceptComponentBoundary,
34
- } from '../route-renderer/orchestration/component-render-context.ts';
35
- import { isThenable } from '../route-renderer/orchestration/render-output.utils.ts';
36
-
37
- /**
38
- * Creates a component factory with lazy-trigger support and boundary-runtime
39
- * interception.
40
- *
41
- * Behavior:
42
- * - In normal render flow, returns `options.render(props)` with optional lazy
43
- * trigger/script wrapping.
44
- * - When rendering under an active component boundary runtime and the current
45
- * renderer-owned boundary runtime resolves the boundary immediately, returns
46
- * that resolved output instead of rendering the component inline.
47
- *
48
- * @param options Component options for rendering and dependency declaration.
49
- * @returns Configured eco component.
50
- */
51
- function createComponentFactory<P, E>(options: ComponentOptions<P, E>): EcoComponent<P, E> {
52
- const integrationName = options.integration ?? options.__eco?.integration;
53
- const comp: EcoComponent<P, E> = ((props: P) => {
54
- const componentProps = (props ?? {}) as Record<string, unknown>;
55
- const renderInline = () => finalizeComponentRender(comp, options.render(props)) as E;
56
- const boundaryRender = interceptComponentBoundary({
57
- component: comp,
58
- props: componentProps,
59
- targetIntegration: integrationName,
60
- });
61
-
62
- if (isThenable<unknown | undefined>(boundaryRender)) {
63
- return boundaryRender.then((resolvedBoundaryRender) =>
64
- resolvedBoundaryRender !== undefined ? (resolvedBoundaryRender as E) : renderInline(),
65
- ) as E;
66
- }
67
-
68
- if (boundaryRender !== undefined) {
69
- return boundaryRender as E;
70
- }
71
-
72
- return renderInline();
73
- }) as EcoComponent<P, E>;
74
-
75
- comp.config = {
76
- __eco: options.__eco,
77
- integration: options.integration,
78
- dependencies: options.dependencies,
79
- };
80
-
81
- return comp;
82
- }
83
-
84
- /**
85
- * Creates a reusable component with optional dependencies.
86
- *
87
- * @param options Component definition options.
88
- * @returns Eco component function.
89
- */
90
- function component<P = {}, E = EcoPagesElement>(options: ComponentOptions<P, E>): EcoComponent<P, E> {
91
- return createComponentFactory(options);
92
- }
93
-
94
- /**
95
- * Creates a document shell component.
96
- *
97
- * Phase 1 keeps this as a semantic alias over eco.component() so existing
98
- * renderer behavior remains unchanged.
99
- */
100
- function html<E = EcoPagesElement>(options: HtmlOptions<E>): EcoHtmlComponent<E> {
101
- return createComponentFactory(options) as EcoHtmlComponent<E>;
102
- }
103
-
104
- /**
105
- * Creates a route layout component.
106
- *
107
- * Phase 1 keeps this as a semantic alias over eco.component() so existing
108
- * renderer behavior remains unchanged.
109
- */
110
- function layout<E = EcoPagesElement>(options: LayoutOptions<E>): EcoLayoutComponent<E> {
111
- return createComponentFactory(options) as EcoLayoutComponent<E>;
112
- }
113
-
114
- /**
115
- * Creates a page component with typed props and optional static helpers.
116
- */
117
- function page<T = {}, E = EcoPagesElement>(options: PageOptions<T, E> & { requires?: undefined }): EcoPageComponent<T>;
118
- function page<T = {}, E = EcoPagesElement, const K extends keyof RequestLocals = keyof RequestLocals>(
119
- options: Omit<PageOptions<T, E>, 'render' | 'requires'> & {
120
- requires: PageRequires<K>;
121
- render: (props: PagePropsForWithLocals<T, K>) => E | Promise<E>;
122
- },
123
- ): EcoPageComponent<T>;
124
-
125
- /**
126
- * Creates a page component and attaches optional static APIs.
127
- *
128
- * @param options Page options.
129
- * @returns Eco page component.
130
- */
131
- function page<T, E>(
132
- options: PageOptionsBase<T, E> & { cache?: CacheStrategy; middleware?: Middleware[] },
133
- ): EcoPageComponent<T> {
134
- const { layout, dependencies, render, staticPaths, staticProps, metadata, cache, requires, middleware } = options;
135
-
136
- const componentOptions: ComponentOptions<PagePropsFor<T> & Partial<RequestPageContext>, E> = {
137
- __eco: options.__eco,
138
- integration: options.integration,
139
- dependencies: layout
140
- ? {
141
- ...dependencies,
142
- components: [...(dependencies?.components || []), layout],
143
- }
144
- : dependencies,
145
- render,
146
- };
147
-
148
- const pageComponent = createComponentFactory(componentOptions) as EcoPageComponent<T>;
149
-
150
- if (layout && pageComponent.config) {
151
- pageComponent.config.layout = layout;
152
- }
153
-
154
- if (staticPaths) pageComponent.staticPaths = staticPaths;
155
- if (staticProps) pageComponent.staticProps = staticProps;
156
- if (metadata) pageComponent.metadata = metadata;
157
- if (cache) pageComponent.cache = cache;
158
- if (requires) pageComponent.requires = requires;
159
- if (middleware) pageComponent.middleware = middleware;
160
-
161
- return pageComponent;
162
- }
163
-
164
- /**
165
- * Type-safe wrapper for metadata functions.
166
- *
167
- * @param fn Metadata factory function.
168
- * @returns The same function.
169
- */
170
- function metadata<P = {}>(fn: GetMetadata<P>): GetMetadata<P> {
171
- return fn;
172
- }
173
-
174
- /**
175
- * Type-safe wrapper for static paths functions.
176
- *
177
- * @param fn Static paths function.
178
- * @returns The same function.
179
- */
180
- function staticPaths(fn: GetStaticPaths): GetStaticPaths {
181
- return fn;
182
- }
183
-
184
- /**
185
- * Type-safe wrapper for static props functions.
186
- *
187
- * @param fn Static props function.
188
- * @returns The same function.
189
- */
190
- function staticProps<P>(fn: GetStaticProps<P>): GetStaticProps<P> {
191
- return fn;
192
- }
193
-
194
- /**
195
- * The eco namespace - provides factories for components and pages
196
- */
197
- export const eco: Eco = {
198
- component,
199
- html,
200
- layout,
201
- page,
202
- metadata,
203
- staticPaths,
204
- staticProps,
205
- };
@@ -1,221 +0,0 @@
1
- /**
2
- * Type definitions for the eco namespace API
3
- * @module
4
- */
5
-
6
- import type {
7
- DependencyLazyTrigger,
8
- EcoComponent,
9
- EcoComponentDependencies,
10
- EcoHtmlComponent,
11
- EcoInjectedMeta,
12
- EcoLayoutComponent,
13
- EcoPageLayoutComponent,
14
- EcoPagesElement,
15
- GetMetadata,
16
- GetStaticPaths,
17
- GetStaticProps,
18
- HtmlTemplateProps,
19
- LayoutProps,
20
- Middleware,
21
- RequestLocals,
22
- RequestPageContext,
23
- } from '../types/public-types.ts';
24
- import type { CacheStrategy } from '../services/cache/cache.types.ts';
25
-
26
- type WithRequiredLocals<K extends keyof RequestLocals> = Omit<RequestLocals, K> & {
27
- [P in K]-?: Exclude<RequestLocals[P], null | undefined>;
28
- };
29
-
30
- type RequiresKeys = keyof RequestLocals;
31
-
32
- export type PageRequires<K extends RequiresKeys = RequiresKeys> = K | readonly K[];
33
-
34
- /**
35
- * Lazy trigger options map directly to scripts-injector attributes.
36
- * Only one trigger type can be active at a time.
37
- */
38
- export type LazyTrigger = DependencyLazyTrigger;
39
-
40
- /**
41
- * Options for creating a component with eco.component()
42
- * @template P - The props type for the component
43
- * @template E - The element/return type (defaults to EcoPagesElement for Kita, use ReactNode for React)
44
- */
45
- export interface ComponentOptions<P, E = EcoPagesElement> {
46
- /** @internal Injected by eco-component-meta-plugin */
47
- __eco?: EcoInjectedMeta;
48
- integration?: string;
49
- dependencies?: EcoComponentDependencies;
50
- render: (props: P) => E | Promise<E>;
51
- }
52
-
53
- export type HtmlOptions<E = EcoPagesElement> = ComponentOptions<HtmlTemplateProps, E>;
54
-
55
- export type LayoutOptions<E = EcoPagesElement> = ComponentOptions<LayoutProps<E>, E>;
56
-
57
- /**
58
- * Base options shared by all page variants
59
- */
60
- export interface PageOptionsBase<T, E = EcoPagesElement> {
61
- /** @internal Injected by eco-component-meta-plugin */
62
- __eco?: EcoInjectedMeta;
63
- integration?: string;
64
- dependencies?: EcoComponentDependencies;
65
- layout?: EcoPageLayoutComponent<E>;
66
-
67
- /**
68
- * Define static paths for dynamic routes (e.g., [slug].tsx).
69
- * Returns all possible paths that should be pre-rendered at build time.
70
- */
71
- staticPaths?: GetStaticPaths;
72
-
73
- /**
74
- * Fetch data for the page at build time.
75
- * Props returned here are passed to both render() and metadata().
76
- */
77
- staticProps?: GetStaticProps<T>;
78
-
79
- /**
80
- * Generate page metadata (title, description, etc.).
81
- * Receives props from staticProps if defined.
82
- */
83
- metadata?: GetMetadata<T>;
84
-
85
- /**
86
- * Declares which `locals` keys must be present for this page.
87
- *
88
- * This is a typing and documentation feature; runtime enforcement must be done via handler/page middleware.
89
- */
90
- requires?: PageRequires;
91
-
92
- render: (props: PagePropsFor<T> & Partial<RequestPageContext>) => E | Promise<E>;
93
- }
94
-
95
- /**
96
- * Page options without middleware - allows any cache strategy
97
- */
98
- interface PageOptionsWithoutMiddleware<T, E = EcoPagesElement> extends PageOptionsBase<T, E> {
99
- /**
100
- * Cache configuration for ISR (Incremental Static Regeneration).
101
- * - `'static'`: Cache indefinitely (default)
102
- * - `'dynamic'`: No caching, render on every request
103
- * - `{ revalidate: number, tags?: string[] }`: Cache with time-based revalidation
104
- */
105
- cache?: CacheStrategy;
106
- middleware?: undefined;
107
- }
108
-
109
- /**
110
- * Page options with middleware - requires cache: 'dynamic'
111
- */
112
- interface PageOptionsWithMiddleware<T, E = EcoPagesElement> extends PageOptionsBase<T, E> {
113
- /**
114
- * Cache must be 'dynamic' when using middleware.
115
- * Middleware runs on every request, so caching would bypass middleware effects.
116
- */
117
- cache: 'dynamic';
118
- /**
119
- * Request-time middleware for file-based routes.
120
- * Runs before rendering and can short-circuit by returning a Response.
121
- */
122
- middleware: Middleware[];
123
- }
124
-
125
- /**
126
- * Options for creating a page with eco.page()
127
- *
128
- * Supports two patterns:
129
- * 1. **Consolidated API** (recommended): Define staticPaths, staticProps, and metadata inline
130
- * 2. **Separate exports** (legacy): Export getStaticPaths, getStaticProps, getMetadata separately
131
- *
132
- * When using `middleware`, `cache` must be set to `'dynamic'` because middleware
133
- * runs on every request and caching would bypass middleware effects.
134
- *
135
- * @template T - The props type for the page
136
- * @template E - The element/return type (defaults to EcoPagesElement for Kita, use ReactNode for React)
137
- */
138
- export type PageOptions<T, E = EcoPagesElement> = PageOptionsWithoutMiddleware<T, E> | PageOptionsWithMiddleware<T, E>;
139
-
140
- export type PagePropsForWithLocals<T, K extends RequiresKeys | never = never> = PagePropsFor<T> &
141
- (K extends never
142
- ? Partial<RequestPageContext>
143
- : Omit<Partial<RequestPageContext>, 'locals'> & {
144
- locals: WithRequiredLocals<Extract<K, keyof RequestLocals>>;
145
- });
146
-
147
- /**
148
- * Extracts props type from getStaticProps return type, or uses T directly if it's a props object.
149
- * Always includes params and query for page context.
150
- */
151
- export type PagePropsFor<T> =
152
- T extends GetStaticProps<infer P>
153
- ? P & { params?: Record<string, string>; query?: Record<string, string> }
154
- : T & { params?: Record<string, string>; query?: Record<string, string> };
155
-
156
- /**
157
- * A page component with optional attached static functions.
158
- * Used by the consolidated eco.page() API where staticPaths, staticProps,
159
- * and metadata are defined inline and attached to the component.
160
- */
161
- export type EcoPageComponent<T> = EcoComponent<PagePropsFor<T> & Partial<RequestPageContext>> & {
162
- staticPaths?: GetStaticPaths;
163
- staticProps?: GetStaticProps<T>;
164
- metadata?: GetMetadata<T>;
165
- cache?: CacheStrategy;
166
- requires?: PageRequires;
167
- middleware?: Middleware[];
168
- };
169
-
170
- /**
171
- * The eco namespace interface
172
- */
173
- export interface Eco {
174
- /**
175
- * Create a reusable component with dependencies and optional lazy-loading.
176
- * @template P - Props type
177
- * @template E - Element/return type (EcoPagesElement for Kita, ReactNode for React)
178
- */
179
- component: <P = {}, E = EcoPagesElement>(options: ComponentOptions<P, E>) => EcoComponent<P, E>;
180
-
181
- /**
182
- * Create a document shell component for the HTML wrapper.
183
- */
184
- html: <E = EcoPagesElement>(options: HtmlOptions<E>) => EcoHtmlComponent<E>;
185
-
186
- /**
187
- * Create a route layout component.
188
- */
189
- layout: <E = EcoPagesElement>(options: LayoutOptions<E>) => EcoLayoutComponent<E>;
190
-
191
- /**
192
- * Create a page component with type-safe props from getStaticProps.
193
- * Returns an EcoPageComponent with attached staticPaths, staticProps, and metadata.
194
- *
195
- * If `requires` is provided, the `render` callback receives `locals` as required and non-null for the required keys.
196
- */
197
- page: {
198
- <T = {}, E = EcoPagesElement>(options: PageOptions<T, E> & { requires?: undefined }): EcoPageComponent<T>;
199
- <T = {}, E = EcoPagesElement, const K extends RequiresKeys = RequiresKeys>(
200
- options: Omit<PageOptions<T, E>, 'render' | 'requires'> & {
201
- requires: PageRequires<K>;
202
- render: (props: PagePropsForWithLocals<T, K>) => E | Promise<E>;
203
- },
204
- ): EcoPageComponent<T>;
205
- };
206
-
207
- /**
208
- * Type-safe wrapper for page metadata (identity function)
209
- */
210
- metadata: <P = {}>(fn: GetMetadata<P>) => GetMetadata<P>;
211
-
212
- /**
213
- * Type-safe wrapper for static paths (identity function)
214
- */
215
- staticPaths: (fn: GetStaticPaths) => GetStaticPaths;
216
-
217
- /**
218
- * Type-safe wrapper for static props (identity function)
219
- */
220
- staticProps: <P>(fn: GetStaticProps<P>) => GetStaticProps<P>;
221
- }
@@ -1,219 +0,0 @@
1
- import { describe, expect, test } from 'vitest';
2
- import { addTriggerAttribute, isThenable, wrapWithScriptsInjector } from './eco.utils.ts';
3
-
4
- const TRIGGER_ID = 'eco-trigger-abc123';
5
-
6
- describe('addTriggerAttribute', () => {
7
- describe('basic element injection', () => {
8
- test('injects into a plain div', () => {
9
- const result = addTriggerAttribute('<div>content</div>', TRIGGER_ID);
10
- expect(result).toBe(`<div data-eco-trigger="${TRIGGER_ID}">content</div>`);
11
- });
12
-
13
- test('injects into a custom element', () => {
14
- const result = addTriggerAttribute('<my-counter value="0"></my-counter>', TRIGGER_ID);
15
- expect(result).toBe(`<my-counter data-eco-trigger="${TRIGGER_ID}" value="0"></my-counter>`);
16
- });
17
-
18
- test('injects into an element that already has attributes', () => {
19
- const result = addTriggerAttribute('<div class="foo" id="bar">content</div>', TRIGGER_ID);
20
- expect(result).toBe(`<div data-eco-trigger="${TRIGGER_ID}" class="foo" id="bar">content</div>`);
21
- });
22
-
23
- test('injects into a self-closing void element', () => {
24
- const result = addTriggerAttribute('<img src="x.png" alt="" />', TRIGGER_ID);
25
- expect(result).toBe(`<img data-eco-trigger="${TRIGGER_ID}" src="x.png" alt="" />`);
26
- });
27
-
28
- test('injects into an element with no attributes and immediate close', () => {
29
- const result = addTriggerAttribute('<section></section>', TRIGGER_ID);
30
- expect(result).toBe(`<section data-eco-trigger="${TRIGGER_ID}"></section>`);
31
- });
32
- });
33
-
34
- describe('leading non-element nodes are skipped', () => {
35
- test('skips leading whitespace and injects into the first element', () => {
36
- const result = addTriggerAttribute(' \n <div>content</div>', TRIGGER_ID);
37
- expect(result).toBe(` \n <div data-eco-trigger="${TRIGGER_ID}">content</div>`);
38
- });
39
-
40
- test('skips a leading HTML comment', () => {
41
- const result = addTriggerAttribute('<!-- wrapper --><div>content</div>', TRIGGER_ID);
42
- expect(result).toBe(`<!-- wrapper --><div data-eco-trigger="${TRIGGER_ID}">content</div>`);
43
- });
44
-
45
- test('skips multiple leading HTML comments', () => {
46
- const result = addTriggerAttribute('<!-- a --><!-- b --><span>text</span>', TRIGGER_ID);
47
- expect(result).toBe(`<!-- a --><!-- b --><span data-eco-trigger="${TRIGGER_ID}">text</span>`);
48
- });
49
-
50
- test('skips a leading doctype declaration', () => {
51
- const result = addTriggerAttribute('<!DOCTYPE html><html lang="en"></html>', TRIGGER_ID);
52
- expect(result).toBe(`<!DOCTYPE html><html data-eco-trigger="${TRIGGER_ID}" lang="en"></html>`);
53
- });
54
-
55
- test('skips a leading XML processing instruction', () => {
56
- const result = addTriggerAttribute('<?xml version="1.0"?><root/>', TRIGGER_ID);
57
- expect(result).toBe(`<?xml version="1.0"?><root data-eco-trigger="${TRIGGER_ID}"/>`);
58
- });
59
-
60
- test('skips comment then whitespace then element', () => {
61
- const result = addTriggerAttribute('<!-- note -->\n<article>body</article>', TRIGGER_ID);
62
- expect(result).toBe(`<!-- note -->\n<article data-eco-trigger="${TRIGGER_ID}">body</article>`);
63
- });
64
- });
65
-
66
- describe('only the first element is modified', () => {
67
- test('does not inject into sibling elements', () => {
68
- const result = addTriggerAttribute('<div>first</div><div>second</div>', TRIGGER_ID);
69
- expect(result).toBe(`<div data-eco-trigger="${TRIGGER_ID}">first</div><div>second</div>`);
70
- });
71
- });
72
-
73
- describe('fallback when no element is found', () => {
74
- test('preserves JSX template metadata while injecting into the first string', () => {
75
- const strings = ['<theme-toggle class=', '></theme-toggle>'];
76
- Object.defineProperty(strings, 'raw', {
77
- value: ['<theme-toggle class=', '></theme-toggle>'],
78
- });
79
-
80
- const template = {
81
- _$rType$: 1,
82
- rootLocalName: 'theme-toggle',
83
- strings,
84
- values: ['radiant-switch'],
85
- };
86
-
87
- const result = addTriggerAttribute(template, TRIGGER_ID) as unknown as {
88
- _$rType$: number;
89
- rootLocalName: string;
90
- strings: string[];
91
- values: unknown[];
92
- };
93
-
94
- expect(result._$rType$).toBe(1);
95
- expect(result.rootLocalName).toBe('theme-toggle');
96
- expect(result.values).toEqual(['radiant-switch']);
97
- expect(result.strings).toEqual([
98
- `<theme-toggle data-eco-trigger="${TRIGGER_ID}" class=`,
99
- '></theme-toggle>',
100
- ]);
101
- expect(Object.getOwnPropertyDescriptor(result.strings, 'raw')?.value).toEqual([
102
- `<theme-toggle data-eco-trigger="${TRIGGER_ID}" class=`,
103
- '></theme-toggle>',
104
- ]);
105
- });
106
-
107
- test('preserves SSR markup node output while injecting into outerHTML', () => {
108
- const markupNode = {
109
- nodeType: 1,
110
- get outerHTML() {
111
- return '<theme-toggle class="radiant-switch"></theme-toggle>';
112
- },
113
- };
114
-
115
- const result = addTriggerAttribute(markupNode, TRIGGER_ID) as typeof markupNode;
116
-
117
- expect(result.nodeType).toBe(1);
118
- expect(result.outerHTML).toBe(
119
- `<theme-toggle data-eco-trigger="${TRIGGER_ID}" class="radiant-switch"></theme-toggle>`,
120
- );
121
- });
122
-
123
- test('returns the original string unchanged when there is no opening tag', () => {
124
- const input = 'just some text';
125
- expect(addTriggerAttribute(input, TRIGGER_ID)).toBe(input);
126
- });
127
-
128
- test('returns the original string unchanged when input is empty', () => {
129
- expect(addTriggerAttribute('', TRIGGER_ID)).toBe('');
130
- });
131
- });
132
-
133
- describe('non-string input coercion', () => {
134
- test('coerces a number to string before injecting', () => {
135
- const result = addTriggerAttribute(42, TRIGGER_ID);
136
- expect(result).toBe('42');
137
- });
138
-
139
- test('coerces null to the string "null"', () => {
140
- expect(addTriggerAttribute(null, TRIGGER_ID)).toBe('null');
141
- });
142
- });
143
- });
144
-
145
- describe('isThenable', () => {
146
- test('returns true for a native Promise', () => {
147
- expect(isThenable(Promise.resolve())).toBe(true);
148
- });
149
-
150
- test('returns true for a plain object with a then function', () => {
151
- expect(isThenable({ then: () => {} })).toBe(true);
152
- });
153
-
154
- test('returns false for a plain string', () => {
155
- expect(isThenable('hello')).toBe(false);
156
- });
157
-
158
- test('returns false for a number', () => {
159
- expect(isThenable(42)).toBe(false);
160
- });
161
-
162
- test('returns false for null', () => {
163
- expect(isThenable(null)).toBe(false);
164
- });
165
-
166
- test('returns false for an object without then', () => {
167
- expect(isThenable({ value: 1 })).toBe(false);
168
- });
169
-
170
- test('returns false when then is not a function', () => {
171
- expect(isThenable({ then: 'not-a-function' })).toBe(false);
172
- });
173
- });
174
-
175
- describe('wrapWithScriptsInjector', () => {
176
- const lazyGroups = [{ lazy: { 'on:idle': true }, scripts: '/_assets/script.js' }] as const;
177
-
178
- test('preserves JSX template metadata while wrapping content', () => {
179
- const strings = ['<theme-toggle class=', '></theme-toggle>'];
180
- Object.defineProperty(strings, 'raw', {
181
- value: ['<theme-toggle class=', '></theme-toggle>'],
182
- });
183
-
184
- const template = {
185
- _$rType$: 1,
186
- rootLocalName: 'theme-toggle',
187
- strings,
188
- values: ['radiant-switch'],
189
- };
190
-
191
- const result = wrapWithScriptsInjector(template, lazyGroups) as unknown as typeof template;
192
-
193
- expect(result._$rType$).toBe(1);
194
- expect(result.rootLocalName).toBe('theme-toggle');
195
- expect(result.values).toEqual(['radiant-switch']);
196
- expect(result.strings[0]).toContain('<scripts-injector><script type="ecopages/injector-map">');
197
- expect(result.strings[0]).toContain('<theme-toggle class=');
198
- expect(result.strings[1]).toBe('></theme-toggle></scripts-injector>');
199
- expect(Object.getOwnPropertyDescriptor(result.strings, 'raw')?.value[1]).toBe(
200
- '></theme-toggle></scripts-injector>',
201
- );
202
- });
203
-
204
- test('preserves markup-node-like output while wrapping content', () => {
205
- const markupNode = {
206
- nodeType: 1,
207
- get outerHTML() {
208
- return '<theme-toggle class="radiant-switch"></theme-toggle>';
209
- },
210
- };
211
-
212
- const result = wrapWithScriptsInjector(markupNode, lazyGroups) as typeof markupNode;
213
-
214
- expect(result.nodeType).toBe(1);
215
- expect(result.outerHTML).toContain('<scripts-injector><script type="ecopages/injector-map">');
216
- expect(result.outerHTML).toContain('<theme-toggle class="radiant-switch"></theme-toggle>');
217
- expect(result.outerHTML).toContain('</scripts-injector>');
218
- });
219
- });
@@ -1,5 +0,0 @@
1
- export {
2
- addTriggerAttribute,
3
- isThenable,
4
- wrapWithScriptsInjector,
5
- } from '../route-renderer/orchestration/render-output.utils.ts';
@@ -1,42 +0,0 @@
1
- import { describe, expect, test } from 'vitest';
2
- import { buildGlobalInjectorBootstrapContent, buildGlobalInjectorMapScript } from './global-injector-map.ts';
3
- import type { ResolvedLazyTrigger } from '../types/public-types.ts';
4
-
5
- describe('buildGlobalInjectorMapScript', () => {
6
- test('builds merged map by trigger id and escapes script closing tags', () => {
7
- const triggers: ResolvedLazyTrigger[] = [
8
- {
9
- triggerId: 'eco-trigger-one',
10
- rules: [
11
- { 'on:interaction': { value: 'click', scripts: ['/a.js', '/b</script>.js'] } },
12
- { 'on:idle': { scripts: ['/idle.js'] } },
13
- ],
14
- },
15
- {
16
- triggerId: 'eco-trigger-one',
17
- rules: [{ 'on:interaction': { value: 'click', scripts: ['/a.js', '/c.js'] } }],
18
- },
19
- ];
20
-
21
- const payload = buildGlobalInjectorMapScript(triggers);
22
- expect(payload).toContain('<\\/script>');
23
-
24
- const map = JSON.parse(payload) as Record<string, Record<string, { scripts: string[]; value?: string }>>;
25
- expect(map['eco-trigger-one']?.['on:idle']?.scripts).toEqual(['/idle.js']);
26
- expect(map['eco-trigger-one']?.['on:interaction']).toEqual({
27
- value: 'click',
28
- scripts: ['/a.js', '/b</script>.js', '/c.js'],
29
- });
30
- });
31
- });
32
-
33
- describe('buildGlobalInjectorBootstrapContent', () => {
34
- test('binds refresh to after-swap and avoids before-swap cleanup listener', () => {
35
- const bootstrap = buildGlobalInjectorBootstrapContent('/assets/injector-global.js');
36
-
37
- expect(bootstrap).toContain("document.addEventListener('eco:after-swap', handleAfterSwap);");
38
- expect(bootstrap).not.toContain("document.addEventListener('eco:before-swap'");
39
- expect(bootstrap).not.toContain('const handleBeforeSwap');
40
- expect(bootstrap).toContain("document.removeEventListener('eco:after-swap', handleAfterSwap);");
41
- });
42
- });