@ecopages/core 0.2.0-alpha.9 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +18 -11
- package/README.md +23 -26
- package/package.json +76 -58
- package/src/adapters/README.md +2 -2
- package/src/adapters/abstract/application-adapter.d.ts +28 -2
- package/src/adapters/abstract/application-adapter.js +14 -2
- package/src/adapters/abstract/router-adapter.d.ts +1 -1
- package/src/adapters/abstract/server-adapter.d.ts +2 -2
- package/src/adapters/bun/client-bridge.d.ts +1 -1
- package/src/adapters/bun/create-app.d.ts +4 -12
- package/src/adapters/bun/create-app.js +4 -5
- package/src/adapters/bun/hmr-manager.d.ts +4 -4
- package/src/adapters/bun/hmr-manager.js +8 -8
- package/src/adapters/bun/index.d.ts +1 -1
- package/src/adapters/bun/index.js +2 -2
- package/src/adapters/bun/server-adapter.d.ts +5 -5
- package/src/adapters/bun/server-adapter.js +6 -5
- package/src/adapters/bun/server-lifecycle.d.ts +4 -4
- package/src/adapters/bun/server-lifecycle.js +2 -2
- package/src/{create-app.d.ts → adapters/create-app.d.ts} +9 -6
- package/src/{create-app.js → adapters/create-app.js} +4 -4
- package/src/adapters/index.d.ts +1 -5
- package/src/adapters/index.js +1 -7
- package/src/adapters/node/create-app.d.ts +6 -9
- package/src/adapters/node/create-app.js +12 -6
- package/src/adapters/node/node-client-bridge.d.ts +1 -1
- package/src/adapters/node/node-hmr-manager.d.ts +2 -2
- package/src/adapters/node/node-hmr-manager.js +3 -3
- package/src/adapters/node/server-adapter.d.ts +4 -4
- package/src/adapters/node/server-adapter.js +13 -12
- package/src/adapters/node/static-content-server.d.ts +1 -1
- package/src/adapters/node/static-content-server.js +1 -1
- package/src/adapters/shared/application-adapter.d.ts +1 -1
- package/src/adapters/shared/define-api-handler.d.ts +1 -1
- package/src/adapters/shared/explicit-static-route-matcher.d.ts +2 -2
- package/src/adapters/shared/file-route-middleware-pipeline.d.ts +1 -1
- package/src/adapters/shared/fs-server-response-factory.d.ts +2 -2
- package/src/adapters/shared/fs-server-response-factory.js +1 -1
- package/src/adapters/shared/fs-server-response-matcher.d.ts +1 -1
- package/src/adapters/shared/hmr-entrypoint-registrar.js +1 -1
- package/src/adapters/shared/hmr-html-response.d.ts +1 -1
- package/src/adapters/shared/render-context.d.ts +2 -1
- package/src/adapters/shared/render-context.js +3 -1
- package/src/adapters/shared/runtime-bootstrap.d.ts +1 -1
- package/src/adapters/shared/runtime-bootstrap.js +1 -1
- package/src/adapters/shared/server-adapter.d.ts +1 -1
- package/src/adapters/shared/server-adapter.js +5 -1
- package/src/adapters/shared/server-route-handler.d.ts +4 -4
- package/src/adapters/shared/server-route-handler.js +3 -3
- package/src/adapters/shared/server-static-builder.d.ts +5 -5
- package/src/adapters/shared/server-static-builder.js +5 -4
- package/src/build/README.md +19 -13
- package/src/build/build-adapter.d.ts +67 -20
- package/src/build/build-adapter.js +420 -19
- package/src/build/dev-build-coordinator.d.ts +10 -12
- package/src/build/dev-build-coordinator.js +8 -15
- package/src/build/esbuild-build-adapter.d.ts +6 -0
- package/src/build/esbuild-build-adapter.js +94 -11
- package/src/build/runtime-build-executor.d.ts +5 -4
- package/src/build/runtime-build-executor.js +5 -3
- package/src/build/runtime-specifier-alias-plugin.js +19 -15
- package/src/build/runtime-specifier-aliases.d.ts +5 -0
- package/src/build/runtime-specifier-aliases.js +95 -0
- package/src/config/README.md +5 -2
- package/src/config/config-builder.d.ts +25 -2
- package/src/config/config-builder.js +44 -7
- package/src/declarations.d.ts +1 -1
- package/src/dev/sc-server.d.ts +1 -1
- package/src/dev/sc-server.js +1 -1
- package/src/eco/eco.browser.d.ts +2 -0
- package/src/eco/eco.browser.js +83 -0
- package/src/eco/eco.js +19 -48
- package/src/eco/eco.types.d.ts +1 -1
- package/src/eco/eco.utils.d.ts +1 -40
- package/src/eco/eco.utils.js +5 -35
- package/src/eco/global-injector-map.d.ts +1 -1
- package/src/eco/lazy-injector-map.d.ts +1 -1
- package/src/hmr/hmr-strategy.d.ts +16 -13
- package/src/hmr/hmr-strategy.js +22 -7
- package/src/hmr/strategies/default-hmr-strategy.d.ts +2 -2
- package/src/hmr/strategies/default-hmr-strategy.js +1 -1
- package/src/hmr/strategies/js-hmr-strategy.d.ts +2 -2
- package/src/hmr/strategies/js-hmr-strategy.js +2 -2
- package/src/index.browser.d.ts +2 -2
- package/src/index.browser.js +1 -1
- package/src/index.d.ts +3 -2
- package/src/index.js +15 -4
- package/src/integrations/ghtml/ghtml-renderer.d.ts +6 -1
- package/src/integrations/ghtml/ghtml-renderer.js +29 -28
- package/src/integrations/ghtml/ghtml.plugin.d.ts +2 -2
- package/src/integrations/ghtml/ghtml.plugin.js +2 -2
- package/src/plugins/README.md +1 -0
- package/src/plugins/eco-component-meta-plugin.d.ts +12 -1
- package/src/plugins/eco-component-meta-plugin.js +26 -20
- package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
- package/src/plugins/foreign-jsx-override-plugin.js +35 -0
- package/src/plugins/integration-plugin.d.ts +99 -33
- package/src/plugins/integration-plugin.js +68 -21
- package/src/plugins/processor.d.ts +2 -2
- package/src/plugins/processor.js +2 -2
- package/src/plugins/source-transform.d.ts +46 -0
- package/src/plugins/source-transform.js +71 -0
- package/src/route-renderer/GRAPH.md +54 -84
- package/src/route-renderer/README.md +14 -20
- package/src/route-renderer/orchestration/component-render-context.d.ts +83 -0
- package/src/route-renderer/orchestration/component-render-context.js +147 -0
- package/src/route-renderer/orchestration/integration-renderer.d.ts +233 -76
- package/src/route-renderer/orchestration/integration-renderer.js +500 -143
- package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +93 -0
- package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +155 -0
- package/src/route-renderer/orchestration/render-execution.service.d.ts +11 -71
- package/src/route-renderer/orchestration/render-execution.service.js +65 -80
- package/src/{eco/eco.utils.ts → route-renderer/orchestration/render-output.utils.d.ts} +10 -53
- package/src/route-renderer/orchestration/render-output.utils.js +65 -0
- package/src/route-renderer/orchestration/render-preparation.service.d.ts +2 -8
- package/src/route-renderer/orchestration/render-preparation.service.js +10 -17
- package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
- package/src/route-renderer/orchestration/template-serialization.js +45 -0
- package/src/route-renderer/page-loading/dependency-resolver.d.ts +2 -2
- package/src/route-renderer/page-loading/dependency-resolver.js +10 -8
- package/src/route-renderer/page-loading/page-module-loader.d.ts +6 -4
- package/src/route-renderer/page-loading/page-module-loader.js +7 -5
- package/src/route-renderer/route-renderer.d.ts +5 -3
- package/src/route-renderer/route-renderer.js +13 -3
- package/src/router/README.md +79 -8
- package/src/router/client/navigation-coordinator.js +2 -2
- package/src/router/server/fs-router-scanner.d.ts +1 -1
- package/src/router/server/fs-router-scanner.js +6 -1
- package/src/router/server/fs-router.d.ts +1 -1
- package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +3 -3
- package/src/services/assets/asset-processing-service/asset-processing.service.js +6 -6
- package/src/services/assets/asset-processing-service/asset.factory.d.ts +1 -1
- package/src/services/assets/asset-processing-service/asset.factory.js +2 -2
- package/src/services/assets/asset-processing-service/index.d.ts +5 -5
- package/src/services/assets/asset-processing-service/index.js +5 -5
- package/src/services/assets/asset-processing-service/processor.interface.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processor.registry.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +1 -1
- package/src/services/assets/asset-processing-service/processors/base/base-processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +3 -3
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +2 -2
- package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -5
- package/src/services/assets/asset-processing-service/processors/index.js +5 -5
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +4 -3
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +15 -3
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +3 -3
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +1 -1
- package/src/services/assets/browser-bundle.service.d.ts +1 -1
- package/src/services/assets/browser-bundle.service.js +2 -2
- package/src/services/html/html-rewriter-provider.service.js +4 -1
- package/src/services/html/html-transformer.service.d.ts +2 -2
- package/src/services/html/html-transformer.service.js +4 -10
- package/src/services/invalidation/development-invalidation.service.d.ts +1 -1
- package/src/services/invalidation/development-invalidation.service.js +1 -0
- package/src/services/module-loading/app-module-loader.service.d.ts +25 -0
- package/src/services/module-loading/app-module-loader.service.js +31 -0
- package/src/services/module-loading/app-server-module-transpiler.service.d.ts +9 -1
- package/src/services/module-loading/app-server-module-transpiler.service.js +77 -2
- package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
- package/src/services/module-loading/host-module-loader-registry.js +15 -0
- package/src/services/module-loading/module-loading-types.d.ts +2 -0
- package/src/{adapters/node/bootstrap-dependency-resolver.d.ts → services/module-loading/node-bootstrap-plugin.d.ts} +2 -24
- package/src/{adapters/node/bootstrap-dependency-resolver.js → services/module-loading/node-bootstrap-plugin.js} +42 -22
- package/src/services/module-loading/page-module-import.service.d.ts +4 -0
- package/src/services/module-loading/page-module-import.service.js +38 -9
- package/src/services/module-loading/server-module-transpiler.service.d.ts +3 -0
- package/src/services/module-loading/server-module-transpiler.service.js +4 -1
- package/src/services/runtime-state/dev-graph.service.d.ts +6 -6
- package/src/services/runtime-state/dev-graph.service.js +10 -10
- package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +1 -1
- package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +1 -1
- package/src/services/runtime-state/server-invalidation-state.service.d.ts +1 -1
- package/src/static-site-generator/static-site-generator.d.ts +2 -2
- package/src/static-site-generator/static-site-generator.js +1 -1
- package/src/{internal-types.d.ts → types/internal-types.d.ts} +24 -14
- package/src/{public-types.d.ts → types/public-types.d.ts} +30 -14
- package/src/types/public-types.js +0 -0
- package/src/utils/html-escaping.d.ts +7 -0
- package/src/utils/html-escaping.js +6 -0
- package/src/utils/locals-utils.d.ts +1 -1
- package/src/utils/parse-cli-args.d.ts +4 -1
- package/src/utils/parse-cli-args.js +16 -1
- package/src/utils/resolve-work-dir.js +1 -1
- package/src/watchers/project-watcher.d.ts +4 -4
- package/src/watchers/project-watcher.js +4 -10
- package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
- package/src/adapters/abstract/application-adapter.ts +0 -337
- package/src/adapters/abstract/router-adapter.ts +0 -30
- package/src/adapters/abstract/server-adapter.ts +0 -79
- package/src/adapters/bun/client-bridge.ts +0 -62
- package/src/adapters/bun/create-app.ts +0 -189
- package/src/adapters/bun/hmr-manager.ts +0 -409
- package/src/adapters/bun/index.ts +0 -2
- package/src/adapters/bun/server-adapter.ts +0 -499
- package/src/adapters/bun/server-lifecycle.ts +0 -124
- package/src/adapters/index.ts +0 -6
- package/src/adapters/node/bootstrap-dependency-resolver.ts +0 -301
- package/src/adapters/node/create-app.ts +0 -179
- package/src/adapters/node/index.d.ts +0 -6
- package/src/adapters/node/index.js +0 -11
- package/src/adapters/node/index.ts +0 -16
- package/src/adapters/node/node-client-bridge.ts +0 -79
- package/src/adapters/node/node-hmr-manager.ts +0 -381
- package/src/adapters/node/runtime-adapter.d.ts +0 -46
- package/src/adapters/node/runtime-adapter.js +0 -306
- package/src/adapters/node/runtime-adapter.ts +0 -439
- package/src/adapters/node/server-adapter.ts +0 -488
- package/src/adapters/node/static-content-server.ts +0 -239
- package/src/adapters/node/write-runtime-manifest.d.ts +0 -26
- package/src/adapters/node/write-runtime-manifest.js +0 -12
- package/src/adapters/node/write-runtime-manifest.ts +0 -38
- package/src/adapters/shared/api-response.ts +0 -104
- package/src/adapters/shared/application-adapter.ts +0 -199
- package/src/adapters/shared/define-api-handler.ts +0 -66
- package/src/adapters/shared/explicit-static-route-matcher.ts +0 -140
- package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -127
- package/src/adapters/shared/fs-server-response-factory.ts +0 -118
- package/src/adapters/shared/fs-server-response-matcher.ts +0 -205
- package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
- package/src/adapters/shared/hmr-html-response.ts +0 -52
- package/src/adapters/shared/render-context.ts +0 -120
- package/src/adapters/shared/runtime-bootstrap.ts +0 -79
- package/src/adapters/shared/server-adapter.ts +0 -489
- package/src/adapters/shared/server-route-handler.ts +0 -153
- package/src/adapters/shared/server-static-builder.ts +0 -166
- package/src/build/build-adapter.ts +0 -361
- package/src/build/build-manifest.ts +0 -54
- package/src/build/build-types.ts +0 -83
- package/src/build/dev-build-coordinator.ts +0 -221
- package/src/build/esbuild-build-adapter.ts +0 -559
- package/src/build/runtime-build-executor.ts +0 -34
- package/src/build/runtime-specifier-alias-plugin.ts +0 -58
- package/src/config/config-builder.ts +0 -706
- package/src/constants.ts +0 -54
- package/src/create-app.ts +0 -87
- package/src/dev/sc-server.ts +0 -143
- package/src/eco/component-render-context.d.ts +0 -105
- package/src/eco/component-render-context.js +0 -87
- package/src/eco/component-render-context.ts +0 -224
- package/src/eco/eco.ts +0 -242
- package/src/eco/eco.types.ts +0 -221
- package/src/eco/global-injector-map.ts +0 -112
- package/src/eco/lazy-injector-map.ts +0 -120
- package/src/eco/module-dependencies.ts +0 -75
- package/src/errors/http-error.ts +0 -72
- package/src/errors/index.ts +0 -2
- package/src/errors/locals-access-error.ts +0 -7
- package/src/global/app-logger.ts +0 -4
- package/src/hmr/client/hmr-runtime.ts +0 -152
- package/src/hmr/hmr-strategy.ts +0 -172
- package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
- package/src/hmr/hmr.test.e2e.ts +0 -66
- package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
- package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
- package/src/index.browser.ts +0 -3
- package/src/index.ts +0 -5
- package/src/integrations/ghtml/ghtml-renderer.ts +0 -96
- package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
- package/src/internal-types.ts +0 -232
- package/src/plugins/alias-resolver-plugin.ts +0 -63
- package/src/plugins/eco-component-meta-plugin.ts +0 -481
- package/src/plugins/integration-plugin.ts +0 -226
- package/src/plugins/processor.ts +0 -240
- package/src/plugins/runtime-capability.ts +0 -14
- package/src/public-types.ts +0 -1317
- package/src/route-renderer/component-graph/component-graph-executor.d.ts +0 -32
- package/src/route-renderer/component-graph/component-graph-executor.js +0 -31
- package/src/route-renderer/component-graph/component-graph-executor.ts +0 -84
- package/src/route-renderer/component-graph/component-graph.d.ts +0 -42
- package/src/route-renderer/component-graph/component-graph.js +0 -72
- package/src/route-renderer/component-graph/component-graph.ts +0 -159
- package/src/route-renderer/component-graph/component-marker.d.ts +0 -52
- package/src/route-renderer/component-graph/component-marker.js +0 -46
- package/src/route-renderer/component-graph/component-marker.ts +0 -117
- package/src/route-renderer/component-graph/component-reference.d.ts +0 -10
- package/src/route-renderer/component-graph/component-reference.js +0 -19
- package/src/route-renderer/component-graph/component-reference.ts +0 -29
- package/src/route-renderer/component-graph/marker-graph-resolver.d.ts +0 -77
- package/src/route-renderer/component-graph/marker-graph-resolver.js +0 -95
- package/src/route-renderer/component-graph/marker-graph-resolver.ts +0 -155
- package/src/route-renderer/orchestration/integration-renderer.ts +0 -790
- package/src/route-renderer/orchestration/render-execution.service.ts +0 -230
- package/src/route-renderer/orchestration/render-preparation.service.ts +0 -476
- package/src/route-renderer/page-loading/dependency-resolver.ts +0 -612
- package/src/route-renderer/page-loading/page-module-loader.ts +0 -181
- package/src/route-renderer/route-renderer.ts +0 -115
- package/src/router/client/link-intent.test.browser.ts +0 -51
- package/src/router/client/link-intent.ts +0 -92
- package/src/router/client/navigation-coordinator.ts +0 -433
- package/src/router/server/fs-router-scanner.ts +0 -219
- package/src/router/server/fs-router.ts +0 -122
- package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -401
- package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
- package/src/services/assets/asset-processing-service/assets.types.ts +0 -113
- package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -95
- package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
- package/src/services/assets/asset-processing-service/index.ts +0 -5
- package/src/services/assets/asset-processing-service/processor.interface.ts +0 -27
- package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
- package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -82
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -95
- package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -66
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -88
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -85
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -80
- package/src/services/assets/browser-bundle.service.ts +0 -53
- package/src/services/cache/cache.types.ts +0 -126
- package/src/services/cache/index.ts +0 -18
- package/src/services/cache/memory-cache-store.ts +0 -130
- package/src/services/cache/page-cache-service.ts +0 -202
- package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
- package/src/services/html/html-rewriter-provider.service.ts +0 -103
- package/src/services/html/html-transformer.service.ts +0 -279
- package/src/services/invalidation/development-invalidation.service.ts +0 -261
- package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -52
- package/src/services/module-loading/page-module-import.service.ts +0 -200
- package/src/services/module-loading/server-loader.service.d.ts +0 -96
- package/src/services/module-loading/server-loader.service.js +0 -32
- package/src/services/module-loading/server-loader.service.ts +0 -130
- package/src/services/module-loading/server-module-transpiler.service.ts +0 -105
- package/src/services/runtime-manifest/node-runtime-manifest.service.d.ts +0 -35
- package/src/services/runtime-manifest/node-runtime-manifest.service.js +0 -60
- package/src/services/runtime-manifest/node-runtime-manifest.service.ts +0 -101
- package/src/services/runtime-state/dev-graph.service.ts +0 -217
- package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
- package/src/services/runtime-state/runtime-specifier-registry.service.ts +0 -96
- package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
- package/src/services/validation/schema-validation-service.ts +0 -204
- package/src/services/validation/standard-schema.types.ts +0 -68
- package/src/static-site-generator/static-site-generator.ts +0 -462
- package/src/utils/css.d.ts +0 -1
- package/src/utils/css.js +0 -7
- package/src/utils/css.ts +0 -5
- package/src/utils/deep-merge.ts +0 -47
- package/src/utils/hash.ts +0 -5
- package/src/utils/html.ts +0 -1
- package/src/utils/invariant.ts +0 -15
- package/src/utils/locals-utils.ts +0 -37
- package/src/utils/parse-cli-args.ts +0 -83
- package/src/utils/path-utils.module.ts +0 -14
- package/src/utils/resolve-work-dir.ts +0 -45
- package/src/utils/runtime.ts +0 -44
- package/src/utils/server-utils.module.ts +0 -67
- package/src/watchers/project-watcher.test-helpers.ts +0 -41
- package/src/watchers/project-watcher.ts +0 -363
- /package/src/{constants.d.ts → config/constants.d.ts} +0 -0
- /package/src/{constants.js → config/constants.js} +0 -0
- /package/src/{internal-types.js → services/module-loading/module-loading-types.js} +0 -0
- /package/src/{public-types.js → types/internal-types.js} +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -4,28 +4,35 @@ All notable changes to `@ecopages/core` are documented here.
|
|
|
4
4
|
|
|
5
5
|
> **Note:** Changelog tracking begins at version `0.2.0`. Changes prior to this release are not recorded here but are available in the git history.
|
|
6
6
|
|
|
7
|
-
## [
|
|
7
|
+
## [0.2.1] — 2026-04-16
|
|
8
|
+
|
|
9
|
+
### Features
|
|
10
|
+
|
|
11
|
+
- Added app-owned runtime and build ownership around `createApp()`, host module loading, the browser-safe `eco` export, `eco.html()`, `eco.layout()`, and the published `EcoPagesAppConfig` surface.
|
|
12
|
+
|
|
13
|
+
### Refactoring
|
|
14
|
+
|
|
15
|
+
- Consolidated runtime state around shared module-loading services, app-owned build execution, and the universal `createApp()` boundary.
|
|
16
|
+
- Simplified route-renderer orchestration around renderer-owned boundary runtimes, shared string-boundary queue helpers, and a smaller component render context.
|
|
17
|
+
- Removed marker-era compatibility capture, the shared route-level fallback resolver, deprecated `@ecopages/core/node*` escape hatches, and other dead route-renderer internals.
|
|
8
18
|
|
|
9
19
|
### Bug Fixes
|
|
10
20
|
|
|
11
|
-
- Fixed
|
|
21
|
+
- Fixed mixed-integration page, layout, document, and component rendering to resolve foreign boundaries inside their owning renderer across the built-in integrations.
|
|
22
|
+
- Fixed host/runtime module loading, published build-helper exports, asset output normalization, explicit render flows, and static or preview build stability across Bun, Node, Vite, and Nitro.
|
|
12
23
|
|
|
13
|
-
###
|
|
24
|
+
### Documentation
|
|
14
25
|
|
|
15
|
-
-
|
|
16
|
-
- **Architectural Consolidation**: Unified server-side loading, browser bundling, and HMR strategy orchestration across all runtimes using shared core services (`ServerModuleTranspiler`, `BrowserBundleService`).
|
|
17
|
-
- **Build & Asset Refinement**: Introduced an internal `.eco` work directory to isolate development artifacts from production exports, and added `eco.html()`/`eco.layout()` for semantic component definitions.
|
|
18
|
-
- **Performance & Reliability**: Refactored internal watchers and HMR dispatching to improve build stability during rapid development cycles.
|
|
26
|
+
- Added architecture and API documentation for config, plugins, services, adapters, HMR, routing, and rendering.
|
|
19
27
|
|
|
20
|
-
### Tests
|
|
28
|
+
### Tests
|
|
21
29
|
|
|
22
|
-
-
|
|
23
|
-
- **Architecture Docs**: Added focused architecture and API documentation for config, plugins, services, adapters, HMR, router, and the rendering lifecycle.
|
|
30
|
+
- Added regression coverage for app-owned runtime services, Node fallback paths, and cross-runtime invalidation behavior.
|
|
24
31
|
|
|
25
32
|
---
|
|
26
33
|
|
|
27
34
|
## Migration Notes
|
|
28
35
|
|
|
29
|
-
- `createApp` is now the recommended entrypoint. Import it from `@ecopages/core`.
|
|
36
|
+
- `createApp` is now the recommended entrypoint. Import it from `@ecopages/core/create-app`.
|
|
30
37
|
- `defineApiHandler` keeps the same call shape, but the handler context is now explicitly runtime-agnostic.
|
|
31
38
|
- The old explicit `renderingMode` config option has been removed and full orchestration is always active.
|
package/README.md
CHANGED
|
@@ -4,10 +4,10 @@ The foundational engine for the Ecopages framework. It provides the core build p
|
|
|
4
4
|
|
|
5
5
|
## Overview
|
|
6
6
|
|
|
7
|
-
Ecopages is an extensible static site generator (SSG) built
|
|
7
|
+
Ecopages is an extensible static site generator (SSG) built around a Bun-first core with Node fallback support and Vite-hosted compatibility for advanced dev and build orchestration. It embraces a strictly MPA (Multi-Page Application) architecture by default, rendering HTML at build-time or request-time, and hydrating interactive islands only where necessary.
|
|
8
8
|
|
|
9
|
-
- **
|
|
10
|
-
- **
|
|
9
|
+
- **Runtime Boundary**: `createApp()` prefers Bun when available and falls back to Node otherwise. Vite and Nitro still own host-side dev and build orchestration.
|
|
10
|
+
- **Build Ownership**: Bun-native execution keeps a core-owned build path. Vite and Nitro own host-side transforms, module graph behavior, and deployment-oriented builds.
|
|
11
11
|
- **Framework agnostic**: First-class support for KitaJS, Lit, React, and MDX via official integration plugins.
|
|
12
12
|
- **Extensible**: Hook into the build process with custom processors or rendering integrations.
|
|
13
13
|
|
|
@@ -32,17 +32,13 @@ flowchart TD
|
|
|
32
32
|
B --> E[Build executor]
|
|
33
33
|
B --> F[Dev graph service]
|
|
34
34
|
B --> G[Runtime specifier registry]
|
|
35
|
-
B --> H[
|
|
36
|
-
H --> I[
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
K --> O[Loaded app runtime]
|
|
43
|
-
D --> P[BrowserBundleService]
|
|
44
|
-
E --> M
|
|
45
|
-
E --> P
|
|
35
|
+
B --> H[Host module loader boundary]
|
|
36
|
+
H --> I[PageModuleImportService]
|
|
37
|
+
E --> I
|
|
38
|
+
E --> J[BrowserBundleService]
|
|
39
|
+
I --> K[Runtime app adapter]
|
|
40
|
+
K --> L[Bun adapter or Node adapter]
|
|
41
|
+
D --> J
|
|
46
42
|
```
|
|
47
43
|
|
|
48
44
|
### Development Invalidation And HMR Flow
|
|
@@ -71,10 +67,11 @@ The manager/orchestration layer is core-owned, but framework-specific strategies
|
|
|
71
67
|
|
|
72
68
|
### Practical Summary
|
|
73
69
|
|
|
74
|
-
- `ConfigBuilder` now seeds one app-owned build adapter, manifest, executor, dev graph, and runtime registry.
|
|
70
|
+
- `ConfigBuilder` now seeds one app-owned build ownership path, adapter, manifest, executor, dev graph, and runtime registry.
|
|
75
71
|
- `BrowserBundleService` is the shared browser build seam used by HMR and asset-oriented browser output paths.
|
|
76
72
|
- `ServerModuleTranspiler` is the shared server-side source loading seam used by runtime bootstrap and HMR metadata loading.
|
|
77
|
-
-
|
|
73
|
+
- `createApp()` stays the universal runtime entrypoint, while Vite and Nitro hosts own their advanced dev and build workflows.
|
|
74
|
+
- esbuild remains only as a temporary Bun-path implementation detail and is not a strategic core dependency.
|
|
78
75
|
|
|
79
76
|
## Documentation Map
|
|
80
77
|
|
|
@@ -134,13 +131,13 @@ export default config;
|
|
|
134
131
|
|
|
135
132
|
### 2. Application Entry (`app.ts`)
|
|
136
133
|
|
|
137
|
-
Start the application using
|
|
134
|
+
Start the application using `createApp`. It will choose the Bun adapter when Bun is available and fall back to Node otherwise.
|
|
138
135
|
|
|
139
136
|
```typescript
|
|
140
|
-
import { createApp } from '@ecopages/core';
|
|
137
|
+
import { createApp } from '@ecopages/core/create-app';
|
|
141
138
|
import appConfig from './eco.config';
|
|
142
139
|
|
|
143
|
-
const app = createApp({ appConfig });
|
|
140
|
+
const app = await createApp({ appConfig });
|
|
144
141
|
|
|
145
142
|
await app.start();
|
|
146
143
|
```
|
|
@@ -201,11 +198,11 @@ Attach the handler in your `app.ts` entry:
|
|
|
201
198
|
|
|
202
199
|
```typescript
|
|
203
200
|
// app.ts
|
|
204
|
-
import { createApp } from '@ecopages/core';
|
|
201
|
+
import { createApp } from '@ecopages/core/create-app';
|
|
205
202
|
import { helloWorld } from './handlers/hello';
|
|
206
203
|
import appConfig from './eco.config';
|
|
207
204
|
|
|
208
|
-
const app = createApp({ appConfig });
|
|
205
|
+
const app = await createApp({ appConfig });
|
|
209
206
|
|
|
210
207
|
app.get(helloWorld); // Register the API handler
|
|
211
208
|
|
|
@@ -216,18 +213,18 @@ See the [official documentation](https://ecopages.app) for advanced usage, API h
|
|
|
216
213
|
|
|
217
214
|
## Import Structure
|
|
218
215
|
|
|
219
|
-
Use the
|
|
216
|
+
Use the `create-app` subpath for runtime startup and the root package for standard authoring helpers:
|
|
220
217
|
|
|
221
218
|
```ts
|
|
222
|
-
import { createApp
|
|
219
|
+
import { createApp } from '@ecopages/core/create-app';
|
|
220
|
+
import { defineApiHandler, defineGroupHandler, eco } from '@ecopages/core';
|
|
223
221
|
```
|
|
224
222
|
|
|
225
223
|
> [!NOTE]
|
|
226
|
-
> `createApp` is
|
|
224
|
+
> `createApp` is the recommended entrypoint over `EcopagesApp`.
|
|
227
225
|
|
|
228
226
|
### Runtime Escape Hatches
|
|
229
227
|
|
|
230
|
-
Use runtime-specific subpaths only when you explicitly need Bun-native
|
|
228
|
+
Use runtime-specific subpaths only when you explicitly need Bun-native APIs that bypass the universal abstractions:
|
|
231
229
|
|
|
232
230
|
- `@ecopages/core/bun`
|
|
233
|
-
- `@ecopages/core/node`
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ecopages/core",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "Core package for Ecopages",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ecopages",
|
|
@@ -17,14 +17,14 @@
|
|
|
17
17
|
"directory": "packages/core"
|
|
18
18
|
},
|
|
19
19
|
"dependencies": {
|
|
20
|
-
"@ecopages/file-system": "0.2.
|
|
21
|
-
"@ecopages/logger": "
|
|
20
|
+
"@ecopages/file-system": "0.2.1",
|
|
21
|
+
"@ecopages/logger": "^0.2.3",
|
|
22
22
|
"@ecopages/scripts-injector": "^0.1.3",
|
|
23
23
|
"@worker-tools/html-rewriter": "0.1.0-pre.19",
|
|
24
|
-
"chokidar": "^
|
|
25
|
-
"esbuild": "^0.
|
|
24
|
+
"chokidar": "^5.0.0",
|
|
25
|
+
"esbuild": "^0.28.0",
|
|
26
26
|
"ghtml": "^4.0.2",
|
|
27
|
-
"oxc-parser": "^0.
|
|
27
|
+
"oxc-parser": "^0.124.0",
|
|
28
28
|
"ws": "^8.18.0"
|
|
29
29
|
},
|
|
30
30
|
"exports": {
|
|
@@ -35,8 +35,9 @@
|
|
|
35
35
|
"default": "./src/index.js"
|
|
36
36
|
},
|
|
37
37
|
"./create-app": {
|
|
38
|
-
"
|
|
39
|
-
"
|
|
38
|
+
"import": "./src/adapters/create-app.js",
|
|
39
|
+
"types": "./src/adapters/create-app.d.ts",
|
|
40
|
+
"default": "./src/adapters/create-app.js"
|
|
40
41
|
},
|
|
41
42
|
"./route-renderer/integration-renderer": {
|
|
42
43
|
"types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
|
|
@@ -59,9 +60,14 @@
|
|
|
59
60
|
"default": "./src/errors/locals-access-error.js"
|
|
60
61
|
},
|
|
61
62
|
"./eco": {
|
|
63
|
+
"browser": "./src/eco/eco.browser.js",
|
|
62
64
|
"types": "./src/eco/eco.d.ts",
|
|
63
65
|
"default": "./src/eco/eco.js"
|
|
64
66
|
},
|
|
67
|
+
"./route-renderer/template-serialization": {
|
|
68
|
+
"types": "./src/route-renderer/orchestration/template-serialization.d.ts",
|
|
69
|
+
"default": "./src/route-renderer/orchestration/template-serialization.js"
|
|
70
|
+
},
|
|
65
71
|
"./declarations": {
|
|
66
72
|
"types": "./src/declarations.d.ts"
|
|
67
73
|
},
|
|
@@ -73,8 +79,8 @@
|
|
|
73
79
|
"default": "./src/config/config-builder.js"
|
|
74
80
|
},
|
|
75
81
|
"./constants": {
|
|
76
|
-
"types": "./src/constants.d.ts",
|
|
77
|
-
"default": "./src/constants.js"
|
|
82
|
+
"types": "./src/config/constants.d.ts",
|
|
83
|
+
"default": "./src/config/constants.js"
|
|
78
84
|
},
|
|
79
85
|
"./bun": {
|
|
80
86
|
"types": "./src/adapters/bun/index.d.ts",
|
|
@@ -89,12 +95,24 @@
|
|
|
89
95
|
"default": "./src/hmr/hmr-strategy.js"
|
|
90
96
|
},
|
|
91
97
|
"./internal-types": {
|
|
92
|
-
"types": "./src/internal-types.d.ts"
|
|
98
|
+
"types": "./src/types/internal-types.d.ts"
|
|
93
99
|
},
|
|
94
100
|
"./services/asset-processing-service": {
|
|
95
101
|
"types": "./src/services/assets/asset-processing-service/index.d.ts",
|
|
96
102
|
"default": "./src/services/assets/asset-processing-service/index.js"
|
|
97
103
|
},
|
|
104
|
+
"./services/invalidation/development-invalidation.service": {
|
|
105
|
+
"types": "./src/services/invalidation/development-invalidation.service.d.ts",
|
|
106
|
+
"default": "./src/services/invalidation/development-invalidation.service.js"
|
|
107
|
+
},
|
|
108
|
+
"./services/module-loading/app-server-module-transpiler.service": {
|
|
109
|
+
"types": "./src/services/module-loading/app-server-module-transpiler.service.d.ts",
|
|
110
|
+
"default": "./src/services/module-loading/app-server-module-transpiler.service.js"
|
|
111
|
+
},
|
|
112
|
+
"./host-module-loader": {
|
|
113
|
+
"types": "./src/services/module-loading/host-module-loader-registry.d.ts",
|
|
114
|
+
"default": "./src/services/module-loading/host-module-loader-registry.js"
|
|
115
|
+
},
|
|
98
116
|
"./utils/deep-merge": {
|
|
99
117
|
"types": "./src/utils/deep-merge.d.ts",
|
|
100
118
|
"default": "./src/utils/deep-merge.js"
|
|
@@ -115,6 +133,10 @@
|
|
|
115
133
|
"types": "./src/plugins/integration-plugin.d.ts",
|
|
116
134
|
"default": "./src/plugins/integration-plugin.js"
|
|
117
135
|
},
|
|
136
|
+
"./plugins/source-transform": {
|
|
137
|
+
"types": "./src/plugins/source-transform.d.ts",
|
|
138
|
+
"default": "./src/plugins/source-transform.js"
|
|
139
|
+
},
|
|
118
140
|
"./build/build-types": {
|
|
119
141
|
"types": "./src/build/build-types.d.ts",
|
|
120
142
|
"default": "./src/build/build-types.js"
|
|
@@ -127,36 +149,23 @@
|
|
|
127
149
|
"types": "./src/build/runtime-specifier-alias-plugin.d.ts",
|
|
128
150
|
"default": "./src/build/runtime-specifier-alias-plugin.js"
|
|
129
151
|
},
|
|
152
|
+
"./build/runtime-specifier-aliases": {
|
|
153
|
+
"types": "./src/build/runtime-specifier-aliases.d.ts",
|
|
154
|
+
"default": "./src/build/runtime-specifier-aliases.js"
|
|
155
|
+
},
|
|
156
|
+
"./plugins/foreign-jsx-override-plugin": {
|
|
157
|
+
"types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
|
|
158
|
+
"default": "./src/plugins/foreign-jsx-override-plugin.js"
|
|
159
|
+
},
|
|
130
160
|
"./adapters/bun/client-bridge": {
|
|
131
161
|
"types": "./src/adapters/bun/client-bridge.d.ts",
|
|
132
162
|
"default": "./src/adapters/bun/client-bridge.js"
|
|
133
163
|
},
|
|
134
|
-
"./node": {
|
|
135
|
-
"types": "./src/adapters/node/index.d.ts",
|
|
136
|
-
"default": "./src/adapters/node/index.js"
|
|
137
|
-
},
|
|
138
|
-
"./node/server-adapter": {
|
|
139
|
-
"types": "./src/adapters/node/server-adapter.d.ts",
|
|
140
|
-
"default": "./src/adapters/node/server-adapter.js"
|
|
141
|
-
},
|
|
142
|
-
"./node/create-app": {
|
|
143
|
-
"types": "./src/adapters/node/create-app.d.ts",
|
|
144
|
-
"default": "./src/adapters/node/create-app.js"
|
|
145
|
-
},
|
|
146
|
-
"./node/runtime-adapter": {
|
|
147
|
-
"types": "./src/adapters/node/runtime-adapter.d.ts",
|
|
148
|
-
"default": "./src/adapters/node/runtime-adapter.js"
|
|
149
|
-
},
|
|
150
164
|
"./html": {
|
|
151
165
|
"import": "./src/utils/html.js",
|
|
152
166
|
"default": "./src/utils/html.js",
|
|
153
167
|
"types": "./src/utils/html.d.ts"
|
|
154
168
|
},
|
|
155
|
-
"./css": {
|
|
156
|
-
"import": "./src/utils/css.js",
|
|
157
|
-
"default": "./src/utils/css.js",
|
|
158
|
-
"types": "./src/utils/css.d.ts"
|
|
159
|
-
},
|
|
160
169
|
"./hash": {
|
|
161
170
|
"import": "./src/utils/hash.js",
|
|
162
171
|
"default": "./src/utils/hash.js",
|
|
@@ -171,8 +180,9 @@
|
|
|
171
180
|
"default": "./src/integrations/ghtml/ghtml.plugin.js"
|
|
172
181
|
},
|
|
173
182
|
"./create-app.ts": {
|
|
174
|
-
"
|
|
175
|
-
"
|
|
183
|
+
"import": "./src/adapters/create-app.js",
|
|
184
|
+
"types": "./src/adapters/create-app.d.ts",
|
|
185
|
+
"default": "./src/adapters/create-app.js"
|
|
176
186
|
},
|
|
177
187
|
"./route-renderer/integration-renderer.ts": {
|
|
178
188
|
"types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
|
|
@@ -195,9 +205,14 @@
|
|
|
195
205
|
"default": "./src/errors/locals-access-error.js"
|
|
196
206
|
},
|
|
197
207
|
"./eco.ts": {
|
|
208
|
+
"browser": "./src/eco/eco.browser.js",
|
|
198
209
|
"types": "./src/eco/eco.d.ts",
|
|
199
210
|
"default": "./src/eco/eco.js"
|
|
200
211
|
},
|
|
212
|
+
"./route-renderer/template-serialization.ts": {
|
|
213
|
+
"types": "./src/route-renderer/orchestration/template-serialization.d.ts",
|
|
214
|
+
"default": "./src/route-renderer/orchestration/template-serialization.js"
|
|
215
|
+
},
|
|
201
216
|
"./declarations.ts": {
|
|
202
217
|
"types": "./src/declarations.d.ts"
|
|
203
218
|
},
|
|
@@ -209,8 +224,8 @@
|
|
|
209
224
|
"default": "./src/config/config-builder.js"
|
|
210
225
|
},
|
|
211
226
|
"./constants.ts": {
|
|
212
|
-
"types": "./src/constants.d.ts",
|
|
213
|
-
"default": "./src/constants.js"
|
|
227
|
+
"types": "./src/config/constants.d.ts",
|
|
228
|
+
"default": "./src/config/constants.js"
|
|
214
229
|
},
|
|
215
230
|
"./bun.ts": {
|
|
216
231
|
"types": "./src/adapters/bun/index.d.ts",
|
|
@@ -225,12 +240,24 @@
|
|
|
225
240
|
"default": "./src/hmr/hmr-strategy.js"
|
|
226
241
|
},
|
|
227
242
|
"./internal-types.ts": {
|
|
228
|
-
"types": "./src/internal-types.d.ts"
|
|
243
|
+
"types": "./src/types/internal-types.d.ts"
|
|
229
244
|
},
|
|
230
245
|
"./services/asset-processing-service.ts": {
|
|
231
246
|
"types": "./src/services/assets/asset-processing-service/index.d.ts",
|
|
232
247
|
"default": "./src/services/assets/asset-processing-service/index.js"
|
|
233
248
|
},
|
|
249
|
+
"./services/invalidation/development-invalidation.service.ts": {
|
|
250
|
+
"types": "./src/services/invalidation/development-invalidation.service.d.ts",
|
|
251
|
+
"default": "./src/services/invalidation/development-invalidation.service.js"
|
|
252
|
+
},
|
|
253
|
+
"./services/module-loading/app-server-module-transpiler.service.ts": {
|
|
254
|
+
"types": "./src/services/module-loading/app-server-module-transpiler.service.d.ts",
|
|
255
|
+
"default": "./src/services/module-loading/app-server-module-transpiler.service.js"
|
|
256
|
+
},
|
|
257
|
+
"./host-module-loader.ts": {
|
|
258
|
+
"types": "./src/services/module-loading/host-module-loader-registry.d.ts",
|
|
259
|
+
"default": "./src/services/module-loading/host-module-loader-registry.js"
|
|
260
|
+
},
|
|
234
261
|
"./utils/deep-merge.ts": {
|
|
235
262
|
"types": "./src/utils/deep-merge.d.ts",
|
|
236
263
|
"default": "./src/utils/deep-merge.js"
|
|
@@ -251,6 +278,10 @@
|
|
|
251
278
|
"types": "./src/plugins/integration-plugin.d.ts",
|
|
252
279
|
"default": "./src/plugins/integration-plugin.js"
|
|
253
280
|
},
|
|
281
|
+
"./plugins/source-transform.ts": {
|
|
282
|
+
"types": "./src/plugins/source-transform.d.ts",
|
|
283
|
+
"default": "./src/plugins/source-transform.js"
|
|
284
|
+
},
|
|
254
285
|
"./build/build-types.ts": {
|
|
255
286
|
"types": "./src/build/build-types.d.ts",
|
|
256
287
|
"default": "./src/build/build-types.js"
|
|
@@ -263,36 +294,23 @@
|
|
|
263
294
|
"types": "./src/build/runtime-specifier-alias-plugin.d.ts",
|
|
264
295
|
"default": "./src/build/runtime-specifier-alias-plugin.js"
|
|
265
296
|
},
|
|
297
|
+
"./build/runtime-specifier-aliases.ts": {
|
|
298
|
+
"types": "./src/build/runtime-specifier-aliases.d.ts",
|
|
299
|
+
"default": "./src/build/runtime-specifier-aliases.js"
|
|
300
|
+
},
|
|
301
|
+
"./plugins/foreign-jsx-override-plugin.ts": {
|
|
302
|
+
"types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
|
|
303
|
+
"default": "./src/plugins/foreign-jsx-override-plugin.js"
|
|
304
|
+
},
|
|
266
305
|
"./adapters/bun/client-bridge.ts": {
|
|
267
306
|
"types": "./src/adapters/bun/client-bridge.d.ts",
|
|
268
307
|
"default": "./src/adapters/bun/client-bridge.js"
|
|
269
308
|
},
|
|
270
|
-
"./node.ts": {
|
|
271
|
-
"types": "./src/adapters/node/index.d.ts",
|
|
272
|
-
"default": "./src/adapters/node/index.js"
|
|
273
|
-
},
|
|
274
|
-
"./node/server-adapter.ts": {
|
|
275
|
-
"types": "./src/adapters/node/server-adapter.d.ts",
|
|
276
|
-
"default": "./src/adapters/node/server-adapter.js"
|
|
277
|
-
},
|
|
278
|
-
"./node/create-app.ts": {
|
|
279
|
-
"types": "./src/adapters/node/create-app.d.ts",
|
|
280
|
-
"default": "./src/adapters/node/create-app.js"
|
|
281
|
-
},
|
|
282
|
-
"./node/runtime-adapter.ts": {
|
|
283
|
-
"types": "./src/adapters/node/runtime-adapter.d.ts",
|
|
284
|
-
"default": "./src/adapters/node/runtime-adapter.js"
|
|
285
|
-
},
|
|
286
309
|
"./html.ts": {
|
|
287
310
|
"import": "./src/utils/html.js",
|
|
288
311
|
"default": "./src/utils/html.js",
|
|
289
312
|
"types": "./src/utils/html.d.ts"
|
|
290
313
|
},
|
|
291
|
-
"./css.ts": {
|
|
292
|
-
"import": "./src/utils/css.js",
|
|
293
|
-
"default": "./src/utils/css.js",
|
|
294
|
-
"types": "./src/utils/css.d.ts"
|
|
295
|
-
},
|
|
296
314
|
"./hash.ts": {
|
|
297
315
|
"import": "./src/utils/hash.js",
|
|
298
316
|
"default": "./src/utils/hash.js",
|
package/src/adapters/README.md
CHANGED
|
@@ -4,7 +4,7 @@ This directory contains the runtime-host integration layer for Ecopages.
|
|
|
4
4
|
|
|
5
5
|
## Purpose
|
|
6
6
|
|
|
7
|
-
Adapters translate app-owned core services into concrete runtime behavior
|
|
7
|
+
Adapters translate app-owned core services into concrete runtime behavior at the host boundary. Bun remains the direct core runtime, while Node compatibility is driven by the Ecopages CLI thin-host path and reuses internal adapter pieces here.
|
|
8
8
|
|
|
9
9
|
They are responsible for:
|
|
10
10
|
|
|
@@ -23,7 +23,7 @@ They are not responsible for:
|
|
|
23
23
|
## Main Areas
|
|
24
24
|
|
|
25
25
|
- `bun/`: Bun server adapter, lifecycle coordination, bridge, and HMR transport
|
|
26
|
-
- `node/`: Node
|
|
26
|
+
- `node/`: internal Node compatibility adapter pieces used by the CLI thin-host path
|
|
27
27
|
- `shared/`: runtime-neutral adapter helpers used by both hosts
|
|
28
28
|
|
|
29
29
|
## Ownership Boundary
|
|
@@ -6,15 +6,40 @@
|
|
|
6
6
|
*
|
|
7
7
|
* @module ApplicationAdapter
|
|
8
8
|
*/
|
|
9
|
-
import type {
|
|
10
|
-
import type {
|
|
9
|
+
import type { SourceModuleLoader } from '../../services/module-loading/module-loading-types.js';
|
|
10
|
+
import type { EcoPagesAppConfig } from '../../types/internal-types.js';
|
|
11
|
+
import type { ApiHandler, ApiHandlerContext, ErrorHandler, Middleware, RouteOptions, StaticRoute, ViewLoader } from '../../types/public-types.js';
|
|
11
12
|
import { type ReturnParseCliArgs } from '../../utils/parse-cli-args.js';
|
|
13
|
+
/**
|
|
14
|
+
* Runtime bootstrap options layered on top of the app config.
|
|
15
|
+
*
|
|
16
|
+
* These options let a host runtime embed Ecopages without mutating process
|
|
17
|
+
* globals or app runtime state before calling `createApp()`.
|
|
18
|
+
*/
|
|
19
|
+
export interface ApplicationRuntimeOptions {
|
|
20
|
+
/**
|
|
21
|
+
* Forces the app into the embedded-runtime CLI mode used by host
|
|
22
|
+
* environments.
|
|
23
|
+
*
|
|
24
|
+
* When enabled and no explicit `hostModuleLoader` is provided, the
|
|
25
|
+
* adapter auto-detects a host module loader from the global scope.
|
|
26
|
+
*/
|
|
27
|
+
embedded?: boolean;
|
|
28
|
+
/**
|
|
29
|
+
* Explicit source module loader for request-time imports.
|
|
30
|
+
*
|
|
31
|
+
* When omitted in embedded mode, the adapter attempts automatic
|
|
32
|
+
* detection from globals set by the host environment.
|
|
33
|
+
*/
|
|
34
|
+
hostModuleLoader?: SourceModuleLoader;
|
|
35
|
+
}
|
|
12
36
|
/**
|
|
13
37
|
* Configuration options for application adapters
|
|
14
38
|
*/
|
|
15
39
|
export interface ApplicationAdapterOptions {
|
|
16
40
|
appConfig: EcoPagesAppConfig;
|
|
17
41
|
serverOptions?: Record<string, any>;
|
|
42
|
+
runtime?: ApplicationRuntimeOptions;
|
|
18
43
|
/**
|
|
19
44
|
* Options for clearing the output directory before starting the server
|
|
20
45
|
* @default false
|
|
@@ -43,6 +68,7 @@ export declare abstract class AbstractApplicationAdapter<TOptions extends Applic
|
|
|
43
68
|
protected appConfig: EcoPagesAppConfig;
|
|
44
69
|
protected serverOptions: Record<string, any>;
|
|
45
70
|
protected cliArgs: ReturnParseCliArgs;
|
|
71
|
+
protected runtimeOptions: ApplicationRuntimeOptions;
|
|
46
72
|
protected apiHandlers: ApiHandler[];
|
|
47
73
|
protected staticRoutes: StaticRoute[];
|
|
48
74
|
protected errorHandler?: ErrorHandler;
|
|
@@ -1,4 +1,9 @@
|
|
|
1
1
|
import { appLogger } from "../../global/app-logger.js";
|
|
2
|
+
import {
|
|
3
|
+
getAppModuleLoader,
|
|
4
|
+
setAppHostModuleLoader
|
|
5
|
+
} from "../../services/module-loading/app-server-module-transpiler.service.js";
|
|
6
|
+
import { getHostModuleLoader } from "../../services/module-loading/host-module-loader-registry.js";
|
|
2
7
|
import { invariant } from "../../utils/invariant.js";
|
|
3
8
|
import { fileSystem } from "@ecopages/file-system";
|
|
4
9
|
import { parseCliArgs } from "../../utils/parse-cli-args.js";
|
|
@@ -6,20 +11,27 @@ class AbstractApplicationAdapter {
|
|
|
6
11
|
appConfig;
|
|
7
12
|
serverOptions;
|
|
8
13
|
cliArgs;
|
|
14
|
+
runtimeOptions;
|
|
9
15
|
apiHandlers = [];
|
|
10
16
|
staticRoutes = [];
|
|
11
17
|
errorHandler;
|
|
12
18
|
constructor(options) {
|
|
13
19
|
this.appConfig = options.appConfig;
|
|
14
20
|
this.serverOptions = options.serverOptions || {};
|
|
15
|
-
this.
|
|
21
|
+
this.runtimeOptions = options.runtime ?? {};
|
|
22
|
+
this.cliArgs = parseCliArgs({ embeddedRuntime: this.runtimeOptions.embedded });
|
|
23
|
+
const hostModuleLoader = this.runtimeOptions.hostModuleLoader ?? (this.runtimeOptions.embedded ? getHostModuleLoader() : void 0);
|
|
24
|
+
if (hostModuleLoader) {
|
|
25
|
+
setAppHostModuleLoader(this.appConfig, hostModuleLoader);
|
|
26
|
+
}
|
|
27
|
+
getAppModuleLoader(this.appConfig);
|
|
16
28
|
if (options.clearOutput) {
|
|
17
29
|
this.clearDistFolder().catch((error) => {
|
|
18
30
|
appLogger.error("Error clearing dist folder", error);
|
|
19
31
|
});
|
|
20
32
|
}
|
|
21
33
|
}
|
|
22
|
-
async clearDistFolder(
|
|
34
|
+
async clearDistFolder() {
|
|
23
35
|
const distPath = this.appConfig.absolutePaths.distDir;
|
|
24
36
|
const distExists = fileSystem.exists(distPath);
|
|
25
37
|
if (!distExists) return;
|
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
*
|
|
7
7
|
* @module ServerAdapter
|
|
8
8
|
*/
|
|
9
|
-
import type { EcoPagesAppConfig } from '../../internal-types.js';
|
|
10
|
-
import type { ApiHandler } from '../../public-types.js';
|
|
9
|
+
import type { EcoPagesAppConfig } from '../../types/internal-types.js';
|
|
10
|
+
import type { ApiHandler } from '../../types/public-types.js';
|
|
11
11
|
/**
|
|
12
12
|
* Configuration options for all server adapters
|
|
13
13
|
*/
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { ServerWebSocket } from 'bun';
|
|
2
|
-
import type { ClientBridgeEvent, IClientBridge } from '../../public-types';
|
|
2
|
+
import type { ClientBridgeEvent, IClientBridge } from '../../types/public-types.js';
|
|
3
3
|
type BunSocket = ServerWebSocket<unknown>;
|
|
4
4
|
/**
|
|
5
5
|
* Manages WebSocket subscribers and broadcasts development events.
|
|
@@ -8,18 +8,10 @@
|
|
|
8
8
|
* @module EcopagesApp
|
|
9
9
|
*/
|
|
10
10
|
import type { Server } from 'bun';
|
|
11
|
-
import type {
|
|
12
|
-
import type { ApiHandlerContext, RouteGroupBuilder } from '../../public-types.js';
|
|
13
|
-
import { type ApplicationAdapterOptions } from '../abstract/application-adapter.js';
|
|
11
|
+
import type { ApiHandlerContext, RouteGroupBuilder } from '../../types/public-types.js';
|
|
14
12
|
import { SharedApplicationAdapter } from '../shared/application-adapter.js';
|
|
13
|
+
import type { EcopagesAppOptions } from '../create-app.js';
|
|
15
14
|
import { type BunServerAdapterResult } from './server-adapter.js';
|
|
16
|
-
/**
|
|
17
|
-
* Configuration options for the Bun application adapter
|
|
18
|
-
*/
|
|
19
|
-
export interface EcopagesAppOptions extends ApplicationAdapterOptions {
|
|
20
|
-
appConfig: EcoPagesAppConfig;
|
|
21
|
-
serverOptions?: Record<string, any>;
|
|
22
|
-
}
|
|
23
15
|
/**
|
|
24
16
|
* Bun-specific route group builder that properly infers route params from path patterns.
|
|
25
17
|
* When you define a route like `/posts/:slug`, the handler context will have
|
|
@@ -34,7 +26,7 @@ export type BunRouteGroupBuilder<WebSocketData = undefined, TContext extends Api
|
|
|
34
26
|
* This class extends the {@link AbstractApplicationAdapter}
|
|
35
27
|
* and provides methods for handling HTTP requests and managing the server.
|
|
36
28
|
*/
|
|
37
|
-
export declare class
|
|
29
|
+
export declare class BunEcopagesApp<WebSocketData = undefined> extends SharedApplicationAdapter<EcopagesAppOptions, Server<WebSocketData>, Request> {
|
|
38
30
|
serverAdapter: BunServerAdapterResult | undefined;
|
|
39
31
|
private server;
|
|
40
32
|
fetch(request: Request): Promise<Response>;
|
|
@@ -57,4 +49,4 @@ export declare class EcopagesApp<WebSocketData = undefined> extends SharedApplic
|
|
|
57
49
|
/**
|
|
58
50
|
* Factory function to create a Bun application
|
|
59
51
|
*/
|
|
60
|
-
export declare function createApp<WebSocketData = undefined>(options: EcopagesAppOptions): Promise<
|
|
52
|
+
export declare function createApp<WebSocketData = undefined>(options: EcopagesAppOptions): Promise<BunEcopagesApp<WebSocketData>>;
|
|
@@ -1,10 +1,9 @@
|
|
|
1
|
-
import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../constants.js";
|
|
1
|
+
import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../config/constants.js";
|
|
2
2
|
import { appLogger } from "../../global/app-logger.js";
|
|
3
3
|
import { getBunRuntime } from "../../utils/runtime.js";
|
|
4
|
-
import {} from "../abstract/application-adapter.js";
|
|
5
4
|
import { SharedApplicationAdapter } from "../shared/application-adapter.js";
|
|
6
5
|
import { createBunServerAdapter } from "./server-adapter.js";
|
|
7
|
-
class
|
|
6
|
+
class BunEcopagesApp extends SharedApplicationAdapter {
|
|
8
7
|
serverAdapter;
|
|
9
8
|
server = null;
|
|
10
9
|
async fetch(request) {
|
|
@@ -109,9 +108,9 @@ class EcopagesApp extends SharedApplicationAdapter {
|
|
|
109
108
|
}
|
|
110
109
|
}
|
|
111
110
|
async function createApp(options) {
|
|
112
|
-
return new
|
|
111
|
+
return new BunEcopagesApp(options);
|
|
113
112
|
}
|
|
114
113
|
export {
|
|
115
|
-
|
|
114
|
+
BunEcopagesApp,
|
|
116
115
|
createApp
|
|
117
116
|
};
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import type { WebSocketHandler } from 'bun';
|
|
2
|
-
import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager } from '../../internal-types';
|
|
2
|
+
import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager } from '../../types/internal-types.js';
|
|
3
3
|
import type { EcoBuildPlugin } from '../../build/build-types.js';
|
|
4
|
-
import { type HmrStrategy } from '../../hmr/hmr-strategy';
|
|
5
|
-
import type { ClientBridge } from './client-bridge';
|
|
6
|
-
import type { ClientBridgeEvent } from '../../public-types';
|
|
4
|
+
import { type HmrStrategy } from '../../hmr/hmr-strategy.js';
|
|
5
|
+
import type { ClientBridge } from './client-bridge.js';
|
|
6
|
+
import type { ClientBridgeEvent } from '../../types/public-types.js';
|
|
7
7
|
type BunSocketHandler = WebSocketHandler<unknown>;
|
|
8
8
|
export interface HmrManagerParams {
|
|
9
9
|
appConfig: EcoPagesAppConfig;
|