isr-engine 0.0.0-stage → 1.0.0
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 +755 -0
- package/README.md +694 -2
- package/dist/RequestContext-BVQ-rOmV.js +58 -0
- package/dist/RequestContext-BVQ-rOmV.js.map +1 -0
- package/dist/RequestContext-DgGEAxcW.cjs +105 -0
- package/dist/RequestContext-DgGEAxcW.cjs.map +1 -0
- package/dist/abVariantContext-CWCdRSdG.js +549 -0
- package/dist/abVariantContext-CWCdRSdG.js.map +1 -0
- package/dist/abVariantContext-Cqp-uxtd.cjs +678 -0
- package/dist/abVariantContext-Cqp-uxtd.cjs.map +1 -0
- package/dist/adapters/observability/client/sentry.d.ts +42 -0
- package/dist/adapters/observability/client/sentry.d.ts.map +1 -0
- package/dist/adapters/observability/index.cjs +152 -0
- package/dist/adapters/observability/index.cjs.map +1 -0
- package/dist/adapters/observability/index.d.ts +17 -0
- package/dist/adapters/observability/index.d.ts.map +1 -0
- package/dist/adapters/observability/index.js +148 -0
- package/dist/adapters/observability/index.js.map +1 -0
- package/dist/adapters/observability/server/datadog.d.ts +45 -0
- package/dist/adapters/observability/server/datadog.d.ts.map +1 -0
- package/dist/adapters/observability/server/otel.d.ts +51 -0
- package/dist/adapters/observability/server/otel.d.ts.map +1 -0
- package/dist/adapters/observability/server/sentry.d.ts +67 -0
- package/dist/adapters/observability/server/sentry.d.ts.map +1 -0
- package/dist/adapters/observability/types.d.ts +39 -0
- package/dist/adapters/observability/types.d.ts.map +1 -0
- package/dist/adapters/runtime/cloudflare.d.ts +33 -0
- package/dist/adapters/runtime/cloudflare.d.ts.map +1 -0
- package/dist/adapters/runtime/errorResponse.d.ts +3 -0
- package/dist/adapters/runtime/errorResponse.d.ts.map +1 -0
- package/dist/adapters/runtime/index.cjs +100 -0
- package/dist/adapters/runtime/index.cjs.map +1 -0
- package/dist/adapters/runtime/index.d.ts +10 -0
- package/dist/adapters/runtime/index.d.ts.map +1 -0
- package/dist/adapters/runtime/index.js +97 -0
- package/dist/adapters/runtime/index.js.map +1 -0
- package/dist/adapters/runtime/types.d.ts +24 -0
- package/dist/adapters/runtime/types.d.ts.map +1 -0
- package/dist/adapters/runtime/vercel-edge.d.ts +59 -0
- package/dist/adapters/runtime/vercel-edge.d.ts.map +1 -0
- package/dist/app/createISRApp.d.ts +19 -0
- package/dist/app/createISRApp.d.ts.map +1 -0
- package/dist/cache/CacheManager.d.ts +81 -0
- package/dist/cache/CacheManager.d.ts.map +1 -0
- package/dist/cache/ICacheAdapter.d.ts +84 -0
- package/dist/cache/ICacheAdapter.d.ts.map +1 -0
- package/dist/cache/MemoryCacheAdapter.d.ts +50 -0
- package/dist/cache/MemoryCacheAdapter.d.ts.map +1 -0
- package/dist/cache/RedisCacheAdapter.d.ts +111 -0
- package/dist/cache/RedisCacheAdapter.d.ts.map +1 -0
- package/dist/cache/RedisInvalidationBus.d.ts +59 -0
- package/dist/cache/RedisInvalidationBus.d.ts.map +1 -0
- package/dist/cache/RedisResponseCacheBackend.d.ts +30 -0
- package/dist/cache/RedisResponseCacheBackend.d.ts.map +1 -0
- package/dist/cache/ResponseCacheBackend.d.ts +28 -0
- package/dist/cache/ResponseCacheBackend.d.ts.map +1 -0
- package/dist/cache/createAutoCacheStore.d.ts +26 -0
- package/dist/cache/createAutoCacheStore.d.ts.map +1 -0
- package/dist/cache/index.d.ts +18 -0
- package/dist/cache/index.d.ts.map +1 -0
- package/dist/cli/cli.cjs +372 -0
- package/dist/cli/cli.cjs.map +1 -0
- package/dist/cli/cli.d.ts +8 -0
- package/dist/cli/cli.d.ts.map +1 -0
- package/dist/cli/cli.js +370 -0
- package/dist/cli/cli.js.map +1 -0
- package/dist/cli/dev.d.ts +11 -0
- package/dist/cli/dev.d.ts.map +1 -0
- package/dist/cli/fallback.d.ts +42 -0
- package/dist/cli/fallback.d.ts.map +1 -0
- package/dist/cli/serverOptions.d.ts +7 -0
- package/dist/cli/serverOptions.d.ts.map +1 -0
- package/dist/cli/start.d.ts +7 -0
- package/dist/cli/start.d.ts.map +1 -0
- package/dist/config/defaults.d.ts +11 -0
- package/dist/config/defaults.d.ts.map +1 -0
- package/dist/config/defineConfig.cjs +26 -0
- package/dist/config/defineConfig.cjs.map +1 -0
- package/dist/config/defineConfig.d.ts +44 -0
- package/dist/config/defineConfig.d.ts.map +1 -0
- package/dist/config/defineConfig.js +24 -0
- package/dist/config/defineConfig.js.map +1 -0
- package/dist/config/getEnv.d.ts +9 -0
- package/dist/config/getEnv.d.ts.map +1 -0
- package/dist/config/getStatus.d.ts +3 -0
- package/dist/config/getStatus.d.ts.map +1 -0
- package/dist/config/loadConfig.d.ts +18 -0
- package/dist/config/loadConfig.d.ts.map +1 -0
- package/dist/config/normalizeEngineConfig.d.ts +10 -0
- package/dist/config/normalizeEngineConfig.d.ts.map +1 -0
- package/dist/config/resolveImageOptions.d.ts +5 -0
- package/dist/config/resolveImageOptions.d.ts.map +1 -0
- package/dist/config/resolveRuntimeRedis.d.ts +11 -0
- package/dist/config/resolveRuntimeRedis.d.ts.map +1 -0
- package/dist/context/RequestContext.d.ts +28 -0
- package/dist/context/RequestContext.d.ts.map +1 -0
- package/dist/context/createServerRequestContext.d.ts +42 -0
- package/dist/context/createServerRequestContext.d.ts.map +1 -0
- package/dist/createCacheInspectorMiddleware-B32Suct_.js +105 -0
- package/dist/createCacheInspectorMiddleware-B32Suct_.js.map +1 -0
- package/dist/createCacheInspectorMiddleware-CAzxgGNh.cjs +105 -0
- package/dist/createCacheInspectorMiddleware-CAzxgGNh.cjs.map +1 -0
- package/dist/createISRApp-Bvs5_63N.cjs +7663 -0
- package/dist/createISRApp-Bvs5_63N.cjs.map +1 -0
- package/dist/createISRApp-CfGFTcw-.js +7322 -0
- package/dist/createISRApp-CfGFTcw-.js.map +1 -0
- package/dist/createImagePlugin-BHVUkFBd.js +416 -0
- package/dist/createImagePlugin-BHVUkFBd.js.map +1 -0
- package/dist/createImagePlugin-C-hHZCqj.cjs +435 -0
- package/dist/createImagePlugin-C-hHZCqj.cjs.map +1 -0
- package/dist/defaults/auto-observability.cjs +147 -0
- package/dist/defaults/auto-observability.cjs.map +1 -0
- package/dist/defaults/auto-observability.d.ts +21 -0
- package/dist/defaults/auto-observability.d.ts.map +1 -0
- package/dist/defaults/auto-observability.js +144 -0
- package/dist/defaults/auto-observability.js.map +1 -0
- package/dist/defaults/runtime/browserObservability.d.ts +73 -0
- package/dist/defaults/runtime/browserObservability.d.ts.map +1 -0
- package/dist/defaults/runtime/client-navigation-policy.d.ts +10 -0
- package/dist/defaults/runtime/client-navigation-policy.d.ts.map +1 -0
- package/dist/defaults/runtime/createCachedFetcher.d.ts +17 -0
- package/dist/defaults/runtime/createCachedFetcher.d.ts.map +1 -0
- package/dist/defaults/runtime/defineSiteHooks.cjs +11 -0
- package/dist/defaults/runtime/defineSiteHooks.d.ts +197 -0
- package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -0
- package/dist/defaults/runtime/defineSiteHooks.js +3 -0
- package/dist/defaults/runtime/dev-css-handoff.client.d.ts +2 -0
- package/dist/defaults/runtime/dev-css-handoff.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-render-inspector.d.ts +57 -0
- package/dist/defaults/runtime/dev-render-inspector.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-rsc-response.client.d.ts +7 -0
- package/dist/defaults/runtime/dev-rsc-response.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts +9 -0
- package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-declarations.server.d.ts +15 -0
- package/dist/defaults/runtime/dev-style-declarations.server.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-id.d.ts +9 -0
- package/dist/defaults/runtime/dev-style-id.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-navigation.client.d.ts +26 -0
- package/dist/defaults/runtime/dev-style-navigation.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-registry.client.d.ts +19 -0
- package/dist/defaults/runtime/dev-style-registry.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts +4 -0
- package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts.map +1 -0
- package/dist/defaults/runtime/empty-routes.d.ts +3 -0
- package/dist/defaults/runtime/empty-routes.d.ts.map +1 -0
- package/dist/defaults/runtime/error-boundary.d.ts +9 -0
- package/dist/defaults/runtime/error-boundary.d.ts.map +1 -0
- package/dist/defaults/runtime/error500-template.d.ts +21 -0
- package/dist/defaults/runtime/error500-template.d.ts.map +1 -0
- package/dist/defaults/runtime/head-extras-runtime.d.ts +17 -0
- package/dist/defaults/runtime/head-extras-runtime.d.ts.map +1 -0
- package/dist/defaults/runtime/hydration-shell.d.ts +12 -0
- package/dist/defaults/runtime/hydration-shell.d.ts.map +1 -0
- package/dist/defaults/runtime/i18n-server.d.ts +7 -0
- package/dist/defaults/runtime/i18n-server.d.ts.map +1 -0
- package/dist/defaults/runtime/navigation-history.client.d.ts +16 -0
- package/dist/defaults/runtime/navigation-history.client.d.ts.map +1 -0
- package/dist/defaults/runtime/navigation-request.client.d.ts +5 -0
- package/dist/defaults/runtime/navigation-request.client.d.ts.map +1 -0
- package/dist/defaults/runtime/seo-runtime.d.ts +41 -0
- package/dist/defaults/runtime/seo-runtime.d.ts.map +1 -0
- package/dist/defineSiteHooks-BeVy-qPH.js +720 -0
- package/dist/defineSiteHooks-BeVy-qPH.js.map +1 -0
- package/dist/defineSiteHooks-C3v3WLS8.cjs +755 -0
- package/dist/defineSiteHooks-C3v3WLS8.cjs.map +1 -0
- package/dist/discovery/componentDiscovery.d.ts +71 -0
- package/dist/discovery/componentDiscovery.d.ts.map +1 -0
- package/dist/discovery/directiveParser.d.ts +197 -0
- package/dist/discovery/directiveParser.d.ts.map +1 -0
- package/dist/discovery/exportParser.d.ts +45 -0
- package/dist/discovery/exportParser.d.ts.map +1 -0
- package/dist/discovery/fileSystem.d.ts +33 -0
- package/dist/discovery/fileSystem.d.ts.map +1 -0
- package/dist/discovery/index.d.ts +18 -0
- package/dist/discovery/index.d.ts.map +1 -0
- package/dist/discovery/routeDiscovery.d.ts +121 -0
- package/dist/discovery/routeDiscovery.d.ts.map +1 -0
- package/dist/discovery/scan.d.ts +54 -0
- package/dist/discovery/scan.d.ts.map +1 -0
- package/dist/discovery/types.d.ts +61 -0
- package/dist/discovery/types.d.ts.map +1 -0
- package/dist/engine/ISREngine.d.ts +54 -0
- package/dist/engine/ISREngine.d.ts.map +1 -0
- package/dist/engine/RenderMode.d.ts +23 -0
- package/dist/engine/RenderMode.d.ts.map +1 -0
- package/dist/engine/i18n/types.d.ts +6 -0
- package/dist/engine/i18n/types.d.ts.map +1 -0
- package/dist/engine/seo/PageSeoMeta.d.ts +9 -0
- package/dist/engine/seo/PageSeoMeta.d.ts.map +1 -0
- package/dist/engine/seo/SEOEngine.d.ts +61 -0
- package/dist/engine/seo/SEOEngine.d.ts.map +1 -0
- package/dist/engine/seo/config.d.ts +9 -0
- package/dist/engine/seo/config.d.ts.map +1 -0
- package/dist/engine/seo/index.d.ts +10 -0
- package/dist/engine/seo/index.d.ts.map +1 -0
- package/dist/engine/seo/injectSeoMeta.d.ts +5 -0
- package/dist/engine/seo/injectSeoMeta.d.ts.map +1 -0
- package/dist/engine/seo/resolveSeoConfig.d.ts +15 -0
- package/dist/engine/seo/resolveSeoConfig.d.ts.map +1 -0
- package/dist/engine/seo/types.d.ts +75 -0
- package/dist/engine/seo/types.d.ts.map +1 -0
- package/dist/error500-template-BvZmvKoa.cjs +63 -0
- package/dist/error500-template-BvZmvKoa.cjs.map +1 -0
- package/dist/error500-template-DhaZzLOB.js +63 -0
- package/dist/error500-template-DhaZzLOB.js.map +1 -0
- package/dist/experiments/ExposureQueue.d.ts +54 -0
- package/dist/experiments/ExposureQueue.d.ts.map +1 -0
- package/dist/experiments/ManifestLoader.d.ts +57 -0
- package/dist/experiments/ManifestLoader.d.ts.map +1 -0
- package/dist/i18n-CyJIoYJT.cjs +244 -0
- package/dist/i18n-CyJIoYJT.cjs.map +1 -0
- package/dist/i18n-Dobe0Wxn.js +191 -0
- package/dist/i18n-Dobe0Wxn.js.map +1 -0
- package/dist/image/index.cjs +93 -0
- package/dist/image/index.cjs.map +1 -0
- package/dist/image/index.js +67 -0
- package/dist/image/index.js.map +1 -0
- package/dist/index.d.ts +59 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/isr/ISRRoutes.d.ts +25 -0
- package/dist/isr/ISRRoutes.d.ts.map +1 -0
- package/dist/isr-engine.cjs +2830 -0
- package/dist/isr-engine.cjs.map +1 -0
- package/dist/isr-engine.js +2740 -0
- package/dist/isr-engine.js.map +1 -0
- package/dist/logger/Logger.d.ts +33 -0
- package/dist/logger/Logger.d.ts.map +1 -0
- package/dist/logger/index.d.ts +3 -0
- package/dist/logger/index.d.ts.map +1 -0
- package/dist/manifest/ManifestLoader.d.ts +98 -0
- package/dist/manifest/ManifestLoader.d.ts.map +1 -0
- package/dist/manifest/index.d.ts +8 -0
- package/dist/manifest/index.d.ts.map +1 -0
- package/dist/manifest/types.d.ts +76 -0
- package/dist/manifest/types.d.ts.map +1 -0
- package/dist/metrics/MetricsCollector.d.ts +90 -0
- package/dist/metrics/MetricsCollector.d.ts.map +1 -0
- package/dist/metrics/PromMetrics.d.ts +59 -0
- package/dist/metrics/PromMetrics.d.ts.map +1 -0
- package/dist/metrics/index.d.ts +7 -0
- package/dist/metrics/index.d.ts.map +1 -0
- package/dist/middlewares/ABVariantMiddleware.d.ts +74 -0
- package/dist/middlewares/ABVariantMiddleware.d.ts.map +1 -0
- package/dist/middlewares/LocaleRedirect.d.ts +27 -0
- package/dist/middlewares/LocaleRedirect.d.ts.map +1 -0
- package/dist/middlewares/MiddlewareComposer.d.ts +20 -0
- package/dist/middlewares/MiddlewareComposer.d.ts.map +1 -0
- package/dist/middlewares/PerformanceMiddleware.d.ts +14 -0
- package/dist/middlewares/PerformanceMiddleware.d.ts.map +1 -0
- package/dist/middlewares/TraceMiddleware.d.ts +24 -0
- package/dist/middlewares/TraceMiddleware.d.ts.map +1 -0
- package/dist/middlewares/abVariantContext.d.ts +7 -0
- package/dist/middlewares/abVariantContext.d.ts.map +1 -0
- package/dist/middlewares/index.d.ts +5 -0
- package/dist/middlewares/index.d.ts.map +1 -0
- package/dist/middlewares/types.d.ts +4 -0
- package/dist/middlewares/types.d.ts.map +1 -0
- package/dist/plugin/clientObservabilityConfig.d.ts +16 -0
- package/dist/plugin/clientObservabilityConfig.d.ts.map +1 -0
- package/dist/plugin/coherentCacheStore.d.ts +11 -0
- package/dist/plugin/coherentCacheStore.d.ts.map +1 -0
- package/dist/plugin/createAutomaticImagePlugin.d.ts +4 -0
- package/dist/plugin/createAutomaticImagePlugin.d.ts.map +1 -0
- package/dist/plugin/createCacheInspectorMiddleware.d.ts +16 -0
- package/dist/plugin/createCacheInspectorMiddleware.d.ts.map +1 -0
- package/dist/plugin/createDevCssHandoffPlugin.d.ts +25 -0
- package/dist/plugin/createDevCssHandoffPlugin.d.ts.map +1 -0
- package/dist/plugin/createFontPlugin.d.ts +15 -0
- package/dist/plugin/createFontPlugin.d.ts.map +1 -0
- package/dist/plugin/createImagePlugin.d.ts +46 -0
- package/dist/plugin/createImagePlugin.d.ts.map +1 -0
- package/dist/plugin/createIsrPlugin.d.ts +43 -0
- package/dist/plugin/createIsrPlugin.d.ts.map +1 -0
- package/dist/plugin/createSsgPostBuildPlugin.d.ts +4 -0
- package/dist/plugin/createSsgPostBuildPlugin.d.ts.map +1 -0
- package/dist/plugin/devAssetRequestMiddleware.d.ts +10 -0
- package/dist/plugin/devAssetRequestMiddleware.d.ts.map +1 -0
- package/dist/plugin/index.d.ts +11 -0
- package/dist/plugin/index.d.ts.map +1 -0
- package/dist/plugin/isrCacheMiddleware.d.ts +223 -0
- package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -0
- package/dist/plugin/isrCacheStore.d.ts +88 -0
- package/dist/plugin/isrCacheStore.d.ts.map +1 -0
- package/dist/plugin/remoteImageSource.d.ts +19 -0
- package/dist/plugin/remoteImageSource.d.ts.map +1 -0
- package/dist/plugin/transformDevCssModule.d.ts +3 -0
- package/dist/plugin/transformDevCssModule.d.ts.map +1 -0
- package/dist/renderer/RenderHeaders.d.ts +28 -0
- package/dist/renderer/RenderHeaders.d.ts.map +1 -0
- package/dist/rolldown-runtime-D7D4PA-g.js +13 -0
- package/dist/rolldown-runtime-DakpK96I.cjs +43 -0
- package/dist/route/RouteManager.d.ts +22 -0
- package/dist/route/RouteManager.d.ts.map +1 -0
- package/dist/route/index.d.ts +2 -0
- package/dist/route/index.d.ts.map +1 -0
- package/dist/rsc/ServerActions.d.ts +65 -0
- package/dist/rsc/ServerActions.d.ts.map +1 -0
- package/dist/rsc/browser.cjs +109 -0
- package/dist/rsc/browser.cjs.map +1 -0
- package/dist/rsc/browser.d.ts +59 -0
- package/dist/rsc/browser.d.ts.map +1 -0
- package/dist/rsc/browser.js +85 -0
- package/dist/rsc/browser.js.map +1 -0
- package/dist/rsc/cacheTag.d.ts +52 -0
- package/dist/rsc/cacheTag.d.ts.map +1 -0
- package/dist/rsc/constants.d.ts +10 -0
- package/dist/rsc/constants.d.ts.map +1 -0
- package/dist/rsc/i18n.d.ts +3 -0
- package/dist/rsc/i18n.d.ts.map +1 -0
- package/dist/rsc/index.cjs +33 -0
- package/dist/rsc/index.d.ts +20 -0
- package/dist/rsc/index.d.ts.map +1 -0
- package/dist/rsc/index.js +4 -0
- package/dist/rsc/revalidate.d.ts +77 -0
- package/dist/rsc/revalidate.d.ts.map +1 -0
- package/dist/rsc-H7D_meHu.cjs +239 -0
- package/dist/rsc-H7D_meHu.cjs.map +1 -0
- package/dist/rsc-lvWPTuVD.js +168 -0
- package/dist/rsc-lvWPTuVD.js.map +1 -0
- package/dist/runtime/Image.d.ts +48 -0
- package/dist/runtime/Image.d.ts.map +1 -0
- package/dist/runtime/LocaleContext.d.ts +14 -0
- package/dist/runtime/LocaleContext.d.ts.map +1 -0
- package/dist/runtime/boundary.d.ts +27 -0
- package/dist/runtime/boundary.d.ts.map +1 -0
- package/dist/runtime/edge-context.d.ts +17 -0
- package/dist/runtime/edge-context.d.ts.map +1 -0
- package/dist/runtime/i18n-store.d.ts +11 -0
- package/dist/runtime/i18n-store.d.ts.map +1 -0
- package/dist/runtime/i18n.d.ts +115 -0
- package/dist/runtime/i18n.d.ts.map +1 -0
- package/dist/runtime/index.d.ts +16 -0
- package/dist/runtime/index.d.ts.map +1 -0
- package/dist/runtime/routes.d.ts +88 -0
- package/dist/runtime/routes.d.ts.map +1 -0
- package/dist/runtime/telemetry.d.ts +48 -0
- package/dist/runtime/telemetry.d.ts.map +1 -0
- package/dist/security/cspNonceTemplate.d.ts +10 -0
- package/dist/security/cspNonceTemplate.d.ts.map +1 -0
- package/dist/security/staticCspManifest.d.ts +37 -0
- package/dist/security/staticCspManifest.d.ts.map +1 -0
- package/dist/server/httpServer.d.ts +17 -0
- package/dist/server/httpServer.d.ts.map +1 -0
- package/dist/server/index.d.ts +3 -0
- package/dist/server/index.d.ts.map +1 -0
- package/dist/server/manager.d.ts +17 -0
- package/dist/server/manager.d.ts.map +1 -0
- package/dist/server/middleware.d.ts +87 -0
- package/dist/server/middleware.d.ts.map +1 -0
- package/dist/server/opsConfig.d.ts +17 -0
- package/dist/server/opsConfig.d.ts.map +1 -0
- package/dist/server/productionRuntime.d.ts +41 -0
- package/dist/server/productionRuntime.d.ts.map +1 -0
- package/dist/server/types.d.ts +41 -0
- package/dist/server/types.d.ts.map +1 -0
- package/dist/server/viteDevServer.d.ts +21 -0
- package/dist/server/viteDevServer.d.ts.map +1 -0
- package/dist/ssg/spider.d.ts +142 -0
- package/dist/ssg/spider.d.ts.map +1 -0
- package/dist/types/IFlightData.d.ts +23 -0
- package/dist/types/IFlightData.d.ts.map +1 -0
- package/dist/types/IHelmetData.d.ts +24 -0
- package/dist/types/IHelmetData.d.ts.map +1 -0
- package/dist/types/IRenderMetadata.d.ts +46 -0
- package/dist/types/IRenderMetadata.d.ts.map +1 -0
- package/dist/types/IRenderResult.d.ts +16 -0
- package/dist/types/IRenderResult.d.ts.map +1 -0
- package/dist/types/ISRConfig.d.ts +463 -0
- package/dist/types/ISRConfig.d.ts.map +1 -0
- package/dist/types/ISRContext.d.ts +104 -0
- package/dist/types/ISRContext.d.ts.map +1 -0
- package/dist/types/index.d.ts +7 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/utils/CacheCleanup.d.ts +32 -0
- package/dist/utils/CacheCleanup.d.ts.map +1 -0
- package/dist/utils/cacheDuration.d.ts +12 -0
- package/dist/utils/cacheDuration.d.ts.map +1 -0
- package/dist/utils/cookie.d.ts +7 -0
- package/dist/utils/cookie.d.ts.map +1 -0
- package/dist/utils/hash.d.ts +22 -0
- package/dist/utils/hash.d.ts.map +1 -0
- package/dist/utils/htmlPathname.d.ts +12 -0
- package/dist/utils/htmlPathname.d.ts.map +1 -0
- package/dist/utils/index.d.ts +9 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/resolveFetchHandler.d.ts +4 -0
- package/dist/utils/resolveFetchHandler.d.ts.map +1 -0
- package/dist/utils/trimTrailingSlashes.d.ts +3 -0
- package/dist/utils/trimTrailingSlashes.d.ts.map +1 -0
- package/package.json +200 -4
- package/src/context/RequestContext.ts +68 -0
- package/src/context/createServerRequestContext.ts +104 -0
- package/src/defaults/auto-observability.ts +195 -0
- package/src/defaults/entry.server.ssr.tsx +257 -0
- package/src/defaults/entry.server.tsx +117 -0
- package/src/defaults/entry.tsx +23 -0
- package/src/defaults/runtime/browserObservability.ts +839 -0
- package/src/defaults/runtime/client-navigation-policy.ts +67 -0
- package/src/defaults/runtime/createCachedFetcher.ts +121 -0
- package/src/defaults/runtime/defineClientEntry.tsx +773 -0
- package/src/defaults/runtime/defineServerEntry.tsx +421 -0
- package/src/defaults/runtime/defineSiteHooks.ts +1073 -0
- package/src/defaults/runtime/dev-css-handoff.client.ts +5 -0
- package/src/defaults/runtime/dev-render-inspector.ts +597 -0
- package/src/defaults/runtime/dev-rsc-response.client.ts +48 -0
- package/src/defaults/runtime/dev-style-commit-boundary.client.tsx +20 -0
- package/src/defaults/runtime/dev-style-declarations.server.ts +158 -0
- package/src/defaults/runtime/dev-style-id.ts +91 -0
- package/src/defaults/runtime/dev-style-navigation.client.ts +152 -0
- package/src/defaults/runtime/dev-style-registry.client.ts +744 -0
- package/src/defaults/runtime/dev-style-resource-dispatcher.server.ts +42 -0
- package/src/defaults/runtime/empty-config.ts +5 -0
- package/src/defaults/runtime/empty-routes.ts +2 -0
- package/src/defaults/runtime/error-boundary.style.css +35 -0
- package/src/defaults/runtime/error-boundary.tsx +65 -0
- package/src/defaults/runtime/error500-template.ts +66 -0
- package/src/defaults/runtime/head-extras-runtime.ts +64 -0
- package/src/defaults/runtime/hydration-shell.tsx +20 -0
- package/src/defaults/runtime/i18n-server.ts +27 -0
- package/src/defaults/runtime/navigation-history.client.ts +80 -0
- package/src/defaults/runtime/navigation-request.client.ts +21 -0
- package/src/defaults/runtime/request.tsx +100 -0
- package/src/defaults/runtime/seo-runtime.ts +257 -0
- package/src/defaults/tsconfig.json +10 -0
- package/src/defaults/types.d.ts +23 -0
- package/src/runtime/Image.tsx +124 -0
- package/src/runtime/LocaleContext.tsx +38 -0
- package/src/runtime/boundary.module.css +46 -0
- package/src/runtime/boundary.tsx +136 -0
- package/src/runtime/edge-context.ts +32 -0
- package/src/runtime/i18n-store.ts +76 -0
- package/src/runtime/i18n.ts +189 -0
- package/src/runtime/index.ts +61 -0
- package/src/runtime/routes.tsx +247 -0
- package/src/runtime/scss.d.ts +13 -0
- package/src/runtime/telemetry.ts +116 -0
- package/src/types/IFlightData.ts +27 -0
- package/src/types/IHelmetData.ts +9 -0
- package/src/types/IRenderMetadata.ts +52 -0
- package/src/types/IRenderResult.ts +16 -0
- package/src/types/ISRConfig.ts +512 -0
- package/src/types/ISRContext.ts +106 -0
- package/src/types/index.ts +6 -0
- package/src/utils/CacheCleanup.ts +74 -0
- package/src/utils/cacheDuration.ts +37 -0
- package/src/utils/cookie.ts +59 -0
- package/src/utils/hash.ts +32 -0
- package/src/utils/htmlPathname.ts +75 -0
- package/src/utils/index.ts +9 -0
- package/src/utils/resolveFetchHandler.ts +19 -0
- package/src/utils/trimTrailingSlashes.ts +6 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defineSiteHooks-C3v3WLS8.cjs","names":[],"sources":["../src/defaults/runtime/createCachedFetcher.ts","../src/defaults/runtime/defineSiteHooks.ts"],"sourcesContent":["/**\n * createCachedFetcher —— 通用 TTL + 并发去重数据加载器\n *\n * 设计目标:\n * - 给 i18n / SEO 这类「url 或本地 json」加载场景一个唯一的成熟实现\n * - 同 key 的并发请求自动合并为一次(避免缓存击穿)\n * - 过期后台刷新可选(SWR 模式)\n *\n * 用例:\n * const loadMessages = createCachedFetcher<IntlPayload>({\n * key: ({ locale }) => `intl:${locale}`,\n * ttl: 60_000,\n * fetch: async ({ locale }) => {\n * const r = await fetch(`https://cdn.example.com/i18n/${locale}.json`);\n * return r.json();\n * },\n * });\n *\n * // 在 hook 里用:\n * loadIntl: (url) => loadMessages({ locale: detectLocale(url) }),\n */\n/**\n * 极简 LRU —— 利用 Map 的插入顺序保留特性\n *\n * 不引外部 lru-cache 包是为了规避用户 RSC bundle 的 ESM/CJS interop 抖动\n * (lru-cache@10 双发布在 rolldown 里偶发 default vs 命名导出错位)\n * 本文件用于 i18n / SEO 数据的请求级缓存(典型 < 100 条),简单 Map 完全够用\n */\nclass TinyLRU<K, V> {\n private store = new Map<K, V>();\n constructor(private max: number) {}\n get(k: K): V | undefined {\n const v = this.store.get(k);\n if (v !== undefined) {\n // 触发 LRU:删后再 set,使其变成最新插入\n this.store.delete(k);\n this.store.set(k, v);\n }\n return v;\n }\n set(k: K, v: V): void {\n if (this.store.has(k)) this.store.delete(k);\n this.store.set(k, v);\n if (this.store.size > this.max) {\n const oldest = this.store.keys().next().value;\n if (oldest !== undefined) this.store.delete(oldest);\n }\n }\n}\n\nexport interface CachedFetcherOptions<TArg, TValue> {\n /** 从入参生成缓存 key */\n key: (arg: TArg) => string;\n /** 实际加载逻辑(network / fs / dynamic import 都可) */\n fetch: (arg: TArg) => Promise<TValue>;\n /** 缓存 TTL(毫秒),默认 60s */\n ttl?: number;\n /** LRU 容量,默认 500 */\n max?: number;\n /** 启用 stale-while-revalidate:过期仍返回旧值,后台异步刷新(默认 false) */\n swr?: boolean;\n /** 拉取失败时的回退值(如不提供则抛错) */\n fallback?: (arg: TArg, error: unknown) => TValue | Promise<TValue>;\n}\n\ninterface Entry<T> {\n value: T;\n expiresAt: number;\n}\n\nexport type CachedFetcher<TArg, TValue> = (arg: TArg) => Promise<TValue>;\n\nexport function createCachedFetcher<TArg, TValue>(\n opts: CachedFetcherOptions<TArg, TValue>\n): CachedFetcher<TArg, TValue> {\n const ttl = opts.ttl ?? 60_000;\n const max = opts.max ?? 500;\n const cache = new TinyLRU<string, Entry<TValue>>(max);\n const inflight = new Map<string, Promise<TValue>>();\n\n async function load(arg: TArg): Promise<TValue> {\n try {\n const v = await opts.fetch(arg);\n cache.set(opts.key(arg), { value: v, expiresAt: Date.now() + ttl });\n return v;\n } catch (err) {\n if (opts.fallback) return await opts.fallback(arg, err);\n throw err;\n }\n }\n\n return async function cachedFetcher(arg: TArg): Promise<TValue> {\n const key = opts.key(arg);\n const entry = cache.get(key);\n const now = Date.now();\n\n if (entry && entry.expiresAt > now) {\n return entry.value;\n }\n\n if (entry && opts.swr) {\n // SWR:返回旧值,后台刷新(不阻塞);如已有 in-flight 则不重复触发\n if (!inflight.has(key)) {\n const p = load(arg).finally(() => inflight.delete(key));\n inflight.set(key, p);\n p.catch(() => {\n /* 后台刷新失败保留旧值 */\n });\n }\n return entry.value;\n }\n\n // miss 或非 SWR 过期:合并并发到同一个 promise\n const existing = inflight.get(key);\n if (existing) return existing;\n\n const p = load(arg).finally(() => inflight.delete(key));\n inflight.set(key, p);\n return p;\n };\n}\n","/**\n * defineSiteHooks —— 高阶 FaaS hooks 工厂(声明式配置 → 完整 ServerEntryHooks)\n *\n * 让用户的 src/entry.server.tsx 收紧到「只写请求期 hooks」。\n * 部署/平台配置(api/site/redis/experiments/i18n/seo/telemetry)放\n * ssr.config.ts 的 runtime 字段;entry.server.tsx 只保留 beforeRequest / onError。\n * 注:experiments 是 experimentation platform 的通用字段名,业务侧可理解为 A/B testing。\n * 内部固化:\n * - i18n 字典缓存(createCachedFetcher: TTL/SWR/dedup/fallback)\n * - SEO 路由表 pattern → resolver\n * - locale 检测(cookie → Accept-Language → 默认)\n * - i18n/seo 远端相对 endpoint 统一使用 runtime.services.api\n * - 服务端渲染错误打印 + runtime.telemetry errors endpoint 上报\n *\n * beforeRequest 的边界:\n * - 它在每次 HTTP/RSC 请求进入渲染前执行。\n * - 返回值会合并进 RequestContext,Server Component 用 getRequestContext() 读取。\n * - 适合放 userId / tenantId / requestSegment 这类请求现场字段。\n * - 不适合放 Redis、SEO、i18n、A/B 定义、慢 API 或数据库查询。\n * - A/B variant 由 runtime.experiments + engine middleware 注入,页面用 getVariant()。\n *\n * 用户态写法(商业项目推荐):\n * import { defineAdminSiteHooks } from 'isr-engine/site-hooks';\n *\n * export default defineAdminSiteHooks({\n * beforeRequest: req => ({\n * userId: req.headers.get('x-user-id') ?? undefined,\n * tenantId: req.headers.get('x-tenant-id') ?? 'public',\n * requestSegment: req.headers.get('x-segment') ?? 'default',\n * }),\n * });\n */\nimport { trimTrailingSlashes } from '../../utils/trimTrailingSlashes';\nimport { createCachedFetcher } from './createCachedFetcher';\nimport type { IntlPayload, PageSeoMeta } from './seo-runtime';\nimport type {\n DynamicSeoResolver,\n ISRConfig,\n RuntimeI18nConfig,\n RuntimeSeoConfig,\n} from '../../types';\nimport { readCookie } from '../../utils/cookie';\nimport { parseLocale, type I18nConfig } from '../../runtime/i18n';\n\nexport { getCookieHeader, parseCookieHeader, readCookie } from '../../utils/cookie';\n\nexport type SiteRuntimeConfig = ISRConfig['runtime'];\n\nexport interface SiteRuntimeContext {\n runtime: SiteRuntimeConfig;\n services: RuntimeServices;\n telemetry?: string;\n site?: string;\n}\n\nexport interface RuntimeServices {\n api?: string;\n telemetry?: string;\n}\n\nfunction createEmptyRuntimeConfig(): SiteRuntimeConfig {\n return {\n site: undefined,\n services: { api: undefined, telemetry: undefined },\n redis: undefined,\n experiments: {},\n i18n: undefined,\n seo: undefined,\n telemetry: false,\n };\n}\n\nexport type RuntimeServiceBase = string | ((ctx: SiteRuntimeContext) => string | null | undefined);\n\nexport type IntlMessagesByLocale = Record<string, Record<string, unknown>>;\n\nexport interface CreateAdminIntlLoaderOptions {\n /** 远端字典端点;相对路径会用 runtime.services.api 拼接 */\n endpoint?: string;\n /** 本地兜底字典,通常来自 ssr.config.ts runtime.i18n.fallbackLocal */\n fallbackMessages?: IntlMessagesByLocale;\n /** 远端和本地都无法命中时使用的 locale */\n defaultLocale?: string;\n /** 远端请求超时,默认 1200ms */\n timeoutMs?: number;\n /** 响应头 / dev inspector 里显示的远端来源名 */\n remoteSource?: string;\n /** 响应头 / dev inspector 里显示的 fallback 来源名 */\n fallbackSource?: string;\n}\n\nexport interface AdminSeoFallbackEntry extends PageSeoMeta {\n path: string;\n group?: string;\n}\n\nexport interface CreateAdminSeoLoaderOptions {\n /** 远端 SEO 端点;支持 {pathname} 和路由 params 占位符 */\n endpoint?: string;\n /** 本地兜底 SEO 条目,通常来自 ssr.config.ts runtime.seo.fallbackLocal */\n fallbackEntries?: readonly AdminSeoFallbackEntry[];\n /** 远端请求超时,默认 1200ms */\n timeoutMs?: number;\n /**\n * 参数化路径解析器;admin endpoint 没命中且 fallback 也没命中时按 pattern 匹配\n * 调一个用户函数。让业务页面零 SEO 代码,所有动态 SEO 集中在 ssr.config.ts。\n */\n dynamicResolvers?: readonly DynamicSeoResolver[];\n}\n\n/**\n * 内部用:把 `/books/:id` 这种 pattern 编译成 RegExp + 参数名列表。\n * `:name` 匹配单段(不跨 /)。`*` 匹配任意后缀(包括 /),收成 \":wildcard\" param。\n * 编译后缓存,避免每次请求重算。\n */\ninterface CompiledSeoResolver {\n re: RegExp;\n paramNames: string[];\n resolver: DynamicSeoResolver;\n}\n\nfunction compileSeoResolver(resolver: DynamicSeoResolver): CompiledSeoResolver {\n const paramNames: string[] = [];\n const reSrc = resolver.pattern\n .replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&')\n .replace(/:([A-Za-z_][A-Za-z0-9_]*)|\\\\\\*/g, (m, name) => {\n if (m === '\\\\*') {\n paramNames.push('wildcard');\n return '(.*)';\n }\n paramNames.push(name);\n return '([^/]+)';\n });\n return {\n re: new RegExp(`^${reSrc}$`),\n paramNames,\n resolver,\n };\n}\n\nexport interface DefineAdminSiteHooksOptions {\n i18n?: {\n locales?: readonly string[];\n defaultLocale?: string;\n endpoint?: string;\n ttl?: number;\n prefixDefault?: boolean;\n detect?: IntlConfig['detect'];\n fallbackLocal?: IntlMessagesByLocale;\n timeoutMs?: number;\n remoteSource?: string;\n fallbackSource?: string;\n };\n seo?: {\n endpoint?: string;\n ttl?: number;\n fallbackLocal?: readonly Record<string, unknown>[];\n timeoutMs?: number;\n /** 参数化路径的 SEO 解析器(参考 RuntimeSeoConfig.dynamicResolvers)。 */\n dynamicResolvers?: readonly DynamicSeoResolver[];\n };\n beforeRequest?: SiteHooksConfig['beforeRequest'];\n onError?: SiteHooksConfig['onError'];\n headExtras?: SiteHooksConfig['headExtras'];\n}\n\nexport interface IntlConfig {\n // ─── URL 路由层(被 parseLocale / withLocale 等消费)───────────\n /** 支持的 locale 列表,如 ['zh', 'en'];用于 URL 前缀解析 */\n locales?: readonly string[];\n /** 默认 locale —— 必须在 locales 内;同时作为 detect 失败的兜底 */\n defaultLocale?: string;\n /** 默认 locale 是否带 URL 前缀(默认 false:'/about';true:'/zh/about') */\n prefixDefault?: boolean;\n\n // ─── 翻译消息加载层(被 SEO/Header 等消费)─────────────────────\n /** 远程 endpoint;`{locale}` 占位符自动替换 */\n endpoint?: string;\n /** 远端响应适配器;支持 admin manifest / SaaS CMS 等非标准响应 */\n transform?: (\n data: unknown,\n locale: string\n ) => IntlPayload | null | undefined | Promise<IntlPayload | null | undefined>;\n /** 本地或自定义加载器;与 endpoint 互斥(优先级更高) */\n load?: (locale: string, ctx: SiteRuntimeContext) => Promise<IntlPayload | null>;\n /** locale 检测(默认:cookie `locale` → Accept-Language 前缀 → defaultLocale) */\n detect?: (req: Request) => string;\n /** 缓存 TTL 毫秒,默认 60_000 */\n ttl?: number;\n}\n\n/** 仅静态值,无远程拉取(PageSeoMeta 直接复用,无需扩展) */\nexport type SeoStaticEntry = PageSeoMeta;\n\nexport interface SeoRemoteEntry<T = unknown> {\n /** 远程 endpoint;`{paramName}` 占位符自动替换为路由捕获组 */\n endpoint: string;\n /** 把远程响应转成 PageSeoMeta */\n transform: (data: T, params: Record<string, string>) => PageSeoMeta | null;\n /** 缓存 TTL 毫秒,默认 300_000(5 分钟) */\n ttl?: number;\n}\n\nexport interface SeoLocalEntry {\n /** 本地加载器:dynamic import / fs.readFile / 内存 Map 都可 */\n load: (\n params: Record<string, string>,\n ctx: SiteRuntimeContext\n ) => Promise<PageSeoMeta | null> | PageSeoMeta | null;\n /** 缓存 TTL 毫秒,默认 300_000 */\n ttl?: number;\n}\n\nexport type SeoEntry = SeoStaticEntry | SeoRemoteEntry | SeoLocalEntry;\n\nexport interface SiteHooksConfig {\n /** i18n 配置 */\n intl?: IntlConfig;\n /** SEO 路由表:path pattern(支持 `:param`)→ 静态 meta 或 remote loader */\n seo?: Record<string, SeoEntry | (() => Promise<PageSeoMeta | null> | PageSeoMeta | null)>;\n /**\n * 错误回调。平台默认会先执行 console + runtime.telemetry errors endpoint 上报;\n * 自定义 onError 作为业务补充回调追加执行,不会关闭平台默认上报。\n */\n onError?: (\n err: unknown,\n req: Request,\n ctx: { traceId: string; locale?: string }\n ) => void | Promise<void>;\n /**\n * 请求级 ctx 扩展(除 engine 基线字段 + locale 之外的业务字段)。\n *\n * 典型用途:userId、tenantId、requestSegment、审计字段。\n * 返回值会合并进 RequestContext;Server Component 使用\n * `getRequestContext()` 读取,Client Component 需要由 Server Component\n * 作为 props 传入。\n *\n * 注意:\n * - 这里处在首屏关键路径上,应只做 header/cookie 解析。\n * - 不要在这里查数据库或慢 API。\n * - 不要在这里解析 A/B cookie;页面用 `getVariant()`。\n */\n beforeRequest?: (req: Request) => Record<string, unknown> | Promise<Record<string, unknown>>;\n /**\n * 注入到 `<head>` 末尾(`</head>` 之前)的 raw HTML 字符串。\n *\n * 通过 SSR HTML stream transformer 注入,**完全脱离 React 树** —— 不进 client RSC\n * payload,不触发 React 19 + plugin-rsc 的 head children mismatch hydration 错误。\n *\n * 典型用途:\n * - 主题 init inline blocking script(避免 FOUC,next-themes 同款)\n * - GA / GTM snippet\n * - A/B variant flag injection\n * - CSP nonce / preload hints\n *\n * 业务侧返回完整的标签 HTML(含 `<script>` / `<style>` / `<meta>` 外壳)。返回\n * 空字符串 / undefined 时跳过注入。\n *\n * ctx.nonce:当前请求的 CSP nonce(engine 自动注入)。业务侧的 inline `<script>`\n * 必须带上 nonce 属性,否则被 nonce-based CSP 阻断:\n *\n * ```ts\n * import { THEME_INIT_SCRIPT } from '@app/ui/theme-utils';\n *\n * defineAdminSiteHooks({\n * headExtras: ({ nonce }) =>\n * `<script${nonce ? ` nonce=\"${nonce}\"` : ''}>${THEME_INIT_SCRIPT}</script>`,\n * });\n * ```\n */\n headExtras?: (ctx: { nonce?: string }) => string | undefined;\n}\n\ninterface CompiledRoute {\n re: RegExp;\n paramNames: string[];\n resolver: (params: Record<string, string>) => Promise<PageSeoMeta | null> | PageSeoMeta | null;\n}\n\n/** 把 `/books/:id/reviews/:rid` 编译成 RegExp + 参数名列表 */\nfunction compilePattern(pattern: string): { re: RegExp; paramNames: string[] } {\n const paramNames: string[] = [];\n const wildcard = pattern.endsWith('/*');\n const base = wildcard ? pattern.slice(0, -2) : pattern;\n const escaped = base.replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&');\n const reSrc = escaped.replace(/:(\\w+)/g, (_, name) => {\n paramNames.push(name);\n return '([^/]+)';\n });\n return { re: new RegExp(`^${reSrc}${wildcard ? '(?:/.*)?' : ''}$`), paramNames };\n}\n\nfunction fillTemplate(template: string, vars: Record<string, string>): string {\n return template.replace(/\\{(\\w+)\\}/g, (_, k) => encodeURIComponent(vars[k] ?? ''));\n}\n\nexport function createAdminIntlLoader(\n options: CreateAdminIntlLoaderOptions = {}\n): NonNullable<IntlConfig['load']> {\n const endpoint = options.endpoint ?? '/api/i18n/{locale}/manifest';\n const fallbackMessages = options.fallbackMessages ?? {};\n const defaultLocale = options.defaultLocale;\n const supportedLocales = Object.keys(fallbackMessages);\n\n return async (locale, ctx) => {\n const normalizedLocale =\n supportedLocales.length && defaultLocale\n ? normalizeLocale(locale, supportedLocales, defaultLocale)\n : locale;\n const remoteUrl = resolveAdminUrl(endpoint, { locale: normalizedLocale }, ctx);\n const remote = remoteUrl\n ? await fetchJsonWithTimeout<unknown>(remoteUrl, options.timeoutMs)\n : null;\n const remoteMessages = extractIntlMessagesOrNull(remote);\n const localMessages =\n fallbackMessages[normalizedLocale] ??\n (defaultLocale ? fallbackMessages[defaultLocale] : undefined) ??\n {};\n const messages = remoteMessages ?? normalizeMessages(localMessages);\n\n return {\n locale: normalizedLocale,\n messages,\n direction: rtlOf(normalizedLocale),\n source: remoteMessages\n ? (options.remoteSource ?? 'remote')\n : (options.fallbackSource ?? 'local-fallback'),\n };\n };\n}\n\nexport function createAdminSeoLoader(\n options: CreateAdminSeoLoaderOptions = {}\n): SeoLocalEntry['load'] {\n const endpoint = options.endpoint ?? '/api/seo?path={pathname}';\n const fallbackEntries = options.fallbackEntries ?? [];\n // 编译一次 + 缓存。N 个 resolver 在每个请求里只是 N 次正则 test,cost 可忽略。\n const compiledResolvers: CompiledSeoResolver[] = (options.dynamicResolvers ?? []).map(\n compileSeoResolver\n );\n\n return async (params, ctx) => {\n const pathname = normalizePathname(params.pathname || '/');\n\n // 1. admin endpoint —— 运营在 dashboard 给具体 path 配过的覆盖优先级最高\n const remoteUrl = resolveAdminUrl(endpoint, { ...params, pathname }, ctx);\n const remote = remoteUrl\n ? await fetchJsonWithTimeout<unknown>(remoteUrl, options.timeoutMs)\n : null;\n const remoteMeta = extractSeoMetaOrNull(remote);\n if (remoteMeta) return remoteMeta;\n\n // 2. dynamic resolvers —— 参数化路径的请求期数据驱动\n if (compiledResolvers.length > 0) {\n for (const compiled of compiledResolvers) {\n const m = pathname.match(compiled.re);\n if (!m) continue;\n const resolverParams: Record<string, string> = {};\n compiled.paramNames.forEach((name, i) => {\n resolverParams[name] = m[i + 1] ?? '';\n });\n try {\n const result = await compiled.resolver.resolve({\n pathname,\n params: resolverParams,\n locale: typeof params.locale === 'string' ? params.locale : undefined,\n services: ctx.services,\n });\n if (result) return result as PageSeoMeta;\n } catch (err) {\n // resolver 抛错不阻塞渲染:业务异常时把 SEO 当 null 处理\n console.warn('[seo] dynamic resolver threw, falling through to fallback', err);\n }\n // 同 pattern 没命中数据就继续找下一个 resolver / fallback;不退出。\n // 例:/books/:id 解析失败时,可能匹配了更宽的 /:scope/:id resolver 兜底。\n }\n }\n\n // 3. fallbackLocal —— build 期冻结的兜底\n const fallback = fallbackEntries.find(entry => normalizePathname(entry.path) === pathname);\n if (!fallback) return null;\n const meta = { ...fallback } as Record<string, unknown>;\n delete meta.path;\n delete meta.group;\n return meta as PageSeoMeta;\n };\n}\n\nexport function defineAdminSiteHooks(options: DefineAdminSiteHooksOptions = {}): ServerHooksOutput {\n return createAdminSiteHooks(options, createEmptyRuntimeConfig());\n}\n\nfunction createAdminSiteHooks(\n options: DefineAdminSiteHooksOptions,\n runtime: SiteRuntimeConfig\n): ServerHooksOutput {\n const runtimeI18n: Partial<RuntimeI18nConfig> = runtime.i18n ?? {};\n const runtimeSeo: Partial<RuntimeSeoConfig> = runtime.seo ?? {};\n const i18n = options.i18n ?? {};\n const seo = options.seo ?? {};\n const fallbackMessages = i18n.fallbackLocal ?? runtimeI18n.fallbackLocal ?? {};\n const locales =\n i18n.locales ??\n runtimeI18n.locales ??\n (Object.keys(fallbackMessages).length > 0 ? Object.keys(fallbackMessages) : ['en']);\n const defaultLocale = i18n.defaultLocale ?? runtimeI18n.defaultLocale ?? locales[0] ?? 'en';\n\n const output = createSiteHooks(\n {\n beforeRequest: options.beforeRequest,\n onError: options.onError,\n headExtras: options.headExtras,\n intl: {\n locales,\n defaultLocale,\n prefixDefault: i18n.prefixDefault ?? runtimeI18n.prefixDefault,\n detect: i18n.detect,\n load: createAdminIntlLoader({\n endpoint: i18n.endpoint ?? runtimeI18n.endpoint,\n fallbackMessages,\n defaultLocale,\n timeoutMs: i18n.timeoutMs ?? runtimeI18n.timeoutMs,\n remoteSource: i18n.remoteSource ?? runtimeI18n.remoteSource,\n fallbackSource: i18n.fallbackSource ?? runtimeI18n.fallbackSource,\n }),\n ttl: i18n.ttl ?? runtimeI18n.ttl ?? 60_000,\n },\n seo: {\n '/*': {\n load: createAdminSeoLoader({\n endpoint: seo.endpoint ?? runtimeSeo.endpoint,\n fallbackEntries: normalizeAdminSeoFallbackEntries(\n seo.fallbackLocal ?? runtimeSeo.fallbackLocal\n ),\n timeoutMs: seo.timeoutMs ?? runtimeSeo.timeoutMs,\n dynamicResolvers: seo.dynamicResolvers ?? runtimeSeo.dynamicResolvers,\n }),\n ttl: seo.ttl ?? runtimeSeo.ttl ?? 60_000,\n },\n },\n },\n runtime\n );\n Object.defineProperty(output, '__configureRuntime', {\n enumerable: false,\n configurable: true,\n value: (nextRuntime: SiteRuntimeConfig) => createAdminSiteHooks(options, nextRuntime),\n });\n return output;\n}\n\nexport interface ServerHooksOutput {\n /** site URL —— SEO 注入时把 image/canonical 等相对路径解析为绝对 URL */\n siteBaseUrl?: string;\n /** 浏览器可访问的 API base —— 注入到 csr-shell 的 window.__API_BASE__ */\n apiBaseUrl?: string;\n /**\n * 原始 intl 配置(用户在 defineSiteHooks 里写的那份),透传出来给 app.tsx 的 parseLocale 用\n * —— 让 i18n 配置只声明一次,不需要单独 i18n.config.ts\n */\n intl?: IntlConfig;\n beforeRequest: (\n req: Request,\n engineCtx: { traceId: string; startedAt: number }\n ) => Promise<Record<string, unknown>>;\n loadIntl: (req: Request) => Promise<IntlPayload | null>;\n loadSeoMeta: (req: Request) => Promise<PageSeoMeta | null>;\n onError: (\n err: unknown,\n req: Request,\n ctx: { traceId: string; locale?: string }\n ) => void | Promise<void>;\n /** 注入 `<head>` 末尾的 raw HTML —— 详见 SiteHooksConfig.headExtras 注释 */\n headExtras?: (ctx: { nonce?: string }) => string | undefined;\n __configureRuntime?: (runtime: SiteRuntimeConfig) => ServerHooksOutput;\n}\n\nexport function defineSiteHooks(config: SiteHooksConfig): ServerHooksOutput {\n return createSiteHooks(config, createEmptyRuntimeConfig());\n}\n\nexport function applyRuntimeToServerHooks<T extends object>(\n hooks: T,\n runtime: SiteRuntimeConfig\n): T {\n const maybeRuntimeAware = hooks as T & {\n __configureRuntime?: (runtime: SiteRuntimeConfig) => T;\n };\n if (typeof maybeRuntimeAware.__configureRuntime === 'function') {\n return maybeRuntimeAware.__configureRuntime(runtime);\n }\n const baseHooks = hooks as T & {\n siteBaseUrl?: string;\n apiBaseUrl?: string;\n intl?: unknown;\n loadIntl?: unknown;\n loadSeoMeta?: unknown;\n beforeRequest?: SiteHooksConfig['beforeRequest'];\n onError?: SiteHooksConfig['onError'];\n };\n const services = resolveRuntimeServices(runtime);\n const siteBaseUrl = baseHooks.siteBaseUrl ?? runtime.site;\n const apiBaseUrl = baseHooks.apiBaseUrl ?? services.api;\n const hasUserContentHooks =\n !!baseHooks.intl ||\n typeof baseHooks.loadIntl === 'function' ||\n typeof baseHooks.loadSeoMeta === 'function';\n\n if (!hasUserContentHooks && hasRuntimeContentConfig(runtime)) {\n const runtimeHooks = createAdminSiteHooks(\n {\n beforeRequest: baseHooks.beforeRequest,\n onError: baseHooks.onError,\n },\n runtime\n );\n return {\n ...hooks,\n siteBaseUrl,\n apiBaseUrl,\n intl: runtimeHooks.intl,\n beforeRequest: runtimeHooks.beforeRequest,\n loadIntl: runtimeHooks.loadIntl,\n loadSeoMeta: runtimeHooks.loadSeoMeta,\n onError: runtimeHooks.onError,\n } as T;\n }\n\n return {\n ...hooks,\n siteBaseUrl,\n apiBaseUrl,\n } as T;\n}\n\nfunction createSiteHooks(config: SiteHooksConfig, runtime: SiteRuntimeConfig): ServerHooksOutput {\n const services = resolveRuntimeServices(runtime);\n const api = services.api ?? '';\n const site = runtime.site ?? '';\n const runtimeCtx: SiteRuntimeContext = {\n runtime,\n services,\n telemetry: services.telemetry,\n site: site || undefined,\n };\n const fetchJson = async (path: string, baseUrl?: string): Promise<unknown> => {\n try {\n if (!baseUrl) return null;\n const r = await fetch(baseUrl + path);\n if (!r.ok) return null;\n return await r.json();\n } catch {\n return null;\n }\n };\n\n // ─── i18n 缓存(一次创建,请求级复用)──────────────\n const intlCfg = config.intl ?? {};\n const fallbackLocale = intlCfg.defaultLocale ?? 'zh-CN';\n const supportedLocales = intlCfg.locales?.length ? intlCfg.locales : undefined;\n // 默认 detect 优先级(业界标准 i18n 顺序):\n // 1. URL pathname 前缀 /en-US/... → 'en-US' ← 显式路由意图,最高优先级\n // 2. locale cookie ← 用户手动切换过的偏好\n // 3. Accept-Language 头 ← 浏览器系统语言\n // 4. defaultLocale ← 兜底\n //\n // 关键:前缀路由(prefixDefault:true 等场景)下,URL 是源真值。如果不优先用\n // URL,curl /en-US 但 Accept-Language 是 zh 会被错误降级到 zh-CN,跟用户\n // 明确写在 URL 里的意图相反。\n // 业务侧可通过 intlCfg.detect 完全覆盖(任何 (req) => string 都行)。\n const detectLocale =\n intlCfg.detect ??\n ((req: Request): string => {\n // 1. URL 前缀\n if (supportedLocales) {\n try {\n const pathname = new URL(req.url).pathname;\n // 客户端 RSC 导航 URL 带 `_.rsc` 后缀(如 `/ja_.rsc`),不剥掉的话\n // 首段会变成 `ja_.rsc` 命中不了 locale,从而错误回退到 cookie /\n // Accept-Language / defaultLocale —— 这正是「切换语言必须刷新才生效」\n // 的根因(RSC 导航拿到的 intl 语言与 URL 前缀不一致)。\n const cleanPath = pathname.endsWith('_.rsc')\n ? pathname.slice(0, -'_.rsc'.length) || '/'\n : pathname;\n const first = cleanPath.split('/')[1];\n if (first && supportedLocales.includes(first)) return first;\n } catch {\n // 非法 URL(极少见,比如内部调用喂了相对路径)→ 继续后续策略\n }\n }\n // 2. cookie\n const localeCookie = readCookie(req, 'locale');\n if (localeCookie) {\n return supportedLocales\n ? normalizeLocale(localeCookie, supportedLocales, fallbackLocale)\n : localeCookie;\n }\n // 3. Accept-Language → 4. fallbackLocale\n const accept = req.headers.get('accept-language') ?? '';\n return supportedLocales\n ? normalizeLocale(parseAcceptLanguage(accept), supportedLocales, fallbackLocale)\n : inferLocaleFromAcceptLanguage(accept, fallbackLocale);\n });\n\n const intlLoader = createCachedFetcher<string, IntlPayload>({\n key: locale => `intl:${locale}`,\n ttl: intlCfg.ttl ?? 60_000,\n swr: true,\n fetch: async locale => {\n if (intlCfg.load) {\n const r = await intlCfg.load(locale, runtimeCtx);\n return r ?? { locale, messages: {}, direction: rtlOf(locale) };\n }\n if (intlCfg.endpoint) {\n const url = fillTemplate(intlCfg.endpoint, { locale });\n const json = await fetchJson(url, services.api);\n if (json !== null && intlCfg.transform) {\n const transformed = await intlCfg.transform(json, locale);\n if (transformed) {\n return {\n ...transformed,\n direction: transformed.direction ?? rtlOf(transformed.locale),\n };\n }\n }\n return {\n locale,\n messages: extractIntlMessages(json),\n direction: rtlOf(locale),\n };\n }\n return { locale, messages: {}, direction: rtlOf(locale) };\n },\n fallback: locale => ({ locale, messages: {}, direction: rtlOf(locale) }),\n });\n\n // ─── SEO 路由表编译 + 远程 loader 缓存(每个 pattern 一份)─────\n const seoRoutes: CompiledRoute[] = [];\n const remoteCaches = new Map<\n string,\n ReturnType<typeof createCachedFetcher<string, PageSeoMeta | null>>\n >();\n\n for (const [pattern, value] of Object.entries(config.seo ?? {})) {\n const { re, paramNames } = compilePattern(pattern);\n\n if (typeof value === 'function') {\n // 自定义 resolver\n seoRoutes.push({ re, paramNames, resolver: value as CompiledRoute['resolver'] });\n continue;\n }\n if ('endpoint' in value && typeof (value as SeoRemoteEntry).endpoint === 'string') {\n const remote = value as SeoRemoteEntry;\n const cache = createCachedFetcher<string, PageSeoMeta | null>({\n key: paramKey => `seo:${pattern}:${paramKey}`,\n ttl: remote.ttl ?? 300_000,\n fetch: async paramKey => {\n const params = JSON.parse(paramKey) as Record<string, string>;\n const data = await fetchJson(fillTemplate(remote.endpoint, params), services.api);\n if (data === null) return null;\n return remote.transform(data, params);\n },\n fallback: () => null,\n });\n remoteCaches.set(pattern, cache);\n seoRoutes.push({\n re,\n paramNames,\n resolver: params => cache(JSON.stringify(params)),\n });\n continue;\n }\n if ('load' in value && typeof (value as SeoLocalEntry).load === 'function') {\n const local = value as SeoLocalEntry;\n const cache = createCachedFetcher<string, PageSeoMeta | null>({\n key: paramKey => `seo-local:${pattern}:${paramKey}`,\n ttl: local.ttl ?? 300_000,\n fetch: async paramKey => {\n const params = JSON.parse(paramKey) as Record<string, string>;\n return await local.load(params, runtimeCtx);\n },\n fallback: () => null,\n });\n remoteCaches.set(pattern, cache);\n seoRoutes.push({\n re,\n paramNames,\n resolver: params => cache(JSON.stringify(params)),\n });\n continue;\n }\n // 静态 meta\n const staticMeta = value as SeoStaticEntry;\n const withDefaults: PageSeoMeta = {\n ...staticMeta,\n canonical:\n staticMeta.canonical ??\n (site && pattern && pattern !== '/*' ? `${site}${pattern}` : staticMeta.canonical),\n };\n seoRoutes.push({ re, paramNames, resolver: () => withDefaults });\n }\n\n // ─── onError ─────\n const platformOnError = createPlatformOnError(runtime, runtimeCtx);\n const onError: ServerHooksOutput['onError'] = async (err, req, ctx) => {\n platformOnError(err, req, ctx);\n if (config.onError) {\n await config.onError(err, req, ctx);\n }\n };\n\n const output: ServerHooksOutput = {\n siteBaseUrl: site || undefined,\n apiBaseUrl: api || undefined,\n intl: config.intl,\n headExtras: config.headExtras,\n async beforeRequest(req, _engineCtx) {\n const locale = detectLocale(req);\n const userExt = config.beforeRequest ? await config.beforeRequest(req) : {};\n return { locale, ...userExt };\n },\n async loadIntl(req) {\n return intlLoader(detectLocale(req));\n },\n async loadSeoMeta(req) {\n const url = new URL(req.url);\n const locale = detectLocale(req);\n // 客户端 RSC 导航 fetch 的 URL 带 _.rsc 后缀(详见 defaults/runtime/request.tsx)。\n // 先剥后缀,否则 /zh-CN/books/1_.rsc 永远 match 不到 /books/:id route → seoMeta=null →\n // 客户端导航后 head 不更新。HTML 请求没这个后缀,原行为不变。\n let pathForRouting = url.pathname;\n if (pathForRouting.endsWith('_.rsc')) {\n pathForRouting = pathForRouting.slice(0, -'_.rsc'.length) || '/';\n }\n // SEO 表是按\"业务规范路径\"('/' / '/books' / '/about')入库的,\n // 不带 locale 前缀。请求 URL 是带前缀的('/en-US/'、'/zh-CN/books'),\n // 直接喂给 admin 查不到。先用 parseLocale 把 locale 段剥掉,\n // 再去 seoRoutes 里匹配 + 调 admin endpoint。\n // 同时 locale 单独传到 resolver params,让 endpoint 模板里 {locale}\n // 占位符能填对应语言(之前那个 fix 留着,跟 strip 配合一起才完整)。\n const intlConfig = config.intl;\n const cleanPath =\n intlConfig?.locales && intlConfig.locales.length > 0\n ? parseLocale(pathForRouting, {\n locales: intlConfig.locales,\n defaultLocale: intlConfig.defaultLocale ?? intlConfig.locales[0]!,\n prefixDefault: intlConfig.prefixDefault,\n } satisfies I18nConfig).pathname\n : pathForRouting;\n\n for (const { re, paramNames, resolver } of seoRoutes) {\n const m = cleanPath.match(re);\n if (m) {\n const params: Record<string, string> = {\n pathname: cleanPath,\n locale,\n };\n paramNames.forEach((n, i) => (params[n] = m[i + 1] ?? ''));\n return await resolver(params);\n }\n }\n return null;\n },\n onError,\n };\n Object.defineProperty(output, '__configureRuntime', {\n enumerable: false,\n configurable: true,\n value: (nextRuntime: SiteRuntimeConfig) => createSiteHooks(config, nextRuntime),\n });\n return output;\n}\n\nfunction rtlOf(locale: string): 'ltr' | 'rtl' {\n return /^(ar|he|fa|ur)/.test(locale) ? 'rtl' : 'ltr';\n}\n\nfunction parseAcceptLanguage(accept: string): string {\n let best = '';\n let bestQ = -1;\n for (const part of accept.split(',')) {\n const [rawLocale, ...attrs] = part.trim().split(';');\n if (!rawLocale) continue;\n const qAttr = attrs.find(attr => attr.trim().startsWith('q='));\n const q = qAttr ? Number(qAttr.trim().slice(2)) : 1;\n if (Number.isFinite(q) && q > bestQ) {\n best = rawLocale;\n bestQ = q;\n }\n }\n return best;\n}\n\nfunction inferLocaleFromAcceptLanguage(accept: string, fallbackLocale: string): string {\n const best = parseAcceptLanguage(accept);\n if (!best) return fallbackLocale;\n const primary = best.toLowerCase().split('-')[0];\n if (primary === 'zh') return 'zh-CN';\n if (primary === 'en') return 'en';\n return fallbackLocale;\n}\n\nfunction normalizeLocale(\n value: string,\n supportedLocales: readonly string[],\n fallbackLocale: string\n): string {\n const lower = value.toLowerCase();\n const exact = supportedLocales.find(locale => locale.toLowerCase() === lower);\n if (exact) return exact;\n const prefix = lower.split('-')[0];\n const byPrefix = supportedLocales.find(locale => locale.toLowerCase().split('-')[0] === prefix);\n return byPrefix ?? fallbackLocale;\n}\n\nfunction extractIntlMessages(data: unknown): Record<string, unknown> {\n return extractIntlMessagesOrNull(data) ?? {};\n}\n\nfunction extractIntlMessagesOrNull(data: unknown): Record<string, unknown> | null {\n if (!data || typeof data !== 'object') return null;\n const raw = data as Record<string, unknown>;\n const dataValue = raw.data;\n const candidate =\n raw.strings ??\n raw.messages ??\n (isRecord(dataValue) && 'strings' in dataValue ? dataValue.strings : dataValue);\n if (!candidate || typeof candidate !== 'object') return null;\n return normalizeMessages(candidate as Record<string, unknown>);\n}\n\nfunction normalizeMessages(messages: Record<string, unknown>): Record<string, unknown> {\n if (isFlatRecord(messages)) {\n return expandDottedRecord(messages);\n }\n return messages;\n}\n\n/**\n * 逐层剥 envelope —— admin 在不同分支返回三种 shape:\n * - flat:`{ title, description, ... }`(admin no-locale fast path)\n * - 单层:`{ data: { title, ... } }`(旧版本)\n * - 双层:`{ status, code, data: { data: { title, ... }, version } }`\n * (api-envelope plugin 包了一层,resolvePublic 自己又是 `{ data, version }`,\n * 所以 locale-aware 路径会双层 wrap)\n *\n * 停止条件:候选对象有 `title` / `description`(SEO 形状),或没有 `data` 字段可剥。\n */\nfunction extractSeoMetaOrNull(data: unknown): PageSeoMeta | null {\n let candidate: unknown = data;\n for (let i = 0; i < 4; i++) {\n if (!isRecord(candidate)) return null;\n if ('title' in candidate || 'description' in candidate) break;\n if ('data' in candidate) {\n candidate = candidate.data;\n continue;\n }\n return null;\n }\n if (!isRecord(candidate)) return null;\n return candidate as PageSeoMeta;\n}\n\nfunction normalizeAdminSeoFallbackEntries(\n entries: readonly Record<string, unknown>[] = []\n): readonly AdminSeoFallbackEntry[] {\n return entries.filter(\n entry => typeof entry.path === 'string'\n ) as unknown as readonly AdminSeoFallbackEntry[];\n}\n\nfunction createPlatformOnError(\n runtime: SiteRuntimeConfig,\n ctx: SiteRuntimeContext\n): NonNullable<ServerHooksOutput['onError']> {\n const reportServerError = createServerErrorEndpointReporter(runtime, ctx);\n\n return (err, req, errorCtx) => {\n console.error('[onError]', {\n traceId: errorCtx.traceId,\n locale: errorCtx.locale,\n url: req.url,\n msg: err instanceof Error ? err.message : String(err),\n });\n reportServerError?.(err, req, errorCtx);\n };\n}\n\nfunction createServerErrorEndpointReporter(\n runtime: SiteRuntimeConfig,\n ctx: SiteRuntimeContext\n): ((err: unknown, req: Request, errorCtx: { traceId: string; locale?: string }) => void) | null {\n const config = runtime.telemetry;\n if (config === false || !config || config.errors === false) return null;\n\n const errors = config.errors ?? {};\n const endpoint = resolveAdminUrl(errors.endpoint ?? '/api/observability/errors', {}, ctx, {\n baseUrl: runtimeCtx => runtimeCtx.services.telemetry ?? runtimeCtx.services.api,\n });\n if (!endpoint) return null;\n\n const app = config.app ?? 'isr-engine-app';\n const release = config.release;\n const environment = config.environment;\n const includeQueryString = config.includeQueryString === true;\n\n return (err, req, errorCtx) => {\n const report = normalizeServerErrorReport(err, req, errorCtx, {\n release,\n environment,\n includeQueryString,\n });\n\n void fetch(endpoint, {\n method: 'POST',\n headers: {\n 'content-type': 'application/json',\n accept: 'application/json',\n },\n body: JSON.stringify({\n app,\n sentAt: Date.now(),\n reports: [report],\n }),\n signal: typeof AbortSignal !== 'undefined' ? AbortSignal.timeout(1000) : undefined,\n }).catch(() => {\n /* 服务端错误上报不能阻断渲染兜底;失败交给进程日志和外层 adapter */\n });\n };\n}\n\nfunction normalizeServerErrorReport(\n err: unknown,\n req: Request,\n ctx: { traceId: string; locale?: string },\n options: {\n release?: string;\n environment?: string;\n includeQueryString?: boolean;\n }\n): Record<string, unknown> {\n const error = err instanceof Error ? err : null;\n const message = error?.message || String(err);\n const name = error?.name || 'Error';\n const url = safeRequestPath(req.url, options.includeQueryString);\n\n return {\n id: createServerReportId(),\n ts: Date.now(),\n level: 'error',\n message,\n name,\n stack: error?.stack,\n release: options.release,\n environment: options.environment,\n url,\n source: 'server-render',\n tags: {\n traceId: ctx.traceId,\n locale: ctx.locale,\n },\n extra: {\n method: req.method,\n pathname: url.split('?')[0] || '/',\n },\n fingerprint: ['server-render', name, message.slice(0, 160)],\n };\n}\n\nfunction safeRequestPath(rawUrl: string, includeQueryString?: boolean): string {\n try {\n const url = new URL(rawUrl);\n return includeQueryString ? `${url.pathname}${url.search}` : url.pathname;\n } catch {\n return includeQueryString ? rawUrl : '/';\n }\n}\n\nfunction createServerReportId(): string {\n const random =\n typeof crypto !== 'undefined' && 'randomUUID' in crypto\n ? crypto.randomUUID()\n : Math.random().toString(36).slice(2);\n return `srv_${Date.now().toString(36)}_${random}`;\n}\n\nasync function fetchJsonWithTimeout<T>(url: string, timeoutMs = 1200): Promise<T | null> {\n try {\n const response = await fetch(url, {\n headers: { Accept: 'application/json' },\n signal: timeoutMs > 0 ? AbortSignal.timeout(timeoutMs) : undefined,\n });\n if (!response.ok) return null;\n return (await response.json()) as T;\n } catch {\n return null;\n }\n}\n\nfunction resolveAdminUrl(\n endpoint: string,\n vars: Record<string, string>,\n ctx: SiteRuntimeContext,\n options: { baseUrl?: RuntimeServiceBase } = {}\n): string | null {\n const filled = fillTemplate(endpoint, vars);\n if (/^(https?:)?\\/\\//i.test(filled)) return filled;\n const base = resolveRuntimeServiceBase(ctx, options.baseUrl);\n if (!base) return null;\n return `${trimTrailingSlashes(base)}/${filled.replace(/^\\/+/, '')}`;\n}\n\nfunction resolveRuntimeServiceBase(\n ctx: SiteRuntimeContext,\n baseUrl?: RuntimeServiceBase\n): string | null {\n if (typeof baseUrl === 'function') {\n return baseUrl(ctx) ?? null;\n }\n if (baseUrl) return baseUrl;\n return ctx.services.api ?? null;\n}\n\nfunction resolveRuntimeServices(runtime: SiteRuntimeConfig): RuntimeServices {\n const services = runtime.services ?? {};\n const api = services.api;\n return {\n api,\n telemetry: services.telemetry ?? api,\n };\n}\n\nfunction hasRuntimeContentConfig(runtime: SiteRuntimeConfig): boolean {\n return !!(\n runtime.i18n?.endpoint ||\n runtime.i18n?.fallbackLocal ||\n runtime.seo?.endpoint ||\n runtime.seo?.fallbackLocal ||\n runtime.telemetry\n );\n}\n\nfunction normalizePathname(pathname: string): string {\n if (pathname === '/') return '/';\n return trimTrailingSlashes(pathname) || '/';\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return !!value && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction isFlatRecord(value: unknown): boolean {\n if (!value || typeof value !== 'object') return false;\n return Object.keys(value as Record<string, unknown>).some(key => key.includes('.'));\n}\n\nfunction expandDottedRecord(flat: Record<string, unknown>): Record<string, unknown> {\n const out: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(flat)) {\n const parts = key.split('.');\n let cur = out;\n parts.forEach((part, index) => {\n if (index === parts.length - 1) {\n cur[part] = value;\n return;\n }\n const next = cur[part];\n if (!next || typeof next !== 'object') cur[part] = {};\n cur = cur[part] as Record<string, unknown>;\n });\n }\n return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,IAAM,UAAN,MAAoB;CAEE;CADpB,wBAAgB,IAAI,IAAU;CAC9B,YAAY,KAAqB;EAAb,KAAA,MAAA;CAAc;CAClC,IAAI,GAAqB;EACvB,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;EAC1B,IAAI,MAAM,KAAA,GAAW;GAEnB,KAAK,MAAM,OAAO,CAAC;GACnB,KAAK,MAAM,IAAI,GAAG,CAAC;EACrB;EACA,OAAO;CACT;CACA,IAAI,GAAM,GAAY;EACpB,IAAI,KAAK,MAAM,IAAI,CAAC,GAAG,KAAK,MAAM,OAAO,CAAC;EAC1C,KAAK,MAAM,IAAI,GAAG,CAAC;EACnB,IAAI,KAAK,MAAM,OAAO,KAAK,KAAK;GAC9B,MAAM,SAAS,KAAK,MAAM,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;GACxC,IAAI,WAAW,KAAA,GAAW,KAAK,MAAM,OAAO,MAAM;EACpD;CACF;AACF;AAwBA,SAAgB,oBACd,MAC6B;CAC7B,MAAM,MAAM,KAAK,OAAO;CAExB,MAAM,QAAQ,IAAI,QADN,KAAK,OAAO,GAC4B;CACpD,MAAM,2BAAW,IAAI,IAA6B;CAElD,eAAe,KAAK,KAA4B;EAC9C,IAAI;GACF,MAAM,IAAI,MAAM,KAAK,MAAM,GAAG;GAC9B,MAAM,IAAI,KAAK,IAAI,GAAG,GAAG;IAAE,OAAO;IAAG,WAAW,KAAK,IAAI,IAAI;GAAI,CAAC;GAClE,OAAO;EACT,SAAS,KAAK;GACZ,IAAI,KAAK,UAAU,OAAO,MAAM,KAAK,SAAS,KAAK,GAAG;GACtD,MAAM;EACR;CACF;CAEA,OAAO,eAAe,cAAc,KAA4B;EAC9D,MAAM,MAAM,KAAK,IAAI,GAAG;EACxB,MAAM,QAAQ,MAAM,IAAI,GAAG;EAC3B,MAAM,MAAM,KAAK,IAAI;EAErB,IAAI,SAAS,MAAM,YAAY,KAC7B,OAAO,MAAM;EAGf,IAAI,SAAS,KAAK,KAAK;GAErB,IAAI,CAAC,SAAS,IAAI,GAAG,GAAG;IACtB,MAAM,IAAI,KAAK,GAAG,CAAC,CAAC,cAAc,SAAS,OAAO,GAAG,CAAC;IACtD,SAAS,IAAI,KAAK,CAAC;IACnB,EAAE,YAAY,CAEd,CAAC;GACH;GACA,OAAO,MAAM;EACf;EAGA,MAAM,WAAW,SAAS,IAAI,GAAG;EACjC,IAAI,UAAU,OAAO;EAErB,MAAM,IAAI,KAAK,GAAG,CAAC,CAAC,cAAc,SAAS,OAAO,GAAG,CAAC;EACtD,SAAS,IAAI,KAAK,CAAC;EACnB,OAAO;CACT;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC5DA,SAAS,2BAA8C;CACrD,OAAO;EACL,MAAM,KAAA;EACN,UAAU;GAAE,KAAK,KAAA;GAAW,WAAW,KAAA;EAAU;EACjD,OAAO,KAAA;EACP,aAAa,CAAC;EACd,MAAM,KAAA;EACN,KAAK,KAAA;EACL,WAAW;CACb;AACF;AAmDA,SAAS,mBAAmB,UAAmD;CAC7E,MAAM,aAAuB,CAAC;CAC9B,MAAM,QAAQ,SAAS,QACpB,QAAQ,sBAAsB,MAAM,CAAC,CACrC,QAAQ,oCAAoC,GAAG,SAAS;EACvD,IAAI,MAAM,OAAO;GACf,WAAW,KAAK,UAAU;GAC1B,OAAO;EACT;EACA,WAAW,KAAK,IAAI;EACpB,OAAO;CACT,CAAC;CACH,OAAO;EACL,IAAI,IAAI,OAAO,IAAI,MAAM,EAAE;EAC3B;EACA;CACF;AACF;;AA8IA,SAAS,eAAe,SAAuD;CAC7E,MAAM,aAAuB,CAAC;CAC9B,MAAM,WAAW,QAAQ,SAAS,IAAI;CAGtC,MAAM,SAFO,WAAW,QAAQ,MAAM,GAAG,EAAE,IAAI,QAAA,CAC1B,QAAQ,sBAAsB,MACrC,CAAA,CAAQ,QAAQ,YAAY,GAAG,SAAS;EACpD,WAAW,KAAK,IAAI;EACpB,OAAO;CACT,CAAC;CACD,OAAO;EAAE,IAAI,IAAI,OAAO,IAAI,QAAQ,WAAW,aAAa,GAAG,EAAE;EAAG;CAAW;AACjF;AAEA,SAAS,aAAa,UAAkB,MAAsC;CAC5E,OAAO,SAAS,QAAQ,eAAe,GAAG,MAAM,mBAAmB,KAAK,MAAM,EAAE,CAAC;AACnF;AAEA,SAAgB,sBACd,UAAwC,CAAC,GACR;CACjC,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,mBAAmB,QAAQ,oBAAoB,CAAC;CACtD,MAAM,gBAAgB,QAAQ;CAC9B,MAAM,mBAAmB,OAAO,KAAK,gBAAgB;CAErD,OAAO,OAAO,QAAQ,QAAQ;EAC5B,MAAM,mBACJ,iBAAiB,UAAU,gBACvB,gBAAgB,QAAQ,kBAAkB,aAAa,IACvD;EACN,MAAM,YAAY,gBAAgB,UAAU,EAAE,QAAQ,iBAAiB,GAAG,GAAG;EAI7E,MAAM,iBAAiB,0BAHR,YACX,MAAM,qBAA8B,WAAW,QAAQ,SAAS,IAChE,IACmD;EACvD,MAAM,gBACJ,iBAAiB,sBAChB,gBAAgB,iBAAiB,iBAAiB,KAAA,MACnD,CAAC;EAGH,OAAO;GACL,QAAQ;GACR,UAJe,kBAAkB,kBAAkB,aAAa;GAKhE,WAAW,MAAM,gBAAgB;GACjC,QAAQ,iBACH,QAAQ,gBAAgB,WACxB,QAAQ,kBAAkB;EACjC;CACF;AACF;AAEA,SAAgB,qBACd,UAAuC,CAAC,GACjB;CACvB,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,kBAAkB,QAAQ,mBAAmB,CAAC;CAEpD,MAAM,qBAA4C,QAAQ,oBAAoB,CAAC,EAAA,CAAG,IAChF,kBACF;CAEA,OAAO,OAAO,QAAQ,QAAQ;EAC5B,MAAM,WAAW,kBAAkB,OAAO,YAAY,GAAG;EAGzD,MAAM,YAAY,gBAAgB,UAAU;GAAE,GAAG;GAAQ;EAAS,GAAG,GAAG;EAIxE,MAAM,aAAa,qBAHJ,YACX,MAAM,qBAA8B,WAAW,QAAQ,SAAS,IAChE,IAC0C;EAC9C,IAAI,YAAY,OAAO;EAGvB,IAAI,kBAAkB,SAAS,GAC7B,KAAK,MAAM,YAAY,mBAAmB;GACxC,MAAM,IAAI,SAAS,MAAM,SAAS,EAAE;GACpC,IAAI,CAAC,GAAG;GACR,MAAM,iBAAyC,CAAC;GAChD,SAAS,WAAW,SAAS,MAAM,MAAM;IACvC,eAAe,QAAQ,EAAE,IAAI,MAAM;GACrC,CAAC;GACD,IAAI;IACF,MAAM,SAAS,MAAM,SAAS,SAAS,QAAQ;KAC7C;KACA,QAAQ;KACR,QAAQ,OAAO,OAAO,WAAW,WAAW,OAAO,SAAS,KAAA;KAC5D,UAAU,IAAI;IAChB,CAAC;IACD,IAAI,QAAQ,OAAO;GACrB,SAAS,KAAK;IAEZ,QAAQ,KAAK,6DAA6D,GAAG;GAC/E;EAGF;EAIF,MAAM,WAAW,gBAAgB,MAAK,UAAS,kBAAkB,MAAM,IAAI,MAAM,QAAQ;EACzF,IAAI,CAAC,UAAU,OAAO;EACtB,MAAM,OAAO,EAAE,GAAG,SAAS;EAC3B,OAAO,KAAK;EACZ,OAAO,KAAK;EACZ,OAAO;CACT;AACF;AAEA,SAAgB,qBAAqB,UAAuC,CAAC,GAAsB;CACjG,OAAO,qBAAqB,SAAS,yBAAyB,CAAC;AACjE;AAEA,SAAS,qBACP,SACA,SACmB;CACnB,MAAM,cAA0C,QAAQ,QAAQ,CAAC;CACjE,MAAM,aAAwC,QAAQ,OAAO,CAAC;CAC9D,MAAM,OAAO,QAAQ,QAAQ,CAAC;CAC9B,MAAM,MAAM,QAAQ,OAAO,CAAC;CAC5B,MAAM,mBAAmB,KAAK,iBAAiB,YAAY,iBAAiB,CAAC;CAC7E,MAAM,UACJ,KAAK,WACL,YAAY,YACX,OAAO,KAAK,gBAAgB,CAAC,CAAC,SAAS,IAAI,OAAO,KAAK,gBAAgB,IAAI,CAAC,IAAI;CACnF,MAAM,gBAAgB,KAAK,iBAAiB,YAAY,iBAAiB,QAAQ,MAAM;CAEvF,MAAM,SAAS,gBACb;EACE,eAAe,QAAQ;EACvB,SAAS,QAAQ;EACjB,YAAY,QAAQ;EACpB,MAAM;GACJ;GACA;GACA,eAAe,KAAK,iBAAiB,YAAY;GACjD,QAAQ,KAAK;GACb,MAAM,sBAAsB;IAC1B,UAAU,KAAK,YAAY,YAAY;IACvC;IACA;IACA,WAAW,KAAK,aAAa,YAAY;IACzC,cAAc,KAAK,gBAAgB,YAAY;IAC/C,gBAAgB,KAAK,kBAAkB,YAAY;GACrD,CAAC;GACD,KAAK,KAAK,OAAO,YAAY,OAAO;EACtC;EACA,KAAK,EACH,MAAM;GACJ,MAAM,qBAAqB;IACzB,UAAU,IAAI,YAAY,WAAW;IACrC,iBAAiB,iCACf,IAAI,iBAAiB,WAAW,aAClC;IACA,WAAW,IAAI,aAAa,WAAW;IACvC,kBAAkB,IAAI,oBAAoB,WAAW;GACvD,CAAC;GACD,KAAK,IAAI,OAAO,WAAW,OAAO;EACpC,EACF;CACF,GACA,OACF;CACA,OAAO,eAAe,QAAQ,sBAAsB;EAClD,YAAY;EACZ,cAAc;EACd,QAAQ,gBAAmC,qBAAqB,SAAS,WAAW;CACtF,CAAC;CACD,OAAO;AACT;AA4BA,SAAgB,gBAAgB,QAA4C;CAC1E,OAAO,gBAAgB,QAAQ,yBAAyB,CAAC;AAC3D;AAEA,SAAgB,0BACd,OACA,SACG;CACH,MAAM,oBAAoB;CAG1B,IAAI,OAAO,kBAAkB,uBAAuB,YAClD,OAAO,kBAAkB,mBAAmB,OAAO;CAErD,MAAM,YAAY;CASlB,MAAM,WAAW,uBAAuB,OAAO;CAC/C,MAAM,cAAc,UAAU,eAAe,QAAQ;CACrD,MAAM,aAAa,UAAU,cAAc,SAAS;CAMpD,IAAI,EAJF,CAAC,CAAC,UAAU,QACZ,OAAO,UAAU,aAAa,cAC9B,OAAO,UAAU,gBAAgB,eAEP,wBAAwB,OAAO,GAAG;EAC5D,MAAM,eAAe,qBACnB;GACE,eAAe,UAAU;GACzB,SAAS,UAAU;EACrB,GACA,OACF;EACA,OAAO;GACL,GAAG;GACH;GACA;GACA,MAAM,aAAa;GACnB,eAAe,aAAa;GAC5B,UAAU,aAAa;GACvB,aAAa,aAAa;GAC1B,SAAS,aAAa;EACxB;CACF;CAEA,OAAO;EACL,GAAG;EACH;EACA;CACF;AACF;AAEA,SAAS,gBAAgB,QAAyB,SAA+C;CAC/F,MAAM,WAAW,uBAAuB,OAAO;CAC/C,MAAM,MAAM,SAAS,OAAO;CAC5B,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,aAAiC;EACrC;EACA;EACA,WAAW,SAAS;EACpB,MAAM,QAAQ,KAAA;CAChB;CACA,MAAM,YAAY,OAAO,MAAc,YAAuC;EAC5E,IAAI;GACF,IAAI,CAAC,SAAS,OAAO;GACrB,MAAM,IAAI,MAAM,MAAM,UAAU,IAAI;GACpC,IAAI,CAAC,EAAE,IAAI,OAAO;GAClB,OAAO,MAAM,EAAE,KAAK;EACtB,QAAQ;GACN,OAAO;EACT;CACF;CAGA,MAAM,UAAU,OAAO,QAAQ,CAAC;CAChC,MAAM,iBAAiB,QAAQ,iBAAiB;CAChD,MAAM,mBAAmB,QAAQ,SAAS,SAAS,QAAQ,UAAU,KAAA;CAWrE,MAAM,eACJ,QAAQ,YACN,QAAyB;EAEzB,IAAI,kBACF,IAAI;GACF,MAAM,WAAW,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC;GAQlC,MAAM,SAHY,SAAS,SAAS,OAAO,IACvC,SAAS,MAAM,GAAG,EAAe,KAAK,MACtC,SAAA,CACoB,MAAM,GAAG,CAAC,CAAC;GACnC,IAAI,SAAS,iBAAiB,SAAS,KAAK,GAAG,OAAO;EACxD,QAAQ,CAER;EAGF,MAAM,eAAe,aAAA,WAAW,KAAK,QAAQ;EAC7C,IAAI,cACF,OAAO,mBACH,gBAAgB,cAAc,kBAAkB,cAAc,IAC9D;EAGN,MAAM,SAAS,IAAI,QAAQ,IAAI,iBAAiB,KAAK;EACrD,OAAO,mBACH,gBAAgB,oBAAoB,MAAM,GAAG,kBAAkB,cAAc,IAC7E,8BAA8B,QAAQ,cAAc;CAC1D;CAEF,MAAM,aAAa,oBAAyC;EAC1D,MAAK,WAAU,QAAQ;EACvB,KAAK,QAAQ,OAAO;EACpB,KAAK;EACL,OAAO,OAAM,WAAU;GACrB,IAAI,QAAQ,MAEV,OAAO,MADS,QAAQ,KAAK,QAAQ,UAAU,KACnC;IAAE;IAAQ,UAAU,CAAC;IAAG,WAAW,MAAM,MAAM;GAAE;GAE/D,IAAI,QAAQ,UAAU;IACpB,MAAM,MAAM,aAAa,QAAQ,UAAU,EAAE,OAAO,CAAC;IACrD,MAAM,OAAO,MAAM,UAAU,KAAK,SAAS,GAAG;IAC9C,IAAI,SAAS,QAAQ,QAAQ,WAAW;KACtC,MAAM,cAAc,MAAM,QAAQ,UAAU,MAAM,MAAM;KACxD,IAAI,aACF,OAAO;MACL,GAAG;MACH,WAAW,YAAY,aAAa,MAAM,YAAY,MAAM;KAC9D;IAEJ;IACA,OAAO;KACL;KACA,UAAU,oBAAoB,IAAI;KAClC,WAAW,MAAM,MAAM;IACzB;GACF;GACA,OAAO;IAAE;IAAQ,UAAU,CAAC;IAAG,WAAW,MAAM,MAAM;GAAE;EAC1D;EACA,WAAU,YAAW;GAAE;GAAQ,UAAU,CAAC;GAAG,WAAW,MAAM,MAAM;EAAE;CACxE,CAAC;CAGD,MAAM,YAA6B,CAAC;CACpC,MAAM,+BAAe,IAAI,IAGvB;CAEF,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,OAAO,OAAO,CAAC,CAAC,GAAG;EAC/D,MAAM,EAAE,IAAI,eAAe,eAAe,OAAO;EAEjD,IAAI,OAAO,UAAU,YAAY;GAE/B,UAAU,KAAK;IAAE;IAAI;IAAY,UAAU;GAAmC,CAAC;GAC/E;EACF;EACA,IAAI,cAAc,SAAS,OAAQ,MAAyB,aAAa,UAAU;GACjF,MAAM,SAAS;GACf,MAAM,QAAQ,oBAAgD;IAC5D,MAAK,aAAY,OAAO,QAAQ,GAAG;IACnC,KAAK,OAAO,OAAO;IACnB,OAAO,OAAM,aAAY;KACvB,MAAM,SAAS,KAAK,MAAM,QAAQ;KAClC,MAAM,OAAO,MAAM,UAAU,aAAa,OAAO,UAAU,MAAM,GAAG,SAAS,GAAG;KAChF,IAAI,SAAS,MAAM,OAAO;KAC1B,OAAO,OAAO,UAAU,MAAM,MAAM;IACtC;IACA,gBAAgB;GAClB,CAAC;GACD,aAAa,IAAI,SAAS,KAAK;GAC/B,UAAU,KAAK;IACb;IACA;IACA,WAAU,WAAU,MAAM,KAAK,UAAU,MAAM,CAAC;GAClD,CAAC;GACD;EACF;EACA,IAAI,UAAU,SAAS,OAAQ,MAAwB,SAAS,YAAY;GAC1E,MAAM,QAAQ;GACd,MAAM,QAAQ,oBAAgD;IAC5D,MAAK,aAAY,aAAa,QAAQ,GAAG;IACzC,KAAK,MAAM,OAAO;IAClB,OAAO,OAAM,aAAY;KACvB,MAAM,SAAS,KAAK,MAAM,QAAQ;KAClC,OAAO,MAAM,MAAM,KAAK,QAAQ,UAAU;IAC5C;IACA,gBAAgB;GAClB,CAAC;GACD,aAAa,IAAI,SAAS,KAAK;GAC/B,UAAU,KAAK;IACb;IACA;IACA,WAAU,WAAU,MAAM,KAAK,UAAU,MAAM,CAAC;GAClD,CAAC;GACD;EACF;EAEA,MAAM,aAAa;EACnB,MAAM,eAA4B;GAChC,GAAG;GACH,WACE,WAAW,cACV,QAAQ,WAAW,YAAY,OAAO,GAAG,OAAO,YAAY,WAAW;EAC5E;EACA,UAAU,KAAK;GAAE;GAAI;GAAY,gBAAgB;EAAa,CAAC;CACjE;CAGA,MAAM,kBAAkB,sBAAsB,SAAS,UAAU;CACjE,MAAM,UAAwC,OAAO,KAAK,KAAK,QAAQ;EACrE,gBAAgB,KAAK,KAAK,GAAG;EAC7B,IAAI,OAAO,SACT,MAAM,OAAO,QAAQ,KAAK,KAAK,GAAG;CAEtC;CAEA,MAAM,SAA4B;EAChC,aAAa,QAAQ,KAAA;EACrB,YAAY,OAAO,KAAA;EACnB,MAAM,OAAO;EACb,YAAY,OAAO;EACnB,MAAM,cAAc,KAAK,YAAY;GAGnC,OAAO;IAAE,QAFM,aAAa,GAEnB;IAAQ,GADD,OAAO,gBAAgB,MAAM,OAAO,cAAc,GAAG,IAAI,CAAC;GAC9C;EAC9B;EACA,MAAM,SAAS,KAAK;GAClB,OAAO,WAAW,aAAa,GAAG,CAAC;EACrC;EACA,MAAM,YAAY,KAAK;GACrB,MAAM,MAAM,IAAI,IAAI,IAAI,GAAG;GAC3B,MAAM,SAAS,aAAa,GAAG;GAI/B,IAAI,iBAAiB,IAAI;GACzB,IAAI,eAAe,SAAS,OAAO,GACjC,iBAAiB,eAAe,MAAM,GAAG,EAAe,KAAK;GAQ/D,MAAM,aAAa,OAAO;GAC1B,MAAM,YACJ,YAAY,WAAW,WAAW,QAAQ,SAAS,IAC/C,aAAA,YAAY,gBAAgB;IAC1B,SAAS,WAAW;IACpB,eAAe,WAAW,iBAAiB,WAAW,QAAQ;IAC9D,eAAe,WAAW;GAC5B,CAAsB,CAAC,CAAC,WACxB;GAEN,KAAK,MAAM,EAAE,IAAI,YAAY,cAAc,WAAW;IACpD,MAAM,IAAI,UAAU,MAAM,EAAE;IAC5B,IAAI,GAAG;KACL,MAAM,SAAiC;MACrC,UAAU;MACV;KACF;KACA,WAAW,SAAS,GAAG,MAAO,OAAO,KAAK,EAAE,IAAI,MAAM,EAAG;KACzD,OAAO,MAAM,SAAS,MAAM;IAC9B;GACF;GACA,OAAO;EACT;EACA;CACF;CACA,OAAO,eAAe,QAAQ,sBAAsB;EAClD,YAAY;EACZ,cAAc;EACd,QAAQ,gBAAmC,gBAAgB,QAAQ,WAAW;CAChF,CAAC;CACD,OAAO;AACT;AAEA,SAAS,MAAM,QAA+B;CAC5C,OAAO,iBAAiB,KAAK,MAAM,IAAI,QAAQ;AACjD;AAEA,SAAS,oBAAoB,QAAwB;CACnD,IAAI,OAAO;CACX,IAAI,QAAQ;CACZ,KAAK,MAAM,QAAQ,OAAO,MAAM,GAAG,GAAG;EACpC,MAAM,CAAC,WAAW,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,MAAM,GAAG;EACnD,IAAI,CAAC,WAAW;EAChB,MAAM,QAAQ,MAAM,MAAK,SAAQ,KAAK,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC;EAC7D,MAAM,IAAI,QAAQ,OAAO,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI;EAClD,IAAI,OAAO,SAAS,CAAC,KAAK,IAAI,OAAO;GACnC,OAAO;GACP,QAAQ;EACV;CACF;CACA,OAAO;AACT;AAEA,SAAS,8BAA8B,QAAgB,gBAAgC;CACrF,MAAM,OAAO,oBAAoB,MAAM;CACvC,IAAI,CAAC,MAAM,OAAO;CAClB,MAAM,UAAU,KAAK,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;CAC9C,IAAI,YAAY,MAAM,OAAO;CAC7B,IAAI,YAAY,MAAM,OAAO;CAC7B,OAAO;AACT;AAEA,SAAS,gBACP,OACA,kBACA,gBACQ;CACR,MAAM,QAAQ,MAAM,YAAY;CAChC,MAAM,QAAQ,iBAAiB,MAAK,WAAU,OAAO,YAAY,MAAM,KAAK;CAC5E,IAAI,OAAO,OAAO;CAClB,MAAM,SAAS,MAAM,MAAM,GAAG,CAAC,CAAC;CAEhC,OADiB,iBAAiB,MAAK,WAAU,OAAO,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,MACjF,KAAY;AACrB;AAEA,SAAS,oBAAoB,MAAwC;CACnE,OAAO,0BAA0B,IAAI,KAAK,CAAC;AAC7C;AAEA,SAAS,0BAA0B,MAA+C;CAChF,IAAI,CAAC,QAAQ,OAAO,SAAS,UAAU,OAAO;CAC9C,MAAM,MAAM;CACZ,MAAM,YAAY,IAAI;CACtB,MAAM,YACJ,IAAI,WACJ,IAAI,aACH,SAAS,SAAS,KAAK,aAAa,YAAY,UAAU,UAAU;CACvE,IAAI,CAAC,aAAa,OAAO,cAAc,UAAU,OAAO;CACxD,OAAO,kBAAkB,SAAoC;AAC/D;AAEA,SAAS,kBAAkB,UAA4D;CACrF,IAAI,aAAa,QAAQ,GACvB,OAAO,mBAAmB,QAAQ;CAEpC,OAAO;AACT;;;;;;;;;;;AAYA,SAAS,qBAAqB,MAAmC;CAC/D,IAAI,YAAqB;CACzB,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,IAAI,CAAC,SAAS,SAAS,GAAG,OAAO;EACjC,IAAI,WAAW,aAAa,iBAAiB,WAAW;EACxD,IAAI,UAAU,WAAW;GACvB,YAAY,UAAU;GACtB;EACF;EACA,OAAO;CACT;CACA,IAAI,CAAC,SAAS,SAAS,GAAG,OAAO;CACjC,OAAO;AACT;AAEA,SAAS,iCACP,UAA8C,CAAC,GACb;CAClC,OAAO,QAAQ,QACb,UAAS,OAAO,MAAM,SAAS,QACjC;AACF;AAEA,SAAS,sBACP,SACA,KAC2C;CAC3C,MAAM,oBAAoB,kCAAkC,SAAS,GAAG;CAExE,QAAQ,KAAK,KAAK,aAAa;EAC7B,QAAQ,MAAM,aAAa;GACzB,SAAS,SAAS;GAClB,QAAQ,SAAS;GACjB,KAAK,IAAI;GACT,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;EACtD,CAAC;EACD,oBAAoB,KAAK,KAAK,QAAQ;CACxC;AACF;AAEA,SAAS,kCACP,SACA,KAC+F;CAC/F,MAAM,SAAS,QAAQ;CACvB,IAAI,WAAW,SAAS,CAAC,UAAU,OAAO,WAAW,OAAO,OAAO;CAGnE,MAAM,WAAW,iBADF,OAAO,UAAU,CAAC,EAAA,CACO,YAAY,6BAA6B,CAAC,GAAG,KAAK,EACxF,UAAS,eAAc,WAAW,SAAS,aAAa,WAAW,SAAS,IAC9E,CAAC;CACD,IAAI,CAAC,UAAU,OAAO;CAEtB,MAAM,MAAM,OAAO,OAAO;CAC1B,MAAM,UAAU,OAAO;CACvB,MAAM,cAAc,OAAO;CAC3B,MAAM,qBAAqB,OAAO,uBAAuB;CAEzD,QAAQ,KAAK,KAAK,aAAa;EAC7B,MAAM,SAAS,2BAA2B,KAAK,KAAK,UAAU;GAC5D;GACA;GACA;EACF,CAAC;EAED,MAAW,UAAU;GACnB,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,QAAQ;GACV;GACA,MAAM,KAAK,UAAU;IACnB;IACA,QAAQ,KAAK,IAAI;IACjB,SAAS,CAAC,MAAM;GAClB,CAAC;GACD,QAAQ,OAAO,gBAAgB,cAAc,YAAY,QAAQ,GAAI,IAAI,KAAA;EAC3E,CAAC,CAAC,CAAC,YAAY,CAEf,CAAC;CACH;AACF;AAEA,SAAS,2BACP,KACA,KACA,KACA,SAKyB;CACzB,MAAM,QAAQ,eAAe,QAAQ,MAAM;CAC3C,MAAM,UAAU,OAAO,WAAW,OAAO,GAAG;CAC5C,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,MAAM,gBAAgB,IAAI,KAAK,QAAQ,kBAAkB;CAE/D,OAAO;EACL,IAAI,qBAAqB;EACzB,IAAI,KAAK,IAAI;EACb,OAAO;EACP;EACA;EACA,OAAO,OAAO;EACd,SAAS,QAAQ;EACjB,aAAa,QAAQ;EACrB;EACA,QAAQ;EACR,MAAM;GACJ,SAAS,IAAI;GACb,QAAQ,IAAI;EACd;EACA,OAAO;GACL,QAAQ,IAAI;GACZ,UAAU,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM;EACjC;EACA,aAAa;GAAC;GAAiB;GAAM,QAAQ,MAAM,GAAG,GAAG;EAAC;CAC5D;AACF;AAEA,SAAS,gBAAgB,QAAgB,oBAAsC;CAC7E,IAAI;EACF,MAAM,MAAM,IAAI,IAAI,MAAM;EAC1B,OAAO,qBAAqB,GAAG,IAAI,WAAW,IAAI,WAAW,IAAI;CACnE,QAAQ;EACN,OAAO,qBAAqB,SAAS;CACvC;AACF;AAEA,SAAS,uBAA+B;CACtC,MAAM,SACJ,OAAO,WAAW,eAAe,gBAAgB,SAC7C,OAAO,WAAW,IAClB,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;CACxC,OAAO,OAAO,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,GAAG;AAC3C;AAEA,eAAe,qBAAwB,KAAa,YAAY,MAAyB;CACvF,IAAI;EACF,MAAM,WAAW,MAAM,MAAM,KAAK;GAChC,SAAS,EAAE,QAAQ,mBAAmB;GACtC,QAAQ,YAAY,IAAI,YAAY,QAAQ,SAAS,IAAI,KAAA;EAC3D,CAAC;EACD,IAAI,CAAC,SAAS,IAAI,OAAO;EACzB,OAAQ,MAAM,SAAS,KAAK;CAC9B,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,gBACP,UACA,MACA,KACA,UAA4C,CAAC,GAC9B;CACf,MAAM,SAAS,aAAa,UAAU,IAAI;CAC1C,IAAI,mBAAmB,KAAK,MAAM,GAAG,OAAO;CAC5C,MAAM,OAAO,0BAA0B,KAAK,QAAQ,OAAO;CAC3D,IAAI,CAAC,MAAM,OAAO;CAClB,OAAO,GAAG,aAAA,oBAAoB,IAAI,EAAE,GAAG,OAAO,QAAQ,QAAQ,EAAE;AAClE;AAEA,SAAS,0BACP,KACA,SACe;CACf,IAAI,OAAO,YAAY,YACrB,OAAO,QAAQ,GAAG,KAAK;CAEzB,IAAI,SAAS,OAAO;CACpB,OAAO,IAAI,SAAS,OAAO;AAC7B;AAEA,SAAS,uBAAuB,SAA6C;CAC3E,MAAM,WAAW,QAAQ,YAAY,CAAC;CACtC,MAAM,MAAM,SAAS;CACrB,OAAO;EACL;EACA,WAAW,SAAS,aAAa;CACnC;AACF;AAEA,SAAS,wBAAwB,SAAqC;CACpE,OAAO,CAAC,EACN,QAAQ,MAAM,YACd,QAAQ,MAAM,iBACd,QAAQ,KAAK,YACb,QAAQ,KAAK,iBACb,QAAQ;AAEZ;AAEA,SAAS,kBAAkB,UAA0B;CACnD,IAAI,aAAa,KAAK,OAAO;CAC7B,OAAO,aAAA,oBAAoB,QAAQ,KAAK;AAC1C;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AACrE;AAEA,SAAS,aAAa,OAAyB;CAC7C,IAAI,CAAC,SAAS,OAAO,UAAU,UAAU,OAAO;CAChD,OAAO,OAAO,KAAK,KAAgC,CAAC,CAAC,MAAK,QAAO,IAAI,SAAS,GAAG,CAAC;AACpF;AAEA,SAAS,mBAAmB,MAAwD;CAClF,MAAM,MAA+B,CAAC;CACtC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,GAAG;EAC/C,MAAM,QAAQ,IAAI,MAAM,GAAG;EAC3B,IAAI,MAAM;EACV,MAAM,SAAS,MAAM,UAAU;GAC7B,IAAI,UAAU,MAAM,SAAS,GAAG;IAC9B,IAAI,QAAQ;IACZ;GACF;GACA,MAAM,OAAO,IAAI;GACjB,IAAI,CAAC,QAAQ,OAAO,SAAS,UAAU,IAAI,QAAQ,CAAC;GACpD,MAAM,IAAI;EACZ,CAAC;CACH;CACA,OAAO;AACT"}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 组件发现器
|
|
3
|
+
*
|
|
4
|
+
* 核心设计:
|
|
5
|
+
* 1. 所有组件默认是 Server Component (RSC)
|
|
6
|
+
* 2. 只有显式标记 'use client' 的组件才是 Client Component
|
|
7
|
+
* 3. 使用 AST 解析指令和导出,确保准确性
|
|
8
|
+
* 4. 支持边界传播分析
|
|
9
|
+
*/
|
|
10
|
+
import type { ComponentMetadata, FileInfo } from './types';
|
|
11
|
+
/**
|
|
12
|
+
* 增强的组件元数据
|
|
13
|
+
*/
|
|
14
|
+
export interface EnhancedComponentMetadata extends ComponentMetadata {
|
|
15
|
+
/** 是否显式标记为客户端 */
|
|
16
|
+
hasClientDirective: boolean;
|
|
17
|
+
/** 是否显式标记为服务端(Server Actions) */
|
|
18
|
+
hasServerDirective: boolean;
|
|
19
|
+
/** 是否有默认导出 */
|
|
20
|
+
hasDefaultExport: boolean;
|
|
21
|
+
/** 命名导出列表 */
|
|
22
|
+
namedExports: string[];
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* 从文件内容解析组件类型
|
|
26
|
+
* 默认为 server,只有 'use client' 才是 client
|
|
27
|
+
*/
|
|
28
|
+
export { parseComponentType } from './directiveParser';
|
|
29
|
+
/**
|
|
30
|
+
* 从文件内容提取导出(使用 AST)
|
|
31
|
+
*/
|
|
32
|
+
export declare function extractExports(content: string): string[];
|
|
33
|
+
/**
|
|
34
|
+
* 生成组件 ID
|
|
35
|
+
*/
|
|
36
|
+
export declare function generateComponentId(relativePath: string): string;
|
|
37
|
+
/**
|
|
38
|
+
* 从路径提取组件名称
|
|
39
|
+
*/
|
|
40
|
+
export declare function extractComponentName(relativePath: string): string;
|
|
41
|
+
/**
|
|
42
|
+
* 从文件信息解析组件元数据
|
|
43
|
+
*/
|
|
44
|
+
export declare function parseComponentFromFile(fileInfo: FileInfo): EnhancedComponentMetadata;
|
|
45
|
+
/**
|
|
46
|
+
* 批量解析组件
|
|
47
|
+
*/
|
|
48
|
+
export declare function parseComponents(files: FileInfo[]): EnhancedComponentMetadata[];
|
|
49
|
+
/**
|
|
50
|
+
* 过滤客户端组件
|
|
51
|
+
*/
|
|
52
|
+
export declare function filterClientComponents(components: EnhancedComponentMetadata[]): EnhancedComponentMetadata[];
|
|
53
|
+
/**
|
|
54
|
+
* 过滤服务端组件
|
|
55
|
+
*/
|
|
56
|
+
export declare function filterServerComponents(components: EnhancedComponentMetadata[]): EnhancedComponentMetadata[];
|
|
57
|
+
/**
|
|
58
|
+
* 统计组件类型分布
|
|
59
|
+
*/
|
|
60
|
+
export interface ComponentStats {
|
|
61
|
+
total: number;
|
|
62
|
+
client: number;
|
|
63
|
+
server: number;
|
|
64
|
+
withClientDirective: number;
|
|
65
|
+
withServerDirective: number;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* 获取组件统计信息
|
|
69
|
+
*/
|
|
70
|
+
export declare function getComponentStats(components: EnhancedComponentMetadata[]): ComponentStats;
|
|
71
|
+
//# sourceMappingURL=componentDiscovery.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"componentDiscovery.d.ts","sourceRoot":"","sources":["../../src/discovery/componentDiscovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,iBAAiB;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iCAAiC;IACjC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc;IACd,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,yBAAyB,CAqBpF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,yBAAyB,EAAE,CAE9E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,yBAAyB,EAAE,GACtC,yBAAyB,EAAE,CAE7B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,yBAAyB,EAAE,GACtC,yBAAyB,EAAE,CAE7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,yBAAyB,EAAE,GAAG,cAAc,CAQzF"}
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AST 指令解析器
|
|
3
|
+
* 使用 TypeScript Compiler API 解析 'use client' 和 'use server' 指令
|
|
4
|
+
*
|
|
5
|
+
* 设计原则:
|
|
6
|
+
* 1. 默认所有组件都是 Server Component (RSC)
|
|
7
|
+
* 2. 只有显式标记 'use client' 的组件才是客户端组件
|
|
8
|
+
* 3. 'use server' 用于标记 Server Actions
|
|
9
|
+
* 4. 纯内存 AST 解析,无文件 I/O
|
|
10
|
+
*
|
|
11
|
+
* 性能说明:
|
|
12
|
+
* - 当前使用 TypeScript Compiler API(比 SWC 慢 10-50x)
|
|
13
|
+
* - 已通过增量分析 + 缓存优化(见 incrementalAnalyzer.ts)
|
|
14
|
+
* - 未来可迁移到 @swc/core 或 oxc 获得更好性能
|
|
15
|
+
*/
|
|
16
|
+
import ts from 'typescript';
|
|
17
|
+
import type { ComponentType } from './types';
|
|
18
|
+
/** 指令类型 - 支持 React 19 的 'use cache' */
|
|
19
|
+
export type DirectiveType = 'use client' | 'use server' | 'use cache';
|
|
20
|
+
/** 指令错误类型 */
|
|
21
|
+
export type DirectiveErrorCode = 'CONFLICT' | 'CONFLICT_CACHE' | 'PARENTHESIZED' | 'INVALID_POSITION' | 'DUPLICATE' | 'UNKNOWN_DIRECTIVE' | 'FORBIDDEN_EXPORT' | 'MISSING_CLIENT_DIRECTIVE';
|
|
22
|
+
/** 指令错误信息 */
|
|
23
|
+
export interface DirectiveError {
|
|
24
|
+
/** 错误代码 */
|
|
25
|
+
code: DirectiveErrorCode;
|
|
26
|
+
/** 错误消息 */
|
|
27
|
+
message: string;
|
|
28
|
+
/** 错误详情 */
|
|
29
|
+
details?: string;
|
|
30
|
+
/** 行号(从 0 开始) */
|
|
31
|
+
line: number;
|
|
32
|
+
/** 列号 */
|
|
33
|
+
column: number;
|
|
34
|
+
/** 建议的修复方式 */
|
|
35
|
+
suggestion?: string;
|
|
36
|
+
}
|
|
37
|
+
/** 检测到的指令信息 */
|
|
38
|
+
export interface DetectedDirective {
|
|
39
|
+
/** 指令类型 */
|
|
40
|
+
type: DirectiveType;
|
|
41
|
+
/** 行号(从 0 开始) */
|
|
42
|
+
line: number;
|
|
43
|
+
/** 列号 */
|
|
44
|
+
column: number;
|
|
45
|
+
/** 是否有效 */
|
|
46
|
+
isValid: boolean;
|
|
47
|
+
}
|
|
48
|
+
/** 完整的解析结果 */
|
|
49
|
+
export interface DirectiveAnalysisResult {
|
|
50
|
+
/** 有效的指令(第一个有效指令) */
|
|
51
|
+
directive: DirectiveType | null;
|
|
52
|
+
/** 所有检测到的指令 */
|
|
53
|
+
allDirectives: DetectedDirective[];
|
|
54
|
+
/** 是否为有效位置 */
|
|
55
|
+
isValidPosition: boolean;
|
|
56
|
+
/** 行号 */
|
|
57
|
+
line: number | null;
|
|
58
|
+
/** 检测到的错误 */
|
|
59
|
+
errors: DirectiveError[];
|
|
60
|
+
/** 是否有错误 */
|
|
61
|
+
hasErrors: boolean;
|
|
62
|
+
}
|
|
63
|
+
/** 兼容层解析结果(旧 API 签名) */
|
|
64
|
+
export interface DirectiveParseResult {
|
|
65
|
+
/** 检测到的指令 */
|
|
66
|
+
directive: DirectiveType | null;
|
|
67
|
+
/** 指令位置(行号,从 0 开始) */
|
|
68
|
+
line: number | null;
|
|
69
|
+
/** 是否为有效位置(文件顶部,仅在注释之后) */
|
|
70
|
+
isValidPosition: boolean;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* 创建 SourceFile(纯内存操作)
|
|
74
|
+
*
|
|
75
|
+
* 注意:ts.createSourceFile 是纯内存操作,不涉及文件系统
|
|
76
|
+
*/
|
|
77
|
+
export declare function createSourceFile(content: string, scriptKind?: ts.ScriptKind): ts.SourceFile;
|
|
78
|
+
/**
|
|
79
|
+
* 完整的指令分析
|
|
80
|
+
*
|
|
81
|
+
* 检测规则:
|
|
82
|
+
* 1. 指令必须是文件的第一个语句(import 之前)
|
|
83
|
+
* 2. 指令必须是字符串字面量 'use client' 或 'use server'
|
|
84
|
+
* 3. 不能同时存在 'use client' 和 'use server'
|
|
85
|
+
* 4. 不能使用括号形式 ('use client')
|
|
86
|
+
* 5. 指令后出现其他语句后不能再有指令
|
|
87
|
+
*/
|
|
88
|
+
export declare function analyzeDirectives(content: string): DirectiveAnalysisResult;
|
|
89
|
+
/**
|
|
90
|
+
* 使用 AST 解析代码中的指令(便捷接口)
|
|
91
|
+
*
|
|
92
|
+
* 规则:
|
|
93
|
+
* 1. 指令必须是文件的第一个语句(import 之前)
|
|
94
|
+
* 2. 指令必须是字符串字面量表达式 'use client' 或 "use client"
|
|
95
|
+
* 3. 只有 'use client' 和 'use server' 是有效指令
|
|
96
|
+
*/
|
|
97
|
+
export declare function parseDirective(content: string): DirectiveParseResult;
|
|
98
|
+
/**
|
|
99
|
+
* 验证指令并返回错误(如果有)
|
|
100
|
+
*/
|
|
101
|
+
export declare function validateDirectives(content: string): DirectiveError[];
|
|
102
|
+
/**
|
|
103
|
+
* 检查指令是否有冲突
|
|
104
|
+
*/
|
|
105
|
+
export declare function hasDirectiveConflict(content: string): boolean;
|
|
106
|
+
/**
|
|
107
|
+
* 从指令确定组件类型
|
|
108
|
+
*
|
|
109
|
+
* 规则:
|
|
110
|
+
* - 'use client' → client
|
|
111
|
+
* - 'use server' → server (Server Actions)
|
|
112
|
+
* - 无指令 → server (默认 RSC)
|
|
113
|
+
*/
|
|
114
|
+
export declare function getComponentTypeFromDirective(result: DirectiveParseResult): ComponentType;
|
|
115
|
+
/**
|
|
116
|
+
* 解析组件类型(便捷接口)
|
|
117
|
+
*
|
|
118
|
+
* @param content - 源代码
|
|
119
|
+
* @returns 'client' | 'server',默认为 'server'
|
|
120
|
+
*/
|
|
121
|
+
export declare function parseComponentType(content: string): ComponentType;
|
|
122
|
+
/**
|
|
123
|
+
* 检查是否为客户端组件
|
|
124
|
+
*/
|
|
125
|
+
export declare function isClientComponent(content: string): boolean;
|
|
126
|
+
/**
|
|
127
|
+
* 检查是否为服务端组件
|
|
128
|
+
*/
|
|
129
|
+
export declare function isServerComponent(content: string): boolean;
|
|
130
|
+
/**
|
|
131
|
+
* 检查是否有 'use client' 指令
|
|
132
|
+
*/
|
|
133
|
+
export declare function hasClientDirective(content: string): boolean;
|
|
134
|
+
/**
|
|
135
|
+
* 检查是否有 'use server' 指令(Server Actions)
|
|
136
|
+
*/
|
|
137
|
+
export declare function hasServerDirective(content: string): boolean;
|
|
138
|
+
/**
|
|
139
|
+
* 检查是否有 'use cache' 指令(React 19 缓存)
|
|
140
|
+
*/
|
|
141
|
+
export declare function hasCacheDirective(content: string): boolean;
|
|
142
|
+
/**
|
|
143
|
+
* 格式化指令错误为可读消息
|
|
144
|
+
*/
|
|
145
|
+
export declare function formatDirectiveErrors(errors: DirectiveError[]): string;
|
|
146
|
+
/**
|
|
147
|
+
* Client Component 禁止导出的 Server-only 标识符
|
|
148
|
+
* (这些 export 名只在服务端组件里才有意义,标了 'use client' 时应当报错)
|
|
149
|
+
*/
|
|
150
|
+
export declare const FORBIDDEN_CLIENT_EXPORTS: Set<string>;
|
|
151
|
+
/** Metadata 导出违规信息 */
|
|
152
|
+
export interface ForbiddenExportViolation {
|
|
153
|
+
/** 禁止的导出名称 */
|
|
154
|
+
exportName: string;
|
|
155
|
+
/** 行号 */
|
|
156
|
+
line: number;
|
|
157
|
+
/** 列号 */
|
|
158
|
+
column: number;
|
|
159
|
+
/** 原因说明 */
|
|
160
|
+
reason: string;
|
|
161
|
+
}
|
|
162
|
+
/**
|
|
163
|
+
* 检查 Client Component 是否包含禁止的导出
|
|
164
|
+
*
|
|
165
|
+
* 规则:
|
|
166
|
+
* - Client Component ('use client') 不能导出 metadata、generateMetadata 等
|
|
167
|
+
* - 这些 API 只能在 Server Components 中使用
|
|
168
|
+
*
|
|
169
|
+
* @param content - 源代码
|
|
170
|
+
* @returns 违规信息列表
|
|
171
|
+
*/
|
|
172
|
+
export declare function checkForbiddenExports(content: string): ForbiddenExportViolation[];
|
|
173
|
+
/**
|
|
174
|
+
* 检查文件是否需要强制 'use client'
|
|
175
|
+
*
|
|
176
|
+
* @param filePath 文件路径
|
|
177
|
+
* @returns 如果需要强制 'use client',返回文件类型描述
|
|
178
|
+
*/
|
|
179
|
+
export declare function requiresClientDirective(filePath: string): string | null;
|
|
180
|
+
/**
|
|
181
|
+
* 检查特殊文件是否缺少 'use client' 指令
|
|
182
|
+
*
|
|
183
|
+
* @param content 文件内容
|
|
184
|
+
* @param filePath 文件路径
|
|
185
|
+
* @returns 如果缺少必要的 'use client' 指令,返回错误
|
|
186
|
+
*/
|
|
187
|
+
export declare function checkClientRequiredFile(content: string, filePath: string): DirectiveError | null;
|
|
188
|
+
/**
|
|
189
|
+
* 完整验证:指令 + 禁止导出检查 + 特殊文件检查
|
|
190
|
+
*
|
|
191
|
+
* 同时检查:
|
|
192
|
+
* 1. 指令错误(位置、冲突等)
|
|
193
|
+
* 2. Client Component 中的禁止导出
|
|
194
|
+
* 3. 特殊文件必须是 Client Component
|
|
195
|
+
*/
|
|
196
|
+
export declare function validateFile(content: string, filePath?: string): DirectiveError[];
|
|
197
|
+
//# sourceMappingURL=directiveParser.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"directiveParser.d.ts","sourceRoot":"","sources":["../../src/discovery/directiveParser.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AST 导出解析器
|
|
3
|
+
* 使用 TypeScript Compiler API 解析模块导出
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
* 导出类型
|
|
7
|
+
*/
|
|
8
|
+
export type ExportKind = 'default' | 'named' | 'reexport' | 'reexport-all';
|
|
9
|
+
/**
|
|
10
|
+
* 导出信息
|
|
11
|
+
*/
|
|
12
|
+
export interface ExportInfo {
|
|
13
|
+
/** 导出名称 */
|
|
14
|
+
name: string;
|
|
15
|
+
/** 本地名称(如果有 as 重命名) */
|
|
16
|
+
localName?: string;
|
|
17
|
+
/** 导出类型 */
|
|
18
|
+
kind: ExportKind;
|
|
19
|
+
/** 来源模块(re-export 时有值) */
|
|
20
|
+
from?: string;
|
|
21
|
+
/** 是否为类型导出 */
|
|
22
|
+
isType: boolean;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* 模块导出分析结果
|
|
26
|
+
*/
|
|
27
|
+
export interface ModuleExports {
|
|
28
|
+
/** 所有导出 */
|
|
29
|
+
exports: ExportInfo[];
|
|
30
|
+
/** 是否有默认导出 */
|
|
31
|
+
hasDefault: boolean;
|
|
32
|
+
/** 命名导出列表 */
|
|
33
|
+
namedExports: string[];
|
|
34
|
+
/** re-export 来源模块列表 */
|
|
35
|
+
reexportSources: string[];
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* 使用 AST 解析模块导出
|
|
39
|
+
*/
|
|
40
|
+
export declare function parseExports(content: string): ModuleExports;
|
|
41
|
+
/**
|
|
42
|
+
* 便捷接口:获取所有导出名称(过滤 type-only 导出)
|
|
43
|
+
*/
|
|
44
|
+
export declare function getExportNames(content: string): string[];
|
|
45
|
+
//# sourceMappingURL=exportParser.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"exportParser.d.ts","sourceRoot":"","sources":["../../src/discovery/exportParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,OAAO,GACP,UAAU,GACV,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,cAAc;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,uBAAuB;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA6E3D;AAmFD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWxD"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 文件系统工具函数
|
|
3
|
+
* 提供文件遍历、读取等基础能力
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
* 递归读取目录下所有文件
|
|
7
|
+
*/
|
|
8
|
+
export declare function readDirRecursive(dir: string): Promise<string[]>;
|
|
9
|
+
/**
|
|
10
|
+
* 读取文件头部内容(用于检测指令)
|
|
11
|
+
*/
|
|
12
|
+
export declare function readFileHeader(filePath: string, length?: number): Promise<string>;
|
|
13
|
+
/**
|
|
14
|
+
* 判断是否为代码文件
|
|
15
|
+
*/
|
|
16
|
+
export declare function isCodeFile(filePath: string): boolean;
|
|
17
|
+
/**
|
|
18
|
+
* 判断是否为测试文件
|
|
19
|
+
*/
|
|
20
|
+
export declare function isTestFile(filePath: string): boolean;
|
|
21
|
+
/**
|
|
22
|
+
* 判断是否应该跳过该文件
|
|
23
|
+
*/
|
|
24
|
+
export declare function shouldSkipFile(filePath: string): boolean;
|
|
25
|
+
/**
|
|
26
|
+
* 获取相对路径
|
|
27
|
+
*/
|
|
28
|
+
export declare function getRelativePath(filePath: string, baseDir: string): string;
|
|
29
|
+
/**
|
|
30
|
+
* 检查目录是否存在
|
|
31
|
+
*/
|
|
32
|
+
export declare function directoryExists(dirPath: string): Promise<boolean>;
|
|
33
|
+
//# sourceMappingURL=fileSystem.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fileSystem.d.ts","sourceRoot":"","sources":["../../src/discovery/fileSystem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBrE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUpF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvE"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Discovery 模块入口(精简版)
|
|
3
|
+
*
|
|
4
|
+
* plugin-rsc 模式下引擎只需要"扫描磁盘统计文件"这个能力:
|
|
5
|
+
* - ISREngine 启动日志
|
|
6
|
+
* - SEO 引擎生成 sitemap 时的路由枚举
|
|
7
|
+
*
|
|
8
|
+
* "use client" / "use server" 指令识别、AST 边界分析、client/server proxy
|
|
9
|
+
* 代码生成等能力,**全部由 `@vitejs/plugin-rsc` 在编译期处理**,engine 不再
|
|
10
|
+
* 维护平行实现。
|
|
11
|
+
*/
|
|
12
|
+
export type { ComponentMetadata, ComponentType, FileInfo, RouteDiscoveryConfig, RouteMetadata, RouteType, } from './types';
|
|
13
|
+
export { SUPPORTED_EXTENSIONS } from './types';
|
|
14
|
+
export { readDirRecursive, readFileHeader, isCodeFile, isTestFile, shouldSkipFile, getRelativePath, directoryExists, } from './fileSystem';
|
|
15
|
+
export { parseRouteFromFile, parseRoutes, detectRouteConflicts, matchRoute, formatRoutes, generateRouteConfig, type ParsedRoute, type RouteMatch, type DynamicParam, } from './routeDiscovery';
|
|
16
|
+
export { parseComponentFromFile, parseComponents, extractExports, generateComponentId, extractComponentName, filterClientComponents, filterServerComponents, getComponentStats, type ComponentStats, type EnhancedComponentMetadata, } from './componentDiscovery';
|
|
17
|
+
export { scanProject, scanRoutes, scanComponents, DEFAULT_SCAN_CONFIG, type ScanConfig, type ScanResult, } from './scan';
|
|
18
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,oBAAoB,EACpB,aAAa,EACb,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,yBAAyB,GAC/B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,WAAW,EACX,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,QAAQ,CAAC"}
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 路由发现器
|
|
3
|
+
*
|
|
4
|
+
* ISR-Engine 的路由发现模块,专注于:
|
|
5
|
+
* 1. 从文件路径解析 URL 路由
|
|
6
|
+
* 2. 动态路由参数识别 [id] -> :id
|
|
7
|
+
* 3. Catch-all 路由支持 [...slug] -> *slug
|
|
8
|
+
*
|
|
9
|
+
* 设计原则:
|
|
10
|
+
* - 不强制使用特定的文件约定(如 page.tsx、layout.tsx)
|
|
11
|
+
* - 支持 pages 目录风格和自定义配置
|
|
12
|
+
* - 简单、准确、可预测
|
|
13
|
+
*
|
|
14
|
+
* 不实现的特性(保持简单):
|
|
15
|
+
* - 路由组 (group) 和平行路由 @slot —— 用 routes.tsx 显式表达更清晰
|
|
16
|
+
*/
|
|
17
|
+
import type { RouteDiscoveryConfig, FileInfo, RouteType } from './types';
|
|
18
|
+
export type { RouteType };
|
|
19
|
+
/**
|
|
20
|
+
* 动态路由参数信息
|
|
21
|
+
*/
|
|
22
|
+
export interface DynamicParam {
|
|
23
|
+
/** 参数名称 */
|
|
24
|
+
name: string;
|
|
25
|
+
/** 参数类型 */
|
|
26
|
+
type: 'single' | 'catch-all' | 'optional-catch-all';
|
|
27
|
+
/** 在 URL 中的位置索引 */
|
|
28
|
+
position: number;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* 解析后的路由信息
|
|
32
|
+
*/
|
|
33
|
+
export interface ParsedRoute {
|
|
34
|
+
/** URL 路径(如 /blog/:id) */
|
|
35
|
+
urlPath: string;
|
|
36
|
+
/** 文件绝对路径 */
|
|
37
|
+
filePath: string;
|
|
38
|
+
/** 路由类型 */
|
|
39
|
+
type: RouteType;
|
|
40
|
+
/** 是否为动态路由 */
|
|
41
|
+
isDynamic: boolean;
|
|
42
|
+
/** 动态参数列表 */
|
|
43
|
+
params: DynamicParam[];
|
|
44
|
+
/** 是否为 catch-all 路由 */
|
|
45
|
+
isCatchAll: boolean;
|
|
46
|
+
/** 原始文件相对路径 */
|
|
47
|
+
relativePath: string;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* 从文件路径解析路由
|
|
51
|
+
*
|
|
52
|
+
* 支持的路径格式:
|
|
53
|
+
* - pages/about.tsx -> /about
|
|
54
|
+
* - pages/blog/[id].tsx -> /blog/:id
|
|
55
|
+
* - pages/docs/[...slug].tsx -> /docs/*slug
|
|
56
|
+
* - src/routes/users.tsx -> /users(自定义目录)
|
|
57
|
+
*
|
|
58
|
+
* @param fileInfo - 文件信息
|
|
59
|
+
* @param config - 路由发现配置
|
|
60
|
+
* @returns 解析后的路由信息,无法解析时返回 null
|
|
61
|
+
*/
|
|
62
|
+
export declare function parseRouteFromFile(fileInfo: FileInfo, config: RouteDiscoveryConfig): ParsedRoute | null;
|
|
63
|
+
/**
|
|
64
|
+
* 批量解析路由
|
|
65
|
+
*
|
|
66
|
+
* @param files - 文件信息列表
|
|
67
|
+
* @param config - 路由发现配置
|
|
68
|
+
* @returns 解析后的路由列表
|
|
69
|
+
*/
|
|
70
|
+
export declare function parseRoutes(files: FileInfo[], config: RouteDiscoveryConfig): ParsedRoute[];
|
|
71
|
+
/**
|
|
72
|
+
* 检测路由冲突
|
|
73
|
+
*
|
|
74
|
+
* @param routes - 路由列表
|
|
75
|
+
* @returns 冲突的路由对
|
|
76
|
+
*/
|
|
77
|
+
export declare function detectRouteConflicts(routes: ParsedRoute[]): Array<{
|
|
78
|
+
route1: ParsedRoute;
|
|
79
|
+
route2: ParsedRoute;
|
|
80
|
+
reason: string;
|
|
81
|
+
}>;
|
|
82
|
+
/**
|
|
83
|
+
* 匹配结果
|
|
84
|
+
*/
|
|
85
|
+
export interface RouteMatch {
|
|
86
|
+
/** 匹配的路由 */
|
|
87
|
+
route: ParsedRoute;
|
|
88
|
+
/** 提取的参数 */
|
|
89
|
+
params: Record<string, string>;
|
|
90
|
+
/** 匹配分数(用于排序) */
|
|
91
|
+
score: number;
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* 匹配 URL 到路由
|
|
95
|
+
*
|
|
96
|
+
* @param pathname - 要匹配的 URL 路径
|
|
97
|
+
* @param routes - 路由列表
|
|
98
|
+
* @returns 最佳匹配结果,无匹配时返回 null
|
|
99
|
+
*/
|
|
100
|
+
export declare function matchRoute(pathname: string, routes: ParsedRoute[]): RouteMatch | null;
|
|
101
|
+
/**
|
|
102
|
+
* 格式化路由列表(用于调试)
|
|
103
|
+
*/
|
|
104
|
+
export declare function formatRoutes(routes: ParsedRoute[]): string;
|
|
105
|
+
/**
|
|
106
|
+
* 生成路由配置(用于运行时路由器)
|
|
107
|
+
*
|
|
108
|
+
* @param routes - 路由列表
|
|
109
|
+
* @returns 路由配置对象
|
|
110
|
+
*/
|
|
111
|
+
export declare function generateRouteConfig(routes: ParsedRoute[]): {
|
|
112
|
+
pages: Array<{
|
|
113
|
+
path: string;
|
|
114
|
+
component: string;
|
|
115
|
+
}>;
|
|
116
|
+
apis: Array<{
|
|
117
|
+
path: string;
|
|
118
|
+
handler: string;
|
|
119
|
+
}>;
|
|
120
|
+
};
|
|
121
|
+
//# sourceMappingURL=routeDiscovery.d.ts.map
|