isr-engine 0.0.0-stage → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (452) hide show
  1. package/CHANGELOG.md +755 -0
  2. package/README.md +170 -2
  3. package/dist/RequestContext-BVQ-rOmV.js +58 -0
  4. package/dist/RequestContext-BVQ-rOmV.js.map +1 -0
  5. package/dist/RequestContext-DgGEAxcW.cjs +105 -0
  6. package/dist/RequestContext-DgGEAxcW.cjs.map +1 -0
  7. package/dist/abVariantContext-CWCdRSdG.js +549 -0
  8. package/dist/abVariantContext-CWCdRSdG.js.map +1 -0
  9. package/dist/abVariantContext-Cqp-uxtd.cjs +678 -0
  10. package/dist/abVariantContext-Cqp-uxtd.cjs.map +1 -0
  11. package/dist/adapters/observability/client/sentry.d.ts +42 -0
  12. package/dist/adapters/observability/client/sentry.d.ts.map +1 -0
  13. package/dist/adapters/observability/index.cjs +152 -0
  14. package/dist/adapters/observability/index.cjs.map +1 -0
  15. package/dist/adapters/observability/index.d.ts +17 -0
  16. package/dist/adapters/observability/index.d.ts.map +1 -0
  17. package/dist/adapters/observability/index.js +148 -0
  18. package/dist/adapters/observability/index.js.map +1 -0
  19. package/dist/adapters/observability/server/datadog.d.ts +45 -0
  20. package/dist/adapters/observability/server/datadog.d.ts.map +1 -0
  21. package/dist/adapters/observability/server/otel.d.ts +51 -0
  22. package/dist/adapters/observability/server/otel.d.ts.map +1 -0
  23. package/dist/adapters/observability/server/sentry.d.ts +67 -0
  24. package/dist/adapters/observability/server/sentry.d.ts.map +1 -0
  25. package/dist/adapters/observability/types.d.ts +39 -0
  26. package/dist/adapters/observability/types.d.ts.map +1 -0
  27. package/dist/adapters/runtime/cloudflare.d.ts +33 -0
  28. package/dist/adapters/runtime/cloudflare.d.ts.map +1 -0
  29. package/dist/adapters/runtime/errorResponse.d.ts +3 -0
  30. package/dist/adapters/runtime/errorResponse.d.ts.map +1 -0
  31. package/dist/adapters/runtime/index.cjs +100 -0
  32. package/dist/adapters/runtime/index.cjs.map +1 -0
  33. package/dist/adapters/runtime/index.d.ts +10 -0
  34. package/dist/adapters/runtime/index.d.ts.map +1 -0
  35. package/dist/adapters/runtime/index.js +97 -0
  36. package/dist/adapters/runtime/index.js.map +1 -0
  37. package/dist/adapters/runtime/types.d.ts +24 -0
  38. package/dist/adapters/runtime/types.d.ts.map +1 -0
  39. package/dist/adapters/runtime/vercel-edge.d.ts +59 -0
  40. package/dist/adapters/runtime/vercel-edge.d.ts.map +1 -0
  41. package/dist/app/createISRApp.d.ts +19 -0
  42. package/dist/app/createISRApp.d.ts.map +1 -0
  43. package/dist/cache/CacheManager.d.ts +81 -0
  44. package/dist/cache/CacheManager.d.ts.map +1 -0
  45. package/dist/cache/ICacheAdapter.d.ts +84 -0
  46. package/dist/cache/ICacheAdapter.d.ts.map +1 -0
  47. package/dist/cache/MemoryCacheAdapter.d.ts +50 -0
  48. package/dist/cache/MemoryCacheAdapter.d.ts.map +1 -0
  49. package/dist/cache/RedisCacheAdapter.d.ts +111 -0
  50. package/dist/cache/RedisCacheAdapter.d.ts.map +1 -0
  51. package/dist/cache/RedisInvalidationBus.d.ts +59 -0
  52. package/dist/cache/RedisInvalidationBus.d.ts.map +1 -0
  53. package/dist/cache/RedisResponseCacheBackend.d.ts +30 -0
  54. package/dist/cache/RedisResponseCacheBackend.d.ts.map +1 -0
  55. package/dist/cache/ResponseCacheBackend.d.ts +28 -0
  56. package/dist/cache/ResponseCacheBackend.d.ts.map +1 -0
  57. package/dist/cache/createAutoCacheStore.d.ts +26 -0
  58. package/dist/cache/createAutoCacheStore.d.ts.map +1 -0
  59. package/dist/cache/index.d.ts +18 -0
  60. package/dist/cache/index.d.ts.map +1 -0
  61. package/dist/cli/cli.cjs +372 -0
  62. package/dist/cli/cli.cjs.map +1 -0
  63. package/dist/cli/cli.d.ts +8 -0
  64. package/dist/cli/cli.d.ts.map +1 -0
  65. package/dist/cli/cli.js +370 -0
  66. package/dist/cli/cli.js.map +1 -0
  67. package/dist/cli/dev.d.ts +11 -0
  68. package/dist/cli/dev.d.ts.map +1 -0
  69. package/dist/cli/fallback.d.ts +42 -0
  70. package/dist/cli/fallback.d.ts.map +1 -0
  71. package/dist/cli/serverOptions.d.ts +7 -0
  72. package/dist/cli/serverOptions.d.ts.map +1 -0
  73. package/dist/cli/start.d.ts +7 -0
  74. package/dist/cli/start.d.ts.map +1 -0
  75. package/dist/config/defaults.d.ts +11 -0
  76. package/dist/config/defaults.d.ts.map +1 -0
  77. package/dist/config/defineConfig.cjs +26 -0
  78. package/dist/config/defineConfig.cjs.map +1 -0
  79. package/dist/config/defineConfig.d.ts +44 -0
  80. package/dist/config/defineConfig.d.ts.map +1 -0
  81. package/dist/config/defineConfig.js +24 -0
  82. package/dist/config/defineConfig.js.map +1 -0
  83. package/dist/config/getEnv.d.ts +9 -0
  84. package/dist/config/getEnv.d.ts.map +1 -0
  85. package/dist/config/getStatus.d.ts +3 -0
  86. package/dist/config/getStatus.d.ts.map +1 -0
  87. package/dist/config/loadConfig.d.ts +18 -0
  88. package/dist/config/loadConfig.d.ts.map +1 -0
  89. package/dist/config/normalizeEngineConfig.d.ts +10 -0
  90. package/dist/config/normalizeEngineConfig.d.ts.map +1 -0
  91. package/dist/config/resolveImageOptions.d.ts +5 -0
  92. package/dist/config/resolveImageOptions.d.ts.map +1 -0
  93. package/dist/config/resolveRuntimeRedis.d.ts +11 -0
  94. package/dist/config/resolveRuntimeRedis.d.ts.map +1 -0
  95. package/dist/context/RequestContext.d.ts +28 -0
  96. package/dist/context/RequestContext.d.ts.map +1 -0
  97. package/dist/context/createServerRequestContext.d.ts +42 -0
  98. package/dist/context/createServerRequestContext.d.ts.map +1 -0
  99. package/dist/createCacheInspectorMiddleware-DGSjHQJd.cjs +105 -0
  100. package/dist/createCacheInspectorMiddleware-DGSjHQJd.cjs.map +1 -0
  101. package/dist/createCacheInspectorMiddleware-Dmuobpcb.js +105 -0
  102. package/dist/createCacheInspectorMiddleware-Dmuobpcb.js.map +1 -0
  103. package/dist/createISRApp-CDkyUuW3.js +7321 -0
  104. package/dist/createISRApp-CDkyUuW3.js.map +1 -0
  105. package/dist/createISRApp-Nv9mwX8I.cjs +7662 -0
  106. package/dist/createISRApp-Nv9mwX8I.cjs.map +1 -0
  107. package/dist/createImagePlugin-BVUPlPOz.js +416 -0
  108. package/dist/createImagePlugin-BVUPlPOz.js.map +1 -0
  109. package/dist/createImagePlugin-D-X_HGlR.cjs +435 -0
  110. package/dist/createImagePlugin-D-X_HGlR.cjs.map +1 -0
  111. package/dist/defaults/auto-observability.cjs +147 -0
  112. package/dist/defaults/auto-observability.cjs.map +1 -0
  113. package/dist/defaults/auto-observability.d.ts +21 -0
  114. package/dist/defaults/auto-observability.d.ts.map +1 -0
  115. package/dist/defaults/auto-observability.js +144 -0
  116. package/dist/defaults/auto-observability.js.map +1 -0
  117. package/dist/defaults/runtime/browserObservability.d.ts +73 -0
  118. package/dist/defaults/runtime/browserObservability.d.ts.map +1 -0
  119. package/dist/defaults/runtime/client-navigation-policy.d.ts +10 -0
  120. package/dist/defaults/runtime/client-navigation-policy.d.ts.map +1 -0
  121. package/dist/defaults/runtime/createCachedFetcher.d.ts +17 -0
  122. package/dist/defaults/runtime/createCachedFetcher.d.ts.map +1 -0
  123. package/dist/defaults/runtime/defineSiteHooks.cjs +11 -0
  124. package/dist/defaults/runtime/defineSiteHooks.d.ts +197 -0
  125. package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -0
  126. package/dist/defaults/runtime/defineSiteHooks.js +3 -0
  127. package/dist/defaults/runtime/dev-css-handoff.client.d.ts +2 -0
  128. package/dist/defaults/runtime/dev-css-handoff.client.d.ts.map +1 -0
  129. package/dist/defaults/runtime/dev-render-inspector.d.ts +57 -0
  130. package/dist/defaults/runtime/dev-render-inspector.d.ts.map +1 -0
  131. package/dist/defaults/runtime/dev-rsc-response.client.d.ts +7 -0
  132. package/dist/defaults/runtime/dev-rsc-response.client.d.ts.map +1 -0
  133. package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts +9 -0
  134. package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts.map +1 -0
  135. package/dist/defaults/runtime/dev-style-declarations.server.d.ts +15 -0
  136. package/dist/defaults/runtime/dev-style-declarations.server.d.ts.map +1 -0
  137. package/dist/defaults/runtime/dev-style-id.d.ts +9 -0
  138. package/dist/defaults/runtime/dev-style-id.d.ts.map +1 -0
  139. package/dist/defaults/runtime/dev-style-navigation.client.d.ts +26 -0
  140. package/dist/defaults/runtime/dev-style-navigation.client.d.ts.map +1 -0
  141. package/dist/defaults/runtime/dev-style-registry.client.d.ts +19 -0
  142. package/dist/defaults/runtime/dev-style-registry.client.d.ts.map +1 -0
  143. package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts +4 -0
  144. package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts.map +1 -0
  145. package/dist/defaults/runtime/empty-routes.d.ts +3 -0
  146. package/dist/defaults/runtime/empty-routes.d.ts.map +1 -0
  147. package/dist/defaults/runtime/error-boundary.d.ts +9 -0
  148. package/dist/defaults/runtime/error-boundary.d.ts.map +1 -0
  149. package/dist/defaults/runtime/error500-template.d.ts +21 -0
  150. package/dist/defaults/runtime/error500-template.d.ts.map +1 -0
  151. package/dist/defaults/runtime/head-extras-runtime.d.ts +17 -0
  152. package/dist/defaults/runtime/head-extras-runtime.d.ts.map +1 -0
  153. package/dist/defaults/runtime/hydration-shell.d.ts +12 -0
  154. package/dist/defaults/runtime/hydration-shell.d.ts.map +1 -0
  155. package/dist/defaults/runtime/i18n-server.d.ts +7 -0
  156. package/dist/defaults/runtime/i18n-server.d.ts.map +1 -0
  157. package/dist/defaults/runtime/navigation-history.client.d.ts +16 -0
  158. package/dist/defaults/runtime/navigation-history.client.d.ts.map +1 -0
  159. package/dist/defaults/runtime/navigation-request.client.d.ts +5 -0
  160. package/dist/defaults/runtime/navigation-request.client.d.ts.map +1 -0
  161. package/dist/defaults/runtime/seo-runtime.d.ts +41 -0
  162. package/dist/defaults/runtime/seo-runtime.d.ts.map +1 -0
  163. package/dist/defineSiteHooks-BeVy-qPH.js +720 -0
  164. package/dist/defineSiteHooks-BeVy-qPH.js.map +1 -0
  165. package/dist/defineSiteHooks-C3v3WLS8.cjs +755 -0
  166. package/dist/defineSiteHooks-C3v3WLS8.cjs.map +1 -0
  167. package/dist/discovery/componentDiscovery.d.ts +71 -0
  168. package/dist/discovery/componentDiscovery.d.ts.map +1 -0
  169. package/dist/discovery/directiveParser.d.ts +197 -0
  170. package/dist/discovery/directiveParser.d.ts.map +1 -0
  171. package/dist/discovery/exportParser.d.ts +45 -0
  172. package/dist/discovery/exportParser.d.ts.map +1 -0
  173. package/dist/discovery/fileSystem.d.ts +33 -0
  174. package/dist/discovery/fileSystem.d.ts.map +1 -0
  175. package/dist/discovery/index.d.ts +18 -0
  176. package/dist/discovery/index.d.ts.map +1 -0
  177. package/dist/discovery/routeDiscovery.d.ts +121 -0
  178. package/dist/discovery/routeDiscovery.d.ts.map +1 -0
  179. package/dist/discovery/scan.d.ts +54 -0
  180. package/dist/discovery/scan.d.ts.map +1 -0
  181. package/dist/discovery/types.d.ts +61 -0
  182. package/dist/discovery/types.d.ts.map +1 -0
  183. package/dist/engine/ISREngine.d.ts +54 -0
  184. package/dist/engine/ISREngine.d.ts.map +1 -0
  185. package/dist/engine/RenderMode.d.ts +23 -0
  186. package/dist/engine/RenderMode.d.ts.map +1 -0
  187. package/dist/engine/i18n/types.d.ts +6 -0
  188. package/dist/engine/i18n/types.d.ts.map +1 -0
  189. package/dist/engine/seo/PageSeoMeta.d.ts +9 -0
  190. package/dist/engine/seo/PageSeoMeta.d.ts.map +1 -0
  191. package/dist/engine/seo/SEOEngine.d.ts +61 -0
  192. package/dist/engine/seo/SEOEngine.d.ts.map +1 -0
  193. package/dist/engine/seo/config.d.ts +9 -0
  194. package/dist/engine/seo/config.d.ts.map +1 -0
  195. package/dist/engine/seo/index.d.ts +10 -0
  196. package/dist/engine/seo/index.d.ts.map +1 -0
  197. package/dist/engine/seo/injectSeoMeta.d.ts +5 -0
  198. package/dist/engine/seo/injectSeoMeta.d.ts.map +1 -0
  199. package/dist/engine/seo/resolveSeoConfig.d.ts +15 -0
  200. package/dist/engine/seo/resolveSeoConfig.d.ts.map +1 -0
  201. package/dist/engine/seo/types.d.ts +75 -0
  202. package/dist/engine/seo/types.d.ts.map +1 -0
  203. package/dist/error500-template-BvZmvKoa.cjs +63 -0
  204. package/dist/error500-template-BvZmvKoa.cjs.map +1 -0
  205. package/dist/error500-template-DhaZzLOB.js +63 -0
  206. package/dist/error500-template-DhaZzLOB.js.map +1 -0
  207. package/dist/experiments/ExposureQueue.d.ts +54 -0
  208. package/dist/experiments/ExposureQueue.d.ts.map +1 -0
  209. package/dist/experiments/ManifestLoader.d.ts +57 -0
  210. package/dist/experiments/ManifestLoader.d.ts.map +1 -0
  211. package/dist/i18n-CyJIoYJT.cjs +244 -0
  212. package/dist/i18n-CyJIoYJT.cjs.map +1 -0
  213. package/dist/i18n-Dobe0Wxn.js +191 -0
  214. package/dist/i18n-Dobe0Wxn.js.map +1 -0
  215. package/dist/image/index.cjs +93 -0
  216. package/dist/image/index.cjs.map +1 -0
  217. package/dist/image/index.js +67 -0
  218. package/dist/image/index.js.map +1 -0
  219. package/dist/index.d.ts +59 -0
  220. package/dist/index.d.ts.map +1 -0
  221. package/dist/isr/ISRRoutes.d.ts +25 -0
  222. package/dist/isr/ISRRoutes.d.ts.map +1 -0
  223. package/dist/isr-engine.cjs +2830 -0
  224. package/dist/isr-engine.cjs.map +1 -0
  225. package/dist/isr-engine.js +2740 -0
  226. package/dist/isr-engine.js.map +1 -0
  227. package/dist/logger/Logger.d.ts +33 -0
  228. package/dist/logger/Logger.d.ts.map +1 -0
  229. package/dist/logger/index.d.ts +3 -0
  230. package/dist/logger/index.d.ts.map +1 -0
  231. package/dist/manifest/ManifestLoader.d.ts +98 -0
  232. package/dist/manifest/ManifestLoader.d.ts.map +1 -0
  233. package/dist/manifest/index.d.ts +8 -0
  234. package/dist/manifest/index.d.ts.map +1 -0
  235. package/dist/manifest/types.d.ts +76 -0
  236. package/dist/manifest/types.d.ts.map +1 -0
  237. package/dist/metrics/MetricsCollector.d.ts +90 -0
  238. package/dist/metrics/MetricsCollector.d.ts.map +1 -0
  239. package/dist/metrics/PromMetrics.d.ts +59 -0
  240. package/dist/metrics/PromMetrics.d.ts.map +1 -0
  241. package/dist/metrics/index.d.ts +7 -0
  242. package/dist/metrics/index.d.ts.map +1 -0
  243. package/dist/middlewares/ABVariantMiddleware.d.ts +74 -0
  244. package/dist/middlewares/ABVariantMiddleware.d.ts.map +1 -0
  245. package/dist/middlewares/LocaleRedirect.d.ts +27 -0
  246. package/dist/middlewares/LocaleRedirect.d.ts.map +1 -0
  247. package/dist/middlewares/MiddlewareComposer.d.ts +20 -0
  248. package/dist/middlewares/MiddlewareComposer.d.ts.map +1 -0
  249. package/dist/middlewares/PerformanceMiddleware.d.ts +14 -0
  250. package/dist/middlewares/PerformanceMiddleware.d.ts.map +1 -0
  251. package/dist/middlewares/TraceMiddleware.d.ts +24 -0
  252. package/dist/middlewares/TraceMiddleware.d.ts.map +1 -0
  253. package/dist/middlewares/abVariantContext.d.ts +7 -0
  254. package/dist/middlewares/abVariantContext.d.ts.map +1 -0
  255. package/dist/middlewares/index.d.ts +5 -0
  256. package/dist/middlewares/index.d.ts.map +1 -0
  257. package/dist/middlewares/types.d.ts +4 -0
  258. package/dist/middlewares/types.d.ts.map +1 -0
  259. package/dist/plugin/clientObservabilityConfig.d.ts +16 -0
  260. package/dist/plugin/clientObservabilityConfig.d.ts.map +1 -0
  261. package/dist/plugin/coherentCacheStore.d.ts +11 -0
  262. package/dist/plugin/coherentCacheStore.d.ts.map +1 -0
  263. package/dist/plugin/createAutomaticImagePlugin.d.ts +4 -0
  264. package/dist/plugin/createAutomaticImagePlugin.d.ts.map +1 -0
  265. package/dist/plugin/createCacheInspectorMiddleware.d.ts +16 -0
  266. package/dist/plugin/createCacheInspectorMiddleware.d.ts.map +1 -0
  267. package/dist/plugin/createDevCssHandoffPlugin.d.ts +25 -0
  268. package/dist/plugin/createDevCssHandoffPlugin.d.ts.map +1 -0
  269. package/dist/plugin/createFontPlugin.d.ts +15 -0
  270. package/dist/plugin/createFontPlugin.d.ts.map +1 -0
  271. package/dist/plugin/createImagePlugin.d.ts +46 -0
  272. package/dist/plugin/createImagePlugin.d.ts.map +1 -0
  273. package/dist/plugin/createIsrPlugin.d.ts +43 -0
  274. package/dist/plugin/createIsrPlugin.d.ts.map +1 -0
  275. package/dist/plugin/createSsgPostBuildPlugin.d.ts +4 -0
  276. package/dist/plugin/createSsgPostBuildPlugin.d.ts.map +1 -0
  277. package/dist/plugin/devAssetRequestMiddleware.d.ts +10 -0
  278. package/dist/plugin/devAssetRequestMiddleware.d.ts.map +1 -0
  279. package/dist/plugin/index.d.ts +11 -0
  280. package/dist/plugin/index.d.ts.map +1 -0
  281. package/dist/plugin/isrCacheMiddleware.d.ts +223 -0
  282. package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -0
  283. package/dist/plugin/isrCacheStore.d.ts +88 -0
  284. package/dist/plugin/isrCacheStore.d.ts.map +1 -0
  285. package/dist/plugin/remoteImageSource.d.ts +19 -0
  286. package/dist/plugin/remoteImageSource.d.ts.map +1 -0
  287. package/dist/plugin/transformDevCssModule.d.ts +3 -0
  288. package/dist/plugin/transformDevCssModule.d.ts.map +1 -0
  289. package/dist/renderer/RenderHeaders.d.ts +28 -0
  290. package/dist/renderer/RenderHeaders.d.ts.map +1 -0
  291. package/dist/rolldown-runtime-D7D4PA-g.js +13 -0
  292. package/dist/rolldown-runtime-DakpK96I.cjs +43 -0
  293. package/dist/route/RouteManager.d.ts +22 -0
  294. package/dist/route/RouteManager.d.ts.map +1 -0
  295. package/dist/route/index.d.ts +2 -0
  296. package/dist/route/index.d.ts.map +1 -0
  297. package/dist/rsc/ServerActions.d.ts +65 -0
  298. package/dist/rsc/ServerActions.d.ts.map +1 -0
  299. package/dist/rsc/browser.cjs +109 -0
  300. package/dist/rsc/browser.cjs.map +1 -0
  301. package/dist/rsc/browser.d.ts +59 -0
  302. package/dist/rsc/browser.d.ts.map +1 -0
  303. package/dist/rsc/browser.js +85 -0
  304. package/dist/rsc/browser.js.map +1 -0
  305. package/dist/rsc/cacheTag.d.ts +52 -0
  306. package/dist/rsc/cacheTag.d.ts.map +1 -0
  307. package/dist/rsc/constants.d.ts +10 -0
  308. package/dist/rsc/constants.d.ts.map +1 -0
  309. package/dist/rsc/i18n.d.ts +3 -0
  310. package/dist/rsc/i18n.d.ts.map +1 -0
  311. package/dist/rsc/index.cjs +33 -0
  312. package/dist/rsc/index.d.ts +20 -0
  313. package/dist/rsc/index.d.ts.map +1 -0
  314. package/dist/rsc/index.js +4 -0
  315. package/dist/rsc/revalidate.d.ts +77 -0
  316. package/dist/rsc/revalidate.d.ts.map +1 -0
  317. package/dist/rsc-H7D_meHu.cjs +239 -0
  318. package/dist/rsc-H7D_meHu.cjs.map +1 -0
  319. package/dist/rsc-lvWPTuVD.js +168 -0
  320. package/dist/rsc-lvWPTuVD.js.map +1 -0
  321. package/dist/runtime/Image.d.ts +48 -0
  322. package/dist/runtime/Image.d.ts.map +1 -0
  323. package/dist/runtime/LocaleContext.d.ts +14 -0
  324. package/dist/runtime/LocaleContext.d.ts.map +1 -0
  325. package/dist/runtime/boundary.d.ts +27 -0
  326. package/dist/runtime/boundary.d.ts.map +1 -0
  327. package/dist/runtime/edge-context.d.ts +17 -0
  328. package/dist/runtime/edge-context.d.ts.map +1 -0
  329. package/dist/runtime/i18n-store.d.ts +11 -0
  330. package/dist/runtime/i18n-store.d.ts.map +1 -0
  331. package/dist/runtime/i18n.d.ts +115 -0
  332. package/dist/runtime/i18n.d.ts.map +1 -0
  333. package/dist/runtime/index.d.ts +16 -0
  334. package/dist/runtime/index.d.ts.map +1 -0
  335. package/dist/runtime/routes.d.ts +88 -0
  336. package/dist/runtime/routes.d.ts.map +1 -0
  337. package/dist/runtime/telemetry.d.ts +48 -0
  338. package/dist/runtime/telemetry.d.ts.map +1 -0
  339. package/dist/security/cspNonceTemplate.d.ts +10 -0
  340. package/dist/security/cspNonceTemplate.d.ts.map +1 -0
  341. package/dist/security/staticCspManifest.d.ts +37 -0
  342. package/dist/security/staticCspManifest.d.ts.map +1 -0
  343. package/dist/server/httpServer.d.ts +17 -0
  344. package/dist/server/httpServer.d.ts.map +1 -0
  345. package/dist/server/index.d.ts +3 -0
  346. package/dist/server/index.d.ts.map +1 -0
  347. package/dist/server/manager.d.ts +17 -0
  348. package/dist/server/manager.d.ts.map +1 -0
  349. package/dist/server/middleware.d.ts +87 -0
  350. package/dist/server/middleware.d.ts.map +1 -0
  351. package/dist/server/opsConfig.d.ts +17 -0
  352. package/dist/server/opsConfig.d.ts.map +1 -0
  353. package/dist/server/productionRuntime.d.ts +41 -0
  354. package/dist/server/productionRuntime.d.ts.map +1 -0
  355. package/dist/server/types.d.ts +41 -0
  356. package/dist/server/types.d.ts.map +1 -0
  357. package/dist/server/viteDevServer.d.ts +21 -0
  358. package/dist/server/viteDevServer.d.ts.map +1 -0
  359. package/dist/ssg/spider.d.ts +142 -0
  360. package/dist/ssg/spider.d.ts.map +1 -0
  361. package/dist/types/IFlightData.d.ts +23 -0
  362. package/dist/types/IFlightData.d.ts.map +1 -0
  363. package/dist/types/IHelmetData.d.ts +24 -0
  364. package/dist/types/IHelmetData.d.ts.map +1 -0
  365. package/dist/types/IRenderMetadata.d.ts +46 -0
  366. package/dist/types/IRenderMetadata.d.ts.map +1 -0
  367. package/dist/types/IRenderResult.d.ts +16 -0
  368. package/dist/types/IRenderResult.d.ts.map +1 -0
  369. package/dist/types/ISRConfig.d.ts +463 -0
  370. package/dist/types/ISRConfig.d.ts.map +1 -0
  371. package/dist/types/ISRContext.d.ts +104 -0
  372. package/dist/types/ISRContext.d.ts.map +1 -0
  373. package/dist/types/index.d.ts +7 -0
  374. package/dist/types/index.d.ts.map +1 -0
  375. package/dist/utils/CacheCleanup.d.ts +32 -0
  376. package/dist/utils/CacheCleanup.d.ts.map +1 -0
  377. package/dist/utils/cacheDuration.d.ts +12 -0
  378. package/dist/utils/cacheDuration.d.ts.map +1 -0
  379. package/dist/utils/cookie.d.ts +7 -0
  380. package/dist/utils/cookie.d.ts.map +1 -0
  381. package/dist/utils/hash.d.ts +22 -0
  382. package/dist/utils/hash.d.ts.map +1 -0
  383. package/dist/utils/htmlPathname.d.ts +12 -0
  384. package/dist/utils/htmlPathname.d.ts.map +1 -0
  385. package/dist/utils/index.d.ts +9 -0
  386. package/dist/utils/index.d.ts.map +1 -0
  387. package/dist/utils/resolveFetchHandler.d.ts +4 -0
  388. package/dist/utils/resolveFetchHandler.d.ts.map +1 -0
  389. package/dist/utils/trimTrailingSlashes.d.ts +3 -0
  390. package/dist/utils/trimTrailingSlashes.d.ts.map +1 -0
  391. package/package.json +199 -4
  392. package/src/context/RequestContext.ts +68 -0
  393. package/src/context/createServerRequestContext.ts +104 -0
  394. package/src/defaults/auto-observability.ts +195 -0
  395. package/src/defaults/entry.server.ssr.tsx +257 -0
  396. package/src/defaults/entry.server.tsx +117 -0
  397. package/src/defaults/entry.tsx +23 -0
  398. package/src/defaults/runtime/browserObservability.ts +837 -0
  399. package/src/defaults/runtime/client-navigation-policy.ts +67 -0
  400. package/src/defaults/runtime/createCachedFetcher.ts +121 -0
  401. package/src/defaults/runtime/defineClientEntry.tsx +773 -0
  402. package/src/defaults/runtime/defineServerEntry.tsx +421 -0
  403. package/src/defaults/runtime/defineSiteHooks.ts +1073 -0
  404. package/src/defaults/runtime/dev-css-handoff.client.ts +5 -0
  405. package/src/defaults/runtime/dev-render-inspector.ts +597 -0
  406. package/src/defaults/runtime/dev-rsc-response.client.ts +48 -0
  407. package/src/defaults/runtime/dev-style-commit-boundary.client.tsx +20 -0
  408. package/src/defaults/runtime/dev-style-declarations.server.ts +158 -0
  409. package/src/defaults/runtime/dev-style-id.ts +91 -0
  410. package/src/defaults/runtime/dev-style-navigation.client.ts +152 -0
  411. package/src/defaults/runtime/dev-style-registry.client.ts +744 -0
  412. package/src/defaults/runtime/dev-style-resource-dispatcher.server.ts +41 -0
  413. package/src/defaults/runtime/empty-config.ts +5 -0
  414. package/src/defaults/runtime/empty-routes.ts +2 -0
  415. package/src/defaults/runtime/error-boundary.style.css +35 -0
  416. package/src/defaults/runtime/error-boundary.tsx +65 -0
  417. package/src/defaults/runtime/error500-template.ts +66 -0
  418. package/src/defaults/runtime/head-extras-runtime.ts +64 -0
  419. package/src/defaults/runtime/hydration-shell.tsx +20 -0
  420. package/src/defaults/runtime/i18n-server.ts +27 -0
  421. package/src/defaults/runtime/navigation-history.client.ts +80 -0
  422. package/src/defaults/runtime/navigation-request.client.ts +21 -0
  423. package/src/defaults/runtime/request.tsx +100 -0
  424. package/src/defaults/runtime/seo-runtime.ts +257 -0
  425. package/src/defaults/tsconfig.json +10 -0
  426. package/src/defaults/types.d.ts +23 -0
  427. package/src/runtime/Image.tsx +124 -0
  428. package/src/runtime/LocaleContext.tsx +38 -0
  429. package/src/runtime/boundary.module.css +46 -0
  430. package/src/runtime/boundary.tsx +136 -0
  431. package/src/runtime/edge-context.ts +32 -0
  432. package/src/runtime/i18n-store.ts +76 -0
  433. package/src/runtime/i18n.ts +189 -0
  434. package/src/runtime/index.ts +61 -0
  435. package/src/runtime/routes.tsx +247 -0
  436. package/src/runtime/scss.d.ts +13 -0
  437. package/src/runtime/telemetry.ts +116 -0
  438. package/src/types/IFlightData.ts +27 -0
  439. package/src/types/IHelmetData.ts +9 -0
  440. package/src/types/IRenderMetadata.ts +52 -0
  441. package/src/types/IRenderResult.ts +16 -0
  442. package/src/types/ISRConfig.ts +507 -0
  443. package/src/types/ISRContext.ts +106 -0
  444. package/src/types/index.ts +6 -0
  445. package/src/utils/CacheCleanup.ts +74 -0
  446. package/src/utils/cacheDuration.ts +37 -0
  447. package/src/utils/cookie.ts +59 -0
  448. package/src/utils/hash.ts +32 -0
  449. package/src/utils/htmlPathname.ts +75 -0
  450. package/src/utils/index.ts +9 -0
  451. package/src/utils/resolveFetchHandler.ts +17 -0
  452. package/src/utils/trimTrailingSlashes.ts +6 -0
@@ -0,0 +1,77 @@
1
+ /**
2
+ * 缓存失效契约 —— `revalidatePath(path)` 按路径精准失效;`revalidateTag(tag)` 按渲染期声明的 tag 失效
3
+ *
4
+ * 跨环境状态共享:
5
+ * Server Action 在 Vite 的 `rsc` 环境中执行(模块图 A),
6
+ * 而 ISR 缓存中间件注册 invalidator 在 Node 上下文(模块图 B),
7
+ * 两份模块图下,同名模块可能各自持有独立的 ES 模块状态。
8
+ * 因此本模块把 invalidator 注册表挂在 `globalThis` 上作为跨环境单例,
9
+ * 确保 `revalidatePath/Tag` 调用能分发到所有已注册的 invalidator。
10
+ *
11
+ * 失败语义(v2.0.x 起):
12
+ * 过去版本用 `Promise.all`,**首个失败的 invalidator 会抛出,剩余的可能仍在执行
13
+ * 但 reject 被吞**——多 invalidator 场景下出现"看似成功但部分缓存没清"的脏状态。
14
+ * 现在改为:
15
+ * 1. `Promise.allSettled` 让所有 invalidator 都跑到底
16
+ * 2. 每个失败单独打 metric + log(含 trace 上下文)
17
+ * 3. 整体 ≥ 1 个失败 → 抛聚合 `RevalidationError`(含 successCount/failureCount/causes)
18
+ * 调用方(Server Action)务必 `try { await revalidateTag(...) } catch (e) { ... }`,
19
+ * 否则用户提交后看到的是 200 但底层有部分 cache 未清——这种"沉默错误"比抛错更危险。
20
+ *
21
+ * 用法:
22
+ * 1. Server Action 内部调用 `revalidatePath('/books')` 或 `revalidateTag('books')`
23
+ * 2. ISR cache 中间件 / ISREngine 启动时通过 `registerInvalidator(fn)` 注册
24
+ * 3. 分发到所有注册的 invalidator,清理对应缓存条目
25
+ *
26
+ * 注意:
27
+ * - 本模块不持有任何缓存实现,纯做路由分发
28
+ * - 若未注册 invalidator(例如脱离 engine 的纯 RSC 场景),调用静默为 no-op
29
+ */
30
+ /** Invalidator 签名:接收失效目标描述 */
31
+ export interface RevalidateInvalidator {
32
+ (target: {
33
+ kind: 'path';
34
+ value: string;
35
+ } | {
36
+ kind: 'tag';
37
+ value: string;
38
+ }): Promise<void> | void;
39
+ }
40
+ /**
41
+ * 注册一个 invalidator 实例(通常由 ISR 缓存中间件 / ISREngine 调用)
42
+ * 返回取消注册的函数
43
+ */
44
+ export declare function registerInvalidator(fn: RevalidateInvalidator): () => void;
45
+ /**
46
+ * 聚合失效错误 —— 当一个或多个 invalidator 失败时抛出。
47
+ *
48
+ * 含:
49
+ * - successCount / failureCount:方便调用方决定补偿策略
50
+ * - causes:每个失败的原始 Error(按注册顺序)
51
+ * - target:触发本次 revalidate 的描述('tag:books' / 'path:/books')
52
+ *
53
+ * 注意:用 `extends Error` 而非 `AggregateError`,因为 AggregateError 在某些 Node
54
+ * 版本对 stack/message 序列化不稳,自定义 class 更可控且 instanceof 检测可靠。
55
+ */
56
+ export declare class RevalidationError extends Error {
57
+ readonly target: string;
58
+ readonly successCount: number;
59
+ readonly failureCount: number;
60
+ readonly causes: readonly Error[];
61
+ constructor(target: string, successCount: number, failureCount: number, causes: readonly Error[]);
62
+ }
63
+ /**
64
+ * 使指定路径的缓存失效
65
+ *
66
+ * @param path 形如 '/books' / '/posts/42' 的路径
67
+ * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)
68
+ */
69
+ export declare function revalidatePath(path: string): Promise<void>;
70
+ /**
71
+ * 使指定 tag 标记的所有缓存条目失效
72
+ *
73
+ * @param tag 业务语义 tag(如 'books' / `book:${id}`)
74
+ * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)
75
+ */
76
+ export declare function revalidateTag(tag: string): Promise<void>;
77
+ //# sourceMappingURL=revalidate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"revalidate.d.ts","sourceRoot":"","sources":["../../src/rsc/revalidate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAWH,8BAA8B;AAC9B,MAAM,WAAW,qBAAqB;IACpC,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClG;AAiBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAMzE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;gBAGvC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,SAAS,KAAK,EAAE;CAY3B;AAuDD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D"}
@@ -0,0 +1,239 @@
1
+ const require_RequestContext = require("./RequestContext-DgGEAxcW.cjs");
2
+ const require_abVariantContext = require("./abVariantContext-Cqp-uxtd.cjs");
3
+ let node_async_hooks = require("node:async_hooks");
4
+ //#region src/rsc/ServerActions.ts
5
+ /**
6
+ * Server Actions —— engine 级元数据注册
7
+ *
8
+ * 架构分工(方案 A 后):
9
+ * - 协议传输:`@vitejs/plugin-rsc` 负责 encodeReply/decodeReply、loadServerAction、
10
+ * Server Action 的 POST 路由、multipart 解码、响应 Flight 流等全部协议层工作
11
+ * - 本模块职责:仅做元数据层面的注册表,供 engine 的调试 / 指标 / 管理面板使用
12
+ *
13
+ * 编写注意:
14
+ * - 不重复实现执行/传输/序列化逻辑 —— 全部交给 plugin
15
+ * - `createServerAction` 仅为便利 API:在 registry 中登记元数据,返回原函数
16
+ * (不再伪造 `$$typeof`/`$$id` —— 这些由 plugin 的 transforms 在编译时注入到
17
+ * `'use server'` 声明的模块导出上)
18
+ */
19
+ var logger = require_abVariantContext.Logger.getInstance();
20
+ var ServerActionsRegistry = class {
21
+ metadata = /* @__PURE__ */ new Map();
22
+ initialized = false;
23
+ async initialize() {
24
+ if (this.initialized) return;
25
+ this.initialized = true;
26
+ logger.info("✅ Server Actions Registry 已初始化");
27
+ }
28
+ async cleanup() {
29
+ this.metadata.clear();
30
+ this.initialized = false;
31
+ logger.info("✅ Server Actions Registry 已清理");
32
+ }
33
+ register(id, metadata) {
34
+ this.metadata.set(id, {
35
+ id,
36
+ ...metadata
37
+ });
38
+ return id;
39
+ }
40
+ getAllActions() {
41
+ return Array.from(this.metadata.values());
42
+ }
43
+ hasAction(actionId) {
44
+ return this.metadata.has(actionId);
45
+ }
46
+ getMetadata(actionId) {
47
+ return this.metadata.get(actionId);
48
+ }
49
+ };
50
+ var serverActionsRegistry = new ServerActionsRegistry();
51
+ /**
52
+ * 声明式注册:用于在服务端日志/管理面板中登记一个 action 的元数据
53
+ *
54
+ * 运行时执行请使用 `'use server'` 指令;本函数**不**改变执行语义,仅记录元数据
55
+ */
56
+ function createServerAction(handler, metadata) {
57
+ serverActionsRegistry.register(metadata.id, metadata);
58
+ return handler;
59
+ }
60
+ var ServerActionUtils = {
61
+ isServer() {
62
+ return typeof window === "undefined";
63
+ },
64
+ isClient() {
65
+ return typeof window !== "undefined";
66
+ },
67
+ getExecutionContext() {
68
+ if (this.isServer()) return {
69
+ environment: "server",
70
+ nodeVersion: process.version,
71
+ platform: process.platform,
72
+ cwd: process.cwd()
73
+ };
74
+ return {
75
+ environment: "client",
76
+ userAgent: typeof navigator !== "undefined" ? navigator.userAgent : void 0,
77
+ url: typeof window !== "undefined" ? window.location.href : void 0,
78
+ timestamp: (/* @__PURE__ */ new Date()).toISOString()
79
+ };
80
+ }
81
+ };
82
+ //#endregion
83
+ //#region src/rsc/constants.ts
84
+ /**
85
+ * RSC / Flight 协议相关常量
86
+ */
87
+ var SERVER_ACTION_ENDPOINT = "/_rsc/action";
88
+ var LEGACY_SERVER_ACTION_ENDPOINT = "/api/server-actions";
89
+ function getServerActionEndpointCandidates(primaryEndpoint) {
90
+ const candidates = /* @__PURE__ */ new Set();
91
+ const endpoint = primaryEndpoint || "/_rsc/action";
92
+ candidates.add(endpoint);
93
+ candidates.add(SERVER_ACTION_ENDPOINT);
94
+ candidates.add(LEGACY_SERVER_ACTION_ENDPOINT);
95
+ return Array.from(candidates);
96
+ }
97
+ function isLegacyServerActionEndpoint(endpoint) {
98
+ return endpoint === LEGACY_SERVER_ACTION_ENDPOINT;
99
+ }
100
+ function shouldSkipServerActionEndpointRetry(endpoint) {
101
+ return isLegacyServerActionEndpoint(endpoint);
102
+ }
103
+ //#endregion
104
+ //#region src/runtime/i18n-store.ts
105
+ var I18N_RUNTIME_STATE_KEY = "__ISR_ENGINE_I18N_RUNTIME_STATE__";
106
+ var runtimeState = getRuntimeState();
107
+ function registerServerI18nReader(reader) {
108
+ runtimeState.serverReader = reader;
109
+ }
110
+ function getCurrentI18n$1() {
111
+ return runtimeState.serverReader?.() ?? runtimeState.clientIntl;
112
+ }
113
+ function getI18nLocale(fallback = "") {
114
+ return getCurrentI18n$1()?.locale ?? fallback;
115
+ }
116
+ var getI18n = (key, params, fallback = key) => {
117
+ const value = readPath(getCurrentI18n$1()?.messages, key);
118
+ return interpolate(typeof value === "string" && value.trim() ? value : fallback, params);
119
+ };
120
+ function readPath(source, key) {
121
+ let path = runtimeState.keyPathCache.get(key);
122
+ if (!path) {
123
+ path = key.split(".");
124
+ runtimeState.keyPathCache.set(key, path);
125
+ }
126
+ let cur = source;
127
+ for (const part of path) {
128
+ if (!cur || typeof cur !== "object" || !(part in cur)) return void 0;
129
+ cur = cur[part];
130
+ }
131
+ return cur;
132
+ }
133
+ function getRuntimeState() {
134
+ const globalState = globalThis;
135
+ globalState[I18N_RUNTIME_STATE_KEY] ??= {
136
+ clientIntl: null,
137
+ serverReader: null,
138
+ keyPathCache: /* @__PURE__ */ new Map()
139
+ };
140
+ return globalState[I18N_RUNTIME_STATE_KEY];
141
+ }
142
+ function interpolate(message, params) {
143
+ if (!params) return message;
144
+ return message.replace(/\{(\w+)\}/g, (match, name) => {
145
+ const value = params[name];
146
+ return value === void 0 || value === null ? match : String(value);
147
+ });
148
+ }
149
+ //#endregion
150
+ //#region src/defaults/runtime/i18n-server.ts
151
+ var store = new node_async_hooks.AsyncLocalStorage();
152
+ function runWithI18n(intl, fn) {
153
+ return store.run(intl ?? null, fn);
154
+ }
155
+ function getCurrentI18n() {
156
+ const scoped = store.getStore();
157
+ if (scoped) return scoped;
158
+ const requestIntl = require_RequestContext.getRequestContext()?.intl;
159
+ return isIntlPayload(requestIntl) ? requestIntl : null;
160
+ }
161
+ registerServerI18nReader(getCurrentI18n);
162
+ function isIntlPayload(value) {
163
+ return !!value && typeof value === "object" && typeof value.locale === "string";
164
+ }
165
+ //#endregion
166
+ Object.defineProperty(exports, "LEGACY_SERVER_ACTION_ENDPOINT", {
167
+ enumerable: true,
168
+ get: function() {
169
+ return LEGACY_SERVER_ACTION_ENDPOINT;
170
+ }
171
+ });
172
+ Object.defineProperty(exports, "SERVER_ACTION_ENDPOINT", {
173
+ enumerable: true,
174
+ get: function() {
175
+ return SERVER_ACTION_ENDPOINT;
176
+ }
177
+ });
178
+ Object.defineProperty(exports, "ServerActionUtils", {
179
+ enumerable: true,
180
+ get: function() {
181
+ return ServerActionUtils;
182
+ }
183
+ });
184
+ Object.defineProperty(exports, "createServerAction", {
185
+ enumerable: true,
186
+ get: function() {
187
+ return createServerAction;
188
+ }
189
+ });
190
+ Object.defineProperty(exports, "getCurrentI18n", {
191
+ enumerable: true,
192
+ get: function() {
193
+ return getCurrentI18n;
194
+ }
195
+ });
196
+ Object.defineProperty(exports, "getI18n", {
197
+ enumerable: true,
198
+ get: function() {
199
+ return getI18n;
200
+ }
201
+ });
202
+ Object.defineProperty(exports, "getI18nLocale", {
203
+ enumerable: true,
204
+ get: function() {
205
+ return getI18nLocale;
206
+ }
207
+ });
208
+ Object.defineProperty(exports, "getServerActionEndpointCandidates", {
209
+ enumerable: true,
210
+ get: function() {
211
+ return getServerActionEndpointCandidates;
212
+ }
213
+ });
214
+ Object.defineProperty(exports, "isLegacyServerActionEndpoint", {
215
+ enumerable: true,
216
+ get: function() {
217
+ return isLegacyServerActionEndpoint;
218
+ }
219
+ });
220
+ Object.defineProperty(exports, "runWithI18n", {
221
+ enumerable: true,
222
+ get: function() {
223
+ return runWithI18n;
224
+ }
225
+ });
226
+ Object.defineProperty(exports, "serverActionsRegistry", {
227
+ enumerable: true,
228
+ get: function() {
229
+ return serverActionsRegistry;
230
+ }
231
+ });
232
+ Object.defineProperty(exports, "shouldSkipServerActionEndpointRetry", {
233
+ enumerable: true,
234
+ get: function() {
235
+ return shouldSkipServerActionEndpointRetry;
236
+ }
237
+ });
238
+
239
+ //# sourceMappingURL=rsc-H7D_meHu.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rsc-H7D_meHu.cjs","names":[],"sources":["../src/rsc/ServerActions.ts","../src/rsc/constants.ts","../src/runtime/i18n-store.ts","../src/defaults/runtime/i18n-server.ts"],"sourcesContent":["/**\n * Server Actions —— engine 级元数据注册\n *\n * 架构分工(方案 A 后):\n * - 协议传输:`@vitejs/plugin-rsc` 负责 encodeReply/decodeReply、loadServerAction、\n * Server Action 的 POST 路由、multipart 解码、响应 Flight 流等全部协议层工作\n * - 本模块职责:仅做元数据层面的注册表,供 engine 的调试 / 指标 / 管理面板使用\n *\n * 编写注意:\n * - 不重复实现执行/传输/序列化逻辑 —— 全部交给 plugin\n * - `createServerAction` 仅为便利 API:在 registry 中登记元数据,返回原函数\n * (不再伪造 `$$typeof`/`$$id` —— 这些由 plugin 的 transforms 在编译时注入到\n * `'use server'` 声明的模块导出上)\n */\n\nimport { Logger } from '../logger/Logger';\n\nconst logger = Logger.getInstance();\n\nexport interface ServerActionMetadata {\n /** Action ID(应与 plugin 生成的 reference id 保持一致;自行注册时由调用方提供) */\n id: string;\n name: string;\n module?: string;\n line?: number;\n file?: string;\n}\n\nexport type ServerActionHandler = (...args: unknown[]) => Promise<unknown> | unknown;\n\nclass ServerActionsRegistry {\n private readonly metadata = new Map<string, ServerActionMetadata>();\n private initialized = false;\n\n async initialize(): Promise<void> {\n if (this.initialized) return;\n this.initialized = true;\n logger.info('✅ Server Actions Registry 已初始化');\n }\n\n async cleanup(): Promise<void> {\n this.metadata.clear();\n this.initialized = false;\n logger.info('✅ Server Actions Registry 已清理');\n }\n\n register(id: string, metadata: Omit<ServerActionMetadata, 'id'>): string {\n this.metadata.set(id, { id, ...metadata });\n return id;\n }\n\n getAllActions(): ServerActionMetadata[] {\n return Array.from(this.metadata.values());\n }\n\n hasAction(actionId: string): boolean {\n return this.metadata.has(actionId);\n }\n\n getMetadata(actionId: string): ServerActionMetadata | undefined {\n return this.metadata.get(actionId);\n }\n}\n\nexport const serverActionsRegistry = new ServerActionsRegistry();\n\n/**\n * 声明式注册:用于在服务端日志/管理面板中登记一个 action 的元数据\n *\n * 运行时执行请使用 `'use server'` 指令;本函数**不**改变执行语义,仅记录元数据\n */\nexport function createServerAction<T extends ServerActionHandler>(\n handler: T,\n metadata: Omit<ServerActionMetadata, 'id'> & { id: string }\n): T {\n serverActionsRegistry.register(metadata.id, metadata);\n return handler;\n}\n\nexport const ServerActionUtils = {\n isServer(): boolean {\n return typeof window === 'undefined';\n },\n isClient(): boolean {\n return typeof window !== 'undefined';\n },\n getExecutionContext() {\n if (this.isServer()) {\n return {\n environment: 'server' as const,\n nodeVersion: process.version,\n platform: process.platform,\n cwd: process.cwd(),\n };\n }\n return {\n environment: 'client' as const,\n userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,\n url: typeof window !== 'undefined' ? window.location.href : undefined,\n timestamp: new Date().toISOString(),\n };\n },\n};\n","/**\n * RSC / Flight 协议相关常量\n */\n\nexport const SERVER_ACTION_ENDPOINT = '/_rsc/action';\nexport const LEGACY_SERVER_ACTION_ENDPOINT = '/api/server-actions';\nexport const SERVER_ACTION_ENDPOINTS = [SERVER_ACTION_ENDPOINT, LEGACY_SERVER_ACTION_ENDPOINT];\n\nexport function getServerActionEndpointCandidates(primaryEndpoint?: string): string[] {\n const candidates = new Set<string>();\n const endpoint = primaryEndpoint || SERVER_ACTION_ENDPOINT;\n\n candidates.add(endpoint);\n candidates.add(SERVER_ACTION_ENDPOINT);\n candidates.add(LEGACY_SERVER_ACTION_ENDPOINT);\n\n return Array.from(candidates);\n}\n\nexport function isLegacyServerActionEndpoint(endpoint: string): boolean {\n return endpoint === LEGACY_SERVER_ACTION_ENDPOINT;\n}\n\nexport function shouldSkipServerActionEndpointRetry(endpoint: string): boolean {\n return isLegacyServerActionEndpoint(endpoint);\n}\n","import type { IntlPayload } from '../defaults/runtime/seo-runtime';\n\nexport type I18nParams = Record<string, string | number | boolean | null | undefined>;\n\nexport type Translate = (key: string, params?: I18nParams, fallback?: string) => string;\n\ntype ServerReader = () => IntlPayload | null | undefined;\n\ninterface I18nRuntimeState {\n clientIntl: IntlPayload | null;\n serverReader: ServerReader | null;\n keyPathCache: Map<string, string[]>;\n}\n\nconst I18N_RUNTIME_STATE_KEY = '__ISR_ENGINE_I18N_RUNTIME_STATE__';\n\nconst runtimeState = getRuntimeState();\n\nexport function setClientI18n(intl: IntlPayload | null | undefined): void {\n runtimeState.clientIntl = intl ?? null;\n}\n\nexport function registerServerI18nReader(reader: ServerReader): void {\n runtimeState.serverReader = reader;\n}\n\nexport function getCurrentI18n(): IntlPayload | null {\n return runtimeState.serverReader?.() ?? runtimeState.clientIntl;\n}\n\nexport function getI18nLocale(fallback = ''): string {\n return getCurrentI18n()?.locale ?? fallback;\n}\n\nexport const getI18n: Translate = (key, params, fallback = key) => {\n const value = readPath(getCurrentI18n()?.messages, key);\n const message = typeof value === 'string' && value.trim() ? value : fallback;\n return interpolate(message, params);\n};\n\nfunction readPath(source: unknown, key: string): unknown {\n let path = runtimeState.keyPathCache.get(key);\n if (!path) {\n path = key.split('.');\n runtimeState.keyPathCache.set(key, path);\n }\n\n let cur = source;\n for (const part of path) {\n if (!cur || typeof cur !== 'object' || !(part in cur)) return undefined;\n cur = (cur as Record<string, unknown>)[part];\n }\n return cur;\n}\n\nfunction getRuntimeState(): I18nRuntimeState {\n const globalState = globalThis as typeof globalThis & {\n [I18N_RUNTIME_STATE_KEY]?: I18nRuntimeState;\n };\n\n globalState[I18N_RUNTIME_STATE_KEY] ??= {\n clientIntl: null,\n serverReader: null,\n keyPathCache: new Map<string, string[]>(),\n };\n\n return globalState[I18N_RUNTIME_STATE_KEY];\n}\n\nfunction interpolate(message: string, params?: I18nParams): string {\n if (!params) return message;\n return message.replace(/\\{(\\w+)\\}/g, (match, name) => {\n const value = params[name];\n return value === undefined || value === null ? match : String(value);\n });\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\n\nimport type { IntlPayload } from './seo-runtime';\nimport { getI18n, getI18nLocale, registerServerI18nReader } from '../../runtime/i18n-store';\nimport { getRequestContext } from '../../context/RequestContext';\n\nconst store = new AsyncLocalStorage<IntlPayload | null>();\n\nexport function runWithI18n<T>(intl: IntlPayload | null | undefined, fn: () => T): T {\n return store.run(intl ?? null, fn);\n}\n\nexport function getCurrentI18n(): IntlPayload | null {\n const scoped = store.getStore();\n if (scoped) return scoped;\n const requestIntl = getRequestContext()?.intl;\n return isIntlPayload(requestIntl) ? requestIntl : null;\n}\n\nregisterServerI18nReader(getCurrentI18n);\n\nexport { getI18n, getI18nLocale };\nexport type { I18nParams, Translate } from '../../runtime/i18n-store';\n\nfunction isIntlPayload(value: unknown): value is IntlPayload {\n return !!value && typeof value === 'object' && typeof (value as IntlPayload).locale === 'string';\n}\n"],"mappings":"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"}
@@ -0,0 +1,168 @@
1
+ import { i as getRequestContext } from "./RequestContext-BVQ-rOmV.js";
2
+ import { x as Logger } from "./abVariantContext-CWCdRSdG.js";
3
+ import { AsyncLocalStorage } from "node:async_hooks";
4
+ //#region src/rsc/ServerActions.ts
5
+ /**
6
+ * Server Actions —— engine 级元数据注册
7
+ *
8
+ * 架构分工(方案 A 后):
9
+ * - 协议传输:`@vitejs/plugin-rsc` 负责 encodeReply/decodeReply、loadServerAction、
10
+ * Server Action 的 POST 路由、multipart 解码、响应 Flight 流等全部协议层工作
11
+ * - 本模块职责:仅做元数据层面的注册表,供 engine 的调试 / 指标 / 管理面板使用
12
+ *
13
+ * 编写注意:
14
+ * - 不重复实现执行/传输/序列化逻辑 —— 全部交给 plugin
15
+ * - `createServerAction` 仅为便利 API:在 registry 中登记元数据,返回原函数
16
+ * (不再伪造 `$$typeof`/`$$id` —— 这些由 plugin 的 transforms 在编译时注入到
17
+ * `'use server'` 声明的模块导出上)
18
+ */
19
+ var logger = Logger.getInstance();
20
+ var ServerActionsRegistry = class {
21
+ metadata = /* @__PURE__ */ new Map();
22
+ initialized = false;
23
+ async initialize() {
24
+ if (this.initialized) return;
25
+ this.initialized = true;
26
+ logger.info("✅ Server Actions Registry 已初始化");
27
+ }
28
+ async cleanup() {
29
+ this.metadata.clear();
30
+ this.initialized = false;
31
+ logger.info("✅ Server Actions Registry 已清理");
32
+ }
33
+ register(id, metadata) {
34
+ this.metadata.set(id, {
35
+ id,
36
+ ...metadata
37
+ });
38
+ return id;
39
+ }
40
+ getAllActions() {
41
+ return Array.from(this.metadata.values());
42
+ }
43
+ hasAction(actionId) {
44
+ return this.metadata.has(actionId);
45
+ }
46
+ getMetadata(actionId) {
47
+ return this.metadata.get(actionId);
48
+ }
49
+ };
50
+ var serverActionsRegistry = new ServerActionsRegistry();
51
+ /**
52
+ * 声明式注册:用于在服务端日志/管理面板中登记一个 action 的元数据
53
+ *
54
+ * 运行时执行请使用 `'use server'` 指令;本函数**不**改变执行语义,仅记录元数据
55
+ */
56
+ function createServerAction(handler, metadata) {
57
+ serverActionsRegistry.register(metadata.id, metadata);
58
+ return handler;
59
+ }
60
+ var ServerActionUtils = {
61
+ isServer() {
62
+ return typeof window === "undefined";
63
+ },
64
+ isClient() {
65
+ return typeof window !== "undefined";
66
+ },
67
+ getExecutionContext() {
68
+ if (this.isServer()) return {
69
+ environment: "server",
70
+ nodeVersion: process.version,
71
+ platform: process.platform,
72
+ cwd: process.cwd()
73
+ };
74
+ return {
75
+ environment: "client",
76
+ userAgent: typeof navigator !== "undefined" ? navigator.userAgent : void 0,
77
+ url: typeof window !== "undefined" ? window.location.href : void 0,
78
+ timestamp: (/* @__PURE__ */ new Date()).toISOString()
79
+ };
80
+ }
81
+ };
82
+ //#endregion
83
+ //#region src/rsc/constants.ts
84
+ /**
85
+ * RSC / Flight 协议相关常量
86
+ */
87
+ var SERVER_ACTION_ENDPOINT = "/_rsc/action";
88
+ var LEGACY_SERVER_ACTION_ENDPOINT = "/api/server-actions";
89
+ function getServerActionEndpointCandidates(primaryEndpoint) {
90
+ const candidates = /* @__PURE__ */ new Set();
91
+ const endpoint = primaryEndpoint || "/_rsc/action";
92
+ candidates.add(endpoint);
93
+ candidates.add(SERVER_ACTION_ENDPOINT);
94
+ candidates.add(LEGACY_SERVER_ACTION_ENDPOINT);
95
+ return Array.from(candidates);
96
+ }
97
+ function isLegacyServerActionEndpoint(endpoint) {
98
+ return endpoint === LEGACY_SERVER_ACTION_ENDPOINT;
99
+ }
100
+ function shouldSkipServerActionEndpointRetry(endpoint) {
101
+ return isLegacyServerActionEndpoint(endpoint);
102
+ }
103
+ //#endregion
104
+ //#region src/runtime/i18n-store.ts
105
+ var I18N_RUNTIME_STATE_KEY = "__ISR_ENGINE_I18N_RUNTIME_STATE__";
106
+ var runtimeState = getRuntimeState();
107
+ function registerServerI18nReader(reader) {
108
+ runtimeState.serverReader = reader;
109
+ }
110
+ function getCurrentI18n$1() {
111
+ return runtimeState.serverReader?.() ?? runtimeState.clientIntl;
112
+ }
113
+ function getI18nLocale(fallback = "") {
114
+ return getCurrentI18n$1()?.locale ?? fallback;
115
+ }
116
+ var getI18n = (key, params, fallback = key) => {
117
+ const value = readPath(getCurrentI18n$1()?.messages, key);
118
+ return interpolate(typeof value === "string" && value.trim() ? value : fallback, params);
119
+ };
120
+ function readPath(source, key) {
121
+ let path = runtimeState.keyPathCache.get(key);
122
+ if (!path) {
123
+ path = key.split(".");
124
+ runtimeState.keyPathCache.set(key, path);
125
+ }
126
+ let cur = source;
127
+ for (const part of path) {
128
+ if (!cur || typeof cur !== "object" || !(part in cur)) return void 0;
129
+ cur = cur[part];
130
+ }
131
+ return cur;
132
+ }
133
+ function getRuntimeState() {
134
+ const globalState = globalThis;
135
+ globalState[I18N_RUNTIME_STATE_KEY] ??= {
136
+ clientIntl: null,
137
+ serverReader: null,
138
+ keyPathCache: /* @__PURE__ */ new Map()
139
+ };
140
+ return globalState[I18N_RUNTIME_STATE_KEY];
141
+ }
142
+ function interpolate(message, params) {
143
+ if (!params) return message;
144
+ return message.replace(/\{(\w+)\}/g, (match, name) => {
145
+ const value = params[name];
146
+ return value === void 0 || value === null ? match : String(value);
147
+ });
148
+ }
149
+ //#endregion
150
+ //#region src/defaults/runtime/i18n-server.ts
151
+ var store = new AsyncLocalStorage();
152
+ function runWithI18n(intl, fn) {
153
+ return store.run(intl ?? null, fn);
154
+ }
155
+ function getCurrentI18n() {
156
+ const scoped = store.getStore();
157
+ if (scoped) return scoped;
158
+ const requestIntl = getRequestContext()?.intl;
159
+ return isIntlPayload(requestIntl) ? requestIntl : null;
160
+ }
161
+ registerServerI18nReader(getCurrentI18n);
162
+ function isIntlPayload(value) {
163
+ return !!value && typeof value === "object" && typeof value.locale === "string";
164
+ }
165
+ //#endregion
166
+ export { LEGACY_SERVER_ACTION_ENDPOINT as a, isLegacyServerActionEndpoint as c, createServerAction as d, serverActionsRegistry as f, getI18nLocale as i, shouldSkipServerActionEndpointRetry as l, runWithI18n as n, SERVER_ACTION_ENDPOINT as o, getI18n as r, getServerActionEndpointCandidates as s, getCurrentI18n as t, ServerActionUtils as u };
167
+
168
+ //# sourceMappingURL=rsc-lvWPTuVD.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rsc-lvWPTuVD.js","names":[],"sources":["../src/rsc/ServerActions.ts","../src/rsc/constants.ts","../src/runtime/i18n-store.ts","../src/defaults/runtime/i18n-server.ts"],"sourcesContent":["/**\n * Server Actions —— engine 级元数据注册\n *\n * 架构分工(方案 A 后):\n * - 协议传输:`@vitejs/plugin-rsc` 负责 encodeReply/decodeReply、loadServerAction、\n * Server Action 的 POST 路由、multipart 解码、响应 Flight 流等全部协议层工作\n * - 本模块职责:仅做元数据层面的注册表,供 engine 的调试 / 指标 / 管理面板使用\n *\n * 编写注意:\n * - 不重复实现执行/传输/序列化逻辑 —— 全部交给 plugin\n * - `createServerAction` 仅为便利 API:在 registry 中登记元数据,返回原函数\n * (不再伪造 `$$typeof`/`$$id` —— 这些由 plugin 的 transforms 在编译时注入到\n * `'use server'` 声明的模块导出上)\n */\n\nimport { Logger } from '../logger/Logger';\n\nconst logger = Logger.getInstance();\n\nexport interface ServerActionMetadata {\n /** Action ID(应与 plugin 生成的 reference id 保持一致;自行注册时由调用方提供) */\n id: string;\n name: string;\n module?: string;\n line?: number;\n file?: string;\n}\n\nexport type ServerActionHandler = (...args: unknown[]) => Promise<unknown> | unknown;\n\nclass ServerActionsRegistry {\n private readonly metadata = new Map<string, ServerActionMetadata>();\n private initialized = false;\n\n async initialize(): Promise<void> {\n if (this.initialized) return;\n this.initialized = true;\n logger.info('✅ Server Actions Registry 已初始化');\n }\n\n async cleanup(): Promise<void> {\n this.metadata.clear();\n this.initialized = false;\n logger.info('✅ Server Actions Registry 已清理');\n }\n\n register(id: string, metadata: Omit<ServerActionMetadata, 'id'>): string {\n this.metadata.set(id, { id, ...metadata });\n return id;\n }\n\n getAllActions(): ServerActionMetadata[] {\n return Array.from(this.metadata.values());\n }\n\n hasAction(actionId: string): boolean {\n return this.metadata.has(actionId);\n }\n\n getMetadata(actionId: string): ServerActionMetadata | undefined {\n return this.metadata.get(actionId);\n }\n}\n\nexport const serverActionsRegistry = new ServerActionsRegistry();\n\n/**\n * 声明式注册:用于在服务端日志/管理面板中登记一个 action 的元数据\n *\n * 运行时执行请使用 `'use server'` 指令;本函数**不**改变执行语义,仅记录元数据\n */\nexport function createServerAction<T extends ServerActionHandler>(\n handler: T,\n metadata: Omit<ServerActionMetadata, 'id'> & { id: string }\n): T {\n serverActionsRegistry.register(metadata.id, metadata);\n return handler;\n}\n\nexport const ServerActionUtils = {\n isServer(): boolean {\n return typeof window === 'undefined';\n },\n isClient(): boolean {\n return typeof window !== 'undefined';\n },\n getExecutionContext() {\n if (this.isServer()) {\n return {\n environment: 'server' as const,\n nodeVersion: process.version,\n platform: process.platform,\n cwd: process.cwd(),\n };\n }\n return {\n environment: 'client' as const,\n userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,\n url: typeof window !== 'undefined' ? window.location.href : undefined,\n timestamp: new Date().toISOString(),\n };\n },\n};\n","/**\n * RSC / Flight 协议相关常量\n */\n\nexport const SERVER_ACTION_ENDPOINT = '/_rsc/action';\nexport const LEGACY_SERVER_ACTION_ENDPOINT = '/api/server-actions';\nexport const SERVER_ACTION_ENDPOINTS = [SERVER_ACTION_ENDPOINT, LEGACY_SERVER_ACTION_ENDPOINT];\n\nexport function getServerActionEndpointCandidates(primaryEndpoint?: string): string[] {\n const candidates = new Set<string>();\n const endpoint = primaryEndpoint || SERVER_ACTION_ENDPOINT;\n\n candidates.add(endpoint);\n candidates.add(SERVER_ACTION_ENDPOINT);\n candidates.add(LEGACY_SERVER_ACTION_ENDPOINT);\n\n return Array.from(candidates);\n}\n\nexport function isLegacyServerActionEndpoint(endpoint: string): boolean {\n return endpoint === LEGACY_SERVER_ACTION_ENDPOINT;\n}\n\nexport function shouldSkipServerActionEndpointRetry(endpoint: string): boolean {\n return isLegacyServerActionEndpoint(endpoint);\n}\n","import type { IntlPayload } from '../defaults/runtime/seo-runtime';\n\nexport type I18nParams = Record<string, string | number | boolean | null | undefined>;\n\nexport type Translate = (key: string, params?: I18nParams, fallback?: string) => string;\n\ntype ServerReader = () => IntlPayload | null | undefined;\n\ninterface I18nRuntimeState {\n clientIntl: IntlPayload | null;\n serverReader: ServerReader | null;\n keyPathCache: Map<string, string[]>;\n}\n\nconst I18N_RUNTIME_STATE_KEY = '__ISR_ENGINE_I18N_RUNTIME_STATE__';\n\nconst runtimeState = getRuntimeState();\n\nexport function setClientI18n(intl: IntlPayload | null | undefined): void {\n runtimeState.clientIntl = intl ?? null;\n}\n\nexport function registerServerI18nReader(reader: ServerReader): void {\n runtimeState.serverReader = reader;\n}\n\nexport function getCurrentI18n(): IntlPayload | null {\n return runtimeState.serverReader?.() ?? runtimeState.clientIntl;\n}\n\nexport function getI18nLocale(fallback = ''): string {\n return getCurrentI18n()?.locale ?? fallback;\n}\n\nexport const getI18n: Translate = (key, params, fallback = key) => {\n const value = readPath(getCurrentI18n()?.messages, key);\n const message = typeof value === 'string' && value.trim() ? value : fallback;\n return interpolate(message, params);\n};\n\nfunction readPath(source: unknown, key: string): unknown {\n let path = runtimeState.keyPathCache.get(key);\n if (!path) {\n path = key.split('.');\n runtimeState.keyPathCache.set(key, path);\n }\n\n let cur = source;\n for (const part of path) {\n if (!cur || typeof cur !== 'object' || !(part in cur)) return undefined;\n cur = (cur as Record<string, unknown>)[part];\n }\n return cur;\n}\n\nfunction getRuntimeState(): I18nRuntimeState {\n const globalState = globalThis as typeof globalThis & {\n [I18N_RUNTIME_STATE_KEY]?: I18nRuntimeState;\n };\n\n globalState[I18N_RUNTIME_STATE_KEY] ??= {\n clientIntl: null,\n serverReader: null,\n keyPathCache: new Map<string, string[]>(),\n };\n\n return globalState[I18N_RUNTIME_STATE_KEY];\n}\n\nfunction interpolate(message: string, params?: I18nParams): string {\n if (!params) return message;\n return message.replace(/\\{(\\w+)\\}/g, (match, name) => {\n const value = params[name];\n return value === undefined || value === null ? match : String(value);\n });\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\n\nimport type { IntlPayload } from './seo-runtime';\nimport { getI18n, getI18nLocale, registerServerI18nReader } from '../../runtime/i18n-store';\nimport { getRequestContext } from '../../context/RequestContext';\n\nconst store = new AsyncLocalStorage<IntlPayload | null>();\n\nexport function runWithI18n<T>(intl: IntlPayload | null | undefined, fn: () => T): T {\n return store.run(intl ?? null, fn);\n}\n\nexport function getCurrentI18n(): IntlPayload | null {\n const scoped = store.getStore();\n if (scoped) return scoped;\n const requestIntl = getRequestContext()?.intl;\n return isIntlPayload(requestIntl) ? requestIntl : null;\n}\n\nregisterServerI18nReader(getCurrentI18n);\n\nexport { getI18n, getI18nLocale };\nexport type { I18nParams, Translate } from '../../runtime/i18n-store';\n\nfunction isIntlPayload(value: unknown): value is IntlPayload {\n return !!value && typeof value === 'object' && typeof (value as IntlPayload).locale === 'string';\n}\n"],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * <Image> —— next/image 对标的图片组件,自动处理 LCP / CLS / 多分辨率。
3
+ *
4
+ * 用法:
5
+ * import { Image } from 'isr-engine/image';
6
+ *
7
+ * // 内部资产(走 /_/img sharp 优化端点)
8
+ * <Image src="/covers/book-1.jpg" width={800} height={600} alt="..." />
9
+ *
10
+ * // 外部 URL(picsum / CDN / S3 等)—— 自动 passthrough,不走 /_/img
11
+ * <Image src="https://picsum.photos/300/400" width={300} height={400} alt="..." />
12
+ *
13
+ * // LCP 候选(above-fold 首屏关键图)
14
+ * <Image src="..." width={300} height={400} alt="..." priority />
15
+ *
16
+ * 自动行为:
17
+ * 1. 内部 src 走 /_/img endpoint + srcset 多分辨率(1x / 2x);
18
+ * 外部 URL、data:image 和 blob URL 原样输出。
19
+ * 2. 默认 loading="lazy" + decoding="async";priority=true 切 eager + fetchPriority=high。
20
+ * 3. priority=true 时通过 React 19 metadata hoisting 自动注入
21
+ * <link rel="preload" as="image">,浏览器 HTML 解析期立即发起加载,
22
+ * 砍掉 LCP 的 "resource load delay" 区间。
23
+ * 4. 强制 width/height 防 CLS(next/image 经验:忘了写就 layout shift)。
24
+ */
25
+ import * as React from 'react';
26
+ export interface ImageProps {
27
+ src: string;
28
+ alt: string;
29
+ width: number;
30
+ height?: number;
31
+ /** 端点路径,需与 createImagePlugin({ path }) 一致;默认 '/_/img'。仅对内部 src 生效 */
32
+ endpoint?: string;
33
+ /** 质量 1-100;仅对内部 src 生效(外部 URL 无优化能力) */
34
+ quality?: number;
35
+ /** 显式通过安全图片端点读取原图(无需 sharp);不能与 quality / format 合用。 */
36
+ unoptimized?: boolean;
37
+ /** 强制格式;仅对内部 src 生效 */
38
+ format?: 'avif' | 'webp' | 'jpeg' | 'png';
39
+ /** LCP 候选图设为 true:禁 lazy + fetchPriority=high + 自动 <link rel="preload"> */
40
+ priority?: boolean;
41
+ /** 设备像素密度数组,默认 [1, 2](覆盖 retina);仅对内部 src 生效 */
42
+ densities?: number[];
43
+ className?: string;
44
+ style?: React.CSSProperties;
45
+ sizes?: string;
46
+ }
47
+ export declare function Image(props: ImageProps): React.ReactElement;
48
+ //# sourceMappingURL=Image.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Image.d.ts","sourceRoot":"","sources":["../../src/runtime/Image.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAeD,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAAC,YAAY,CA8D3D"}
@@ -0,0 +1,14 @@
1
+ import * as React from 'react';
2
+ import type { I18nConfig } from './i18n';
3
+ interface LocaleContextValue {
4
+ locale: string;
5
+ config: I18nConfig;
6
+ }
7
+ export declare function LocaleProvider({ locale, config, children, }: {
8
+ locale: string;
9
+ config: I18nConfig;
10
+ children: React.ReactNode;
11
+ }): import("react/jsx-runtime").JSX.Element;
12
+ export declare function useLocale(): LocaleContextValue;
13
+ export {};
14
+ //# sourceMappingURL=LocaleContext.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LocaleContext.d.ts","sourceRoot":"","sources":["../../src/runtime/LocaleContext.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;CACpB;AAID,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,2CAGA;AAED,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C"}
@@ -0,0 +1,27 @@
1
+ import * as React from 'react';
2
+ interface BoundaryProps {
3
+ /** Suspense fallback —— 子组件 await 数据时显示 */
4
+ loading?: React.ReactNode;
5
+ /**
6
+ * 错误边界 fallback —— 子组件抛错时显示。
7
+ * 必须是 ReactElement(不能是 function,因 RSC 不能跨边界序列化函数)。
8
+ * Boundary 内部会用 cloneElement 注入 `{ error, reset }` —— 'use client' 错误组件可接收这些 props。
9
+ */
10
+ error?: React.ReactElement;
11
+ /** onError 钩子(上报到 Sentry / Datadog) */
12
+ onError?: (error: Error, info: React.ErrorInfo) => void;
13
+ children: React.ReactNode;
14
+ }
15
+ /**
16
+ * 一站式 Boundary —— 同时套 ErrorBoundary + Suspense
17
+ * 业务最常用的形式:用 1 个组件框住有数据获取/有副作用的子树
18
+ */
19
+ export declare function Boundary({ loading, error, onError, children }: BoundaryProps): import("react/jsx-runtime").JSX.Element;
20
+ /** 仅错误边界(不需要 Suspense 时用)*/
21
+ export declare function ErrorBoundary({ fallback, onError, children, }: {
22
+ fallback?: React.ReactElement;
23
+ onError?: (error: Error, info: React.ErrorInfo) => void;
24
+ children: React.ReactNode;
25
+ }): import("react/jsx-runtime").JSX.Element;
26
+ export {};
27
+ //# sourceMappingURL=boundary.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../src/runtime/boundary.tsx"],"names":[],"mappings":"AAiCA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,UAAU,aAAa;IACrB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC;IAC3B,uCAAuC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IACxD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AA4DD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,aAAa,2CAM5E;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,OAAO,EACP,QAAQ,GACT,EAAE;IACD,QAAQ,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IACxD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,2CAMA"}
@@ -0,0 +1,17 @@
1
+ /** Platform bindings and background-task scheduling for one exact Request object. */
2
+ export interface EdgeContext<Env extends object = Record<string, unknown>> {
3
+ readonly env: Env;
4
+ readonly waitUntil: (promise: Promise<unknown>) => void;
5
+ }
6
+ /** @internal Adapters bind the incoming request before invoking application code. */
7
+ export declare function bindEdgeContext(request: Request, context: EdgeContext<object>): void;
8
+ /**
9
+ * Get platform context for the exact Request received by the handler.
10
+ * Returns undefined outside a supported adapter, including for request.clone().
11
+ * Pass the original Request (or the context itself) into deferred work explicitly.
12
+ * Entries remain available after fetch returns for streams and waitUntil tasks;
13
+ * weak ownership releases them when the Request is no longer reachable.
14
+ * Context is never attached to request properties or serialized into responses.
15
+ */
16
+ export declare function getEdgeContext<Env extends object = Record<string, unknown>>(request: Request): EdgeContext<Env> | undefined;
17
+ //# sourceMappingURL=edge-context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"edge-context.d.ts","sourceRoot":"","sources":["../../src/runtime/edge-context.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,WAAW,WAAW,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACzD;AAUD,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAEpF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzE,OAAO,EAAE,OAAO,GACf,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,CAE9B"}