@ecopages/core 0.2.0-alpha.9 → 0.2.1
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.
- package/CHANGELOG.md +18 -11
- package/README.md +23 -26
- package/package.json +76 -58
- package/src/adapters/README.md +2 -2
- package/src/adapters/abstract/application-adapter.d.ts +28 -2
- package/src/adapters/abstract/application-adapter.js +14 -2
- package/src/adapters/abstract/router-adapter.d.ts +1 -1
- package/src/adapters/abstract/server-adapter.d.ts +2 -2
- package/src/adapters/bun/client-bridge.d.ts +1 -1
- package/src/adapters/bun/create-app.d.ts +4 -12
- package/src/adapters/bun/create-app.js +4 -5
- package/src/adapters/bun/hmr-manager.d.ts +4 -4
- package/src/adapters/bun/hmr-manager.js +8 -8
- package/src/adapters/bun/index.d.ts +1 -1
- package/src/adapters/bun/index.js +2 -2
- package/src/adapters/bun/server-adapter.d.ts +5 -5
- package/src/adapters/bun/server-adapter.js +6 -5
- package/src/adapters/bun/server-lifecycle.d.ts +4 -4
- package/src/adapters/bun/server-lifecycle.js +2 -2
- package/src/{create-app.d.ts → adapters/create-app.d.ts} +9 -6
- package/src/{create-app.js → adapters/create-app.js} +4 -4
- package/src/adapters/index.d.ts +1 -5
- package/src/adapters/index.js +1 -7
- package/src/adapters/node/create-app.d.ts +6 -9
- package/src/adapters/node/create-app.js +12 -6
- package/src/adapters/node/node-client-bridge.d.ts +1 -1
- package/src/adapters/node/node-hmr-manager.d.ts +2 -2
- package/src/adapters/node/node-hmr-manager.js +3 -3
- package/src/adapters/node/server-adapter.d.ts +4 -4
- package/src/adapters/node/server-adapter.js +13 -12
- package/src/adapters/node/static-content-server.d.ts +1 -1
- package/src/adapters/node/static-content-server.js +1 -1
- package/src/adapters/shared/application-adapter.d.ts +1 -1
- package/src/adapters/shared/define-api-handler.d.ts +1 -1
- package/src/adapters/shared/explicit-static-route-matcher.d.ts +2 -2
- package/src/adapters/shared/file-route-middleware-pipeline.d.ts +1 -1
- package/src/adapters/shared/fs-server-response-factory.d.ts +2 -2
- package/src/adapters/shared/fs-server-response-factory.js +1 -1
- package/src/adapters/shared/fs-server-response-matcher.d.ts +1 -1
- package/src/adapters/shared/hmr-entrypoint-registrar.js +1 -1
- package/src/adapters/shared/hmr-html-response.d.ts +1 -1
- package/src/adapters/shared/render-context.d.ts +2 -1
- package/src/adapters/shared/render-context.js +3 -1
- package/src/adapters/shared/runtime-bootstrap.d.ts +1 -1
- package/src/adapters/shared/runtime-bootstrap.js +1 -1
- package/src/adapters/shared/server-adapter.d.ts +1 -1
- package/src/adapters/shared/server-adapter.js +5 -1
- package/src/adapters/shared/server-route-handler.d.ts +4 -4
- package/src/adapters/shared/server-route-handler.js +3 -3
- package/src/adapters/shared/server-static-builder.d.ts +5 -5
- package/src/adapters/shared/server-static-builder.js +5 -4
- package/src/build/README.md +19 -13
- package/src/build/build-adapter.d.ts +67 -20
- package/src/build/build-adapter.js +420 -19
- package/src/build/dev-build-coordinator.d.ts +10 -12
- package/src/build/dev-build-coordinator.js +8 -15
- package/src/build/esbuild-build-adapter.d.ts +6 -0
- package/src/build/esbuild-build-adapter.js +94 -11
- package/src/build/runtime-build-executor.d.ts +5 -4
- package/src/build/runtime-build-executor.js +5 -3
- package/src/build/runtime-specifier-alias-plugin.js +19 -15
- package/src/build/runtime-specifier-aliases.d.ts +5 -0
- package/src/build/runtime-specifier-aliases.js +95 -0
- package/src/config/README.md +5 -2
- package/src/config/config-builder.d.ts +25 -2
- package/src/config/config-builder.js +44 -7
- package/src/declarations.d.ts +1 -1
- package/src/dev/sc-server.d.ts +1 -1
- package/src/dev/sc-server.js +1 -1
- package/src/eco/eco.browser.d.ts +2 -0
- package/src/eco/eco.browser.js +83 -0
- package/src/eco/eco.js +19 -48
- package/src/eco/eco.types.d.ts +1 -1
- package/src/eco/eco.utils.d.ts +1 -40
- package/src/eco/eco.utils.js +5 -35
- package/src/eco/global-injector-map.d.ts +1 -1
- package/src/eco/lazy-injector-map.d.ts +1 -1
- package/src/hmr/hmr-strategy.d.ts +16 -13
- package/src/hmr/hmr-strategy.js +22 -7
- package/src/hmr/strategies/default-hmr-strategy.d.ts +2 -2
- package/src/hmr/strategies/default-hmr-strategy.js +1 -1
- package/src/hmr/strategies/js-hmr-strategy.d.ts +2 -2
- package/src/hmr/strategies/js-hmr-strategy.js +2 -2
- package/src/index.browser.d.ts +2 -2
- package/src/index.browser.js +1 -1
- package/src/index.d.ts +3 -2
- package/src/index.js +15 -4
- package/src/integrations/ghtml/ghtml-renderer.d.ts +6 -1
- package/src/integrations/ghtml/ghtml-renderer.js +29 -28
- package/src/integrations/ghtml/ghtml.plugin.d.ts +2 -2
- package/src/integrations/ghtml/ghtml.plugin.js +2 -2
- package/src/plugins/README.md +1 -0
- package/src/plugins/eco-component-meta-plugin.d.ts +12 -1
- package/src/plugins/eco-component-meta-plugin.js +26 -20
- package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
- package/src/plugins/foreign-jsx-override-plugin.js +35 -0
- package/src/plugins/integration-plugin.d.ts +99 -33
- package/src/plugins/integration-plugin.js +68 -21
- package/src/plugins/processor.d.ts +2 -2
- package/src/plugins/processor.js +2 -2
- package/src/plugins/source-transform.d.ts +46 -0
- package/src/plugins/source-transform.js +71 -0
- package/src/route-renderer/GRAPH.md +54 -84
- package/src/route-renderer/README.md +14 -20
- package/src/route-renderer/orchestration/component-render-context.d.ts +83 -0
- package/src/route-renderer/orchestration/component-render-context.js +147 -0
- package/src/route-renderer/orchestration/integration-renderer.d.ts +233 -76
- package/src/route-renderer/orchestration/integration-renderer.js +500 -143
- package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +93 -0
- package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +155 -0
- package/src/route-renderer/orchestration/render-execution.service.d.ts +11 -71
- package/src/route-renderer/orchestration/render-execution.service.js +65 -80
- package/src/{eco/eco.utils.ts → route-renderer/orchestration/render-output.utils.d.ts} +10 -53
- package/src/route-renderer/orchestration/render-output.utils.js +65 -0
- package/src/route-renderer/orchestration/render-preparation.service.d.ts +2 -8
- package/src/route-renderer/orchestration/render-preparation.service.js +10 -17
- package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
- package/src/route-renderer/orchestration/template-serialization.js +45 -0
- package/src/route-renderer/page-loading/dependency-resolver.d.ts +2 -2
- package/src/route-renderer/page-loading/dependency-resolver.js +10 -8
- package/src/route-renderer/page-loading/page-module-loader.d.ts +6 -4
- package/src/route-renderer/page-loading/page-module-loader.js +7 -5
- package/src/route-renderer/route-renderer.d.ts +5 -3
- package/src/route-renderer/route-renderer.js +13 -3
- package/src/router/README.md +79 -8
- package/src/router/client/navigation-coordinator.js +2 -2
- package/src/router/server/fs-router-scanner.d.ts +1 -1
- package/src/router/server/fs-router-scanner.js +6 -1
- package/src/router/server/fs-router.d.ts +1 -1
- package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +3 -3
- package/src/services/assets/asset-processing-service/asset-processing.service.js +6 -6
- package/src/services/assets/asset-processing-service/asset.factory.d.ts +1 -1
- package/src/services/assets/asset-processing-service/asset.factory.js +2 -2
- package/src/services/assets/asset-processing-service/index.d.ts +5 -5
- package/src/services/assets/asset-processing-service/index.js +5 -5
- package/src/services/assets/asset-processing-service/processor.interface.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processor.registry.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +1 -1
- package/src/services/assets/asset-processing-service/processors/base/base-processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +3 -3
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +2 -2
- package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -5
- package/src/services/assets/asset-processing-service/processors/index.js +5 -5
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +4 -3
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +15 -3
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +3 -3
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +1 -1
- package/src/services/assets/browser-bundle.service.d.ts +1 -1
- package/src/services/assets/browser-bundle.service.js +2 -2
- package/src/services/html/html-rewriter-provider.service.js +4 -1
- package/src/services/html/html-transformer.service.d.ts +2 -2
- package/src/services/html/html-transformer.service.js +4 -10
- package/src/services/invalidation/development-invalidation.service.d.ts +1 -1
- package/src/services/invalidation/development-invalidation.service.js +1 -0
- package/src/services/module-loading/app-module-loader.service.d.ts +25 -0
- package/src/services/module-loading/app-module-loader.service.js +31 -0
- package/src/services/module-loading/app-server-module-transpiler.service.d.ts +9 -1
- package/src/services/module-loading/app-server-module-transpiler.service.js +77 -2
- package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
- package/src/services/module-loading/host-module-loader-registry.js +15 -0
- package/src/services/module-loading/module-loading-types.d.ts +2 -0
- package/src/{adapters/node/bootstrap-dependency-resolver.d.ts → services/module-loading/node-bootstrap-plugin.d.ts} +2 -24
- package/src/{adapters/node/bootstrap-dependency-resolver.js → services/module-loading/node-bootstrap-plugin.js} +42 -22
- package/src/services/module-loading/page-module-import.service.d.ts +4 -0
- package/src/services/module-loading/page-module-import.service.js +38 -9
- package/src/services/module-loading/server-module-transpiler.service.d.ts +3 -0
- package/src/services/module-loading/server-module-transpiler.service.js +4 -1
- package/src/services/runtime-state/dev-graph.service.d.ts +6 -6
- package/src/services/runtime-state/dev-graph.service.js +10 -10
- package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +1 -1
- package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +1 -1
- package/src/services/runtime-state/server-invalidation-state.service.d.ts +1 -1
- package/src/static-site-generator/static-site-generator.d.ts +2 -2
- package/src/static-site-generator/static-site-generator.js +1 -1
- package/src/{internal-types.d.ts → types/internal-types.d.ts} +24 -14
- package/src/{public-types.d.ts → types/public-types.d.ts} +30 -14
- package/src/types/public-types.js +0 -0
- package/src/utils/html-escaping.d.ts +7 -0
- package/src/utils/html-escaping.js +6 -0
- package/src/utils/locals-utils.d.ts +1 -1
- package/src/utils/parse-cli-args.d.ts +4 -1
- package/src/utils/parse-cli-args.js +16 -1
- package/src/utils/resolve-work-dir.js +1 -1
- package/src/watchers/project-watcher.d.ts +4 -4
- package/src/watchers/project-watcher.js +4 -10
- package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
- package/src/adapters/abstract/application-adapter.ts +0 -337
- package/src/adapters/abstract/router-adapter.ts +0 -30
- package/src/adapters/abstract/server-adapter.ts +0 -79
- package/src/adapters/bun/client-bridge.ts +0 -62
- package/src/adapters/bun/create-app.ts +0 -189
- package/src/adapters/bun/hmr-manager.ts +0 -409
- package/src/adapters/bun/index.ts +0 -2
- package/src/adapters/bun/server-adapter.ts +0 -499
- package/src/adapters/bun/server-lifecycle.ts +0 -124
- package/src/adapters/index.ts +0 -6
- package/src/adapters/node/bootstrap-dependency-resolver.ts +0 -301
- package/src/adapters/node/create-app.ts +0 -179
- package/src/adapters/node/index.d.ts +0 -6
- package/src/adapters/node/index.js +0 -11
- package/src/adapters/node/index.ts +0 -16
- package/src/adapters/node/node-client-bridge.ts +0 -79
- package/src/adapters/node/node-hmr-manager.ts +0 -381
- package/src/adapters/node/runtime-adapter.d.ts +0 -46
- package/src/adapters/node/runtime-adapter.js +0 -306
- package/src/adapters/node/runtime-adapter.ts +0 -439
- package/src/adapters/node/server-adapter.ts +0 -488
- package/src/adapters/node/static-content-server.ts +0 -239
- package/src/adapters/node/write-runtime-manifest.d.ts +0 -26
- package/src/adapters/node/write-runtime-manifest.js +0 -12
- package/src/adapters/node/write-runtime-manifest.ts +0 -38
- package/src/adapters/shared/api-response.ts +0 -104
- package/src/adapters/shared/application-adapter.ts +0 -199
- package/src/adapters/shared/define-api-handler.ts +0 -66
- package/src/adapters/shared/explicit-static-route-matcher.ts +0 -140
- package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -127
- package/src/adapters/shared/fs-server-response-factory.ts +0 -118
- package/src/adapters/shared/fs-server-response-matcher.ts +0 -205
- package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
- package/src/adapters/shared/hmr-html-response.ts +0 -52
- package/src/adapters/shared/render-context.ts +0 -120
- package/src/adapters/shared/runtime-bootstrap.ts +0 -79
- package/src/adapters/shared/server-adapter.ts +0 -489
- package/src/adapters/shared/server-route-handler.ts +0 -153
- package/src/adapters/shared/server-static-builder.ts +0 -166
- package/src/build/build-adapter.ts +0 -361
- package/src/build/build-manifest.ts +0 -54
- package/src/build/build-types.ts +0 -83
- package/src/build/dev-build-coordinator.ts +0 -221
- package/src/build/esbuild-build-adapter.ts +0 -559
- package/src/build/runtime-build-executor.ts +0 -34
- package/src/build/runtime-specifier-alias-plugin.ts +0 -58
- package/src/config/config-builder.ts +0 -706
- package/src/constants.ts +0 -54
- package/src/create-app.ts +0 -87
- package/src/dev/sc-server.ts +0 -143
- package/src/eco/component-render-context.d.ts +0 -105
- package/src/eco/component-render-context.js +0 -87
- package/src/eco/component-render-context.ts +0 -224
- package/src/eco/eco.ts +0 -242
- package/src/eco/eco.types.ts +0 -221
- package/src/eco/global-injector-map.ts +0 -112
- package/src/eco/lazy-injector-map.ts +0 -120
- package/src/eco/module-dependencies.ts +0 -75
- package/src/errors/http-error.ts +0 -72
- package/src/errors/index.ts +0 -2
- package/src/errors/locals-access-error.ts +0 -7
- package/src/global/app-logger.ts +0 -4
- package/src/hmr/client/hmr-runtime.ts +0 -152
- package/src/hmr/hmr-strategy.ts +0 -172
- package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
- package/src/hmr/hmr.test.e2e.ts +0 -66
- package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
- package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
- package/src/index.browser.ts +0 -3
- package/src/index.ts +0 -5
- package/src/integrations/ghtml/ghtml-renderer.ts +0 -96
- package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
- package/src/internal-types.ts +0 -232
- package/src/plugins/alias-resolver-plugin.ts +0 -63
- package/src/plugins/eco-component-meta-plugin.ts +0 -481
- package/src/plugins/integration-plugin.ts +0 -226
- package/src/plugins/processor.ts +0 -240
- package/src/plugins/runtime-capability.ts +0 -14
- package/src/public-types.ts +0 -1317
- package/src/route-renderer/component-graph/component-graph-executor.d.ts +0 -32
- package/src/route-renderer/component-graph/component-graph-executor.js +0 -31
- package/src/route-renderer/component-graph/component-graph-executor.ts +0 -84
- package/src/route-renderer/component-graph/component-graph.d.ts +0 -42
- package/src/route-renderer/component-graph/component-graph.js +0 -72
- package/src/route-renderer/component-graph/component-graph.ts +0 -159
- package/src/route-renderer/component-graph/component-marker.d.ts +0 -52
- package/src/route-renderer/component-graph/component-marker.js +0 -46
- package/src/route-renderer/component-graph/component-marker.ts +0 -117
- package/src/route-renderer/component-graph/component-reference.d.ts +0 -10
- package/src/route-renderer/component-graph/component-reference.js +0 -19
- package/src/route-renderer/component-graph/component-reference.ts +0 -29
- package/src/route-renderer/component-graph/marker-graph-resolver.d.ts +0 -77
- package/src/route-renderer/component-graph/marker-graph-resolver.js +0 -95
- package/src/route-renderer/component-graph/marker-graph-resolver.ts +0 -155
- package/src/route-renderer/orchestration/integration-renderer.ts +0 -790
- package/src/route-renderer/orchestration/render-execution.service.ts +0 -230
- package/src/route-renderer/orchestration/render-preparation.service.ts +0 -476
- package/src/route-renderer/page-loading/dependency-resolver.ts +0 -612
- package/src/route-renderer/page-loading/page-module-loader.ts +0 -181
- package/src/route-renderer/route-renderer.ts +0 -115
- package/src/router/client/link-intent.test.browser.ts +0 -51
- package/src/router/client/link-intent.ts +0 -92
- package/src/router/client/navigation-coordinator.ts +0 -433
- package/src/router/server/fs-router-scanner.ts +0 -219
- package/src/router/server/fs-router.ts +0 -122
- package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -401
- package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
- package/src/services/assets/asset-processing-service/assets.types.ts +0 -113
- package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -95
- package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
- package/src/services/assets/asset-processing-service/index.ts +0 -5
- package/src/services/assets/asset-processing-service/processor.interface.ts +0 -27
- package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
- package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -82
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -95
- package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -66
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -88
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -85
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -80
- package/src/services/assets/browser-bundle.service.ts +0 -53
- package/src/services/cache/cache.types.ts +0 -126
- package/src/services/cache/index.ts +0 -18
- package/src/services/cache/memory-cache-store.ts +0 -130
- package/src/services/cache/page-cache-service.ts +0 -202
- package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
- package/src/services/html/html-rewriter-provider.service.ts +0 -103
- package/src/services/html/html-transformer.service.ts +0 -279
- package/src/services/invalidation/development-invalidation.service.ts +0 -261
- package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -52
- package/src/services/module-loading/page-module-import.service.ts +0 -200
- package/src/services/module-loading/server-loader.service.d.ts +0 -96
- package/src/services/module-loading/server-loader.service.js +0 -32
- package/src/services/module-loading/server-loader.service.ts +0 -130
- package/src/services/module-loading/server-module-transpiler.service.ts +0 -105
- package/src/services/runtime-manifest/node-runtime-manifest.service.d.ts +0 -35
- package/src/services/runtime-manifest/node-runtime-manifest.service.js +0 -60
- package/src/services/runtime-manifest/node-runtime-manifest.service.ts +0 -101
- package/src/services/runtime-state/dev-graph.service.ts +0 -217
- package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
- package/src/services/runtime-state/runtime-specifier-registry.service.ts +0 -96
- package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
- package/src/services/validation/schema-validation-service.ts +0 -204
- package/src/services/validation/standard-schema.types.ts +0 -68
- package/src/static-site-generator/static-site-generator.ts +0 -462
- package/src/utils/css.d.ts +0 -1
- package/src/utils/css.js +0 -7
- package/src/utils/css.ts +0 -5
- package/src/utils/deep-merge.ts +0 -47
- package/src/utils/hash.ts +0 -5
- package/src/utils/html.ts +0 -1
- package/src/utils/invariant.ts +0 -15
- package/src/utils/locals-utils.ts +0 -37
- package/src/utils/parse-cli-args.ts +0 -83
- package/src/utils/path-utils.module.ts +0 -14
- package/src/utils/resolve-work-dir.ts +0 -45
- package/src/utils/runtime.ts +0 -44
- package/src/utils/server-utils.module.ts +0 -67
- package/src/watchers/project-watcher.test-helpers.ts +0 -41
- package/src/watchers/project-watcher.ts +0 -363
- /package/src/{constants.d.ts → config/constants.d.ts} +0 -0
- /package/src/{constants.js → config/constants.js} +0 -0
- /package/src/{internal-types.js → services/module-loading/module-loading-types.js} +0 -0
- /package/src/{public-types.js → types/internal-types.js} +0 -0
|
@@ -1,230 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
runWithComponentRenderContext,
|
|
3
|
-
type ComponentRenderBoundaryContext,
|
|
4
|
-
} from '../../eco/component-render-context.ts';
|
|
5
|
-
import type {
|
|
6
|
-
EcoComponent,
|
|
7
|
-
IntegrationRendererRenderOptions,
|
|
8
|
-
RouteRendererBody,
|
|
9
|
-
RouteRendererOptions,
|
|
10
|
-
RouteRenderResult,
|
|
11
|
-
} from '../../public-types.ts';
|
|
12
|
-
import type { ProcessedAsset } from '../../services/assets/asset-processing-service/index.ts';
|
|
13
|
-
import type { MarkerGraphContext } from '../component-graph/marker-graph-resolver.ts';
|
|
14
|
-
|
|
15
|
-
/**
|
|
16
|
-
* Serializable graph context merged from render-time captured references and
|
|
17
|
-
* optional explicit page-module graph metadata.
|
|
18
|
-
*/
|
|
19
|
-
export type RenderExecutionGraphContext = {
|
|
20
|
-
propsByRef?: Record<string, Record<string, unknown>>;
|
|
21
|
-
slotChildrenByRef?: MarkerGraphContext['slotChildrenByRef'];
|
|
22
|
-
};
|
|
23
|
-
|
|
24
|
-
export interface CapturedHtmlRenderResult {
|
|
25
|
-
html: string;
|
|
26
|
-
graphContext: RenderExecutionGraphContext;
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
export interface FinalizeHtmlRenderOptions {
|
|
30
|
-
html: string;
|
|
31
|
-
graphContext: RenderExecutionGraphContext;
|
|
32
|
-
componentsToResolve: EcoComponent[];
|
|
33
|
-
componentRootAttributes?: Record<string, string>;
|
|
34
|
-
documentAttributes?: Record<string, string>;
|
|
35
|
-
mergeAssets?: boolean;
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
export interface RenderExecutionCallbacks<C> {
|
|
39
|
-
prepareRenderOptions(options: RouteRendererOptions): Promise<IntegrationRendererRenderOptions<C>>;
|
|
40
|
-
render(renderOptions: IntegrationRendererRenderOptions<C>): Promise<RouteRendererBody>;
|
|
41
|
-
getComponentRenderBoundaryContext(): ComponentRenderBoundaryContext;
|
|
42
|
-
getDocumentAttributes(renderOptions: IntegrationRendererRenderOptions<C>): Record<string, string> | undefined;
|
|
43
|
-
resolveMarkerGraphHtml(input: {
|
|
44
|
-
html: string;
|
|
45
|
-
componentsToResolve: EcoComponent[];
|
|
46
|
-
graphContext: RenderExecutionGraphContext;
|
|
47
|
-
}): Promise<{ html: string; assets: ProcessedAsset[] }>;
|
|
48
|
-
dedupeProcessedAssets(assets: ProcessedAsset[]): ProcessedAsset[];
|
|
49
|
-
getProcessedDependencies(): ProcessedAsset[];
|
|
50
|
-
setProcessedDependencies(dependencies: ProcessedAsset[]): void;
|
|
51
|
-
applyAttributesToHtmlElement(html: string, attributes: Record<string, string>): string;
|
|
52
|
-
applyAttributesToFirstBodyElement(html: string, attributes: Record<string, string>): string;
|
|
53
|
-
transformHtml(html: string): Promise<RouteRendererBody>;
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
export interface FinalizeHtmlRenderCallbacks {
|
|
57
|
-
resolveMarkerGraphHtml(input: {
|
|
58
|
-
html: string;
|
|
59
|
-
componentsToResolve: EcoComponent[];
|
|
60
|
-
graphContext: RenderExecutionGraphContext;
|
|
61
|
-
}): Promise<{ html: string; assets: ProcessedAsset[] }>;
|
|
62
|
-
dedupeProcessedAssets(assets: ProcessedAsset[]): ProcessedAsset[];
|
|
63
|
-
getProcessedDependencies(): ProcessedAsset[];
|
|
64
|
-
setProcessedDependencies(dependencies: ProcessedAsset[]): void;
|
|
65
|
-
applyAttributesToHtmlElement(html: string, attributes: Record<string, string>): string;
|
|
66
|
-
applyAttributesToFirstBodyElement(html: string, attributes: Record<string, string>): string;
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
/**
|
|
70
|
-
* Executes the main post-preparation rendering flow for integration renderers.
|
|
71
|
-
*
|
|
72
|
-
* This service owns the orchestration that happens after normalized render
|
|
73
|
-
* options have been prepared: the first render pass, graph-context capture,
|
|
74
|
-
* deferred marker resolution, root-attribute application, and final HTML
|
|
75
|
-
* transformation into a response body stream.
|
|
76
|
-
*/
|
|
77
|
-
export class RenderExecutionService {
|
|
78
|
-
async captureHtmlRender(
|
|
79
|
-
currentIntegrationName: string,
|
|
80
|
-
boundaryContext: ComponentRenderBoundaryContext,
|
|
81
|
-
render: () => Promise<RouteRendererBody>,
|
|
82
|
-
): Promise<CapturedHtmlRenderResult> {
|
|
83
|
-
const renderExecution = await runWithComponentRenderContext(
|
|
84
|
-
{
|
|
85
|
-
currentIntegration: currentIntegrationName,
|
|
86
|
-
boundaryContext,
|
|
87
|
-
},
|
|
88
|
-
render,
|
|
89
|
-
);
|
|
90
|
-
|
|
91
|
-
return {
|
|
92
|
-
html: await new Response(renderExecution.value as BodyInit).text(),
|
|
93
|
-
graphContext: renderExecution.graphContext,
|
|
94
|
-
};
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
/**
|
|
98
|
-
* Executes one integration render pass and returns the final route render
|
|
99
|
-
* result.
|
|
100
|
-
*
|
|
101
|
-
* @typeParam C Integration render output element type.
|
|
102
|
-
* @param options Route-level render options.
|
|
103
|
-
* @param currentIntegrationName Active integration name for this render pass.
|
|
104
|
-
* @param callbacks Renderer-specific hooks required during execution.
|
|
105
|
-
* @returns Final route render output with body and cache strategy.
|
|
106
|
-
*/
|
|
107
|
-
async execute<C = unknown>(
|
|
108
|
-
options: RouteRendererOptions,
|
|
109
|
-
currentIntegrationName: string,
|
|
110
|
-
callbacks: RenderExecutionCallbacks<C>,
|
|
111
|
-
): Promise<RouteRenderResult> {
|
|
112
|
-
const renderOptions = await callbacks.prepareRenderOptions(options);
|
|
113
|
-
const shouldApplyComponentRootAttributes =
|
|
114
|
-
renderOptions.componentRender?.canAttachAttributes &&
|
|
115
|
-
renderOptions.componentRender.rootAttributes &&
|
|
116
|
-
Object.keys(renderOptions.componentRender.rootAttributes).length > 0;
|
|
117
|
-
|
|
118
|
-
const renderExecution = await this.captureHtmlRender(
|
|
119
|
-
currentIntegrationName,
|
|
120
|
-
callbacks.getComponentRenderBoundaryContext(),
|
|
121
|
-
async () => callbacks.render(renderOptions),
|
|
122
|
-
);
|
|
123
|
-
|
|
124
|
-
const componentGraphContext = this.mergeGraphContext(
|
|
125
|
-
renderExecution.graphContext,
|
|
126
|
-
(
|
|
127
|
-
renderOptions as IntegrationRendererRenderOptions<C> & {
|
|
128
|
-
componentGraphContext?: RenderExecutionGraphContext;
|
|
129
|
-
}
|
|
130
|
-
).componentGraphContext,
|
|
131
|
-
);
|
|
132
|
-
const finalization = await this.finalizeHtmlRender(
|
|
133
|
-
{
|
|
134
|
-
html: renderExecution.html,
|
|
135
|
-
graphContext: componentGraphContext,
|
|
136
|
-
componentsToResolve: this.getComponentsToResolve(renderOptions),
|
|
137
|
-
componentRootAttributes: shouldApplyComponentRootAttributes
|
|
138
|
-
? (renderOptions.componentRender?.rootAttributes as Record<string, string>)
|
|
139
|
-
: undefined,
|
|
140
|
-
documentAttributes: callbacks.getDocumentAttributes(renderOptions),
|
|
141
|
-
mergeAssets: true,
|
|
142
|
-
},
|
|
143
|
-
callbacks,
|
|
144
|
-
);
|
|
145
|
-
|
|
146
|
-
const body = await callbacks.transformHtml(finalization.html);
|
|
147
|
-
|
|
148
|
-
return {
|
|
149
|
-
body,
|
|
150
|
-
cacheStrategy: renderOptions.cacheStrategy,
|
|
151
|
-
};
|
|
152
|
-
}
|
|
153
|
-
|
|
154
|
-
/**
|
|
155
|
-
* Merges captured render-time graph references with any explicit graph context
|
|
156
|
-
* provided by the page module.
|
|
157
|
-
*
|
|
158
|
-
* @param capturedGraphContext Graph context captured from the first render pass.
|
|
159
|
-
* @param explicitGraphContext Optional page-module graph metadata.
|
|
160
|
-
* @returns Merged graph context used during marker resolution.
|
|
161
|
-
*/
|
|
162
|
-
mergeGraphContext(
|
|
163
|
-
capturedGraphContext: RenderExecutionGraphContext,
|
|
164
|
-
explicitGraphContext?: RenderExecutionGraphContext,
|
|
165
|
-
): RenderExecutionGraphContext {
|
|
166
|
-
return {
|
|
167
|
-
propsByRef: {
|
|
168
|
-
...(capturedGraphContext.propsByRef ?? {}),
|
|
169
|
-
...(explicitGraphContext?.propsByRef ?? {}),
|
|
170
|
-
},
|
|
171
|
-
slotChildrenByRef: {
|
|
172
|
-
...(capturedGraphContext.slotChildrenByRef ?? {}),
|
|
173
|
-
...(explicitGraphContext?.slotChildrenByRef ?? {}),
|
|
174
|
-
},
|
|
175
|
-
};
|
|
176
|
-
}
|
|
177
|
-
|
|
178
|
-
async finalizeHtmlRender(
|
|
179
|
-
options: FinalizeHtmlRenderOptions,
|
|
180
|
-
callbacks: FinalizeHtmlRenderCallbacks,
|
|
181
|
-
): Promise<{ html: string; assets: ProcessedAsset[] }> {
|
|
182
|
-
let renderedHtml = options.html;
|
|
183
|
-
let markerAssets: ProcessedAsset[] = [];
|
|
184
|
-
|
|
185
|
-
if (renderedHtml.includes('<eco-marker')) {
|
|
186
|
-
const markerResolution = await callbacks.resolveMarkerGraphHtml({
|
|
187
|
-
html: renderedHtml,
|
|
188
|
-
componentsToResolve: options.componentsToResolve,
|
|
189
|
-
graphContext: options.graphContext,
|
|
190
|
-
});
|
|
191
|
-
renderedHtml = markerResolution.html;
|
|
192
|
-
markerAssets = markerResolution.assets;
|
|
193
|
-
|
|
194
|
-
if (options.mergeAssets !== false && markerResolution.assets.length > 0) {
|
|
195
|
-
const mergedDependencies = callbacks.dedupeProcessedAssets([
|
|
196
|
-
...callbacks.getProcessedDependencies(),
|
|
197
|
-
...markerResolution.assets,
|
|
198
|
-
]);
|
|
199
|
-
callbacks.setProcessedDependencies(mergedDependencies);
|
|
200
|
-
}
|
|
201
|
-
}
|
|
202
|
-
|
|
203
|
-
if (options.componentRootAttributes && Object.keys(options.componentRootAttributes).length > 0) {
|
|
204
|
-
renderedHtml = callbacks.applyAttributesToFirstBodyElement(renderedHtml, options.componentRootAttributes);
|
|
205
|
-
}
|
|
206
|
-
|
|
207
|
-
if (options.documentAttributes && Object.keys(options.documentAttributes).length > 0) {
|
|
208
|
-
renderedHtml = callbacks.applyAttributesToHtmlElement(renderedHtml, options.documentAttributes);
|
|
209
|
-
}
|
|
210
|
-
|
|
211
|
-
return {
|
|
212
|
-
html: renderedHtml,
|
|
213
|
-
assets: markerAssets,
|
|
214
|
-
};
|
|
215
|
-
}
|
|
216
|
-
|
|
217
|
-
/**
|
|
218
|
-
* Returns the component set that participates in marker graph resolution for a
|
|
219
|
-
* render pass.
|
|
220
|
-
*
|
|
221
|
-
* @typeParam C Integration render output element type.
|
|
222
|
-
* @param renderOptions Normalized render options for the pass.
|
|
223
|
-
* @returns Ordered component list for graph registry construction.
|
|
224
|
-
*/
|
|
225
|
-
private getComponentsToResolve<C>(renderOptions: IntegrationRendererRenderOptions<C>): EcoComponent[] {
|
|
226
|
-
return renderOptions.Layout
|
|
227
|
-
? [renderOptions.HtmlTemplate as EcoComponent, renderOptions.Layout as EcoComponent, renderOptions.Page]
|
|
228
|
-
: [renderOptions.HtmlTemplate as EcoComponent, renderOptions.Page];
|
|
229
|
-
}
|
|
230
|
-
}
|
|
@@ -1,476 +0,0 @@
|
|
|
1
|
-
import { createRequire } from 'node:module';
|
|
2
|
-
import type { EcoPagesAppConfig } from '../../internal-types.ts';
|
|
3
|
-
import type {
|
|
4
|
-
ComponentRenderResult,
|
|
5
|
-
EcoComponent,
|
|
6
|
-
EcoComponentConfig,
|
|
7
|
-
DependencyAttributes,
|
|
8
|
-
EcoPageComponent,
|
|
9
|
-
EcoPageFile,
|
|
10
|
-
EcoPagesElement,
|
|
11
|
-
GetMetadata,
|
|
12
|
-
GetStaticProps,
|
|
13
|
-
HtmlTemplateProps,
|
|
14
|
-
IntegrationRendererRenderOptions,
|
|
15
|
-
PageProps,
|
|
16
|
-
PageMetadataProps,
|
|
17
|
-
ResolvedLazyTrigger,
|
|
18
|
-
RouteRendererOptions,
|
|
19
|
-
} from '../../public-types.ts';
|
|
20
|
-
import {
|
|
21
|
-
type AssetProcessingService,
|
|
22
|
-
AssetFactory,
|
|
23
|
-
type ProcessedAsset,
|
|
24
|
-
} from '../../services/assets/asset-processing-service/index.ts';
|
|
25
|
-
import { buildGlobalInjectorBootstrapContent, buildGlobalInjectorMapScript } from '../../eco/global-injector-map.ts';
|
|
26
|
-
import {
|
|
27
|
-
runWithComponentRenderContext,
|
|
28
|
-
type ComponentRenderBoundaryContext,
|
|
29
|
-
} from '../../eco/component-render-context.ts';
|
|
30
|
-
|
|
31
|
-
const coreRequire = createRequire(import.meta.url);
|
|
32
|
-
|
|
33
|
-
type ResolvedPageModule = {
|
|
34
|
-
Page: EcoPageFile['default'] | EcoPageComponent<any>;
|
|
35
|
-
getStaticProps?: GetStaticProps<Record<string, unknown>>;
|
|
36
|
-
getMetadata?: GetMetadata;
|
|
37
|
-
integrationSpecificProps: Record<string, unknown>;
|
|
38
|
-
};
|
|
39
|
-
|
|
40
|
-
export interface RenderPreparationCallbacks {
|
|
41
|
-
resolvePageModule(file: string): Promise<ResolvedPageModule>;
|
|
42
|
-
getHtmlTemplate(): Promise<EcoComponent<HtmlTemplateProps>>;
|
|
43
|
-
resolvePageData(
|
|
44
|
-
pageModule: {
|
|
45
|
-
getStaticProps?: GetStaticProps<Record<string, unknown>>;
|
|
46
|
-
getMetadata?: GetMetadata;
|
|
47
|
-
},
|
|
48
|
-
routeOptions: RouteRendererOptions,
|
|
49
|
-
): Promise<{ props: Record<string, unknown>; metadata: PageMetadataProps }>;
|
|
50
|
-
resolveDependencies(components: (EcoComponent | Partial<EcoComponent>)[]): Promise<ProcessedAsset[]>;
|
|
51
|
-
buildRouteRenderAssets(file: string): Promise<ProcessedAsset[]> | undefined;
|
|
52
|
-
shouldRenderPageComponent(input: {
|
|
53
|
-
Page: EcoComponent;
|
|
54
|
-
Layout?: EcoComponent;
|
|
55
|
-
options: RouteRendererOptions;
|
|
56
|
-
}): boolean;
|
|
57
|
-
renderPageComponent(input: {
|
|
58
|
-
component: EcoComponent;
|
|
59
|
-
props: Record<string, unknown>;
|
|
60
|
-
}): Promise<ComponentRenderResult>;
|
|
61
|
-
/**
|
|
62
|
-
* Returns the boundary policy context that should be active while rendering
|
|
63
|
-
* page-root component output during preparation.
|
|
64
|
-
*/
|
|
65
|
-
getComponentRenderBoundaryContext(): ComponentRenderBoundaryContext;
|
|
66
|
-
setProcessedDependencies(dependencies: ProcessedAsset[]): void;
|
|
67
|
-
dedupeProcessedAssets(assets: ProcessedAsset[]): ProcessedAsset[];
|
|
68
|
-
createPageLocalsProxy(filePath: string): RouteRendererOptions['locals'];
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
/**
|
|
72
|
-
* Prepares the normalized render inputs consumed by `IntegrationRenderer.execute()`.
|
|
73
|
-
*
|
|
74
|
-
* This service owns the orchestration that happens before the main HTML render:
|
|
75
|
-
* page module resolution, data loading, dependency aggregation, page-root
|
|
76
|
-
* component artifact capture, lazy trigger bootstrap generation, and request
|
|
77
|
-
* locals policy.
|
|
78
|
-
*/
|
|
79
|
-
export class RenderPreparationService {
|
|
80
|
-
private appConfig: EcoPagesAppConfig;
|
|
81
|
-
private assetProcessingService: AssetProcessingService;
|
|
82
|
-
|
|
83
|
-
/**
|
|
84
|
-
* Creates the render-preparation orchestrator for one app instance.
|
|
85
|
-
*
|
|
86
|
-
* @remarks
|
|
87
|
-
* The service is app-scoped because it depends on finalized config defaults and
|
|
88
|
-
* the app-owned asset-processing pipeline while remaining renderer-agnostic.
|
|
89
|
-
*/
|
|
90
|
-
constructor(appConfig: EcoPagesAppConfig, assetProcessingService: AssetProcessingService) {
|
|
91
|
-
this.appConfig = appConfig;
|
|
92
|
-
this.assetProcessingService = assetProcessingService;
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
/**
|
|
96
|
-
* Builds the final render options object used by the integration-specific
|
|
97
|
-
* renderer.
|
|
98
|
-
*
|
|
99
|
-
* The returned object contains normalized page data, processed dependency
|
|
100
|
-
* state, component render artifacts, and the locals contract expected by the
|
|
101
|
-
* rest of the pipeline.
|
|
102
|
-
*
|
|
103
|
-
* @typeParam C Integration render output element type.
|
|
104
|
-
* @param routeOptions Route-level render inputs.
|
|
105
|
-
* @param currentIntegrationName Active integration name for this preparation pass.
|
|
106
|
-
* @param callbacks Renderer-specific hooks used during preparation.
|
|
107
|
-
* @returns Normalized render options.
|
|
108
|
-
*/
|
|
109
|
-
async prepare<C = EcoPagesElement>(
|
|
110
|
-
routeOptions: RouteRendererOptions,
|
|
111
|
-
currentIntegrationName: string,
|
|
112
|
-
callbacks: RenderPreparationCallbacks,
|
|
113
|
-
): Promise<IntegrationRendererRenderOptions<C>> {
|
|
114
|
-
const pageModule = await callbacks.resolvePageModule(routeOptions.file);
|
|
115
|
-
const { Page, integrationSpecificProps } = pageModule;
|
|
116
|
-
const HtmlTemplate = await callbacks.getHtmlTemplate();
|
|
117
|
-
const { props, metadata } = await callbacks.resolvePageData(pageModule, routeOptions);
|
|
118
|
-
const Layout = Page.config?.layout;
|
|
119
|
-
|
|
120
|
-
const componentsToResolve = Layout ? [HtmlTemplate, Layout, Page] : [HtmlTemplate, Page];
|
|
121
|
-
const resolvedDependencies = await callbacks.resolveDependencies(componentsToResolve);
|
|
122
|
-
const usedIntegrationDependencies = this.collectUsedIntegrationDependencies(
|
|
123
|
-
componentsToResolve,
|
|
124
|
-
currentIntegrationName,
|
|
125
|
-
);
|
|
126
|
-
const pageDeps = (await callbacks.buildRouteRenderAssets(routeOptions.file)) || [];
|
|
127
|
-
const allDependencies = [...resolvedDependencies, ...usedIntegrationDependencies, ...pageDeps];
|
|
128
|
-
|
|
129
|
-
let componentRender: ComponentRenderResult | undefined;
|
|
130
|
-
if (callbacks.shouldRenderPageComponent({ Page, Layout, options: routeOptions })) {
|
|
131
|
-
componentRender = await this.renderPageRoot({
|
|
132
|
-
currentIntegrationName,
|
|
133
|
-
Page: Page as EcoComponent,
|
|
134
|
-
props,
|
|
135
|
-
routeOptions,
|
|
136
|
-
callbacks,
|
|
137
|
-
});
|
|
138
|
-
|
|
139
|
-
if (componentRender.assets?.length) {
|
|
140
|
-
allDependencies.push(...componentRender.assets);
|
|
141
|
-
}
|
|
142
|
-
}
|
|
143
|
-
|
|
144
|
-
const triggers = this.collectResolvedTriggers(componentsToResolve);
|
|
145
|
-
if (triggers.length > 0) {
|
|
146
|
-
const globalAssets = await this.buildGlobalInjectorAssets(triggers, currentIntegrationName);
|
|
147
|
-
allDependencies.push(...globalAssets);
|
|
148
|
-
}
|
|
149
|
-
|
|
150
|
-
const eagerSsrLazyAssets = await this.buildEagerSsrLazyAssets(componentsToResolve, currentIntegrationName);
|
|
151
|
-
if (eagerSsrLazyAssets.length > 0) {
|
|
152
|
-
allDependencies.push(...eagerSsrLazyAssets);
|
|
153
|
-
}
|
|
154
|
-
|
|
155
|
-
callbacks.setProcessedDependencies(callbacks.dedupeProcessedAssets(allDependencies));
|
|
156
|
-
|
|
157
|
-
const pageProps = {
|
|
158
|
-
...props,
|
|
159
|
-
params: routeOptions.params || {},
|
|
160
|
-
query: routeOptions.query || {},
|
|
161
|
-
};
|
|
162
|
-
|
|
163
|
-
const cacheStrategy = (Page as EcoPageComponent<any>).cache;
|
|
164
|
-
const defaultCacheStrategy = this.appConfig.cache?.defaultStrategy ?? 'static';
|
|
165
|
-
const effectiveCacheStrategy = cacheStrategy ?? defaultCacheStrategy;
|
|
166
|
-
const localsAvailable = effectiveCacheStrategy === 'dynamic' && routeOptions.locals !== undefined;
|
|
167
|
-
|
|
168
|
-
const pageLocals = localsAvailable ? routeOptions.locals! : callbacks.createPageLocalsProxy(routeOptions.file);
|
|
169
|
-
|
|
170
|
-
const locals = localsAvailable ? routeOptions.locals : undefined;
|
|
171
|
-
const preparedOptions: IntegrationRendererRenderOptions<C> = {
|
|
172
|
-
...routeOptions,
|
|
173
|
-
resolvedDependencies,
|
|
174
|
-
componentRender,
|
|
175
|
-
HtmlTemplate: HtmlTemplate as EcoComponent<HtmlTemplateProps, C>,
|
|
176
|
-
Layout,
|
|
177
|
-
props,
|
|
178
|
-
Page: Page as EcoComponent<PageProps, C>,
|
|
179
|
-
metadata,
|
|
180
|
-
params: routeOptions.params || {},
|
|
181
|
-
query: routeOptions.query || {},
|
|
182
|
-
pageProps,
|
|
183
|
-
locals,
|
|
184
|
-
pageLocals,
|
|
185
|
-
cacheStrategy,
|
|
186
|
-
};
|
|
187
|
-
|
|
188
|
-
return {
|
|
189
|
-
...integrationSpecificProps,
|
|
190
|
-
...preparedOptions,
|
|
191
|
-
};
|
|
192
|
-
}
|
|
193
|
-
|
|
194
|
-
/**
|
|
195
|
-
* Collects resolved lazy trigger metadata from the component tree.
|
|
196
|
-
*
|
|
197
|
-
* Traversal is depth-first and deduplicated by component identity so shared
|
|
198
|
-
* component dependencies do not emit duplicate trigger sets.
|
|
199
|
-
*
|
|
200
|
-
* @param components Root component set.
|
|
201
|
-
* @param seen Internal visited set for shared graphs.
|
|
202
|
-
* @returns All resolved lazy triggers reachable from the root set.
|
|
203
|
-
*/
|
|
204
|
-
private collectResolvedTriggers(
|
|
205
|
-
components: (EcoComponent | Partial<EcoComponent>)[],
|
|
206
|
-
seen = new Set<object>(),
|
|
207
|
-
): ResolvedLazyTrigger[] {
|
|
208
|
-
const triggers: ResolvedLazyTrigger[] = [];
|
|
209
|
-
for (const comp of components) {
|
|
210
|
-
const ecoComp = comp as EcoComponent;
|
|
211
|
-
if (seen.has(ecoComp)) {
|
|
212
|
-
continue;
|
|
213
|
-
}
|
|
214
|
-
seen.add(ecoComp);
|
|
215
|
-
const ownTriggers = ecoComp.config?._resolvedLazyTriggers;
|
|
216
|
-
if (ownTriggers?.length) {
|
|
217
|
-
triggers.push(...ownTriggers);
|
|
218
|
-
}
|
|
219
|
-
const nested = ecoComp.config?.dependencies?.components;
|
|
220
|
-
if (nested?.length) {
|
|
221
|
-
triggers.push(...this.collectResolvedTriggers(nested, seen));
|
|
222
|
-
}
|
|
223
|
-
}
|
|
224
|
-
return triggers;
|
|
225
|
-
}
|
|
226
|
-
|
|
227
|
-
/**
|
|
228
|
-
* Collects global integration dependencies used by nested components belonging
|
|
229
|
-
* to integrations other than the current renderer.
|
|
230
|
-
*
|
|
231
|
-
* @param components Root component set.
|
|
232
|
-
* @returns Processed integration dependencies contributed by nested integrations.
|
|
233
|
-
*/
|
|
234
|
-
private collectUsedIntegrationDependencies(
|
|
235
|
-
components: (EcoComponent | Partial<EcoComponent>)[],
|
|
236
|
-
currentIntegrationName: string,
|
|
237
|
-
): ProcessedAsset[] {
|
|
238
|
-
const integrationNames = this.collectIntegrationNames(components);
|
|
239
|
-
const dependencies: ProcessedAsset[] = [];
|
|
240
|
-
|
|
241
|
-
for (const integrationName of integrationNames) {
|
|
242
|
-
if (integrationName === currentIntegrationName) {
|
|
243
|
-
continue;
|
|
244
|
-
}
|
|
245
|
-
|
|
246
|
-
const integrationPlugin = this.appConfig.integrations.find(
|
|
247
|
-
(integration) => integration.name === integrationName,
|
|
248
|
-
);
|
|
249
|
-
if (!integrationPlugin || typeof integrationPlugin.getResolvedIntegrationDependencies !== 'function') {
|
|
250
|
-
continue;
|
|
251
|
-
}
|
|
252
|
-
|
|
253
|
-
dependencies.push(...integrationPlugin.getResolvedIntegrationDependencies());
|
|
254
|
-
}
|
|
255
|
-
|
|
256
|
-
return dependencies;
|
|
257
|
-
}
|
|
258
|
-
|
|
259
|
-
/**
|
|
260
|
-
* Discovers integration names referenced by the component dependency graph.
|
|
261
|
-
*
|
|
262
|
-
* @param components Root component set.
|
|
263
|
-
* @param seen Internal visited set for shared graphs.
|
|
264
|
-
* @returns Set of integration names found in the graph.
|
|
265
|
-
*/
|
|
266
|
-
private collectIntegrationNames(
|
|
267
|
-
components: (EcoComponent | Partial<EcoComponent>)[],
|
|
268
|
-
seen = new Set<object>(),
|
|
269
|
-
): Set<string> {
|
|
270
|
-
const integrationNames = new Set<string>();
|
|
271
|
-
|
|
272
|
-
for (const comp of components) {
|
|
273
|
-
const ecoComp = comp as EcoComponent;
|
|
274
|
-
if (seen.has(ecoComp)) {
|
|
275
|
-
continue;
|
|
276
|
-
}
|
|
277
|
-
seen.add(ecoComp);
|
|
278
|
-
|
|
279
|
-
const integrationName = ecoComp.config?.integration ?? ecoComp.config?.__eco?.integration;
|
|
280
|
-
if (integrationName) {
|
|
281
|
-
integrationNames.add(integrationName);
|
|
282
|
-
}
|
|
283
|
-
|
|
284
|
-
const nested = ecoComp.config?.dependencies?.components;
|
|
285
|
-
if (nested?.length) {
|
|
286
|
-
const nestedNames = this.collectIntegrationNames(nested, seen);
|
|
287
|
-
for (const nestedName of nestedNames) {
|
|
288
|
-
integrationNames.add(nestedName);
|
|
289
|
-
}
|
|
290
|
-
}
|
|
291
|
-
}
|
|
292
|
-
|
|
293
|
-
return integrationNames;
|
|
294
|
-
}
|
|
295
|
-
|
|
296
|
-
/**
|
|
297
|
-
* Renders the page root through the component-level render contract so any
|
|
298
|
-
* integration-specific assets and root attributes are available before the main
|
|
299
|
-
* document render.
|
|
300
|
-
*
|
|
301
|
-
* @param input Page root render inputs.
|
|
302
|
-
* @returns Structured component render result.
|
|
303
|
-
*/
|
|
304
|
-
private async renderPageRoot(input: {
|
|
305
|
-
currentIntegrationName: string;
|
|
306
|
-
Page: EcoComponent;
|
|
307
|
-
props: Record<string, unknown>;
|
|
308
|
-
routeOptions: RouteRendererOptions;
|
|
309
|
-
callbacks: RenderPreparationCallbacks;
|
|
310
|
-
}): Promise<ComponentRenderResult> {
|
|
311
|
-
const execution = await runWithComponentRenderContext(
|
|
312
|
-
{
|
|
313
|
-
currentIntegration: input.currentIntegrationName,
|
|
314
|
-
boundaryContext: input.callbacks.getComponentRenderBoundaryContext(),
|
|
315
|
-
},
|
|
316
|
-
async () =>
|
|
317
|
-
input.callbacks.renderPageComponent({
|
|
318
|
-
component: input.Page,
|
|
319
|
-
props: {
|
|
320
|
-
...input.props,
|
|
321
|
-
params: input.routeOptions.params || {},
|
|
322
|
-
query: input.routeOptions.query || {},
|
|
323
|
-
},
|
|
324
|
-
}),
|
|
325
|
-
);
|
|
326
|
-
|
|
327
|
-
return execution.value;
|
|
328
|
-
}
|
|
329
|
-
|
|
330
|
-
/**
|
|
331
|
-
* Builds the runtime assets needed to bootstrap global lazy trigger execution.
|
|
332
|
-
*
|
|
333
|
-
* @param triggers Fully resolved lazy trigger definitions.
|
|
334
|
-
* @returns Processed assets that should be merged into the final dependency set.
|
|
335
|
-
*/
|
|
336
|
-
private async buildGlobalInjectorAssets(
|
|
337
|
-
triggers: ResolvedLazyTrigger[],
|
|
338
|
-
currentIntegrationName: string,
|
|
339
|
-
): Promise<ProcessedAsset[]> {
|
|
340
|
-
const globalInjectorImportPath = coreRequire.resolve('@ecopages/scripts-injector/global');
|
|
341
|
-
const globalInjectorRuntimeAsset = AssetFactory.createNodeModuleScript({
|
|
342
|
-
position: 'head',
|
|
343
|
-
name: 'ecopages-scripts-injector-global',
|
|
344
|
-
importPath: globalInjectorImportPath,
|
|
345
|
-
excludeFromHtml: true,
|
|
346
|
-
});
|
|
347
|
-
|
|
348
|
-
const [globalInjectorRuntimeProcessed] = await this.assetProcessingService.processDependencies(
|
|
349
|
-
[globalInjectorRuntimeAsset],
|
|
350
|
-
currentIntegrationName,
|
|
351
|
-
);
|
|
352
|
-
|
|
353
|
-
const globalInjectorModuleUrl = globalInjectorRuntimeProcessed?.srcUrl;
|
|
354
|
-
if (!globalInjectorModuleUrl) {
|
|
355
|
-
throw new Error('[ecopages] Failed to resolve global injector runtime asset URL.');
|
|
356
|
-
}
|
|
357
|
-
|
|
358
|
-
const mapScript = AssetFactory.createInlineContentScript({
|
|
359
|
-
position: 'head',
|
|
360
|
-
name: 'ecopages-global-injector-map',
|
|
361
|
-
content: buildGlobalInjectorMapScript(triggers),
|
|
362
|
-
attributes: { type: 'ecopages/global-injector-map' },
|
|
363
|
-
bundle: false,
|
|
364
|
-
});
|
|
365
|
-
const bootstrapScript = AssetFactory.createContentScript({
|
|
366
|
-
position: 'head',
|
|
367
|
-
name: 'ecopages-global-injector-bootstrap',
|
|
368
|
-
content: buildGlobalInjectorBootstrapContent(globalInjectorModuleUrl),
|
|
369
|
-
attributes: { type: 'module' },
|
|
370
|
-
bundle: false,
|
|
371
|
-
});
|
|
372
|
-
|
|
373
|
-
return this.assetProcessingService.processDependencies(
|
|
374
|
-
[mapScript, bootstrapScript, globalInjectorRuntimeAsset],
|
|
375
|
-
currentIntegrationName,
|
|
376
|
-
);
|
|
377
|
-
}
|
|
378
|
-
|
|
379
|
-
private async buildEagerSsrLazyAssets(
|
|
380
|
-
components: (EcoComponent | Partial<EcoComponent>)[],
|
|
381
|
-
currentIntegrationName: string,
|
|
382
|
-
): Promise<ProcessedAsset[]> {
|
|
383
|
-
const dependencies = this.collectEagerSsrLazyDependencies(components);
|
|
384
|
-
if (dependencies.length === 0) {
|
|
385
|
-
return [];
|
|
386
|
-
}
|
|
387
|
-
|
|
388
|
-
return this.assetProcessingService.processDependencies(dependencies, `${currentIntegrationName}:ssr-lazy`);
|
|
389
|
-
}
|
|
390
|
-
|
|
391
|
-
private collectEagerSsrLazyDependencies(
|
|
392
|
-
components: (EcoComponent | Partial<EcoComponent>)[],
|
|
393
|
-
): ReturnType<AssetProcessingService['processDependencies']> extends Promise<infer _>
|
|
394
|
-
? Parameters<AssetProcessingService['processDependencies']>[0]
|
|
395
|
-
: never {
|
|
396
|
-
const dependencies = [] as Parameters<AssetProcessingService['processDependencies']>[0];
|
|
397
|
-
const visitedConfigs = new Set<EcoComponentConfig>();
|
|
398
|
-
const seenKeys = new Set<string>();
|
|
399
|
-
|
|
400
|
-
const normalizeAttributes = (attributes?: DependencyAttributes) => ({
|
|
401
|
-
type: 'module',
|
|
402
|
-
defer: '',
|
|
403
|
-
...(attributes ?? {}),
|
|
404
|
-
});
|
|
405
|
-
|
|
406
|
-
const collect = (config?: EcoComponentConfig) => {
|
|
407
|
-
if (!config || visitedConfigs.has(config)) {
|
|
408
|
-
return;
|
|
409
|
-
}
|
|
410
|
-
|
|
411
|
-
visitedConfigs.add(config);
|
|
412
|
-
|
|
413
|
-
const componentFile = config.__eco?.file;
|
|
414
|
-
if (componentFile) {
|
|
415
|
-
const componentDir = coreRequire('node:path').dirname(componentFile);
|
|
416
|
-
for (const script of config.dependencies?.scripts ?? []) {
|
|
417
|
-
if (typeof script === 'string' || !script.lazy || script.ssr !== true) {
|
|
418
|
-
continue;
|
|
419
|
-
}
|
|
420
|
-
|
|
421
|
-
const attributes = normalizeAttributes(script.attributes);
|
|
422
|
-
|
|
423
|
-
if (script.content) {
|
|
424
|
-
const key = `content:${script.content}:${JSON.stringify(attributes)}`;
|
|
425
|
-
if (seenKeys.has(key)) {
|
|
426
|
-
continue;
|
|
427
|
-
}
|
|
428
|
-
|
|
429
|
-
seenKeys.add(key);
|
|
430
|
-
dependencies.push(
|
|
431
|
-
AssetFactory.createContentScript({
|
|
432
|
-
position: 'head',
|
|
433
|
-
content: script.content,
|
|
434
|
-
attributes,
|
|
435
|
-
}),
|
|
436
|
-
);
|
|
437
|
-
continue;
|
|
438
|
-
}
|
|
439
|
-
|
|
440
|
-
if (!script.src) {
|
|
441
|
-
continue;
|
|
442
|
-
}
|
|
443
|
-
|
|
444
|
-
const resolvedPath = coreRequire('node:path').resolve(componentDir, script.src);
|
|
445
|
-
const key = `file:${resolvedPath}:${JSON.stringify(attributes)}`;
|
|
446
|
-
if (seenKeys.has(key)) {
|
|
447
|
-
continue;
|
|
448
|
-
}
|
|
449
|
-
|
|
450
|
-
seenKeys.add(key);
|
|
451
|
-
dependencies.push(
|
|
452
|
-
AssetFactory.createFileScript({
|
|
453
|
-
filepath: resolvedPath,
|
|
454
|
-
position: 'head',
|
|
455
|
-
attributes,
|
|
456
|
-
}),
|
|
457
|
-
);
|
|
458
|
-
}
|
|
459
|
-
}
|
|
460
|
-
|
|
461
|
-
if (config.layout?.config) {
|
|
462
|
-
collect(config.layout.config);
|
|
463
|
-
}
|
|
464
|
-
|
|
465
|
-
for (const nestedComponent of config.dependencies?.components ?? []) {
|
|
466
|
-
collect(nestedComponent?.config);
|
|
467
|
-
}
|
|
468
|
-
};
|
|
469
|
-
|
|
470
|
-
for (const component of components) {
|
|
471
|
-
collect(component.config);
|
|
472
|
-
}
|
|
473
|
-
|
|
474
|
-
return dependencies;
|
|
475
|
-
}
|
|
476
|
-
}
|