@ecopages/core 0.2.0-alpha.1 → 0.2.0-alpha.10

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 (323) hide show
  1. package/CHANGELOG.md +13 -70
  2. package/README.md +213 -12
  3. package/package.json +50 -18
  4. package/src/adapters/README.md +39 -0
  5. package/src/adapters/bun/hmr-manager.d.ts +77 -18
  6. package/src/adapters/bun/hmr-manager.js +159 -52
  7. package/src/adapters/bun/index.d.ts +1 -2
  8. package/src/adapters/bun/index.js +1 -1
  9. package/src/adapters/bun/server-adapter.js +35 -30
  10. package/src/adapters/bun/server-lifecycle.d.ts +24 -13
  11. package/src/adapters/bun/server-lifecycle.js +32 -60
  12. package/src/adapters/index.d.ts +1 -1
  13. package/src/adapters/index.js +1 -1
  14. package/src/adapters/node/bootstrap-dependency-resolver.d.ts +44 -0
  15. package/src/adapters/node/bootstrap-dependency-resolver.js +172 -0
  16. package/src/adapters/node/index.d.ts +2 -0
  17. package/src/adapters/node/index.js +3 -0
  18. package/src/adapters/node/node-hmr-manager.d.ts +87 -16
  19. package/src/adapters/node/node-hmr-manager.js +179 -88
  20. package/src/adapters/node/runtime-adapter.d.ts +46 -0
  21. package/src/adapters/node/runtime-adapter.js +306 -0
  22. package/src/adapters/node/server-adapter.d.ts +2 -31
  23. package/src/adapters/node/server-adapter.js +31 -93
  24. package/src/adapters/node/static-content-server.d.ts +36 -0
  25. package/src/adapters/node/static-content-server.js +28 -0
  26. package/src/adapters/node/write-runtime-manifest.d.ts +26 -0
  27. package/src/adapters/node/write-runtime-manifest.js +12 -0
  28. package/src/{define-api-handler.d.ts → adapters/shared/define-api-handler.d.ts} +1 -1
  29. package/src/adapters/shared/explicit-static-route-matcher.js +4 -1
  30. package/src/adapters/shared/file-route-middleware-pipeline.js +1 -0
  31. package/src/adapters/shared/fs-server-response-matcher.d.ts +9 -5
  32. package/src/adapters/shared/fs-server-response-matcher.js +13 -8
  33. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  34. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  35. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  36. package/src/adapters/shared/hmr-html-response.js +32 -0
  37. package/src/adapters/shared/render-context.js +3 -2
  38. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  39. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  40. package/src/adapters/shared/server-adapter.d.ts +12 -2
  41. package/src/adapters/shared/server-adapter.js +37 -4
  42. package/src/adapters/shared/server-route-handler.d.ts +1 -1
  43. package/src/adapters/shared/server-route-handler.js +4 -13
  44. package/src/adapters/shared/server-static-builder.d.ts +35 -3
  45. package/src/adapters/shared/server-static-builder.js +59 -6
  46. package/src/build/README.md +101 -0
  47. package/src/build/build-adapter.d.ts +114 -2
  48. package/src/build/build-adapter.js +119 -5
  49. package/src/build/build-manifest.d.ts +27 -0
  50. package/src/build/build-manifest.js +30 -0
  51. package/src/build/dev-build-coordinator.d.ts +74 -0
  52. package/src/build/dev-build-coordinator.js +161 -0
  53. package/src/build/esbuild-build-adapter.d.ts +9 -6
  54. package/src/build/esbuild-build-adapter.js +103 -71
  55. package/src/build/runtime-build-executor.d.ts +13 -0
  56. package/src/build/runtime-build-executor.js +20 -0
  57. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  58. package/src/build/runtime-specifier-alias-plugin.js +31 -0
  59. package/src/config/README.md +33 -0
  60. package/src/config/config-builder.d.ts +28 -17
  61. package/src/config/config-builder.js +221 -48
  62. package/src/constants.d.ts +13 -0
  63. package/src/constants.js +4 -0
  64. package/src/declarations.d.ts +18 -13
  65. package/src/eco/README.md +70 -16
  66. package/src/eco/component-render-context.d.ts +1 -1
  67. package/src/eco/component-render-context.js +26 -16
  68. package/src/eco/eco.js +16 -12
  69. package/src/eco/eco.types.d.ts +12 -4
  70. package/src/hmr/README.md +26 -0
  71. package/src/hmr/client/hmr-runtime.d.ts +1 -6
  72. package/src/hmr/client/hmr-runtime.js +30 -7
  73. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  74. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  75. package/src/hmr/hmr.test.e2e.js +26 -33
  76. package/src/hmr/strategies/js-hmr-strategy.d.ts +45 -42
  77. package/src/hmr/strategies/js-hmr-strategy.js +70 -71
  78. package/src/index.d.ts +1 -1
  79. package/src/index.js +1 -1
  80. package/src/integrations/ghtml/ghtml-renderer.d.ts +1 -1
  81. package/src/integrations/ghtml/ghtml-renderer.js +3 -1
  82. package/src/internal-types.d.ts +39 -18
  83. package/src/plugins/README.md +34 -0
  84. package/src/plugins/alias-resolver-plugin.js +17 -3
  85. package/src/plugins/eco-component-meta-plugin.d.ts +2 -0
  86. package/src/plugins/eco-component-meta-plugin.js +1 -1
  87. package/src/plugins/integration-plugin.d.ts +38 -4
  88. package/src/plugins/integration-plugin.js +34 -1
  89. package/src/plugins/processor.d.ts +14 -1
  90. package/src/plugins/processor.js +15 -1
  91. package/src/plugins/runtime-capability.d.ts +9 -0
  92. package/src/public-types.d.ts +65 -10
  93. package/src/route-renderer/GRAPH.md +16 -20
  94. package/src/route-renderer/README.md +8 -21
  95. package/src/route-renderer/component-graph/component-reference.d.ts +10 -0
  96. package/src/route-renderer/component-graph/component-reference.js +19 -0
  97. package/src/route-renderer/{marker-graph-resolver.d.ts → component-graph/marker-graph-resolver.d.ts} +6 -5
  98. package/src/route-renderer/{marker-graph-resolver.js → component-graph/marker-graph-resolver.js} +10 -8
  99. package/src/route-renderer/{integration-renderer.d.ts → orchestration/integration-renderer.d.ts} +45 -12
  100. package/src/route-renderer/{integration-renderer.js → orchestration/integration-renderer.js} +79 -16
  101. package/src/route-renderer/{render-execution.service.d.ts → orchestration/render-execution.service.d.ts} +39 -5
  102. package/src/route-renderer/{render-execution.service.js → orchestration/render-execution.service.js} +58 -28
  103. package/src/route-renderer/{render-preparation.service.d.ts → orchestration/render-preparation.service.d.ts} +13 -4
  104. package/src/route-renderer/{render-preparation.service.js → orchestration/render-preparation.service.js} +92 -3
  105. package/src/route-renderer/{dependency-resolver.d.ts → page-loading/dependency-resolver.d.ts} +15 -4
  106. package/src/route-renderer/{dependency-resolver.js → page-loading/dependency-resolver.js} +18 -4
  107. package/src/route-renderer/page-loading/page-module-loader.d.ts +87 -0
  108. package/src/route-renderer/{page-module-loader.js → page-loading/page-module-loader.js} +36 -14
  109. package/src/route-renderer/route-renderer.d.ts +36 -1
  110. package/src/route-renderer/route-renderer.js +19 -0
  111. package/src/router/README.md +26 -0
  112. package/src/router/client/link-intent.d.ts +53 -0
  113. package/src/router/client/link-intent.js +34 -0
  114. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  115. package/src/router/client/link-intent.test.browser.js +43 -0
  116. package/src/router/client/navigation-coordinator.d.ts +149 -0
  117. package/src/router/client/navigation-coordinator.js +215 -0
  118. package/src/router/{fs-router-scanner.d.ts → server/fs-router-scanner.d.ts} +3 -3
  119. package/src/router/{fs-router-scanner.js → server/fs-router-scanner.js} +8 -7
  120. package/src/router/{fs-router.d.ts → server/fs-router.d.ts} +1 -1
  121. package/src/router/{fs-router.js → server/fs-router.js} +1 -1
  122. package/src/services/README.md +29 -0
  123. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +120 -0
  124. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset-processing.service.js +88 -7
  125. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.js +2 -2
  126. package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.d.ts +2 -1
  127. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  128. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  129. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +48 -0
  130. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  131. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  132. package/src/services/{asset-processing-service → assets/asset-processing-service}/index.d.ts +2 -0
  133. package/src/services/{asset-processing-service → assets/asset-processing-service}/index.js +2 -0
  134. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.d.ts +1 -1
  135. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.d.ts +1 -1
  136. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.js +9 -4
  137. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-script-processor.d.ts +3 -2
  138. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-script-processor.js +14 -22
  139. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.d.ts +1 -1
  140. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.js +2 -2
  141. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.js +5 -4
  142. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.js +4 -1
  143. package/src/services/assets/browser-bundle.service.d.ts +32 -0
  144. package/src/services/assets/browser-bundle.service.js +33 -0
  145. package/src/services/{page-request-cache-coordinator.service.d.ts → cache/page-request-cache-coordinator.service.d.ts} +2 -2
  146. package/src/services/{page-request-cache-coordinator.service.js → cache/page-request-cache-coordinator.service.js} +3 -1
  147. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  148. package/src/services/html/html-rewriter-provider.service.js +65 -0
  149. package/src/services/html/html-transformer.service.d.ts +77 -0
  150. package/src/services/html/html-transformer.service.js +221 -0
  151. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  152. package/src/services/invalidation/development-invalidation.service.js +189 -0
  153. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +16 -0
  154. package/src/services/module-loading/app-server-module-transpiler.service.js +34 -0
  155. package/src/services/module-loading/page-module-import.service.d.ts +71 -0
  156. package/src/services/module-loading/page-module-import.service.js +132 -0
  157. package/src/services/module-loading/server-loader.service.d.ts +96 -0
  158. package/src/services/module-loading/server-loader.service.js +32 -0
  159. package/src/services/module-loading/server-module-transpiler.service.d.ts +69 -0
  160. package/src/services/module-loading/server-module-transpiler.service.js +61 -0
  161. package/src/services/runtime-manifest/node-runtime-manifest.service.d.ts +35 -0
  162. package/src/services/runtime-manifest/node-runtime-manifest.service.js +60 -0
  163. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  164. package/src/services/runtime-state/dev-graph.service.js +162 -0
  165. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  166. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  167. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +69 -0
  168. package/src/services/runtime-state/runtime-specifier-registry.service.js +37 -0
  169. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  170. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  171. package/src/services/{schema-validation-service.d.ts → validation/schema-validation-service.d.ts} +1 -1
  172. package/src/static-site-generator/README.md +26 -0
  173. package/src/static-site-generator/static-site-generator.d.ts +53 -1
  174. package/src/static-site-generator/static-site-generator.js +86 -5
  175. package/src/utils/resolve-work-dir.d.ts +11 -0
  176. package/src/utils/resolve-work-dir.js +31 -0
  177. package/src/watchers/project-watcher.d.ts +37 -21
  178. package/src/watchers/project-watcher.js +109 -66
  179. package/src/watchers/project-watcher.test-helpers.js +1 -0
  180. package/src/adapters/abstract/application-adapter.ts +0 -337
  181. package/src/adapters/abstract/router-adapter.ts +0 -30
  182. package/src/adapters/abstract/server-adapter.ts +0 -79
  183. package/src/adapters/bun/client-bridge.ts +0 -62
  184. package/src/adapters/bun/create-app.ts +0 -189
  185. package/src/adapters/bun/define-api-handler.d.ts +0 -61
  186. package/src/adapters/bun/define-api-handler.ts +0 -114
  187. package/src/adapters/bun/hmr-manager.ts +0 -281
  188. package/src/adapters/bun/index.ts +0 -3
  189. package/src/adapters/bun/server-adapter.ts +0 -492
  190. package/src/adapters/bun/server-lifecycle.ts +0 -154
  191. package/src/adapters/index.ts +0 -6
  192. package/src/adapters/node/create-app.ts +0 -179
  193. package/src/adapters/node/index.ts +0 -9
  194. package/src/adapters/node/node-client-bridge.ts +0 -79
  195. package/src/adapters/node/node-hmr-manager.ts +0 -271
  196. package/src/adapters/node/server-adapter.ts +0 -561
  197. package/src/adapters/node/static-content-server.ts +0 -203
  198. package/src/adapters/shared/api-response.ts +0 -104
  199. package/src/adapters/shared/application-adapter.ts +0 -199
  200. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -134
  201. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -123
  202. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  203. package/src/adapters/shared/fs-server-response-matcher.ts +0 -198
  204. package/src/adapters/shared/render-context.ts +0 -105
  205. package/src/adapters/shared/server-adapter.ts +0 -442
  206. package/src/adapters/shared/server-route-handler.ts +0 -166
  207. package/src/adapters/shared/server-static-builder.ts +0 -82
  208. package/src/build/build-adapter.ts +0 -132
  209. package/src/build/build-types.ts +0 -83
  210. package/src/build/esbuild-build-adapter.ts +0 -510
  211. package/src/config/config-builder.ts +0 -474
  212. package/src/constants.ts +0 -39
  213. package/src/create-app.ts +0 -87
  214. package/src/define-api-handler.js +0 -15
  215. package/src/define-api-handler.ts +0 -66
  216. package/src/dev/sc-server.ts +0 -143
  217. package/src/eco/component-render-context.ts +0 -202
  218. package/src/eco/eco.ts +0 -221
  219. package/src/eco/eco.types.ts +0 -202
  220. package/src/eco/eco.utils.ts +0 -89
  221. package/src/eco/global-injector-map.ts +0 -112
  222. package/src/eco/lazy-injector-map.ts +0 -120
  223. package/src/eco/module-dependencies.ts +0 -75
  224. package/src/errors/http-error.ts +0 -72
  225. package/src/errors/index.ts +0 -2
  226. package/src/errors/locals-access-error.ts +0 -7
  227. package/src/global/app-logger.ts +0 -4
  228. 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
  229. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  230. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  231. package/src/hmr/client/hmr-runtime.ts +0 -121
  232. package/src/hmr/hmr-strategy.ts +0 -172
  233. package/src/hmr/hmr.test.e2e.ts +0 -75
  234. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  235. package/src/hmr/strategies/js-hmr-strategy.ts +0 -308
  236. package/src/index.browser.ts +0 -3
  237. package/src/index.ts +0 -5
  238. package/src/integrations/ghtml/ghtml-renderer.ts +0 -93
  239. package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
  240. package/src/internal-types.ts +0 -212
  241. package/src/plugins/alias-resolver-plugin.ts +0 -45
  242. package/src/plugins/eco-component-meta-plugin.ts +0 -474
  243. package/src/plugins/integration-plugin.ts +0 -184
  244. package/src/plugins/processor.ts +0 -220
  245. package/src/public-types.ts +0 -1255
  246. package/src/route-renderer/component-graph-executor.ts +0 -84
  247. package/src/route-renderer/component-graph.ts +0 -159
  248. package/src/route-renderer/component-marker.ts +0 -117
  249. package/src/route-renderer/dependency-resolver.ts +0 -596
  250. package/src/route-renderer/html-post-processing.service.d.ts +0 -40
  251. package/src/route-renderer/html-post-processing.service.js +0 -86
  252. package/src/route-renderer/html-post-processing.service.ts +0 -103
  253. package/src/route-renderer/integration-renderer.ts +0 -696
  254. package/src/route-renderer/marker-graph-resolver.ts +0 -153
  255. package/src/route-renderer/page-module-loader.d.ts +0 -61
  256. package/src/route-renderer/page-module-loader.ts +0 -153
  257. package/src/route-renderer/render-execution.service.ts +0 -158
  258. package/src/route-renderer/render-preparation.service.ts +0 -358
  259. package/src/route-renderer/route-renderer.ts +0 -80
  260. package/src/router/fs-router-scanner.ts +0 -217
  261. package/src/router/fs-router.ts +0 -122
  262. package/src/services/asset-processing-service/asset-processing.service.d.ts +0 -41
  263. package/src/services/asset-processing-service/asset-processing.service.ts +0 -306
  264. package/src/services/asset-processing-service/asset.factory.ts +0 -105
  265. package/src/services/asset-processing-service/assets.types.ts +0 -112
  266. package/src/services/asset-processing-service/index.ts +0 -3
  267. package/src/services/asset-processing-service/processor.interface.ts +0 -27
  268. package/src/services/asset-processing-service/processor.registry.ts +0 -18
  269. package/src/services/asset-processing-service/processors/base/base-processor.ts +0 -76
  270. package/src/services/asset-processing-service/processors/base/base-script-processor.ts +0 -105
  271. package/src/services/asset-processing-service/processors/index.ts +0 -5
  272. package/src/services/asset-processing-service/processors/script/content-script.processor.ts +0 -66
  273. package/src/services/asset-processing-service/processors/script/file-script.processor.ts +0 -88
  274. package/src/services/asset-processing-service/processors/script/node-module-script.processor.ts +0 -84
  275. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
  276. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -77
  277. package/src/services/cache/cache.types.ts +0 -126
  278. package/src/services/cache/index.ts +0 -18
  279. package/src/services/cache/memory-cache-store.ts +0 -130
  280. package/src/services/cache/page-cache-service.ts +0 -202
  281. package/src/services/html-transformer.service.d.ts +0 -50
  282. package/src/services/html-transformer.service.js +0 -163
  283. package/src/services/html-transformer.service.ts +0 -217
  284. package/src/services/page-module-import.service.d.ts +0 -37
  285. package/src/services/page-module-import.service.js +0 -88
  286. package/src/services/page-module-import.service.ts +0 -129
  287. package/src/services/page-request-cache-coordinator.service.ts +0 -128
  288. package/src/services/schema-validation-service.ts +0 -204
  289. package/src/services/validation/standard-schema.types.ts +0 -68
  290. package/src/static-site-generator/static-site-generator.ts +0 -359
  291. package/src/utils/css.ts +0 -5
  292. package/src/utils/deep-merge.ts +0 -47
  293. package/src/utils/hash.ts +0 -5
  294. package/src/utils/html.ts +0 -1
  295. package/src/utils/invariant.ts +0 -15
  296. package/src/utils/locals-utils.ts +0 -37
  297. package/src/utils/parse-cli-args.ts +0 -83
  298. package/src/utils/path-utils.module.ts +0 -14
  299. package/src/utils/runtime.ts +0 -44
  300. package/src/utils/server-utils.module.ts +0 -67
  301. package/src/watchers/project-watcher.test-helpers.ts +0 -40
  302. package/src/watchers/project-watcher.ts +0 -306
  303. /package/src/adapters/{bun → shared}/define-api-handler.js +0 -0
  304. /package/src/{services/asset-processing-service/assets.types.js → plugins/runtime-capability.js} +0 -0
  305. /package/src/route-renderer/{component-graph-executor.d.ts → component-graph/component-graph-executor.d.ts} +0 -0
  306. /package/src/route-renderer/{component-graph-executor.js → component-graph/component-graph-executor.js} +0 -0
  307. /package/src/route-renderer/{component-graph.d.ts → component-graph/component-graph.d.ts} +0 -0
  308. /package/src/route-renderer/{component-graph.js → component-graph/component-graph.js} +0 -0
  309. /package/src/route-renderer/{component-marker.d.ts → component-graph/component-marker.d.ts} +0 -0
  310. /package/src/route-renderer/{component-marker.js → component-graph/component-marker.js} +0 -0
  311. /package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.d.ts +0 -0
  312. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.js +0 -0
  313. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.d.ts +0 -0
  314. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.js +0 -0
  315. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/index.d.ts +0 -0
  316. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/index.js +0 -0
  317. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.d.ts +0 -0
  318. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.js +0 -0
  319. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.d.ts +0 -0
  320. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.d.ts +0 -0
  321. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.js +0 -0
  322. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.d.ts +0 -0
  323. /package/src/services/{schema-validation-service.js → validation/schema-validation-service.js} +0 -0
@@ -1,122 +0,0 @@
1
- import { appLogger } from '../global/app-logger.ts';
2
- import type { MatchResult, Route, Routes } from '../internal-types.ts';
3
- import type { FSRouterScanner } from './fs-router-scanner.ts';
4
-
5
- /**
6
- * A class that manages the routes of the file system.
7
- * It scans the file system for files with the specified extensions and creates a map of routes.
8
- * It also provides a method to match a request to a route.
9
- * It can be used to reload the routes when the file system changes.
10
- */
11
- export class FSRouter {
12
- origin: string;
13
- assetPrefix: string;
14
- routes: Routes = {};
15
- scanner: FSRouterScanner;
16
- onReload?: () => void;
17
-
18
- constructor({ origin, assetPrefix, scanner }: { origin: string; assetPrefix: string; scanner: FSRouterScanner }) {
19
- this.origin = origin;
20
- this.assetPrefix = assetPrefix;
21
- this.scanner = scanner;
22
- }
23
-
24
- async init() {
25
- this.routes = await this.scanner.scan();
26
- appLogger.debug('FSRouter initialized', this.routes);
27
- }
28
-
29
- getDynamicParams(route: Route, pathname: string): Record<string, string | string[]> {
30
- const params: Record<string, string | string[]> = {};
31
- const routeParts = route.pathname.split('/');
32
- const pathnameParts = pathname.split('/');
33
-
34
- for (let i = 0; i < routeParts.length; i++) {
35
- const part = routeParts[i];
36
- if (part.startsWith('[') && part.endsWith(']')) {
37
- if (part.startsWith('[...')) {
38
- const param = part.slice(4, -1);
39
- params[param] = pathnameParts.slice(i);
40
- break;
41
- }
42
- const param = part.slice(1, -1);
43
- params[param] = pathnameParts[i];
44
- }
45
- }
46
- return params;
47
- }
48
-
49
- getSearchParams(url: URL): Record<string, string> {
50
- const query: Record<string, string> = {};
51
- for (const [key, value] of url.searchParams) {
52
- query[key] = value;
53
- }
54
- return query;
55
- }
56
-
57
- match(requestUrl: string): MatchResult | null {
58
- const url = new URL(requestUrl);
59
- const pathname = url.pathname.replace(this.origin, '');
60
-
61
- const routeValues = Object.values(this.routes);
62
-
63
- for (const route of routeValues) {
64
- if (route.kind === 'exact' && (pathname === route.pathname || pathname === `${route.pathname}/`)) {
65
- return {
66
- filePath: route.filePath,
67
- kind: 'exact',
68
- pathname: route.pathname,
69
- query: this.getSearchParams(url),
70
- };
71
- }
72
- }
73
-
74
- for (const route of routeValues) {
75
- const cleanPathname = route.pathname.replace(/\[.*?\]/g, '');
76
- const isValidDynamicRoute = pathname.includes(cleanPathname);
77
-
78
- if (route.kind === 'dynamic' && isValidDynamicRoute) {
79
- const routeParts = route.pathname.split('/');
80
- const pathnameParts = pathname.split('/');
81
-
82
- if (routeParts.length === pathnameParts.length) {
83
- return {
84
- filePath: route.filePath,
85
- kind: 'dynamic',
86
- pathname: pathname,
87
- query: this.getSearchParams(url),
88
- params: this.getDynamicParams(route, pathname),
89
- };
90
- }
91
- }
92
- }
93
-
94
- for (const route of routeValues) {
95
- const cleanPathname = route.pathname.replace(/\[.*?\]/g, '');
96
- const isValidCatchAllRoute = pathname.includes(cleanPathname);
97
-
98
- if (route.kind === 'catch-all' && isValidCatchAllRoute) {
99
- return {
100
- filePath: route.filePath,
101
- kind: 'catch-all',
102
- pathname: pathname,
103
- query: this.getSearchParams(url),
104
- params: this.getDynamicParams(route, pathname),
105
- };
106
- }
107
- }
108
-
109
- return null;
110
- }
111
-
112
- setOnReload(cb: () => void) {
113
- this.onReload = cb;
114
- }
115
-
116
- reload() {
117
- this.init();
118
- if (this.onReload) {
119
- this.onReload();
120
- }
121
- }
122
- }
@@ -1,41 +0,0 @@
1
- import type { EcoPagesAppConfig, IHmrManager } from '../../internal-types';
2
- import type { AssetDefinition, AssetKind, AssetSource, ProcessedAsset } from './assets.types';
3
- import { ProcessorRegistry } from './processor.registry';
4
- export declare class AssetProcessingService {
5
- private readonly config;
6
- static readonly RESOLVED_ASSETS_DIR = "assets";
7
- private registry;
8
- private hmrManager?;
9
- private cache;
10
- constructor(config: EcoPagesAppConfig);
11
- /**
12
- * Set the HMR manager for the asset processing service.
13
- * @param hmrManager The HMR manager to set.
14
- */
15
- setHmrManager(hmrManager: IHmrManager): void;
16
- getHmrManager(): IHmrManager | undefined;
17
- /**
18
- * Register a processor for a specific asset kind and source.
19
- * @param kind The asset kind.
20
- * @param variant The asset source.
21
- * @param processor The processor to register.
22
- */
23
- registerProcessor(kind: AssetKind, variant: AssetSource, processor: any): void;
24
- processDependencies(deps: AssetDefinition[], key: string): Promise<ProcessedAsset[]>;
25
- private deduplicateDependencies;
26
- private getScriptDependencyBuildSignature;
27
- private getDependencyKey;
28
- private generateHash;
29
- private processDependenciesParallel;
30
- private groupDependenciesByType;
31
- private getSrcUrl;
32
- private resolveProcessedAssetSrcUrl;
33
- private isFilesystemPath;
34
- private optimizeDependencies;
35
- private getCachedAsset;
36
- private setCachedAsset;
37
- clearCache(): void;
38
- invalidateCacheForFile(filepath: string): void;
39
- static createWithDefaultProcessors(appConfig: EcoPagesAppConfig): AssetProcessingService;
40
- getRegistry(): ProcessorRegistry;
41
- }
@@ -1,306 +0,0 @@
1
- import path from 'node:path';
2
- import { RESOLVED_ASSETS_DIR } from '../../constants';
3
- import { appLogger } from '../../global/app-logger';
4
- import type { EcoPagesAppConfig, IHmrManager } from '../../internal-types';
5
- import { rapidhash } from '../../utils/hash';
6
- import { fileSystem } from '@ecopages/file-system';
7
- import type { AssetDefinition, AssetKind, AssetSource, ProcessedAsset } from './assets.types';
8
- import { isHmrAware } from './processor.interface';
9
- import { ProcessorRegistry } from './processor.registry';
10
- import {
11
- ContentScriptProcessor,
12
- ContentStylesheetProcessor,
13
- FileScriptProcessor,
14
- FileStylesheetProcessor,
15
- NodeModuleScriptProcessor,
16
- } from './processors';
17
-
18
- export class AssetProcessingService {
19
- static readonly RESOLVED_ASSETS_DIR = RESOLVED_ASSETS_DIR;
20
- private registry = new ProcessorRegistry();
21
- private hmrManager?: IHmrManager;
22
- private cache = new Map<string, { asset: ProcessedAsset }>();
23
-
24
- constructor(private readonly config: EcoPagesAppConfig) {}
25
-
26
- /**
27
- * Set the HMR manager for the asset processing service.
28
- * @param hmrManager The HMR manager to set.
29
- */
30
- setHmrManager(hmrManager: IHmrManager) {
31
- this.hmrManager = hmrManager;
32
-
33
- for (const processor of this.registry.getAllProcessors().values()) {
34
- if (isHmrAware(processor)) {
35
- processor.setHmrManager(hmrManager);
36
- }
37
- }
38
- }
39
-
40
- getHmrManager(): IHmrManager | undefined {
41
- return this.hmrManager;
42
- }
43
-
44
- /**
45
- * Register a processor for a specific asset kind and source.
46
- * @param kind The asset kind.
47
- * @param variant The asset source.
48
- * @param processor The processor to register.
49
- */
50
- registerProcessor(kind: AssetKind, variant: AssetSource, processor: any): void {
51
- if (this.hmrManager && isHmrAware(processor)) {
52
- processor.setHmrManager(this.hmrManager);
53
- }
54
- this.registry.register(kind, variant, processor);
55
- }
56
-
57
- async processDependencies(deps: AssetDefinition[], key: string): Promise<ProcessedAsset[]> {
58
- const depsDir = path.join(this.config.absolutePaths.distDir, RESOLVED_ASSETS_DIR);
59
- fileSystem.ensureDir(depsDir);
60
-
61
- const dedupedDeps = this.deduplicateDependencies(deps);
62
- const results = await this.processDependenciesParallel(dedupedDeps, key);
63
-
64
- await this.optimizeDependencies(results);
65
- return results;
66
- }
67
-
68
- private deduplicateDependencies(deps: AssetDefinition[]): AssetDefinition[] {
69
- const seen = new Map<string, AssetDefinition>();
70
-
71
- for (const dep of deps) {
72
- const key = this.getDependencyKey(dep);
73
- if (!seen.has(key)) {
74
- seen.set(key, dep);
75
- }
76
- }
77
-
78
- return Array.from(seen.values());
79
- }
80
-
81
- private getScriptDependencyBuildSignature(dep: AssetDefinition): string | undefined {
82
- if (dep.kind !== 'script') {
83
- return undefined;
84
- }
85
-
86
- const pluginNames = dep.bundleOptions?.plugins?.map((plugin) => plugin.name) ?? [];
87
- const signature = {
88
- bundle: dep.bundle,
89
- inline: dep.inline,
90
- excludeFromHtml: dep.excludeFromHtml,
91
- naming: dep.bundleOptions?.naming,
92
- external: dep.bundleOptions?.external,
93
- minify: dep.bundleOptions?.minify,
94
- plugins: pluginNames,
95
- };
96
-
97
- return this.generateHash(JSON.stringify(signature));
98
- }
99
-
100
- private getDependencyKey(dep: AssetDefinition): string {
101
- const parts: string[] = [dep.kind, dep.source];
102
-
103
- if ('filepath' in dep) {
104
- parts.push(dep.filepath);
105
- } else if ('content' in dep) {
106
- parts.push(`content:${this.generateHash(dep.content)}`);
107
- } else if ('importPath' in dep) {
108
- parts.push(dep.importPath);
109
- }
110
-
111
- if ('position' in dep && dep.position) {
112
- parts.push(dep.position);
113
- }
114
-
115
- const scriptBuildSignature = this.getScriptDependencyBuildSignature(dep);
116
- if (scriptBuildSignature) {
117
- parts.push(`build:${scriptBuildSignature}`);
118
- }
119
-
120
- return parts.join(':');
121
- }
122
-
123
- private generateHash(content: string): string {
124
- return rapidhash(content).toString();
125
- }
126
-
127
- private async processDependenciesParallel(deps: AssetDefinition[], key: string): Promise<ProcessedAsset[]> {
128
- const grouped = this.groupDependenciesByType(deps);
129
-
130
- const groupPromises = Object.entries(grouped).map(async ([, typeDeps]) => {
131
- const typePromises = typeDeps.map(async (dep) => {
132
- const depKey = this.getDependencyKey(dep);
133
- const cached = this.getCachedAsset(dep, depKey);
134
-
135
- if (cached) {
136
- return { key, ...cached };
137
- }
138
-
139
- const processor = this.registry.getProcessor(dep.kind, dep.source);
140
- if (!processor) {
141
- appLogger.error(`No processor found for ${dep.kind}/${dep.source}`);
142
- return null;
143
- }
144
-
145
- if (dep.source === 'file' && 'filepath' in dep) {
146
- const fileExists = fileSystem.exists(dep.filepath);
147
- if (!fileExists) {
148
- appLogger.warn(`Skipping missing ${dep.kind} file: ${dep.filepath}`);
149
- return null;
150
- }
151
- }
152
-
153
- try {
154
- const processed = await processor.process(dep);
155
- const srcUrl = this.resolveProcessedAssetSrcUrl(processed);
156
-
157
- const processedWithKey = {
158
- key,
159
- ...processed,
160
- srcUrl,
161
- };
162
-
163
- this.setCachedAsset(dep, depKey, processedWithKey);
164
-
165
- return processedWithKey as ProcessedAsset;
166
- } catch (error) {
167
- appLogger.error(
168
- `Failed to process dependency: ${
169
- error instanceof Error ? error.message : String(error)
170
- } for ${dep.kind}/${dep.source}`,
171
- );
172
- appLogger.debug(error as Error);
173
- return null;
174
- }
175
- });
176
-
177
- const typeResults = await Promise.all(typePromises);
178
- return typeResults.filter((result) => result !== null);
179
- });
180
-
181
- const allTypeResults = await Promise.all(groupPromises);
182
- return allTypeResults.flat();
183
- }
184
-
185
- private groupDependenciesByType(deps: AssetDefinition[]): Record<string, AssetDefinition[]> {
186
- return deps.reduce(
187
- (acc, dep) => {
188
- const key = `${dep.kind}_${dep.source}`;
189
- if (!acc[key]) acc[key] = [];
190
- acc[key].push(dep);
191
- return acc;
192
- },
193
- {} as Record<string, AssetDefinition[]>,
194
- );
195
- }
196
-
197
- private getSrcUrl(filepath: string): string | undefined {
198
- const distDir = this.config.absolutePaths.distDir;
199
- if (!filepath.startsWith(distDir)) return undefined;
200
-
201
- const relativePath = filepath.slice(distDir.length);
202
- const urlPath = relativePath.startsWith('/') ? relativePath : `/${relativePath}`;
203
- return urlPath.replace(/\\/g, '/');
204
- }
205
-
206
- private resolveProcessedAssetSrcUrl(processed: ProcessedAsset): string | undefined {
207
- if (processed.srcUrl) {
208
- if (this.isFilesystemPath(processed.srcUrl)) {
209
- const srcUrlFromPath = this.getSrcUrl(processed.srcUrl);
210
- if (srcUrlFromPath) return srcUrlFromPath;
211
- } else {
212
- return processed.srcUrl;
213
- }
214
- }
215
-
216
- if (processed.filepath) {
217
- return this.getSrcUrl(processed.filepath);
218
- }
219
-
220
- return undefined;
221
- }
222
-
223
- private isFilesystemPath(value: string): boolean {
224
- if (value.startsWith('http://') || value.startsWith('https://') || value.startsWith('//')) {
225
- return false;
226
- }
227
-
228
- if (value.startsWith(this.config.absolutePaths.distDir)) {
229
- return true;
230
- }
231
-
232
- const rootDir = this.config.rootDir;
233
- if (rootDir && value.startsWith(rootDir)) {
234
- return true;
235
- }
236
-
237
- return /^[A-Za-z]:\\/.test(value);
238
- }
239
-
240
- private async optimizeDependencies(processedAssets: ProcessedAsset[]): Promise<void> {
241
- if (process.env.NODE_ENV !== 'production') {
242
- return;
243
- }
244
-
245
- const filesToGzip = new Set<string>();
246
-
247
- for (const asset of processedAssets) {
248
- if (!asset.filepath) {
249
- continue;
250
- }
251
-
252
- if (!asset.filepath.startsWith(this.config.absolutePaths.distDir)) {
253
- continue;
254
- }
255
-
256
- const extension = path.extname(asset.filepath).slice(1);
257
- if (extension === 'css' || extension === 'js') {
258
- filesToGzip.add(asset.filepath);
259
- }
260
- }
261
-
262
- for (const filePath of filesToGzip) {
263
- if (fileSystem.exists(filePath)) {
264
- fileSystem.gzipFile(filePath);
265
- }
266
- }
267
- }
268
-
269
- private getCachedAsset(dep: AssetDefinition, depKey: string): ProcessedAsset | null {
270
- const cached = this.cache.get(depKey);
271
- return cached?.asset ?? null;
272
- }
273
-
274
- private setCachedAsset(dep: AssetDefinition, depKey: string, asset: ProcessedAsset): void {
275
- this.cache.set(depKey, { asset });
276
- }
277
-
278
- clearCache(): void {
279
- this.cache.clear();
280
- }
281
-
282
- invalidateCacheForFile(filepath: string): void {
283
- for (const [key, value] of this.cache.entries()) {
284
- if (value.asset.filepath === filepath) {
285
- this.cache.delete(key);
286
- }
287
- }
288
- }
289
-
290
- static createWithDefaultProcessors(appConfig: EcoPagesAppConfig): AssetProcessingService {
291
- const service = new AssetProcessingService(appConfig);
292
-
293
- service.registerProcessor('script', 'content', new ContentScriptProcessor({ appConfig }));
294
- service.registerProcessor('script', 'file', new FileScriptProcessor({ appConfig }));
295
- service.registerProcessor('script', 'node-module', new NodeModuleScriptProcessor({ appConfig }));
296
-
297
- service.registerProcessor('stylesheet', 'content', new ContentStylesheetProcessor({ appConfig }));
298
- service.registerProcessor('stylesheet', 'file', new FileStylesheetProcessor({ appConfig }));
299
-
300
- return service;
301
- }
302
-
303
- getRegistry(): ProcessorRegistry {
304
- return this.registry;
305
- }
306
- }
@@ -1,105 +0,0 @@
1
- import { RESOLVED_ASSETS_DIR, RESOLVED_ASSETS_VENDORS_DIR } from '../../constants';
2
- import { deepMerge } from '../../utils/deep-merge';
3
- import type {
4
- ContentScriptAsset,
5
- ContentStylesheetAsset,
6
- FileScriptAsset,
7
- FileStylesheetAsset,
8
- InlineContentScriptAsset,
9
- InlineContentStylesheetAsset,
10
- InlineFileScriptAsset,
11
- JsonScriptAsset,
12
- NodeModuleScriptAsset,
13
- } from './assets.types';
14
-
15
- type CreateAssetOptions<T> = Omit<T, 'kind' | 'source' | 'inline'>;
16
-
17
- export class AssetFactory {
18
- static readonly RESOLVED_ASSETS_DIR = RESOLVED_ASSETS_DIR;
19
- static readonly RESOLVED_ASSETS_VENDORS_DIR = RESOLVED_ASSETS_VENDORS_DIR;
20
-
21
- static createContentScript(options: CreateAssetOptions<ContentScriptAsset>): ContentScriptAsset {
22
- return {
23
- kind: 'script',
24
- source: 'content',
25
- position: options.position || 'body',
26
- ...options,
27
- };
28
- }
29
-
30
- static createInlineContentScript(options: CreateAssetOptions<InlineContentScriptAsset>): InlineContentScriptAsset {
31
- return {
32
- ...AssetFactory.createContentScript(options),
33
- inline: true,
34
- };
35
- }
36
-
37
- static createFileScript(options: CreateAssetOptions<FileScriptAsset>): FileScriptAsset {
38
- return {
39
- kind: 'script',
40
- source: 'file',
41
- position: options.position || 'body',
42
- ...options,
43
- };
44
- }
45
-
46
- static createInlineFileScript(options: CreateAssetOptions<InlineFileScriptAsset>): InlineFileScriptAsset {
47
- return {
48
- ...AssetFactory.createFileScript(options),
49
- inline: true,
50
- };
51
- }
52
-
53
- static createNodeModuleScript(options: CreateAssetOptions<NodeModuleScriptAsset>): NodeModuleScriptAsset {
54
- return {
55
- kind: 'script',
56
- source: 'node-module',
57
- position: options.position || 'body',
58
- ...options,
59
- };
60
- }
61
-
62
- static createInlineNodeModuleScript(options: CreateAssetOptions<NodeModuleScriptAsset>): NodeModuleScriptAsset {
63
- return {
64
- ...AssetFactory.createNodeModuleScript(options),
65
- inline: true,
66
- };
67
- }
68
-
69
- static createJsonScript(options: CreateAssetOptions<JsonScriptAsset>): JsonScriptAsset {
70
- return {
71
- kind: 'script',
72
- source: 'content',
73
- attributes: deepMerge(options.attributes, { type: 'application/json' }),
74
- position: options.position || 'body',
75
- ...options,
76
- };
77
- }
78
-
79
- static createContentStylesheet(options: CreateAssetOptions<ContentStylesheetAsset>): ContentStylesheetAsset {
80
- return {
81
- kind: 'stylesheet',
82
- source: 'content',
83
- position: 'head',
84
- ...options,
85
- };
86
- }
87
-
88
- static createInlineContentStylesheet(
89
- options: CreateAssetOptions<InlineContentStylesheetAsset>,
90
- ): InlineContentStylesheetAsset {
91
- return {
92
- ...AssetFactory.createContentStylesheet(options),
93
- inline: true,
94
- };
95
- }
96
-
97
- static createFileStylesheet(options: CreateAssetOptions<FileStylesheetAsset>): FileStylesheetAsset {
98
- return {
99
- kind: 'stylesheet',
100
- source: 'file',
101
- position: options.position || 'head',
102
- ...options,
103
- };
104
- }
105
- }
@@ -1,112 +0,0 @@
1
- import type { EcoBuildPlugin } from '../../build/build-types.ts';
2
-
3
- export type AssetSource = 'content' | 'file' | 'node-module';
4
- export type AssetKind = 'script' | 'stylesheet';
5
- export type AssetPosition = 'head' | 'body';
6
-
7
- export interface BaseAsset {
8
- kind: AssetKind;
9
- source: AssetSource;
10
- attributes?: Record<string, string>;
11
- position?: AssetPosition;
12
- }
13
-
14
- export interface ScriptAsset extends BaseAsset {
15
- kind: 'script';
16
- inline?: boolean;
17
- bundle?: boolean;
18
- bundleOptions?: {
19
- minify?: boolean;
20
- external?: string[];
21
- naming?: string;
22
- plugins?: EcoBuildPlugin[];
23
- };
24
- /**
25
- * Whether to exclude this asset from the HTML output.
26
- * @default false
27
- */
28
- excludeFromHtml?: boolean;
29
- }
30
-
31
- export interface StylesheetAsset extends BaseAsset {
32
- kind: 'stylesheet';
33
- inline?: boolean;
34
- }
35
-
36
- export interface ContentScriptAsset extends ScriptAsset {
37
- source: 'content';
38
- content: string;
39
- name?: string;
40
- }
41
-
42
- export interface InlineContentScriptAsset extends ContentScriptAsset {
43
- inline: true;
44
- }
45
-
46
- export interface ContentStylesheetAsset extends StylesheetAsset {
47
- source: 'content';
48
- content: string;
49
- }
50
-
51
- export interface InlineContentStylesheetAsset extends ContentStylesheetAsset {
52
- inline: true;
53
- }
54
-
55
- export interface FileScriptAsset extends ScriptAsset {
56
- source: 'file';
57
- filepath: string;
58
- name?: string;
59
- }
60
-
61
- export interface InlineFileScriptAsset extends FileScriptAsset {
62
- inline: true;
63
- }
64
-
65
- export interface FileStylesheetAsset extends StylesheetAsset {
66
- source: 'file';
67
- filepath: string;
68
- name?: string;
69
- }
70
-
71
- export interface InlineFileStylesheetAsset extends FileStylesheetAsset {
72
- inline: true;
73
- }
74
-
75
- export interface NodeModuleScriptAsset extends ScriptAsset {
76
- kind: 'script';
77
- source: 'node-module';
78
- importPath: string;
79
- name?: string;
80
- }
81
-
82
- export interface InlineNodeModuleScriptAsset extends NodeModuleScriptAsset {
83
- inline: true;
84
- }
85
-
86
- export interface InlineNodeModuleScriptAsset extends NodeModuleScriptAsset {
87
- inline: true;
88
- }
89
-
90
- export interface JsonScriptAsset extends ScriptAsset {
91
- source: 'content';
92
- content: string;
93
- }
94
-
95
- export type ProcessedAsset = {
96
- filepath?: string;
97
- srcUrl?: string;
98
- content?: string;
99
- kind: AssetKind;
100
- position?: AssetPosition;
101
- attributes?: Record<string, string>;
102
- inline?: boolean;
103
- excludeFromHtml?: boolean;
104
- };
105
-
106
- export type AssetDefinition =
107
- | ContentScriptAsset
108
- | FileScriptAsset
109
- | NodeModuleScriptAsset
110
- | JsonScriptAsset
111
- | ContentStylesheetAsset
112
- | FileStylesheetAsset;
@@ -1,3 +0,0 @@
1
- export * from './asset.factory';
2
- export * from './asset-processing.service';
3
- export * from './assets.types';