@ecopages/core 0.2.0-alpha.27 → 0.2.0-alpha.28
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 +91 -0
- package/package.json +162 -72
- package/src/adapters/abstract/application-adapter.d.ts +194 -0
- package/src/adapters/abstract/application-adapter.js +121 -0
- package/src/adapters/abstract/router-adapter.d.ts +26 -0
- package/src/adapters/abstract/router-adapter.js +5 -0
- package/src/adapters/abstract/server-adapter.d.ts +69 -0
- package/src/adapters/abstract/server-adapter.js +15 -0
- package/src/adapters/bun/client-bridge.d.ts +34 -0
- package/src/adapters/bun/client-bridge.js +48 -0
- package/src/adapters/bun/create-app.d.ts +53 -0
- package/src/adapters/bun/create-app.js +153 -0
- package/src/adapters/bun/hmr-manager.d.ts +131 -0
- package/src/adapters/bun/hmr-manager.js +312 -0
- package/src/adapters/bun/index.d.ts +2 -0
- package/src/adapters/bun/index.js +8 -0
- package/src/adapters/bun/server-adapter.d.ts +155 -0
- package/src/adapters/bun/server-adapter.js +393 -0
- package/src/adapters/bun/server-lifecycle.d.ts +63 -0
- package/src/adapters/bun/server-lifecycle.js +92 -0
- package/src/adapters/create-app.d.ts +20 -0
- package/src/adapters/create-app.js +66 -0
- package/src/adapters/index.d.ts +2 -0
- package/src/adapters/index.js +8 -0
- package/src/adapters/node/create-app.d.ts +18 -0
- package/src/adapters/node/create-app.js +149 -0
- package/src/adapters/node/node-client-bridge.d.ts +26 -0
- package/src/adapters/node/node-client-bridge.js +66 -0
- package/src/adapters/node/node-hmr-manager.d.ts +121 -0
- package/src/adapters/node/node-hmr-manager.js +290 -0
- package/src/adapters/node/server-adapter.d.ts +162 -0
- package/src/adapters/node/server-adapter.js +368 -0
- package/src/adapters/node/static-content-server.d.ts +60 -0
- package/src/adapters/node/static-content-server.js +194 -0
- package/src/adapters/shared/api-response.d.ts +52 -0
- package/src/adapters/shared/api-response.js +96 -0
- package/src/adapters/shared/application-adapter.d.ts +18 -0
- package/src/adapters/shared/application-adapter.js +90 -0
- package/src/adapters/shared/define-api-handler.d.ts +25 -0
- package/src/adapters/shared/define-api-handler.js +15 -0
- package/src/adapters/shared/explicit-static-render-preparation.d.ts +25 -0
- package/src/adapters/shared/explicit-static-render-preparation.js +26 -0
- package/src/adapters/shared/explicit-static-route-matcher.d.ts +41 -0
- package/src/adapters/shared/explicit-static-route-matcher.js +101 -0
- package/src/adapters/shared/file-route-middleware-pipeline.d.ts +62 -0
- package/src/adapters/shared/file-route-middleware-pipeline.js +90 -0
- package/src/adapters/shared/fs-server-response-factory.d.ts +23 -0
- package/src/adapters/shared/fs-server-response-factory.js +81 -0
- package/src/adapters/shared/fs-server-response-matcher.d.ts +75 -0
- package/src/adapters/shared/fs-server-response-matcher.js +186 -0
- package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
- package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
- package/src/adapters/shared/hmr-html-response.d.ts +22 -0
- package/src/adapters/shared/hmr-html-response.js +32 -0
- package/src/adapters/shared/render-context.d.ts +15 -0
- package/src/adapters/shared/render-context.js +72 -0
- package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
- package/src/adapters/shared/runtime-bootstrap.js +43 -0
- package/src/adapters/shared/server-adapter.d.ts +108 -0
- package/src/adapters/shared/server-adapter.js +429 -0
- package/src/adapters/shared/server-route-handler.d.ts +89 -0
- package/src/adapters/shared/server-route-handler.js +111 -0
- package/src/adapters/shared/server-static-builder.d.ts +71 -0
- package/src/adapters/shared/server-static-builder.js +100 -0
- package/src/build/build-adapter.d.ts +239 -0
- package/src/build/build-adapter.js +642 -0
- package/src/build/build-manifest.d.ts +27 -0
- package/src/build/build-manifest.js +30 -0
- package/src/build/build-types.d.ts +57 -0
- package/src/build/build-types.js +0 -0
- package/src/build/dev-build-coordinator.d.ts +72 -0
- package/src/build/dev-build-coordinator.js +154 -0
- package/src/build/esbuild-build-adapter.d.ts +78 -0
- package/src/build/esbuild-build-adapter.js +505 -0
- package/src/build/runtime-build-executor.d.ts +14 -0
- package/src/build/runtime-build-executor.js +22 -0
- package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
- package/src/build/runtime-specifier-alias-plugin.js +35 -0
- package/src/build/runtime-specifier-aliases.d.ts +5 -0
- package/src/build/runtime-specifier-aliases.js +95 -0
- package/src/config/config-builder.d.ts +252 -0
- package/src/config/config-builder.js +598 -0
- package/src/config/{constants.ts → constants.d.ts} +13 -22
- package/src/config/constants.js +25 -0
- package/src/dev/host-runtime.d.ts +10 -0
- package/src/dev/host-runtime.js +24 -0
- package/src/dev/sc-server.d.ts +30 -0
- package/src/dev/sc-server.js +111 -0
- package/src/eco/eco.browser.d.ts +2 -0
- package/src/eco/eco.browser.js +83 -0
- package/src/eco/eco.d.ts +9 -0
- package/src/eco/eco.js +85 -0
- package/src/eco/eco.types.d.ts +178 -0
- package/src/eco/eco.types.js +0 -0
- package/src/eco/eco.utils.d.ts +1 -0
- package/src/eco/eco.utils.js +10 -0
- package/src/eco/global-injector-map.d.ts +16 -0
- package/src/eco/global-injector-map.js +80 -0
- package/src/eco/lazy-injector-map.d.ts +8 -0
- package/src/eco/lazy-injector-map.js +70 -0
- package/src/eco/module-dependencies.d.ts +18 -0
- package/src/eco/module-dependencies.js +49 -0
- package/src/errors/http-error.d.ts +31 -0
- package/src/errors/http-error.js +50 -0
- package/src/errors/index.d.ts +3 -0
- package/src/errors/index.js +6 -0
- package/src/errors/locals-access-error.d.ts +4 -0
- package/src/errors/locals-access-error.js +9 -0
- package/src/global/app-logger.d.ts +2 -0
- package/src/global/app-logger.js +6 -0
- package/src/hmr/client/hmr-runtime.d.ts +5 -0
- package/src/hmr/client/hmr-runtime.js +117 -0
- package/src/hmr/hmr-strategy.d.ts +162 -0
- package/src/hmr/hmr-strategy.js +44 -0
- package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
- package/src/hmr/hmr.postcss.test.e2e.js +31 -0
- package/src/hmr/hmr.test.e2e.d.ts +1 -0
- package/src/hmr/hmr.test.e2e.js +43 -0
- package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
- package/src/hmr/strategies/default-hmr-strategy.js +34 -0
- package/src/hmr/strategies/js-hmr-strategy.d.ts +134 -0
- package/src/hmr/strategies/js-hmr-strategy.js +178 -0
- package/src/index.browser.d.ts +3 -0
- package/src/index.browser.js +4 -0
- package/src/index.d.ts +6 -0
- package/src/index.js +21 -0
- package/src/integrations/ghtml/ghtml-renderer.d.ts +16 -0
- package/src/integrations/ghtml/ghtml-renderer.js +57 -0
- package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
- package/src/integrations/ghtml/ghtml.constants.js +4 -0
- package/src/integrations/ghtml/ghtml.plugin.d.ts +16 -0
- package/src/integrations/ghtml/ghtml.plugin.js +20 -0
- package/src/plugins/alias-resolver-plugin.d.ts +2 -0
- package/src/plugins/alias-resolver-plugin.js +53 -0
- package/src/plugins/eco-component-meta-plugin.d.ts +108 -0
- package/src/plugins/eco-component-meta-plugin.js +162 -0
- 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 +215 -0
- package/src/plugins/integration-plugin.js +189 -0
- package/src/plugins/processor.d.ts +97 -0
- package/src/plugins/processor.js +141 -0
- package/src/plugins/{runtime-capability.ts → runtime-capability.d.ts} +3 -8
- package/src/plugins/runtime-capability.js +0 -0
- package/src/plugins/source-transform.d.ts +46 -0
- package/src/plugins/source-transform.js +71 -0
- package/src/route-renderer/orchestration/component-render-context.d.ts +89 -0
- package/src/route-renderer/orchestration/component-render-context.js +147 -0
- package/src/route-renderer/orchestration/declared-ownership-graph.d.ts +18 -0
- package/src/route-renderer/orchestration/declared-ownership-graph.js +34 -0
- package/src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts +108 -0
- package/src/route-renderer/orchestration/foreign-subtree-execution.service.js +206 -0
- package/src/route-renderer/orchestration/integration-renderer.d.ts +516 -0
- package/src/route-renderer/orchestration/integration-renderer.js +909 -0
- package/src/route-renderer/orchestration/ownership-planning.service.d.ts +24 -0
- package/src/route-renderer/orchestration/ownership-planning.service.js +63 -0
- package/src/route-renderer/orchestration/ownership-validation.service.d.ts +29 -0
- package/src/route-renderer/orchestration/ownership-validation.service.js +53 -0
- package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +2 -0
- package/src/route-renderer/orchestration/processed-asset-dedupe.js +23 -0
- package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.d.ts +90 -0
- package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.js +158 -0
- package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
- package/src/route-renderer/orchestration/render-output.utils.js +171 -0
- package/src/route-renderer/orchestration/route-render-orchestrator.d.ts +120 -0
- package/src/route-renderer/orchestration/route-render-orchestrator.js +388 -0
- 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/component-dependency-collection.d.ts +37 -0
- package/src/route-renderer/page-loading/component-dependency-collection.js +132 -0
- package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
- package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
- package/src/route-renderer/page-loading/dependency-resolver.d.ts +35 -0
- package/src/route-renderer/page-loading/dependency-resolver.js +115 -0
- package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
- package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
- package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
- package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
- package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
- package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
- package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
- package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
- package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
- package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
- package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
- package/src/route-renderer/page-loading/page-dependency-bundling.js +137 -0
- package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
- package/src/route-renderer/page-loading/page-module-loader.js +127 -0
- package/src/route-renderer/route-renderer.d.ts +69 -0
- package/src/route-renderer/route-renderer.js +80 -0
- package/src/router/client/link-intent.js +34 -0
- package/src/router/client/link-intent.test.browser.d.ts +1 -0
- package/src/router/client/link-intent.test.browser.js +43 -0
- package/src/router/client/navigation-coordinator.d.ts +169 -0
- package/src/router/client/navigation-coordinator.js +215 -0
- package/src/router/server/route-registry.d.ts +78 -0
- package/src/router/server/route-registry.js +262 -0
- package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
- package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
- package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +103 -0
- package/src/services/assets/asset-processing-service/asset-processing.service.js +285 -0
- package/src/services/assets/asset-processing-service/asset.factory.d.ts +17 -0
- package/src/services/assets/asset-processing-service/asset.factory.js +82 -0
- package/src/services/assets/asset-processing-service/assets.types.d.ts +103 -0
- package/src/services/assets/asset-processing-service/assets.types.js +0 -0
- package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
- package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +49 -0
- package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
- package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
- package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
- package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
- package/src/services/assets/asset-processing-service/index.d.ts +6 -0
- package/src/services/assets/asset-processing-service/index.js +6 -0
- package/src/services/assets/asset-processing-service/page-package.d.ts +3 -0
- package/src/services/assets/asset-processing-service/page-package.js +74 -0
- package/src/services/assets/asset-processing-service/{processor.interface.ts → processor.interface.d.ts} +5 -10
- package/src/services/assets/asset-processing-service/processor.interface.js +6 -0
- package/src/services/assets/asset-processing-service/processor.registry.d.ts +8 -0
- package/src/services/assets/asset-processing-service/processor.registry.js +15 -0
- package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +24 -0
- package/src/services/assets/asset-processing-service/processors/base/base-processor.js +65 -0
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +22 -0
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +136 -0
- package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
- package/src/services/assets/asset-processing-service/processors/index.js +5 -0
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +6 -0
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +119 -0
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +9 -0
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +97 -0
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +79 -0
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +8 -0
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +59 -0
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +69 -0
- package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
- package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
- package/src/services/assets/browser-bundle.service.d.ts +73 -0
- package/src/services/assets/browser-bundle.service.js +41 -0
- package/src/services/cache/cache.types.d.ts +107 -0
- package/src/services/cache/cache.types.js +0 -0
- package/src/services/cache/index.d.ts +7 -0
- package/src/services/cache/index.js +7 -0
- package/src/services/cache/memory-cache-store.d.ts +42 -0
- package/src/services/cache/memory-cache-store.js +98 -0
- package/src/services/cache/page-cache-service.d.ts +70 -0
- package/src/services/cache/page-cache-service.js +152 -0
- package/src/services/cache/page-request-cache-coordinator.service.d.ts +75 -0
- package/src/services/cache/page-request-cache-coordinator.service.js +109 -0
- package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
- package/src/services/html/html-rewriter-provider.service.js +68 -0
- package/src/services/html/html-transformer.service.d.ts +87 -0
- package/src/services/html/html-transformer.service.js +216 -0
- package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
- package/src/services/invalidation/development-invalidation.service.js +190 -0
- package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
- package/src/services/module-loading/app-module-loader.service.js +0 -0
- package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
- package/src/services/module-loading/app-server-module-transpiler.service.js +115 -0
- 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.ts → module-loading-types.d.ts} +0 -1
- package/src/services/module-loading/module-loading-types.js +0 -0
- package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
- package/src/services/module-loading/node-bootstrap-plugin.js +216 -0
- package/src/services/module-loading/page-module-import.service.d.ts +76 -0
- package/src/services/module-loading/page-module-import.service.js +170 -0
- package/src/services/module-loading/server-module-transpiler.service.d.ts +63 -0
- package/src/services/module-loading/server-module-transpiler.service.js +64 -0
- package/src/services/module-loading/source-module-support.d.ts +5 -0
- package/src/services/module-loading/source-module-support.js +8 -0
- package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
- package/src/services/runtime-state/dev-graph.service.js +162 -0
- package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
- package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
- package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
- package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
- package/src/services/validation/schema-validation-service.d.ts +122 -0
- package/src/services/validation/schema-validation-service.js +101 -0
- package/src/services/validation/{standard-schema.types.ts → standard-schema.types.d.ts} +17 -20
- package/src/services/validation/standard-schema.types.js +0 -0
- package/src/static-site-generator/static-site-generator.d.ts +104 -0
- package/src/static-site-generator/static-site-generator.js +316 -0
- package/src/types/internal-types.d.ts +232 -0
- package/src/types/internal-types.js +0 -0
- package/src/types/public-types.d.ts +1267 -0
- package/src/types/public-types.js +0 -0
- package/src/utils/deep-merge.d.ts +14 -0
- package/src/utils/deep-merge.js +32 -0
- package/src/utils/hash.d.ts +1 -0
- package/src/utils/hash.js +7 -0
- package/src/utils/html-escaping.d.ts +7 -0
- package/src/utils/html-escaping.js +6 -0
- package/src/utils/html.js +4 -0
- package/src/utils/invariant.d.ts +5 -0
- package/src/utils/invariant.js +11 -0
- package/src/utils/locals-utils.d.ts +15 -0
- package/src/utils/locals-utils.js +24 -0
- package/src/utils/parse-cli-args.d.ts +27 -0
- package/src/utils/parse-cli-args.js +62 -0
- package/src/utils/path-utils.module.d.ts +5 -0
- package/src/utils/path-utils.module.js +14 -0
- package/src/utils/resolve-work-dir.d.ts +11 -0
- package/src/utils/resolve-work-dir.js +31 -0
- package/src/utils/runtime.d.ts +11 -0
- package/src/utils/runtime.js +40 -0
- package/src/utils/server-utils.module.d.ts +19 -0
- package/src/utils/server-utils.module.js +56 -0
- package/src/watchers/project-watcher.d.ts +136 -0
- package/src/watchers/project-watcher.js +275 -0
- package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
- package/src/watchers/project-watcher.test-helpers.js +52 -0
- package/src/adapters/abstract/application-adapter.test.ts +0 -172
- package/src/adapters/abstract/application-adapter.ts +0 -379
- 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 -232
- package/src/adapters/bun/hmr-manager.test.ts +0 -265
- package/src/adapters/bun/hmr-manager.ts +0 -383
- package/src/adapters/bun/index.ts +0 -2
- package/src/adapters/bun/server-adapter.ts +0 -526
- package/src/adapters/bun/server-lifecycle.ts +0 -124
- package/src/adapters/create-app.test.ts +0 -10
- package/src/adapters/create-app.ts +0 -91
- package/src/adapters/index.ts +0 -2
- package/src/adapters/node/create-app.test.ts +0 -53
- package/src/adapters/node/create-app.ts +0 -183
- package/src/adapters/node/node-client-bridge.test.ts +0 -198
- package/src/adapters/node/node-client-bridge.ts +0 -79
- package/src/adapters/node/node-hmr-manager.test.ts +0 -320
- package/src/adapters/node/node-hmr-manager.ts +0 -355
- package/src/adapters/node/server-adapter.ts +0 -502
- package/src/adapters/node/static-content-server.test.ts +0 -60
- package/src/adapters/node/static-content-server.ts +0 -239
- package/src/adapters/shared/api-response.test.ts +0 -97
- 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-render-preparation.ts +0 -58
- package/src/adapters/shared/explicit-static-route-matcher.test.ts +0 -381
- package/src/adapters/shared/explicit-static-route-matcher.ts +0 -131
- package/src/adapters/shared/file-route-middleware-pipeline.test.ts +0 -85
- package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -118
- package/src/adapters/shared/fs-server-response-factory.test.ts +0 -176
- package/src/adapters/shared/fs-server-response-factory.ts +0 -96
- package/src/adapters/shared/fs-server-response-matcher.test.ts +0 -311
- package/src/adapters/shared/fs-server-response-matcher.ts +0 -240
- package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
- package/src/adapters/shared/hmr-html-response.ts +0 -52
- package/src/adapters/shared/hmr-manager.contract.test.ts +0 -228
- package/src/adapters/shared/hmr-manager.dispatch.test.ts +0 -220
- package/src/adapters/shared/render-context.test.ts +0 -150
- package/src/adapters/shared/render-context.ts +0 -123
- package/src/adapters/shared/runtime-bootstrap.ts +0 -79
- package/src/adapters/shared/server-adapter.test.ts +0 -130
- package/src/adapters/shared/server-adapter.ts +0 -562
- package/src/adapters/shared/server-route-handler.test.ts +0 -111
- package/src/adapters/shared/server-route-handler.ts +0 -153
- package/src/adapters/shared/server-static-builder.test.ts +0 -338
- package/src/adapters/shared/server-static-builder.ts +0 -170
- package/src/build/build-adapter-serialization.test.ts +0 -281
- package/src/build/build-adapter.test.ts +0 -1240
- package/src/build/build-adapter.ts +0 -1012
- package/src/build/build-manifest.ts +0 -54
- package/src/build/build-types.ts +0 -83
- package/src/build/dev-build-coordinator.ts +0 -220
- package/src/build/esbuild-build-adapter.ts +0 -660
- package/src/build/runtime-build-executor.test.ts +0 -81
- package/src/build/runtime-build-executor.ts +0 -40
- package/src/build/runtime-specifier-alias-plugin.test.ts +0 -67
- package/src/build/runtime-specifier-alias-plugin.ts +0 -62
- package/src/build/runtime-specifier-aliases.ts +0 -135
- package/src/config/config-builder.test.ts +0 -442
- package/src/config/config-builder.ts +0 -737
- package/src/config/config-builder.typecheck.test.ts +0 -96
- package/src/dev/host-runtime.ts +0 -34
- package/src/dev/sc-server.ts +0 -143
- package/src/eco/eco.browser.test.ts +0 -43
- package/src/eco/eco.browser.ts +0 -118
- package/src/eco/eco.test.ts +0 -654
- package/src/eco/eco.ts +0 -205
- package/src/eco/eco.types.ts +0 -221
- package/src/eco/eco.utils.test.ts +0 -219
- package/src/eco/eco.utils.ts +0 -5
- package/src/eco/global-injector-map.test.ts +0 -42
- package/src/eco/global-injector-map.ts +0 -112
- package/src/eco/lazy-injector-map.test.ts +0 -66
- package/src/eco/lazy-injector-map.ts +0 -120
- package/src/eco/module-dependencies.test.ts +0 -30
- package/src/eco/module-dependencies.ts +0 -75
- package/src/errors/http-error.test.ts +0 -134
- package/src/errors/http-error.ts +0 -72
- package/src/errors/index.ts +0 -3
- package/src/errors/locals-access-error.ts +0 -7
- package/src/global/app-logger.ts +0 -4
- package/src/global/utils.test.ts +0 -12
- 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
- package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
- package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
- package/src/hmr/client/hmr-runtime.ts +0 -162
- package/src/hmr/hmr-strategy.test.ts +0 -124
- package/src/hmr/hmr-strategy.ts +0 -177
- 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.test.ts +0 -334
- package/src/hmr/strategies/js-hmr-strategy.ts +0 -314
- package/src/index.browser.ts +0 -3
- package/src/index.ts +0 -15
- package/src/integrations/ghtml/ghtml-renderer.test.ts +0 -253
- package/src/integrations/ghtml/ghtml-renderer.ts +0 -87
- package/src/integrations/ghtml/ghtml.constants.ts +0 -1
- package/src/integrations/ghtml/ghtml.plugin.ts +0 -28
- package/src/plugins/alias-resolver-plugin.test.ts +0 -41
- package/src/plugins/alias-resolver-plugin.ts +0 -63
- package/src/plugins/eco-component-meta-plugin.test.ts +0 -406
- package/src/plugins/eco-component-meta-plugin.ts +0 -494
- package/src/plugins/foreign-jsx-override-plugin.test.ts +0 -65
- package/src/plugins/foreign-jsx-override-plugin.ts +0 -67
- package/src/plugins/integration-plugin.test.ts +0 -151
- package/src/plugins/integration-plugin.ts +0 -323
- package/src/plugins/processor.test.ts +0 -148
- package/src/plugins/processor.ts +0 -257
- package/src/plugins/source-transform.test.ts +0 -82
- package/src/plugins/source-transform.ts +0 -123
- package/src/route-renderer/orchestration/component-render-context.ts +0 -325
- package/src/route-renderer/orchestration/declared-ownership-graph.ts +0 -62
- package/src/route-renderer/orchestration/foreign-subtree-execution.service.ts +0 -383
- package/src/route-renderer/orchestration/integration-renderer.test.ts +0 -2085
- package/src/route-renderer/orchestration/integration-renderer.ts +0 -1244
- package/src/route-renderer/orchestration/ownership-planning.service.ts +0 -97
- package/src/route-renderer/orchestration/ownership-validation.service.ts +0 -76
- package/src/route-renderer/orchestration/processed-asset-dedupe.ts +0 -25
- package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.test.ts +0 -324
- package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.ts +0 -294
- package/src/route-renderer/orchestration/render-output.utils.ts +0 -310
- package/src/route-renderer/orchestration/route-render-orchestrator.prepare-render-options.test.ts +0 -644
- package/src/route-renderer/orchestration/route-render-orchestrator.test.ts +0 -265
- package/src/route-renderer/orchestration/route-render-orchestrator.ts +0 -592
- package/src/route-renderer/orchestration/template-serialization.test.ts +0 -110
- package/src/route-renderer/orchestration/template-serialization.ts +0 -117
- package/src/route-renderer/page-loading/component-dependency-collection.ts +0 -202
- package/src/route-renderer/page-loading/declared-asset-collection.ts +0 -153
- package/src/route-renderer/page-loading/dependency-resolver.test.ts +0 -761
- package/src/route-renderer/page-loading/dependency-resolver.ts +0 -144
- package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +0 -75
- package/src/route-renderer/page-loading/lazy-entry-collection.ts +0 -167
- package/src/route-renderer/page-loading/lazy-trigger-planning.ts +0 -74
- package/src/route-renderer/page-loading/module-declaration-aggregation.ts +0 -60
- package/src/route-renderer/page-loading/module-declaration-scripts.ts +0 -16
- package/src/route-renderer/page-loading/page-dependency-bundling.ts +0 -244
- package/src/route-renderer/page-loading/page-module-loader.test.ts +0 -183
- package/src/route-renderer/page-loading/page-module-loader.ts +0 -184
- package/src/route-renderer/route-renderer.ts +0 -133
- 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.test.ts +0 -237
- package/src/router/client/navigation-coordinator.ts +0 -453
- package/src/router/server/route-registry.test.ts +0 -176
- package/src/router/server/route-registry.ts +0 -382
- package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +0 -66
- package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +0 -473
- package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -344
- package/src/services/assets/asset-processing-service/asset.factory.test.ts +0 -63
- package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
- package/src/services/assets/asset-processing-service/assets.types.ts +0 -128
- package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +0 -74
- package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -96
- package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +0 -67
- package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
- package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +0 -104
- package/src/services/assets/asset-processing-service/index.ts +0 -6
- package/src/services/assets/asset-processing-service/page-package.test.ts +0 -100
- package/src/services/assets/asset-processing-service/page-package.ts +0 -93
- package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
- package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +0 -59
- package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -83
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -173
- package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +0 -195
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -137
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +0 -326
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -116
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +0 -227
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -89
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +0 -261
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -72
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -83
- package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +0 -65
- package/src/services/assets/browser-bundle.service.test.ts +0 -66
- package/src/services/assets/browser-bundle.service.ts +0 -109
- package/src/services/cache/cache.types.ts +0 -126
- package/src/services/cache/index.ts +0 -18
- package/src/services/cache/memory-cache-store.test.ts +0 -225
- package/src/services/cache/memory-cache-store.ts +0 -130
- package/src/services/cache/page-cache-service.test.ts +0 -175
- package/src/services/cache/page-cache-service.ts +0 -202
- package/src/services/cache/page-request-cache-coordinator.service.test.ts +0 -79
- package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
- package/src/services/html/html-rewriter-provider.service.test.ts +0 -183
- package/src/services/html/html-rewriter-provider.service.ts +0 -104
- package/src/services/html/html-transformer.service.test.ts +0 -476
- package/src/services/html/html-transformer.service.ts +0 -275
- package/src/services/invalidation/development-invalidation.service.test.ts +0 -87
- package/src/services/invalidation/development-invalidation.service.ts +0 -262
- package/src/services/module-loading/app-module-loader.service.ts +0 -9
- package/src/services/module-loading/app-server-module-transpiler.service.test.ts +0 -130
- package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -141
- package/src/services/module-loading/host-module-loader-registry.ts +0 -15
- package/src/services/module-loading/node-bootstrap-plugin.test.ts +0 -335
- package/src/services/module-loading/node-bootstrap-plugin.ts +0 -311
- package/src/services/module-loading/page-module-import.service.test.ts +0 -504
- package/src/services/module-loading/page-module-import.service.ts +0 -251
- package/src/services/module-loading/server-module-transpiler.service.test.ts +0 -243
- package/src/services/module-loading/server-module-transpiler.service.ts +0 -104
- package/src/services/module-loading/source-module-support.ts +0 -19
- 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/server-invalidation-state.service.ts +0 -68
- package/src/services/validation/schema-validation-service.test.ts +0 -223
- package/src/services/validation/schema-validation-service.ts +0 -204
- package/src/static-site-generator/static-site-generator.test.ts +0 -408
- package/src/static-site-generator/static-site-generator.ts +0 -445
- package/src/types/internal-types.ts +0 -243
- package/src/types/public-types.ts +0 -1459
- package/src/utils/deep-merge.test.ts +0 -114
- package/src/utils/deep-merge.ts +0 -47
- package/src/utils/hash.ts +0 -5
- package/src/utils/html-escaping.ts +0 -9
- package/src/utils/invariant.test.ts +0 -22
- package/src/utils/invariant.ts +0 -15
- package/src/utils/locals-utils.ts +0 -37
- package/src/utils/parse-cli-args.test.ts +0 -69
- package/src/utils/parse-cli-args.ts +0 -105
- package/src/utils/path-utils.module.ts +0 -14
- package/src/utils/path-utils.test.ts +0 -15
- 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/utils/server-utils.test.ts +0 -38
- package/src/watchers/project-watcher.integration.test.ts +0 -337
- package/src/watchers/project-watcher.test-helpers.ts +0 -42
- package/src/watchers/project-watcher.test.ts +0 -768
- package/src/watchers/project-watcher.ts +0 -357
- /package/src/utils/{html.ts → html.d.ts} +0 -0
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
import { AssetProcessingService } from "../services/assets/asset-processing-service/asset-processing.service.js";
|
|
2
|
+
import { deepMerge } from "../utils/deep-merge.js";
|
|
3
|
+
import { invariant } from "../utils/invariant.js";
|
|
4
|
+
const INTEGRATION_PLUGIN_ERRORS = {
|
|
5
|
+
NOT_INITIALIZED_WITH_APP_CONFIG: "Plugin not initialized with app config",
|
|
6
|
+
NOT_INITIALIZED_WITH_ASSET_SERVICE: "Plugin not initialized with asset dependency service"
|
|
7
|
+
};
|
|
8
|
+
function mergeIntegrationOptions(defaults, overrides) {
|
|
9
|
+
return deepMerge(defaults, overrides);
|
|
10
|
+
}
|
|
11
|
+
function assertIntegrationInvariant(condition, message) {
|
|
12
|
+
invariant(condition, message);
|
|
13
|
+
}
|
|
14
|
+
class IntegrationPlugin {
|
|
15
|
+
name;
|
|
16
|
+
extensions;
|
|
17
|
+
staticBuildStep;
|
|
18
|
+
runtimeCapability;
|
|
19
|
+
jsxImportSource;
|
|
20
|
+
integrationDependencies;
|
|
21
|
+
resolvedIntegrationDependencies = [];
|
|
22
|
+
options;
|
|
23
|
+
appConfig;
|
|
24
|
+
assetProcessingService;
|
|
25
|
+
hmrManager;
|
|
26
|
+
get plugins() {
|
|
27
|
+
return [];
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Returns build plugins that should only apply to browser-oriented bundles.
|
|
31
|
+
*
|
|
32
|
+
* @remarks
|
|
33
|
+
* Browser-only transforms such as runtime import aliasing belong here so they
|
|
34
|
+
* do not affect server bundles or static-page module generation.
|
|
35
|
+
*/
|
|
36
|
+
get browserBuildPlugins() {
|
|
37
|
+
return [];
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Creates the integration with static declaration-only configuration.
|
|
41
|
+
*
|
|
42
|
+
* @remarks
|
|
43
|
+
* Constructors are expected to stay side-effect free. Build-manifest
|
|
44
|
+
* contributions belong in `prepareBuildContributions()` and runtime-only setup
|
|
45
|
+
* belongs in `setup()`.
|
|
46
|
+
*/
|
|
47
|
+
constructor(config) {
|
|
48
|
+
this.name = config.name;
|
|
49
|
+
this.extensions = config.extensions;
|
|
50
|
+
this.integrationDependencies = config.integrationDependencies || [];
|
|
51
|
+
this.staticBuildStep = config.staticBuildStep || "render";
|
|
52
|
+
this.runtimeCapability = config.runtimeCapability;
|
|
53
|
+
this.jsxImportSource = config.jsxImportSource;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Attaches the finalized app config to the integration.
|
|
57
|
+
*
|
|
58
|
+
* Core calls this during config finalization before runtime setup so the
|
|
59
|
+
* integration can resolve asset paths and other app-owned services later.
|
|
60
|
+
*/
|
|
61
|
+
setConfig(appConfig) {
|
|
62
|
+
this.appConfig = appConfig;
|
|
63
|
+
this.initializeAssetDefinitionService();
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Records the runtime origin used for page-module loading and renderer setup.
|
|
67
|
+
*/
|
|
68
|
+
setRuntimeOrigin(runtimeOrigin) {
|
|
69
|
+
this.runtimeOrigin = runtimeOrigin;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Attaches the shared HMR manager and registers integration-owned development hooks.
|
|
73
|
+
*
|
|
74
|
+
* @remarks
|
|
75
|
+
* The default implementation registers the optional integration HMR strategy.
|
|
76
|
+
* Integrations should override this only when they need to extend that shared
|
|
77
|
+
* behavior rather than replace it.
|
|
78
|
+
*/
|
|
79
|
+
setHmrManager(hmrManager) {
|
|
80
|
+
this.hmrManager = hmrManager;
|
|
81
|
+
const strategy = this.getHmrStrategy?.();
|
|
82
|
+
if (strategy) {
|
|
83
|
+
hmrManager.registerStrategy(strategy);
|
|
84
|
+
}
|
|
85
|
+
if (this.assetProcessingService) {
|
|
86
|
+
this.assetProcessingService.setHmrManager(hmrManager);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Creates the asset-processing service used for global integration dependencies.
|
|
91
|
+
*/
|
|
92
|
+
initializeAssetDefinitionService() {
|
|
93
|
+
if (!this.appConfig) throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_APP_CONFIG);
|
|
94
|
+
this.assetProcessingService = AssetProcessingService.createWithDefaultProcessors(this.appConfig);
|
|
95
|
+
if (this.hmrManager) {
|
|
96
|
+
this.assetProcessingService.setHmrManager(this.hmrManager);
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* Returns processed global assets resolved during `setup()`.
|
|
101
|
+
*/
|
|
102
|
+
getResolvedIntegrationDependencies() {
|
|
103
|
+
return this.resolvedIntegrationDependencies;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Creates the shared renderer options owned by core lifecycle setup.
|
|
107
|
+
*/
|
|
108
|
+
createRendererOptions(options) {
|
|
109
|
+
if (!this.appConfig) {
|
|
110
|
+
throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_APP_CONFIG);
|
|
111
|
+
}
|
|
112
|
+
const assetProcessingService = AssetProcessingService.createWithDefaultProcessors(this.appConfig);
|
|
113
|
+
if (this.hmrManager) {
|
|
114
|
+
assetProcessingService.setHmrManager(this.hmrManager);
|
|
115
|
+
}
|
|
116
|
+
return {
|
|
117
|
+
appConfig: this.appConfig,
|
|
118
|
+
assetProcessingService,
|
|
119
|
+
resolvedIntegrationDependencies: this.resolvedIntegrationDependencies,
|
|
120
|
+
rendererModules: options?.rendererModules,
|
|
121
|
+
runtimeOrigin: this.runtimeOrigin
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Attaches runtime-only services after a renderer instance has been created.
|
|
126
|
+
*/
|
|
127
|
+
attachRendererRuntimeServices(renderer) {
|
|
128
|
+
if (typeof renderer.name !== "string" || renderer.name.length === 0) {
|
|
129
|
+
renderer.name = this.name;
|
|
130
|
+
}
|
|
131
|
+
if (this.hmrManager) {
|
|
132
|
+
renderer.setHmrManager(this.hmrManager);
|
|
133
|
+
}
|
|
134
|
+
return renderer;
|
|
135
|
+
}
|
|
136
|
+
/**
|
|
137
|
+
* Instantiates the integration renderer with app-owned services.
|
|
138
|
+
*
|
|
139
|
+
* @remarks
|
|
140
|
+
* Renderers are cheap runtime objects. They receive the finalized app config,
|
|
141
|
+
* a fresh asset-processing service, integration-global processed assets, and
|
|
142
|
+
* any renderer module context supplied by the active runtime.
|
|
143
|
+
renderer.name ||= this.name;
|
|
144
|
+
*/
|
|
145
|
+
initializeRenderer(options) {
|
|
146
|
+
const renderer = new this.renderer(this.createRendererOptions(options));
|
|
147
|
+
renderer.name ||= this.name;
|
|
148
|
+
return this.attachRendererRuntimeServices(renderer);
|
|
149
|
+
}
|
|
150
|
+
/**
|
|
151
|
+
* Prepares build-facing contributions before the app build manifest is sealed.
|
|
152
|
+
*
|
|
153
|
+
* @remarks
|
|
154
|
+
* Integrations can override this when runtime or build plugin declarations must
|
|
155
|
+
* be materialized ahead of runtime startup. Runtime-only side effects stay in
|
|
156
|
+
* `setup()`.
|
|
157
|
+
*/
|
|
158
|
+
async prepareBuildContributions() {
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* Performs runtime-only integration setup after config build has already
|
|
162
|
+
* sealed manifest contributions.
|
|
163
|
+
*/
|
|
164
|
+
async setup() {
|
|
165
|
+
if (this.integrationDependencies.length === 0) return;
|
|
166
|
+
if (!this.assetProcessingService) throw new Error(INTEGRATION_PLUGIN_ERRORS.NOT_INITIALIZED_WITH_ASSET_SERVICE);
|
|
167
|
+
this.resolvedIntegrationDependencies = await this.assetProcessingService.processDependencies(
|
|
168
|
+
this.integrationDependencies,
|
|
169
|
+
this.name
|
|
170
|
+
);
|
|
171
|
+
this.initializeRenderer();
|
|
172
|
+
}
|
|
173
|
+
/**
|
|
174
|
+
* Releases runtime resources owned by the integration.
|
|
175
|
+
*
|
|
176
|
+
* @remarks
|
|
177
|
+
* Most integrations do not need custom teardown. Override this only for
|
|
178
|
+
* explicit cleanup such as watchers, compiler handles, or runtime registries
|
|
179
|
+
* that outlive individual requests.
|
|
180
|
+
*/
|
|
181
|
+
async teardown() {
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
export {
|
|
185
|
+
INTEGRATION_PLUGIN_ERRORS,
|
|
186
|
+
IntegrationPlugin,
|
|
187
|
+
assertIntegrationInvariant,
|
|
188
|
+
mergeIntegrationOptions
|
|
189
|
+
};
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import type { EcoBuildPlugin } from '../build/build-types.js';
|
|
2
|
+
import type { EcoPagesAppConfig, IClientBridge } from '../types/internal-types.js';
|
|
3
|
+
import type { AssetDefinition } from '../services/assets/asset-processing-service/assets.types.js';
|
|
4
|
+
import type { RuntimeCapabilityDeclaration } from './runtime-capability.js';
|
|
5
|
+
export type { RuntimeCapabilityDeclaration, RuntimeCapabilityTag } from './runtime-capability.js';
|
|
6
|
+
export type { EcoBuildLoader, EcoBuildOnLoadArgs, EcoBuildOnLoadResult, EcoBuildOnResolveArgs, EcoBuildOnResolveResult, EcoBuildPlugin, EcoBuildPluginBuilder, } from '../build/build-types.js';
|
|
7
|
+
export declare const PROCESSOR_ERRORS: {
|
|
8
|
+
readonly CACHE_DIRECTORY_NOT_SET: "Cache directory not set in context";
|
|
9
|
+
};
|
|
10
|
+
export declare function mergeProcessorOptions<TDefaults, TOverrides>(defaults: TDefaults, overrides: TOverrides): TDefaults & TOverrides;
|
|
11
|
+
export interface ProcessorWatchContext {
|
|
12
|
+
path: string;
|
|
13
|
+
bridge: IClientBridge;
|
|
14
|
+
}
|
|
15
|
+
export interface ProcessorWatchConfig {
|
|
16
|
+
paths: string[];
|
|
17
|
+
extensions?: string[];
|
|
18
|
+
onCreate?: (ctx: ProcessorWatchContext) => Promise<void>;
|
|
19
|
+
onChange?: (ctx: ProcessorWatchContext) => Promise<void>;
|
|
20
|
+
onDelete?: (ctx: ProcessorWatchContext) => Promise<void>;
|
|
21
|
+
onError?: (error: Error) => void;
|
|
22
|
+
}
|
|
23
|
+
export type ProcessorAssetKind = 'script' | 'stylesheet' | 'image';
|
|
24
|
+
export type ProcessorExtensionPattern = string;
|
|
25
|
+
export interface ProcessorAssetCapability {
|
|
26
|
+
kind: ProcessorAssetKind;
|
|
27
|
+
/**
|
|
28
|
+
* Supported patterns:
|
|
29
|
+
* - `*` (all extensions)
|
|
30
|
+
* - `.css` or `css`
|
|
31
|
+
* - `*.css`
|
|
32
|
+
* - `*.{css,scss,sass}`
|
|
33
|
+
*
|
|
34
|
+
* Pattern matching is case-insensitive and trims surrounding spaces,
|
|
35
|
+
* including grouped values (e.g. `*.{ CSS, ScSs }`).
|
|
36
|
+
*/
|
|
37
|
+
extensions?: ProcessorExtensionPattern[];
|
|
38
|
+
}
|
|
39
|
+
export interface ProcessorConfig<TOptions = Record<string, unknown>> {
|
|
40
|
+
name: string;
|
|
41
|
+
description?: string;
|
|
42
|
+
options?: TOptions;
|
|
43
|
+
watch?: ProcessorWatchConfig;
|
|
44
|
+
capabilities?: ProcessorAssetCapability[];
|
|
45
|
+
runtimeCapability?: RuntimeCapabilityDeclaration;
|
|
46
|
+
}
|
|
47
|
+
export interface ProcessorContext {
|
|
48
|
+
config: EcoPagesAppConfig;
|
|
49
|
+
rootDir: string;
|
|
50
|
+
srcDir: string;
|
|
51
|
+
distDir: string;
|
|
52
|
+
cache?: string;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Interface for processor build plugins
|
|
56
|
+
* This is used to pass plugins to the build process directly from the processor
|
|
57
|
+
* For instance it can become very handy when dealing with virtual modules that needs to be recognized by the bundler
|
|
58
|
+
* i.e. @ecopages/image-processor
|
|
59
|
+
*/
|
|
60
|
+
export declare abstract class Processor<TOptions = Record<string, unknown>> {
|
|
61
|
+
readonly name: string;
|
|
62
|
+
protected dependencies: AssetDefinition[];
|
|
63
|
+
protected context?: ProcessorContext;
|
|
64
|
+
protected options?: TOptions;
|
|
65
|
+
protected watchConfig?: ProcessorWatchConfig;
|
|
66
|
+
protected capabilities: ProcessorAssetCapability[];
|
|
67
|
+
readonly runtimeCapability?: RuntimeCapabilityDeclaration;
|
|
68
|
+
/** Plugins that are only used during the build process */
|
|
69
|
+
abstract buildPlugins?: EcoBuildPlugin[];
|
|
70
|
+
/** Plugins that are used during runtime for file processing */
|
|
71
|
+
abstract plugins?: EcoBuildPlugin[];
|
|
72
|
+
constructor(config: ProcessorConfig<TOptions>);
|
|
73
|
+
setContext(appConfig: EcoPagesAppConfig): void;
|
|
74
|
+
/**
|
|
75
|
+
* Prepares build-facing processor contributions before config finalization.
|
|
76
|
+
*
|
|
77
|
+
* @remarks
|
|
78
|
+
* Override this when a processor must compute runtime/build plugins or other
|
|
79
|
+
* manifest-owned state before startup. Runtime-only work such as cache
|
|
80
|
+
* warming or watcher registration should stay in `setup()`.
|
|
81
|
+
*/
|
|
82
|
+
prepareBuildContributions(): Promise<void>;
|
|
83
|
+
abstract setup(): Promise<void>;
|
|
84
|
+
abstract teardown(): Promise<void>;
|
|
85
|
+
abstract process(input: unknown, filePath?: string): Promise<unknown>;
|
|
86
|
+
protected getCachePath(key: string): string;
|
|
87
|
+
protected readCache<T>(key: string): Promise<T | null>;
|
|
88
|
+
protected writeCache<T>(key: string, data: T): Promise<void>;
|
|
89
|
+
getWatchConfig(): ProcessorWatchConfig | undefined;
|
|
90
|
+
getDependencies(): AssetDefinition[];
|
|
91
|
+
getName(): string;
|
|
92
|
+
getAssetCapabilities(): ProcessorAssetCapability[];
|
|
93
|
+
matchesFileFilter(_filepath: string): boolean;
|
|
94
|
+
canProcessAsset(kind: ProcessorAssetKind, filepath?: string): boolean;
|
|
95
|
+
private matchesCapabilityExtensions;
|
|
96
|
+
private normalizeExtensionPattern;
|
|
97
|
+
}
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import { fileSystem } from "@ecopages/file-system";
|
|
3
|
+
import { DEFAULT_ECOPAGES_WORK_DIR } from "../config/constants.js";
|
|
4
|
+
import { GENERATED_BASE_PATHS } from "../config/constants.js";
|
|
5
|
+
import { deepMerge } from "../utils/deep-merge.js";
|
|
6
|
+
const PROCESSOR_ERRORS = {
|
|
7
|
+
CACHE_DIRECTORY_NOT_SET: "Cache directory not set in context"
|
|
8
|
+
};
|
|
9
|
+
function mergeProcessorOptions(defaults, overrides) {
|
|
10
|
+
return deepMerge(defaults, overrides);
|
|
11
|
+
}
|
|
12
|
+
function resolveGeneratedPath(type, options) {
|
|
13
|
+
const { root, module, subPath } = options;
|
|
14
|
+
const parts = [root, GENERATED_BASE_PATHS[type], module, subPath].filter(Boolean);
|
|
15
|
+
return path.join(...parts);
|
|
16
|
+
}
|
|
17
|
+
class Processor {
|
|
18
|
+
name;
|
|
19
|
+
dependencies = [];
|
|
20
|
+
context;
|
|
21
|
+
options;
|
|
22
|
+
watchConfig;
|
|
23
|
+
capabilities = [];
|
|
24
|
+
runtimeCapability;
|
|
25
|
+
constructor(config) {
|
|
26
|
+
this.name = config.name;
|
|
27
|
+
this.options = config.options;
|
|
28
|
+
this.watchConfig = config.watch;
|
|
29
|
+
this.capabilities = config.capabilities ?? [];
|
|
30
|
+
this.runtimeCapability = config.runtimeCapability;
|
|
31
|
+
}
|
|
32
|
+
setContext(appConfig) {
|
|
33
|
+
const workDir = appConfig.absolutePaths.workDir ?? path.join(appConfig.rootDir, appConfig.workDir ?? DEFAULT_ECOPAGES_WORK_DIR);
|
|
34
|
+
const cachePath = resolveGeneratedPath("cache", {
|
|
35
|
+
root: workDir,
|
|
36
|
+
module: this.name
|
|
37
|
+
});
|
|
38
|
+
fileSystem.ensureDir(cachePath);
|
|
39
|
+
this.context = {
|
|
40
|
+
config: appConfig,
|
|
41
|
+
rootDir: appConfig.rootDir,
|
|
42
|
+
srcDir: appConfig.absolutePaths.srcDir,
|
|
43
|
+
distDir: appConfig.absolutePaths.distDir,
|
|
44
|
+
cache: cachePath
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Prepares build-facing processor contributions before config finalization.
|
|
49
|
+
*
|
|
50
|
+
* @remarks
|
|
51
|
+
* Override this when a processor must compute runtime/build plugins or other
|
|
52
|
+
* manifest-owned state before startup. Runtime-only work such as cache
|
|
53
|
+
* warming or watcher registration should stay in `setup()`.
|
|
54
|
+
*/
|
|
55
|
+
async prepareBuildContributions() {
|
|
56
|
+
}
|
|
57
|
+
getCachePath(key) {
|
|
58
|
+
return `${this.context?.cache}/${key}`;
|
|
59
|
+
}
|
|
60
|
+
async readCache(key) {
|
|
61
|
+
const cachePath = this.getCachePath(key);
|
|
62
|
+
try {
|
|
63
|
+
const data = await fileSystem.readFile(cachePath);
|
|
64
|
+
return JSON.parse(data);
|
|
65
|
+
} catch {
|
|
66
|
+
return null;
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
async writeCache(key, data) {
|
|
70
|
+
if (!this.context?.cache) {
|
|
71
|
+
throw new Error(PROCESSOR_ERRORS.CACHE_DIRECTORY_NOT_SET);
|
|
72
|
+
}
|
|
73
|
+
const cachePath = this.getCachePath(key);
|
|
74
|
+
fileSystem.write(cachePath, JSON.stringify(data, null, 2));
|
|
75
|
+
}
|
|
76
|
+
getWatchConfig() {
|
|
77
|
+
return this.watchConfig;
|
|
78
|
+
}
|
|
79
|
+
getDependencies() {
|
|
80
|
+
return this.dependencies;
|
|
81
|
+
}
|
|
82
|
+
getName() {
|
|
83
|
+
return this.name;
|
|
84
|
+
}
|
|
85
|
+
getAssetCapabilities() {
|
|
86
|
+
return this.capabilities;
|
|
87
|
+
}
|
|
88
|
+
matchesFileFilter(_filepath) {
|
|
89
|
+
return true;
|
|
90
|
+
}
|
|
91
|
+
canProcessAsset(kind, filepath) {
|
|
92
|
+
const capabilities = this.getAssetCapabilities();
|
|
93
|
+
if (capabilities.length === 0) {
|
|
94
|
+
return false;
|
|
95
|
+
}
|
|
96
|
+
const matchingKind = capabilities.filter((capability) => capability.kind === kind);
|
|
97
|
+
if (matchingKind.length === 0) {
|
|
98
|
+
return false;
|
|
99
|
+
}
|
|
100
|
+
if (!filepath) {
|
|
101
|
+
return true;
|
|
102
|
+
}
|
|
103
|
+
return matchingKind.some((capability) => this.matchesCapabilityExtensions(filepath, capability.extensions));
|
|
104
|
+
}
|
|
105
|
+
matchesCapabilityExtensions(filepath, extensions) {
|
|
106
|
+
if (!extensions || extensions.length === 0) {
|
|
107
|
+
return true;
|
|
108
|
+
}
|
|
109
|
+
const normalizedExt = path.extname(filepath).toLowerCase();
|
|
110
|
+
return extensions.some((rawPattern) => {
|
|
111
|
+
const pattern = this.normalizeExtensionPattern(rawPattern);
|
|
112
|
+
if (!pattern) {
|
|
113
|
+
return false;
|
|
114
|
+
}
|
|
115
|
+
if (pattern === "*") {
|
|
116
|
+
return true;
|
|
117
|
+
}
|
|
118
|
+
const groupedMatch = pattern.match(/^\*\.\{(.+)\}$/);
|
|
119
|
+
if (groupedMatch) {
|
|
120
|
+
const groupItems = groupedMatch[1].split(",").map((item) => this.normalizeExtensionPattern(item)).filter(Boolean);
|
|
121
|
+
return groupItems.some((item) => normalizedExt === item || normalizedExt === `.${item}`);
|
|
122
|
+
}
|
|
123
|
+
if (pattern.startsWith("*")) {
|
|
124
|
+
const suffix = pattern.slice(1);
|
|
125
|
+
return normalizedExt.endsWith(suffix);
|
|
126
|
+
}
|
|
127
|
+
if (pattern.startsWith(".")) {
|
|
128
|
+
return normalizedExt === pattern;
|
|
129
|
+
}
|
|
130
|
+
return normalizedExt === `.${pattern}`;
|
|
131
|
+
});
|
|
132
|
+
}
|
|
133
|
+
normalizeExtensionPattern(rawPattern) {
|
|
134
|
+
return rawPattern.trim().toLowerCase();
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
export {
|
|
138
|
+
PROCESSOR_ERRORS,
|
|
139
|
+
Processor,
|
|
140
|
+
mergeProcessorOptions
|
|
141
|
+
};
|
|
@@ -1,14 +1,9 @@
|
|
|
1
|
-
export type RuntimeCapabilityTag =
|
|
2
|
-
| 'bun-only'
|
|
3
|
-
| 'node-compatible'
|
|
4
|
-
| 'requires-native-bun-api'
|
|
5
|
-
| 'requires-node-builtins';
|
|
6
|
-
|
|
1
|
+
export type RuntimeCapabilityTag = 'bun-only' | 'node-compatible' | 'requires-native-bun-api' | 'requires-node-builtins';
|
|
7
2
|
/**
|
|
8
3
|
* Declares the runtime assumptions a plugin makes so config finalization can
|
|
9
4
|
* reject incompatible startup environments before bootstrapping the app.
|
|
10
5
|
*/
|
|
11
6
|
export interface RuntimeCapabilityDeclaration {
|
|
12
|
-
|
|
13
|
-
|
|
7
|
+
tags: RuntimeCapabilityTag[];
|
|
8
|
+
minRuntimeVersion?: string;
|
|
14
9
|
}
|
|
File without changes
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import type { EcoBuildPlugin } from '../build/build-types.js';
|
|
2
|
+
import type { EcoPagesAppConfig } from '../types/internal-types.js';
|
|
3
|
+
export interface EcoSourceTransformResult {
|
|
4
|
+
code: string;
|
|
5
|
+
map?: unknown;
|
|
6
|
+
}
|
|
7
|
+
export interface EcoSourceTransform {
|
|
8
|
+
name: string;
|
|
9
|
+
filter: RegExp;
|
|
10
|
+
enforce?: 'pre' | 'post';
|
|
11
|
+
transform(code: string, id: string): EcoSourceTransformResult | string | undefined;
|
|
12
|
+
}
|
|
13
|
+
export interface EcoViteCompatiblePlugin {
|
|
14
|
+
name: string;
|
|
15
|
+
enforce?: 'pre' | 'post';
|
|
16
|
+
transform(code: string, id: string): EcoSourceTransformResult | string | undefined;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Normalizes bundler module ids so one transform can serve Ecopages loaders,
|
|
20
|
+
* Vite, and future bundler adapters.
|
|
21
|
+
*/
|
|
22
|
+
export declare function normalizeTransformId(id: string): string;
|
|
23
|
+
/**
|
|
24
|
+
* Applies one source transform if the normalized id matches its filter.
|
|
25
|
+
*/
|
|
26
|
+
export declare function applySourceTransform(transform: EcoSourceTransform, code: string, id: string): EcoSourceTransformResult | string | undefined;
|
|
27
|
+
/**
|
|
28
|
+
* Adapts a source transform into the existing Ecopages build-plugin contract.
|
|
29
|
+
*/
|
|
30
|
+
export declare function createEcoBuildPluginFromSourceTransform(transform: EcoSourceTransform): EcoBuildPlugin;
|
|
31
|
+
/**
|
|
32
|
+
* Adapts a source transform into a Vite-compatible plugin object.
|
|
33
|
+
*
|
|
34
|
+
* @remarks
|
|
35
|
+
* This intentionally returns a plain object shape so core does not need a hard
|
|
36
|
+
* dependency on `vite` just to author transform primitives.
|
|
37
|
+
*/
|
|
38
|
+
export declare function createVitePluginFromSourceTransform(transform: EcoSourceTransform): EcoViteCompatiblePlugin;
|
|
39
|
+
/**
|
|
40
|
+
* Returns the app-owned source transforms in stable registration order.
|
|
41
|
+
*/
|
|
42
|
+
export declare function getAppSourceTransforms(appConfig: EcoPagesAppConfig): EcoSourceTransform[];
|
|
43
|
+
/**
|
|
44
|
+
* Adapts the app-owned source transforms into Vite-compatible plugin objects.
|
|
45
|
+
*/
|
|
46
|
+
export declare function createVitePluginsFromAppSourceTransforms(appConfig: EcoPagesAppConfig): EcoViteCompatiblePlugin[];
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import { fileSystem } from "@ecopages/file-system";
|
|
3
|
+
function normalizeTransformId(id) {
|
|
4
|
+
const queryIndex = id.indexOf("?");
|
|
5
|
+
const hashIndex = id.indexOf("#");
|
|
6
|
+
const endIndex = [queryIndex, hashIndex].filter((index) => index >= 0).sort((left, right) => left - right)[0];
|
|
7
|
+
return endIndex === void 0 ? id : id.slice(0, endIndex);
|
|
8
|
+
}
|
|
9
|
+
function applySourceTransform(transform, code, id) {
|
|
10
|
+
const normalizedId = normalizeTransformId(id);
|
|
11
|
+
if (!transform.filter.test(normalizedId)) {
|
|
12
|
+
return void 0;
|
|
13
|
+
}
|
|
14
|
+
return transform.transform(code, normalizedId);
|
|
15
|
+
}
|
|
16
|
+
function inferLoaderFromPath(filePath) {
|
|
17
|
+
const extension = path.extname(filePath).toLowerCase();
|
|
18
|
+
switch (extension) {
|
|
19
|
+
case ".ts":
|
|
20
|
+
return "ts";
|
|
21
|
+
case ".tsx":
|
|
22
|
+
return "tsx";
|
|
23
|
+
case ".jsx":
|
|
24
|
+
return "jsx";
|
|
25
|
+
default:
|
|
26
|
+
return "js";
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
function createEcoBuildPluginFromSourceTransform(transform) {
|
|
30
|
+
return {
|
|
31
|
+
name: transform.name,
|
|
32
|
+
setup(build) {
|
|
33
|
+
build.onLoad({ filter: transform.filter }, (args) => {
|
|
34
|
+
const filePath = normalizeTransformId(args.path);
|
|
35
|
+
const code = fileSystem.readFileSync(filePath);
|
|
36
|
+
const result = applySourceTransform(transform, code, filePath);
|
|
37
|
+
if (!result) {
|
|
38
|
+
return void 0;
|
|
39
|
+
}
|
|
40
|
+
return {
|
|
41
|
+
contents: typeof result === "string" ? result : result.code,
|
|
42
|
+
loader: inferLoaderFromPath(filePath),
|
|
43
|
+
resolveDir: path.dirname(filePath)
|
|
44
|
+
};
|
|
45
|
+
});
|
|
46
|
+
}
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
function createVitePluginFromSourceTransform(transform) {
|
|
50
|
+
return {
|
|
51
|
+
name: transform.name,
|
|
52
|
+
enforce: transform.enforce,
|
|
53
|
+
transform(code, id) {
|
|
54
|
+
return applySourceTransform(transform, code, id);
|
|
55
|
+
}
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
function getAppSourceTransforms(appConfig) {
|
|
59
|
+
return Array.from(appConfig.sourceTransforms.values());
|
|
60
|
+
}
|
|
61
|
+
function createVitePluginsFromAppSourceTransforms(appConfig) {
|
|
62
|
+
return getAppSourceTransforms(appConfig).map((transform) => createVitePluginFromSourceTransform(transform));
|
|
63
|
+
}
|
|
64
|
+
export {
|
|
65
|
+
applySourceTransform,
|
|
66
|
+
createEcoBuildPluginFromSourceTransform,
|
|
67
|
+
createVitePluginFromSourceTransform,
|
|
68
|
+
createVitePluginsFromAppSourceTransforms,
|
|
69
|
+
getAppSourceTransforms,
|
|
70
|
+
normalizeTransformId
|
|
71
|
+
};
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import type { EcoComponent } from '../../types/public-types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Result returned by a renderer-owned foreign-child runtime.
|
|
4
|
+
*
|
|
5
|
+
* `inline` keeps rendering inside the current integration. `resolved` returns a
|
|
6
|
+
* renderer-owned value immediately, which can be final HTML or a renderer-local
|
|
7
|
+
* transport token for later queue resolution.
|
|
8
|
+
*/
|
|
9
|
+
export type ForeignChildInterceptionResult = {
|
|
10
|
+
kind: 'inline';
|
|
11
|
+
} | {
|
|
12
|
+
kind: 'resolved';
|
|
13
|
+
value: unknown;
|
|
14
|
+
};
|
|
15
|
+
/**
|
|
16
|
+
* Foreign-child metadata passed into the active renderer-owned runtime.
|
|
17
|
+
*/
|
|
18
|
+
export type ForeignChildInterceptionInput = {
|
|
19
|
+
currentIntegration: string;
|
|
20
|
+
targetIntegration?: string;
|
|
21
|
+
component: EcoComponent;
|
|
22
|
+
props: Record<string, unknown>;
|
|
23
|
+
};
|
|
24
|
+
/**
|
|
25
|
+
* Narrow renderer-owned foreign-child runtime injected into one active render
|
|
26
|
+
* context.
|
|
27
|
+
*
|
|
28
|
+
* Integrations implement this contract when foreign children must be handed
|
|
29
|
+
* off inside the renderer instead of being left for route-level reconciliation.
|
|
30
|
+
*/
|
|
31
|
+
export interface ForeignChildRuntime {
|
|
32
|
+
/**
|
|
33
|
+
* Intercepts one foreign child during an active render.
|
|
34
|
+
*
|
|
35
|
+
* This runtime is typically installed by the Foreign Subtree execution module,
|
|
36
|
+
* which decides whether the child stays inline or leaves the current renderer.
|
|
37
|
+
*/
|
|
38
|
+
interceptForeignChild?(input: ForeignChildInterceptionInput): ForeignChildInterceptionResult | Promise<ForeignChildInterceptionResult>;
|
|
39
|
+
interceptForeignChildSync?(input: ForeignChildInterceptionInput): ForeignChildInterceptionResult;
|
|
40
|
+
}
|
|
41
|
+
type ForeignChildRenderInput = {
|
|
42
|
+
component: EcoComponent;
|
|
43
|
+
props: Record<string, unknown>;
|
|
44
|
+
targetIntegration?: string;
|
|
45
|
+
};
|
|
46
|
+
/**
|
|
47
|
+
* Per-render mutable state used while applying foreign-child interception and lazy
|
|
48
|
+
* output wrapping.
|
|
49
|
+
*/
|
|
50
|
+
export type ComponentRenderContext = {
|
|
51
|
+
currentIntegration: string;
|
|
52
|
+
foreignChildRuntime?: ForeignChildRuntime;
|
|
53
|
+
interceptForeignChild(input: ForeignChildRenderInput): Promise<unknown | undefined> | unknown | undefined;
|
|
54
|
+
finalizeComponentRender<T>(component: EcoComponent, content: T): T;
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* Returns the current component render context, if one is active.
|
|
58
|
+
*
|
|
59
|
+
* @returns Active render context or `undefined` outside render execution.
|
|
60
|
+
*/
|
|
61
|
+
export declare function getComponentRenderContext(): ComponentRenderContext | undefined;
|
|
62
|
+
/**
|
|
63
|
+
* Runs foreign-child interception for one component render step.
|
|
64
|
+
*
|
|
65
|
+
* The active runtime may resolve the foreign child immediately or keep it inline.
|
|
66
|
+
*/
|
|
67
|
+
export declare function interceptForeignChild(input: ForeignChildRenderInput): Promise<unknown | undefined> | unknown | undefined;
|
|
68
|
+
/**
|
|
69
|
+
* Applies lazy trigger or injector wrapping to completed component output.
|
|
70
|
+
*
|
|
71
|
+
* This helper works both inside render-context execution and in fallback flows
|
|
72
|
+
* where no active context exists.
|
|
73
|
+
*/
|
|
74
|
+
export declare function finalizeComponentRender<T>(component: EcoComponent, content: T): T;
|
|
75
|
+
/**
|
|
76
|
+
* Runs render work under a fresh component render context and returns the
|
|
77
|
+
* resulting value.
|
|
78
|
+
*
|
|
79
|
+
* @param input Execution metadata for current integration and foreign-child policy.
|
|
80
|
+
* @param render Async render function to execute inside the context.
|
|
81
|
+
* @returns Render result value.
|
|
82
|
+
*/
|
|
83
|
+
export declare function runWithComponentRenderContext<T>(input: {
|
|
84
|
+
currentIntegration: string;
|
|
85
|
+
foreignChildRuntime?: ForeignChildRuntime;
|
|
86
|
+
}, render: () => Promise<T>): Promise<{
|
|
87
|
+
value: T;
|
|
88
|
+
}>;
|
|
89
|
+
export {};
|