@rsc-kit/core 0.30.33 → 0.30.34

package/dist/js/slotStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"slotStore.js","sourceRoot":"","sources":["../../src/js/slotStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAeH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAA;AAC1C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAA;AAElD,kFAAkF;AAClF,MAAM,KAAK,GAAc,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;AAE5C,SAAS,MAAM,CAAC,IAAY;IAC1B,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAU;IAC9C,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IACzB,MAAM,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAkB;IAC9D,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAY,CAAA;IAE3D,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACtB,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAE7B,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC3B,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAA;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IAE/B,KAAK,CAAC,KAAK,EAAE,CAAA;IACb,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;AACvB,CAAC","sourcesContent":["/**\n * What each parallel slot is showing, when the server has re-rendered one.\n *\n * A slot is the only region of a page smaller than the page that the server\n * can name, so it is the unit an action can invalidate on its own — two tables\n * refresh apart from each other only if they are two slots.\n *\n * Empty is meaningful, and is the ordinary case: a slot with nothing stored\n * renders what the server sent with the page. Nothing is retained here the way\n * segments retain pages; a slot has one current value and replacing it is the\n * whole point.\n */\n\ntype Tree = unknown\ntype Listener = () => void\n\n/**\n * Immutable, like the segment store and for the same reason:\n * useSyncExternalStore compares snapshots by identity, so returning a fresh\n * object per read reads as \"changed every render\" and loops until React gives\n * up. Every write replaces the entry; nothing is edited in place.\n */\ninterface SlotState {\n  readonly tree: Tree\n}\n\nconst slots = new Map<string, SlotState>()\nconst listeners = new Map<string, Set<Listener>>()\n\n/** Shared by every slot that has never been written to, so identity is stable. */\nconst EMPTY: SlotState = { tree: undefined }\n\nfunction notify(name: string): void {\n  listeners.get(name)?.forEach((listener) => listener())\n}\n\nexport function setSlot(name: string, tree: Tree): void {\n  slots.set(name, { tree })\n  notify(name)\n}\n\nexport function subscribeToSlot(name: string, listener: Listener): () => void {\n  const existing = listeners.get(name) ?? new Set<Listener>()\n\n  existing.add(listener)\n  listeners.set(name, existing)\n\n  return () => {\n    existing.delete(listener)\n  }\n}\n\nexport function getSlotState(name: string): SlotState {\n  return slots.get(name) ?? EMPTY\n}\n\n/**\n * Forget every slot.\n *\n * A navigation replaces the page, and a slot rendered for the page you left\n * has no claim on the one you arrived at.\n */\nexport function clearSlots(): void {\n  const names = [...slots.keys()]\n\n  slots.clear()\n  names.forEach(notify)\n}\n"]}
+{"version":3,"file":"slotStore.js","sourceRoot":"","sources":["../../src/js/slotStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAeH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAA;AAC1C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAA;AAElD,kFAAkF;AAClF,MAAM,KAAK,GAAc,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;AAE5C,SAAS,MAAM,CAAC,IAAY;IAC1B,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAU;IAC9C,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IACzB,MAAM,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,2EAA2E;AAC3E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;AAExC,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAkB,EAAE,KAAc;IAC9E,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAEhD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAY,CAAA;IAE3D,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACtB,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAE7B,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC3B,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAA;AACjC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,SAAS,GAAG,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,GAAG,SAAS;YAAE,SAAQ;QAEzD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAClB,MAAM,CAAC,IAAI,CAAC,CAAA;IACd,CAAC;AACH,CAAC","sourcesContent":["/**\n * What each parallel slot is showing, when the server has re-rendered one.\n *\n * A slot is the only region of a page smaller than the page that the server\n * can name, so it is the unit an action can invalidate on its own — two tables\n * refresh apart from each other only if they are two slots.\n *\n * Empty is meaningful, and is the ordinary case: a slot with nothing stored\n * renders what the server sent with the page. Nothing is retained here the way\n * segments retain pages; a slot has one current value and replacing it is the\n * whole point.\n */\n\ntype Tree = unknown\ntype Listener = () => void\n\n/**\n * Immutable, like the segment store and for the same reason:\n * useSyncExternalStore compares snapshots by identity, so returning a fresh\n * object per read reads as \"changed every render\" and loops until React gives\n * up. Every write replaces the entry; nothing is edited in place.\n */\ninterface SlotState {\n  readonly tree: Tree\n}\n\nconst slots = new Map<string, SlotState>()\nconst listeners = new Map<string, Set<Listener>>()\n\n/** Shared by every slot that has never been written to, so identity is stable. */\nconst EMPTY: SlotState = { tree: undefined }\n\nfunction notify(name: string): void {\n  listeners.get(name)?.forEach((listener) => listener())\n}\n\nexport function setSlot(name: string, tree: Tree): void {\n  slots.set(name, { tree })\n  notify(name)\n}\n\n/** The depth of the segment each slot renders in, told by its boundary. */\nconst depths = new Map<string, number>()\n\nexport function subscribeToSlot(name: string, listener: Listener, depth?: number): () => void {\n  if (depth !== undefined) depths.set(name, depth)\n\n  const existing = listeners.get(name) ?? new Set<Listener>()\n\n  existing.add(listener)\n  listeners.set(name, existing)\n\n  return () => {\n    existing.delete(listener)\n  }\n}\n\nexport function getSlotState(name: string): SlotState {\n  return slots.get(name) ?? EMPTY\n}\n\n/**\n * Forget the slots a navigation replaces.\n *\n * A navigation answered at a depth renders everything from that boundary\n * down, and a slot rendered for the page you left has no claim on the one you\n * arrived at. A slot of a layout above it is not part of the answer: that\n * layout stays mounted, and what an action last put in its slot is still\n * current. Emptied, the boundary fell back to the layout's first render, and\n * a team picker went back to the name from before the rename.\n *\n * With no depth, every slot - and a slot whose boundary never said where it\n * is goes either way.\n */\nexport function clearSlots(fromDepth = 0): void {\n  for (const name of [...slots.keys()]) {\n    if ((depths.get(name) ?? fromDepth) < fromDepth) continue\n\n    slots.delete(name)\n    notify(name)\n  }\n}\n"]}

package/dist/js/viewportPrefetch.d.ts

@@ -21,7 +21,15 @@
  * One observer for every link, and the work is done when the browser is
  * idle - a list scrolled into view is many links at once, and the browser's
  * per-origin connections should not all be taken by pages nobody has tapped
- * yet. Each link prefetches once; the router keeps the payload for its TTL.
+ * yet.
+ *
+ * A link asks again each time it comes back into view, and when the tab is
+ * visible again. The router keeps a payload for its TTL and ignores the ask
+ * until then, so this is a request only for one that expired: a visitor who
+ * read for a minute and scrolled back to the nav, or came back to the tab,
+ * tapped a link whose payload was thirty seconds gone and waited a round trip
+ * for it. Not on a timer: a page left open would refetch every link on it,
+ * every thirty seconds, for nobody.
  */
 /**
  * Prefetch when the link is on screen. Returns the function that stops

package/dist/js/viewportPrefetch.js

@@ -21,10 +21,22 @@
  * One observer for every link, and the work is done when the browser is
  * idle - a list scrolled into view is many links at once, and the browser's
  * per-origin connections should not all be taken by pages nobody has tapped
- * yet. Each link prefetches once; the router keeps the payload for its TTL.
+ * yet.
+ *
+ * A link asks again each time it comes back into view, and when the tab is
+ * visible again. The router keeps a payload for its TTL and ignores the ask
+ * until then, so this is a request only for one that expired: a visitor who
+ * read for a minute and scrolled back to the nav, or came back to the tab,
+ * tapped a link whose payload was thirty seconds gone and waited a round trip
+ * for it. Not on a timer: a page left open would refetch every link on it,
+ * every thirty seconds, for nobody.
  */
 let observer = null;
-const pending = new WeakMap();
+const fires = new WeakMap();
+/** Links that have spent the page's budget, which asking again does not spend twice. */
+const counted = new WeakSet();
+/** On screen now, for the tab coming back. */
+const inView = new Set();
 /**
  * How many links a page prefetches on sight before the rest wait for
  * intent. A product page's payload is 30 KB with its related products,
@@ -44,6 +56,15 @@ function budgetPerPage() {
     window.addEventListener("rsc-navigate", () => {
         onSight = 0;
     });
+    document.addEventListener("visibilitychange", () => {
+        if (document.visibilityState !== "visible")
+            return;
+        for (const element of inView) {
+            const fire = fires.get(element);
+            if (fire && counted.has(element))
+                whenIdle(fire);
+        }
+    });
 }
 function savingData() {
     const connection = navigator.connection;
@@ -62,17 +83,21 @@ function observerFor() {
     if (typeof IntersectionObserver === "undefined")
         return null;
     observer = new IntersectionObserver((entries) => {
-        for (const entry of entries) {
-            if (!entry.isIntersecting)
+        for (const { isIntersecting, target } of entries) {
+            if (!isIntersecting) {
+                inView.delete(target);
                 continue;
-            const fire = pending.get(entry.target);
-            observer.unobserve(entry.target);
-            pending.delete(entry.target);
+            }
+            inView.add(target);
+            const fire = fires.get(target);
             if (!fire)
                 continue;
-            if (onSight >= ON_SIGHT_PER_PAGE)
-                continue;
-            onSight++;
+            if (!counted.has(target)) {
+                if (onSight >= ON_SIGHT_PER_PAGE)
+                    continue;
+                onSight++;
+                counted.add(target);
+            }
             whenIdle(fire);
         }
     }, 
@@ -92,10 +117,11 @@ export function prefetchWhenVisible(element, fire) {
     const io = observerFor();
     if (!io)
         return () => { };
-    pending.set(element, fire);
+    fires.set(element, fire);
     io.observe(element);
     return () => {
-        pending.delete(element);
+        fires.delete(element);
+        inView.delete(element);
         io.unobserve(element);
     };
 }

package/dist/js/viewportPrefetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewportPrefetch.js","sourceRoot":"","sources":["../../src/js/viewportPrefetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,IAAI,QAAQ,GAAgC,IAAI,CAAA;AAChD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAuB,CAAA;AAElD;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAC5B,IAAI,OAAO,GAAG,CAAC,CAAA;AACf,IAAI,SAAS,GAAG,KAAK,CAAA;AAErB,SAAS,aAAa;IACpB,IAAI,SAAS,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAM;IAEtD,SAAS,GAAG,IAAI,CAAA;IAChB,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,GAAG,EAAE;QAC3C,OAAO,GAAG,CAAC,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,UAAU,GAAI,SAAqD,CAAC,UAAU,CAAA;IAEpF,OAAO,UAAU,EAAE,QAAQ,KAAK,IAAI,CAAA;AACtC,CAAC;AAED,SAAS,QAAQ,CAAC,EAAc;IAC9B,MAAM,IAAI,GAAI,MAAyF,CAAC,mBAAmB,CAAA;IAE3H,IAAI,IAAI;QAAE,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;;QAChC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;AACzB,CAAC;AAED,SAAS,WAAW;IAClB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,IAAI,OAAO,oBAAoB,KAAK,WAAW;QAAE,OAAO,IAAI,CAAA;IAE5D,QAAQ,GAAG,IAAI,oBAAoB,CACjC,CAAC,OAAO,EAAE,EAAE;QACV,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,cAAc;gBAAE,SAAQ;YAEnC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YAEtC,QAAS,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YAE5B,IAAI,CAAC,IAAI;gBAAE,SAAQ;YACnB,IAAI,OAAO,IAAI,iBAAiB;gBAAE,SAAQ;YAE1C,OAAO,EAAE,CAAA;YACT,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IACD,sEAAsE;IACtE,sBAAsB;IACtB,EAAE,UAAU,EAAE,OAAO,EAAE,CACxB,CAAA;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAuB,EAAE,IAAgB;IAC3E,IAAI,CAAC,OAAO,IAAI,UAAU,EAAE;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAE7C,aAAa,EAAE,CAAA;IAEf,MAAM,EAAE,GAAG,WAAW,EAAE,CAAA;IAExB,IAAI,CAAC,EAAE;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAExB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAC1B,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAEnB,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACvB,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IACvB,CAAC,CAAA;AACH,CAAC","sourcesContent":["/**\n * Prefetching a link as it comes into view.\n *\n * A navigation is as fast as what is already in the browser when the click\n * lands, and a hover is too late to fetch that: a pointer that has settled\n * on a link is 200-300 ms from clicking it, and on a phone the first signal\n * is touchstart, 100-300 ms before the click - about a round trip either\n * way, so a fetch started there has barely left when the navigation needs\n * it. Next prefetches the links on screen instead, and that is what makes\n * its clicks feel like a single-page app's: the payload was there before\n * the pointer moved. So, on every device, the links on screen are fetched -\n * the bytes only; decoding a payload loads the chunks it names, and that\n * waits for the hover or the touch that says which link is meant. It used\n * to be phones only, with a hover-capable device left to the hover: a click\n * that came quicker than the round trip waited for it, and desktop was\n * fast but not instant.\n *\n * Not when the visitor asked for less data: Save-Data is the one signal a\n * browser gives that speculative requests are unwelcome.\n *\n * One observer for every link, and the work is done when the browser is\n * idle - a list scrolled into view is many links at once, and the browser's\n * per-origin connections should not all be taken by pages nobody has tapped\n * yet. Each link prefetches once; the router keeps the payload for its TTL.\n */\n\nlet observer: IntersectionObserver | null = null\nconst pending = new WeakMap<Element, () => void>()\n\n/**\n * How many links a page prefetches on sight before the rest wait for\n * intent. A product page's payload is 30 KB with its related products,\n * and a listing shows twenty-four of them: on sight, every one, that was\n * three quarters of a megabyte per page on a phone. The first dozen in\n * view are fetched; a link past the budget is fetched on touch or on a\n * settled hover, a round trip before the click rather than before the\n * scroll. The budget is the page's, and starts again on each navigation.\n */\nconst ON_SIGHT_PER_PAGE = 12\nlet onSight = 0\nlet listening = false\n\nfunction budgetPerPage(): void {\n  if (listening || typeof window === \"undefined\") return\n\n  listening = true\n  window.addEventListener(\"rsc-navigate\", () => {\n    onSight = 0\n  })\n}\n\nfunction savingData(): boolean {\n  const connection = (navigator as { connection?: { saveData?: boolean } }).connection\n\n  return connection?.saveData === true\n}\n\nfunction whenIdle(fn: () => void): void {\n  const idle = (window as { requestIdleCallback?: (fn: () => void, opts?: { timeout: number }) => void }).requestIdleCallback\n\n  if (idle) idle(fn, { timeout: 1000 })\n  else setTimeout(fn, 50)\n}\n\nfunction observerFor(): IntersectionObserver | null {\n  if (observer) return observer\n  if (typeof IntersectionObserver === \"undefined\") return null\n\n  observer = new IntersectionObserver(\n    (entries) => {\n      for (const entry of entries) {\n        if (!entry.isIntersecting) continue\n\n        const fire = pending.get(entry.target)\n\n        observer!.unobserve(entry.target)\n        pending.delete(entry.target)\n\n        if (!fire) continue\n        if (onSight >= ON_SIGHT_PER_PAGE) continue\n\n        onSight++\n        whenIdle(fire)\n      }\n    },\n    // A little ahead of the fold: a link about to scroll into view is one\n    // about to be tapped.\n    { rootMargin: \"200px\" },\n  )\n\n  return observer\n}\n\n/**\n * Prefetch when the link is on screen. Returns the function that stops\n * watching; a no-op where this does not apply.\n */\nexport function prefetchWhenVisible(element: Element | null, fire: () => void): () => void {\n  if (!element || savingData()) return () => {}\n\n  budgetPerPage()\n\n  const io = observerFor()\n\n  if (!io) return () => {}\n\n  pending.set(element, fire)\n  io.observe(element)\n\n  return () => {\n    pending.delete(element)\n    io.unobserve(element)\n  }\n}\n"]}
+{"version":3,"file":"viewportPrefetch.js","sourceRoot":"","sources":["../../src/js/viewportPrefetch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Prefetching a link as it comes into view.\n *\n * A navigation is as fast as what is already in the browser when the click\n * lands, and a hover is too late to fetch that: a pointer that has settled\n * on a link is 200-300 ms from clicking it, and on a phone the first signal\n * is touchstart, 100-300 ms before the click - about a round trip either\n * way, so a fetch started there has barely left when the navigation needs\n * it. Next prefetches the links on screen instead, and that is what makes\n * its clicks feel like a single-page app's: the payload was there before\n * the pointer moved. So, on every device, the links on screen are fetched -\n * the bytes only; decoding a payload loads the chunks it names, and that\n * waits for the hover or the touch that says which link is meant. It used\n * to be phones only, with a hover-capable device left to the hover: a click\n * that came quicker than the round trip waited for it, and desktop was\n * fast but not instant.\n *\n * Not when the visitor asked for less data: Save-Data is the one signal a\n * browser gives that speculative requests are unwelcome.\n *\n * One observer for every link, and the work is done when the browser is\n * idle - a list scrolled into view is many links at once, and the browser's\n * per-origin connections should not all be taken by pages nobody has tapped\n * yet.\n *\n * A link asks again each time it comes back into view, and when the tab is\n * visible again. The router keeps a payload for its TTL and ignores the ask\n * until then, so this is a request only for one that expired: a visitor who\n * read for a minute and scrolled back to the nav, or came back to the tab,\n * tapped a link whose payload was thirty seconds gone and waited a round trip\n * for it. Not on a timer: a page left open would refetch every link on it,\n * every thirty seconds, for nobody.\n */\n\nlet observer: IntersectionObserver | null = null\nconst fires = new WeakMap<Element, () => void>()\n/** Links that have spent the page's budget, which asking again does not spend twice. */\nconst counted = new WeakSet<Element>()\n/** On screen now, for the tab coming back. */\nconst inView = new Set<Element>()\n\n/**\n * How many links a page prefetches on sight before the rest wait for\n * intent. A product page's payload is 30 KB with its related products,\n * and a listing shows twenty-four of them: on sight, every one, that was\n * three quarters of a megabyte per page on a phone. The first dozen in\n * view are fetched; a link past the budget is fetched on touch or on a\n * settled hover, a round trip before the click rather than before the\n * scroll. The budget is the page's, and starts again on each navigation.\n */\nconst ON_SIGHT_PER_PAGE = 12\nlet onSight = 0\nlet listening = false\n\nfunction budgetPerPage(): void {\n  if (listening || typeof window === \"undefined\") return\n\n  listening = true\n  window.addEventListener(\"rsc-navigate\", () => {\n    onSight = 0\n  })\n  document.addEventListener(\"visibilitychange\", () => {\n    if (document.visibilityState !== \"visible\") return\n\n    for (const element of inView) {\n      const fire = fires.get(element)\n\n      if (fire && counted.has(element)) whenIdle(fire)\n    }\n  })\n}\n\nfunction savingData(): boolean {\n  const connection = (navigator as { connection?: { saveData?: boolean } }).connection\n\n  return connection?.saveData === true\n}\n\nfunction whenIdle(fn: () => void): void {\n  const idle = (window as { requestIdleCallback?: (fn: () => void, opts?: { timeout: number }) => void }).requestIdleCallback\n\n  if (idle) idle(fn, { timeout: 1000 })\n  else setTimeout(fn, 50)\n}\n\nfunction observerFor(): IntersectionObserver | null {\n  if (observer) return observer\n  if (typeof IntersectionObserver === \"undefined\") return null\n\n  observer = new IntersectionObserver(\n    (entries) => {\n      for (const { isIntersecting, target } of entries) {\n        if (!isIntersecting) {\n          inView.delete(target)\n          continue\n        }\n\n        inView.add(target)\n\n        const fire = fires.get(target)\n\n        if (!fire) continue\n\n        if (!counted.has(target)) {\n          if (onSight >= ON_SIGHT_PER_PAGE) continue\n\n          onSight++\n          counted.add(target)\n        }\n\n        whenIdle(fire)\n      }\n    },\n    // A little ahead of the fold: a link about to scroll into view is one\n    // about to be tapped.\n    { rootMargin: \"200px\" },\n  )\n\n  return observer\n}\n\n/**\n * Prefetch when the link is on screen. Returns the function that stops\n * watching; a no-op where this does not apply.\n */\nexport function prefetchWhenVisible(element: Element | null, fire: () => void): () => void {\n  if (!element || savingData()) return () => {}\n\n  budgetPerPage()\n\n  const io = observerFor()\n\n  if (!io) return () => {}\n\n  fires.set(element, fire)\n  io.observe(element)\n\n  return () => {\n    fires.delete(element)\n    inView.delete(element)\n    io.unobserve(element)\n  }\n}\n"]}

package/dist/vite.js

@@ -35,7 +35,7 @@ import { ownHosts } from "./hostRouting.js";
 import { unrollBarrelImports } from "./barrelImports.js";
 import { hasUseSsr, serverRendererMessage, SERVER_RENDERER, ssrProxyModule, UseSsrError, withoutSsrDirective } from "./useSsr.js";
 import { httpHostCalls } from "./hostCalls.js";
-import { COMMANDS_MODULE_ID, commandFiles, commandsEntry, commandsEntrySource, commandsModule, compileEntryWithCommands } from "./commandFiles.js";
+import { BARE_COMMANDS_ENVIRONMENT, BARE_COMMANDS_MODULE_ID, COMMANDS_MODULE_ID, bareCommandsModule, commandFiles, commandsEntry, commandsEntrySource, commandsModule, compileEntryWithCommands } from "./commandFiles.js";
 import { clientPackages, importsServerRenderer, packageDir as installedPackageDir, packageEntryInGraph, polyfillsToTrace, traceableByName } from "./clientPackages.js";
 // Resolved once per rscKit() call. One build runs in one process, so these are
 // module state rather than threaded through every helper.
@@ -50,6 +50,8 @@ let clientLibraryImports = [];
  * decisions buildApp makes about where stored pages can live.
  */
 let nitroPreset = null;
+/** Set by Nitro's setup of a built server, which asks for the commands before Vite has resolved. */
+let nitroBuilding = false;
 /** `src/commands`, read once per build; null until asked. See buildCommands(). */
 let commandsFound = null;
 /**
@@ -85,7 +87,7 @@ const COMMAND_PRESETS = /^(?:bun|node|node[-_]server|node[-_]cluster)$/;
  * seen.
  */
 function buildCommands() {
-    if (resolvedConfig?.command !== "build")
+    if (resolvedConfig?.command !== "build" && !nitroBuilding)
         return [];
     if (commandsFound)
         return commandsFound;
@@ -2704,12 +2706,14 @@ function commandsPlugin() {
     return {
         name: "rsc-kit:commands",
         resolveId(id) {
-            if (id === COMMANDS_MODULE_ID)
+            if (id === COMMANDS_MODULE_ID || id === BARE_COMMANDS_MODULE_ID)
                 return "\0" + id;
         },
         load(id) {
             if (id === "\0" + COMMANDS_MODULE_ID)
                 return commandsModule(buildCommands());
+            if (id === "\0" + BARE_COMMANDS_MODULE_ID)
+                return bareCommandsModule(buildCommands(), join(packageDir, "commands"));
         },
     };
 }
@@ -7506,6 +7510,30 @@ export function rscKit(options = {}) {
                 if (nitro.options.dev)
                     return;
                 nitroPreset = nitro.options.preset ?? null;
+                nitroBuilding = true;
+                // The commands that did not ask for register() are an entry of the
+                // rsc environment that Nitro would leave behind: it bundles the
+                // server from the environment's main entry only. Given to it as an
+                // entry of the server bundle, it is written beside the server's
+                // `_ssr/rsc.mjs` and shares its chunks - without importing the entry
+                // that imports instrumentation.ts.
+                nitro.hooks.hook("rollup:before", (_nitro, config) => {
+                    if (!buildCommands().some((command) => !command.instrumented))
+                        return;
+                    const file = join(nitro.options.buildDir, "vite", "services", "rsc", BARE_COMMANDS_ENVIRONMENT + ".js");
+                    const input = config.input;
+                    const names = config.output?.entryFileNames;
+                    config.input = {
+                        ...(typeof input === "string" ? { index: input } : Array.isArray(input) ? Object.fromEntries(input.map((entry, i) => [i ? "index" + i : "index", entry])) : input),
+                        [BARE_COMMANDS_ENVIRONMENT]: file,
+                    };
+                    config.output = {
+                        ...config.output,
+                        entryFileNames: (chunk) => chunk.facadeModuleId === file
+                            ? "_ssr/" + BARE_COMMANDS_ENVIRONMENT + ".mjs"
+                            : typeof names === "function" ? names(chunk) : (names ?? "index.mjs"),
+                    };
+                });
                 // The entry a command runs from, beside the server it does not start.
                 // Written once Nitro has assembled the output, because it names a
                 // file Nitro places: if that moves, the build says so rather than a
@@ -7518,6 +7546,10 @@ export function rscKit(options = {}) {
                         throw new Error(`[rsc-kit] src/commands runs from ${join(serverDir, "_ssr", "rsc.mjs")}, and Nitro did not write it there. ` +
                             "Nitro's output layout changed; the commands entry needs to follow it.");
                     }
+                    if (buildCommands().some((command) => !command.instrumented) && !existsSync(join(serverDir, "_ssr", BARE_COMMANDS_ENVIRONMENT + ".mjs"))) {
+                        throw new Error(`[rsc-kit] The commands that do not ask for register() run from ${join(serverDir, "_ssr", BARE_COMMANDS_ENVIRONMENT + ".mjs")}, and Nitro did not write it there. ` +
+                            "Nitro's output layout changed; the commands entry needs to follow it.");
+                    }
                     writeFileSync(join(serverDir, "commands.mjs"), commandsEntrySource(commandEntryOptions()));
                 });
                 // A binary carries what the server would read from node_modules. Once
@@ -7890,7 +7922,16 @@ export function rscKit(options = {}) {
                     rsc: {
                         build: {
                             rollupOptions: {
-                                input: { index: join(genDir, "entry.rsc.tsx") },
+                                input: {
+                                    index: join(genDir, "entry.rsc.tsx"),
+                                    // The commands that did not ask for register(), as an entry
+                                    // of their own beside the server's, so that what they share
+                                    // with it is split out and instrumentation.ts - reached
+                                    // only from the server's entry - stays in that one.
+                                    ...(env.command === "build" && existsSync(join(sourceDir, "commands"))
+                                        ? { [BARE_COMMANDS_ENVIRONMENT]: BARE_COMMANDS_MODULE_ID }
+                                        : {}),
+                                },
                                 external: serverExternals,
                                 // The server-references map is `id: () => import(file)` for
                                 // every "use server" file, and the page that passes an action