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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (515) hide show
  1. package/package.json +93 -226
  2. package/src/adapters/abstract/application-adapter.test.ts +172 -0
  3. package/src/adapters/abstract/application-adapter.ts +379 -0
  4. package/src/adapters/abstract/router-adapter.ts +30 -0
  5. package/src/adapters/abstract/server-adapter.ts +79 -0
  6. package/src/adapters/bun/client-bridge.ts +62 -0
  7. package/src/adapters/bun/create-app.ts +180 -0
  8. package/src/adapters/bun/hmr-manager.test.ts +267 -0
  9. package/src/adapters/bun/hmr-manager.ts +406 -0
  10. package/src/adapters/bun/index.ts +2 -0
  11. package/src/adapters/bun/server-adapter.ts +500 -0
  12. package/src/adapters/bun/server-lifecycle.ts +124 -0
  13. package/src/adapters/create-app.test.ts +10 -0
  14. package/src/adapters/create-app.ts +91 -0
  15. package/src/adapters/index.ts +2 -0
  16. package/src/adapters/node/create-app.test.ts +53 -0
  17. package/src/adapters/node/create-app.ts +183 -0
  18. package/src/adapters/node/node-client-bridge.test.ts +198 -0
  19. package/src/adapters/node/node-client-bridge.ts +79 -0
  20. package/src/adapters/node/node-hmr-manager.test.ts +322 -0
  21. package/src/adapters/node/node-hmr-manager.ts +378 -0
  22. package/src/adapters/node/server-adapter.ts +502 -0
  23. package/src/adapters/node/static-content-server.test.ts +60 -0
  24. package/src/adapters/node/static-content-server.ts +239 -0
  25. package/src/adapters/shared/api-response.test.ts +97 -0
  26. package/src/adapters/shared/api-response.ts +104 -0
  27. package/src/adapters/shared/application-adapter.ts +199 -0
  28. package/src/adapters/shared/define-api-handler.ts +66 -0
  29. package/src/adapters/shared/explicit-static-route-matcher.test.ts +381 -0
  30. package/src/adapters/shared/explicit-static-route-matcher.ts +140 -0
  31. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +90 -0
  32. package/src/adapters/shared/file-route-middleware-pipeline.ts +127 -0
  33. package/src/adapters/shared/fs-server-response-factory.test.ts +187 -0
  34. package/src/adapters/shared/fs-server-response-factory.ts +118 -0
  35. package/src/adapters/shared/fs-server-response-matcher.test.ts +285 -0
  36. package/src/adapters/shared/fs-server-response-matcher.ts +189 -0
  37. package/src/adapters/shared/hmr-entrypoint-registrar.ts +149 -0
  38. package/src/adapters/shared/hmr-html-response.ts +52 -0
  39. package/src/adapters/shared/hmr-manager.contract.test.ts +232 -0
  40. package/src/adapters/shared/hmr-manager.dispatch.test.ts +220 -0
  41. package/src/adapters/shared/render-context.test.ts +150 -0
  42. package/src/adapters/shared/render-context.ts +123 -0
  43. package/src/adapters/shared/runtime-bootstrap.ts +79 -0
  44. package/src/adapters/shared/server-adapter.test.ts +77 -0
  45. package/src/adapters/shared/server-adapter.ts +493 -0
  46. package/src/adapters/shared/server-route-handler.test.ts +110 -0
  47. package/src/adapters/shared/server-route-handler.ts +153 -0
  48. package/src/adapters/shared/server-static-builder.test.ts +338 -0
  49. package/src/adapters/shared/server-static-builder.ts +170 -0
  50. package/src/build/build-adapter-serialization.test.ts +281 -0
  51. package/src/build/build-adapter.test.ts +1240 -0
  52. package/src/build/build-adapter.ts +1012 -0
  53. package/src/build/build-manifest.ts +54 -0
  54. package/src/build/build-types.ts +83 -0
  55. package/src/build/dev-build-coordinator.ts +220 -0
  56. package/src/build/esbuild-build-adapter.ts +660 -0
  57. package/src/build/runtime-build-executor.test.ts +81 -0
  58. package/src/build/runtime-build-executor.ts +40 -0
  59. package/src/build/runtime-specifier-alias-plugin.test.ts +67 -0
  60. package/src/build/runtime-specifier-alias-plugin.ts +62 -0
  61. package/src/build/runtime-specifier-aliases.ts +135 -0
  62. package/src/config/config-builder.test.ts +443 -0
  63. package/src/config/config-builder.ts +742 -0
  64. package/src/config/config-builder.typecheck.test.ts +96 -0
  65. package/src/config/{constants.d.ts → constants.ts} +22 -13
  66. package/src/dev/sc-server.ts +143 -0
  67. package/src/eco/eco.browser.test.ts +43 -0
  68. package/src/eco/eco.browser.ts +118 -0
  69. package/src/eco/eco.test.ts +654 -0
  70. package/src/eco/eco.ts +205 -0
  71. package/src/eco/eco.types.ts +221 -0
  72. package/src/eco/eco.utils.test.ts +219 -0
  73. package/src/eco/eco.utils.ts +5 -0
  74. package/src/eco/global-injector-map.test.ts +42 -0
  75. package/src/eco/global-injector-map.ts +112 -0
  76. package/src/eco/lazy-injector-map.test.ts +66 -0
  77. package/src/eco/lazy-injector-map.ts +120 -0
  78. package/src/eco/module-dependencies.test.ts +30 -0
  79. package/src/eco/module-dependencies.ts +75 -0
  80. package/src/errors/http-error.test.ts +134 -0
  81. package/src/errors/http-error.ts +72 -0
  82. package/src/errors/{index.d.ts → index.ts} +2 -2
  83. package/src/errors/locals-access-error.ts +7 -0
  84. package/src/global/app-logger.ts +4 -0
  85. package/src/global/utils.test.ts +12 -0
  86. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-have-HMR-script-injected-in-page-1.png +0 -0
  87. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  88. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  89. package/src/hmr/client/hmr-runtime.ts +160 -0
  90. package/src/hmr/hmr-strategy.test.ts +124 -0
  91. package/src/hmr/hmr-strategy.ts +177 -0
  92. package/src/hmr/hmr.postcss.test.e2e.ts +41 -0
  93. package/src/hmr/hmr.test.e2e.ts +66 -0
  94. package/src/hmr/strategies/default-hmr-strategy.ts +60 -0
  95. package/src/hmr/strategies/js-hmr-strategy.test.ts +335 -0
  96. package/src/hmr/strategies/js-hmr-strategy.ts +320 -0
  97. package/src/index.browser.ts +3 -0
  98. package/src/index.ts +15 -0
  99. package/src/integrations/ghtml/ghtml-renderer.test.ts +253 -0
  100. package/src/integrations/ghtml/ghtml-renderer.ts +97 -0
  101. package/src/integrations/ghtml/ghtml.constants.ts +1 -0
  102. package/src/integrations/ghtml/ghtml.plugin.ts +28 -0
  103. package/src/plugins/alias-resolver-plugin.test.ts +41 -0
  104. package/src/plugins/alias-resolver-plugin.ts +63 -0
  105. package/src/plugins/eco-component-meta-plugin.test.ts +406 -0
  106. package/src/plugins/eco-component-meta-plugin.ts +495 -0
  107. package/src/plugins/foreign-jsx-override-plugin.test.ts +65 -0
  108. package/src/plugins/foreign-jsx-override-plugin.ts +67 -0
  109. package/src/plugins/integration-plugin.test.ts +156 -0
  110. package/src/plugins/integration-plugin.ts +311 -0
  111. package/src/plugins/processor.test.ts +148 -0
  112. package/src/plugins/processor.ts +240 -0
  113. package/src/plugins/{runtime-capability.d.ts → runtime-capability.ts} +8 -3
  114. package/src/plugins/source-transform.test.ts +82 -0
  115. package/src/plugins/source-transform.ts +123 -0
  116. package/src/route-renderer/orchestration/boundary-planning.service.ts +146 -0
  117. package/src/route-renderer/orchestration/component-render-context.ts +318 -0
  118. package/src/route-renderer/orchestration/integration-renderer.test.ts +2088 -0
  119. package/src/route-renderer/orchestration/integration-renderer.ts +1285 -0
  120. package/src/route-renderer/orchestration/page-packaging.service.test.ts +76 -0
  121. package/src/route-renderer/orchestration/page-packaging.service.ts +85 -0
  122. package/src/route-renderer/orchestration/processed-asset-dedupe.ts +25 -0
  123. package/src/route-renderer/orchestration/queued-boundary-runtime.service.test.ts +319 -0
  124. package/src/route-renderer/orchestration/queued-boundary-runtime.service.ts +289 -0
  125. package/src/route-renderer/orchestration/render-execution.service.test.ts +196 -0
  126. package/src/route-renderer/orchestration/render-execution.service.ts +182 -0
  127. package/src/route-renderer/orchestration/render-output.utils.ts +302 -0
  128. package/src/route-renderer/orchestration/render-preparation.service.test.ts +569 -0
  129. package/src/route-renderer/orchestration/render-preparation.service.ts +508 -0
  130. package/src/route-renderer/orchestration/route-shell-composer.service.ts +162 -0
  131. package/src/route-renderer/orchestration/template-serialization.test.ts +110 -0
  132. package/src/route-renderer/orchestration/template-serialization.ts +117 -0
  133. package/src/route-renderer/page-loading/component-dependency-collection.ts +196 -0
  134. package/src/route-renderer/page-loading/declared-asset-collection.ts +156 -0
  135. package/src/route-renderer/page-loading/dependency-resolver.test.ts +665 -0
  136. package/src/route-renderer/page-loading/dependency-resolver.ts +150 -0
  137. package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +75 -0
  138. package/src/route-renderer/page-loading/lazy-entry-collection.ts +167 -0
  139. package/src/route-renderer/page-loading/lazy-trigger-planning.ts +74 -0
  140. package/src/route-renderer/page-loading/module-declaration-aggregation.ts +60 -0
  141. package/src/route-renderer/page-loading/module-declaration-scripts.ts +16 -0
  142. package/src/route-renderer/page-loading/page-dependency-bundling.ts +205 -0
  143. package/src/route-renderer/page-loading/page-module-loader.test.ts +183 -0
  144. package/src/route-renderer/page-loading/page-module-loader.ts +184 -0
  145. package/src/route-renderer/route-renderer.ts +136 -0
  146. package/src/router/client/link-intent.test.browser.ts +51 -0
  147. package/src/router/client/link-intent.ts +92 -0
  148. package/src/router/client/navigation-coordinator.test.ts +237 -0
  149. package/src/router/client/navigation-coordinator.ts +453 -0
  150. package/src/router/server/fs-router-scanner.test.ts +83 -0
  151. package/src/router/server/fs-router-scanner.ts +224 -0
  152. package/src/router/server/fs-router.test.ts +214 -0
  153. package/src/router/server/fs-router.ts +122 -0
  154. package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +66 -0
  155. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +476 -0
  156. package/src/services/assets/asset-processing-service/asset-processing.service.ts +345 -0
  157. package/src/services/assets/asset-processing-service/asset.factory.test.ts +63 -0
  158. package/src/services/assets/asset-processing-service/asset.factory.ts +105 -0
  159. package/src/services/assets/asset-processing-service/assets.types.ts +125 -0
  160. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +74 -0
  161. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +96 -0
  162. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +67 -0
  163. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +78 -0
  164. package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +104 -0
  165. package/src/services/assets/asset-processing-service/index.ts +5 -0
  166. package/src/services/assets/asset-processing-service/{processor.interface.d.ts → processor.interface.ts} +10 -5
  167. package/src/services/assets/asset-processing-service/processor.registry.ts +18 -0
  168. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +59 -0
  169. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +83 -0
  170. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +174 -0
  171. package/src/services/assets/asset-processing-service/processors/index.ts +5 -0
  172. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +192 -0
  173. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +134 -0
  174. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +326 -0
  175. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +110 -0
  176. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +227 -0
  177. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +87 -0
  178. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +261 -0
  179. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +71 -0
  180. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +81 -0
  181. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +65 -0
  182. package/src/services/assets/browser-bundle.service.test.ts +66 -0
  183. package/src/services/assets/browser-bundle.service.ts +109 -0
  184. package/src/services/cache/cache.types.ts +126 -0
  185. package/src/services/cache/index.ts +18 -0
  186. package/src/services/cache/memory-cache-store.test.ts +225 -0
  187. package/src/services/cache/memory-cache-store.ts +130 -0
  188. package/src/services/cache/page-cache-service.test.ts +175 -0
  189. package/src/services/cache/page-cache-service.ts +202 -0
  190. package/src/services/cache/page-request-cache-coordinator.service.test.ts +79 -0
  191. package/src/services/cache/page-request-cache-coordinator.service.ts +131 -0
  192. package/src/services/html/html-rewriter-provider.service.test.ts +183 -0
  193. package/src/services/html/html-rewriter-provider.service.ts +104 -0
  194. package/src/services/html/html-transformer.service.test.ts +479 -0
  195. package/src/services/html/html-transformer.service.ts +275 -0
  196. package/src/services/invalidation/development-invalidation.service.test.ts +87 -0
  197. package/src/services/invalidation/development-invalidation.service.ts +262 -0
  198. package/src/services/module-loading/app-module-loader.service.ts +9 -0
  199. package/src/services/module-loading/app-server-module-transpiler.service.test.ts +130 -0
  200. package/src/services/module-loading/app-server-module-transpiler.service.ts +143 -0
  201. package/src/services/module-loading/host-module-loader-registry.ts +15 -0
  202. package/src/services/module-loading/{module-loading-types.d.ts → module-loading-types.ts} +1 -0
  203. package/src/services/module-loading/node-bootstrap-plugin.test.ts +335 -0
  204. package/src/services/module-loading/node-bootstrap-plugin.ts +297 -0
  205. package/src/services/module-loading/page-module-import.service.test.ts +504 -0
  206. package/src/services/module-loading/page-module-import.service.ts +252 -0
  207. package/src/services/module-loading/server-module-transpiler.service.test.ts +243 -0
  208. package/src/services/module-loading/server-module-transpiler.service.ts +104 -0
  209. package/src/services/module-loading/source-module-support.ts +19 -0
  210. package/src/services/runtime-state/dev-graph.service.ts +217 -0
  211. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +136 -0
  212. package/src/services/runtime-state/runtime-specifier-registry.service.ts +96 -0
  213. package/src/services/runtime-state/server-invalidation-state.service.ts +68 -0
  214. package/src/services/validation/schema-validation-service.test.ts +223 -0
  215. package/src/services/validation/schema-validation-service.ts +204 -0
  216. package/src/services/validation/{standard-schema.types.d.ts → standard-schema.types.ts} +20 -17
  217. package/src/static-site-generator/static-site-generator.test.ts +316 -0
  218. package/src/static-site-generator/static-site-generator.ts +462 -0
  219. package/src/types/internal-types.ts +242 -0
  220. package/src/types/public-types.ts +1443 -0
  221. package/src/utils/deep-merge.test.ts +114 -0
  222. package/src/utils/deep-merge.ts +47 -0
  223. package/src/utils/hash.ts +5 -0
  224. package/src/utils/html-escaping.ts +9 -0
  225. package/src/utils/invariant.test.ts +22 -0
  226. package/src/utils/invariant.ts +15 -0
  227. package/src/utils/locals-utils.ts +37 -0
  228. package/src/utils/parse-cli-args.test.ts +69 -0
  229. package/src/utils/parse-cli-args.ts +105 -0
  230. package/src/utils/path-utils.module.ts +14 -0
  231. package/src/utils/path-utils.test.ts +15 -0
  232. package/src/utils/resolve-work-dir.ts +45 -0
  233. package/src/utils/runtime.ts +44 -0
  234. package/src/utils/server-utils.module.ts +67 -0
  235. package/src/utils/server-utils.test.ts +38 -0
  236. package/src/watchers/project-watcher.integration.test.ts +337 -0
  237. package/src/watchers/project-watcher.test-helpers.ts +41 -0
  238. package/src/watchers/project-watcher.test.ts +768 -0
  239. package/src/watchers/project-watcher.ts +357 -0
  240. package/CHANGELOG.md +0 -51
  241. package/src/adapters/abstract/application-adapter.d.ts +0 -194
  242. package/src/adapters/abstract/application-adapter.js +0 -121
  243. package/src/adapters/abstract/router-adapter.d.ts +0 -26
  244. package/src/adapters/abstract/router-adapter.js +0 -5
  245. package/src/adapters/abstract/server-adapter.d.ts +0 -69
  246. package/src/adapters/abstract/server-adapter.js +0 -15
  247. package/src/adapters/bun/client-bridge.d.ts +0 -34
  248. package/src/adapters/bun/client-bridge.js +0 -48
  249. package/src/adapters/bun/create-app.d.ts +0 -52
  250. package/src/adapters/bun/create-app.js +0 -116
  251. package/src/adapters/bun/hmr-manager.d.ts +0 -143
  252. package/src/adapters/bun/hmr-manager.js +0 -333
  253. package/src/adapters/bun/index.d.ts +0 -2
  254. package/src/adapters/bun/index.js +0 -8
  255. package/src/adapters/bun/server-adapter.d.ts +0 -155
  256. package/src/adapters/bun/server-adapter.js +0 -374
  257. package/src/adapters/bun/server-lifecycle.d.ts +0 -63
  258. package/src/adapters/bun/server-lifecycle.js +0 -92
  259. package/src/adapters/create-app.d.ts +0 -20
  260. package/src/adapters/create-app.js +0 -66
  261. package/src/adapters/index.d.ts +0 -2
  262. package/src/adapters/index.js +0 -8
  263. package/src/adapters/node/create-app.d.ts +0 -18
  264. package/src/adapters/node/create-app.js +0 -149
  265. package/src/adapters/node/node-client-bridge.d.ts +0 -26
  266. package/src/adapters/node/node-client-bridge.js +0 -66
  267. package/src/adapters/node/node-hmr-manager.d.ts +0 -133
  268. package/src/adapters/node/node-hmr-manager.js +0 -311
  269. package/src/adapters/node/server-adapter.d.ts +0 -161
  270. package/src/adapters/node/server-adapter.js +0 -359
  271. package/src/adapters/node/static-content-server.d.ts +0 -60
  272. package/src/adapters/node/static-content-server.js +0 -194
  273. package/src/adapters/shared/api-response.d.ts +0 -52
  274. package/src/adapters/shared/api-response.js +0 -96
  275. package/src/adapters/shared/application-adapter.d.ts +0 -18
  276. package/src/adapters/shared/application-adapter.js +0 -90
  277. package/src/adapters/shared/define-api-handler.d.ts +0 -25
  278. package/src/adapters/shared/define-api-handler.js +0 -15
  279. package/src/adapters/shared/explicit-static-route-matcher.d.ts +0 -38
  280. package/src/adapters/shared/explicit-static-route-matcher.js +0 -103
  281. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +0 -65
  282. package/src/adapters/shared/file-route-middleware-pipeline.js +0 -99
  283. package/src/adapters/shared/fs-server-response-factory.d.ts +0 -19
  284. package/src/adapters/shared/fs-server-response-factory.js +0 -97
  285. package/src/adapters/shared/fs-server-response-matcher.d.ts +0 -67
  286. package/src/adapters/shared/fs-server-response-matcher.js +0 -147
  287. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +0 -55
  288. package/src/adapters/shared/hmr-entrypoint-registrar.js +0 -87
  289. package/src/adapters/shared/hmr-html-response.d.ts +0 -22
  290. package/src/adapters/shared/hmr-html-response.js +0 -32
  291. package/src/adapters/shared/render-context.d.ts +0 -15
  292. package/src/adapters/shared/render-context.js +0 -72
  293. package/src/adapters/shared/runtime-bootstrap.d.ts +0 -38
  294. package/src/adapters/shared/runtime-bootstrap.js +0 -43
  295. package/src/adapters/shared/server-adapter.d.ts +0 -97
  296. package/src/adapters/shared/server-adapter.js +0 -390
  297. package/src/adapters/shared/server-route-handler.d.ts +0 -89
  298. package/src/adapters/shared/server-route-handler.js +0 -111
  299. package/src/adapters/shared/server-static-builder.d.ts +0 -70
  300. package/src/adapters/shared/server-static-builder.js +0 -100
  301. package/src/build/build-adapter.d.ts +0 -239
  302. package/src/build/build-adapter.js +0 -642
  303. package/src/build/build-manifest.d.ts +0 -27
  304. package/src/build/build-manifest.js +0 -30
  305. package/src/build/build-types.d.ts +0 -57
  306. package/src/build/build-types.js +0 -0
  307. package/src/build/dev-build-coordinator.d.ts +0 -72
  308. package/src/build/dev-build-coordinator.js +0 -154
  309. package/src/build/esbuild-build-adapter.d.ts +0 -78
  310. package/src/build/esbuild-build-adapter.js +0 -505
  311. package/src/build/runtime-build-executor.d.ts +0 -14
  312. package/src/build/runtime-build-executor.js +0 -22
  313. package/src/build/runtime-specifier-alias-plugin.d.ts +0 -15
  314. package/src/build/runtime-specifier-alias-plugin.js +0 -35
  315. package/src/build/runtime-specifier-aliases.d.ts +0 -5
  316. package/src/build/runtime-specifier-aliases.js +0 -95
  317. package/src/config/config-builder.d.ts +0 -252
  318. package/src/config/config-builder.js +0 -603
  319. package/src/config/constants.js +0 -25
  320. package/src/dev/sc-server.d.ts +0 -30
  321. package/src/dev/sc-server.js +0 -111
  322. package/src/eco/eco.browser.d.ts +0 -2
  323. package/src/eco/eco.browser.js +0 -83
  324. package/src/eco/eco.d.ts +0 -9
  325. package/src/eco/eco.js +0 -85
  326. package/src/eco/eco.types.d.ts +0 -178
  327. package/src/eco/eco.types.js +0 -0
  328. package/src/eco/eco.utils.d.ts +0 -1
  329. package/src/eco/eco.utils.js +0 -10
  330. package/src/eco/global-injector-map.d.ts +0 -16
  331. package/src/eco/global-injector-map.js +0 -80
  332. package/src/eco/lazy-injector-map.d.ts +0 -8
  333. package/src/eco/lazy-injector-map.js +0 -70
  334. package/src/eco/module-dependencies.d.ts +0 -18
  335. package/src/eco/module-dependencies.js +0 -49
  336. package/src/errors/http-error.d.ts +0 -31
  337. package/src/errors/http-error.js +0 -50
  338. package/src/errors/index.js +0 -4
  339. package/src/errors/locals-access-error.d.ts +0 -4
  340. package/src/errors/locals-access-error.js +0 -9
  341. package/src/global/app-logger.d.ts +0 -2
  342. package/src/global/app-logger.js +0 -6
  343. package/src/hmr/client/hmr-runtime.d.ts +0 -5
  344. package/src/hmr/client/hmr-runtime.js +0 -109
  345. package/src/hmr/hmr-strategy.d.ts +0 -162
  346. package/src/hmr/hmr-strategy.js +0 -44
  347. package/src/hmr/hmr.postcss.test.e2e.d.ts +0 -1
  348. package/src/hmr/hmr.postcss.test.e2e.js +0 -31
  349. package/src/hmr/hmr.test.e2e.d.ts +0 -1
  350. package/src/hmr/hmr.test.e2e.js +0 -43
  351. package/src/hmr/strategies/default-hmr-strategy.d.ts +0 -43
  352. package/src/hmr/strategies/default-hmr-strategy.js +0 -34
  353. package/src/hmr/strategies/js-hmr-strategy.d.ts +0 -139
  354. package/src/hmr/strategies/js-hmr-strategy.js +0 -178
  355. package/src/index.browser.d.ts +0 -3
  356. package/src/index.browser.js +0 -4
  357. package/src/index.d.ts +0 -6
  358. package/src/index.js +0 -21
  359. package/src/integrations/ghtml/ghtml-renderer.d.ts +0 -20
  360. package/src/integrations/ghtml/ghtml-renderer.js +0 -63
  361. package/src/integrations/ghtml/ghtml.constants.d.ts +0 -1
  362. package/src/integrations/ghtml/ghtml.constants.js +0 -4
  363. package/src/integrations/ghtml/ghtml.plugin.d.ts +0 -16
  364. package/src/integrations/ghtml/ghtml.plugin.js +0 -20
  365. package/src/plugins/alias-resolver-plugin.d.ts +0 -2
  366. package/src/plugins/alias-resolver-plugin.js +0 -53
  367. package/src/plugins/eco-component-meta-plugin.d.ts +0 -108
  368. package/src/plugins/eco-component-meta-plugin.js +0 -163
  369. package/src/plugins/foreign-jsx-override-plugin.d.ts +0 -31
  370. package/src/plugins/foreign-jsx-override-plugin.js +0 -35
  371. package/src/plugins/integration-plugin.d.ts +0 -219
  372. package/src/plugins/integration-plugin.js +0 -196
  373. package/src/plugins/processor.d.ts +0 -95
  374. package/src/plugins/processor.js +0 -136
  375. package/src/plugins/runtime-capability.js +0 -0
  376. package/src/plugins/source-transform.d.ts +0 -46
  377. package/src/plugins/source-transform.js +0 -71
  378. package/src/route-renderer/orchestration/boundary-planning.service.d.ts +0 -25
  379. package/src/route-renderer/orchestration/boundary-planning.service.js +0 -97
  380. package/src/route-renderer/orchestration/component-render-context.d.ts +0 -83
  381. package/src/route-renderer/orchestration/component-render-context.js +0 -147
  382. package/src/route-renderer/orchestration/integration-renderer.d.ts +0 -554
  383. package/src/route-renderer/orchestration/integration-renderer.js +0 -957
  384. package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +0 -89
  385. package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +0 -155
  386. package/src/route-renderer/orchestration/render-execution.service.d.ts +0 -43
  387. package/src/route-renderer/orchestration/render-execution.service.js +0 -106
  388. package/src/route-renderer/orchestration/render-output.utils.d.ts +0 -46
  389. package/src/route-renderer/orchestration/render-output.utils.js +0 -65
  390. package/src/route-renderer/orchestration/render-preparation.service.d.ts +0 -120
  391. package/src/route-renderer/orchestration/render-preparation.service.js +0 -341
  392. package/src/route-renderer/orchestration/route-shell-composer.service.d.ts +0 -50
  393. package/src/route-renderer/orchestration/route-shell-composer.service.js +0 -81
  394. package/src/route-renderer/orchestration/template-serialization.d.ts +0 -38
  395. package/src/route-renderer/orchestration/template-serialization.js +0 -45
  396. package/src/route-renderer/page-loading/dependency-resolver.d.ts +0 -35
  397. package/src/route-renderer/page-loading/dependency-resolver.js +0 -444
  398. package/src/route-renderer/page-loading/page-module-loader.d.ts +0 -90
  399. package/src/route-renderer/page-loading/page-module-loader.js +0 -127
  400. package/src/route-renderer/route-renderer.d.ts +0 -67
  401. package/src/route-renderer/route-renderer.js +0 -103
  402. package/src/router/client/link-intent.js +0 -34
  403. package/src/router/client/link-intent.test.browser.d.ts +0 -1
  404. package/src/router/client/link-intent.test.browser.js +0 -43
  405. package/src/router/client/navigation-coordinator.d.ts +0 -149
  406. package/src/router/client/navigation-coordinator.js +0 -215
  407. package/src/router/server/fs-router-scanner.d.ts +0 -41
  408. package/src/router/server/fs-router-scanner.js +0 -161
  409. package/src/router/server/fs-router.d.ts +0 -26
  410. package/src/router/server/fs-router.js +0 -100
  411. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +0 -120
  412. package/src/services/assets/asset-processing-service/asset-processing.service.js +0 -331
  413. package/src/services/assets/asset-processing-service/asset.factory.d.ts +0 -17
  414. package/src/services/assets/asset-processing-service/asset.factory.js +0 -82
  415. package/src/services/assets/asset-processing-service/assets.types.d.ts +0 -89
  416. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  417. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +0 -55
  418. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +0 -48
  419. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +0 -20
  420. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +0 -41
  421. package/src/services/assets/asset-processing-service/index.d.ts +0 -5
  422. package/src/services/assets/asset-processing-service/index.js +0 -5
  423. package/src/services/assets/asset-processing-service/processor.interface.js +0 -6
  424. package/src/services/assets/asset-processing-service/processor.registry.d.ts +0 -8
  425. package/src/services/assets/asset-processing-service/processor.registry.js +0 -15
  426. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +0 -24
  427. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +0 -64
  428. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +0 -17
  429. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +0 -72
  430. package/src/services/assets/asset-processing-service/processors/index.d.ts +0 -5
  431. package/src/services/assets/asset-processing-service/processors/index.js +0 -5
  432. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +0 -5
  433. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +0 -57
  434. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +0 -9
  435. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +0 -88
  436. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +0 -7
  437. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +0 -75
  438. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +0 -5
  439. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -25
  440. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +0 -9
  441. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +0 -66
  442. package/src/services/assets/browser-bundle.service.d.ts +0 -32
  443. package/src/services/assets/browser-bundle.service.js +0 -33
  444. package/src/services/cache/cache.types.d.ts +0 -107
  445. package/src/services/cache/cache.types.js +0 -0
  446. package/src/services/cache/index.d.ts +0 -7
  447. package/src/services/cache/index.js +0 -7
  448. package/src/services/cache/memory-cache-store.d.ts +0 -42
  449. package/src/services/cache/memory-cache-store.js +0 -98
  450. package/src/services/cache/page-cache-service.d.ts +0 -70
  451. package/src/services/cache/page-cache-service.js +0 -152
  452. package/src/services/cache/page-request-cache-coordinator.service.d.ts +0 -75
  453. package/src/services/cache/page-request-cache-coordinator.service.js +0 -109
  454. package/src/services/html/html-rewriter-provider.service.d.ts +0 -37
  455. package/src/services/html/html-rewriter-provider.service.js +0 -68
  456. package/src/services/html/html-transformer.service.d.ts +0 -77
  457. package/src/services/html/html-transformer.service.js +0 -215
  458. package/src/services/invalidation/development-invalidation.service.d.ts +0 -74
  459. package/src/services/invalidation/development-invalidation.service.js +0 -190
  460. package/src/services/module-loading/app-module-loader.service.d.ts +0 -28
  461. package/src/services/module-loading/app-module-loader.service.js +0 -35
  462. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +0 -24
  463. package/src/services/module-loading/app-server-module-transpiler.service.js +0 -109
  464. package/src/services/module-loading/host-module-loader-registry.d.ts +0 -4
  465. package/src/services/module-loading/host-module-loader-registry.js +0 -15
  466. package/src/services/module-loading/module-loading-types.js +0 -0
  467. package/src/services/module-loading/node-bootstrap-plugin.d.ts +0 -42
  468. package/src/services/module-loading/node-bootstrap-plugin.js +0 -204
  469. package/src/services/module-loading/page-module-import.service.d.ts +0 -76
  470. package/src/services/module-loading/page-module-import.service.js +0 -173
  471. package/src/services/module-loading/server-module-transpiler.service.d.ts +0 -72
  472. package/src/services/module-loading/server-module-transpiler.service.js +0 -64
  473. package/src/services/runtime-state/dev-graph.service.d.ts +0 -118
  474. package/src/services/runtime-state/dev-graph.service.js +0 -162
  475. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +0 -41
  476. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +0 -85
  477. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +0 -69
  478. package/src/services/runtime-state/runtime-specifier-registry.service.js +0 -37
  479. package/src/services/runtime-state/server-invalidation-state.service.d.ts +0 -26
  480. package/src/services/runtime-state/server-invalidation-state.service.js +0 -35
  481. package/src/services/validation/schema-validation-service.d.ts +0 -122
  482. package/src/services/validation/schema-validation-service.js +0 -101
  483. package/src/services/validation/standard-schema.types.js +0 -0
  484. package/src/static-site-generator/static-site-generator.d.ts +0 -104
  485. package/src/static-site-generator/static-site-generator.js +0 -338
  486. package/src/types/internal-types.d.ts +0 -231
  487. package/src/types/internal-types.js +0 -0
  488. package/src/types/public-types.d.ts +0 -1219
  489. package/src/types/public-types.js +0 -0
  490. package/src/utils/deep-merge.d.ts +0 -14
  491. package/src/utils/deep-merge.js +0 -32
  492. package/src/utils/hash.d.ts +0 -1
  493. package/src/utils/hash.js +0 -7
  494. package/src/utils/html-escaping.d.ts +0 -7
  495. package/src/utils/html-escaping.js +0 -6
  496. package/src/utils/html.js +0 -4
  497. package/src/utils/invariant.d.ts +0 -5
  498. package/src/utils/invariant.js +0 -11
  499. package/src/utils/locals-utils.d.ts +0 -15
  500. package/src/utils/locals-utils.js +0 -24
  501. package/src/utils/parse-cli-args.d.ts +0 -27
  502. package/src/utils/parse-cli-args.js +0 -62
  503. package/src/utils/path-utils.module.d.ts +0 -5
  504. package/src/utils/path-utils.module.js +0 -14
  505. package/src/utils/resolve-work-dir.d.ts +0 -11
  506. package/src/utils/resolve-work-dir.js +0 -31
  507. package/src/utils/runtime.d.ts +0 -11
  508. package/src/utils/runtime.js +0 -40
  509. package/src/utils/server-utils.module.d.ts +0 -19
  510. package/src/utils/server-utils.module.js +0 -56
  511. package/src/watchers/project-watcher.d.ts +0 -136
  512. package/src/watchers/project-watcher.js +0 -275
  513. package/src/watchers/project-watcher.test-helpers.d.ts +0 -4
  514. package/src/watchers/project-watcher.test-helpers.js +0 -52
  515. /package/src/utils/{html.d.ts → html.ts} +0 -0
@@ -1,67 +0,0 @@
1
- import type { EcoPagesAppConfig } from '../types/internal-types.js';
2
- import type { IntegrationPlugin } from '../plugins/integration-plugin.js';
3
- import type { EcoPageFile, RouteRenderResult, RouteRendererOptions } from '../types/public-types.js';
4
- import type { IntegrationRenderer, RouteModuleLoadOptions } from './orchestration/integration-renderer.js';
5
- /**
6
- * Thin wrapper around one initialized integration renderer.
7
- *
8
- * @remarks
9
- * This type exists so higher-level routing code can ask for a route renderer
10
- * without depending on the full integration plugin lifecycle. It delegates all
11
- * real work to the integration-specific renderer selected by the factory.
12
- */
13
- export declare class RouteRenderer {
14
- private renderer;
15
- /**
16
- * Creates a route renderer bound to one integration renderer instance.
17
- */
18
- constructor(renderer: IntegrationRenderer);
19
- /**
20
- * Executes the render pipeline for one matched route.
21
- */
22
- createRoute(options: RouteRendererOptions): Promise<RouteRenderResult>;
23
- /**
24
- * Loads the route module through the owning integration renderer.
25
- */
26
- loadPageModule(filePath: string, options?: RouteModuleLoadOptions): Promise<EcoPageFile>;
27
- }
28
- /**
29
- * Selects and caches integration renderers for route files and explicit views.
30
- *
31
- * @remarks
32
- * The factory owns the policy that maps a route file or explicit integration
33
- * name to one initialized integration renderer. Renderer instances are cached by
34
- * integration name so repeated requests do not rebuild renderer state.
35
- */
36
- export declare class RouteRendererFactory {
37
- private appConfig;
38
- runtimeOrigin: string;
39
- private rendererModules?;
40
- private rendererCache;
41
- /**
42
- * Creates the route-renderer factory for one app/runtime instance.
43
- */
44
- constructor({ appConfig, rendererModules, runtimeOrigin, }: {
45
- appConfig: EcoPagesAppConfig;
46
- rendererModules?: unknown;
47
- runtimeOrigin: string;
48
- });
49
- /**
50
- * Returns a route renderer for the supplied route file.
51
- */
52
- createRenderer(filePath: string): RouteRenderer;
53
- /**
54
- * Get an integration renderer by its name.
55
- * Used for explicit routing where views specify their integration via __eco.integration.
56
- */
57
- getRendererByIntegration(integrationName: string): IntegrationRenderer | null;
58
- /**
59
- * Resolves the integration plugin that owns a given route file.
60
- */
61
- getIntegrationPlugin(filePath: string): IntegrationPlugin;
62
- /**
63
- * Returns the cached renderer engine for the file's owning integration,
64
- * creating it on first use.
65
- */
66
- private getRouteRendererEngine;
67
- }
@@ -1,103 +0,0 @@
1
- import { invariant } from "../utils/invariant.js";
2
- import { PathUtils } from "../utils/path-utils.module.js";
3
- class RouteRenderer {
4
- renderer;
5
- /**
6
- * Creates a route renderer bound to one integration renderer instance.
7
- */
8
- constructor(renderer) {
9
- this.renderer = renderer;
10
- }
11
- /**
12
- * Executes the render pipeline for one matched route.
13
- */
14
- async createRoute(options) {
15
- return this.renderer.execute(options);
16
- }
17
- /**
18
- * Loads the route module through the owning integration renderer.
19
- */
20
- async loadPageModule(filePath, options) {
21
- return this.renderer.loadPageModule(filePath, options);
22
- }
23
- }
24
- class RouteRendererFactory {
25
- appConfig;
26
- runtimeOrigin;
27
- rendererModules;
28
- rendererCache = /* @__PURE__ */ new Map();
29
- /**
30
- * Creates the route-renderer factory for one app/runtime instance.
31
- */
32
- constructor({
33
- appConfig,
34
- rendererModules,
35
- runtimeOrigin
36
- }) {
37
- this.appConfig = appConfig;
38
- this.rendererModules = rendererModules;
39
- this.runtimeOrigin = runtimeOrigin;
40
- }
41
- /**
42
- * Returns a route renderer for the supplied route file.
43
- */
44
- createRenderer(filePath) {
45
- const integrationRenderer = this.getRouteRendererEngine(filePath);
46
- invariant(!!integrationRenderer, `No integration renderer found for file: ${filePath}`);
47
- return new RouteRenderer(integrationRenderer);
48
- }
49
- /**
50
- * Get an integration renderer by its name.
51
- * Used for explicit routing where views specify their integration via __eco.integration.
52
- */
53
- getRendererByIntegration(integrationName) {
54
- const integrationPlugin = this.appConfig.integrations.find((plugin) => plugin.name === integrationName);
55
- if (!integrationPlugin) {
56
- return null;
57
- }
58
- const cached = this.rendererCache.get(integrationName);
59
- if (cached) {
60
- return cached;
61
- }
62
- const renderer = integrationPlugin.initializeRenderer({
63
- rendererModules: this.rendererModules
64
- });
65
- this.rendererCache.set(integrationName, renderer);
66
- return renderer;
67
- }
68
- /**
69
- * Resolves the integration plugin that owns a given route file.
70
- */
71
- getIntegrationPlugin(filePath) {
72
- const templateExtension = PathUtils.getEcoTemplateExtension(filePath);
73
- const isIntegrationPlugin = (plugin) => {
74
- return plugin.extensions.some((extension) => templateExtension === extension);
75
- };
76
- const integrationPlugin = this.appConfig.integrations.find(isIntegrationPlugin);
77
- invariant(
78
- !!integrationPlugin,
79
- `No integration plugin found for template extension: ${templateExtension}, file: ${filePath}`
80
- );
81
- return integrationPlugin;
82
- }
83
- /**
84
- * Returns the cached renderer engine for the file's owning integration,
85
- * creating it on first use.
86
- */
87
- getRouteRendererEngine(filePath) {
88
- const integrationPlugin = this.getIntegrationPlugin(filePath);
89
- const cached = this.rendererCache.get(integrationPlugin.name);
90
- if (cached) {
91
- return cached;
92
- }
93
- const renderer = integrationPlugin.initializeRenderer({
94
- rendererModules: this.rendererModules
95
- });
96
- this.rendererCache.set(integrationPlugin.name, renderer);
97
- return renderer;
98
- }
99
- }
100
- export {
101
- RouteRenderer,
102
- RouteRendererFactory
103
- };
@@ -1,34 +0,0 @@
1
- function getAnchorFromNavigationEvent(event, linkSelector) {
2
- const eventTarget = event.target;
3
- if (eventTarget instanceof HTMLAnchorElement && eventTarget.matches(linkSelector)) {
4
- return eventTarget;
5
- }
6
- if (eventTarget instanceof Element) {
7
- const closestAnchor = eventTarget.closest(linkSelector);
8
- if (closestAnchor instanceof HTMLAnchorElement) {
9
- return closestAnchor;
10
- }
11
- }
12
- if (eventTarget instanceof Text) {
13
- const parentAnchor = eventTarget.parentElement?.closest(linkSelector);
14
- if (parentAnchor instanceof HTMLAnchorElement) {
15
- return parentAnchor;
16
- }
17
- }
18
- return event.composedPath().find(
19
- (target) => target instanceof HTMLAnchorElement && target.matches(linkSelector)
20
- );
21
- }
22
- function recoverPendingNavigationHref(intent, hasInFlightNavigation, now, maxAgeMs = 1e3) {
23
- if (!intent || !hasInFlightNavigation) {
24
- return null;
25
- }
26
- if (now - intent.timestamp > maxAgeMs) {
27
- return null;
28
- }
29
- return intent.href;
30
- }
31
- export {
32
- getAnchorFromNavigationEvent,
33
- recoverPendingNavigationHref
34
- };
@@ -1 +0,0 @@
1
- export {};
@@ -1,43 +0,0 @@
1
- import { describe, expect, it } from "vitest";
2
- import { getAnchorFromNavigationEvent, recoverPendingNavigationHref } from "./link-intent.js";
3
- describe("getAnchorFromNavigationEvent", () => {
4
- it("returns the anchor when the event target is a text node inside it", () => {
5
- const anchor = document.createElement("a");
6
- anchor.href = "/fast";
7
- anchor.setAttribute("data-eco-link", "true");
8
- const textNode = document.createTextNode("fast-link");
9
- anchor.append(textNode);
10
- document.body.append(anchor);
11
- const event = new MouseEvent("click", { bubbles: true, cancelable: true, composed: true });
12
- Object.defineProperty(event, "target", {
13
- configurable: true,
14
- value: textNode
15
- });
16
- expect(getAnchorFromNavigationEvent(event, "a[data-eco-link]")).toBe(anchor);
17
- });
18
- it("returns the closest matching anchor for nested element targets", () => {
19
- const anchor = document.createElement("a");
20
- anchor.href = "/fast";
21
- anchor.setAttribute("data-eco-link", "true");
22
- const span = document.createElement("span");
23
- span.textContent = "fast-link";
24
- anchor.append(span);
25
- document.body.append(anchor);
26
- const event = new MouseEvent("click", { bubbles: true, cancelable: true, composed: true });
27
- Object.defineProperty(event, "target", {
28
- configurable: true,
29
- value: span
30
- });
31
- expect(getAnchorFromNavigationEvent(event, "a[data-eco-link]")).toBe(anchor);
32
- });
33
- });
34
- describe("recoverPendingNavigationHref", () => {
35
- it("returns null for stale or missing pending intent state", () => {
36
- expect(recoverPendingNavigationHref(null, true, 10)).toBeNull();
37
- expect(recoverPendingNavigationHref({ href: "/fast", timestamp: 0 }, false, 10)).toBeNull();
38
- expect(recoverPendingNavigationHref({ href: "/fast", timestamp: 0 }, true, 2e3, 1e3)).toBeNull();
39
- });
40
- it("returns the captured href while a navigation is still in flight", () => {
41
- expect(recoverPendingNavigationHref({ href: "/fast", timestamp: 10 }, true, 20, 1e3)).toBe("/fast");
42
- });
43
- });
@@ -1,149 +0,0 @@
1
- /**
2
- * Shared browser-side navigation coordinator.
3
- *
4
- * This module is the client runtime contract used by browser-router,
5
- * react-router, and HMR code to coordinate ownership, cross-runtime handoff,
6
- * current-page reloads, and stale-navigation cancellation.
7
- *
8
- * The coordinator stays framework-agnostic: browser runtimes register their
9
- * capabilities here, and the coordinator arbitrates which runtime currently
10
- * owns the document and which navigation transaction is still current.
11
- *
12
- * @module
13
- */
14
- /** Logical owner name for a browser navigation runtime. */
15
- export type EcoNavigationOwner = 'none' | 'browser-router' | 'react-router' | (string & {});
16
- /** HTML attribute used to persist the rendered document owner across navigations. */
17
- export declare const ECO_DOCUMENT_OWNER_ATTRIBUTE = "data-eco-document-owner";
18
- /** High-level navigation direction understood by browser runtimes. */
19
- export type EcoNavigationDirection = 'forward' | 'back' | 'replace';
20
- /** Navigation request sent between browser runtimes. */
21
- export type EcoNavigationRequest = {
22
- href: string;
23
- direction?: EcoNavigationDirection;
24
- source?: EcoNavigationOwner;
25
- };
26
- /** Navigation handoff request that includes a pre-fetched document. */
27
- export type EcoNavigationHandoffRequest = EcoNavigationRequest & {
28
- finalHref?: string;
29
- targetOwner: EcoNavigationOwner;
30
- document: Document;
31
- html?: string;
32
- /**
33
- * Reports whether the source runtime's original navigation has already been
34
- * superseded.
35
- *
36
- * Target runtimes use this to ignore handoff work that arrives after a newer
37
- * navigation has already claimed ownership.
38
- */
39
- isStaleSourceNavigation?: () => boolean;
40
- };
41
- /** Request to reload the current page through the active runtime. */
42
- export type EcoReloadRequest = {
43
- clearCache?: boolean;
44
- source?: EcoNavigationOwner;
45
- };
46
- /** Snapshot of the coordinator's current runtime ownership state. */
47
- export type EcoNavigationOwnerState = {
48
- owner: EcoNavigationOwner;
49
- canHandleSpaNavigation: boolean;
50
- };
51
- /**
52
- * Coordinator-managed navigation transaction.
53
- *
54
- * Runtimes use this to determine whether async work has become stale and to
55
- * cancel or complete the active navigation sequence.
56
- */
57
- export type EcoNavigationTransaction = {
58
- id: number;
59
- signal: AbortSignal;
60
- isCurrent: () => boolean;
61
- cancel: () => void;
62
- complete: () => void;
63
- };
64
- export type EcoNavigationRuntimeEvent = {
65
- type: 'owner-change';
66
- owner: EcoNavigationOwner;
67
- previousOwner: EcoNavigationOwner;
68
- reason: 'set' | 'claim' | 'release' | 'document' | 'unregister';
69
- } | {
70
- type: 'registration-change';
71
- owner: EcoNavigationOwner;
72
- status: 'registered' | 'unregistered';
73
- };
74
- export type EcoNavigationRuntimeListener = (event: EcoNavigationRuntimeEvent) => void;
75
- export type EcoNavigationRuntimeRegistration = {
76
- owner: EcoNavigationOwner;
77
- navigate?: (request: EcoNavigationRequest) => Promise<boolean | void>;
78
- handoffNavigation?: (request: EcoNavigationHandoffRequest) => Promise<boolean | void>;
79
- reloadCurrentPage?: (request?: EcoReloadRequest) => Promise<void>;
80
- /**
81
- * Releases runtime-owned client state before another runtime commits a new
82
- * document.
83
- *
84
- * This hook intentionally does not run as part of `requestHandoff()`. The
85
- * accepting runtime decides when cleanup is safe so cross-runtime handoffs do
86
- * not blank the current page before the incoming document is ready.
87
- */
88
- cleanupBeforeHandoff?: () => void | Promise<void>;
89
- };
90
- /** Public browser-side navigation coordinator interface. */
91
- export interface EcoNavigationRuntime {
92
- /** Returns the currently active runtime owner and whether it can handle SPA navigation. */
93
- getOwnerState(): EcoNavigationOwnerState;
94
- /** Starts a new navigation transaction, invalidating the previously active one. */
95
- beginNavigationTransaction(): EcoNavigationTransaction;
96
- /** Reports whether a navigation transaction is still in flight. */
97
- hasPendingNavigationTransaction(): boolean;
98
- /** Cancels the active navigation transaction, if one exists. */
99
- cancelCurrentNavigationTransaction(): void;
100
- /** Forces the current owner value without checking registrations. */
101
- setOwner(owner: EcoNavigationOwner): void;
102
- /** Claims ownership for a runtime that is ready to drive SPA navigation. */
103
- claimOwnership(owner: EcoNavigationOwner): void;
104
- /** Releases ownership when the given runtime no longer controls the document. */
105
- releaseOwnership(owner: EcoNavigationOwner): void;
106
- /** Resolves document ownership from the rendered owner marker or fallback. */
107
- resolveDocumentOwner(doc: Document, fallbackOwner?: EcoNavigationOwner): EcoNavigationOwner;
108
- /** Reads and adopts the rendered document owner as the active runtime owner. */
109
- adoptDocumentOwner(doc: Document, fallbackOwner?: EcoNavigationOwner): EcoNavigationOwner;
110
- /** Returns whether the active owner is some runtime other than the given owner. */
111
- isOwnedByAnotherRuntime(owner: EcoNavigationOwner): boolean;
112
- /** Subscribes to ownership and registration change events. */
113
- subscribe(listener: EcoNavigationRuntimeListener): () => void;
114
- /** Registers a runtime implementation with the coordinator. */
115
- register(runtime: EcoNavigationRuntimeRegistration): () => void;
116
- /** Requests navigation through another eligible registered runtime. */
117
- requestNavigation(request: EcoNavigationRequest): Promise<boolean>;
118
- /**
119
- * Hands a pre-fetched document to the target runtime.
120
- *
121
- * The coordinator delegates the document but does not clean up the current
122
- * owner first. Cleanup timing belongs to the accepting runtime so a stale or
123
- * superseded handoff cannot tear down the current page prematurely.
124
- */
125
- requestHandoff(request: EcoNavigationHandoffRequest): Promise<boolean>;
126
- /** Requests the active runtime to reload the current page. */
127
- reloadCurrentPage(request?: EcoReloadRequest): Promise<boolean>;
128
- /** Runs a target runtime's cleanup hook before handoff. */
129
- cleanupOwner(owner: EcoNavigationOwner): Promise<void>;
130
- /** Runs cleanup for whichever runtime currently owns the document. */
131
- cleanupCurrentOwner(): Promise<void>;
132
- }
133
- /**
134
- * Reads the explicit browser document owner marker from a rendered HTML document.
135
- *
136
- * Documents without a marker return `null`, allowing runtimes to fall back to
137
- * their local default behavior without scanning hydration scripts.
138
- */
139
- export declare function getEcoDocumentOwner(doc: Document): EcoNavigationOwner | null;
140
- /**
141
- * Returns the singleton browser-side navigation coordinator.
142
- *
143
- * The coordinator centralizes ownership, handoff, and current-page reload
144
- * requests across browser runtimes through one internal protocol.
145
- *
146
- * @param windowObject - Window-like object that stores the singleton runtime.
147
- * @returns The shared browser navigation coordinator.
148
- */
149
- export declare function getEcoNavigationRuntime(windowObject?: Window & typeof globalThis): EcoNavigationRuntime;
@@ -1,215 +0,0 @@
1
- const ECO_DOCUMENT_OWNER_ATTRIBUTE = "data-eco-document-owner";
2
- function getEcoDocumentOwner(doc) {
3
- const owner = doc.documentElement.getAttribute(ECO_DOCUMENT_OWNER_ATTRIBUTE);
4
- return owner && owner.length > 0 ? owner : null;
5
- }
6
- function getCandidateOwners(currentOwner, registrations, excludedOwner) {
7
- const owners = [];
8
- if (currentOwner !== "none" && currentOwner !== excludedOwner) {
9
- owners.push(currentOwner);
10
- }
11
- for (const owner of registrations.keys()) {
12
- if (owner === currentOwner || owner === excludedOwner) {
13
- continue;
14
- }
15
- owners.push(owner);
16
- }
17
- return owners;
18
- }
19
- function createEcoNavigationRuntime() {
20
- const registrations = /* @__PURE__ */ new Map();
21
- const listeners = /* @__PURE__ */ new Set();
22
- let owner = "none";
23
- let navigationSequence = 0;
24
- let navigationAbortController = null;
25
- const emit = (event) => {
26
- for (const listener of listeners) {
27
- listener(event);
28
- }
29
- };
30
- const updateOwner = (nextOwner, reason) => {
31
- if (owner === nextOwner) {
32
- return;
33
- }
34
- const previousOwner = owner;
35
- owner = nextOwner;
36
- emit({
37
- type: "owner-change",
38
- owner: nextOwner,
39
- previousOwner,
40
- reason
41
- });
42
- };
43
- const cancelNavigationTransaction = (navigationId, abortController) => {
44
- if (navigationSequence !== navigationId || navigationAbortController !== abortController) {
45
- return;
46
- }
47
- navigationSequence += 1;
48
- navigationAbortController = null;
49
- abortController.abort();
50
- };
51
- const completeNavigationTransaction = (navigationId, abortController) => {
52
- if (navigationSequence !== navigationId || navigationAbortController !== abortController) {
53
- return;
54
- }
55
- navigationAbortController = null;
56
- };
57
- const runtime = {
58
- getOwnerState() {
59
- const activeRuntime = registrations.get(owner);
60
- return {
61
- owner,
62
- canHandleSpaNavigation: typeof activeRuntime?.navigate === "function"
63
- };
64
- },
65
- hasPendingNavigationTransaction() {
66
- return navigationAbortController !== null;
67
- },
68
- beginNavigationTransaction() {
69
- navigationAbortController?.abort();
70
- const abortController = new AbortController();
71
- const navigationId = ++navigationSequence;
72
- navigationAbortController = abortController;
73
- return {
74
- id: navigationId,
75
- signal: abortController.signal,
76
- isCurrent: () => navigationSequence === navigationId && navigationAbortController === abortController,
77
- cancel: () => {
78
- cancelNavigationTransaction(navigationId, abortController);
79
- },
80
- complete: () => {
81
- completeNavigationTransaction(navigationId, abortController);
82
- }
83
- };
84
- },
85
- cancelCurrentNavigationTransaction() {
86
- if (!navigationAbortController) {
87
- return;
88
- }
89
- cancelNavigationTransaction(navigationSequence, navigationAbortController);
90
- },
91
- setOwner(nextOwner) {
92
- updateOwner(nextOwner, "set");
93
- },
94
- claimOwnership(nextOwner) {
95
- updateOwner(nextOwner, "claim");
96
- },
97
- releaseOwnership(currentOwner) {
98
- if (owner !== currentOwner) {
99
- return;
100
- }
101
- updateOwner("none", "release");
102
- },
103
- resolveDocumentOwner(doc, fallbackOwner = "none") {
104
- return getEcoDocumentOwner(doc) ?? fallbackOwner;
105
- },
106
- adoptDocumentOwner(doc, fallbackOwner = "none") {
107
- const nextOwner = runtime.resolveDocumentOwner(doc, fallbackOwner);
108
- updateOwner(nextOwner, "document");
109
- return nextOwner;
110
- },
111
- isOwnedByAnotherRuntime(candidateOwner) {
112
- return owner !== "none" && owner !== candidateOwner;
113
- },
114
- subscribe(listener) {
115
- listeners.add(listener);
116
- return () => {
117
- listeners.delete(listener);
118
- };
119
- },
120
- register(registration) {
121
- registrations.set(registration.owner, registration);
122
- emit({
123
- type: "registration-change",
124
- owner: registration.owner,
125
- status: "registered"
126
- });
127
- return () => {
128
- const currentRegistration = registrations.get(registration.owner);
129
- if (currentRegistration !== registration) {
130
- return;
131
- }
132
- registrations.delete(registration.owner);
133
- emit({
134
- type: "registration-change",
135
- owner: registration.owner,
136
- status: "unregistered"
137
- });
138
- if (owner === registration.owner) {
139
- updateOwner("none", "unregister");
140
- }
141
- };
142
- },
143
- async requestNavigation(request) {
144
- for (const candidateOwner of getCandidateOwners(owner, registrations, request.source)) {
145
- const registration = registrations.get(candidateOwner);
146
- if (!registration?.navigate) {
147
- continue;
148
- }
149
- const handled = await registration.navigate(request);
150
- if (handled !== false) {
151
- return true;
152
- }
153
- }
154
- return false;
155
- },
156
- async requestHandoff(request) {
157
- if (request.targetOwner === "none") {
158
- return false;
159
- }
160
- if (request.isStaleSourceNavigation?.()) {
161
- return true;
162
- }
163
- const registration = registrations.get(request.targetOwner);
164
- if (!registration?.handoffNavigation) {
165
- return false;
166
- }
167
- if (request.isStaleSourceNavigation?.()) {
168
- return true;
169
- }
170
- const handled = await registration.handoffNavigation(request);
171
- return handled !== false;
172
- },
173
- async reloadCurrentPage(request) {
174
- for (const candidateOwner of getCandidateOwners(owner, registrations)) {
175
- const registration = registrations.get(candidateOwner);
176
- if (!registration?.reloadCurrentPage) {
177
- continue;
178
- }
179
- await registration.reloadCurrentPage(request);
180
- return true;
181
- }
182
- return false;
183
- },
184
- async cleanupOwner(targetOwner) {
185
- if (targetOwner === "none") {
186
- return;
187
- }
188
- const registration = registrations.get(targetOwner);
189
- if (!registration?.cleanupBeforeHandoff) {
190
- return;
191
- }
192
- await registration.cleanupBeforeHandoff();
193
- if (owner === targetOwner) {
194
- updateOwner("none", "release");
195
- }
196
- },
197
- async cleanupCurrentOwner() {
198
- await runtime.cleanupOwner(owner);
199
- }
200
- };
201
- return runtime;
202
- }
203
- function getEcoNavigationRuntime(windowObject = window) {
204
- const runtimeWindow = windowObject;
205
- runtimeWindow.__ECO_PAGES__ = runtimeWindow.__ECO_PAGES__ || {};
206
- if (!runtimeWindow.__ECO_PAGES__.navigation) {
207
- runtimeWindow.__ECO_PAGES__.navigation = createEcoNavigationRuntime();
208
- }
209
- return runtimeWindow.__ECO_PAGES__.navigation;
210
- }
211
- export {
212
- ECO_DOCUMENT_OWNER_ATTRIBUTE,
213
- getEcoDocumentOwner,
214
- getEcoNavigationRuntime
215
- };
@@ -1,41 +0,0 @@
1
- import type { EcoPagesAppConfig, Routes } from '../../types/internal-types.js';
2
- type FSRouterScannerOptions = {
3
- buildMode: boolean;
4
- };
5
- /**
6
- * @class FSRouterScanner
7
- * @description
8
- * This class is responsible for scanning the file system for routes.
9
- * It uses the glob package to scan the file system for files with the specified file extensions.
10
- * It then creates a map of the routes with the pathname as the key.
11
- * The pathname is the route without the file extension.
12
- * For example, if the file is "index.tsx", the pathname will be "/index".
13
- * If the file is "blog/[slug].tsx", the pathname will be "/blog/[slug]".
14
- * If the file is "blog/[...slug].tsx", the pathname will be "/blog/[...slug]".
15
- */
16
- export declare class FSRouterScanner {
17
- private dir;
18
- private origin;
19
- private templatesExt;
20
- private options;
21
- readonly appConfig: EcoPagesAppConfig;
22
- routes: Routes;
23
- private serverModuleTranspiler;
24
- constructor({ dir, origin, templatesExt, options, appConfig, }: {
25
- dir: string;
26
- origin: string;
27
- templatesExt: string[];
28
- options: FSRouterScannerOptions;
29
- appConfig: EcoPagesAppConfig;
30
- });
31
- private getRoutePath;
32
- private getDynamicParamsNames;
33
- private getStaticPathsFromDynamicRoute;
34
- private createStaticRoutes;
35
- private handleDynamicRouteCreation;
36
- private importPageModule;
37
- private createRoute;
38
- private getRouteData;
39
- scan(): Promise<Routes>;
40
- }
41
- export {};