@preprio/toolkit 0.6.0-alpha.7 → 0.6.0-alpha.9

package/README.md

@@ -384,14 +384,14 @@ A/B tests go through the same decision as segment groups: both variants are in t
 
 ##### How each visitor gets their variant
 
-Every page view is decided. Nothing is reused from a prefetch, the router cache or another page's view; the only reuse is showing a view again as the visitor just saw it (a reload, Back and Forward).
+Every page view is decided. Nothing is reused from a prefetch, the router cache or another page's view; the browser only reuses a decision this tab already got for the same URL (see **Reuse** below).
 
 - **Page loads.** The page is the same for every visitor and is sent at once, from the cache. An inline script at the start of each `PreprStack` asks the proxy for this view's decision as soon as it is parsed, so Prepr answers while the rest of the page, its styles and scripts (the tracking pixel included) still load. The personalized sections show the visitor's variant when the answer arrives; everything else never waits for it.
-- **Client-side navigations.** When the visitor presses a link, `PreprPersonalizationSwitch` asks the proxy for the target page's decision, and the click waits for the answer. The new page then paints with the visitor's variants. Pressing, not clicking, starts the request, so most of the wait happens while the button is still going down. Prefetches still bring the page itself; only the decision is fetched per click.
+- **Client-side navigations.** When the visitor hovers over a link (or presses it, on touch devices), `PreprPersonalizationSwitch` asks the proxy for the target page's decision. Clicks are never held: when the answer is in by the click, which hovering mostly ensures, the new page paints with the visitor's variants; otherwise its personalized sections show when the answer arrives. Prefetches still bring the page itself; only the decision is fetched.
 - **Never the default first.** Until a view's decision is in, its personalized sections are not shown: the default variant keeps its space, invisible, so the page does not move when the visitor's variant appears (only by any difference in height). The default variant only shows when it is the decision: for visitors in none of the segments, for requests `onlyIf` skips, and when Prepr does not answer within `timeoutMs` (default 3000). Navigations started from code ask for a decision when the page opens; the personalized sections appear when it arrives.
-- **Reloads and Back/Forward.** Back and Forward show a page as this tab last showed it, at once, without asking Prepr. A reload of the same URL within 10 seconds of the decision, with no other page view in between, reuses it too (kept in `sessionStorage`); after that, or after any other page view, the browser asks again. A URL with other UTM parameters is another view. Prepr needs a few seconds to process a visitor's activity anyway, so asking again sooner would mostly get the same answer.
+- **Reuse.** Back and Forward show a page as this tab last showed it, at once, without asking Prepr. Any other view of a URL this tab got a decision for (kept in `sessionStorage`) shows it at once too: under 10 seconds old without asking again, since Prepr needs a few seconds to process a visitor's activity anyway; up to 30 minutes old while a new decision is asked for in the background. When that one differs, it changes only the sections still below the screen; a section the visitor can see, or has scrolled past, keeps its variant for that view, so nothing they are reading is swapped or moves under them. The next view shows the new decision. A page without personalization answers with no groups, which is trusted for an hour with no background check, so links to it cost nothing; when that page renders personalization by then (published since), it asks at once. A URL with other UTM parameters is another view; a failed answer is kept for 10 seconds and never replaces a real one.
 - **"Right" means what Prepr knows when the visitor clicks.** Prepr assigns segments from the visitor's tracked activity. If it has not yet processed the pixel event of the previous page view, the decision cannot include it, and the visitor sees that segment from a later page view.
-- **Costs.** The page carries the HTML of every variant, and an item with groups nested inside it once per combination of their variants. `render` gets `defaultVariant`: give `priority` images only to the default variant and `loading="lazy"` to the others, or the browser downloads every variant's hero image. Every page view and every link press on a site with personalization is one decision request (a press on touch devices too, also when it turns into a scroll), answered from Prepr's cache when other visitors had the same answer.
+- **Costs.** The page carries the HTML of every variant, and an item with groups nested inside it once per combination of their variants. `render` gets `defaultVariant`: give `priority` images only to the default variant and `loading="lazy"` to the others, or the browser downloads every variant's hero image. Every page load with personalization, and every link hovered or pressed (also a press that turns into a scroll), is at most one decision request when this tab has no fresh decision for that URL, answered from Prepr's cache when other visitors had the same answer.
 - Without JavaScript, visitors see the default variants.
 
 ##### Deploying
@@ -1054,7 +1054,7 @@ The toolbar. Takes the props returned by `getToolbarProps`, and renders nothing
 
 #### `PreprPersonalizationSwitch`
 
-From `@preprio/toolkit/nextjs`. Decides every client-side navigation: when the visitor presses a same-site link, it asks `createPreprProxy` for the target page's decision and holds the click until the answer is in (see [How each visitor gets their variant](#how-each-visitor-gets-their-variant)). Mount it once in the root layout, so links on pages without a `PreprStack` are covered too. Clicks with a modifier key, links to other sites and links that open a new tab or download are left alone. The decision requests are answered by `createPreprProxy` only. Takes no props and renders nothing.
+From `@preprio/toolkit/nextjs`. Gets each client-side navigation's decision in before the click: when the visitor hovers over a same-site link (or presses it, on touch devices), it asks `createPreprProxy` for the target page's decision. Clicks are never held (see [How each visitor gets their variant](#how-each-visitor-gets-their-variant)). Mount it once in the root layout, so links on pages without a `PreprStack` are covered too. Links to other sites and links that open a new tab or download are left alone. The decision requests are answered by `createPreprProxy` only. Takes no props and renders nothing.
 
 #### `PreprPreview`
 

package/dist/astro/{chunk-3EXK2LHI.js → chunk-UN4JADNU.js}

@@ -1,5 +1,5 @@
 // src/version.ts
-var VERSION = "0.6.0-alpha.7";
+var VERSION = "0.6.0-alpha.9";
 
 // src/core/features.ts
 function isEnabled(config) {

package/dist/astro/graphql.js

@@ -3,7 +3,7 @@ import {
   getPreprHeadersFromHeaders,
   isPersonalizedResponse,
   validatePreprToken
-} from "./chunk-3EXK2LHI.js";
+} from "./chunk-UN4JADNU.js";
 
 // src/core/variants/constants.ts
 var PREPR_CONTEXT_ALIAS = "_preprContext";

package/dist/astro/index.cjs

@@ -31,7 +31,7 @@ __export(astro_exports, {
 module.exports = __toCommonJS(astro_exports);
 
 // src/version.ts
-var VERSION = "0.6.0-alpha.7";
+var VERSION = "0.6.0-alpha.9";
 
 // src/core/features.ts
 function isEnabled(config) {

package/dist/astro/index.js

@@ -7,7 +7,7 @@ import {
   getToolbarPropsFromHeaders,
   isPersonalizedResponse,
   resolveFeatures
-} from "./chunk-3EXK2LHI.js";
+} from "./chunk-UN4JADNU.js";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";

package/dist/{chunk-VQIPTUN4.js → chunk-5QIWVDP2.js}

@@ -1,5 +1,5 @@
 // src/version.ts
-var VERSION = "0.6.0-alpha.7";
+var VERSION = "0.6.0-alpha.9";
 
 // src/core/features.ts
 function isEnabled(config) {

package/dist/{chunk-U7TRFVK7.js → chunk-J66UOCK6.js}

@@ -11,7 +11,7 @@ import {
   ALL_FEATURES_ENABLED,
   VERSION,
   resolveFeatures
-} from "./chunk-VQIPTUN4.js";
+} from "./chunk-5QIWVDP2.js";
 
 // src/core/stega/dom.ts
 var IGNORED_ANCESTORS = "script, style, noscript";

package/dist/{chunk-3QGWCYTL.js → chunk-WQBKQG4R.js}

@@ -1,7 +1,7 @@
 import {
   VERSION,
   resolveFeatures
-} from "./chunk-VQIPTUN4.js";
+} from "./chunk-5QIWVDP2.js";
 
 // src/core/server.ts
 var PreprError = class extends Error {

package/dist/{chunk-PFJO4TYL.js → chunk-XL4Y7FGW.js}

@@ -1,6 +1,6 @@
 import {
   PreprError
-} from "./chunk-3QGWCYTL.js";
+} from "./chunk-WQBKQG4R.js";
 
 // src/core/variants/constants.ts
 var PREPR_CONTEXT_ALIAS = "_preprContext";

package/dist/graphql/codegen.js

@@ -2,9 +2,9 @@ import {
   toDecisionQuery,
   toSchemaInfo,
   toVariantsQuery
-} from "../chunk-PFJO4TYL.js";
-import "../chunk-3QGWCYTL.js";
-import "../chunk-VQIPTUN4.js";
+} from "../chunk-XL4Y7FGW.js";
+import "../chunk-WQBKQG4R.js";
+import "../chunk-5QIWVDP2.js";
 
 // src/codegen/index.ts
 function typeRef(type) {

package/dist/graphql.js

@@ -21,12 +21,12 @@ import {
   toSchemaInfo,
   toVariantsDocument,
   toVariantsQuery
-} from "./chunk-PFJO4TYL.js";
+} from "./chunk-XL4Y7FGW.js";
 import {
   PreprError,
   validatePreprToken
-} from "./chunk-3QGWCYTL.js";
-import "./chunk-VQIPTUN4.js";
+} from "./chunk-WQBKQG4R.js";
+import "./chunk-5QIWVDP2.js";
 
 // src/core/graphql/cache-tags.ts
 var MAX_TAGS = 128;

package/dist/index.cjs

@@ -45,7 +45,7 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // src/version.ts
-var VERSION = "0.6.0-alpha.7";
+var VERSION = "0.6.0-alpha.9";
 
 // src/core/features.ts
 function isEnabled(config) {

package/dist/index.d.cts

@@ -7,7 +7,7 @@ export { P as PreprPixelConfig, l as loadTrackingPixel, s as setTrackingParam, t
  * Package version; must match package.json. Lives in its own leaf module so
  * core can import it without cycling through the barrel.
  */
-declare const VERSION = "0.6.0-alpha.7";
+declare const VERSION = "0.6.0-alpha.9";
 
 /**
  * Resolve a `PreprFeatures` bag to plain booleans, defaulting every omitted key

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export { P as PreprPixelConfig, l as loadTrackingPixel, s as setTrackingParam, t
  * Package version; must match package.json. Lives in its own leaf module so
  * core can import it without cycling through the barrel.
  */
-declare const VERSION = "0.6.0-alpha.7";
+declare const VERSION = "0.6.0-alpha.9";
 
 /**
  * Resolve a `PreprFeatures` bag to plain booleans, defaulting every omitted key

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   loadTrackingPixel,
   setTrackingParam,
   trackEvent
-} from "./chunk-U7TRFVK7.js";
+} from "./chunk-J66UOCK6.js";
 import {
   isPersonalizedResponse
 } from "./chunk-3NCEVJJ3.js";
@@ -32,11 +32,11 @@ import {
   getPreprUUIDFromHeaders,
   getToolbarPropsFromHeaders,
   validatePreprToken
-} from "./chunk-3QGWCYTL.js";
+} from "./chunk-WQBKQG4R.js";
 import {
   VERSION,
   resolveFeatures
-} from "./chunk-VQIPTUN4.js";
+} from "./chunk-5QIWVDP2.js";
 
 // src/core/middleware.ts
 var UTM_PARAMS = [

package/dist/nextjs/{chunk-CZK7SMBD.js → chunk-CMV6ZP6E.js}

@@ -2,7 +2,7 @@
 import { NextResponse } from "next/server";
 
 // src/version.ts
-var VERSION = "0.6.0-alpha.7";
+var VERSION = "0.6.0-alpha.9";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";

package/dist/nextjs/components.cjs

@@ -2317,10 +2317,34 @@ function isReactHydrated(text) {
 }
 
 // src/nextjs/decision-switch.ts
-function applyPreprDecisions(decision) {
+function applyPreprDecisions(decision, options = {}) {
   const state = window;
   const key = location.pathname + location.search;
-  if (decision !== void 0) state.__preprDecision = { key, value: decision };
+  const previous = state.__preprDecision;
+  let value = decision;
+  if (value !== void 0 && value !== "*" && options.refresh && previous && previous.key === key && previous.value !== "*") {
+    const pairs = (from) => {
+      const out = {};
+      from.split("~").forEach((pair) => {
+        const colon = pair.indexOf(":");
+        if (colon > 0) out[pair.slice(0, colon)] = pair;
+      });
+      return out;
+    };
+    const before = pairs(previous.value);
+    const after = pairs(value);
+    document.querySelectorAll("[data-prepr-v][data-prepr-show]").forEach((element) => {
+      const range = document.createRange();
+      range.selectNodeContents(element);
+      if (range.getBoundingClientRect().top >= window.innerHeight) return;
+      (element.getAttribute("data-prepr-v") || "").split(" ").forEach((token) => {
+        const group = token.slice(0, token.indexOf(":"));
+        if (before[group]) after[group] = before[group];
+      });
+    });
+    value = Object.keys(after).map((group) => after[group]).join("~");
+  }
+  if (value !== void 0) state.__preprDecision = { key, value };
   const current = state.__preprDecision;
   if (!current || current.key !== key) return false;
   document.querySelectorAll("[data-prepr-decision]").forEach((marker) => {
@@ -2346,12 +2370,76 @@ function applyPreprDecisions(decision) {
   });
   return true;
 }
+function requestPreprDecision(key, options = {}) {
+  const fresh = 1e4;
+  const keep = 18e5;
+  const keepStatic = 36e5;
+  const state = window;
+  const asking = state.__preprAsking = state.__preprAsking || {};
+  const read = () => {
+    try {
+      const all = JSON.parse(sessionStorage.getItem("prepr_decisions") || "{}");
+      return all && typeof all === "object" ? all : {};
+    } catch {
+      return {};
+    }
+  };
+  const ask = () => {
+    if (!asking[key]) {
+      asking[key] = fetch(key, {
+        headers: { "Prepr-Decide": "1" },
+        cache: "no-store",
+        credentials: "same-origin",
+        // The proxy gives up on Prepr after its own `timeoutMs`; this only
+        // covers a proxy that never answers.
+        signal: AbortSignal.timeout ? AbortSignal.timeout(6e3) : void 0
+      }).then((response) => response.ok ? response.text() : "*").catch(() => "*").then((answer) => {
+        delete asking[key];
+        try {
+          const all = read();
+          const at = Date.now();
+          Object.keys(all).forEach((stored) => {
+            const entry = all[stored];
+            if (!(entry && typeof entry.at === "number" && at - entry.at < keepStatic))
+              delete all[stored];
+          });
+          const kept = all[key];
+          if (answer !== "*" || !kept || kept.value === "*")
+            all[key] = { value: answer, at };
+          sessionStorage.setItem("prepr_decisions", JSON.stringify(all));
+        } catch {
+        }
+        return answer;
+      });
+    }
+    return asking[key];
+  };
+  const last = read()[key];
+  const age = last && typeof last.at === "number" ? Date.now() - last.at : -1;
+  const value = last && typeof last.value === "string" ? last.value : null;
+  if (value !== null && !(value === "" && options.personalized) && age >= 0 && age < (value === "*" ? fresh : value === "" ? keepStatic : keep)) {
+    if (value !== "" && age >= fresh) {
+      ask().then((answer) => {
+        if (answer !== "*" && answer !== value && options.onChange)
+          options.onChange(answer);
+      });
+    }
+    return { result: value, value: Promise.resolve(value) };
+  }
+  const pending = {
+    value: ask()
+  };
+  pending.value.then((answer) => {
+    pending.result = answer;
+  });
+  return pending;
+}
 
 // src/react/components.ts
 var import_react = require("react");
 
 // src/version.ts
-var VERSION = "0.6.0-alpha.7";
+var VERSION = "0.6.0-alpha.9";
 
 // src/core/pixel.ts
 var PIXEL_SCRIPT_URL = "https://cdn.tracking.prepr.io/js/prepr.min.js";
@@ -2426,35 +2514,22 @@ function PreprToolbar({
   }, []);
   return null;
 }
-var DECIDE_HEADER = "Prepr-Decide";
-var DECIDE_TIMEOUT_MS = 6e3;
-function requestDecision(key) {
-  const pending = { key, value: null };
-  pending.value = fetch(key, {
-    headers: { [DECIDE_HEADER]: "1" },
-    cache: "no-store",
-    credentials: "same-origin",
-    signal: AbortSignal.timeout(DECIDE_TIMEOUT_MS)
-  }).then((response) => response.ok ? response.text() : "*").catch(() => "*").then((value) => {
-    pending.result = value;
-    try {
-      sessionStorage.setItem(
-        "prepr_decision",
-        JSON.stringify({ key, value, at: Date.now() })
-      );
-    } catch {
-    }
-    return value;
-  });
-  return pending;
-}
-var pressed = null;
-var replaying = null;
 var shown = /* @__PURE__ */ new Map();
 var historyStep = false;
 var onPopState = () => {
   historyStep = true;
 };
+function requestDecision(key, personalized = false) {
+  return requestPreprDecision(key, {
+    personalized,
+    onChange: (value) => {
+      if (location.pathname + location.search !== key) return;
+      applyPreprDecisions(value, { refresh: true });
+      const state = window.__preprDecision;
+      if (state) shown.set(key, state.value);
+    }
+  });
+}
 function linkTarget(event) {
   const anchor = event.target?.closest?.("a[href]");
   if (!(anchor instanceof HTMLAnchorElement)) return null;
@@ -2466,55 +2541,37 @@ function linkTarget(event) {
   if (url.origin !== location.origin || key === location.pathname + location.search) {
     return null;
   }
-  return { anchor, key };
+  return key;
+}
+var HOVER_DELAY_MS = 65;
+var hovering = null;
+function onPointerOver(event) {
+  if (event.pointerType !== "mouse") return;
+  const key = linkTarget(event);
+  if (hovering?.key === key) return;
+  if (hovering) clearTimeout(hovering.timer);
+  hovering = key ? { key, timer: setTimeout(() => requestDecision(key), HOVER_DELAY_MS) } : null;
 }
 function onPointerDown(event) {
   if (event.button !== 0) return;
-  const target = linkTarget(event);
-  if (!target || pressed?.key === target.key && pressed.result === void 0) {
-    return;
-  }
-  pressed = requestDecision(target.key);
-}
-function onClick(event) {
-  const target = linkTarget(event);
-  if (!target) return;
-  if (replaying === target.anchor) {
-    replaying = null;
-    return;
-  }
-  if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {
-    return;
-  }
-  const pending = pressed && pressed.key === target.key ? pressed : requestDecision(target.key);
-  pressed = null;
-  const record = (value) => {
-    window.__preprDecision = { key: target.key, value };
-  };
-  if (pending.result !== void 0) {
-    record(pending.result);
-    return;
-  }
-  event.preventDefault();
-  event.stopImmediatePropagation();
-  void pending.value.then((value) => {
-    record(value);
-    replaying = target.anchor;
-    target.anchor.click();
-  });
+  const key = linkTarget(event);
+  if (key) requestDecision(key);
 }
 var listeners = 0;
 function useDecisionRequests() {
   (0, import_react2.useEffect)(() => {
     if (listeners++ === 0) {
-      window.addEventListener("pointerdown", onPointerDown, true);
-      window.addEventListener("click", onClick, true);
+      window.addEventListener("pointerover", onPointerOver, { passive: true });
+      window.addEventListener("pointerdown", onPointerDown, {
+        capture: true,
+        passive: true
+      });
       window.addEventListener("popstate", onPopState);
     }
     return () => {
       if (--listeners === 0) {
+        window.removeEventListener("pointerover", onPointerOver);
         window.removeEventListener("pointerdown", onPointerDown, true);
-        window.removeEventListener("click", onClick, true);
         window.removeEventListener("popstate", onPopState);
       }
     };
@@ -2538,12 +2595,16 @@ function PreprDecisionApplier() {
       remember();
       return;
     }
+    const pending = requestDecision(key, true);
+    if (pending.result !== void 0) {
+      applyPreprDecisions(pending.result);
+      remember();
+      return;
+    }
     let live = true;
-    const started = window.__preprPending;
-    const value = started?.key === key ? started.value : requestDecision(key).value;
-    void value.then((value2) => {
+    void pending.value.then((value) => {
       if (live && location.pathname + location.search === key) {
-        applyPreprDecisions(value2);
+        applyPreprDecisions(value);
         remember();
       }
     });

package/dist/nextjs/components.d.cts

@@ -23,15 +23,17 @@ declare function PreprTrackingPixel({ id, config, }: PreprTrackingPixelProps): n
  */
 declare function PreprToolbar({ options, ...props }: PreprToolbarComponentProps): null;
 /**
- * Decides every client-side navigation to another page: when the visitor
- * presses a same-site link, it asks `createPreprProxy` which variants they
- * get on that page, and holds the click until the answer is in. The new page
- * then paints with those variants, never with the default variant first.
- * Pressing starts the request, so the wait mostly overlaps the click itself.
+ * Gets each client-side navigation's decision in before the click: when the
+ * visitor hovers over a same-site link (or presses it, on touch devices), it
+ * asks `createPreprProxy` which variants they get on that page. Clicks are
+ * never held: the new page paints with those variants when the answer is in,
+ * and keeps its personalized sections hidden until then otherwise. Pages
+ * without personalization answer with no groups and are not asked again for
+ * an hour.
  *
  * Mount it once in the root layout, so links on pages without a
- * `PreprStack` are covered too. Clicks with a modifier key, links to other
- * sites and links that open a new tab or download are left alone.
+ * `PreprStack` are covered too. Links to other sites and links that open a
+ * new tab or download are left alone.
  *
  * @example
  * <PreprPersonalizationSwitch />
@@ -39,12 +41,11 @@ declare function PreprToolbar({ options, ...props }: PreprToolbarComponentProps)
 declare function PreprPersonalizationSwitch(): null;
 /**
  * Applies this page view's decision to the variant wrappers of the
- * `PreprStack` it is rendered by. A click's decision is in before the page
- * paints; Back and Forward show the page as this tab last showed it. On a
- * page load, and any other view without a decision (a navigation started
- * from code, or Back to a page this tab never showed), its personalized
- * sections stay hidden until the decision request answers. Rendered by
- * `PreprStack`; you do not need it yourself.
+ * `PreprStack` it is rendered by, before the page paints when the decision is
+ * already in: asked for on hover, or kept from an earlier view of the page.
+ * Back and Forward show the page as this tab last showed it. Any other view
+ * keeps its personalized sections hidden until the decision request answers.
+ * Rendered by `PreprStack`; you do not need it yourself.
  */
 declare function PreprDecisionApplier(): null;
 /**

package/dist/nextjs/components.d.ts

@@ -23,15 +23,17 @@ declare function PreprTrackingPixel({ id, config, }: PreprTrackingPixelProps): n
  */
 declare function PreprToolbar({ options, ...props }: PreprToolbarComponentProps): null;
 /**
- * Decides every client-side navigation to another page: when the visitor
- * presses a same-site link, it asks `createPreprProxy` which variants they
- * get on that page, and holds the click until the answer is in. The new page
- * then paints with those variants, never with the default variant first.
- * Pressing starts the request, so the wait mostly overlaps the click itself.
+ * Gets each client-side navigation's decision in before the click: when the
+ * visitor hovers over a same-site link (or presses it, on touch devices), it
+ * asks `createPreprProxy` which variants they get on that page. Clicks are
+ * never held: the new page paints with those variants when the answer is in,
+ * and keeps its personalized sections hidden until then otherwise. Pages
+ * without personalization answer with no groups and are not asked again for
+ * an hour.
  *
  * Mount it once in the root layout, so links on pages without a
- * `PreprStack` are covered too. Clicks with a modifier key, links to other
- * sites and links that open a new tab or download are left alone.
+ * `PreprStack` are covered too. Links to other sites and links that open a
+ * new tab or download are left alone.
  *
  * @example
  * <PreprPersonalizationSwitch />
@@ -39,12 +41,11 @@ declare function PreprToolbar({ options, ...props }: PreprToolbarComponentProps)
 declare function PreprPersonalizationSwitch(): null;
 /**
  * Applies this page view's decision to the variant wrappers of the
- * `PreprStack` it is rendered by. A click's decision is in before the page
- * paints; Back and Forward show the page as this tab last showed it. On a
- * page load, and any other view without a decision (a navigation started
- * from code, or Back to a page this tab never showed), its personalized
- * sections stay hidden until the decision request answers. Rendered by
- * `PreprStack`; you do not need it yourself.
+ * `PreprStack` it is rendered by, before the page paints when the decision is
+ * already in: asked for on hover, or kept from an earlier view of the page.
+ * Back and Forward show the page as this tab last showed it. Any other view
+ * keeps its personalized sections hidden until the decision request answers.
+ * Rendered by `PreprStack`; you do not need it yourself.
  */
 declare function PreprDecisionApplier(): null;
 /**