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,54 @@
1
+ import type { RuntimeExperimentTrackingConfig } from '../types/ISRConfig';
2
+ export interface ExposureEvent {
3
+ /** 浏览器 / 设备稳定 UUID */
4
+ anonId: string;
5
+ /** 已登录用户 ID(业务侧 beforeRequest 写入) */
6
+ userId: string | null;
7
+ /** 本次请求 ID,关联 engine trace */
8
+ requestId: string;
9
+ /** 本次 SSR 涉及的全部实验:{ 'hero-style': 'bold', 'pricing-cta': 'discount' } */
10
+ experiments: Record<string, string>;
11
+ /** 请求 path(不含 query);用于按页面切实验数据 */
12
+ path: string;
13
+ /** 时间戳(ms epoch)—— engine 生成时刻 */
14
+ ts: number;
15
+ }
16
+ export interface ExposureQueueOptions {
17
+ /** admin-server endpoint(绝对 URL;engine 入口负责把相对路径拼好后传进来) */
18
+ endpoint: string;
19
+ /** 单批最大事件数;默认 100 */
20
+ batchSize?: number;
21
+ /** 距上次 flush 多久强制 flush(ms);默认 1000 */
22
+ flushIntervalMs?: number;
23
+ /** 采样率 [0, 1];默认 1.0;高 QPS 时降到 0.1 / 0.01 */
24
+ sampleRate?: number;
25
+ /** 队列硬上限(防止 admin-server 长宕时内存爆);默认 batchSize × 2 */
26
+ maxQueueSize?: number;
27
+ /** 自定义 fetch(测试用);默认 globalThis.fetch */
28
+ fetcher?: typeof fetch;
29
+ }
30
+ /**
31
+ * 创建上报队列。同一进程整个 lifecycle 只创建一个;engine 入口保管 instance。
32
+ * 返回 push() / flush() / destroy() 三个方法。
33
+ */
34
+ export declare function createExposureQueue(options: ExposureQueueOptions): {
35
+ /**
36
+ * 入队一个曝光事件。完全同步、永远不抛错。
37
+ * - 队列满(maxQueueSize)→ 丢最早事件(FIFO)+ critical log
38
+ * - 采样未命中 → 直接丢弃
39
+ */
40
+ push(event: ExposureEvent): void;
41
+ /** 立即 flush 当前批次(测试 / 优雅退出用) */
42
+ flush(): Promise<void>;
43
+ /** 销毁队列(清定时器、丢残留);engine 关闭时调 */
44
+ destroy(): void;
45
+ /** 测试用:当前队列长度 */
46
+ readonly size: number;
47
+ };
48
+ export type ExposureQueueInstance = ReturnType<typeof createExposureQueue>;
49
+ /**
50
+ * 解析配置,决定是否创建 queue 实例。配置缺失 / disabled / 无 endpoint 返回 null。
51
+ * services.api 或 services.telemetry origin 用于把相对路径补全为绝对 URL。
52
+ */
53
+ export declare function resolveExposureQueue(config: RuntimeExperimentTrackingConfig | undefined, baseOrigin: string | undefined): ExposureQueueInstance | null;
54
+ //# sourceMappingURL=ExposureQueue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ExposureQueue.d.ts","sourceRoot":"","sources":["../../src/experiments/ExposureQueue.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAI1E,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAQD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB;IA8E7D;;;;OAIG;gBACS,aAAa,GAAG,IAAI;IA6BhC,gCAAgC;aACjB,OAAO,CAAC,IAAI,CAAC;IAO5B,iCAAiC;eACtB,IAAI;IAYf,iBAAiB;mBACL,MAAM;EAIrB;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,+BAA+B,GAAG,SAAS,EACnD,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,qBAAqB,GAAG,IAAI,CAoB9B"}
@@ -0,0 +1,57 @@
1
+ import type { RuntimeExperimentConfig, RuntimeExperimentManifestConfig } from '../types/ISRConfig';
2
+ /** admin-server manifest 响应中单条实验定义的形状 */
3
+ export interface ManifestExperiment {
4
+ variants: readonly string[];
5
+ weights?: readonly number[];
6
+ status?: 'running' | 'paused' | 'killed' | 'concluded';
7
+ targeting?: {
8
+ locales?: readonly string[];
9
+ paths?: readonly string[];
10
+ };
11
+ }
12
+ export interface ExperimentManifest {
13
+ version: string;
14
+ updatedAt: string;
15
+ experiments: Record<string, ManifestExperiment>;
16
+ }
17
+ export interface ManifestLoaderOptions {
18
+ /** admin-server endpoint(绝对 URL) */
19
+ endpoint: string;
20
+ /** 拉取间隔 ms;默认 60_000 */
21
+ refreshIntervalMs?: number;
22
+ /** 拉取失败回退策略 */
23
+ fallbackOnError?: 'cache' | 'static' | 'empty';
24
+ /** 鉴权头(Bearer / API key 之类) */
25
+ authHeader?: {
26
+ name: string;
27
+ value: string;
28
+ };
29
+ /** 测试用 fetcher */
30
+ fetcher?: typeof fetch;
31
+ /** 静态配置(fallback='static' 时用) */
32
+ staticExperiments?: Record<string, RuntimeExperimentConfig>;
33
+ }
34
+ /**
35
+ * 把 manifest 里的实验定义归一化为 engine 内部用的 RuntimeExperimentConfig。
36
+ * killed / paused / concluded 状态的实验:**weights 强制变成 [100, 0, 0, ...]**,
37
+ * 让所有用户回 control。不直接从 effective experiments 里剔除,保留 cacheTag /
38
+ * exposure 上报能力(哪怕全部走 control,也能记录"实验在跑且强制 control")。
39
+ */
40
+ export declare function normalizeManifestExperiments(experiments: Record<string, ManifestExperiment>): Record<string, RuntimeExperimentConfig>;
41
+ export declare function createManifestLoader(options: ManifestLoaderOptions): {
42
+ /** 立即拉一次(启动期同步等待 + 后续异步轮询) */
43
+ init(): Promise<void>;
44
+ /**
45
+ * 读取当前快照 —— 同步返回 ABVariantMiddleware 用。
46
+ * 永远返回非 null(最差是 empty);调用方不用 null 检查。
47
+ */
48
+ getCurrent(): Record<string, RuntimeExperimentConfig>;
49
+ /** 销毁 loader(清定时器) */
50
+ destroy(): void;
51
+ };
52
+ export type ManifestLoaderInstance = ReturnType<typeof createManifestLoader>;
53
+ /**
54
+ * 解析配置,决定是否创建 loader 实例。配置缺失 / 无 endpoint 返回 null。
55
+ */
56
+ export declare function resolveManifestLoader(config: RuntimeExperimentManifestConfig | undefined, staticExperiments: Record<string, RuntimeExperimentConfig>, baseOrigin: string | undefined): ManifestLoaderInstance | null;
57
+ //# sourceMappingURL=ManifestLoader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ManifestLoader.d.ts","sourceRoot":"","sources":["../../src/experiments/ManifestLoader.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAInG,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IACvD,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe;IACf,eAAe,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC/C,+BAA+B;IAC/B,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,kBAAkB;IAClB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CAC7D;AAYD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC9C,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAazC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB;IAyF/D,8BAA8B;YAChB,OAAO,CAAC,IAAI,CAAC;IAK3B;;;OAGG;kBACW,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC;IAIrD,sBAAsB;eACX,IAAI;EAQlB;AAED,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE7E;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,+BAA+B,GAAG,SAAS,EACnD,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,EAC1D,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,sBAAsB,GAAG,IAAI,CAmB/B"}
@@ -0,0 +1,244 @@
1
+ const require_rolldown_runtime = require("./rolldown-runtime-DakpK96I.cjs");
2
+ //#region src/utils/cookie.ts
3
+ function getCookieHeader(source) {
4
+ if (!source) return "";
5
+ if (typeof source === "string") return source;
6
+ const headers = source.headers;
7
+ if (!headers) return "";
8
+ if (typeof headers.get === "function") return headers.get("cookie") ?? "";
9
+ const record = headers;
10
+ const raw = record.cookie ?? record.Cookie;
11
+ if (Array.isArray(raw)) return raw.join("; ");
12
+ return raw === void 0 || raw === null ? "" : String(raw);
13
+ }
14
+ function readCookie(source, name) {
15
+ if (!name) return void 0;
16
+ return parseCookieHeader(getCookieHeader(source))[name];
17
+ }
18
+ function parseCookieHeader(header) {
19
+ const cookies = Object.create(null);
20
+ if (!header) return cookies;
21
+ for (const part of header.split(";")) {
22
+ const trimmed = part.trim();
23
+ if (!trimmed) continue;
24
+ const index = trimmed.indexOf("=");
25
+ if (index <= 0) continue;
26
+ const key = trimmed.slice(0, index).trim();
27
+ if (!key) continue;
28
+ cookies[key] = safeDecodeCookieValue(trimmed.slice(index + 1).trim());
29
+ }
30
+ return cookies;
31
+ }
32
+ function safeDecodeCookieValue(value) {
33
+ try {
34
+ return decodeURIComponent(value);
35
+ } catch {
36
+ return value;
37
+ }
38
+ }
39
+ //#endregion
40
+ //#region src/utils/trimTrailingSlashes.ts
41
+ /** Remove only the trailing slash run; each character is inspected at most once. */
42
+ function trimTrailingSlashes(value) {
43
+ let end = value.length;
44
+ while (end > 0 && value[end - 1] === "/") end--;
45
+ return value.slice(0, end);
46
+ }
47
+ //#endregion
48
+ //#region src/runtime/i18n.ts
49
+ /**
50
+ * i18n 路由工具 —— URL 前缀自动处理(无 React 依赖,server + client 通用)
51
+ *
52
+ * 业务侧用法:
53
+ *
54
+ * import { parseLocale, withLocale, negotiateLocale } from 'isr-engine/runtime';
55
+ *
56
+ * const I18N = { locales: ['zh', 'en'] as const, defaultLocale: 'zh' };
57
+ *
58
+ * // SSR 入口:从 URL 拆 locale + 干净 pathname 给路由
59
+ * const { locale, pathname } = parseLocale(url.pathname, I18N);
60
+ * return <Layout lang={locale}>{resolveRoute({ pathname, locale })}</Layout>;
61
+ *
62
+ * // Header 切换语言
63
+ * const href = withLocale('/books/1', 'en', I18N); // → '/en/books/1'
64
+ * const href = withLocale('/books/1', 'zh', I18N); // → '/books/1'(默认 locale 不前缀)
65
+ *
66
+ * // 服务器协商:Accept-Language 头 → locale
67
+ * const locale = negotiateLocale(req.headers.get('accept-language'), I18N);
68
+ *
69
+ * 设计取舍:
70
+ * - 默认 locale 不带前缀('/about'),其他 locale 带('/en/about')
71
+ * → 与 Next.js i18n routing 默认 + Vue I18n 一致;SEO 友好(默认语言 URL 简洁)
72
+ * - 用 `prefixDefault: true` 切到"全部带前缀"模式(如 '/zh/about')
73
+ * - 不内置消息字典 / 翻译机制 —— 那是 react-intl / FormatJS / lingui 的活
74
+ */
75
+ var i18n_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
76
+ negotiateLocale: () => negotiateLocale,
77
+ parseLocale: () => parseLocale,
78
+ resolveI18nConfig: () => resolveI18nConfig,
79
+ withLocale: () => withLocale
80
+ });
81
+ /**
82
+ * 从 pathname 拆出 locale 与业务 pathname
83
+ *
84
+ * '/zh/books/1' + { locales: ['zh','en'], defaultLocale: 'en' }
85
+ * → { locale: 'zh', pathname: '/books/1', hasPrefix: true }
86
+ *
87
+ * '/books/1' 同上
88
+ * → { locale: 'en', pathname: '/books/1', hasPrefix: false }
89
+ */
90
+ function parseLocale(pathname, config) {
91
+ const segments = pathname.split("/");
92
+ const first = segments[1];
93
+ if (first && config.locales.includes(first)) {
94
+ const rest = "/" + segments.slice(2).join("/");
95
+ return {
96
+ locale: first,
97
+ pathname: rest === "/" ? "/" : trimTrailingSlashes(rest),
98
+ hasPrefix: true
99
+ };
100
+ }
101
+ return {
102
+ locale: config.defaultLocale,
103
+ pathname: pathname || "/",
104
+ hasPrefix: false
105
+ };
106
+ }
107
+ /**
108
+ * 给业务 pathname 套上 locale 前缀(生成可跳转 URL)
109
+ *
110
+ * withLocale('/about', 'en', { defaultLocale: 'zh', locales: ['zh','en'] })
111
+ * → '/en/about'
112
+ *
113
+ * withLocale('/about', 'zh', { defaultLocale: 'zh', locales: ['zh','en'] })
114
+ * → '/about' (默认 locale 不前缀)
115
+ *
116
+ * withLocale('/about', 'zh', { ..., prefixDefault: true })
117
+ * → '/zh/about'
118
+ */
119
+ function withLocale(pathname, locale, config) {
120
+ if (!config.locales.includes(locale)) throw new Error(`[i18n] unknown locale "${locale}"; allowed: ${config.locales.join(", ")}`);
121
+ const clean = pathname.startsWith("/") ? pathname : "/" + pathname;
122
+ if (locale === config.defaultLocale && !config.prefixDefault) return clean;
123
+ return `/${locale}${clean === "/" ? "" : clean}`;
124
+ }
125
+ /**
126
+ * Accept-Language 协商 —— RFC 4647 lookup(含主语言回退)
127
+ *
128
+ * negotiateLocale('zh-CN,en;q=0.9', { locales: ['zh','en'], defaultLocale: 'en' })
129
+ * → 'zh' ('zh-CN' 命中 'zh')
130
+ *
131
+ * negotiateLocale('en-GB', { locales: ['zh-hans','en-us'], defaultLocale: 'zh-hans' })
132
+ * → 'en-us' ('en-GB' 主语言 'en' 回退到第一个 en-*)
133
+ *
134
+ * negotiateLocale(null, ...) → defaultLocale
135
+ */
136
+ function negotiateLocale(acceptLanguage, config) {
137
+ if (!acceptLanguage) return config.defaultLocale;
138
+ const ranked = acceptLanguage.split(",").map((part) => {
139
+ const [tag, ...params] = part.trim().split(";");
140
+ const q = params.find((p) => p.startsWith("q="));
141
+ return {
142
+ tag: tag.toLowerCase(),
143
+ q: q ? Number(q.slice(2)) || 0 : 1
144
+ };
145
+ }).sort((a, b) => b.q - a.q);
146
+ const supported = config.locales.map((l) => l.toLowerCase());
147
+ for (const { tag } of ranked) {
148
+ const exact = supported.indexOf(tag);
149
+ if (exact >= 0) return config.locales[exact];
150
+ const primary = tag.split("-")[0];
151
+ const sub = supported.indexOf(primary);
152
+ if (sub >= 0) return config.locales[sub];
153
+ const primaryPrefix = supported.findIndex((l) => l.startsWith(primary + "-"));
154
+ if (primaryPrefix >= 0) return config.locales[primaryPrefix];
155
+ }
156
+ return config.defaultLocale;
157
+ }
158
+ /**
159
+ * 从 SiteHooks 的 intl 字段提取 URL 路由配置并填默认值
160
+ *
161
+ * 用途:消除消费者侧 `app.tsx` 里那段「从 siteHooks.intl 抠出 locales/defaultLocale/prefixDefault
162
+ * 再补默认值组装 I18nConfig」的重复样板。
163
+ *
164
+ * // before
165
+ * const intl = siteHooks.intl ?? {};
166
+ * const I18N: I18nConfig = {
167
+ * locales: intl.locales ?? ['en'],
168
+ * defaultLocale: intl.defaultLocale ?? 'en',
169
+ * prefixDefault: intl.prefixDefault,
170
+ * };
171
+ *
172
+ * // after
173
+ * const I18N = resolveI18nConfig(siteHooks.intl);
174
+ *
175
+ * 行为:
176
+ * - 缺省 → `{ locales: ['en'], defaultLocale: 'en' }`(单语言英文兜底)
177
+ * - locales 给了但 defaultLocale 没给 → 取 locales[0]
178
+ * - 多余字段(endpoint / load / ttl / detect)忽略,只挑 URL 路由相关
179
+ */
180
+ function resolveI18nConfig(intl) {
181
+ const locales = intl?.locales && intl.locales.length > 0 ? intl.locales : ["en"];
182
+ return {
183
+ locales,
184
+ defaultLocale: intl?.defaultLocale ?? locales[0],
185
+ prefixDefault: intl?.prefixDefault
186
+ };
187
+ }
188
+ //#endregion
189
+ Object.defineProperty(exports, "getCookieHeader", {
190
+ enumerable: true,
191
+ get: function() {
192
+ return getCookieHeader;
193
+ }
194
+ });
195
+ Object.defineProperty(exports, "i18n_exports", {
196
+ enumerable: true,
197
+ get: function() {
198
+ return i18n_exports;
199
+ }
200
+ });
201
+ Object.defineProperty(exports, "negotiateLocale", {
202
+ enumerable: true,
203
+ get: function() {
204
+ return negotiateLocale;
205
+ }
206
+ });
207
+ Object.defineProperty(exports, "parseCookieHeader", {
208
+ enumerable: true,
209
+ get: function() {
210
+ return parseCookieHeader;
211
+ }
212
+ });
213
+ Object.defineProperty(exports, "parseLocale", {
214
+ enumerable: true,
215
+ get: function() {
216
+ return parseLocale;
217
+ }
218
+ });
219
+ Object.defineProperty(exports, "readCookie", {
220
+ enumerable: true,
221
+ get: function() {
222
+ return readCookie;
223
+ }
224
+ });
225
+ Object.defineProperty(exports, "resolveI18nConfig", {
226
+ enumerable: true,
227
+ get: function() {
228
+ return resolveI18nConfig;
229
+ }
230
+ });
231
+ Object.defineProperty(exports, "trimTrailingSlashes", {
232
+ enumerable: true,
233
+ get: function() {
234
+ return trimTrailingSlashes;
235
+ }
236
+ });
237
+ Object.defineProperty(exports, "withLocale", {
238
+ enumerable: true,
239
+ get: function() {
240
+ return withLocale;
241
+ }
242
+ });
243
+
244
+ //# sourceMappingURL=i18n-CyJIoYJT.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"i18n-CyJIoYJT.cjs","names":[],"sources":["../src/utils/cookie.ts","../src/utils/trimTrailingSlashes.ts","../src/runtime/i18n.ts"],"sourcesContent":["export type CookieHeaderSource =\n | string\n | null\n | undefined\n | {\n headers?: Headers | Record<string, string | string[] | number | undefined | null>;\n };\n\nexport function getCookieHeader(source: CookieHeaderSource): string {\n if (!source) return '';\n if (typeof source === 'string') return source;\n\n const headers = source.headers;\n if (!headers) return '';\n\n if (typeof (headers as Headers).get === 'function') {\n return (headers as Headers).get('cookie') ?? '';\n }\n\n const record = headers as Record<string, string | string[] | number | undefined | null>;\n const raw = record.cookie ?? record.Cookie;\n if (Array.isArray(raw)) return raw.join('; ');\n return raw === undefined || raw === null ? '' : String(raw);\n}\n\nexport function readCookie(source: CookieHeaderSource, name: string): string | undefined {\n if (!name) return undefined;\n const cookies = parseCookieHeader(getCookieHeader(source));\n return cookies[name];\n}\n\nexport function parseCookieHeader(header: string): Record<string, string> {\n const cookies: Record<string, string> = Object.create(null);\n if (!header) return cookies;\n\n for (const part of header.split(';')) {\n const trimmed = part.trim();\n if (!trimmed) continue;\n\n const index = trimmed.indexOf('=');\n if (index <= 0) continue;\n\n const key = trimmed.slice(0, index).trim();\n if (!key) continue;\n\n const rawValue = trimmed.slice(index + 1).trim();\n cookies[key] = safeDecodeCookieValue(rawValue);\n }\n\n return cookies;\n}\n\nfunction safeDecodeCookieValue(value: string): string {\n try {\n return decodeURIComponent(value);\n } catch {\n return value;\n }\n}\n","/** Remove only the trailing slash run; each character is inspected at most once. */\nexport function trimTrailingSlashes(value: string): string {\n let end = value.length;\n while (end > 0 && value[end - 1] === '/') end--;\n return value.slice(0, end);\n}\n","/**\n * i18n 路由工具 —— URL 前缀自动处理(无 React 依赖,server + client 通用)\n *\n * 业务侧用法:\n *\n * import { parseLocale, withLocale, negotiateLocale } from 'isr-engine/runtime';\n *\n * const I18N = { locales: ['zh', 'en'] as const, defaultLocale: 'zh' };\n *\n * // SSR 入口:从 URL 拆 locale + 干净 pathname 给路由\n * const { locale, pathname } = parseLocale(url.pathname, I18N);\n * return <Layout lang={locale}>{resolveRoute({ pathname, locale })}</Layout>;\n *\n * // Header 切换语言\n * const href = withLocale('/books/1', 'en', I18N); // → '/en/books/1'\n * const href = withLocale('/books/1', 'zh', I18N); // → '/books/1'(默认 locale 不前缀)\n *\n * // 服务器协商:Accept-Language 头 → locale\n * const locale = negotiateLocale(req.headers.get('accept-language'), I18N);\n *\n * 设计取舍:\n * - 默认 locale 不带前缀('/about'),其他 locale 带('/en/about')\n * → 与 Next.js i18n routing 默认 + Vue I18n 一致;SEO 友好(默认语言 URL 简洁)\n * - 用 `prefixDefault: true` 切到\"全部带前缀\"模式(如 '/zh/about')\n * - 不内置消息字典 / 翻译机制 —— 那是 react-intl / FormatJS / lingui 的活\n */\n\nimport { trimTrailingSlashes } from '../utils/trimTrailingSlashes';\nexport interface I18nConfig {\n /** 支持的 locale 列表,如 ['zh', 'en', 'ja'] */\n locales: readonly string[];\n /** 默认 locale —— 必须在 locales 内 */\n defaultLocale: string;\n /** 是否给默认 locale 也加 URL 前缀(默认 false:'/about';true:'/zh/about') */\n prefixDefault?: boolean;\n}\n\nexport interface ParsedLocale {\n /** 解析出的 locale(命中 URL 前缀则取前缀,否则取 defaultLocale) */\n locale: string;\n /** 去掉 locale 前缀后的\"业务 pathname\",路由表只需匹配这个 */\n pathname: string;\n /** URL 是否真的带了 locale 前缀 */\n hasPrefix: boolean;\n}\n\n/**\n * 从 pathname 拆出 locale 与业务 pathname\n *\n * '/zh/books/1' + { locales: ['zh','en'], defaultLocale: 'en' }\n * → { locale: 'zh', pathname: '/books/1', hasPrefix: true }\n *\n * '/books/1' 同上\n * → { locale: 'en', pathname: '/books/1', hasPrefix: false }\n */\nexport function parseLocale(pathname: string, config: I18nConfig): ParsedLocale {\n const segments = pathname.split('/');\n // segments[0] 是空串(leading '/'),segments[1] 才是首段\n const first = segments[1];\n if (first && config.locales.includes(first)) {\n const rest = '/' + segments.slice(2).join('/');\n return {\n locale: first,\n pathname: rest === '/' ? '/' : trimTrailingSlashes(rest),\n hasPrefix: true,\n };\n }\n return { locale: config.defaultLocale, pathname: pathname || '/', hasPrefix: false };\n}\n\n/**\n * 给业务 pathname 套上 locale 前缀(生成可跳转 URL)\n *\n * withLocale('/about', 'en', { defaultLocale: 'zh', locales: ['zh','en'] })\n * → '/en/about'\n *\n * withLocale('/about', 'zh', { defaultLocale: 'zh', locales: ['zh','en'] })\n * → '/about' (默认 locale 不前缀)\n *\n * withLocale('/about', 'zh', { ..., prefixDefault: true })\n * → '/zh/about'\n */\nexport function withLocale(pathname: string, locale: string, config: I18nConfig): string {\n if (!config.locales.includes(locale)) {\n throw new Error(`[i18n] unknown locale \"${locale}\"; allowed: ${config.locales.join(', ')}`);\n }\n const clean = pathname.startsWith('/') ? pathname : '/' + pathname;\n if (locale === config.defaultLocale && !config.prefixDefault) return clean;\n return `/${locale}${clean === '/' ? '' : clean}`;\n}\n\n/**\n * Accept-Language 协商 —— RFC 4647 lookup(含主语言回退)\n *\n * negotiateLocale('zh-CN,en;q=0.9', { locales: ['zh','en'], defaultLocale: 'en' })\n * → 'zh' ('zh-CN' 命中 'zh')\n *\n * negotiateLocale('en-GB', { locales: ['zh-hans','en-us'], defaultLocale: 'zh-hans' })\n * → 'en-us' ('en-GB' 主语言 'en' 回退到第一个 en-*)\n *\n * negotiateLocale(null, ...) → defaultLocale\n */\nexport function negotiateLocale(\n acceptLanguage: string | null | undefined,\n config: I18nConfig\n): string {\n if (!acceptLanguage) return config.defaultLocale;\n const ranked = acceptLanguage\n .split(',')\n .map(part => {\n const [tag, ...params] = part.trim().split(';');\n const q = params.find(p => p.startsWith('q='));\n return { tag: tag.toLowerCase(), q: q ? Number(q.slice(2)) || 0 : 1 };\n })\n .sort((a, b) => b.q - a.q);\n\n const supported = config.locales.map(l => l.toLowerCase());\n for (const { tag } of ranked) {\n // 1) 完整 code 精确匹配('en-us' === 'en-us')\n const exact = supported.indexOf(tag);\n if (exact >= 0) return config.locales[exact];\n\n const primary = tag.split('-')[0];\n\n // 2) 主语言精确匹配('ja' === 'ja',针对无地区后缀的 locale 如 ja/fr/tr)\n const sub = supported.indexOf(primary);\n if (sub >= 0) return config.locales[sub];\n\n // 3) 主语言回退('en' / 'en-GB' → 第一个 en-*;'zh' / 'zh-CN' → zh-hans)\n // 解决「浏览器只发 en / en-GB,而 locales 是 en-us/en-au」这类地区码不匹配问题。\n const primaryPrefix = supported.findIndex(l => l.startsWith(primary + '-'));\n if (primaryPrefix >= 0) return config.locales[primaryPrefix];\n }\n return config.defaultLocale;\n}\n\n/**\n * 列出某业务 pathname 在所有 locale 下的 URL —— 用于 <link rel=\"alternate\" hreflang>\n *\n * alternates('/about', { locales: ['zh','en'], defaultLocale: 'zh' })\n * → [{ hreflang: 'zh', href: '/about' }, { hreflang: 'en', href: '/en/about' }]\n */\nexport function alternates(\n pathname: string,\n config: I18nConfig\n): Array<{ hreflang: string; href: string }> {\n return config.locales.map(locale => ({\n hreflang: locale,\n href: withLocale(pathname, locale, config),\n }));\n}\n\n/**\n * 从 SiteHooks 的 intl 字段提取 URL 路由配置并填默认值\n *\n * 用途:消除消费者侧 `app.tsx` 里那段「从 siteHooks.intl 抠出 locales/defaultLocale/prefixDefault\n * 再补默认值组装 I18nConfig」的重复样板。\n *\n * // before\n * const intl = siteHooks.intl ?? {};\n * const I18N: I18nConfig = {\n * locales: intl.locales ?? ['en'],\n * defaultLocale: intl.defaultLocale ?? 'en',\n * prefixDefault: intl.prefixDefault,\n * };\n *\n * // after\n * const I18N = resolveI18nConfig(siteHooks.intl);\n *\n * 行为:\n * - 缺省 → `{ locales: ['en'], defaultLocale: 'en' }`(单语言英文兜底)\n * - locales 给了但 defaultLocale 没给 → 取 locales[0]\n * - 多余字段(endpoint / load / ttl / detect)忽略,只挑 URL 路由相关\n */\nexport function resolveI18nConfig(\n intl?: {\n locales?: readonly string[];\n defaultLocale?: string;\n prefixDefault?: boolean;\n } | null\n): I18nConfig {\n const locales = intl?.locales && intl.locales.length > 0 ? intl.locales : ['en'];\n const defaultLocale = intl?.defaultLocale ?? locales[0];\n return {\n locales,\n defaultLocale,\n prefixDefault: intl?.prefixDefault,\n };\n}\n"],"mappings":"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"}
@@ -0,0 +1,191 @@
1
+ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
2
+ //#region src/utils/cookie.ts
3
+ function getCookieHeader(source) {
4
+ if (!source) return "";
5
+ if (typeof source === "string") return source;
6
+ const headers = source.headers;
7
+ if (!headers) return "";
8
+ if (typeof headers.get === "function") return headers.get("cookie") ?? "";
9
+ const record = headers;
10
+ const raw = record.cookie ?? record.Cookie;
11
+ if (Array.isArray(raw)) return raw.join("; ");
12
+ return raw === void 0 || raw === null ? "" : String(raw);
13
+ }
14
+ function readCookie(source, name) {
15
+ if (!name) return void 0;
16
+ return parseCookieHeader(getCookieHeader(source))[name];
17
+ }
18
+ function parseCookieHeader(header) {
19
+ const cookies = Object.create(null);
20
+ if (!header) return cookies;
21
+ for (const part of header.split(";")) {
22
+ const trimmed = part.trim();
23
+ if (!trimmed) continue;
24
+ const index = trimmed.indexOf("=");
25
+ if (index <= 0) continue;
26
+ const key = trimmed.slice(0, index).trim();
27
+ if (!key) continue;
28
+ cookies[key] = safeDecodeCookieValue(trimmed.slice(index + 1).trim());
29
+ }
30
+ return cookies;
31
+ }
32
+ function safeDecodeCookieValue(value) {
33
+ try {
34
+ return decodeURIComponent(value);
35
+ } catch {
36
+ return value;
37
+ }
38
+ }
39
+ //#endregion
40
+ //#region src/utils/trimTrailingSlashes.ts
41
+ /** Remove only the trailing slash run; each character is inspected at most once. */
42
+ function trimTrailingSlashes(value) {
43
+ let end = value.length;
44
+ while (end > 0 && value[end - 1] === "/") end--;
45
+ return value.slice(0, end);
46
+ }
47
+ //#endregion
48
+ //#region src/runtime/i18n.ts
49
+ /**
50
+ * i18n 路由工具 —— URL 前缀自动处理(无 React 依赖,server + client 通用)
51
+ *
52
+ * 业务侧用法:
53
+ *
54
+ * import { parseLocale, withLocale, negotiateLocale } from 'isr-engine/runtime';
55
+ *
56
+ * const I18N = { locales: ['zh', 'en'] as const, defaultLocale: 'zh' };
57
+ *
58
+ * // SSR 入口:从 URL 拆 locale + 干净 pathname 给路由
59
+ * const { locale, pathname } = parseLocale(url.pathname, I18N);
60
+ * return <Layout lang={locale}>{resolveRoute({ pathname, locale })}</Layout>;
61
+ *
62
+ * // Header 切换语言
63
+ * const href = withLocale('/books/1', 'en', I18N); // → '/en/books/1'
64
+ * const href = withLocale('/books/1', 'zh', I18N); // → '/books/1'(默认 locale 不前缀)
65
+ *
66
+ * // 服务器协商:Accept-Language 头 → locale
67
+ * const locale = negotiateLocale(req.headers.get('accept-language'), I18N);
68
+ *
69
+ * 设计取舍:
70
+ * - 默认 locale 不带前缀('/about'),其他 locale 带('/en/about')
71
+ * → 与 Next.js i18n routing 默认 + Vue I18n 一致;SEO 友好(默认语言 URL 简洁)
72
+ * - 用 `prefixDefault: true` 切到"全部带前缀"模式(如 '/zh/about')
73
+ * - 不内置消息字典 / 翻译机制 —— 那是 react-intl / FormatJS / lingui 的活
74
+ */
75
+ var i18n_exports = /* @__PURE__ */ __exportAll({
76
+ negotiateLocale: () => negotiateLocale,
77
+ parseLocale: () => parseLocale,
78
+ resolveI18nConfig: () => resolveI18nConfig,
79
+ withLocale: () => withLocale
80
+ });
81
+ /**
82
+ * 从 pathname 拆出 locale 与业务 pathname
83
+ *
84
+ * '/zh/books/1' + { locales: ['zh','en'], defaultLocale: 'en' }
85
+ * → { locale: 'zh', pathname: '/books/1', hasPrefix: true }
86
+ *
87
+ * '/books/1' 同上
88
+ * → { locale: 'en', pathname: '/books/1', hasPrefix: false }
89
+ */
90
+ function parseLocale(pathname, config) {
91
+ const segments = pathname.split("/");
92
+ const first = segments[1];
93
+ if (first && config.locales.includes(first)) {
94
+ const rest = "/" + segments.slice(2).join("/");
95
+ return {
96
+ locale: first,
97
+ pathname: rest === "/" ? "/" : trimTrailingSlashes(rest),
98
+ hasPrefix: true
99
+ };
100
+ }
101
+ return {
102
+ locale: config.defaultLocale,
103
+ pathname: pathname || "/",
104
+ hasPrefix: false
105
+ };
106
+ }
107
+ /**
108
+ * 给业务 pathname 套上 locale 前缀(生成可跳转 URL)
109
+ *
110
+ * withLocale('/about', 'en', { defaultLocale: 'zh', locales: ['zh','en'] })
111
+ * → '/en/about'
112
+ *
113
+ * withLocale('/about', 'zh', { defaultLocale: 'zh', locales: ['zh','en'] })
114
+ * → '/about' (默认 locale 不前缀)
115
+ *
116
+ * withLocale('/about', 'zh', { ..., prefixDefault: true })
117
+ * → '/zh/about'
118
+ */
119
+ function withLocale(pathname, locale, config) {
120
+ if (!config.locales.includes(locale)) throw new Error(`[i18n] unknown locale "${locale}"; allowed: ${config.locales.join(", ")}`);
121
+ const clean = pathname.startsWith("/") ? pathname : "/" + pathname;
122
+ if (locale === config.defaultLocale && !config.prefixDefault) return clean;
123
+ return `/${locale}${clean === "/" ? "" : clean}`;
124
+ }
125
+ /**
126
+ * Accept-Language 协商 —— RFC 4647 lookup(含主语言回退)
127
+ *
128
+ * negotiateLocale('zh-CN,en;q=0.9', { locales: ['zh','en'], defaultLocale: 'en' })
129
+ * → 'zh' ('zh-CN' 命中 'zh')
130
+ *
131
+ * negotiateLocale('en-GB', { locales: ['zh-hans','en-us'], defaultLocale: 'zh-hans' })
132
+ * → 'en-us' ('en-GB' 主语言 'en' 回退到第一个 en-*)
133
+ *
134
+ * negotiateLocale(null, ...) → defaultLocale
135
+ */
136
+ function negotiateLocale(acceptLanguage, config) {
137
+ if (!acceptLanguage) return config.defaultLocale;
138
+ const ranked = acceptLanguage.split(",").map((part) => {
139
+ const [tag, ...params] = part.trim().split(";");
140
+ const q = params.find((p) => p.startsWith("q="));
141
+ return {
142
+ tag: tag.toLowerCase(),
143
+ q: q ? Number(q.slice(2)) || 0 : 1
144
+ };
145
+ }).sort((a, b) => b.q - a.q);
146
+ const supported = config.locales.map((l) => l.toLowerCase());
147
+ for (const { tag } of ranked) {
148
+ const exact = supported.indexOf(tag);
149
+ if (exact >= 0) return config.locales[exact];
150
+ const primary = tag.split("-")[0];
151
+ const sub = supported.indexOf(primary);
152
+ if (sub >= 0) return config.locales[sub];
153
+ const primaryPrefix = supported.findIndex((l) => l.startsWith(primary + "-"));
154
+ if (primaryPrefix >= 0) return config.locales[primaryPrefix];
155
+ }
156
+ return config.defaultLocale;
157
+ }
158
+ /**
159
+ * 从 SiteHooks 的 intl 字段提取 URL 路由配置并填默认值
160
+ *
161
+ * 用途:消除消费者侧 `app.tsx` 里那段「从 siteHooks.intl 抠出 locales/defaultLocale/prefixDefault
162
+ * 再补默认值组装 I18nConfig」的重复样板。
163
+ *
164
+ * // before
165
+ * const intl = siteHooks.intl ?? {};
166
+ * const I18N: I18nConfig = {
167
+ * locales: intl.locales ?? ['en'],
168
+ * defaultLocale: intl.defaultLocale ?? 'en',
169
+ * prefixDefault: intl.prefixDefault,
170
+ * };
171
+ *
172
+ * // after
173
+ * const I18N = resolveI18nConfig(siteHooks.intl);
174
+ *
175
+ * 行为:
176
+ * - 缺省 → `{ locales: ['en'], defaultLocale: 'en' }`(单语言英文兜底)
177
+ * - locales 给了但 defaultLocale 没给 → 取 locales[0]
178
+ * - 多余字段(endpoint / load / ttl / detect)忽略,只挑 URL 路由相关
179
+ */
180
+ function resolveI18nConfig(intl) {
181
+ const locales = intl?.locales && intl.locales.length > 0 ? intl.locales : ["en"];
182
+ return {
183
+ locales,
184
+ defaultLocale: intl?.defaultLocale ?? locales[0],
185
+ prefixDefault: intl?.prefixDefault
186
+ };
187
+ }
188
+ //#endregion
189
+ export { withLocale as a, parseCookieHeader as c, resolveI18nConfig as i, readCookie as l, negotiateLocale as n, trimTrailingSlashes as o, parseLocale as r, getCookieHeader as s, i18n_exports as t };
190
+
191
+ //# sourceMappingURL=i18n-Dobe0Wxn.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"i18n-Dobe0Wxn.js","names":[],"sources":["../src/utils/cookie.ts","../src/utils/trimTrailingSlashes.ts","../src/runtime/i18n.ts"],"sourcesContent":["export type CookieHeaderSource =\n | string\n | null\n | undefined\n | {\n headers?: Headers | Record<string, string | string[] | number | undefined | null>;\n };\n\nexport function getCookieHeader(source: CookieHeaderSource): string {\n if (!source) return '';\n if (typeof source === 'string') return source;\n\n const headers = source.headers;\n if (!headers) return '';\n\n if (typeof (headers as Headers).get === 'function') {\n return (headers as Headers).get('cookie') ?? '';\n }\n\n const record = headers as Record<string, string | string[] | number | undefined | null>;\n const raw = record.cookie ?? record.Cookie;\n if (Array.isArray(raw)) return raw.join('; ');\n return raw === undefined || raw === null ? '' : String(raw);\n}\n\nexport function readCookie(source: CookieHeaderSource, name: string): string | undefined {\n if (!name) return undefined;\n const cookies = parseCookieHeader(getCookieHeader(source));\n return cookies[name];\n}\n\nexport function parseCookieHeader(header: string): Record<string, string> {\n const cookies: Record<string, string> = Object.create(null);\n if (!header) return cookies;\n\n for (const part of header.split(';')) {\n const trimmed = part.trim();\n if (!trimmed) continue;\n\n const index = trimmed.indexOf('=');\n if (index <= 0) continue;\n\n const key = trimmed.slice(0, index).trim();\n if (!key) continue;\n\n const rawValue = trimmed.slice(index + 1).trim();\n cookies[key] = safeDecodeCookieValue(rawValue);\n }\n\n return cookies;\n}\n\nfunction safeDecodeCookieValue(value: string): string {\n try {\n return decodeURIComponent(value);\n } catch {\n return value;\n }\n}\n","/** Remove only the trailing slash run; each character is inspected at most once. */\nexport function trimTrailingSlashes(value: string): string {\n let end = value.length;\n while (end > 0 && value[end - 1] === '/') end--;\n return value.slice(0, end);\n}\n","/**\n * i18n 路由工具 —— URL 前缀自动处理(无 React 依赖,server + client 通用)\n *\n * 业务侧用法:\n *\n * import { parseLocale, withLocale, negotiateLocale } from 'isr-engine/runtime';\n *\n * const I18N = { locales: ['zh', 'en'] as const, defaultLocale: 'zh' };\n *\n * // SSR 入口:从 URL 拆 locale + 干净 pathname 给路由\n * const { locale, pathname } = parseLocale(url.pathname, I18N);\n * return <Layout lang={locale}>{resolveRoute({ pathname, locale })}</Layout>;\n *\n * // Header 切换语言\n * const href = withLocale('/books/1', 'en', I18N); // → '/en/books/1'\n * const href = withLocale('/books/1', 'zh', I18N); // → '/books/1'(默认 locale 不前缀)\n *\n * // 服务器协商:Accept-Language 头 → locale\n * const locale = negotiateLocale(req.headers.get('accept-language'), I18N);\n *\n * 设计取舍:\n * - 默认 locale 不带前缀('/about'),其他 locale 带('/en/about')\n * → 与 Next.js i18n routing 默认 + Vue I18n 一致;SEO 友好(默认语言 URL 简洁)\n * - 用 `prefixDefault: true` 切到\"全部带前缀\"模式(如 '/zh/about')\n * - 不内置消息字典 / 翻译机制 —— 那是 react-intl / FormatJS / lingui 的活\n */\n\nimport { trimTrailingSlashes } from '../utils/trimTrailingSlashes';\nexport interface I18nConfig {\n /** 支持的 locale 列表,如 ['zh', 'en', 'ja'] */\n locales: readonly string[];\n /** 默认 locale —— 必须在 locales 内 */\n defaultLocale: string;\n /** 是否给默认 locale 也加 URL 前缀(默认 false:'/about';true:'/zh/about') */\n prefixDefault?: boolean;\n}\n\nexport interface ParsedLocale {\n /** 解析出的 locale(命中 URL 前缀则取前缀,否则取 defaultLocale) */\n locale: string;\n /** 去掉 locale 前缀后的\"业务 pathname\",路由表只需匹配这个 */\n pathname: string;\n /** URL 是否真的带了 locale 前缀 */\n hasPrefix: boolean;\n}\n\n/**\n * 从 pathname 拆出 locale 与业务 pathname\n *\n * '/zh/books/1' + { locales: ['zh','en'], defaultLocale: 'en' }\n * → { locale: 'zh', pathname: '/books/1', hasPrefix: true }\n *\n * '/books/1' 同上\n * → { locale: 'en', pathname: '/books/1', hasPrefix: false }\n */\nexport function parseLocale(pathname: string, config: I18nConfig): ParsedLocale {\n const segments = pathname.split('/');\n // segments[0] 是空串(leading '/'),segments[1] 才是首段\n const first = segments[1];\n if (first && config.locales.includes(first)) {\n const rest = '/' + segments.slice(2).join('/');\n return {\n locale: first,\n pathname: rest === '/' ? '/' : trimTrailingSlashes(rest),\n hasPrefix: true,\n };\n }\n return { locale: config.defaultLocale, pathname: pathname || '/', hasPrefix: false };\n}\n\n/**\n * 给业务 pathname 套上 locale 前缀(生成可跳转 URL)\n *\n * withLocale('/about', 'en', { defaultLocale: 'zh', locales: ['zh','en'] })\n * → '/en/about'\n *\n * withLocale('/about', 'zh', { defaultLocale: 'zh', locales: ['zh','en'] })\n * → '/about' (默认 locale 不前缀)\n *\n * withLocale('/about', 'zh', { ..., prefixDefault: true })\n * → '/zh/about'\n */\nexport function withLocale(pathname: string, locale: string, config: I18nConfig): string {\n if (!config.locales.includes(locale)) {\n throw new Error(`[i18n] unknown locale \"${locale}\"; allowed: ${config.locales.join(', ')}`);\n }\n const clean = pathname.startsWith('/') ? pathname : '/' + pathname;\n if (locale === config.defaultLocale && !config.prefixDefault) return clean;\n return `/${locale}${clean === '/' ? '' : clean}`;\n}\n\n/**\n * Accept-Language 协商 —— RFC 4647 lookup(含主语言回退)\n *\n * negotiateLocale('zh-CN,en;q=0.9', { locales: ['zh','en'], defaultLocale: 'en' })\n * → 'zh' ('zh-CN' 命中 'zh')\n *\n * negotiateLocale('en-GB', { locales: ['zh-hans','en-us'], defaultLocale: 'zh-hans' })\n * → 'en-us' ('en-GB' 主语言 'en' 回退到第一个 en-*)\n *\n * negotiateLocale(null, ...) → defaultLocale\n */\nexport function negotiateLocale(\n acceptLanguage: string | null | undefined,\n config: I18nConfig\n): string {\n if (!acceptLanguage) return config.defaultLocale;\n const ranked = acceptLanguage\n .split(',')\n .map(part => {\n const [tag, ...params] = part.trim().split(';');\n const q = params.find(p => p.startsWith('q='));\n return { tag: tag.toLowerCase(), q: q ? Number(q.slice(2)) || 0 : 1 };\n })\n .sort((a, b) => b.q - a.q);\n\n const supported = config.locales.map(l => l.toLowerCase());\n for (const { tag } of ranked) {\n // 1) 完整 code 精确匹配('en-us' === 'en-us')\n const exact = supported.indexOf(tag);\n if (exact >= 0) return config.locales[exact];\n\n const primary = tag.split('-')[0];\n\n // 2) 主语言精确匹配('ja' === 'ja',针对无地区后缀的 locale 如 ja/fr/tr)\n const sub = supported.indexOf(primary);\n if (sub >= 0) return config.locales[sub];\n\n // 3) 主语言回退('en' / 'en-GB' → 第一个 en-*;'zh' / 'zh-CN' → zh-hans)\n // 解决「浏览器只发 en / en-GB,而 locales 是 en-us/en-au」这类地区码不匹配问题。\n const primaryPrefix = supported.findIndex(l => l.startsWith(primary + '-'));\n if (primaryPrefix >= 0) return config.locales[primaryPrefix];\n }\n return config.defaultLocale;\n}\n\n/**\n * 列出某业务 pathname 在所有 locale 下的 URL —— 用于 <link rel=\"alternate\" hreflang>\n *\n * alternates('/about', { locales: ['zh','en'], defaultLocale: 'zh' })\n * → [{ hreflang: 'zh', href: '/about' }, { hreflang: 'en', href: '/en/about' }]\n */\nexport function alternates(\n pathname: string,\n config: I18nConfig\n): Array<{ hreflang: string; href: string }> {\n return config.locales.map(locale => ({\n hreflang: locale,\n href: withLocale(pathname, locale, config),\n }));\n}\n\n/**\n * 从 SiteHooks 的 intl 字段提取 URL 路由配置并填默认值\n *\n * 用途:消除消费者侧 `app.tsx` 里那段「从 siteHooks.intl 抠出 locales/defaultLocale/prefixDefault\n * 再补默认值组装 I18nConfig」的重复样板。\n *\n * // before\n * const intl = siteHooks.intl ?? {};\n * const I18N: I18nConfig = {\n * locales: intl.locales ?? ['en'],\n * defaultLocale: intl.defaultLocale ?? 'en',\n * prefixDefault: intl.prefixDefault,\n * };\n *\n * // after\n * const I18N = resolveI18nConfig(siteHooks.intl);\n *\n * 行为:\n * - 缺省 → `{ locales: ['en'], defaultLocale: 'en' }`(单语言英文兜底)\n * - locales 给了但 defaultLocale 没给 → 取 locales[0]\n * - 多余字段(endpoint / load / ttl / detect)忽略,只挑 URL 路由相关\n */\nexport function resolveI18nConfig(\n intl?: {\n locales?: readonly string[];\n defaultLocale?: string;\n prefixDefault?: boolean;\n } | null\n): I18nConfig {\n const locales = intl?.locales && intl.locales.length > 0 ? intl.locales : ['en'];\n const defaultLocale = intl?.defaultLocale ?? locales[0];\n return {\n locales,\n defaultLocale,\n prefixDefault: intl?.prefixDefault,\n };\n}\n"],"mappings":"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"}