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,76 @@
1
+ import type { IntlPayload } from '../defaults/runtime/seo-runtime';
2
+
3
+ export type I18nParams = Record<string, string | number | boolean | null | undefined>;
4
+
5
+ export type Translate = (key: string, params?: I18nParams, fallback?: string) => string;
6
+
7
+ type ServerReader = () => IntlPayload | null | undefined;
8
+
9
+ interface I18nRuntimeState {
10
+ clientIntl: IntlPayload | null;
11
+ serverReader: ServerReader | null;
12
+ keyPathCache: Map<string, string[]>;
13
+ }
14
+
15
+ const I18N_RUNTIME_STATE_KEY = '__ISR_ENGINE_I18N_RUNTIME_STATE__';
16
+
17
+ const runtimeState = getRuntimeState();
18
+
19
+ export function setClientI18n(intl: IntlPayload | null | undefined): void {
20
+ runtimeState.clientIntl = intl ?? null;
21
+ }
22
+
23
+ export function registerServerI18nReader(reader: ServerReader): void {
24
+ runtimeState.serverReader = reader;
25
+ }
26
+
27
+ export function getCurrentI18n(): IntlPayload | null {
28
+ return runtimeState.serverReader?.() ?? runtimeState.clientIntl;
29
+ }
30
+
31
+ export function getI18nLocale(fallback = ''): string {
32
+ return getCurrentI18n()?.locale ?? fallback;
33
+ }
34
+
35
+ export const getI18n: Translate = (key, params, fallback = key) => {
36
+ const value = readPath(getCurrentI18n()?.messages, key);
37
+ const message = typeof value === 'string' && value.trim() ? value : fallback;
38
+ return interpolate(message, params);
39
+ };
40
+
41
+ function readPath(source: unknown, key: string): unknown {
42
+ let path = runtimeState.keyPathCache.get(key);
43
+ if (!path) {
44
+ path = key.split('.');
45
+ runtimeState.keyPathCache.set(key, path);
46
+ }
47
+
48
+ let cur = source;
49
+ for (const part of path) {
50
+ if (!cur || typeof cur !== 'object' || !(part in cur)) return undefined;
51
+ cur = (cur as Record<string, unknown>)[part];
52
+ }
53
+ return cur;
54
+ }
55
+
56
+ function getRuntimeState(): I18nRuntimeState {
57
+ const globalState = globalThis as typeof globalThis & {
58
+ [I18N_RUNTIME_STATE_KEY]?: I18nRuntimeState;
59
+ };
60
+
61
+ globalState[I18N_RUNTIME_STATE_KEY] ??= {
62
+ clientIntl: null,
63
+ serverReader: null,
64
+ keyPathCache: new Map<string, string[]>(),
65
+ };
66
+
67
+ return globalState[I18N_RUNTIME_STATE_KEY];
68
+ }
69
+
70
+ function interpolate(message: string, params?: I18nParams): string {
71
+ if (!params) return message;
72
+ return message.replace(/\{(\w+)\}/g, (match, name) => {
73
+ const value = params[name];
74
+ return value === undefined || value === null ? match : String(value);
75
+ });
76
+ }
@@ -0,0 +1,189 @@
1
+ /**
2
+ * i18n 路由工具 —— URL 前缀自动处理(无 React 依赖,server + client 通用)
3
+ *
4
+ * 业务侧用法:
5
+ *
6
+ * import { parseLocale, withLocale, negotiateLocale } from 'isr-engine/runtime';
7
+ *
8
+ * const I18N = { locales: ['zh', 'en'] as const, defaultLocale: 'zh' };
9
+ *
10
+ * // SSR 入口:从 URL 拆 locale + 干净 pathname 给路由
11
+ * const { locale, pathname } = parseLocale(url.pathname, I18N);
12
+ * return <Layout lang={locale}>{resolveRoute({ pathname, locale })}</Layout>;
13
+ *
14
+ * // Header 切换语言
15
+ * const href = withLocale('/books/1', 'en', I18N); // → '/en/books/1'
16
+ * const href = withLocale('/books/1', 'zh', I18N); // → '/books/1'(默认 locale 不前缀)
17
+ *
18
+ * // 服务器协商:Accept-Language 头 → locale
19
+ * const locale = negotiateLocale(req.headers.get('accept-language'), I18N);
20
+ *
21
+ * 设计取舍:
22
+ * - 默认 locale 不带前缀('/about'),其他 locale 带('/en/about')
23
+ * → 与 Next.js i18n routing 默认 + Vue I18n 一致;SEO 友好(默认语言 URL 简洁)
24
+ * - 用 `prefixDefault: true` 切到"全部带前缀"模式(如 '/zh/about')
25
+ * - 不内置消息字典 / 翻译机制 —— 那是 react-intl / FormatJS / lingui 的活
26
+ */
27
+
28
+ import { trimTrailingSlashes } from '../utils/trimTrailingSlashes';
29
+ export interface I18nConfig {
30
+ /** 支持的 locale 列表,如 ['zh', 'en', 'ja'] */
31
+ locales: readonly string[];
32
+ /** 默认 locale —— 必须在 locales 内 */
33
+ defaultLocale: string;
34
+ /** 是否给默认 locale 也加 URL 前缀(默认 false:'/about';true:'/zh/about') */
35
+ prefixDefault?: boolean;
36
+ }
37
+
38
+ export interface ParsedLocale {
39
+ /** 解析出的 locale(命中 URL 前缀则取前缀,否则取 defaultLocale) */
40
+ locale: string;
41
+ /** 去掉 locale 前缀后的"业务 pathname",路由表只需匹配这个 */
42
+ pathname: string;
43
+ /** URL 是否真的带了 locale 前缀 */
44
+ hasPrefix: boolean;
45
+ }
46
+
47
+ /**
48
+ * 从 pathname 拆出 locale 与业务 pathname
49
+ *
50
+ * '/zh/books/1' + { locales: ['zh','en'], defaultLocale: 'en' }
51
+ * → { locale: 'zh', pathname: '/books/1', hasPrefix: true }
52
+ *
53
+ * '/books/1' 同上
54
+ * → { locale: 'en', pathname: '/books/1', hasPrefix: false }
55
+ */
56
+ export function parseLocale(pathname: string, config: I18nConfig): ParsedLocale {
57
+ const segments = pathname.split('/');
58
+ // segments[0] 是空串(leading '/'),segments[1] 才是首段
59
+ const first = segments[1];
60
+ if (first && config.locales.includes(first)) {
61
+ const rest = '/' + segments.slice(2).join('/');
62
+ return {
63
+ locale: first,
64
+ pathname: rest === '/' ? '/' : trimTrailingSlashes(rest),
65
+ hasPrefix: true,
66
+ };
67
+ }
68
+ return { locale: config.defaultLocale, pathname: pathname || '/', hasPrefix: false };
69
+ }
70
+
71
+ /**
72
+ * 给业务 pathname 套上 locale 前缀(生成可跳转 URL)
73
+ *
74
+ * withLocale('/about', 'en', { defaultLocale: 'zh', locales: ['zh','en'] })
75
+ * → '/en/about'
76
+ *
77
+ * withLocale('/about', 'zh', { defaultLocale: 'zh', locales: ['zh','en'] })
78
+ * → '/about' (默认 locale 不前缀)
79
+ *
80
+ * withLocale('/about', 'zh', { ..., prefixDefault: true })
81
+ * → '/zh/about'
82
+ */
83
+ export function withLocale(pathname: string, locale: string, config: I18nConfig): string {
84
+ if (!config.locales.includes(locale)) {
85
+ throw new Error(`[i18n] unknown locale "${locale}"; allowed: ${config.locales.join(', ')}`);
86
+ }
87
+ const clean = pathname.startsWith('/') ? pathname : '/' + pathname;
88
+ if (locale === config.defaultLocale && !config.prefixDefault) return clean;
89
+ return `/${locale}${clean === '/' ? '' : clean}`;
90
+ }
91
+
92
+ /**
93
+ * Accept-Language 协商 —— RFC 4647 lookup(含主语言回退)
94
+ *
95
+ * negotiateLocale('zh-CN,en;q=0.9', { locales: ['zh','en'], defaultLocale: 'en' })
96
+ * → 'zh' ('zh-CN' 命中 'zh')
97
+ *
98
+ * negotiateLocale('en-GB', { locales: ['zh-hans','en-us'], defaultLocale: 'zh-hans' })
99
+ * → 'en-us' ('en-GB' 主语言 'en' 回退到第一个 en-*)
100
+ *
101
+ * negotiateLocale(null, ...) → defaultLocale
102
+ */
103
+ export function negotiateLocale(
104
+ acceptLanguage: string | null | undefined,
105
+ config: I18nConfig
106
+ ): string {
107
+ if (!acceptLanguage) return config.defaultLocale;
108
+ const ranked = acceptLanguage
109
+ .split(',')
110
+ .map(part => {
111
+ const [tag, ...params] = part.trim().split(';');
112
+ const q = params.find(p => p.startsWith('q='));
113
+ return { tag: tag.toLowerCase(), q: q ? Number(q.slice(2)) || 0 : 1 };
114
+ })
115
+ .sort((a, b) => b.q - a.q);
116
+
117
+ const supported = config.locales.map(l => l.toLowerCase());
118
+ for (const { tag } of ranked) {
119
+ // 1) 完整 code 精确匹配('en-us' === 'en-us')
120
+ const exact = supported.indexOf(tag);
121
+ if (exact >= 0) return config.locales[exact];
122
+
123
+ const primary = tag.split('-')[0];
124
+
125
+ // 2) 主语言精确匹配('ja' === 'ja',针对无地区后缀的 locale 如 ja/fr/tr)
126
+ const sub = supported.indexOf(primary);
127
+ if (sub >= 0) return config.locales[sub];
128
+
129
+ // 3) 主语言回退('en' / 'en-GB' → 第一个 en-*;'zh' / 'zh-CN' → zh-hans)
130
+ // 解决「浏览器只发 en / en-GB,而 locales 是 en-us/en-au」这类地区码不匹配问题。
131
+ const primaryPrefix = supported.findIndex(l => l.startsWith(primary + '-'));
132
+ if (primaryPrefix >= 0) return config.locales[primaryPrefix];
133
+ }
134
+ return config.defaultLocale;
135
+ }
136
+
137
+ /**
138
+ * 列出某业务 pathname 在所有 locale 下的 URL —— 用于 <link rel="alternate" hreflang>
139
+ *
140
+ * alternates('/about', { locales: ['zh','en'], defaultLocale: 'zh' })
141
+ * → [{ hreflang: 'zh', href: '/about' }, { hreflang: 'en', href: '/en/about' }]
142
+ */
143
+ export function alternates(
144
+ pathname: string,
145
+ config: I18nConfig
146
+ ): Array<{ hreflang: string; href: string }> {
147
+ return config.locales.map(locale => ({
148
+ hreflang: locale,
149
+ href: withLocale(pathname, locale, config),
150
+ }));
151
+ }
152
+
153
+ /**
154
+ * 从 SiteHooks 的 intl 字段提取 URL 路由配置并填默认值
155
+ *
156
+ * 用途:消除消费者侧 `app.tsx` 里那段「从 siteHooks.intl 抠出 locales/defaultLocale/prefixDefault
157
+ * 再补默认值组装 I18nConfig」的重复样板。
158
+ *
159
+ * // before
160
+ * const intl = siteHooks.intl ?? {};
161
+ * const I18N: I18nConfig = {
162
+ * locales: intl.locales ?? ['en'],
163
+ * defaultLocale: intl.defaultLocale ?? 'en',
164
+ * prefixDefault: intl.prefixDefault,
165
+ * };
166
+ *
167
+ * // after
168
+ * const I18N = resolveI18nConfig(siteHooks.intl);
169
+ *
170
+ * 行为:
171
+ * - 缺省 → `{ locales: ['en'], defaultLocale: 'en' }`(单语言英文兜底)
172
+ * - locales 给了但 defaultLocale 没给 → 取 locales[0]
173
+ * - 多余字段(endpoint / load / ttl / detect)忽略,只挑 URL 路由相关
174
+ */
175
+ export function resolveI18nConfig(
176
+ intl?: {
177
+ locales?: readonly string[];
178
+ defaultLocale?: string;
179
+ prefixDefault?: boolean;
180
+ } | null
181
+ ): I18nConfig {
182
+ const locales = intl?.locales && intl.locales.length > 0 ? intl.locales : ['en'];
183
+ const defaultLocale = intl?.defaultLocale ?? locales[0];
184
+ return {
185
+ locales,
186
+ defaultLocale,
187
+ prefixDefault: intl?.prefixDefault,
188
+ };
189
+ }
@@ -0,0 +1,61 @@
1
+ /**
2
+ * isr-engine/runtime —— 业务页面通用运行时
3
+ *
4
+ * 与主入口 `isr-engine`(Node 编排层)严格隔离,浏览器 + RSC 都安全
5
+ *
6
+ * 用法:
7
+ * import { defineRoutes, Boundary, parseLocale } from 'isr-engine/runtime';
8
+ */
9
+
10
+ export { Boundary, ErrorBoundary } from './boundary';
11
+ export {
12
+ parseLocale,
13
+ withLocale,
14
+ negotiateLocale,
15
+ alternates,
16
+ resolveI18nConfig,
17
+ type I18nConfig,
18
+ type ParsedLocale,
19
+ } from './i18n';
20
+ export {
21
+ getI18n,
22
+ getI18nLocale,
23
+ getCurrentI18n,
24
+ setClientI18n,
25
+ type I18nParams,
26
+ type Translate,
27
+ } from './i18n-store';
28
+ export { LocaleProvider, useLocale } from './LocaleContext';
29
+ export {
30
+ capture,
31
+ flushTelemetry,
32
+ getTelemetry,
33
+ measure,
34
+ page,
35
+ setTelemetryUser,
36
+ track,
37
+ type TelemetryCaptureOptions,
38
+ type TelemetryEventOptions,
39
+ type TelemetryLevel,
40
+ type TelemetryMeasureOptions,
41
+ type TelemetryRuntimeHandle,
42
+ type TelemetryUser,
43
+ } from './telemetry';
44
+
45
+ // 路由 —— route module 风格({ path, load: () => import('./pages/HomePage') })
46
+ export {
47
+ defineRoutes,
48
+ resolvePageSeoMeta,
49
+ type RouteEntry,
50
+ type RouteModuleLoader,
51
+ type RouteModuleRef,
52
+ type PageProps,
53
+ type PageComponent,
54
+ type ResolveRoute,
55
+ type RouteManifest,
56
+ type DefinedRoutes,
57
+ type PageSeoContext,
58
+ type PageSeoExport,
59
+ } from './routes';
60
+
61
+ export { getEdgeContext, type EdgeContext } from './edge-context';
@@ -0,0 +1,247 @@
1
+ /**
2
+ * defineRoutes —— Next.js 风格路由表
3
+ *
4
+ * 第一性原理:一条路由 = (path, route module)。Page 可以是:
5
+ * - async Server Component(默认)—— 内部直接 cacheTag / await fetch / getVariant
6
+ * - 同步 Server Component
7
+ * - 'use client' Client Component(带 useState/useEffect 等 hooks)
8
+ *
9
+ * Server Action / RSC:标准 React 19 + plugin-rsc 'use server' / 'use client' 指令,
10
+ * engine 不发明新 API。
11
+ *
12
+ * 业务用法:
13
+ *
14
+ * // src/routes.tsx
15
+ * import { defineRoutes } from 'isr-engine/runtime';
16
+ * import HomePage from './pages/HomePage'; // async Server Component
17
+ * import BookDetail from './components/BookDetail'; // async Server Component
18
+ * import NotFoundPage from './pages/NotFoundPage';
19
+ *
20
+ * export const { routes } = defineRoutes({
21
+ * notFound: { load: () => import('./pages/NotFoundPage') },
22
+ * routes: [
23
+ * { path: '/', load: () => import('./pages/HomePage') },
24
+ * { path: '/books/:id', load: () => import('./components/BookDetail') },
25
+ * { path: '/about', load: () => import('./pages/AboutPage') },
26
+ * ],
27
+ * });
28
+ *
29
+ * // src/pages/HomePage.tsx —— 一切都在这里
30
+ * import { cacheTag } from 'isr-engine/rsc';
31
+ * export default async function HomePage({ searchParams }) {
32
+ * cacheTag('books');
33
+ * const data = await fetch(`${process.env.API_URL}/api/books`).then(r => r.json());
34
+ * return <HomeContent books={data.data ?? []} />;
35
+ * }
36
+ *
37
+ * 路径语法:':param' 命名参数 / '/*' 通配后缀
38
+ * Engine 自动把 path params 注入 page 的 `params` 属性
39
+ */
40
+
41
+ import { trimTrailingSlashes } from '../utils/trimTrailingSlashes';
42
+ import * as React from 'react';
43
+ import type { PageSeoMeta } from '../defaults/runtime/seo-runtime';
44
+
45
+ declare global {
46
+ var __ISR_ENGINE_ROUTE_MANIFESTS__: RouteManifest[] | undefined;
47
+ }
48
+
49
+ /** 路由匹配后传给 page 的 props */
50
+ export interface PageProps {
51
+ pathname: string;
52
+ searchParams: URLSearchParams;
53
+ params: Record<string, string>;
54
+ }
55
+
56
+ /**
57
+ * Page 组件 —— 普通 React 组件(async / sync / 'use client' 都可)
58
+ *
59
+ * 用 any 是因为 page 可只接收 PageProps 的子集(如 `({ params })` / `()`);
60
+ * engine 总是 spread 完整 PageProps,多余 props 被组件忽略
61
+ */
62
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
63
+ export type PageComponent = React.ComponentType<any>;
64
+
65
+ type RouteModule = object;
66
+ export type RouteModuleLoader = () => Promise<RouteModule>;
67
+
68
+ export interface RouteModuleRef {
69
+ load: RouteModuleLoader;
70
+ /** 命名导出;默认读取 default */
71
+ export?: string;
72
+ }
73
+
74
+ export interface RouteEntry extends RouteModuleRef {
75
+ path: string;
76
+ }
77
+
78
+ export interface RouteManifest {
79
+ routes: readonly RouteEntry[];
80
+ /** 没匹配到时渲染的 route module;不传 → 返回 null */
81
+ notFound?: RouteModuleRef;
82
+ }
83
+
84
+ export interface DefinedRoutes {
85
+ /** SSR/RSC resolver */
86
+ routes: ResolveRoute;
87
+ }
88
+
89
+ export interface PageSeoContext extends PageProps {
90
+ url: URL;
91
+ }
92
+
93
+ export type PageSeoExport =
94
+ | PageSeoMeta
95
+ | null
96
+ | undefined
97
+ | ((
98
+ ctx: PageSeoContext
99
+ ) => PageSeoMeta | null | undefined | Promise<PageSeoMeta | null | undefined>);
100
+
101
+ interface CompiledRoute extends RouteEntry {
102
+ re: RegExp;
103
+ keys: string[];
104
+ Component: PageComponent;
105
+ }
106
+
107
+ function compile(path: string): { re: RegExp; keys: string[] } {
108
+ const keys: string[] = [];
109
+ const hasWildcard = path.endsWith('/*');
110
+ const base = hasWildcard ? path.slice(0, -2) : path;
111
+ const escaped = base.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
112
+ const pattern = escaped.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (_m, k) => {
113
+ keys.push(k);
114
+ return '([^/]+)';
115
+ });
116
+ return {
117
+ re: new RegExp('^' + (hasWildcard ? pattern + '(?:/.*)?' : pattern) + '$'),
118
+ keys,
119
+ };
120
+ }
121
+
122
+ export type ResolveRoute = (ctx: {
123
+ pathname: string;
124
+ searchParams: URLSearchParams;
125
+ }) => React.ReactNode;
126
+
127
+ function resolveRouteComponent(
128
+ ref: RouteModuleRef,
129
+ label: string,
130
+ exportName = 'default',
131
+ fallbackExport?: string
132
+ ): PageComponent {
133
+ const requestedExport = ref.export ?? exportName;
134
+ return React.lazy(async () => {
135
+ const mod = await ref.load();
136
+ const exports = mod as Record<string, unknown>;
137
+ const component =
138
+ exports[requestedExport] ?? (fallbackExport ? exports[fallbackExport] : undefined);
139
+ if (!component) {
140
+ throw new Error(`Route component "${label}" does not export "${requestedExport}"`);
141
+ }
142
+ return { default: component as PageComponent };
143
+ });
144
+ }
145
+
146
+ function resolvePageComponent(route: RouteEntry): PageComponent {
147
+ return resolveRouteComponent(route, route.path);
148
+ }
149
+
150
+ function createRouteResolver(
151
+ routes: readonly RouteEntry[],
152
+ notFound?: RouteModuleRef
153
+ ): ResolveRoute {
154
+ const compiled: CompiledRoute[] = routes.map(r => ({
155
+ ...r,
156
+ Component: resolvePageComponent(r),
157
+ ...compile(r.path),
158
+ }));
159
+ const NotFound = notFound ? resolveRouteComponent(notFound, '__not_found__') : undefined;
160
+
161
+ return function resolveRoute({ pathname, searchParams }) {
162
+ const clean = trimTrailingSlashes(pathname) || '/';
163
+ for (const route of compiled) {
164
+ const m = route.re.exec(clean);
165
+ if (!m) continue;
166
+ const params: Record<string, string> = {};
167
+ route.keys.forEach((k, i) => {
168
+ params[k] = decodeURIComponent(m[i + 1] ?? '');
169
+ });
170
+ const Page = route.Component;
171
+ return <Page pathname={clean} searchParams={searchParams} params={params} />;
172
+ }
173
+ if (NotFound) {
174
+ return <NotFound pathname={clean} searchParams={searchParams} params={{}} />;
175
+ }
176
+ return null;
177
+ };
178
+ }
179
+
180
+ function createDefinedRoutes(config: RouteManifest): DefinedRoutes {
181
+ registerRouteManifest(config);
182
+ return {
183
+ routes: createRouteResolver(config.routes, config.notFound),
184
+ };
185
+ }
186
+
187
+ export function defineRoutes(config: RouteManifest): DefinedRoutes;
188
+ export function defineRoutes(input: RouteManifest): DefinedRoutes {
189
+ return createDefinedRoutes(input);
190
+ }
191
+
192
+ function getRouteRegistry(): RouteManifest[] {
193
+ globalThis.__ISR_ENGINE_ROUTE_MANIFESTS__ ??= [];
194
+ return globalThis.__ISR_ENGINE_ROUTE_MANIFESTS__;
195
+ }
196
+
197
+ function registerRouteManifest(config: RouteManifest): void {
198
+ getRouteRegistry().push(config);
199
+ }
200
+
201
+ export async function resolvePageSeoMeta(url: URL): Promise<PageSeoMeta | null> {
202
+ const pathname = trimTrailingSlashes(url.pathname) || '/';
203
+ for (const manifest of getRouteRegistry()) {
204
+ for (const route of manifest.routes) {
205
+ const matched = matchRoute(pathname, route);
206
+ if (!matched) continue;
207
+ return await loadPageSeo(route, {
208
+ url,
209
+ pathname,
210
+ searchParams: url.searchParams,
211
+ params: matched.params,
212
+ });
213
+ }
214
+ }
215
+ return null;
216
+ }
217
+
218
+ function matchRoute(
219
+ pathname: string,
220
+ route: RouteEntry
221
+ ): { params: Record<string, string> } | null {
222
+ const compiled = compile(route.path);
223
+ const m = compiled.re.exec(pathname);
224
+ if (!m) return null;
225
+ const params: Record<string, string> = {};
226
+ compiled.keys.forEach((k, i) => {
227
+ params[k] = decodeURIComponent(m[i + 1] ?? '');
228
+ });
229
+ return { params };
230
+ }
231
+
232
+ async function loadPageSeo(route: RouteEntry, ctx: PageSeoContext): Promise<PageSeoMeta | null> {
233
+ const mod = await route.load();
234
+ const exports = mod as Record<string, unknown>;
235
+ const exported = exports.seo ?? exports.generateSeo;
236
+ if (!exported) return null;
237
+ if (typeof exported === 'function') {
238
+ return (
239
+ (await (
240
+ exported as (
241
+ ctx: PageSeoContext
242
+ ) => PageSeoMeta | null | undefined | Promise<PageSeoMeta | null | undefined>
243
+ )(ctx)) ?? null
244
+ );
245
+ }
246
+ return exported as PageSeoMeta;
247
+ }
@@ -0,0 +1,13 @@
1
+ /**
2
+ * CSS Modules 类型声明 —— 让 engine 内部 tsc 通过
3
+ * 用户项目侧由 `vite/client` types 提供同款声明,互不冲突
4
+ */
5
+ declare module '*.module.scss' {
6
+ const styles: Record<string, string>;
7
+ export default styles;
8
+ }
9
+
10
+ declare module '*.module.css' {
11
+ const styles: Record<string, string>;
12
+ export default styles;
13
+ }
@@ -0,0 +1,116 @@
1
+ /**
2
+ * Browser telemetry facade.
3
+ *
4
+ * Business code imports these functions for semantic product events, domain
5
+ * errors, or custom performance measurements. The transport is installed by
6
+ * the engine client entry from ssr.config.ts runtime.telemetry. Without an
7
+ * installed transport these functions are deliberate no-ops, so shared modules
8
+ * can import them safely during SSR/RSC evaluation.
9
+ */
10
+
11
+ export type TelemetryLevel = 'fatal' | 'error' | 'warning' | 'info' | 'debug';
12
+
13
+ export interface TelemetryUser {
14
+ id?: string;
15
+ tenantId?: string;
16
+ segment?: string;
17
+ traits?: Record<string, unknown>;
18
+ }
19
+
20
+ export interface TelemetryEventOptions {
21
+ tags?: Record<string, string | number | boolean | null | undefined>;
22
+ }
23
+
24
+ export interface TelemetryCaptureOptions extends TelemetryEventOptions {
25
+ level?: TelemetryLevel;
26
+ source?: string;
27
+ extra?: Record<string, unknown>;
28
+ fingerprint?: readonly string[];
29
+ }
30
+
31
+ export interface TelemetryMeasureOptions extends TelemetryEventOptions {
32
+ unit?: 'ms' | 's' | 'byte' | 'count' | 'ratio' | string;
33
+ properties?: Record<string, unknown>;
34
+ }
35
+
36
+ export interface TelemetryRuntimeHandle {
37
+ track(name: string, properties?: Record<string, unknown>, options?: TelemetryEventOptions): void;
38
+ capture(error: unknown, options?: TelemetryCaptureOptions): void;
39
+ measure(name: string, value: number, options?: TelemetryMeasureOptions): void;
40
+ page(url?: URL | string): void;
41
+ setUser(user: TelemetryUser | null): void;
42
+ flush(): Promise<void> | void;
43
+ shutdown(): void;
44
+ }
45
+
46
+ type PendingTelemetryCall = (handle: TelemetryRuntimeHandle) => void;
47
+
48
+ const MAX_PENDING_CALLS = 50;
49
+
50
+ let currentHandle: TelemetryRuntimeHandle | null = null;
51
+ let pendingCalls: PendingTelemetryCall[] = [];
52
+
53
+ export function track(
54
+ name: string,
55
+ properties?: Record<string, unknown>,
56
+ options?: TelemetryEventOptions
57
+ ): void {
58
+ runOrQueue(handle => handle.track(name, properties, options));
59
+ }
60
+
61
+ export function capture(error: unknown, options?: TelemetryCaptureOptions): void {
62
+ runOrQueue(handle => handle.capture(error, options));
63
+ }
64
+
65
+ export function measure(name: string, value: number, options?: TelemetryMeasureOptions): void {
66
+ runOrQueue(handle => handle.measure(name, value, options));
67
+ }
68
+
69
+ export function page(url?: URL | string): void {
70
+ runOrQueue(handle => handle.page(url));
71
+ }
72
+
73
+ export function setTelemetryUser(user: TelemetryUser | null): void {
74
+ runOrQueue(handle => handle.setUser(user));
75
+ }
76
+
77
+ export function flushTelemetry(): Promise<void> | void {
78
+ return currentHandle?.flush();
79
+ }
80
+
81
+ export function getTelemetry(): TelemetryRuntimeHandle | null {
82
+ return currentHandle;
83
+ }
84
+
85
+ export function __setBrowserTelemetryHandle(handle: TelemetryRuntimeHandle): void {
86
+ currentHandle = handle;
87
+ const calls = pendingCalls;
88
+ pendingCalls = [];
89
+ for (const call of calls) {
90
+ try {
91
+ call(handle);
92
+ } catch {
93
+ /* telemetry facade must never break app startup */
94
+ }
95
+ }
96
+ }
97
+
98
+ export function __clearBrowserTelemetryHandle(handle: TelemetryRuntimeHandle): void {
99
+ if (currentHandle === handle) currentHandle = null;
100
+ }
101
+
102
+ function runOrQueue(call: PendingTelemetryCall): void {
103
+ if (currentHandle) {
104
+ call(currentHandle);
105
+ return;
106
+ }
107
+ if (!isBrowser()) return;
108
+ pendingCalls.push(call);
109
+ if (pendingCalls.length > MAX_PENDING_CALLS) {
110
+ pendingCalls = pendingCalls.slice(-MAX_PENDING_CALLS);
111
+ }
112
+ }
113
+
114
+ function isBrowser(): boolean {
115
+ return typeof window !== 'undefined' && typeof document !== 'undefined';
116
+ }