@ecopages/core 0.2.0-alpha.7 → 0.2.0-alpha.9
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 +31 -0
- package/package.json +212 -92
- package/src/adapters/abstract/application-adapter.d.ts +168 -0
- package/src/adapters/abstract/application-adapter.js +109 -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 +60 -0
- package/src/adapters/bun/create-app.js +117 -0
- package/src/adapters/bun/hmr-manager.d.ts +143 -0
- package/src/adapters/bun/hmr-manager.js +334 -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 +373 -0
- package/src/adapters/bun/server-lifecycle.d.ts +63 -0
- package/src/adapters/bun/server-lifecycle.js +92 -0
- package/src/adapters/index.d.ts +6 -0
- package/src/adapters/index.js +14 -0
- package/src/adapters/node/bootstrap-dependency-resolver.d.ts +44 -0
- package/src/adapters/node/bootstrap-dependency-resolver.js +172 -0
- package/src/adapters/node/create-app.d.ts +21 -0
- package/src/adapters/node/create-app.js +143 -0
- package/src/adapters/node/index.d.ts +6 -0
- package/src/adapters/node/index.js +11 -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 +133 -0
- package/src/adapters/node/node-hmr-manager.js +312 -0
- package/src/adapters/node/runtime-adapter.d.ts +46 -0
- package/src/adapters/node/runtime-adapter.js +306 -0
- package/src/adapters/node/server-adapter.d.ts +161 -0
- package/src/adapters/node/server-adapter.js +358 -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/node/write-runtime-manifest.d.ts +26 -0
- package/src/adapters/node/write-runtime-manifest.js +12 -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-route-matcher.d.ts +38 -0
- package/src/adapters/shared/explicit-static-route-matcher.js +103 -0
- package/src/adapters/shared/file-route-middleware-pipeline.d.ts +65 -0
- package/src/adapters/shared/file-route-middleware-pipeline.js +99 -0
- package/src/adapters/shared/fs-server-response-factory.d.ts +19 -0
- package/src/adapters/shared/fs-server-response-factory.js +97 -0
- package/src/adapters/shared/fs-server-response-matcher.d.ts +75 -0
- package/src/adapters/shared/fs-server-response-matcher.js +160 -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 +14 -0
- package/src/adapters/shared/render-context.js +70 -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 +97 -0
- package/src/adapters/shared/server-adapter.js +386 -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 +70 -0
- package/src/adapters/shared/server-static-builder.js +99 -0
- package/src/build/build-adapter.d.ts +186 -0
- package/src/build/build-adapter.js +168 -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 +74 -0
- package/src/build/dev-build-coordinator.js +161 -0
- package/src/build/esbuild-build-adapter.d.ts +72 -0
- package/src/build/esbuild-build-adapter.js +422 -0
- package/src/build/runtime-build-executor.d.ts +13 -0
- package/src/build/runtime-build-executor.js +20 -0
- package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
- package/src/build/runtime-specifier-alias-plugin.js +31 -0
- package/src/config/config-builder.d.ts +238 -0
- package/src/config/config-builder.js +565 -0
- package/src/constants.d.ts +45 -0
- package/src/constants.js +25 -0
- package/src/create-app.d.ts +17 -0
- package/src/create-app.js +66 -0
- package/src/dev/sc-server.d.ts +30 -0
- package/src/dev/sc-server.js +111 -0
- package/src/eco/component-render-context.d.ts +105 -0
- package/src/eco/component-render-context.js +87 -0
- package/src/eco/eco.d.ts +9 -0
- package/src/eco/eco.js +114 -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 +40 -0
- package/src/eco/eco.utils.js +40 -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 +2 -0
- package/src/errors/index.js +4 -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 +109 -0
- package/src/hmr/hmr-strategy.d.ts +159 -0
- package/src/hmr/hmr-strategy.js +29 -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 +139 -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 +5 -0
- package/src/index.js +10 -0
- package/src/integrations/ghtml/ghtml-renderer.d.ts +15 -0
- package/src/integrations/ghtml/ghtml-renderer.js +62 -0
- package/src/integrations/ghtml/ghtml.plugin.d.ts +20 -0
- package/src/integrations/ghtml/ghtml.plugin.js +21 -0
- package/src/internal-types.d.ts +221 -0
- package/src/internal-types.js +0 -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 +97 -0
- package/src/plugins/eco-component-meta-plugin.js +157 -0
- package/src/plugins/integration-plugin.d.ts +136 -0
- package/src/plugins/integration-plugin.js +133 -0
- package/src/plugins/processor.d.ts +95 -0
- package/src/plugins/processor.js +136 -0
- package/src/plugins/runtime-capability.d.ts +9 -0
- package/src/plugins/runtime-capability.js +0 -0
- package/src/public-types.d.ts +1149 -0
- package/src/public-types.js +0 -0
- package/src/route-renderer/component-graph/component-graph-executor.d.ts +32 -0
- package/src/route-renderer/component-graph/component-graph-executor.js +31 -0
- package/src/route-renderer/component-graph/component-graph.d.ts +42 -0
- package/src/route-renderer/component-graph/component-graph.js +72 -0
- package/src/route-renderer/component-graph/component-marker.d.ts +52 -0
- package/src/route-renderer/component-graph/component-marker.js +46 -0
- package/src/route-renderer/component-graph/component-reference.d.ts +10 -0
- package/src/route-renderer/component-graph/component-reference.js +19 -0
- package/src/route-renderer/component-graph/marker-graph-resolver.d.ts +77 -0
- package/src/route-renderer/component-graph/marker-graph-resolver.js +95 -0
- package/src/route-renderer/orchestration/integration-renderer.d.ts +372 -0
- package/src/route-renderer/orchestration/integration-renderer.js +589 -0
- package/src/route-renderer/orchestration/render-execution.service.d.ts +103 -0
- package/src/route-renderer/orchestration/render-execution.service.js +121 -0
- package/src/route-renderer/orchestration/render-preparation.service.d.ts +121 -0
- package/src/route-renderer/orchestration/render-preparation.service.js +332 -0
- package/src/route-renderer/page-loading/dependency-resolver.d.ts +35 -0
- package/src/route-renderer/page-loading/dependency-resolver.js +442 -0
- package/src/route-renderer/page-loading/page-module-loader.d.ts +87 -0
- package/src/route-renderer/page-loading/page-module-loader.js +124 -0
- package/src/route-renderer/route-renderer.d.ts +61 -0
- package/src/route-renderer/route-renderer.js +87 -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 +149 -0
- package/src/router/client/navigation-coordinator.js +215 -0
- package/src/router/server/fs-router-scanner.d.ts +41 -0
- package/src/router/server/fs-router-scanner.js +156 -0
- package/src/router/server/fs-router.d.ts +26 -0
- package/src/router/server/fs-router.js +100 -0
- package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +120 -0
- package/src/services/assets/asset-processing-service/asset-processing.service.js +331 -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 +89 -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 +48 -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/index.d.ts +5 -0
- package/src/services/assets/asset-processing-service/index.js +5 -0
- package/src/services/assets/asset-processing-service/processor.interface.d.ts +22 -0
- 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 +64 -0
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +17 -0
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +72 -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 +5 -0
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +57 -0
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +8 -0
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +76 -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 +75 -0
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +5 -0
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +25 -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 +66 -0
- package/src/services/assets/browser-bundle.service.d.ts +32 -0
- package/src/services/assets/browser-bundle.service.js +33 -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 +65 -0
- package/src/services/html/html-transformer.service.d.ts +77 -0
- package/src/services/html/html-transformer.service.js +221 -0
- package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
- package/src/services/invalidation/development-invalidation.service.js +189 -0
- package/src/services/module-loading/app-server-module-transpiler.service.d.ts +16 -0
- package/src/services/module-loading/app-server-module-transpiler.service.js +34 -0
- package/src/services/module-loading/page-module-import.service.d.ts +71 -0
- package/src/services/module-loading/page-module-import.service.js +132 -0
- package/src/services/module-loading/server-loader.service.d.ts +96 -0
- package/src/services/module-loading/server-loader.service.js +32 -0
- package/src/services/module-loading/server-module-transpiler.service.d.ts +69 -0
- package/src/services/module-loading/server-module-transpiler.service.js +61 -0
- package/src/services/runtime-manifest/node-runtime-manifest.service.d.ts +35 -0
- package/src/services/runtime-manifest/node-runtime-manifest.service.js +60 -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/runtime-specifier-registry.service.d.ts +69 -0
- package/src/services/runtime-state/runtime-specifier-registry.service.js +37 -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.d.ts +65 -0
- package/src/services/validation/standard-schema.types.js +0 -0
- package/src/static-site-generator/static-site-generator.d.ts +109 -0
- package/src/static-site-generator/static-site-generator.js +353 -0
- package/src/utils/css.d.ts +1 -0
- package/src/utils/css.js +7 -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.d.ts +1 -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 +24 -0
- package/src/utils/parse-cli-args.js +47 -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 +281 -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/bun/hmr-manager.test.ts +0 -267
- package/src/adapters/node/bootstrap-dependency-resolver.test.ts +0 -282
- package/src/adapters/node/node-client-bridge.test.ts +0 -198
- package/src/adapters/node/node-hmr-manager.test.ts +0 -322
- package/src/adapters/node/runtime-adapter.test.ts +0 -868
- package/src/adapters/node/static-content-server.test.ts +0 -60
- package/src/adapters/shared/api-response.test.ts +0 -97
- package/src/adapters/shared/explicit-static-route-matcher.test.ts +0 -381
- package/src/adapters/shared/file-route-middleware-pipeline.test.ts +0 -90
- package/src/adapters/shared/fs-server-response-factory.test.ts +0 -187
- package/src/adapters/shared/fs-server-response-matcher.test.ts +0 -286
- package/src/adapters/shared/hmr-manager.contract.test.ts +0 -196
- package/src/adapters/shared/hmr-manager.dispatch.test.ts +0 -220
- package/src/adapters/shared/render-context.test.ts +0 -146
- package/src/adapters/shared/server-adapter.test.ts +0 -77
- package/src/adapters/shared/server-route-handler.test.ts +0 -110
- package/src/adapters/shared/server-static-builder.test.ts +0 -316
- package/src/build/build-adapter-serialization.test.ts +0 -268
- package/src/build/build-adapter.test.ts +0 -815
- package/src/build/runtime-specifier-alias-plugin.test.ts +0 -43
- package/src/config/config-builder.test.ts +0 -410
- package/src/eco/eco.test.ts +0 -678
- package/src/eco/eco.utils.test.ts +0 -124
- package/src/eco/global-injector-map.test.ts +0 -42
- package/src/eco/lazy-injector-map.test.ts +0 -66
- package/src/eco/module-dependencies.test.ts +0 -30
- package/src/errors/http-error.test.ts +0 -134
- 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/hmr-strategy.test.ts +0 -124
- package/src/hmr/strategies/js-hmr-strategy.test.ts +0 -335
- package/src/integrations/ghtml/ghtml-renderer.test.ts +0 -63
- package/src/plugins/alias-resolver-plugin.test.ts +0 -41
- package/src/plugins/eco-component-meta-plugin.test.ts +0 -380
- package/src/plugins/integration-plugin.test.ts +0 -111
- package/src/plugins/processor.test.ts +0 -148
- package/src/route-renderer/component-graph/component-graph-executor.test.ts +0 -41
- package/src/route-renderer/component-graph/component-graph.test.ts +0 -63
- package/src/route-renderer/component-graph/component-marker.test.ts +0 -73
- package/src/route-renderer/component-graph/marker-graph-resolver.test.ts +0 -135
- package/src/route-renderer/orchestration/integration-renderer.test.ts +0 -936
- package/src/route-renderer/orchestration/render-execution.service.test.ts +0 -97
- package/src/route-renderer/orchestration/render-preparation.service.test.ts +0 -235
- package/src/route-renderer/page-loading/dependency-resolver.test.ts +0 -345
- package/src/route-renderer/page-loading/page-module-loader.test.ts +0 -96
- package/src/router/client/navigation-coordinator.test.ts +0 -237
- package/src/router/server/fs-router-scanner.test.ts +0 -83
- package/src/router/server/fs-router.test.ts +0 -214
- package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +0 -385
- package/src/services/assets/asset-processing-service/asset.factory.test.ts +0 -63
- package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +0 -72
- package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +0 -67
- package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +0 -59
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +0 -286
- 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/stylesheet/content-stylesheet.processor.test.ts +0 -199
- package/src/services/assets/browser-bundle.service.test.ts +0 -36
- package/src/services/cache/memory-cache-store.test.ts +0 -225
- package/src/services/cache/page-cache-service.test.ts +0 -175
- package/src/services/cache/page-request-cache-coordinator.service.test.ts +0 -79
- package/src/services/html/html-rewriter-provider.service.test.ts +0 -183
- package/src/services/html/html-transformer.service.test.ts +0 -378
- package/src/services/invalidation/development-invalidation.service.test.ts +0 -77
- package/src/services/module-loading/page-module-import.service.test.ts +0 -253
- package/src/services/module-loading/server-loader.service.test.ts +0 -161
- package/src/services/module-loading/server-module-transpiler.service.test.ts +0 -115
- package/src/services/runtime-manifest/node-runtime-manifest.service.test.ts +0 -95
- package/src/services/validation/schema-validation-service.test.ts +0 -223
- package/src/static-site-generator/static-site-generator.test.ts +0 -307
- package/src/utils/deep-merge.test.ts +0 -114
- package/src/utils/invariant.test.ts +0 -22
- package/src/utils/path-utils.test.ts +0 -15
- 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.ts +0 -678
|
@@ -0,0 +1,331 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import { RESOLVED_ASSETS_DIR } from "../../../constants";
|
|
3
|
+
import { appLogger } from "../../../global/app-logger";
|
|
4
|
+
import { rapidhash } from "../../../utils/hash";
|
|
5
|
+
import { fileSystem } from "@ecopages/file-system";
|
|
6
|
+
import { isHmrAware } from "./processor.interface";
|
|
7
|
+
import { ProcessorRegistry } from "./processor.registry";
|
|
8
|
+
import {
|
|
9
|
+
ContentScriptProcessor,
|
|
10
|
+
ContentStylesheetProcessor,
|
|
11
|
+
FileScriptProcessor,
|
|
12
|
+
FileStylesheetProcessor,
|
|
13
|
+
NodeModuleScriptProcessor
|
|
14
|
+
} from "./processors";
|
|
15
|
+
class AssetProcessingService {
|
|
16
|
+
static RESOLVED_ASSETS_DIR = RESOLVED_ASSETS_DIR;
|
|
17
|
+
registry = new ProcessorRegistry();
|
|
18
|
+
hmrManager;
|
|
19
|
+
cache = /* @__PURE__ */ new Map();
|
|
20
|
+
config;
|
|
21
|
+
/**
|
|
22
|
+
* Creates the asset-processing service bound to one finalized app config.
|
|
23
|
+
*/
|
|
24
|
+
constructor(config) {
|
|
25
|
+
this.config = config;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Set the HMR manager for the asset processing service.
|
|
29
|
+
* @param hmrManager The HMR manager to set.
|
|
30
|
+
*/
|
|
31
|
+
setHmrManager(hmrManager) {
|
|
32
|
+
this.hmrManager = hmrManager;
|
|
33
|
+
for (const processor of this.registry.getAllProcessors().values()) {
|
|
34
|
+
if (isHmrAware(processor)) {
|
|
35
|
+
processor.setHmrManager(hmrManager);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
getHmrManager() {
|
|
40
|
+
return this.hmrManager;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Register a processor for a specific asset kind and source.
|
|
44
|
+
* @param kind The asset kind.
|
|
45
|
+
* @param variant The asset source.
|
|
46
|
+
* @param processor The processor to register.
|
|
47
|
+
*/
|
|
48
|
+
registerProcessor(kind, variant, processor) {
|
|
49
|
+
if (this.hmrManager && isHmrAware(processor)) {
|
|
50
|
+
processor.setHmrManager(this.hmrManager);
|
|
51
|
+
}
|
|
52
|
+
this.registry.register(kind, variant, processor);
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Processes one dependency list into normalized emitted assets.
|
|
56
|
+
*
|
|
57
|
+
* @remarks
|
|
58
|
+
* Dependencies are deduplicated before processor execution so repeated
|
|
59
|
+
* declarations across the render tree reuse the same emitted outputs and cache
|
|
60
|
+
* entries.
|
|
61
|
+
*/
|
|
62
|
+
async processDependencies(deps, key) {
|
|
63
|
+
const depsDir = path.join(this.config.absolutePaths.distDir, RESOLVED_ASSETS_DIR);
|
|
64
|
+
fileSystem.ensureDir(depsDir);
|
|
65
|
+
const dedupedDeps = this.deduplicateDependencies(deps);
|
|
66
|
+
const results = await this.processDependenciesParallel(dedupedDeps, key);
|
|
67
|
+
await this.optimizeDependencies(results);
|
|
68
|
+
return results;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Removes duplicate dependency declarations while preserving first-seen order.
|
|
72
|
+
*/
|
|
73
|
+
deduplicateDependencies(deps) {
|
|
74
|
+
const seen = /* @__PURE__ */ new Map();
|
|
75
|
+
for (const dep of deps) {
|
|
76
|
+
const key = this.getDependencyKey(dep);
|
|
77
|
+
if (!seen.has(key)) {
|
|
78
|
+
seen.set(key, dep);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
return Array.from(seen.values());
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Builds the cache signature fragment for script dependencies that can vary by
|
|
85
|
+
* bundling policy.
|
|
86
|
+
*/
|
|
87
|
+
getScriptDependencyBuildSignature(dep) {
|
|
88
|
+
if (dep.kind !== "script") {
|
|
89
|
+
return void 0;
|
|
90
|
+
}
|
|
91
|
+
const pluginNames = dep.bundleOptions?.plugins?.map((plugin) => plugin.name) ?? [];
|
|
92
|
+
const signature = {
|
|
93
|
+
bundle: dep.bundle,
|
|
94
|
+
inline: dep.inline,
|
|
95
|
+
excludeFromHtml: dep.excludeFromHtml,
|
|
96
|
+
naming: dep.bundleOptions?.naming,
|
|
97
|
+
external: dep.bundleOptions?.external,
|
|
98
|
+
minify: dep.bundleOptions?.minify,
|
|
99
|
+
plugins: pluginNames
|
|
100
|
+
};
|
|
101
|
+
return this.generateHash(JSON.stringify(signature));
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
* Derives the stable cache key for one dependency declaration.
|
|
105
|
+
*/
|
|
106
|
+
getDependencyKey(dep) {
|
|
107
|
+
const parts = [dep.kind, dep.source];
|
|
108
|
+
if ("filepath" in dep) {
|
|
109
|
+
parts.push(dep.filepath);
|
|
110
|
+
} else if ("content" in dep) {
|
|
111
|
+
parts.push(`content:${this.generateHash(dep.content)}`);
|
|
112
|
+
} else if ("importPath" in dep) {
|
|
113
|
+
parts.push(dep.importPath);
|
|
114
|
+
}
|
|
115
|
+
if ("position" in dep && dep.position) {
|
|
116
|
+
parts.push(dep.position);
|
|
117
|
+
}
|
|
118
|
+
const scriptBuildSignature = this.getScriptDependencyBuildSignature(dep);
|
|
119
|
+
if (scriptBuildSignature) {
|
|
120
|
+
parts.push(`build:${scriptBuildSignature}`);
|
|
121
|
+
}
|
|
122
|
+
return parts.join(":");
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Hashes content used in dependency cache and signature keys.
|
|
126
|
+
*/
|
|
127
|
+
generateHash(content) {
|
|
128
|
+
return rapidhash(content).toString();
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Processes deduplicated dependencies grouped by processor type.
|
|
132
|
+
*
|
|
133
|
+
* @remarks
|
|
134
|
+
* Grouping keeps cache and processor behavior isolated by asset kind/source
|
|
135
|
+
* pair, while still allowing the overall dependency set to resolve in
|
|
136
|
+
* parallel.
|
|
137
|
+
*/
|
|
138
|
+
async processDependenciesParallel(deps, key) {
|
|
139
|
+
const grouped = this.groupDependenciesByType(deps);
|
|
140
|
+
const groupPromises = Object.entries(grouped).map(async ([, typeDeps]) => {
|
|
141
|
+
const typePromises = typeDeps.map(async (dep) => {
|
|
142
|
+
const depKey = this.getDependencyKey(dep);
|
|
143
|
+
const cached = this.getCachedAsset(dep, depKey);
|
|
144
|
+
if (cached) {
|
|
145
|
+
return { key, ...cached };
|
|
146
|
+
}
|
|
147
|
+
const processor = this.registry.getProcessor(dep.kind, dep.source);
|
|
148
|
+
if (!processor) {
|
|
149
|
+
appLogger.error(`No processor found for ${dep.kind}/${dep.source}`);
|
|
150
|
+
return null;
|
|
151
|
+
}
|
|
152
|
+
if (dep.source === "file" && "filepath" in dep) {
|
|
153
|
+
const fileExists = fileSystem.exists(dep.filepath);
|
|
154
|
+
if (!fileExists) {
|
|
155
|
+
appLogger.warn(`Skipping missing ${dep.kind} file: ${dep.filepath}`);
|
|
156
|
+
return null;
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
try {
|
|
160
|
+
const processed = await processor.process(dep);
|
|
161
|
+
const srcUrl = this.resolveProcessedAssetSrcUrl(processed);
|
|
162
|
+
const processedWithKey = {
|
|
163
|
+
key,
|
|
164
|
+
...processed,
|
|
165
|
+
srcUrl
|
|
166
|
+
};
|
|
167
|
+
this.setCachedAsset(dep, depKey, processedWithKey);
|
|
168
|
+
return processedWithKey;
|
|
169
|
+
} catch (error) {
|
|
170
|
+
appLogger.error(
|
|
171
|
+
`Failed to process dependency: ${error instanceof Error ? error.message : String(error)} for ${dep.kind}/${dep.source}`
|
|
172
|
+
);
|
|
173
|
+
appLogger.debug(error);
|
|
174
|
+
return null;
|
|
175
|
+
}
|
|
176
|
+
});
|
|
177
|
+
const typeResults = await Promise.all(typePromises);
|
|
178
|
+
return typeResults.filter((result) => result !== null);
|
|
179
|
+
});
|
|
180
|
+
const allTypeResults = await Promise.all(groupPromises);
|
|
181
|
+
return allTypeResults.flat();
|
|
182
|
+
}
|
|
183
|
+
/**
|
|
184
|
+
* Groups dependencies by processor bucket.
|
|
185
|
+
*/
|
|
186
|
+
groupDependenciesByType(deps) {
|
|
187
|
+
return deps.reduce(
|
|
188
|
+
(acc, dep) => {
|
|
189
|
+
const key = `${dep.kind}_${dep.source}`;
|
|
190
|
+
if (!acc[key]) acc[key] = [];
|
|
191
|
+
acc[key].push(dep);
|
|
192
|
+
return acc;
|
|
193
|
+
},
|
|
194
|
+
{}
|
|
195
|
+
);
|
|
196
|
+
}
|
|
197
|
+
/**
|
|
198
|
+
* Converts a dist-local file path into its public URL.
|
|
199
|
+
*/
|
|
200
|
+
getSrcUrl(filepath) {
|
|
201
|
+
const distDir = this.config.absolutePaths.distDir;
|
|
202
|
+
if (!filepath.startsWith(distDir)) return void 0;
|
|
203
|
+
const relativePath = filepath.slice(distDir.length);
|
|
204
|
+
const urlPath = relativePath.startsWith("/") ? relativePath : `/${relativePath}`;
|
|
205
|
+
return urlPath.replace(/\\/g, "/");
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* Normalizes the public source URL for one processed asset.
|
|
209
|
+
*/
|
|
210
|
+
resolveProcessedAssetSrcUrl(processed) {
|
|
211
|
+
if (processed.srcUrl) {
|
|
212
|
+
if (this.isFilesystemPath(processed.srcUrl)) {
|
|
213
|
+
const srcUrlFromPath = this.getSrcUrl(processed.srcUrl);
|
|
214
|
+
if (srcUrlFromPath) return srcUrlFromPath;
|
|
215
|
+
} else {
|
|
216
|
+
return processed.srcUrl;
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
if (processed.filepath) {
|
|
220
|
+
return this.getSrcUrl(processed.filepath);
|
|
221
|
+
}
|
|
222
|
+
return void 0;
|
|
223
|
+
}
|
|
224
|
+
/**
|
|
225
|
+
* Returns whether a value should be interpreted as a filesystem path instead
|
|
226
|
+
* of an already-public URL.
|
|
227
|
+
*/
|
|
228
|
+
isFilesystemPath(value) {
|
|
229
|
+
if (value.startsWith("http://") || value.startsWith("https://") || value.startsWith("//")) {
|
|
230
|
+
return false;
|
|
231
|
+
}
|
|
232
|
+
if (value.startsWith(this.config.absolutePaths.distDir)) {
|
|
233
|
+
return true;
|
|
234
|
+
}
|
|
235
|
+
const rootDir = this.config.rootDir;
|
|
236
|
+
if (rootDir && value.startsWith(rootDir)) {
|
|
237
|
+
return true;
|
|
238
|
+
}
|
|
239
|
+
return /^[A-Za-z]:\\/.test(value);
|
|
240
|
+
}
|
|
241
|
+
/**
|
|
242
|
+
* Applies post-processing for emitted production assets.
|
|
243
|
+
*
|
|
244
|
+
* @remarks
|
|
245
|
+
* Current optimization is intentionally conservative: only generated CSS and
|
|
246
|
+
* JavaScript files inside the app dist directory are gzipped.
|
|
247
|
+
*/
|
|
248
|
+
async optimizeDependencies(processedAssets) {
|
|
249
|
+
if (process.env.NODE_ENV !== "production") {
|
|
250
|
+
return;
|
|
251
|
+
}
|
|
252
|
+
const filesToGzip = /* @__PURE__ */ new Set();
|
|
253
|
+
for (const asset of processedAssets) {
|
|
254
|
+
if (!asset.filepath) {
|
|
255
|
+
continue;
|
|
256
|
+
}
|
|
257
|
+
if (!asset.filepath.startsWith(this.config.absolutePaths.distDir)) {
|
|
258
|
+
continue;
|
|
259
|
+
}
|
|
260
|
+
const extension = path.extname(asset.filepath).slice(1);
|
|
261
|
+
if (extension === "css" || extension === "js") {
|
|
262
|
+
filesToGzip.add(asset.filepath);
|
|
263
|
+
}
|
|
264
|
+
}
|
|
265
|
+
for (const filePath of filesToGzip) {
|
|
266
|
+
if (fileSystem.exists(filePath)) {
|
|
267
|
+
fileSystem.gzipFile(filePath);
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
/**
|
|
272
|
+
* Returns the cached processed asset for a dependency key when available.
|
|
273
|
+
*/
|
|
274
|
+
getCachedAsset(dep, depKey) {
|
|
275
|
+
if (process.env.NODE_ENV !== "production" && dep.source === "file" && dep.kind === "stylesheet") {
|
|
276
|
+
return null;
|
|
277
|
+
}
|
|
278
|
+
const cached = this.cache.get(depKey);
|
|
279
|
+
if (!cached) {
|
|
280
|
+
return null;
|
|
281
|
+
}
|
|
282
|
+
if (cached.asset.filepath && !fileSystem.exists(cached.asset.filepath)) {
|
|
283
|
+
this.cache.delete(depKey);
|
|
284
|
+
return null;
|
|
285
|
+
}
|
|
286
|
+
return cached.asset;
|
|
287
|
+
}
|
|
288
|
+
/**
|
|
289
|
+
* Stores one processed asset in the dependency cache.
|
|
290
|
+
*/
|
|
291
|
+
setCachedAsset(dep, depKey, asset) {
|
|
292
|
+
this.cache.set(depKey, { asset });
|
|
293
|
+
}
|
|
294
|
+
/**
|
|
295
|
+
* Clears all cached processed assets.
|
|
296
|
+
*/
|
|
297
|
+
clearCache() {
|
|
298
|
+
this.cache.clear();
|
|
299
|
+
}
|
|
300
|
+
/**
|
|
301
|
+
* Removes cached assets that were produced from the given file path.
|
|
302
|
+
*/
|
|
303
|
+
invalidateCacheForFile(filepath) {
|
|
304
|
+
for (const [key, value] of this.cache.entries()) {
|
|
305
|
+
if (value.asset.filepath === filepath) {
|
|
306
|
+
this.cache.delete(key);
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
/**
|
|
311
|
+
* Creates a service prewired with the default core processors.
|
|
312
|
+
*/
|
|
313
|
+
static createWithDefaultProcessors(appConfig) {
|
|
314
|
+
const service = new AssetProcessingService(appConfig);
|
|
315
|
+
service.registerProcessor("script", "content", new ContentScriptProcessor({ appConfig }));
|
|
316
|
+
service.registerProcessor("script", "file", new FileScriptProcessor({ appConfig }));
|
|
317
|
+
service.registerProcessor("script", "node-module", new NodeModuleScriptProcessor({ appConfig }));
|
|
318
|
+
service.registerProcessor("stylesheet", "content", new ContentStylesheetProcessor({ appConfig }));
|
|
319
|
+
service.registerProcessor("stylesheet", "file", new FileStylesheetProcessor({ appConfig }));
|
|
320
|
+
return service;
|
|
321
|
+
}
|
|
322
|
+
/**
|
|
323
|
+
* Returns the processor registry owned by this service.
|
|
324
|
+
*/
|
|
325
|
+
getRegistry() {
|
|
326
|
+
return this.registry;
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
export {
|
|
330
|
+
AssetProcessingService
|
|
331
|
+
};
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { ContentScriptAsset, ContentStylesheetAsset, FileScriptAsset, FileStylesheetAsset, InlineContentScriptAsset, InlineContentStylesheetAsset, InlineFileScriptAsset, JsonScriptAsset, NodeModuleScriptAsset } from './assets.types';
|
|
2
|
+
type CreateAssetOptions<T> = Omit<T, 'kind' | 'source' | 'inline'>;
|
|
3
|
+
export declare class AssetFactory {
|
|
4
|
+
static readonly RESOLVED_ASSETS_DIR = "assets";
|
|
5
|
+
static readonly RESOLVED_ASSETS_VENDORS_DIR: string;
|
|
6
|
+
static createContentScript(options: CreateAssetOptions<ContentScriptAsset>): ContentScriptAsset;
|
|
7
|
+
static createInlineContentScript(options: CreateAssetOptions<InlineContentScriptAsset>): InlineContentScriptAsset;
|
|
8
|
+
static createFileScript(options: CreateAssetOptions<FileScriptAsset>): FileScriptAsset;
|
|
9
|
+
static createInlineFileScript(options: CreateAssetOptions<InlineFileScriptAsset>): InlineFileScriptAsset;
|
|
10
|
+
static createNodeModuleScript(options: CreateAssetOptions<NodeModuleScriptAsset>): NodeModuleScriptAsset;
|
|
11
|
+
static createInlineNodeModuleScript(options: CreateAssetOptions<NodeModuleScriptAsset>): NodeModuleScriptAsset;
|
|
12
|
+
static createJsonScript(options: CreateAssetOptions<JsonScriptAsset>): JsonScriptAsset;
|
|
13
|
+
static createContentStylesheet(options: CreateAssetOptions<ContentStylesheetAsset>): ContentStylesheetAsset;
|
|
14
|
+
static createInlineContentStylesheet(options: CreateAssetOptions<InlineContentStylesheetAsset>): InlineContentStylesheetAsset;
|
|
15
|
+
static createFileStylesheet(options: CreateAssetOptions<FileStylesheetAsset>): FileStylesheetAsset;
|
|
16
|
+
}
|
|
17
|
+
export {};
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { RESOLVED_ASSETS_DIR, RESOLVED_ASSETS_VENDORS_DIR } from "../../../constants";
|
|
2
|
+
import { deepMerge } from "../../../utils/deep-merge";
|
|
3
|
+
class AssetFactory {
|
|
4
|
+
static RESOLVED_ASSETS_DIR = RESOLVED_ASSETS_DIR;
|
|
5
|
+
static RESOLVED_ASSETS_VENDORS_DIR = RESOLVED_ASSETS_VENDORS_DIR;
|
|
6
|
+
static createContentScript(options) {
|
|
7
|
+
return {
|
|
8
|
+
kind: "script",
|
|
9
|
+
source: "content",
|
|
10
|
+
position: options.position || "body",
|
|
11
|
+
...options
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
static createInlineContentScript(options) {
|
|
15
|
+
return {
|
|
16
|
+
...AssetFactory.createContentScript(options),
|
|
17
|
+
inline: true
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
static createFileScript(options) {
|
|
21
|
+
return {
|
|
22
|
+
kind: "script",
|
|
23
|
+
source: "file",
|
|
24
|
+
position: options.position || "body",
|
|
25
|
+
...options
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
static createInlineFileScript(options) {
|
|
29
|
+
return {
|
|
30
|
+
...AssetFactory.createFileScript(options),
|
|
31
|
+
inline: true
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
static createNodeModuleScript(options) {
|
|
35
|
+
return {
|
|
36
|
+
kind: "script",
|
|
37
|
+
source: "node-module",
|
|
38
|
+
position: options.position || "body",
|
|
39
|
+
...options
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
static createInlineNodeModuleScript(options) {
|
|
43
|
+
return {
|
|
44
|
+
...AssetFactory.createNodeModuleScript(options),
|
|
45
|
+
inline: true
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
static createJsonScript(options) {
|
|
49
|
+
return {
|
|
50
|
+
kind: "script",
|
|
51
|
+
source: "content",
|
|
52
|
+
attributes: deepMerge(options.attributes, { type: "application/json" }),
|
|
53
|
+
position: options.position || "body",
|
|
54
|
+
...options
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
static createContentStylesheet(options) {
|
|
58
|
+
return {
|
|
59
|
+
kind: "stylesheet",
|
|
60
|
+
source: "content",
|
|
61
|
+
position: "head",
|
|
62
|
+
...options
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
static createInlineContentStylesheet(options) {
|
|
66
|
+
return {
|
|
67
|
+
...AssetFactory.createContentStylesheet(options),
|
|
68
|
+
inline: true
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
static createFileStylesheet(options) {
|
|
72
|
+
return {
|
|
73
|
+
kind: "stylesheet",
|
|
74
|
+
source: "file",
|
|
75
|
+
position: options.position || "head",
|
|
76
|
+
...options
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
export {
|
|
81
|
+
AssetFactory
|
|
82
|
+
};
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import type { EcoBuildPlugin } from '../../../build/build-types.js';
|
|
2
|
+
export type AssetSource = 'content' | 'file' | 'node-module';
|
|
3
|
+
export type AssetKind = 'script' | 'stylesheet';
|
|
4
|
+
export type AssetPosition = 'head' | 'body';
|
|
5
|
+
export interface BaseAsset {
|
|
6
|
+
kind: AssetKind;
|
|
7
|
+
source: AssetSource;
|
|
8
|
+
attributes?: Record<string, string>;
|
|
9
|
+
position?: AssetPosition;
|
|
10
|
+
}
|
|
11
|
+
export interface ScriptAsset extends BaseAsset {
|
|
12
|
+
kind: 'script';
|
|
13
|
+
inline?: boolean;
|
|
14
|
+
bundle?: boolean;
|
|
15
|
+
bundleOptions?: {
|
|
16
|
+
define?: Record<string, string>;
|
|
17
|
+
minify?: boolean;
|
|
18
|
+
external?: string[];
|
|
19
|
+
naming?: string;
|
|
20
|
+
plugins?: EcoBuildPlugin[];
|
|
21
|
+
};
|
|
22
|
+
/**
|
|
23
|
+
* Whether to exclude this asset from the HTML output.
|
|
24
|
+
* @default false
|
|
25
|
+
*/
|
|
26
|
+
excludeFromHtml?: boolean;
|
|
27
|
+
}
|
|
28
|
+
export interface StylesheetAsset extends BaseAsset {
|
|
29
|
+
kind: 'stylesheet';
|
|
30
|
+
inline?: boolean;
|
|
31
|
+
}
|
|
32
|
+
export interface ContentScriptAsset extends ScriptAsset {
|
|
33
|
+
source: 'content';
|
|
34
|
+
content: string;
|
|
35
|
+
name?: string;
|
|
36
|
+
}
|
|
37
|
+
export interface InlineContentScriptAsset extends ContentScriptAsset {
|
|
38
|
+
inline: true;
|
|
39
|
+
}
|
|
40
|
+
export interface ContentStylesheetAsset extends StylesheetAsset {
|
|
41
|
+
source: 'content';
|
|
42
|
+
content: string;
|
|
43
|
+
}
|
|
44
|
+
export interface InlineContentStylesheetAsset extends ContentStylesheetAsset {
|
|
45
|
+
inline: true;
|
|
46
|
+
}
|
|
47
|
+
export interface FileScriptAsset extends ScriptAsset {
|
|
48
|
+
source: 'file';
|
|
49
|
+
filepath: string;
|
|
50
|
+
name?: string;
|
|
51
|
+
}
|
|
52
|
+
export interface InlineFileScriptAsset extends FileScriptAsset {
|
|
53
|
+
inline: true;
|
|
54
|
+
}
|
|
55
|
+
export interface FileStylesheetAsset extends StylesheetAsset {
|
|
56
|
+
source: 'file';
|
|
57
|
+
filepath: string;
|
|
58
|
+
name?: string;
|
|
59
|
+
}
|
|
60
|
+
export interface InlineFileStylesheetAsset extends FileStylesheetAsset {
|
|
61
|
+
inline: true;
|
|
62
|
+
}
|
|
63
|
+
export interface NodeModuleScriptAsset extends ScriptAsset {
|
|
64
|
+
kind: 'script';
|
|
65
|
+
source: 'node-module';
|
|
66
|
+
importPath: string;
|
|
67
|
+
name?: string;
|
|
68
|
+
}
|
|
69
|
+
export interface InlineNodeModuleScriptAsset extends NodeModuleScriptAsset {
|
|
70
|
+
inline: true;
|
|
71
|
+
}
|
|
72
|
+
export interface InlineNodeModuleScriptAsset extends NodeModuleScriptAsset {
|
|
73
|
+
inline: true;
|
|
74
|
+
}
|
|
75
|
+
export interface JsonScriptAsset extends ScriptAsset {
|
|
76
|
+
source: 'content';
|
|
77
|
+
content: string;
|
|
78
|
+
}
|
|
79
|
+
export type ProcessedAsset = {
|
|
80
|
+
filepath?: string;
|
|
81
|
+
srcUrl?: string;
|
|
82
|
+
content?: string;
|
|
83
|
+
kind: AssetKind;
|
|
84
|
+
position?: AssetPosition;
|
|
85
|
+
attributes?: Record<string, string>;
|
|
86
|
+
inline?: boolean;
|
|
87
|
+
excludeFromHtml?: boolean;
|
|
88
|
+
};
|
|
89
|
+
export type AssetDefinition = ContentScriptAsset | FileScriptAsset | NodeModuleScriptAsset | JsonScriptAsset | ContentStylesheetAsset | FileStylesheetAsset;
|
|
File without changes
|
|
@@ -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,48 @@
|
|
|
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
|
+
excludeFromHtml: true,
|
|
18
|
+
bundleOptions: {
|
|
19
|
+
naming: options.fileName,
|
|
20
|
+
...options.bundleOptions
|
|
21
|
+
},
|
|
22
|
+
attributes: {
|
|
23
|
+
...BROWSER_RUNTIME_SCRIPT_ATTRIBUTES,
|
|
24
|
+
...options.attributes ?? {}
|
|
25
|
+
}
|
|
26
|
+
});
|
|
27
|
+
}
|
|
28
|
+
function createBrowserRuntimeModuleAsset(options) {
|
|
29
|
+
const importPath = createBrowserRuntimeEntryModule({
|
|
30
|
+
modules: options.modules,
|
|
31
|
+
fileName: `${options.name}-entry.mjs`,
|
|
32
|
+
rootDir: options.rootDir,
|
|
33
|
+
cacheDirName: options.cacheDirName
|
|
34
|
+
});
|
|
35
|
+
return createBrowserRuntimeScriptAsset({
|
|
36
|
+
importPath,
|
|
37
|
+
name: options.name,
|
|
38
|
+
fileName: options.fileName,
|
|
39
|
+
bundleOptions: options.bundleOptions,
|
|
40
|
+
attributes: options.attributes
|
|
41
|
+
});
|
|
42
|
+
}
|
|
43
|
+
export {
|
|
44
|
+
BROWSER_RUNTIME_SCRIPT_ATTRIBUTES,
|
|
45
|
+
buildBrowserRuntimeAssetUrl,
|
|
46
|
+
createBrowserRuntimeModuleAsset,
|
|
47
|
+
createBrowserRuntimeScriptAsset
|
|
48
|
+
};
|
|
@@ -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
|
+
};
|