@ecopages/core 0.2.0-alpha.3 → 0.2.0-alpha.30
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 +66 -66
- package/README.md +268 -14
- package/package.json +72 -108
- package/src/adapters/README.md +39 -0
- 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 +5 -12
- package/src/adapters/bun/create-app.js +43 -7
- package/src/adapters/bun/hmr-manager.d.ts +72 -26
- package/src/adapters/bun/hmr-manager.js +153 -81
- package/src/adapters/bun/index.d.ts +2 -3
- package/src/adapters/bun/index.js +3 -3
- package/src/adapters/bun/server-adapter.d.ts +5 -5
- package/src/adapters/bun/server-adapter.js +63 -38
- package/src/adapters/bun/server-lifecycle.d.ts +28 -17
- package/src/adapters/bun/server-lifecycle.js +34 -62
- 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 +2 -6
- package/src/adapters/index.js +2 -8
- 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 +79 -21
- package/src/adapters/node/node-hmr-manager.js +167 -114
- package/src/adapters/node/server-adapter.d.ts +7 -35
- package/src/adapters/node/server-adapter.js +55 -107
- package/src/adapters/node/static-content-server.d.ts +37 -1
- package/src/adapters/node/static-content-server.js +29 -1
- package/src/adapters/shared/application-adapter.d.ts +1 -1
- package/src/{define-api-handler.d.ts → adapters/shared/define-api-handler.d.ts} +1 -1
- 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 +7 -4
- package/src/adapters/shared/explicit-static-route-matcher.js +14 -13
- package/src/adapters/shared/file-route-middleware-pipeline.d.ts +7 -10
- package/src/adapters/shared/file-route-middleware-pipeline.js +3 -11
- package/src/adapters/shared/fs-server-response-factory.d.ts +14 -10
- package/src/adapters/shared/fs-server-response-factory.js +11 -27
- package/src/adapters/shared/fs-server-response-matcher.d.ts +20 -16
- package/src/adapters/shared/fs-server-response-matcher.js +76 -45
- 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 +4 -3
- package/src/adapters/shared/render-context.js +6 -3
- 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 +33 -12
- package/src/adapters/shared/server-adapter.js +208 -132
- package/src/adapters/shared/server-route-handler.d.ts +5 -5
- package/src/adapters/shared/server-route-handler.js +7 -16
- package/src/adapters/shared/server-static-builder.d.ts +41 -8
- package/src/adapters/shared/server-static-builder.js +65 -11
- package/src/build/README.md +107 -0
- package/src/build/build-adapter.d.ts +168 -3
- package/src/build/build-adapter.js +604 -16
- package/src/build/build-manifest.d.ts +27 -0
- package/src/build/build-manifest.js +30 -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 +15 -6
- package/src/build/esbuild-build-adapter.js +189 -74
- 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/README.md +36 -0
- package/src/config/config-builder.d.ts +54 -29
- package/src/config/config-builder.js +255 -49
- package/src/{constants.d.ts → config/constants.d.ts} +13 -0
- package/src/{constants.js → config/constants.js} +4 -0
- package/src/declarations.d.ts +19 -14
- package/src/dev/host-runtime.d.ts +10 -0
- package/src/dev/host-runtime.js +24 -0
- package/src/dev/sc-server.d.ts +1 -1
- package/src/dev/sc-server.js +1 -1
- package/src/eco/README.md +70 -16
- package/src/eco/eco.browser.d.ts +2 -0
- package/src/eco/eco.browser.js +83 -0
- package/src/eco/eco.js +32 -57
- package/src/eco/eco.types.d.ts +14 -6
- 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 +3 -3
- package/src/eco/global-injector-map.js +2 -2
- package/src/eco/lazy-injector-map.d.ts +2 -2
- package/src/errors/index.d.ts +1 -0
- package/src/errors/index.js +3 -1
- package/src/hmr/README.md +26 -0
- package/src/hmr/client/hmr-runtime.d.ts +1 -6
- package/src/hmr/client/hmr-runtime.js +38 -7
- package/src/hmr/hmr-strategy.d.ts +16 -13
- package/src/hmr/hmr-strategy.js +22 -7
- 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.js +26 -33
- 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 +46 -48
- package/src/hmr/strategies/js-hmr-strategy.js +64 -74
- package/src/index.browser.d.ts +2 -2
- package/src/index.browser.js +1 -1
- package/src/index.d.ts +4 -3
- package/src/index.js +16 -5
- package/src/integrations/ghtml/ghtml-renderer.d.ts +3 -2
- package/src/integrations/ghtml/ghtml-renderer.js +27 -30
- 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 +2 -6
- package/src/integrations/ghtml/ghtml.plugin.js +3 -4
- package/src/plugins/README.md +35 -0
- package/src/plugins/alias-resolver-plugin.js +17 -3
- package/src/plugins/eco-component-meta-plugin.d.ts +14 -1
- package/src/plugins/eco-component-meta-plugin.js +27 -22
- 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 +142 -29
- package/src/plugins/integration-plugin.js +103 -14
- package/src/plugins/processor.d.ts +17 -2
- package/src/plugins/processor.js +22 -3
- package/src/plugins/runtime-capability.d.ts +9 -0
- package/src/plugins/source-transform.d.ts +46 -0
- package/src/plugins/source-transform.js +71 -0
- package/src/route-renderer/GRAPH.md +83 -325
- package/src/route-renderer/README.md +73 -90
- 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/{dependency-resolver.d.ts → page-loading/dependency-resolver.d.ts} +15 -4
- 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-module-loader.js → page-loading/page-module-loader.js} +39 -14
- package/src/route-renderer/route-renderer.d.ts +57 -14
- package/src/route-renderer/route-renderer.js +30 -18
- package/src/router/README.md +94 -0
- package/src/router/client/link-intent.d.ts +53 -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/README.md +28 -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/{asset-processing-service → assets/asset-processing-service}/asset-processing.service.js +124 -89
- package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.d.ts +1 -1
- package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.js +2 -2
- package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.d.ts +16 -1
- 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/{asset-processing-service → assets/asset-processing-service}/processor.interface.d.ts +2 -2
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.d.ts +2 -2
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.d.ts +1 -1
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.js +11 -5
- 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/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.d.ts +3 -2
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +119 -0
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.d.ts +4 -3
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.js +28 -7
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.d.ts +3 -3
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.js +12 -7
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.d.ts +5 -2
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +59 -0
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.js +9 -3
- 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/{page-request-cache-coordinator.service.d.ts → cache/page-request-cache-coordinator.service.d.ts} +2 -2
- package/src/services/{page-request-cache-coordinator.service.js → cache/page-request-cache-coordinator.service.js} +3 -1
- 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-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.d.ts +2 -0
- 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/{schema-validation-service.d.ts → validation/schema-validation-service.d.ts} +1 -1
- package/src/static-site-generator/README.md +26 -0
- package/src/static-site-generator/static-site-generator.d.ts +67 -20
- package/src/static-site-generator/static-site-generator.js +182 -138
- package/src/{internal-types.d.ts → types/internal-types.d.ts} +62 -30
- package/src/types/internal-types.js +0 -0
- package/src/{public-types.d.ts → types/public-types.d.ts} +201 -32
- 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.d.ts +11 -0
- package/src/utils/resolve-work-dir.js +31 -0
- package/src/watchers/project-watcher.d.ts +40 -29
- package/src/watchers/project-watcher.js +126 -116
- package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
- package/src/watchers/project-watcher.test-helpers.js +6 -6
- 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/define-api-handler.d.ts +0 -61
- package/src/adapters/bun/define-api-handler.ts +0 -114
- package/src/adapters/bun/hmr-manager.ts +0 -296
- package/src/adapters/bun/index.ts +0 -3
- package/src/adapters/bun/server-adapter.ts +0 -492
- package/src/adapters/bun/server-lifecycle.ts +0 -154
- package/src/adapters/index.ts +0 -6
- package/src/adapters/node/create-app.ts +0 -179
- package/src/adapters/node/index.d.ts +0 -4
- package/src/adapters/node/index.js +0 -8
- package/src/adapters/node/index.ts +0 -9
- package/src/adapters/node/node-client-bridge.ts +0 -79
- package/src/adapters/node/node-hmr-manager.ts +0 -289
- package/src/adapters/node/server-adapter.ts +0 -561
- package/src/adapters/node/static-content-server.ts +0 -203
- package/src/adapters/shared/api-response.ts +0 -104
- package/src/adapters/shared/application-adapter.ts +0 -199
- package/src/adapters/shared/explicit-static-route-matcher.ts +0 -134
- package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -123
- package/src/adapters/shared/fs-server-response-factory.ts +0 -118
- package/src/adapters/shared/fs-server-response-matcher.ts +0 -198
- package/src/adapters/shared/render-context.ts +0 -105
- package/src/adapters/shared/server-adapter.ts +0 -442
- package/src/adapters/shared/server-route-handler.ts +0 -166
- package/src/adapters/shared/server-static-builder.ts +0 -82
- package/src/build/build-adapter.ts +0 -132
- package/src/build/build-types.ts +0 -83
- package/src/build/esbuild-build-adapter.ts +0 -510
- package/src/config/config-builder.ts +0 -474
- package/src/constants.ts +0 -39
- package/src/create-app.ts +0 -87
- package/src/define-api-handler.js +0 -15
- package/src/define-api-handler.ts +0 -66
- 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 -77
- package/src/eco/component-render-context.ts +0 -202
- package/src/eco/eco.ts +0 -221
- package/src/eco/eco.types.ts +0 -202
- package/src/eco/eco.utils.ts +0 -89
- 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/__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 -121
- package/src/hmr/hmr-strategy.ts +0 -172
- package/src/hmr/hmr.test.e2e.ts +0 -75
- 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 -93
- package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
- package/src/internal-types.ts +0 -212
- package/src/plugins/alias-resolver-plugin.ts +0 -45
- package/src/plugins/eco-component-meta-plugin.ts +0 -474
- package/src/plugins/integration-plugin.ts +0 -184
- package/src/plugins/processor.ts +0 -220
- package/src/public-types.ts +0 -1260
- package/src/route-renderer/component-graph-executor.d.ts +0 -32
- package/src/route-renderer/component-graph-executor.js +0 -31
- package/src/route-renderer/component-graph-executor.ts +0 -84
- package/src/route-renderer/component-graph.d.ts +0 -42
- package/src/route-renderer/component-graph.js +0 -72
- package/src/route-renderer/component-graph.ts +0 -159
- package/src/route-renderer/component-marker.d.ts +0 -52
- package/src/route-renderer/component-marker.js +0 -46
- package/src/route-renderer/component-marker.ts +0 -117
- package/src/route-renderer/dependency-resolver.js +0 -428
- package/src/route-renderer/dependency-resolver.ts +0 -596
- package/src/route-renderer/html-post-processing.service.d.ts +0 -40
- package/src/route-renderer/html-post-processing.service.js +0 -86
- package/src/route-renderer/html-post-processing.service.ts +0 -103
- package/src/route-renderer/integration-renderer.d.ts +0 -339
- package/src/route-renderer/integration-renderer.js +0 -526
- package/src/route-renderer/integration-renderer.ts +0 -696
- package/src/route-renderer/marker-graph-resolver.d.ts +0 -76
- package/src/route-renderer/marker-graph-resolver.js +0 -93
- package/src/route-renderer/marker-graph-resolver.ts +0 -153
- package/src/route-renderer/page-module-loader.d.ts +0 -61
- package/src/route-renderer/page-module-loader.ts +0 -153
- package/src/route-renderer/render-execution.service.d.ts +0 -69
- package/src/route-renderer/render-execution.service.js +0 -91
- package/src/route-renderer/render-execution.service.ts +0 -158
- package/src/route-renderer/render-preparation.service.d.ts +0 -112
- package/src/route-renderer/render-preparation.service.js +0 -243
- package/src/route-renderer/render-preparation.service.ts +0 -358
- package/src/route-renderer/route-renderer.ts +0 -80
- package/src/router/fs-router-scanner.d.ts +0 -41
- package/src/router/fs-router-scanner.js +0 -155
- package/src/router/fs-router-scanner.ts +0 -217
- package/src/router/fs-router.d.ts +0 -26
- package/src/router/fs-router.js +0 -100
- package/src/router/fs-router.ts +0 -122
- package/src/services/asset-processing-service/asset-processing.service.d.ts +0 -41
- package/src/services/asset-processing-service/asset-processing.service.ts +0 -306
- package/src/services/asset-processing-service/asset.factory.ts +0 -105
- package/src/services/asset-processing-service/assets.types.ts +0 -112
- package/src/services/asset-processing-service/index.d.ts +0 -3
- package/src/services/asset-processing-service/index.js +0 -3
- package/src/services/asset-processing-service/index.ts +0 -3
- package/src/services/asset-processing-service/processor.interface.ts +0 -27
- package/src/services/asset-processing-service/processor.registry.ts +0 -18
- package/src/services/asset-processing-service/processors/base/base-processor.ts +0 -76
- package/src/services/asset-processing-service/processors/base/base-script-processor.d.ts +0 -16
- package/src/services/asset-processing-service/processors/base/base-script-processor.js +0 -80
- package/src/services/asset-processing-service/processors/base/base-script-processor.ts +0 -105
- package/src/services/asset-processing-service/processors/index.d.ts +0 -5
- package/src/services/asset-processing-service/processors/index.js +0 -5
- package/src/services/asset-processing-service/processors/index.ts +0 -5
- package/src/services/asset-processing-service/processors/script/content-script.processor.js +0 -57
- package/src/services/asset-processing-service/processors/script/content-script.processor.ts +0 -66
- package/src/services/asset-processing-service/processors/script/file-script.processor.ts +0 -88
- package/src/services/asset-processing-service/processors/script/node-module-script.processor.ts +0 -84
- package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -25
- package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
- package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -77
- 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/html-transformer.service.d.ts +0 -50
- package/src/services/html-transformer.service.js +0 -163
- package/src/services/html-transformer.service.ts +0 -217
- package/src/services/page-module-import.service.d.ts +0 -37
- package/src/services/page-module-import.service.js +0 -88
- package/src/services/page-module-import.service.ts +0 -129
- package/src/services/page-request-cache-coordinator.service.ts +0 -128
- package/src/services/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 -359
- 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/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 -344
- /package/src/adapters/{bun → shared}/define-api-handler.js +0 -0
- /package/src/{internal-types.js → plugins/runtime-capability.js} +0 -0
- /package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.js +0 -0
- /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.js +0 -0
- /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.js +0 -0
- /package/src/{public-types.js → services/module-loading/app-module-loader.service.js} +0 -0
- /package/src/services/{schema-validation-service.js → validation/schema-validation-service.js} +0 -0
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import type { EcoPagesAppConfig, IHmrManager } from '../../../types/internal-types.js';
|
|
2
|
+
import type { AssetDefinition, AssetKind, AssetSource, ProcessedAsset } from './assets.types.js';
|
|
3
|
+
import { ProcessorRegistry } from './processor.registry.js';
|
|
4
|
+
/**
|
|
5
|
+
* Processes declared component and page asset dependencies for one app instance.
|
|
6
|
+
*
|
|
7
|
+
* @remarks
|
|
8
|
+
* This service is the shared bridge between dependency declarations and emitted
|
|
9
|
+
* runtime-ready assets. It owns deduplication, processor dispatch, cache reuse,
|
|
10
|
+
* output URL normalization, and production gzip preparation so route rendering
|
|
11
|
+
* and HMR flows do not need to understand processor-specific behavior.
|
|
12
|
+
*/
|
|
13
|
+
export declare class AssetProcessingService {
|
|
14
|
+
static readonly RESOLVED_ASSETS_DIR = "assets";
|
|
15
|
+
private registry;
|
|
16
|
+
private hmrManager?;
|
|
17
|
+
private cache;
|
|
18
|
+
private readonly config;
|
|
19
|
+
/**
|
|
20
|
+
* Creates the asset-processing service bound to one finalized app config.
|
|
21
|
+
*/
|
|
22
|
+
constructor(config: EcoPagesAppConfig);
|
|
23
|
+
/**
|
|
24
|
+
* Set the HMR manager for the asset processing service.
|
|
25
|
+
* @param hmrManager The HMR manager to set.
|
|
26
|
+
*/
|
|
27
|
+
setHmrManager(hmrManager: IHmrManager): void;
|
|
28
|
+
getHmrManager(): IHmrManager | undefined;
|
|
29
|
+
/**
|
|
30
|
+
* Register a processor for a specific asset kind and source.
|
|
31
|
+
* @param kind The asset kind.
|
|
32
|
+
* @param variant The asset source.
|
|
33
|
+
* @param processor The processor to register.
|
|
34
|
+
*/
|
|
35
|
+
registerProcessor(kind: AssetKind, variant: AssetSource, processor: any): void;
|
|
36
|
+
/**
|
|
37
|
+
* Processes one dependency list into normalized emitted assets.
|
|
38
|
+
*
|
|
39
|
+
* @remarks
|
|
40
|
+
* Dependencies are deduplicated before processor execution so repeated
|
|
41
|
+
* declarations across the render tree reuse the same emitted outputs and cache
|
|
42
|
+
* entries.
|
|
43
|
+
*/
|
|
44
|
+
processDependencies(deps: AssetDefinition[], key: string): Promise<ProcessedAsset[]>;
|
|
45
|
+
/**
|
|
46
|
+
* Processes deduplicated dependencies grouped by processor type.
|
|
47
|
+
*
|
|
48
|
+
* @remarks
|
|
49
|
+
* Grouping keeps cache and processor behavior isolated by asset kind/source
|
|
50
|
+
* pair, while still allowing the overall dependency set to resolve in
|
|
51
|
+
* parallel.
|
|
52
|
+
*/
|
|
53
|
+
private processDependenciesParallel;
|
|
54
|
+
/**
|
|
55
|
+
* Groups dependencies by processor bucket.
|
|
56
|
+
*/
|
|
57
|
+
private groupDependenciesByType;
|
|
58
|
+
/**
|
|
59
|
+
* Converts a dist-local file path into its public URL.
|
|
60
|
+
*/
|
|
61
|
+
private getSrcUrl;
|
|
62
|
+
/**
|
|
63
|
+
* Normalizes the public source URL for one processed asset.
|
|
64
|
+
*/
|
|
65
|
+
private resolveProcessedAssetSrcUrl;
|
|
66
|
+
/**
|
|
67
|
+
* Returns whether a value should be interpreted as a filesystem path instead
|
|
68
|
+
* of an already-public URL.
|
|
69
|
+
*/
|
|
70
|
+
private isFilesystemPath;
|
|
71
|
+
/**
|
|
72
|
+
* Applies post-processing for emitted production assets.
|
|
73
|
+
*
|
|
74
|
+
* @remarks
|
|
75
|
+
* Current optimization is intentionally conservative: only generated CSS and
|
|
76
|
+
* JavaScript files inside the app dist directory are gzipped.
|
|
77
|
+
*/
|
|
78
|
+
private optimizeDependencies;
|
|
79
|
+
/**
|
|
80
|
+
* Returns the cached processed asset for a dependency key when available.
|
|
81
|
+
*/
|
|
82
|
+
private getCachedAsset;
|
|
83
|
+
/**
|
|
84
|
+
* Stores one processed asset in the dependency cache.
|
|
85
|
+
*/
|
|
86
|
+
private setCachedAsset;
|
|
87
|
+
/**
|
|
88
|
+
* Clears all cached processed assets.
|
|
89
|
+
*/
|
|
90
|
+
clearCache(): void;
|
|
91
|
+
/**
|
|
92
|
+
* Removes cached assets that were produced from the given file path.
|
|
93
|
+
*/
|
|
94
|
+
invalidateCacheForFile(filepath: string): void;
|
|
95
|
+
/**
|
|
96
|
+
* Creates a service prewired with the default core processors.
|
|
97
|
+
*/
|
|
98
|
+
static createWithDefaultProcessors(appConfig: EcoPagesAppConfig): AssetProcessingService;
|
|
99
|
+
/**
|
|
100
|
+
* Returns the processor registry owned by this service.
|
|
101
|
+
*/
|
|
102
|
+
getRegistry(): ProcessorRegistry;
|
|
103
|
+
}
|
|
@@ -1,25 +1,34 @@
|
|
|
1
1
|
import path from "node:path";
|
|
2
|
-
import { RESOLVED_ASSETS_DIR } from "
|
|
3
|
-
import { appLogger } from "
|
|
4
|
-
import { rapidhash } from "../../utils/hash";
|
|
2
|
+
import { RESOLVED_ASSETS_DIR } from "../../../config/constants.js";
|
|
3
|
+
import { appLogger } from "../../../global/app-logger.js";
|
|
5
4
|
import { fileSystem } from "@ecopages/file-system";
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
5
|
+
import { deduplicateAssetDependencies, getAssetDependencyKey } from "./asset-dependency-keys.js";
|
|
6
|
+
import {
|
|
7
|
+
partitionGroupedContentScriptDependencies,
|
|
8
|
+
processGroupedDependencyBundles
|
|
9
|
+
} from "./grouped-content-bundles.js";
|
|
10
|
+
import { isHmrAware } from "./processor.interface.js";
|
|
11
|
+
import { ProcessorRegistry } from "./processor.registry.js";
|
|
12
|
+
import { processUngroupedDependency } from "./ungrouped-dependency-processing.js";
|
|
8
13
|
import {
|
|
9
14
|
ContentScriptProcessor,
|
|
10
15
|
ContentStylesheetProcessor,
|
|
11
16
|
FileScriptProcessor,
|
|
12
17
|
FileStylesheetProcessor,
|
|
13
18
|
NodeModuleScriptProcessor
|
|
14
|
-
} from "./processors";
|
|
19
|
+
} from "./processors/index.js";
|
|
15
20
|
class AssetProcessingService {
|
|
16
|
-
constructor(config) {
|
|
17
|
-
this.config = config;
|
|
18
|
-
}
|
|
19
21
|
static RESOLVED_ASSETS_DIR = RESOLVED_ASSETS_DIR;
|
|
20
22
|
registry = new ProcessorRegistry();
|
|
21
23
|
hmrManager;
|
|
22
24
|
cache = /* @__PURE__ */ new Map();
|
|
25
|
+
config;
|
|
26
|
+
/**
|
|
27
|
+
* Creates the asset-processing service bound to one finalized app config.
|
|
28
|
+
*/
|
|
29
|
+
constructor(config) {
|
|
30
|
+
this.config = config;
|
|
31
|
+
}
|
|
23
32
|
/**
|
|
24
33
|
* Set the HMR manager for the asset processing service.
|
|
25
34
|
* @param hmrManager The HMR manager to set.
|
|
@@ -47,106 +56,87 @@ class AssetProcessingService {
|
|
|
47
56
|
}
|
|
48
57
|
this.registry.register(kind, variant, processor);
|
|
49
58
|
}
|
|
59
|
+
/**
|
|
60
|
+
* Processes one dependency list into normalized emitted assets.
|
|
61
|
+
*
|
|
62
|
+
* @remarks
|
|
63
|
+
* Dependencies are deduplicated before processor execution so repeated
|
|
64
|
+
* declarations across the render tree reuse the same emitted outputs and cache
|
|
65
|
+
* entries.
|
|
66
|
+
*/
|
|
50
67
|
async processDependencies(deps, key) {
|
|
51
68
|
const depsDir = path.join(this.config.absolutePaths.distDir, RESOLVED_ASSETS_DIR);
|
|
52
69
|
fileSystem.ensureDir(depsDir);
|
|
53
|
-
const dedupedDeps =
|
|
70
|
+
const dedupedDeps = deduplicateAssetDependencies(deps);
|
|
54
71
|
const results = await this.processDependenciesParallel(dedupedDeps, key);
|
|
55
72
|
await this.optimizeDependencies(results);
|
|
56
73
|
return results;
|
|
57
74
|
}
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
return Array.from(seen.values());
|
|
67
|
-
}
|
|
68
|
-
getScriptDependencyBuildSignature(dep) {
|
|
69
|
-
if (dep.kind !== "script") {
|
|
70
|
-
return void 0;
|
|
71
|
-
}
|
|
72
|
-
const pluginNames = dep.bundleOptions?.plugins?.map((plugin) => plugin.name) ?? [];
|
|
73
|
-
const signature = {
|
|
74
|
-
bundle: dep.bundle,
|
|
75
|
-
inline: dep.inline,
|
|
76
|
-
excludeFromHtml: dep.excludeFromHtml,
|
|
77
|
-
naming: dep.bundleOptions?.naming,
|
|
78
|
-
external: dep.bundleOptions?.external,
|
|
79
|
-
minify: dep.bundleOptions?.minify,
|
|
80
|
-
plugins: pluginNames
|
|
81
|
-
};
|
|
82
|
-
return this.generateHash(JSON.stringify(signature));
|
|
83
|
-
}
|
|
84
|
-
getDependencyKey(dep) {
|
|
85
|
-
const parts = [dep.kind, dep.source];
|
|
86
|
-
if ("filepath" in dep) {
|
|
87
|
-
parts.push(dep.filepath);
|
|
88
|
-
} else if ("content" in dep) {
|
|
89
|
-
parts.push(`content:${this.generateHash(dep.content)}`);
|
|
90
|
-
} else if ("importPath" in dep) {
|
|
91
|
-
parts.push(dep.importPath);
|
|
92
|
-
}
|
|
93
|
-
if ("position" in dep && dep.position) {
|
|
94
|
-
parts.push(dep.position);
|
|
95
|
-
}
|
|
96
|
-
const scriptBuildSignature = this.getScriptDependencyBuildSignature(dep);
|
|
97
|
-
if (scriptBuildSignature) {
|
|
98
|
-
parts.push(`build:${scriptBuildSignature}`);
|
|
99
|
-
}
|
|
100
|
-
return parts.join(":");
|
|
101
|
-
}
|
|
102
|
-
generateHash(content) {
|
|
103
|
-
return rapidhash(content).toString();
|
|
104
|
-
}
|
|
75
|
+
/**
|
|
76
|
+
* Processes deduplicated dependencies grouped by processor type.
|
|
77
|
+
*
|
|
78
|
+
* @remarks
|
|
79
|
+
* Grouping keeps cache and processor behavior isolated by asset kind/source
|
|
80
|
+
* pair, while still allowing the overall dependency set to resolve in
|
|
81
|
+
* parallel.
|
|
82
|
+
*/
|
|
105
83
|
async processDependenciesParallel(deps, key) {
|
|
106
84
|
const grouped = this.groupDependenciesByType(deps);
|
|
107
85
|
const groupPromises = Object.entries(grouped).map(async ([, typeDeps]) => {
|
|
108
|
-
const
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
appLogger.warn(`Skipping missing ${
|
|
123
|
-
|
|
86
|
+
const { groupedBundleDeps, ungroupedDeps } = partitionGroupedContentScriptDependencies(typeDeps);
|
|
87
|
+
const typePromises = ungroupedDeps.map(
|
|
88
|
+
(dep) => processUngroupedDependency({
|
|
89
|
+
dep,
|
|
90
|
+
key,
|
|
91
|
+
depKey: getAssetDependencyKey(dep),
|
|
92
|
+
getCachedAsset: (assetDep, depKey) => this.getCachedAsset(assetDep, depKey),
|
|
93
|
+
getProcessor: (assetDep) => this.registry.getProcessor(assetDep.kind, assetDep.source),
|
|
94
|
+
resolveProcessedAssetSrcUrl: (processed) => this.resolveProcessedAssetSrcUrl(processed),
|
|
95
|
+
setCachedAsset: (assetDep, depKey, processed) => this.setCachedAsset(assetDep, depKey, processed),
|
|
96
|
+
logMissingProcessor: (assetDep) => {
|
|
97
|
+
appLogger.error(`No processor found for ${assetDep.kind}/${assetDep.source}`);
|
|
98
|
+
},
|
|
99
|
+
logMissingFile: (assetDep) => {
|
|
100
|
+
appLogger.warn(`Skipping missing ${assetDep.kind} file: ${assetDep.filepath}`);
|
|
101
|
+
},
|
|
102
|
+
logProcessingError: (assetDep, error) => {
|
|
103
|
+
appLogger.error(
|
|
104
|
+
`Failed to process dependency: ${error instanceof Error ? error.message : String(error)} for ${assetDep.kind}/${assetDep.source}`
|
|
105
|
+
);
|
|
106
|
+
appLogger.debug(error);
|
|
124
107
|
}
|
|
125
|
-
}
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
} catch (error) {
|
|
108
|
+
})
|
|
109
|
+
);
|
|
110
|
+
const groupedResults = await processGroupedDependencyBundles({
|
|
111
|
+
bundles: Array.from(groupedBundleDeps.values()),
|
|
112
|
+
key,
|
|
113
|
+
getCachedAsset: (dep, depKey) => this.getCachedAsset(dep, depKey),
|
|
114
|
+
getDependencyKey: getAssetDependencyKey,
|
|
115
|
+
getGroupedProcessor: () => this.registry.getProcessor("script", "content"),
|
|
116
|
+
resolveProcessedAssetSrcUrl: (processed) => this.resolveProcessedAssetSrcUrl(processed),
|
|
117
|
+
setCachedAsset: (dep, depKey, processed) => this.setCachedAsset(dep, depKey, processed),
|
|
118
|
+
logError: (error) => {
|
|
137
119
|
appLogger.error(
|
|
138
|
-
`Failed to process dependency: ${error instanceof Error ? error.message : String(error)}
|
|
120
|
+
`Failed to process grouped dependency bundle: ${error instanceof Error ? error.message : String(error)}`
|
|
139
121
|
);
|
|
140
122
|
appLogger.debug(error);
|
|
141
|
-
return null;
|
|
142
123
|
}
|
|
143
124
|
});
|
|
144
125
|
const typeResults = await Promise.all(typePromises);
|
|
145
|
-
|
|
126
|
+
const processedTypeResults = typeResults.flatMap((result) => {
|
|
127
|
+
if (!result) {
|
|
128
|
+
return [];
|
|
129
|
+
}
|
|
130
|
+
return Array.isArray(result) ? result : [result];
|
|
131
|
+
});
|
|
132
|
+
return [...processedTypeResults, ...groupedResults];
|
|
146
133
|
});
|
|
147
134
|
const allTypeResults = await Promise.all(groupPromises);
|
|
148
135
|
return allTypeResults.flat();
|
|
149
136
|
}
|
|
137
|
+
/**
|
|
138
|
+
* Groups dependencies by processor bucket.
|
|
139
|
+
*/
|
|
150
140
|
groupDependenciesByType(deps) {
|
|
151
141
|
return deps.reduce(
|
|
152
142
|
(acc, dep) => {
|
|
@@ -158,6 +148,9 @@ class AssetProcessingService {
|
|
|
158
148
|
{}
|
|
159
149
|
);
|
|
160
150
|
}
|
|
151
|
+
/**
|
|
152
|
+
* Converts a dist-local file path into its public URL.
|
|
153
|
+
*/
|
|
161
154
|
getSrcUrl(filepath) {
|
|
162
155
|
const distDir = this.config.absolutePaths.distDir;
|
|
163
156
|
if (!filepath.startsWith(distDir)) return void 0;
|
|
@@ -165,6 +158,9 @@ class AssetProcessingService {
|
|
|
165
158
|
const urlPath = relativePath.startsWith("/") ? relativePath : `/${relativePath}`;
|
|
166
159
|
return urlPath.replace(/\\/g, "/");
|
|
167
160
|
}
|
|
161
|
+
/**
|
|
162
|
+
* Normalizes the public source URL for one processed asset.
|
|
163
|
+
*/
|
|
168
164
|
resolveProcessedAssetSrcUrl(processed) {
|
|
169
165
|
if (processed.srcUrl) {
|
|
170
166
|
if (this.isFilesystemPath(processed.srcUrl)) {
|
|
@@ -179,6 +175,10 @@ class AssetProcessingService {
|
|
|
179
175
|
}
|
|
180
176
|
return void 0;
|
|
181
177
|
}
|
|
178
|
+
/**
|
|
179
|
+
* Returns whether a value should be interpreted as a filesystem path instead
|
|
180
|
+
* of an already-public URL.
|
|
181
|
+
*/
|
|
182
182
|
isFilesystemPath(value) {
|
|
183
183
|
if (value.startsWith("http://") || value.startsWith("https://") || value.startsWith("//")) {
|
|
184
184
|
return false;
|
|
@@ -192,6 +192,13 @@ class AssetProcessingService {
|
|
|
192
192
|
}
|
|
193
193
|
return /^[A-Za-z]:\\/.test(value);
|
|
194
194
|
}
|
|
195
|
+
/**
|
|
196
|
+
* Applies post-processing for emitted production assets.
|
|
197
|
+
*
|
|
198
|
+
* @remarks
|
|
199
|
+
* Current optimization is intentionally conservative: only generated CSS and
|
|
200
|
+
* JavaScript files inside the app dist directory are gzipped.
|
|
201
|
+
*/
|
|
195
202
|
async optimizeDependencies(processedAssets) {
|
|
196
203
|
if (process.env.NODE_ENV !== "production") {
|
|
197
204
|
return;
|
|
@@ -215,16 +222,38 @@ class AssetProcessingService {
|
|
|
215
222
|
}
|
|
216
223
|
}
|
|
217
224
|
}
|
|
225
|
+
/**
|
|
226
|
+
* Returns the cached processed asset for a dependency key when available.
|
|
227
|
+
*/
|
|
218
228
|
getCachedAsset(dep, depKey) {
|
|
229
|
+
if (process.env.NODE_ENV !== "production" && dep.source === "file" && dep.kind === "stylesheet") {
|
|
230
|
+
return null;
|
|
231
|
+
}
|
|
219
232
|
const cached = this.cache.get(depKey);
|
|
220
|
-
|
|
233
|
+
if (!cached) {
|
|
234
|
+
return null;
|
|
235
|
+
}
|
|
236
|
+
if (cached.asset.filepath && !fileSystem.exists(cached.asset.filepath)) {
|
|
237
|
+
this.cache.delete(depKey);
|
|
238
|
+
return null;
|
|
239
|
+
}
|
|
240
|
+
return cached.asset;
|
|
221
241
|
}
|
|
242
|
+
/**
|
|
243
|
+
* Stores one processed asset in the dependency cache.
|
|
244
|
+
*/
|
|
222
245
|
setCachedAsset(dep, depKey, asset) {
|
|
223
246
|
this.cache.set(depKey, { asset });
|
|
224
247
|
}
|
|
248
|
+
/**
|
|
249
|
+
* Clears all cached processed assets.
|
|
250
|
+
*/
|
|
225
251
|
clearCache() {
|
|
226
252
|
this.cache.clear();
|
|
227
253
|
}
|
|
254
|
+
/**
|
|
255
|
+
* Removes cached assets that were produced from the given file path.
|
|
256
|
+
*/
|
|
228
257
|
invalidateCacheForFile(filepath) {
|
|
229
258
|
for (const [key, value] of this.cache.entries()) {
|
|
230
259
|
if (value.asset.filepath === filepath) {
|
|
@@ -232,6 +261,9 @@ class AssetProcessingService {
|
|
|
232
261
|
}
|
|
233
262
|
}
|
|
234
263
|
}
|
|
264
|
+
/**
|
|
265
|
+
* Creates a service prewired with the default core processors.
|
|
266
|
+
*/
|
|
235
267
|
static createWithDefaultProcessors(appConfig) {
|
|
236
268
|
const service = new AssetProcessingService(appConfig);
|
|
237
269
|
service.registerProcessor("script", "content", new ContentScriptProcessor({ appConfig }));
|
|
@@ -241,6 +273,9 @@ class AssetProcessingService {
|
|
|
241
273
|
service.registerProcessor("stylesheet", "file", new FileStylesheetProcessor({ appConfig }));
|
|
242
274
|
return service;
|
|
243
275
|
}
|
|
276
|
+
/**
|
|
277
|
+
* Returns the processor registry owned by this service.
|
|
278
|
+
*/
|
|
244
279
|
getRegistry() {
|
|
245
280
|
return this.registry;
|
|
246
281
|
}
|
package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.d.ts
RENAMED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ContentScriptAsset, ContentStylesheetAsset, FileScriptAsset, FileStylesheetAsset, InlineContentScriptAsset, InlineContentStylesheetAsset, InlineFileScriptAsset, JsonScriptAsset, NodeModuleScriptAsset } from './assets.types';
|
|
1
|
+
import type { ContentScriptAsset, ContentStylesheetAsset, FileScriptAsset, FileStylesheetAsset, InlineContentScriptAsset, InlineContentStylesheetAsset, InlineFileScriptAsset, JsonScriptAsset, NodeModuleScriptAsset } from './assets.types.js';
|
|
2
2
|
type CreateAssetOptions<T> = Omit<T, 'kind' | 'source' | 'inline'>;
|
|
3
3
|
export declare class AssetFactory {
|
|
4
4
|
static readonly RESOLVED_ASSETS_DIR = "assets";
|
package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.js
RENAMED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { RESOLVED_ASSETS_DIR, RESOLVED_ASSETS_VENDORS_DIR } from "
|
|
2
|
-
import { deepMerge } from "
|
|
1
|
+
import { RESOLVED_ASSETS_DIR, RESOLVED_ASSETS_VENDORS_DIR } from "../../../config/constants.js";
|
|
2
|
+
import { deepMerge } from "../../../utils/deep-merge.js";
|
|
3
3
|
class AssetFactory {
|
|
4
4
|
static RESOLVED_ASSETS_DIR = RESOLVED_ASSETS_DIR;
|
|
5
5
|
static RESOLVED_ASSETS_VENDORS_DIR = RESOLVED_ASSETS_VENDORS_DIR;
|
package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.d.ts
RENAMED
|
@@ -1,20 +1,31 @@
|
|
|
1
|
-
import type { EcoBuildPlugin } from '
|
|
1
|
+
import type { EcoBuildPlugin } from '../../../build/build-types.js';
|
|
2
2
|
export type AssetSource = 'content' | 'file' | 'node-module';
|
|
3
3
|
export type AssetKind = 'script' | 'stylesheet';
|
|
4
4
|
export type AssetPosition = 'head' | 'body';
|
|
5
|
+
export type AssetPackageRole = 'page-script' | 'page-style' | 'runtime' | 'keep-separate' | 'dynamic-chunk';
|
|
6
|
+
export type GroupedScriptBundle = {
|
|
7
|
+
id: string;
|
|
8
|
+
entryName: string;
|
|
9
|
+
};
|
|
5
10
|
export interface BaseAsset {
|
|
6
11
|
kind: AssetKind;
|
|
7
12
|
source: AssetSource;
|
|
8
13
|
attributes?: Record<string, string>;
|
|
9
14
|
position?: AssetPosition;
|
|
15
|
+
packageRole?: AssetPackageRole;
|
|
16
|
+
bundledSourceFilepaths?: string[];
|
|
10
17
|
}
|
|
11
18
|
export interface ScriptAsset extends BaseAsset {
|
|
12
19
|
kind: 'script';
|
|
13
20
|
inline?: boolean;
|
|
14
21
|
bundle?: boolean;
|
|
22
|
+
groupedBundle?: GroupedScriptBundle;
|
|
15
23
|
bundleOptions?: {
|
|
24
|
+
define?: Record<string, string>;
|
|
16
25
|
minify?: boolean;
|
|
17
26
|
external?: string[];
|
|
27
|
+
splitting?: boolean;
|
|
28
|
+
excludeAppBuildPlugins?: string[];
|
|
18
29
|
naming?: string;
|
|
19
30
|
plugins?: EcoBuildPlugin[];
|
|
20
31
|
};
|
|
@@ -77,6 +88,7 @@ export interface JsonScriptAsset extends ScriptAsset {
|
|
|
77
88
|
}
|
|
78
89
|
export type ProcessedAsset = {
|
|
79
90
|
filepath?: string;
|
|
91
|
+
sourceFilepath?: string;
|
|
80
92
|
srcUrl?: string;
|
|
81
93
|
content?: string;
|
|
82
94
|
kind: AssetKind;
|
|
@@ -84,5 +96,8 @@ export type ProcessedAsset = {
|
|
|
84
96
|
attributes?: Record<string, string>;
|
|
85
97
|
inline?: boolean;
|
|
86
98
|
excludeFromHtml?: boolean;
|
|
99
|
+
packageRole?: AssetPackageRole;
|
|
100
|
+
groupedBundle?: GroupedScriptBundle;
|
|
101
|
+
bundledSourceFilepaths?: string[];
|
|
87
102
|
};
|
|
88
103
|
export type AssetDefinition = ContentScriptAsset | FileScriptAsset | NodeModuleScriptAsset | JsonScriptAsset | ContentStylesheetAsset | FileStylesheetAsset;
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import type { EcoBuildPlugin } from '../../../build/build-types.js';
|
|
2
|
+
import type { AssetDefinition } from './assets.types.js';
|
|
3
|
+
import { type BrowserRuntimeEntryModuleConfig } from './browser-runtime-entry.factory.js';
|
|
4
|
+
export declare const BROWSER_RUNTIME_SCRIPT_ATTRIBUTES: {
|
|
5
|
+
readonly type: "module";
|
|
6
|
+
readonly defer: "";
|
|
7
|
+
};
|
|
8
|
+
/**
|
|
9
|
+
* Builds the public vendor URL used for generated browser runtime assets.
|
|
10
|
+
*/
|
|
11
|
+
export declare function buildBrowserRuntimeAssetUrl(fileName: string): string;
|
|
12
|
+
/**
|
|
13
|
+
* Declares a browser runtime script asset backed by one importable module.
|
|
14
|
+
*
|
|
15
|
+
* @remarks
|
|
16
|
+
* Runtime assets are emitted as excluded head scripts because integrations often
|
|
17
|
+
* need the bundler output and specifier registration without injecting the raw
|
|
18
|
+
* asset directly into HTML during dependency resolution.
|
|
19
|
+
*/
|
|
20
|
+
export declare function createBrowserRuntimeScriptAsset(options: {
|
|
21
|
+
importPath: string;
|
|
22
|
+
name: string;
|
|
23
|
+
fileName: string;
|
|
24
|
+
bundleOptions?: {
|
|
25
|
+
define?: Record<string, string>;
|
|
26
|
+
minify?: boolean;
|
|
27
|
+
external?: string[];
|
|
28
|
+
naming?: string;
|
|
29
|
+
plugins?: EcoBuildPlugin[];
|
|
30
|
+
};
|
|
31
|
+
attributes?: Record<string, string>;
|
|
32
|
+
}): AssetDefinition;
|
|
33
|
+
/**
|
|
34
|
+
* Creates a browser runtime asset from a generated re-export entry module.
|
|
35
|
+
*
|
|
36
|
+
* @remarks
|
|
37
|
+
* This is the shared "module list -> generated entry file -> runtime asset"
|
|
38
|
+
* path used by integrations that need browser-side runtime bundles without
|
|
39
|
+
* owning bespoke entry-file generation logic.
|
|
40
|
+
*/
|
|
41
|
+
export declare function createBrowserRuntimeModuleAsset(options: {
|
|
42
|
+
modules: BrowserRuntimeEntryModuleConfig[];
|
|
43
|
+
name: string;
|
|
44
|
+
fileName: string;
|
|
45
|
+
cacheDirName?: string;
|
|
46
|
+
rootDir?: string;
|
|
47
|
+
bundleOptions?: {
|
|
48
|
+
define?: Record<string, string>;
|
|
49
|
+
minify?: boolean;
|
|
50
|
+
external?: string[];
|
|
51
|
+
naming?: string;
|
|
52
|
+
plugins?: EcoBuildPlugin[];
|
|
53
|
+
};
|
|
54
|
+
attributes?: Record<string, string>;
|
|
55
|
+
}): AssetDefinition;
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import { AssetFactory } from "./asset.factory.js";
|
|
2
|
+
import {
|
|
3
|
+
createBrowserRuntimeEntryModule
|
|
4
|
+
} from "./browser-runtime-entry.factory.js";
|
|
5
|
+
const BROWSER_RUNTIME_SCRIPT_ATTRIBUTES = {
|
|
6
|
+
type: "module",
|
|
7
|
+
defer: ""
|
|
8
|
+
};
|
|
9
|
+
function buildBrowserRuntimeAssetUrl(fileName) {
|
|
10
|
+
return `/${AssetFactory.RESOLVED_ASSETS_VENDORS_DIR}/${fileName}`;
|
|
11
|
+
}
|
|
12
|
+
function createBrowserRuntimeScriptAsset(options) {
|
|
13
|
+
return AssetFactory.createNodeModuleScript({
|
|
14
|
+
position: "head",
|
|
15
|
+
importPath: options.importPath,
|
|
16
|
+
name: options.name,
|
|
17
|
+
packageRole: "runtime",
|
|
18
|
+
excludeFromHtml: true,
|
|
19
|
+
bundleOptions: {
|
|
20
|
+
naming: options.fileName,
|
|
21
|
+
...options.bundleOptions
|
|
22
|
+
},
|
|
23
|
+
attributes: {
|
|
24
|
+
...BROWSER_RUNTIME_SCRIPT_ATTRIBUTES,
|
|
25
|
+
...options.attributes ?? {}
|
|
26
|
+
}
|
|
27
|
+
});
|
|
28
|
+
}
|
|
29
|
+
function createBrowserRuntimeModuleAsset(options) {
|
|
30
|
+
const importPath = createBrowserRuntimeEntryModule({
|
|
31
|
+
modules: options.modules,
|
|
32
|
+
fileName: `${options.name}-entry.mjs`,
|
|
33
|
+
rootDir: options.rootDir,
|
|
34
|
+
cacheDirName: options.cacheDirName
|
|
35
|
+
});
|
|
36
|
+
return createBrowserRuntimeScriptAsset({
|
|
37
|
+
importPath,
|
|
38
|
+
name: options.name,
|
|
39
|
+
fileName: options.fileName,
|
|
40
|
+
bundleOptions: options.bundleOptions,
|
|
41
|
+
attributes: options.attributes
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
export {
|
|
45
|
+
BROWSER_RUNTIME_SCRIPT_ATTRIBUTES,
|
|
46
|
+
buildBrowserRuntimeAssetUrl,
|
|
47
|
+
createBrowserRuntimeModuleAsset,
|
|
48
|
+
createBrowserRuntimeScriptAsset
|
|
49
|
+
};
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
export type BrowserRuntimeEntryModuleConfig = {
|
|
2
|
+
specifier: string;
|
|
3
|
+
defaultExport?: boolean;
|
|
4
|
+
};
|
|
5
|
+
/**
|
|
6
|
+
* Creates a generated ESM entry module that re-exports runtime modules through
|
|
7
|
+
* one stable file.
|
|
8
|
+
*
|
|
9
|
+
* @remarks
|
|
10
|
+
* Integrations use this helper when they need a browser runtime asset composed
|
|
11
|
+
* from multiple bare specifiers but do not want to own temporary file assembly
|
|
12
|
+
* logic themselves. The generated file lives under a cache directory inside the
|
|
13
|
+
* consuming app root so repeated runs can reuse the same location.
|
|
14
|
+
*/
|
|
15
|
+
export declare function createBrowserRuntimeEntryModule(options: {
|
|
16
|
+
modules: BrowserRuntimeEntryModuleConfig[];
|
|
17
|
+
fileName: string;
|
|
18
|
+
rootDir?: string;
|
|
19
|
+
cacheDirName?: string;
|
|
20
|
+
}): string;
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { createRequire } from "node:module";
|
|
4
|
+
function createBrowserRuntimeEntryModule(options) {
|
|
5
|
+
const rootDir = options.rootDir ?? process.cwd();
|
|
6
|
+
const artifactsDir = path.join(
|
|
7
|
+
rootDir,
|
|
8
|
+
"node_modules",
|
|
9
|
+
".cache",
|
|
10
|
+
options.cacheDirName ?? "ecopages-browser-runtime"
|
|
11
|
+
);
|
|
12
|
+
fs.mkdirSync(artifactsDir, { recursive: true });
|
|
13
|
+
const requireFromRoot = createRequire(path.join(rootDir, "package.json"));
|
|
14
|
+
const seenExports = /* @__PURE__ */ new Set();
|
|
15
|
+
const statements = [];
|
|
16
|
+
for (const module of options.modules) {
|
|
17
|
+
if (module.defaultExport) {
|
|
18
|
+
statements.push(`import __ecopages_default_export__ from '${module.specifier}';`);
|
|
19
|
+
statements.push("export default __ecopages_default_export__;");
|
|
20
|
+
}
|
|
21
|
+
const exportNames = getModuleExportNames(module.specifier, requireFromRoot).filter(
|
|
22
|
+
(name) => !seenExports.has(name)
|
|
23
|
+
);
|
|
24
|
+
if (exportNames.length > 0) {
|
|
25
|
+
statements.push(`export { ${exportNames.join(", ")} } from '${module.specifier}';`);
|
|
26
|
+
for (const exportName of exportNames) {
|
|
27
|
+
seenExports.add(exportName);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
const filePath = path.join(artifactsDir, options.fileName);
|
|
32
|
+
fs.writeFileSync(filePath, statements.join("\n"), "utf-8");
|
|
33
|
+
return filePath;
|
|
34
|
+
}
|
|
35
|
+
function getModuleExportNames(specifier, requireFromRoot) {
|
|
36
|
+
const moduleExports = requireFromRoot(specifier);
|
|
37
|
+
return Object.keys(moduleExports).filter((name) => name !== "__esModule" && name !== "default").filter((name) => /^[$A-Z_a-z][$\w]*$/.test(name)).sort();
|
|
38
|
+
}
|
|
39
|
+
export {
|
|
40
|
+
createBrowserRuntimeEntryModule
|
|
41
|
+
};
|