isr-engine 0.0.0-stage → 2.6.21

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 +694 -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-Byzz8ZlU.cjs +105 -0
  100. package/dist/createCacheInspectorMiddleware-Byzz8ZlU.cjs.map +1 -0
  101. package/dist/createCacheInspectorMiddleware-DYJ2WGYu.js +105 -0
  102. package/dist/createCacheInspectorMiddleware-DYJ2WGYu.js.map +1 -0
  103. package/dist/createISRApp-C9Bezuit.cjs +7663 -0
  104. package/dist/createISRApp-C9Bezuit.cjs.map +1 -0
  105. package/dist/createISRApp-CylUYiIU.js +7322 -0
  106. package/dist/createISRApp-CylUYiIU.js.map +1 -0
  107. package/dist/createImagePlugin-_ntL0DcT.js +416 -0
  108. package/dist/createImagePlugin-_ntL0DcT.js.map +1 -0
  109. package/dist/createImagePlugin-birVNynL.cjs +435 -0
  110. package/dist/createImagePlugin-birVNynL.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 +200 -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 +839 -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 +42 -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 +512 -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 +19 -0
  452. package/src/utils/trimTrailingSlashes.ts +6 -0
@@ -0,0 +1,257 @@
1
+ /**
2
+ * SEO + i18n 运行时载荷类型 + 注入 helper
3
+ *
4
+ * 这些定义同时被两端消费:
5
+ * - engine 内部(src/engine/seo/* re-export 后给 SEOEngine 等用)
6
+ * - 用户的 plugin-rsc 构建里(src/defaults/* 在用户项目的 rsc 环境里被打包)
7
+ *
8
+ * 因此不能跨 `src/engine/...` 引用 —— pnpm `files` 字段只发布 `src/defaults/`。
9
+ * 把运行时需要的部分集中在本文件里,根 index.ts 再 re-export 给公共表面使用。
10
+ */
11
+
12
+ // ─── 类型 ──────────────────────────────────────────
13
+
14
+ export interface IntlPayload {
15
+ /** BCP 47 语言标签,如 'en', 'zh-CN' */
16
+ locale: string;
17
+ /** 翻译消息字典 —— 结构由用户的 i18n 库决定 */
18
+ messages: Record<string, unknown>;
19
+ /** 文本方向;RTL 语言(ar/he)需设 'rtl',默认 'ltr' */
20
+ direction?: 'ltr' | 'rtl';
21
+ /** 时区(用于日期格式化),默认 UTC */
22
+ timeZone?: string;
23
+ /** 诊断字段:标记消息来源,如 admin / local-fallback,便于 dev inspector 与响应头观测 */
24
+ source?: string;
25
+ }
26
+
27
+ export interface PageSeoMeta {
28
+ title?: string;
29
+ description?: string;
30
+ keywords?: string[];
31
+ canonical?: string;
32
+ image?: string;
33
+ ogType?: 'website' | 'article' | 'product';
34
+ noindex?: boolean;
35
+ alternates?: Array<{ hreflang: string; href: string }>;
36
+ jsonLd?: object | object[];
37
+ }
38
+
39
+ export function mergePageSeoMeta(
40
+ base: PageSeoMeta | null | undefined,
41
+ override: PageSeoMeta | null | undefined
42
+ ): PageSeoMeta | null {
43
+ if (!base) return override ?? null;
44
+ if (!override) return base;
45
+ return {
46
+ ...base,
47
+ ...override,
48
+ keywords: override.keywords ?? base.keywords,
49
+ alternates: override.alternates ?? base.alternates,
50
+ jsonLd: override.jsonLd ?? base.jsonLd,
51
+ };
52
+ }
53
+
54
+ // ─── PageSeoMeta → HTML 片段 ───────────────────────
55
+
56
+ /**
57
+ * 把相对 URL 用 baseUrl 解析成绝对 URL
58
+ * og:image / canonical / twitter:image / alternates.href 必须是绝对 URL
59
+ * —— 社交爬虫(Facebook/Twitter/微信/LinkedIn)不会基于页面 URL resolve 相对路径
60
+ */
61
+ function toAbsolute(href: string, baseUrl?: string): string {
62
+ if (!href) return href;
63
+ // 已是绝对 URL(含 protocol 或 //)
64
+ if (/^(https?:)?\/\//i.test(href)) return href;
65
+ if (!baseUrl) return href; // 没 baseUrl 只能原样输出(降级)
66
+ try {
67
+ return new URL(href, baseUrl).toString();
68
+ } catch {
69
+ return href;
70
+ }
71
+ }
72
+
73
+ export function renderPageSeoMeta(meta: PageSeoMeta, baseUrl?: string): string {
74
+ const tags: string[] = [];
75
+ const esc = (s: string) =>
76
+ s.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
77
+
78
+ // 所有 engine 注入的 head 节点都打 data-isr-seo 标,客户端导航时按 marker 精准替换,
79
+ // 不动业务/插件自己加的 meta(详见 applySeoToDocument 注释)。
80
+ // <title> 是单值元素由 document.title 直接管理,不打标。
81
+ if (meta.title) tags.push(`<title>${esc(meta.title)}</title>`);
82
+ if (meta.description) {
83
+ tags.push(`<meta data-isr-seo name="description" content="${esc(meta.description)}">`);
84
+ }
85
+ if (meta.keywords?.length) {
86
+ tags.push(`<meta data-isr-seo name="keywords" content="${esc(meta.keywords.join(', '))}">`);
87
+ }
88
+ if (meta.noindex) {
89
+ tags.push(`<meta data-isr-seo name="robots" content="noindex, nofollow">`);
90
+ }
91
+ if (meta.canonical || baseUrl) {
92
+ const href = toAbsolute(meta.canonical || '', baseUrl) || baseUrl || '';
93
+ if (href) tags.push(`<link data-isr-seo rel="canonical" href="${esc(href)}">`);
94
+ }
95
+ if (meta.alternates?.length) {
96
+ for (const a of meta.alternates) {
97
+ tags.push(
98
+ `<link data-isr-seo rel="alternate" hreflang="${esc(a.hreflang)}" href="${esc(toAbsolute(a.href, baseUrl))}">`
99
+ );
100
+ }
101
+ }
102
+ if (meta.title) {
103
+ tags.push(`<meta data-isr-seo property="og:title" content="${esc(meta.title)}">`);
104
+ }
105
+ if (meta.description) {
106
+ tags.push(`<meta data-isr-seo property="og:description" content="${esc(meta.description)}">`);
107
+ }
108
+ tags.push(`<meta data-isr-seo property="og:type" content="${meta.ogType ?? 'website'}">`);
109
+ if (meta.image) {
110
+ const abs = toAbsolute(meta.image, baseUrl);
111
+ tags.push(`<meta data-isr-seo property="og:image" content="${esc(abs)}">`);
112
+ tags.push(`<meta data-isr-seo name="twitter:image" content="${esc(abs)}">`);
113
+ }
114
+ if (meta.jsonLd) {
115
+ const arr = Array.isArray(meta.jsonLd) ? meta.jsonLd : [meta.jsonLd];
116
+ for (const obj of arr) {
117
+ const json = JSON.stringify(obj).replace(/<\/script/gi, '<\\/script');
118
+ tags.push(`<script data-isr-seo="jsonld" type="application/ld+json">${json}</script>`);
119
+ }
120
+ }
121
+ return tags.join('\n ');
122
+ }
123
+
124
+ // ─── 流式注入:在 <head> 开标签**之后**立刻插入 ────────────
125
+ // 关键:浏览器对 <title> 等单值元素只用 head 中的**第一个**,所以注入必须最先出现。
126
+ // 老实现是在 </head> 之前 append,结果用户 SSR 的 <title> 会先出现并胜出 → SEO 失效。
127
+ // 现在正则匹配 `<head ...>`(含属性)后立刻塞入用户的 PageSeoMeta。
128
+
129
+ const HEAD_OPEN_RE = /<head\b[^>]*>/i;
130
+
131
+ export function injectSeoMeta(
132
+ source: ReadableStream<Uint8Array>,
133
+ meta: PageSeoMeta,
134
+ baseUrl?: string
135
+ ): ReadableStream<Uint8Array> {
136
+ const encoder = new TextEncoder();
137
+ const decoder = new TextDecoder('utf-8', { fatal: false });
138
+ const injection = '\n ' + renderPageSeoMeta(meta, baseUrl) + '\n';
139
+
140
+ let buffer = '';
141
+ let injected = false;
142
+ // 防止 <head 被切成两个 chunk —— 保留尾部窗口
143
+ const SAFE_KEEP = 256;
144
+
145
+ const transform = new TransformStream<Uint8Array, Uint8Array>({
146
+ transform(chunk, controller) {
147
+ if (injected) {
148
+ controller.enqueue(chunk);
149
+ return;
150
+ }
151
+ buffer += decoder.decode(chunk, { stream: true });
152
+ const m = HEAD_OPEN_RE.exec(buffer);
153
+ if (m) {
154
+ const cutAt = m.index + m[0].length;
155
+ const before = buffer.slice(0, cutAt);
156
+ const after = buffer.slice(cutAt);
157
+ controller.enqueue(encoder.encode(before + injection + after));
158
+ buffer = '';
159
+ injected = true;
160
+ return;
161
+ }
162
+ if (buffer.length > SAFE_KEEP) {
163
+ const emit = buffer.slice(0, buffer.length - SAFE_KEEP);
164
+ buffer = buffer.slice(buffer.length - SAFE_KEEP);
165
+ controller.enqueue(encoder.encode(emit));
166
+ }
167
+ },
168
+ flush(controller) {
169
+ const tail = buffer + decoder.decode();
170
+ if (tail) controller.enqueue(encoder.encode(tail));
171
+ },
172
+ });
173
+
174
+ return source.pipeThrough(transform);
175
+ }
176
+
177
+ // ─── 客户端导航后同步 <head> ──────────────────────────────────────────────
178
+ //
179
+ // 首屏 SSR 走 injectSeoMeta(HTML 流注入 <title> / <meta>)。
180
+ // 但 RSC 客户端导航(pushState + 拉新 RSC payload)只换 React 树,<head> 不会自动跟。
181
+ // Next.js / Remix / Astro 同样的问题,做法都是把页面的 metadata 序列化进 RSC payload,
182
+ // 客户端在每次 setPayload 之后把 metadata 应用到 document(title / meta / link / jsonLd)。
183
+ //
184
+ // 本函数只在浏览器调用:业务侧通常不直接 import,engine 客户端 entry 自动调用。
185
+ //
186
+ // 关键点:
187
+ // - 用 `data-isr-seo` 标记本函数管理的 <head> 节点,避免误删用户/插件加的 meta
188
+ // - 先按 `data-isr-seo` 抓出旧节点,再按 meta 重建写回(删→建,避免顺序漂移)
189
+ // - jsonLd 也一并管,按 data-isr-seo='jsonld' 标记 + 全删全建
190
+ // - 初次调用(即 SSR 注入的初始 head)首先把已有的 <title> / <meta> / <link> / 含
191
+ // SSR injection marker 的节点打 data-isr-seo 标,让后续导航能精准替换
192
+ export function applySeoToDocument(meta: PageSeoMeta | null | undefined, baseUrl?: string): void {
193
+ if (typeof document === 'undefined') return;
194
+ if (!meta) return;
195
+ const head = document.head;
196
+ if (!head) return;
197
+
198
+ // 1. 删除上一次本函数写入的所有 SEO 节点(按 marker)
199
+ head.querySelectorAll('[data-isr-seo]').forEach(el => el.remove());
200
+
201
+ // 2. title 单独管 —— 只用 document.title 赋值(不创建第二个 <title>)
202
+ if (meta.title) document.title = meta.title;
203
+
204
+ // 3. 用与 renderPageSeoMeta 相同的逻辑重建 head 节点(保持 SSR / 客户端语义一致)
205
+ const fragments: HTMLElement[] = [];
206
+ const tag = (name: 'meta' | 'link' | 'script', attrs: Record<string, string>): HTMLElement => {
207
+ const el = document.createElement(name);
208
+ el.setAttribute('data-isr-seo', '');
209
+ for (const [k, v] of Object.entries(attrs)) el.setAttribute(k, v);
210
+ return el;
211
+ };
212
+
213
+ if (meta.description) {
214
+ fragments.push(tag('meta', { name: 'description', content: meta.description }));
215
+ }
216
+ if (meta.keywords?.length) {
217
+ fragments.push(tag('meta', { name: 'keywords', content: meta.keywords.join(', ') }));
218
+ }
219
+ if (meta.noindex) {
220
+ fragments.push(tag('meta', { name: 'robots', content: 'noindex, nofollow' }));
221
+ }
222
+ if (meta.canonical || baseUrl) {
223
+ const href = toAbsolute(meta.canonical || '', baseUrl) || baseUrl || '';
224
+ if (href) fragments.push(tag('link', { rel: 'canonical', href }));
225
+ }
226
+ if (meta.alternates?.length) {
227
+ for (const a of meta.alternates) {
228
+ fragments.push(
229
+ tag('link', { rel: 'alternate', hreflang: a.hreflang, href: toAbsolute(a.href, baseUrl) })
230
+ );
231
+ }
232
+ }
233
+ if (meta.title) {
234
+ fragments.push(tag('meta', { property: 'og:title', content: meta.title }));
235
+ }
236
+ if (meta.description) {
237
+ fragments.push(tag('meta', { property: 'og:description', content: meta.description }));
238
+ }
239
+ fragments.push(tag('meta', { property: 'og:type', content: meta.ogType ?? 'website' }));
240
+ if (meta.image) {
241
+ const abs = toAbsolute(meta.image, baseUrl);
242
+ fragments.push(tag('meta', { property: 'og:image', content: abs }));
243
+ fragments.push(tag('meta', { name: 'twitter:image', content: abs }));
244
+ }
245
+ if (meta.jsonLd) {
246
+ const arr = Array.isArray(meta.jsonLd) ? meta.jsonLd : [meta.jsonLd];
247
+ for (const obj of arr) {
248
+ const script = document.createElement('script');
249
+ script.setAttribute('data-isr-seo', 'jsonld');
250
+ script.type = 'application/ld+json';
251
+ script.textContent = JSON.stringify(obj).replace(/<\/script/gi, '<\\/script');
252
+ fragments.push(script);
253
+ }
254
+ }
255
+
256
+ for (const el of fragments) head.appendChild(el);
257
+ }
@@ -0,0 +1,10 @@
1
+ {
2
+ "extends": "../../tsconfig.json",
3
+ "compilerOptions": {
4
+ "rootDir": "../..",
5
+ "noEmit": true,
6
+ "types": ["node", "vite/client"]
7
+ },
8
+ "include": ["./**/*.ts", "./**/*.tsx", "./types.d.ts"],
9
+ "exclude": ["../../node_modules", "../../dist"]
10
+ }
@@ -0,0 +1,23 @@
1
+ /**
2
+ * 类型补全 —— 仅用于 src/defaults/* 的源码(被用户的 plugin-rsc 二次打包,不进 engine dist)
3
+ *
4
+ * 这些 API 只在 plugin-rsc 的 Vite environment 内可用,engine 自己的 lib build
5
+ * 不消费它们;所以放在 defaults/ 子目录的局部 d.ts,而不是污染 engine 顶层 types
6
+ */
7
+
8
+ /// <reference types="vite/client" />
9
+
10
+ declare global {
11
+ interface ImportMeta {
12
+ /**
13
+ * @vitejs/plugin-rsc 注入的 RSC 环境跨 environment 调用 API
14
+ * 详见 https://github.com/vitejs/vite-plugin-react/tree/main/packages/plugin-rsc
15
+ */
16
+ readonly viteRsc: {
17
+ loadModule<T = unknown>(env: 'rsc' | 'ssr' | 'client', name: string): Promise<T>;
18
+ loadBootstrapScriptContent(name: string): Promise<string>;
19
+ };
20
+ }
21
+ }
22
+
23
+ export {};
@@ -0,0 +1,124 @@
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
+
27
+ export interface ImageProps {
28
+ src: string;
29
+ alt: string;
30
+ width: number;
31
+ height?: number;
32
+ /** 端点路径,需与 createImagePlugin({ path }) 一致;默认 '/_/img'。仅对内部 src 生效 */
33
+ endpoint?: string;
34
+ /** 质量 1-100;仅对内部 src 生效(外部 URL 无优化能力) */
35
+ quality?: number;
36
+ /** 显式通过安全图片端点读取原图(无需 sharp);不能与 quality / format 合用。 */
37
+ unoptimized?: boolean;
38
+ /** 强制格式;仅对内部 src 生效 */
39
+ format?: 'avif' | 'webp' | 'jpeg' | 'png';
40
+ /** LCP 候选图设为 true:禁 lazy + fetchPriority=high + 自动 <link rel="preload"> */
41
+ priority?: boolean;
42
+ /** 设备像素密度数组,默认 [1, 2](覆盖 retina);仅对内部 src 生效 */
43
+ densities?: number[];
44
+ className?: string;
45
+ style?: React.CSSProperties;
46
+ sizes?: string;
47
+ }
48
+
49
+ /** 浏览器可直接加载的 URL 不交给仅接受本地路径的优化端点。
50
+ * data 仅允许图片媒体类型;不将任意 URL scheme 视为 passthrough。 */
51
+ function isBrowserImageUrl(src: string): boolean {
52
+ return /^(?:https?:\/\/|\/\/|blob:|data:image\/[^;,]+[;,])/i.test(src);
53
+ }
54
+
55
+ /** SVG 是矢量,不需要 sharp 优化也不需要 1x/2x srcset(无限分辨率),
56
+ * 无论 src 是内部还是外部,一律 passthrough 让浏览器直接加载。 */
57
+ function isSvg(src: string): boolean {
58
+ // 去 query string 后判扩展名
59
+ return /\.svg($|\?|#)/i.test(src);
60
+ }
61
+
62
+ export function Image(props: ImageProps): React.ReactElement {
63
+ const passthrough = isBrowserImageUrl(props.src) || isSvg(props.src);
64
+ const endpoint = props.endpoint ?? '/_/img';
65
+ const densities = props.densities ?? [1, 2];
66
+
67
+ let src: string;
68
+ let srcSet: string | undefined;
69
+
70
+ if (passthrough) {
71
+ // passthrough:浏览器原生 URL 或 SVG,不走 sharp 端点也不发 srcset,仍享有
72
+ // priority / preload / width/height(CLS 防护)等所有 priority 行为
73
+ src = props.src;
74
+ srcSet = undefined;
75
+ } else if (props.unoptimized) {
76
+ if (props.quality !== undefined || props.format !== undefined)
77
+ throw new Error('Image unoptimized cannot be combined with quality or format');
78
+ src = `${endpoint}?${new URLSearchParams({ src: props.src, fmt: 'original' })}`;
79
+ srcSet = undefined;
80
+ } else {
81
+ const buildUrl = (w: number) => {
82
+ const u = new URLSearchParams({ src: props.src, w: String(w) });
83
+ if (props.quality) u.set('q', String(props.quality));
84
+ if (props.format) u.set('fmt', props.format);
85
+ return `${endpoint}?${u.toString()}`;
86
+ };
87
+ srcSet = densities.map(d => `${buildUrl(props.width * d)} ${d}x`).join(', ');
88
+ src = buildUrl(props.width);
89
+ }
90
+
91
+ // 用 JSX 标准 prop 名 fetchPriority (camelCase) —— React 19.2 在 DOM render
92
+ // 路径下会序列化成小写 HTML 属性 fetchpriority;之前我用小写 spread 是过头修,
93
+ // 反而触发 React dev mode 警告 "Invalid DOM property fetchpriority"。
94
+ return (
95
+ <>
96
+ {/* React 19 metadata hoisting:<link> 会被自动提到 <head>。HTML 解析早期
97
+ 就发起 image preload,比等 React 渲染到 <img> 节点早几百 ms,直接砍
98
+ 掉 Lighthouse "Resource load delay" 那段。 */}
99
+ {props.priority && (
100
+ <link
101
+ rel='preload'
102
+ as='image'
103
+ href={src}
104
+ fetchPriority='high'
105
+ {...(srcSet ? { imageSrcSet: srcSet } : {})}
106
+ {...(props.sizes ? { imageSizes: props.sizes } : {})}
107
+ />
108
+ )}
109
+ <img
110
+ src={src}
111
+ srcSet={srcSet}
112
+ width={props.width}
113
+ height={props.height}
114
+ alt={props.alt}
115
+ className={props.className}
116
+ style={props.style}
117
+ sizes={props.sizes}
118
+ loading={props.priority ? 'eager' : 'lazy'}
119
+ decoding={props.priority ? 'sync' : 'async'}
120
+ fetchPriority={props.priority ? 'high' : 'auto'}
121
+ />
122
+ </>
123
+ );
124
+ }
@@ -0,0 +1,38 @@
1
+ /**
2
+ * LocaleProvider / useLocale —— 客户端 locale context(极小)
3
+ *
4
+ * 不内置消息字典;只暴露当前 locale + I18nConfig 给组件
5
+ * 切换语言用 withLocale + <a href> 触发整页导航即可(SSR 重新分派)
6
+ */
7
+ 'use client';
8
+
9
+ import * as React from 'react';
10
+ import type { I18nConfig } from './i18n';
11
+
12
+ interface LocaleContextValue {
13
+ locale: string;
14
+ config: I18nConfig;
15
+ }
16
+
17
+ const LocaleContext = React.createContext<LocaleContextValue | null>(null);
18
+
19
+ export function LocaleProvider({
20
+ locale,
21
+ config,
22
+ children,
23
+ }: {
24
+ locale: string;
25
+ config: I18nConfig;
26
+ children: React.ReactNode;
27
+ }) {
28
+ const value = React.useMemo(() => ({ locale, config }), [locale, config]);
29
+ return <LocaleContext.Provider value={value}>{children}</LocaleContext.Provider>;
30
+ }
31
+
32
+ export function useLocale(): LocaleContextValue {
33
+ const ctx = React.useContext(LocaleContext);
34
+ if (!ctx) {
35
+ throw new Error('useLocale() must be used inside <LocaleProvider>');
36
+ }
37
+ return ctx;
38
+ }
@@ -0,0 +1,46 @@
1
+ /**
2
+ * 默认 fallback 样式 —— 仅在用户没传 loading/error 自定义节点时启用
3
+ * 业务长出自家设计后,把自定义节点传进 <Boundary loading={...} error={...}> 即可
4
+ *
5
+ * 用平面 CSS(不嵌套)—— 让消费方零依赖即可使用 engine,
6
+ * 不强制要求装 sass / sass-embedded。
7
+ */
8
+
9
+ .errorRoot {
10
+ padding: 24px;
11
+ border: 1px solid #5a1d1d;
12
+ border-radius: 8px;
13
+ background: #2a0a0a;
14
+ color: #ffb4b4;
15
+ }
16
+
17
+ .errorRoot__title {
18
+ margin: 0;
19
+ font-weight: 600;
20
+ }
21
+
22
+ .errorRoot__message {
23
+ margin: 8px 0;
24
+ opacity: 0.8;
25
+ font-size: 13px;
26
+ }
27
+
28
+ .errorRoot__retry {
29
+ padding: 6px 14px;
30
+ background: #7b5cff;
31
+ color: #fff;
32
+ border: none;
33
+ border-radius: 4px;
34
+ cursor: pointer;
35
+ font-size: 13px;
36
+ }
37
+
38
+ .errorRoot__retry:hover {
39
+ filter: brightness(1.1);
40
+ }
41
+
42
+ .loadingRoot {
43
+ padding: 32px;
44
+ text-align: center;
45
+ opacity: 0.6;
46
+ }
@@ -0,0 +1,136 @@
1
+ /**
2
+ * 错误边界 + Suspense fallback —— 标准约定(Next.js error.tsx 同款 API)
3
+ *
4
+ * 业务页面用法(强烈推荐传自定义 fallback —— engine 默认只是兜底):
5
+ *
6
+ * // skeletons.tsx
7
+ * import { BookListSkeleton } from './skeletons';
8
+ *
9
+ * // BookListError.tsx —— 富错误 UI 必须是 'use client'(要接 error / reset 实例 props)
10
+ * 'use client';
11
+ * export function BookListError({ error, reset }: { error?: Error; reset?: () => void }) {
12
+ * return <div>...{error?.message}...<button onClick={reset}>重试</button></div>;
13
+ * }
14
+ *
15
+ * // page.tsx (Server Component)
16
+ * <Boundary
17
+ * loading={<BookListSkeleton />}
18
+ * error={<BookListError />} // ← 元素,不是函数;Boundary 会 cloneElement 注入 { error, reset }
19
+ * onError={(err) => Sentry.captureException(err)}
20
+ * >
21
+ * <BookList />
22
+ * </Boundary>
23
+ *
24
+ * 设计:
25
+ * - loading / error 都是 ReactElement(不能是函数 —— RSC 无法跨 server→client 边界传 function)
26
+ * - 内部 ReactErrorBoundary 在错误发生时 React.cloneElement(error, { error, reset })
27
+ * → 业务侧 'use client' 错误组件按 props 接收即可
28
+ * - 简单纯静态 fallback(无需 error/reset)也 OK:`<div>出错了</div>`,注入的 props 自动忽略
29
+ * - 嵌套:每层 <Boundary> 是独立隔离
30
+ * - Streaming:与 React 19 Suspense 自然配合
31
+ */
32
+ 'use client';
33
+
34
+ import * as React from 'react';
35
+ import styles from './boundary.module.css';
36
+
37
+ interface BoundaryProps {
38
+ /** Suspense fallback —— 子组件 await 数据时显示 */
39
+ loading?: React.ReactNode;
40
+ /**
41
+ * 错误边界 fallback —— 子组件抛错时显示。
42
+ * 必须是 ReactElement(不能是 function,因 RSC 不能跨边界序列化函数)。
43
+ * Boundary 内部会用 cloneElement 注入 `{ error, reset }` —— 'use client' 错误组件可接收这些 props。
44
+ */
45
+ error?: React.ReactElement;
46
+ /** onError 钩子(上报到 Sentry / Datadog) */
47
+ onError?: (error: Error, info: React.ErrorInfo) => void;
48
+ children: React.ReactNode;
49
+ }
50
+
51
+ interface ErrorState {
52
+ error: Error | null;
53
+ }
54
+
55
+ interface InjectedFallbackProps {
56
+ error?: Error;
57
+ reset?: () => void;
58
+ }
59
+
60
+ class ReactErrorBoundary extends React.Component<
61
+ {
62
+ fallback?: React.ReactElement;
63
+ onError?: (error: Error, info: React.ErrorInfo) => void;
64
+ children: React.ReactNode;
65
+ },
66
+ ErrorState
67
+ > {
68
+ state: ErrorState = { error: null };
69
+
70
+ static getDerivedStateFromError(error: Error): ErrorState {
71
+ return { error };
72
+ }
73
+
74
+ componentDidCatch(error: Error, info: React.ErrorInfo): void {
75
+ this.props.onError?.(error, info);
76
+ }
77
+
78
+ reset = (): void => this.setState({ error: null });
79
+
80
+ render(): React.ReactNode {
81
+ if (this.state.error) {
82
+ const { fallback } = this.props;
83
+ const injected: InjectedFallbackProps = { error: this.state.error, reset: this.reset };
84
+ if (fallback) {
85
+ return React.cloneElement(fallback, injected);
86
+ }
87
+ return <DefaultErrorFallback error={this.state.error} reset={this.reset} />;
88
+ }
89
+ return this.props.children;
90
+ }
91
+ }
92
+
93
+ function DefaultErrorFallback({ error, reset }: { error?: Error; reset?: () => void }) {
94
+ return (
95
+ <div className={styles.errorRoot}>
96
+ <p className={styles.errorRoot__title}>组件渲染异常</p>
97
+ <p className={styles.errorRoot__message}>{error?.message ?? 'unknown error'}</p>
98
+ <button onClick={reset ?? (() => location.reload())} className={styles.errorRoot__retry}>
99
+ 重试
100
+ </button>
101
+ </div>
102
+ );
103
+ }
104
+
105
+ function DefaultLoadingFallback() {
106
+ return <div className={styles.loadingRoot}>加载中…</div>;
107
+ }
108
+
109
+ /**
110
+ * 一站式 Boundary —— 同时套 ErrorBoundary + Suspense
111
+ * 业务最常用的形式:用 1 个组件框住有数据获取/有副作用的子树
112
+ */
113
+ export function Boundary({ loading, error, onError, children }: BoundaryProps) {
114
+ return (
115
+ <ReactErrorBoundary fallback={error} onError={onError}>
116
+ <React.Suspense fallback={loading ?? <DefaultLoadingFallback />}>{children}</React.Suspense>
117
+ </ReactErrorBoundary>
118
+ );
119
+ }
120
+
121
+ /** 仅错误边界(不需要 Suspense 时用)*/
122
+ export function ErrorBoundary({
123
+ fallback,
124
+ onError,
125
+ children,
126
+ }: {
127
+ fallback?: React.ReactElement;
128
+ onError?: (error: Error, info: React.ErrorInfo) => void;
129
+ children: React.ReactNode;
130
+ }) {
131
+ return (
132
+ <ReactErrorBoundary fallback={fallback} onError={onError}>
133
+ {children}
134
+ </ReactErrorBoundary>
135
+ );
136
+ }
@@ -0,0 +1,32 @@
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
+
7
+ // Share the registry across the bundled adapter and the source runtime entry.
8
+ // This is a weak request registry, never an ambient "current request" pointer.
9
+ const registryKey = Symbol.for('isr-engine/request-edge-context/v1');
10
+ const registryHost = globalThis as typeof globalThis & {
11
+ [registryKey]?: WeakMap<Request, EdgeContext<object>>;
12
+ };
13
+ const contexts = (registryHost[registryKey] ??= new WeakMap<Request, EdgeContext<object>>());
14
+
15
+ /** @internal Adapters bind the incoming request before invoking application code. */
16
+ export function bindEdgeContext(request: Request, context: EdgeContext<object>): void {
17
+ contexts.set(request, context);
18
+ }
19
+
20
+ /**
21
+ * Get platform context for the exact Request received by the handler.
22
+ * Returns undefined outside a supported adapter, including for request.clone().
23
+ * Pass the original Request (or the context itself) into deferred work explicitly.
24
+ * Entries remain available after fetch returns for streams and waitUntil tasks;
25
+ * weak ownership releases them when the Request is no longer reachable.
26
+ * Context is never attached to request properties or serialized into responses.
27
+ */
28
+ export function getEdgeContext<Env extends object = Record<string, unknown>>(
29
+ request: Request
30
+ ): EdgeContext<Env> | undefined {
31
+ return contexts.get(request) as EdgeContext<Env> | undefined;
32
+ }