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,744 @@
1
+ import {
2
+ DEV_STYLE_TRANSPORT_GENERATION_PARAM,
3
+ canonicalizeDevStyleId,
4
+ createDevStyleTransportHref,
5
+ getDevStyleTransportGeneration,
6
+ } from './dev-style-id';
7
+
8
+ const RSC_STYLESHEET = 'link[rel="stylesheet"][data-precedence^="vite-rsc/"]';
9
+ const DEV_STYLE_REGISTRY_INSPECT = Symbol.for('isr-engine.dev-style-registry.inspect');
10
+ const devStyleRegistries = new WeakMap<Document, DevStyleRegistry>();
11
+
12
+ type DevStyleState = 'ssr-active' | 'client-active' | 'updating' | 'pending-release' | 'released';
13
+
14
+ interface StyleRecord {
15
+ id: string;
16
+ state: DevStyleState;
17
+ node?: HTMLStyleElement;
18
+ ownedLink?: HTMLLinkElement;
19
+ cssText?: string;
20
+ pendingRelease: boolean;
21
+ }
22
+
23
+ export interface DevStyleRegistryOptions {
24
+ onRscCommit?(generation: number): void;
25
+ }
26
+
27
+ export interface DevStyleRegistry {
28
+ publish(id: string, cssText: string): void;
29
+ prune(id: string): void;
30
+ beginRscUpdate(generation: number): void;
31
+ declareRscStyles(generation: number, activeIds: Iterable<string>): void;
32
+ prepareRscStyles(generation: number, activeIds?: Iterable<string>): Promise<string[]>;
33
+ abortRscUpdate(generation: number): void;
34
+ beginUpdate(): void;
35
+ commitUpdate(activeIds?: Iterable<string>): void;
36
+ abortUpdate(): void;
37
+ reconcileDocumentStyles(generation: number, activeIds: Iterable<string>): void;
38
+ dispose(): void;
39
+ }
40
+
41
+ export function createDevStyleRegistry(
42
+ document: Document,
43
+ options: DevStyleRegistryOptions = {}
44
+ ): DevStyleRegistry {
45
+ const records = new Map<string, StyleRecord>();
46
+ const pendingRscGenerations = new Set<number>();
47
+ const invalidatedTransportGenerationRanges: Array<[number, number]> = [];
48
+ const preparingRscGenerations = new Set<number>();
49
+ const preparedRscGenerations = new Set<number>();
50
+ const preparationControllers = new Map<number, AbortController>();
51
+ const preparationPromises = new Map<number, Promise<void>>();
52
+ const generationPreloads = new Map<number, Map<string, HTMLLinkElement>>();
53
+ const rscDeclarations = new Map<number, string[]>();
54
+ const committedTransportNodes = new Map<string, HTMLLinkElement>();
55
+ let committedActiveIds: string[] = [];
56
+ let committedGenerationWatermark = -1;
57
+
58
+ const isInvalidatedGeneration = (generation: number): boolean =>
59
+ invalidatedTransportGenerationRanges.some(
60
+ ([start, end]) => generation >= start && generation <= end
61
+ );
62
+
63
+ const invalidateGeneration = (generation: number) => {
64
+ let index = 0;
65
+ while (
66
+ index < invalidatedTransportGenerationRanges.length &&
67
+ invalidatedTransportGenerationRanges[index]![1] < generation - 1
68
+ ) {
69
+ index += 1;
70
+ }
71
+ const current = invalidatedTransportGenerationRanges[index];
72
+ if (!current || generation < current[0] - 1) {
73
+ invalidatedTransportGenerationRanges.splice(index, 0, [generation, generation]);
74
+ return;
75
+ }
76
+ current[0] = Math.min(current[0], generation);
77
+ current[1] = Math.max(current[1], generation);
78
+ while (index + 1 < invalidatedTransportGenerationRanges.length) {
79
+ const next = invalidatedTransportGenerationRanges[index + 1]!;
80
+ if (next[0] > current[1] + 1) break;
81
+ current[1] = Math.max(current[1], next[1]);
82
+ invalidatedTransportGenerationRanges.splice(index + 1, 1);
83
+ }
84
+ };
85
+
86
+ const clearInvalidatedThrough = (generation: number) => {
87
+ while (
88
+ invalidatedTransportGenerationRanges[0] &&
89
+ invalidatedTransportGenerationRanges[0][1] <= generation
90
+ ) {
91
+ invalidatedTransportGenerationRanges.shift();
92
+ }
93
+ const first = invalidatedTransportGenerationRanges[0];
94
+ if (first && first[0] <= generation) first[0] = generation + 1;
95
+ };
96
+
97
+ const canonicalId = (id: string): string => {
98
+ if (!id.trim())
99
+ throw new Error('Cannot publish a development stylesheet without an identifier.');
100
+ return canonicalizeDevStyleId(id, document.baseURI);
101
+ };
102
+
103
+ const matchingRecord = (id: string): StyleRecord | undefined => {
104
+ return records.get(id);
105
+ };
106
+
107
+ const stylesheetId = (link: HTMLLinkElement): string | undefined => {
108
+ const href = link.getAttribute('href') ?? link.href;
109
+ if (!href) return undefined;
110
+ try {
111
+ return canonicalizeDevStyleId(href, document.baseURI);
112
+ } catch {
113
+ return undefined;
114
+ }
115
+ };
116
+
117
+ const findOrCreateRecord = (id: string): StyleRecord => {
118
+ const existing = matchingRecord(id);
119
+ if (existing) return existing;
120
+ const record: StyleRecord = { id, state: 'ssr-active', pendingRelease: false };
121
+ records.set(id, record);
122
+ return record;
123
+ };
124
+
125
+ const matchingLinks = (id: string): HTMLLinkElement[] =>
126
+ Array.from(document.querySelectorAll<HTMLLinkElement>(RSC_STYLESHEET)).filter(link => {
127
+ const linkId = stylesheetId(link);
128
+ return linkId === id;
129
+ });
130
+
131
+ const linkGeneration = (link: HTMLLinkElement): number | undefined => {
132
+ const href = link.getAttribute('href') ?? link.href;
133
+ return href ? getDevStyleTransportGeneration(href, document.baseURI) : undefined;
134
+ };
135
+
136
+ const generationTransportLinks = (): HTMLLinkElement[] =>
137
+ Array.from(
138
+ document.querySelectorAll<HTMLLinkElement>(
139
+ `${RSC_STYLESHEET}[href*="${DEV_STYLE_TRANSPORT_GENERATION_PARAM}="]`
140
+ )
141
+ );
142
+
143
+ const generationLinks = (generation: number): HTMLLinkElement[] =>
144
+ generationTransportLinks().filter(link => linkGeneration(link) === generation);
145
+
146
+ const bootstrapLinks = new Map<string, HTMLLinkElement>();
147
+ for (const link of Array.from(document.querySelectorAll<HTMLLinkElement>(RSC_STYLESHEET))) {
148
+ const id = stylesheetId(link);
149
+ if (id === undefined || linkGeneration(link) !== undefined || link.media === 'not all')
150
+ continue;
151
+ bootstrapLinks.set(id, link);
152
+ findOrCreateRecord(id);
153
+ if (!committedActiveIds.includes(id)) committedActiveIds.push(id);
154
+ committedTransportNodes.set(id, link);
155
+ }
156
+
157
+ const hasManagedStyle = (record: StyleRecord | undefined): boolean => !!record?.node?.isConnected;
158
+
159
+ const hasManagedOwner = (record: StyleRecord | undefined): boolean =>
160
+ hasManagedStyle(record) || !!record?.ownedLink?.isConnected;
161
+
162
+ const isCommitted = (id: string): boolean => committedActiveIds.includes(id);
163
+
164
+ const committedTransportNode = (id: string): HTMLLinkElement | undefined => {
165
+ const node = committedTransportNodes.get(id);
166
+ if (node?.isConnected && stylesheetId(node) === id) return node;
167
+ committedTransportNodes.delete(id);
168
+ return undefined;
169
+ };
170
+
171
+ const installManagedNode = (record: StyleRecord): HTMLStyleElement => {
172
+ const node = record.node?.isConnected ? record.node : document.createElement('style');
173
+ if (!node.isConnected) {
174
+ node.setAttribute('data-isr-engine-dev-style', record.id);
175
+ document.head.appendChild(node);
176
+ record.node = node;
177
+ }
178
+ if (record.cssText !== undefined) node.textContent = record.cssText;
179
+ record.pendingRelease = false;
180
+ record.state = 'client-active';
181
+ record.ownedLink?.remove();
182
+ record.ownedLink = undefined;
183
+ const transport = committedTransportNode(record.id);
184
+ committedTransportNodes.delete(record.id);
185
+ transport?.remove();
186
+ return node;
187
+ };
188
+
189
+ const release = (record: StyleRecord, generation?: number) => {
190
+ record.node?.remove();
191
+ record.node = undefined;
192
+ record.ownedLink?.remove();
193
+ record.ownedLink = undefined;
194
+ committedTransportNodes.delete(record.id);
195
+ for (const link of matchingLinks(record.id)) {
196
+ const owner = linkGeneration(link);
197
+ if (generation === undefined || owner === undefined || owner <= generation) link.remove();
198
+ }
199
+ record.pendingRelease = false;
200
+ record.state = 'released';
201
+ };
202
+
203
+ const restoreActiveState = (record: StyleRecord) => {
204
+ record.pendingRelease = false;
205
+ record.state = hasManagedOwner(record) ? 'client-active' : 'ssr-active';
206
+ };
207
+
208
+ const sameActiveSet = (left: string[], right: string[]): boolean =>
209
+ left.length === right.length && left.every(id => right.includes(id));
210
+
211
+ const commitActiveSet = (activeIds: string[], generation?: number) => {
212
+ for (const record of Array.from(records.values())) {
213
+ if (activeIds.includes(record.id)) {
214
+ restoreActiveState(record);
215
+ } else {
216
+ release(record, generation);
217
+ }
218
+ }
219
+ committedActiveIds = [...activeIds];
220
+ };
221
+
222
+ const isImporterResource = (link: HTMLLinkElement): boolean =>
223
+ !!link.dataset.precedence?.startsWith('vite-rsc/importer-resources');
224
+
225
+ const committedTransportOwner = (
226
+ id: string,
227
+ generation: number,
228
+ exactGeneration = false
229
+ ): HTMLLinkElement | undefined => {
230
+ const current = committedTransportNode(id);
231
+ let selected: HTMLLinkElement | undefined;
232
+ let selectedGeneration = Number.NEGATIVE_INFINITY;
233
+ for (const link of matchingLinks(id)) {
234
+ const owner = linkGeneration(link);
235
+ const isCurrent = link === current;
236
+ if (
237
+ !isImporterResource(link) ||
238
+ (exactGeneration && owner !== generation && !(generation === 0 && owner === undefined)) ||
239
+ (!isCurrent && owner === undefined && committedGenerationWatermark > 0) ||
240
+ (!isCurrent &&
241
+ owner !== undefined &&
242
+ (owner < committedGenerationWatermark ||
243
+ owner > generation ||
244
+ isInvalidatedGeneration(owner)))
245
+ ) {
246
+ continue;
247
+ }
248
+ const rank = owner ?? Number.NEGATIVE_INFINITY;
249
+ if (rank >= selectedGeneration) {
250
+ selected = link;
251
+ selectedGeneration = rank;
252
+ }
253
+ }
254
+ return selected;
255
+ };
256
+
257
+ const activateTransportOwner = (link: HTMLLinkElement) => {
258
+ if (link.media === 'not all') link.removeAttribute('media');
259
+ };
260
+
261
+ const convergeCommittedTransport = (
262
+ id: string,
263
+ generation: number,
264
+ managed: boolean,
265
+ exactGeneration = false
266
+ ): boolean => {
267
+ const selected = managed ? undefined : committedTransportOwner(id, generation, exactGeneration);
268
+ if (!managed && !selected) return false;
269
+ if (selected) {
270
+ activateTransportOwner(selected);
271
+ committedTransportNodes.set(id, selected);
272
+ } else {
273
+ committedTransportNodes.delete(id);
274
+ }
275
+ for (const link of matchingLinks(id)) {
276
+ const owner = linkGeneration(link);
277
+ if (
278
+ (owner === undefined || owner <= generation || isInvalidatedGeneration(owner)) &&
279
+ link !== selected
280
+ ) {
281
+ link.remove();
282
+ }
283
+ }
284
+ return true;
285
+ };
286
+
287
+ const reconcileCommittedSet = () => {
288
+ for (const id of committedActiveIds) {
289
+ const record = matchingRecord(id);
290
+ if (record?.cssText !== undefined) installManagedNode(record);
291
+ convergeCommittedTransport(id, committedGenerationWatermark, hasManagedStyle(record));
292
+ }
293
+ };
294
+
295
+ const adoptBootstrapOwner = (id: string): Promise<void> => {
296
+ const record = findOrCreateRecord(id);
297
+ if (hasManagedOwner(record)) return Promise.resolve();
298
+ const bootstrap = bootstrapLinks.get(id);
299
+ if (!bootstrap?.isConnected) {
300
+ return Promise.reject(
301
+ new Error(`Bootstrap stylesheet ${id} was removed before engine ownership was established.`)
302
+ );
303
+ }
304
+
305
+ const owned = bootstrap.cloneNode(false) as HTMLLinkElement;
306
+ owned.removeAttribute('data-rsc-css-href');
307
+ owned.dataset.isrEngineDevStyleLink = id;
308
+
309
+ return new Promise<void>((resolve, reject) => {
310
+ const cleanup = () => {
311
+ owned.removeEventListener('load', onLoad);
312
+ owned.removeEventListener('error', onError);
313
+ };
314
+ const onLoad = () => {
315
+ cleanup();
316
+ if (record.node?.isConnected) {
317
+ owned.remove();
318
+ } else {
319
+ record.ownedLink = owned;
320
+ record.state = 'client-active';
321
+ }
322
+ bootstrap.remove();
323
+ bootstrapLinks.delete(id);
324
+ committedTransportNodes.delete(id);
325
+ resolve();
326
+ };
327
+ const onError = () => {
328
+ cleanup();
329
+ owned.remove();
330
+ reject(new Error(`Failed to adopt bootstrap stylesheet ${id}.`));
331
+ };
332
+ owned.addEventListener('load', onLoad, { once: true });
333
+ owned.addEventListener('error', onError, { once: true });
334
+ document.head.appendChild(owned);
335
+ if (owned.sheet) onLoad();
336
+ });
337
+ };
338
+
339
+ const transportHref = (id: string, generation: number): string => {
340
+ return createDevStyleTransportHref(id, generation, document.baseURI);
341
+ };
342
+
343
+ const prepareTransport = (generation: number, id: string, signal: AbortSignal): Promise<void> => {
344
+ const href = transportHref(id, generation);
345
+ const link = document.createElement('link');
346
+ link.rel = 'preload';
347
+ link.as = 'style';
348
+ link.href = href;
349
+ link.dataset.isrEngineDevStylePreload = id;
350
+ generationPreloads.get(generation)?.set(id, link);
351
+
352
+ return new Promise<void>((resolve, reject) => {
353
+ const cleanup = () => {
354
+ link.removeEventListener('load', onLoad);
355
+ link.removeEventListener('error', onError);
356
+ signal.removeEventListener('abort', onAbort);
357
+ };
358
+ const onLoad = () => {
359
+ cleanup();
360
+ resolve();
361
+ };
362
+ const onError = () => {
363
+ cleanup();
364
+ reject(new Error(`Failed to preload development stylesheet ${id}.`));
365
+ };
366
+ const onAbort = () => {
367
+ cleanup();
368
+ reject(new Error(`Development stylesheet generation ${generation} was aborted.`));
369
+ };
370
+ link.addEventListener('load', onLoad, { once: true });
371
+ link.addEventListener('error', onError, { once: true });
372
+ signal.addEventListener('abort', onAbort, { once: true });
373
+ document.head.appendChild(link);
374
+ if (signal.aborted) onAbort();
375
+ });
376
+ };
377
+
378
+ const removeGenerationPreloads = (generation: number) => {
379
+ const preloads = generationPreloads.get(generation);
380
+ if (!preloads) return;
381
+ for (const link of preloads.values()) link.remove();
382
+ generationPreloads.delete(generation);
383
+ };
384
+
385
+ const clearGenerationState = (generation: number, abortPreparation: boolean) => {
386
+ const controller = preparationControllers.get(generation);
387
+ if (abortPreparation) controller?.abort();
388
+ preparationControllers.delete(generation);
389
+ preparationPromises.delete(generation);
390
+ preparingRscGenerations.delete(generation);
391
+ preparedRscGenerations.delete(generation);
392
+ removeGenerationPreloads(generation);
393
+ pendingRscGenerations.delete(generation);
394
+ rscDeclarations.delete(generation);
395
+ };
396
+
397
+ const removeGenerationTransport = (generation: number) => {
398
+ for (const link of generationLinks(generation)) {
399
+ const id = stylesheetId(link);
400
+ if (id !== undefined && committedTransportNode(id) === link) continue;
401
+ link.remove();
402
+ }
403
+ };
404
+
405
+ const clearObsoleteGeneration = (generation: number) => {
406
+ clearGenerationState(generation, true);
407
+ removeGenerationTransport(generation);
408
+ };
409
+
410
+ const reconcileCommittedGenerationTouch = (generation: number) => {
411
+ clearGenerationState(generation, false);
412
+ reconcileCommittedSet();
413
+ for (const link of generationLinks(generation)) {
414
+ const id = stylesheetId(link);
415
+ if (id === undefined || !committedActiveIds.includes(id)) link.remove();
416
+ }
417
+ };
418
+
419
+ const invalidateUncommittedGeneration = (generation: number) => {
420
+ if (generation < committedGenerationWatermark) {
421
+ clearObsoleteGeneration(generation);
422
+ return;
423
+ }
424
+ if (generation === committedGenerationWatermark) {
425
+ reconcileCommittedGenerationTouch(generation);
426
+ return;
427
+ }
428
+ invalidateGeneration(generation);
429
+ clearObsoleteGeneration(generation);
430
+ reconcileCommittedSet();
431
+ };
432
+
433
+ const finalizeDroppedGenerations = (committingGeneration: number) => {
434
+ const candidates = new Set<number>([
435
+ ...pendingRscGenerations,
436
+ ...preparingRscGenerations,
437
+ ...preparedRscGenerations,
438
+ ...preparationControllers.keys(),
439
+ ...preparationPromises.keys(),
440
+ ...generationPreloads.keys(),
441
+ ...rscDeclarations.keys(),
442
+ ]);
443
+ const dropped = Array.from(candidates)
444
+ .filter(
445
+ generation => generation > committedGenerationWatermark && generation < committingGeneration
446
+ )
447
+ .sort((left, right) => left - right);
448
+ if (dropped.length === 0) return;
449
+ for (const generation of dropped) {
450
+ invalidateGeneration(generation);
451
+ clearObsoleteGeneration(generation);
452
+ }
453
+ reconcileCommittedSet();
454
+ };
455
+
456
+ const clearCommittedGenerationState = (generation: number) => {
457
+ const candidates = new Set<number>([
458
+ ...pendingRscGenerations,
459
+ ...preparingRscGenerations,
460
+ ...preparedRscGenerations,
461
+ ...preparationControllers.keys(),
462
+ ...preparationPromises.keys(),
463
+ ...generationPreloads.keys(),
464
+ ...rscDeclarations.keys(),
465
+ ]);
466
+ for (const candidate of candidates) {
467
+ if (candidate <= generation) clearGenerationState(candidate, candidate < generation);
468
+ }
469
+ for (const link of generationTransportLinks()) {
470
+ const owner = linkGeneration(link);
471
+ const id = stylesheetId(link);
472
+ if (
473
+ owner !== undefined &&
474
+ owner < generation &&
475
+ isInvalidatedGeneration(owner) &&
476
+ (id === undefined || committedTransportNode(id) !== link)
477
+ ) {
478
+ link.remove();
479
+ }
480
+ }
481
+ clearInvalidatedThrough(generation);
482
+ };
483
+
484
+ const sorted = (values: Iterable<number>): number[] => Array.from(values).sort((a, b) => a - b);
485
+
486
+ const inspectGenerationState = () => ({
487
+ committedWatermark: committedGenerationWatermark,
488
+ controllers: sorted(preparationControllers.keys()),
489
+ declarations: sorted(rscDeclarations.keys()),
490
+ invalidatedRanges: invalidatedTransportGenerationRanges.map(([start, end]) => [start, end]),
491
+ pending: sorted(pendingRscGenerations),
492
+ preloads: sorted(generationPreloads.keys()),
493
+ prepared: sorted(preparedRscGenerations),
494
+ preparing: sorted(preparingRscGenerations),
495
+ promises: sorted(preparationPromises.keys()),
496
+ });
497
+
498
+ const registry: DevStyleRegistry = {
499
+ publish(id, cssText) {
500
+ const record = findOrCreateRecord(canonicalId(id));
501
+ record.cssText = cssText;
502
+ const links = matchingLinks(record.id);
503
+
504
+ if (
505
+ isCommitted(record.id) ||
506
+ (committedGenerationWatermark === -1 &&
507
+ pendingRscGenerations.size === 0 &&
508
+ links.length === 0)
509
+ ) {
510
+ installManagedNode(record);
511
+ if (!isCommitted(record.id)) committedActiveIds.push(record.id);
512
+ convergeCommittedTransport(
513
+ record.id,
514
+ committedGenerationWatermark,
515
+ !!record.node?.isConnected
516
+ );
517
+ }
518
+ },
519
+
520
+ prune(id) {
521
+ const record = matchingRecord(canonicalId(id));
522
+ if (!record) return;
523
+ record.pendingRelease = true;
524
+ record.state = 'pending-release';
525
+ },
526
+
527
+ beginRscUpdate(generation) {
528
+ if (generation <= committedGenerationWatermark || isInvalidatedGeneration(generation)) {
529
+ if (generation < committedGenerationWatermark || isInvalidatedGeneration(generation)) {
530
+ clearObsoleteGeneration(generation);
531
+ } else {
532
+ reconcileCommittedGenerationTouch(generation);
533
+ }
534
+ return;
535
+ }
536
+ pendingRscGenerations.add(generation);
537
+ },
538
+
539
+ declareRscStyles(generation, activeIds) {
540
+ if (generation <= committedGenerationWatermark || isInvalidatedGeneration(generation)) {
541
+ if (generation < committedGenerationWatermark) clearObsoleteGeneration(generation);
542
+ else if (isInvalidatedGeneration(generation)) {
543
+ clearObsoleteGeneration(generation);
544
+ } else {
545
+ reconcileCommittedGenerationTouch(generation);
546
+ }
547
+ return;
548
+ }
549
+ const active = Array.from(new Set(Array.from(activeIds, canonicalId)));
550
+ const existing = rscDeclarations.get(generation);
551
+ if (existing && !sameActiveSet(existing, active)) {
552
+ throw new Error(
553
+ `Conflicting development stylesheet declarations for RSC generation ${generation}.`
554
+ );
555
+ }
556
+ for (const id of active) findOrCreateRecord(id);
557
+ rscDeclarations.set(generation, active);
558
+ },
559
+
560
+ prepareRscStyles(generation, activeIds) {
561
+ if (generation <= committedGenerationWatermark || isInvalidatedGeneration(generation)) {
562
+ if (generation < committedGenerationWatermark || isInvalidatedGeneration(generation)) {
563
+ clearObsoleteGeneration(generation);
564
+ } else {
565
+ reconcileCommittedGenerationTouch(generation);
566
+ }
567
+ return Promise.resolve([...committedActiveIds]);
568
+ }
569
+ const active =
570
+ activeIds === undefined
571
+ ? generation === 0
572
+ ? [...committedActiveIds]
573
+ : Array.from(
574
+ new Set(
575
+ generationLinks(generation).flatMap(link => {
576
+ const id = stylesheetId(link);
577
+ return id === undefined ? [] : [id];
578
+ })
579
+ )
580
+ )
581
+ : Array.from(activeIds);
582
+ this.declareRscStyles(generation, active);
583
+ const existing = preparationPromises.get(generation);
584
+ if (existing) return existing.then(() => [...(rscDeclarations.get(generation) ?? active)]);
585
+ if (generation === 0) {
586
+ const preparation =
587
+ activeIds === undefined
588
+ ? Promise.all(active.map(adoptBootstrapOwner)).then(() => undefined)
589
+ : Promise.resolve();
590
+ return preparation.then(() => {
591
+ preparedRscGenerations.add(generation);
592
+ return [...active];
593
+ });
594
+ }
595
+
596
+ const declared = rscDeclarations.get(generation) ?? [];
597
+ const controller = new AbortController();
598
+ const preloads = new Map<string, HTMLLinkElement>();
599
+ generationPreloads.set(generation, preloads);
600
+ preparationControllers.set(generation, controller);
601
+ preparingRscGenerations.add(generation);
602
+ const preparation = Promise.all(
603
+ declared.map(id => {
604
+ const record = matchingRecord(id);
605
+ return record?.cssText === undefined
606
+ ? prepareTransport(generation, id, controller.signal)
607
+ : Promise.resolve();
608
+ })
609
+ ).then(() => {
610
+ if (controller.signal.aborted) {
611
+ throw new Error(`Development stylesheet generation ${generation} was aborted.`);
612
+ }
613
+ preparingRscGenerations.delete(generation);
614
+ preparedRscGenerations.add(generation);
615
+ });
616
+ preparation.catch(() => {
617
+ preparingRscGenerations.delete(generation);
618
+ });
619
+ preparationPromises.set(generation, preparation);
620
+ return preparation.then(() => [...declared]);
621
+ },
622
+
623
+ abortRscUpdate(generation) {
624
+ invalidateUncommittedGeneration(generation);
625
+ },
626
+
627
+ beginUpdate() {
628
+ for (const record of records.values()) {
629
+ if (!record.pendingRelease) record.state = 'updating';
630
+ }
631
+ },
632
+
633
+ commitUpdate(activeIds) {
634
+ if (activeIds === undefined) {
635
+ for (const record of records.values()) {
636
+ if (record.pendingRelease) restoreActiveState(record);
637
+ }
638
+ return;
639
+ }
640
+ commitActiveSet(Array.from(activeIds, canonicalId));
641
+ },
642
+
643
+ abortUpdate() {
644
+ for (const record of records.values()) {
645
+ if (record.pendingRelease || record.state === 'updating') restoreActiveState(record);
646
+ }
647
+ },
648
+
649
+ reconcileDocumentStyles(generation, activeIds) {
650
+ if (generation < committedGenerationWatermark || isInvalidatedGeneration(generation)) {
651
+ clearObsoleteGeneration(generation);
652
+ return;
653
+ }
654
+ if (generation === committedGenerationWatermark) {
655
+ reconcileCommittedGenerationTouch(generation);
656
+ }
657
+ if (
658
+ preparingRscGenerations.has(generation) ||
659
+ (preparationPromises.has(generation) && !preparedRscGenerations.has(generation))
660
+ ) {
661
+ return;
662
+ }
663
+ const active = Array.from(new Set(Array.from(activeIds, canonicalId)));
664
+ if (generation === committedGenerationWatermark) {
665
+ if (!sameActiveSet(committedActiveIds, active)) {
666
+ throw new Error(`Conflicting committed stylesheet set for RSC generation ${generation}.`);
667
+ }
668
+ reconcileCommittedSet();
669
+ return;
670
+ }
671
+
672
+ const declared = rscDeclarations.get(generation);
673
+ if (declared && !sameActiveSet(declared, active)) {
674
+ throw new Error(
675
+ `RSC generation ${generation} committed a stylesheet set different from its payload.`
676
+ );
677
+ }
678
+ if (!declared) rscDeclarations.set(generation, active);
679
+ const exactPreparedOwner = preparedRscGenerations.has(generation);
680
+
681
+ for (const id of active) {
682
+ const record = findOrCreateRecord(id);
683
+ if (record.cssText !== undefined) installManagedNode(record);
684
+ }
685
+
686
+ const ready = active.every(id => {
687
+ const record = matchingRecord(id);
688
+ if (hasManagedOwner(record)) return true;
689
+ return committedTransportOwner(id, generation, exactPreparedOwner) !== undefined;
690
+ });
691
+ if (!ready) return;
692
+
693
+ finalizeDroppedGenerations(generation);
694
+
695
+ for (const id of active) {
696
+ convergeCommittedTransport(
697
+ id,
698
+ generation,
699
+ hasManagedStyle(matchingRecord(id)),
700
+ exactPreparedOwner
701
+ );
702
+ }
703
+ commitActiveSet(active, generation);
704
+ committedGenerationWatermark = generation;
705
+ clearCommittedGenerationState(generation);
706
+ options.onRscCommit?.(generation);
707
+ },
708
+
709
+ dispose() {
710
+ pendingRscGenerations.clear();
711
+ invalidatedTransportGenerationRanges.length = 0;
712
+ for (const controller of preparationControllers.values()) controller.abort();
713
+ preparationControllers.clear();
714
+ preparationPromises.clear();
715
+ preparingRscGenerations.clear();
716
+ preparedRscGenerations.clear();
717
+ for (const generation of generationPreloads.keys()) removeGenerationPreloads(generation);
718
+ rscDeclarations.clear();
719
+ committedTransportNodes.clear();
720
+ committedActiveIds = [];
721
+ for (const record of Array.from(records.values())) {
722
+ record.node?.remove();
723
+ record.ownedLink?.remove();
724
+ record.state = 'released';
725
+ }
726
+ records.clear();
727
+ },
728
+ };
729
+ Object.defineProperty(registry, DEV_STYLE_REGISTRY_INSPECT, {
730
+ value: inspectGenerationState,
731
+ });
732
+ return registry;
733
+ }
734
+
735
+ export function getOrCreateDevStyleRegistry(
736
+ document: Document,
737
+ options: DevStyleRegistryOptions = {}
738
+ ): DevStyleRegistry {
739
+ const existing = devStyleRegistries.get(document);
740
+ if (existing) return existing;
741
+ const registry = createDevStyleRegistry(document, options);
742
+ devStyleRegistries.set(document, registry);
743
+ return registry;
744
+ }