@thg-agentic/hyper-personalisation-web 3.31.0 → 3.34.0

package/src/onsite/index.js

@@ -6,7 +6,7 @@
  *   startOnsite(hp); // the client bootstrap resolved to, or pass `onsite: true` to bootstrap
  *
  * The browser judges the trigger; the server decides the rest. Each live form's trigger is watched
- * here, with its pages, devices, dates and caps. When one fires, `POST /v1/decisions` is asked for
+ * here, with its pages, devices, dates, daily cut-off and caps. When one fires, `POST /v1/decisions` is asked for
  * that one slot: a held-out visitor, or no decision, shows nothing. One overlay per page view, the
  * highest priority among those that fire within 50 ms; one that cannot show passes to the next, but
  * a held-out visitor sees none, and once one has shown, closing it lets no other in; with the
@@ -21,19 +21,25 @@ import { loadAnswers } from './answers-loader.js';
 import { createApi } from './api.js';
 import { loadAudiences } from './audiences-loader.js';
 import { createCounters } from './counters.js';
+import { factsFor, pageFacts } from './page-facts.js';
 import { loadProducts } from './products-loader.js';
 import { loadRender } from './render-loader.js';
+import { holdsValue } from './rich-text.js';
 import {
 	ASKED,
 	blockers,
 	byPriority,
 	deviceOf,
 	INTERRUPTS,
+	OUTSIDE_WINDOW,
 	OVERLAY,
+	opensIn,
 	readCreative,
 	readForm,
+	UNSAID,
 } from './rules.js';
 import { watch } from './triggers.js';
+import { loadValues } from './values-loader.js';
 import { loadWheel } from './wheel-loader.js';
 
 const ACCESS = Symbol.for(
@@ -46,6 +52,9 @@ const PENDING = Symbol.for(
 const LISTENERS = Symbol.for(
 	'@thg-agentic/hyper-personalisation-web.onsite.listeners',
 );
+const PAGE_SAID = Symbol.for(
+	'@thg-agentic/hyper-personalisation-web.onsite.page-said',
+);
 const SUPPRESSED = Symbol.for(
 	'@thg-agentic/hyper-personalisation-web.onsite.suppressed',
 );
@@ -75,6 +84,7 @@ const NOTHING = new Set([
 	'no-code',
 	'renderer-failed',
 	'products-failed',
+	'values-failed',
 	'error',
 ]);
 
@@ -102,14 +112,9 @@ const debugParam = () => {
 	}
 };
 
-/** Whether a creative shows a products block on any step. */
-const showsProducts = (creative) =>
-	Array.isArray(creative?.steps) &&
-	creative.steps.some(
-		(step) =>
-			Array.isArray(step?.blocks) &&
-			step.blocks.some((block) => block?.t === 'products'),
-	);
+/** Whether any block of any of the creative's steps meets `uses`. */
+const stepsUse = (creative, uses) =>
+	creative.steps.some((step) => step.blocks.some(uses));
 
 /**
  * Start onsite forms for `client`, once per page. Returns the controller, or null without a
@@ -228,6 +233,11 @@ export function startOnsite(client, options = {}) {
 	};
 	/** Forms whose trigger fired on an empty basket: they try again when the basket changes. */
 	const awaitingBasket = new Set();
+	/**
+	 * Teasers' tabs kept from an earlier page, held back only until the page says what it is about
+	 * (its facts, its product), which it may do after onsite starts: they try again when it does.
+	 */
+	const awaitingPage = new Set();
 	/** Covering forms whose trigger fired before the consent banner was answered. */
 	const awaitingConsent = new Map();
 
@@ -291,6 +301,9 @@ export function startOnsite(client, options = {}) {
 		path: location.pathname,
 		device,
 		campaign: campaign(),
+		// What the page says, and the product it is about: both held in memory, cheap to read.
+		facts: pageFacts(),
+		product: access.pageProduct?.(),
 		now: Date.now(),
 		seen: counters.seen(form.slot),
 		subscribed: counters.subscribed() || options.subscribed?.() === true,
@@ -359,8 +372,30 @@ export function startOnsite(client, options = {}) {
 			asked,
 		});
 		if (reasons.length) {
+			if (kept && reasons.every((r) => UNSAID.includes(r)))
+				awaitingPage.add(form);
+			// A trigger that fired before the form's daily window opened is watched again once it
+			// opens, so the shopper's next exit (or the page's entry) still counts.
+			if (
+				reasons.length === 1 &&
+				reasons[0] === OUTSIDE_WINDOW &&
+				!asked &&
+				!kept &&
+				!stopped
+			) {
+				const inline =
+					form.trigger.type === 'inline' || form.format === 'inline';
+				// In place of any watcher it still has (the site opened it by hand), never beside it.
+				unwatch(form);
+				const later = setTimeout(
+					() => (inline ? show(form, 'inline') : arm(form)),
+					opensIn(form, Date.now()),
+				);
+				stops.set(form.slot, () => clearTimeout(later));
+			}
 			return note(form, 'not eligible', 'not-eligible', reasons);
 		}
+		awaitingPage.delete(form);
 		// The gap first: it holds for the whole session, so it is the reason worth reading.
 		const interrupts = INTERRUPTS(form.format) && !kept;
 		const wait = interrupts && !asked && gapHolds();
@@ -444,11 +479,17 @@ export function startOnsite(client, options = {}) {
 						api.decide(form.slot, counters.pin(form.slot), {
 							visitAudiences: claimed,
 							visitCampaign: form.arrived_from.length ? campaign() : null,
-							// Only for a form whose products are filled from it; never kept or logged by the server.
+							// Only for a form whose products are filled from it, or limited to products (then only
+							// the page's product); never kept or logged by the server.
 							visitContext:
 								form.visit_context === true
 									? (access.visitContext?.() ?? null)
-									: null,
+									: form.products
+										? { product_id: access.pageProduct?.() }
+										: null,
+							pageFacts: form.page_facts.length
+								? factsFor(form.page_facts, pageFacts())
+								: null,
 							timeoutMs: deadline - Date.now(),
 						}),
 						deadline,
@@ -521,20 +562,36 @@ export function startOnsite(client, options = {}) {
 			return drop(form, 'not shown', 'renderer-failed', [
 				'the renderer did not load',
 			]);
-		// Its products are drawn by their own chunk: without it the form would open on an empty block.
-		if (showsProducts(creative)) {
-			cards ??= loadProducts().catch(() => null);
-			if (!(await within(cards, deadline, null)))
-				return drop(form, 'not shown', 'products-failed', [
-					'its products did not load',
-				]);
-		}
-		// Its first step's pictures fetched and decoded first, so it never opens on an empty one, and
-		// never waits for them longer than WARM_MS or past its deadline.
-		await within(
+		// Its products and its text's values are drawn by chunks of their own, fetched together while
+		// its first step's pictures warm: without them the form would open on an empty block, or on
+		// text with a gap. The pictures are waited for no longer than WARM_MS or past its deadline.
+		const products = stepsUse(creative, (b) => b?.t === 'products');
+		if (products) cards ??= loadProducts().catch(() => null);
+		const warming = within(
 			render.warm?.(form, creative, creative.steps[0].id, warmed),
 			Math.min(deadline, Date.now() + WARM_MS),
 		);
+		const [drawn, values] = await Promise.all([
+			!products || within(cards, deadline, null),
+			stepsUse(
+				creative,
+				(b) => (b?.t === 'heading' || b?.t === 'text') && holdsValue(b.text),
+			) &&
+				within(
+					loadValues().catch(() => null),
+					deadline,
+					null,
+				),
+		]);
+		if (!drawn)
+			return drop(form, 'not shown', 'products-failed', [
+				'its products did not load',
+			]);
+		if (values === null)
+			return drop(form, 'not shown', 'values-failed', [
+				'its values did not load',
+			]);
+		await warming;
 		if (suppressed())
 			return drop(form, 'not shown', 'suppressed', ['suppressed']);
 		const tell = (name, detail = {}) =>
@@ -559,6 +616,7 @@ export function startOnsite(client, options = {}) {
 			warmed,
 			coupon,
 			basket: () => access.basketValue?.() ?? null,
+			fill: values ? values.fillFor(form, access, options.values) : undefined,
 			emit: tell,
 			onClose(why) {
 				mounted.delete(form.slot);
@@ -636,7 +694,10 @@ export function startOnsite(client, options = {}) {
 			show(form, 'tab kept from an earlier page', true);
 			continue;
 		}
-		const reasons = blockers(form, env(form));
+		// What the page says, which product it is about, and whether its daily window is open may
+		// all change while the shopper is on it, so a form waits on its trigger for them; they are
+		// judged when it fires.
+		const reasons = blockers(form, { ...env(form), later: true });
 		if (reasons.length) {
 			note(form, 'not eligible', 'not-eligible', reasons);
 			continue;
@@ -677,6 +738,20 @@ export function startOnsite(client, options = {}) {
 				asked ? fire(form, 'manual', asked) : arm(form);
 	});
 
+	const heard = () => {
+		const waiting = [...awaitingPage];
+		awaitingPage.clear();
+		// After any attempt still settling: it judged the page before the page said so.
+		for (const form of waiting)
+			Promise.resolve(opening.get(form.slot)?.done).then(
+				() =>
+					stopped ||
+					mounted.has(form.slot) ||
+					show(form, 'tab kept from an earlier page', true),
+			);
+	};
+	(window[PAGE_SAID] ??= new Set()).add(heard);
+
 	const stopBasket = access.onBasket?.(() => {
 		if (!((access.basketValue?.() ?? 0) > 0)) return;
 		// Out of the set before the decision is asked, so a second update cannot show them twice;
@@ -729,6 +804,8 @@ export function startOnsite(client, options = {}) {
 			stopConsent?.();
 			awaitingBasket.clear();
 			awaitingConsent.clear();
+			awaitingPage.clear();
+			window[PAGE_SAID]?.delete(heard);
 			if (window[CONTROLLER] === controller) delete window[CONTROLLER];
 		},
 	});

package/src/onsite/money.js

@@ -0,0 +1,11 @@
+/** Money in `currency` for the language `lang` (else the browser's); null for a currency `Intl` does not know. */
+export function money(lang, currency) {
+	try {
+		return new Intl.NumberFormat(lang || undefined, {
+			style: 'currency',
+			currency,
+		});
+	} catch {
+		return null;
+	}
+}

package/src/onsite/page-facts.js

@@ -0,0 +1,61 @@
+/**
+ * Page facts (#1164): what the page says about itself, given with `hp.onsite.facts({ … })`, such as
+ * whether the product on it can be delivered tomorrow. Kept in the page's memory for the path it was
+ * given on, so a single-page app's next page starts with none; an anchor or a variant's query on the
+ * same path keeps them. A form's
+ * `page_facts` rules are judged here and again by the public API, which reads the facts the request carries (only those the rules
+ * read) and drops any that are not a fact: both run spec/onsite/examples/page-facts.cases.json.
+ */
+
+/** Where `hp.onsite.facts` (../onsite-facade.js) keeps them: the page's, not this chunk's. */
+const PAGE_FACTS = Symbol.for(
+	'@thg-agentic/hyper-personalisation-web.onsite.page-facts',
+);
+
+/** The facts this page gave, on the path it is on now; `{}` when none. */
+export function pageFacts(win = globalThis.window) {
+	const held = win?.[PAGE_FACTS];
+	return held?.path === win?.location?.pathname ? held.facts : {};
+}
+
+/** A fact as the public API reads it: words up to 100 characters. */
+const read = (v) => (typeof v === 'string' ? v.slice(0, 100) : v);
+
+const norm = (v) => (typeof v === 'string' ? v.trim().toLowerCase() : v);
+
+/**
+ * Whether `facts` meets every rule. A fact the page did not give, or gave as another kind, meets no
+ * rule on it, `is_not` included; a rule this SDK cannot read meets none. No rules is any page. The
+ * control plane's `pageFactsHold` is the same.
+ *
+ * @param {Array<{ fact: string, op: string, values: unknown[] }>} rules
+ * @param {Record<string, unknown> | null} facts
+ */
+export const pageFactsHold = (rules, facts) =>
+	rules.every((rule) => {
+		// As the public API reads them, and only finite numbers.
+		const have = read(facts?.[rule.fact]);
+		const values = Array.isArray(rule.values) ? rule.values : [];
+		if (
+			have == null ||
+			typeof have !== typeof values[0] ||
+			(typeof have === 'number' && !Number.isFinite(have))
+		)
+			return false;
+		const any = values.some((want) => norm(want) === norm(have));
+		return rule.op === 'is'
+			? any
+			: rule.op === 'is_not'
+				? !any
+				: rule.op === 'at_least'
+					? have >= values[0]
+					: rule.op === 'at_most' && have <= values[0];
+	});
+
+/** Only the facts `rules` read, for the decision request: nothing else the page gave leaves it. */
+export const factsFor = (rules, facts) =>
+	Object.fromEntries(
+		rules
+			.filter((r) => r.fact in facts)
+			.map((r) => [r.fact, read(facts[r.fact])]),
+	);

package/src/onsite/preview.js

@@ -10,9 +10,12 @@ import { answerCards, answerFields, answerOf, countdown } from './answers.js';
 import { mountProducts } from './products.js';
 import { mountForm } from './render.js';
 import { readCreative } from './rules.js';
+import { fillFor } from './values.js';
 import { mountWheel } from './wheel.js';
 
 export { CALLING_CODES } from './rules.js';
+/** A shopper value as the SDK shows it, so the console's examples read as shoppers see them. */
+export { formatValue } from './values.js';
 
 const SAMPLE_CONSENT = 'Your consent text appears here.';
 const SAMPLE_SMS_CONSENT = 'Your SMS consent text appears here.';
@@ -35,7 +38,12 @@ const SAMPLE_BASKET = 32;
  * @param {unknown} creative The arm's payload.
  * @param {{ step?: string, device?: 'desktop'|'mobile', consentText?: string, smsConsentText?: string, locale?: string,
  *   questions?: Array<{ key: string, type?: 'one'|'many'|'date'|'number', label?: string, options?: Array<{ value: string, label?: string }>, format?: object }>,
- *   prizes?: Array<{ key: string, label: string }>, basketValue?: number }} [options]
+ *   prizes?: Array<{ key: string, label: string }>, basketValue?: number, daily?: object,
+ *   values?: { first_name?: string, basket_value?: number, basket_items?: number, currency?: string, answers?: Record<string, string[]> } | null }} [options]
+ *   `values`: a returning shopper's, for the text's shopper values; without them every value shows
+ *   its fallback, as for a new visitor, but for an answer given in the form itself. `daily`: the
+ *   form's daily cut-off as the settings carry it (`window.daily`, its moments), which a `daily`
+ *   countdown counts to.
  * @returns {{ update(creative: unknown, options?: object): void, destroy(): void, step(): string|null }}
  */
 export function mountPreview(host, creative, options = {}) {
@@ -48,19 +56,26 @@ export function mountPreview(host, creative, options = {}) {
 		mounted = null;
 		if (!read) return;
 		const format = read.format ?? 'popup';
+		const form = {
+			slot: 'preview',
+			format,
+			// The settings' `locale`, so the preview orders a birthday and picks a phone's
+			// country as shoppers see them, not by the console's own language.
+			...(opts.locale ? { locale: opts.locale } : {}),
+			consent_text: { text: opts.consentText ?? SAMPLE_CONSENT },
+			sms_consent_text: { text: opts.smsConsentText ?? SAMPLE_SMS_CONSENT },
+			questions: Array.isArray(opts.questions) ? opts.questions : [],
+			prizes: Array.isArray(opts.prizes) ? opts.prizes : [],
+			window: opts.daily ? { daily: opts.daily } : {},
+		};
+		const values = opts.values ?? null;
 		mounted = mountForm({
-			form: {
-				slot: 'preview',
-				format,
-				// The settings' `locale`, so the preview orders a birthday and picks a phone's
-				// country as shoppers see them, not by the console's own language.
-				...(opts.locale ? { locale: opts.locale } : {}),
-				consent_text: { text: opts.consentText ?? SAMPLE_CONSENT },
-				sms_consent_text: { text: opts.smsConsentText ?? SAMPLE_SMS_CONSENT },
-				questions: Array.isArray(opts.questions) ? opts.questions : [],
-				prizes: Array.isArray(opts.prizes) ? opts.prizes : [],
-			},
+			form,
 			creative: read,
+			fill: fillFor(form, {
+				// A new visitor: nothing known yet, though the answers they give in the form show.
+				values: () => values ?? { answers: {} },
+			}),
 			decision: { slot: 'preview' },
 			access: silent,
 			client: null,

package/src/onsite/products.js

@@ -10,6 +10,7 @@
  */
 
 import { watchViewability } from '../auto/viewability.js';
+import { money } from './money.js';
 import { httpsHref } from './rich-text.js';
 import { isObject } from './rules.js';
 
@@ -42,15 +43,8 @@ const ALIGNS = ['left', 'center', 'right'];
 
 /** Money in the form's language; the bare amount for a currency the browser does not know. */
 function moneyIn(lang, currency) {
-	try {
-		const format = new Intl.NumberFormat(lang || undefined, {
-			style: 'currency',
-			currency,
-		});
-		return (n) => format.format(n);
-	} catch {
-		return (n) => n.toFixed(2);
-	}
+	const format = money(lang, currency);
+	return format ? (n) => format.format(n) : (n) => n.toFixed(2);
 }
 
 /**

package/src/onsite/render.js

@@ -352,6 +352,8 @@ function styles(root) {
  * @param {(name: 'submitted'|'apply', detail: object) => void} [o.emit] To `hp.onsite.on` listeners.
  * @param {string|null} [o.coupon] A code the form starts with: an unused one to remind of.
  * @param {() => number|null} [o.basket] The basket's value, for a progress block.
+ * @param {(block: object, answers: object) => object|false} [o.fill] A form whose text has shopper
+ *   values: each block as it shows (./values.js `fillFor`), `false` for one hidden.
  * @param {{ device: 'desktop'|'mobile', step?: string }} [o.preview] Render inside `container`,
  *   inert but for moving between steps: no network, no events, no counters.
  */
@@ -759,7 +761,8 @@ export function mountForm(o) {
 
 	/**
 	 * A countdown's place: the answers chunk draws its label and timer into it and ticks it
-	 * (./countdown.js), showing it, and hides it again once a deadline passes. Hidden until then, so
+	 * (./countdown.js), a daily one to the form's next cut-off, showing it, and hides it again once a
+	 * deadline passes. Hidden until then, so
 	 * a chunk that never comes leaves nothing behind, not an empty timer.
 	 */
 	function countdown(block) {
@@ -771,7 +774,9 @@ export function mountForm(o) {
 			(m) =>
 				m &&
 				box.isConnected &&
-				state.timers.push(m.countdown(box, block, preview, el)),
+				state.timers.push(
+					m.countdown(box, block, preview, el, form.window.daily?.next),
+				),
 		);
 		return box;
 	}
@@ -1002,11 +1007,9 @@ export function mountForm(o) {
 	}
 
 	/** A teaser's first step: a tab that opens the rest of the form. */
-	function tab(step) {
-		const heading = step.blocks.find((b) => b?.t === 'heading');
-		const open = step.blocks.find(
-			(b) => b?.t === 'button' && b.action === 'next',
-		);
+	function tab(blocks) {
+		const heading = blocks.find((b) => b?.t === 'heading');
+		const open = blocks.find((b) => b?.t === 'button' && b.action === 'next');
 		// The heading's words without its marks: a button holds no link.
 		const b = el('button', 'tb');
 		b.textContent = heading
@@ -1075,9 +1078,11 @@ export function mountForm(o) {
 			wrap.classList.add('lk');
 		}
 		body.replaceChildren();
-		if (asTab && l.template !== 'image-only') body.append(tab(step));
+		// Shopper values filled in as text (./values.js), from this form's answers too; false: hidden.
+		const blocks = step.blocks.map((b) => o.fill?.(b, state.answers) ?? b);
+		if (asTab && l.template !== 'image-only') body.append(tab(blocks));
 		else
-			for (const [index, block] of step.blocks.entries()) {
+			for (const [index, block] of blocks.entries()) {
 				const node =
 					isObject(block) && Object.hasOwn(BLOCKS, block.t)
 						? BLOCKS[block.t](block)

package/src/onsite/rich-text.js

@@ -5,7 +5,18 @@
  *   RichText = string | Array<string | { b: RichText } | { i: RichText } | { a: RichText, href }>
  */
 
-const MAX_DEPTH = 6;
+/** How deep marks nest before the rest is dropped. */
+export const MAX_DEPTH = 6;
+
+/** Whether a rich text holds a shopper value node (one with a `v`), to the depth it is drawn. */
+export const holdsValue = (text, depth = 0) =>
+	depth <= MAX_DEPTH &&
+	typeof text === 'object' &&
+	!!text &&
+	(Array.isArray(text)
+		? text.some((run) => holdsValue(run, depth + 1))
+		: typeof text.v === 'string' ||
+			holdsValue(text.b ?? text.i ?? text.a, depth + 1));
 
 /** The href as an https URL, or null. */
 export function httpsHref(href) {

package/src/onsite/rules.js

@@ -4,6 +4,10 @@
  */
 
 import { arrivedFrom } from '../visit-campaign.js';
+import { pageFactsHold } from './page-facts.js';
+
+/** What holds a form back until the page says what it is about: its facts, or its product. */
+export const UNSAID = ['the page does not say so', 'not a product page'];
 
 export const FORMATS = [
 	'popup',
@@ -41,10 +45,12 @@ const strings = (v) =>
 	Array.isArray(v) ? v.filter((s) => typeof s === 'string') : [];
 const count = (v) => (Number.isInteger(v) && v >= 0 ? v : null);
 
-/** A rule no visit meets: what an `arrived_from` this SDK cannot read becomes, so it fails closed. */
-const NEVER = { field: null, match: null, values: [] };
-const arrivedRules = (raw) =>
-	raw == null ? [] : Array.isArray(raw) && raw.every(isObject) ? raw : [NEVER];
+/**
+ * Rules as the runtime reads them: none when absent, and ones this SDK cannot read become `never`, a
+ * rule no visit or page meets, so the form fails closed.
+ */
+const rulesOr = (raw, never) =>
+	raw == null ? [] : Array.isArray(raw) && raw.every(isObject) ? raw : [never];
 
 /** A form from the settings as the runtime uses it, or null when it cannot be used. */
 export function readForm(raw) {
@@ -62,7 +68,13 @@ export function readForm(raw) {
 		devices: strings(raw.devices),
 		aliases: strings(raw.aliases),
 		audiences: strings(raw.audiences),
-		arrived_from: arrivedRules(raw.arrived_from),
+		arrived_from: rulesOr(raw.arrived_from, {
+			field: null,
+			match: null,
+			values: [],
+		}),
+		page_facts: rulesOr(raw.page_facts, { fact: null, op: null, values: [] }),
+		products: raw.products === true,
 		caps: {
 			per_session: count(caps.per_session),
 			lifetime: count(caps.lifetime),
@@ -136,10 +148,20 @@ const at = (iso) => (typeof iso === 'string' ? Date.parse(iso) : Number.NaN);
  */
 export const ASKED = (form) => form.trigger.type === 'manual';
 
+/** A form held back only until its daily window opens; `opensIn` says how long that is. */
+export const OUTSIDE_WINDOW = 'outside its daily window';
+export const opensIn = (form, now) => {
+	const { daily } = form.window;
+	return daily.next.find((t) => t > now) - daily.within_hours * 36e5 - now;
+};
+
 /**
- * Every reason `form` may not show now, empty when it may. `env` is the page:
- * `{ path, device, campaign, now, seen, subscribed, personalisation, preview, audiences }`, where
- * `campaign` is the visit's (`visitCampaign`), `seen` the slot's counters and `audiences` the
+ * Every reason `form` may not show now, empty when it may: its pages, devices, campaign, page
+ * facts and products, dates and daily cut-off, audiences and counters. `env` is the page:
+ * `{ path, device, campaign, facts, product, now, seen, subscribed, personalisation, preview,
+ * audiences }`, where `campaign` is the visit's (`visitCampaign`), `facts` what the page said
+ * about itself (`hp.onsite.facts`), `product` the id of the product the page is about (its last
+ * Product Viewed), `seen` the slot's counters and `audiences` the
  * session audiences the host gave, or null. The campaign is context about this visit, as the page
  * is, so it needs no personalisation consent. A form limited to audiences needs personalisation
  * consent; whether the visitor is in one is the server's to decide (`POST /v1/decisions`), unless
@@ -152,9 +174,26 @@ export function blockers(form, env) {
 		reasons.push(`not on ${env.device}`);
 	if (!arrivedFrom(form.arrived_from, env.campaign))
 		reasons.push('not from its campaign');
+	// A preview shows the version asked for on any page, as the server answers it.
+	if (!env.later && !env.preview) {
+		if (!pageFactsHold(form.page_facts, env.facts)) reasons.push(UNSAID[0]);
+		// Which products: the server's to decide; a page about none can never be one of them.
+		if (form.products && !env.product) reasons.push(UNSAID[1]);
+	}
 	const starts = at(form.window.starts_at);
 	const ends = at(form.window.ends_at);
 	if (env.now < starts || env.now >= ends) reasons.push('outside its dates');
+	// Its daily cut-off is targeting too: checked before any decision, so a held-out visitor is
+	// filtered as a shown one is. Its window is judged when the trigger fires (`later` at start), as
+	// it may open while the shopper is on the page; with no cut-off ahead it never can. The server
+	// lists the moments; a trader previewing sees it at any hour.
+	const { daily } = form.window;
+	if (daily && !env.preview) {
+		const left = daily.next?.find?.((t) => t > env.now) - env.now;
+		if (!(left > 0)) reasons.push('no cut-off ahead');
+		else if (!env.later && left > daily.within_hours * 36e5)
+			reasons.push(OUTSIDE_WINDOW);
+	}
 	// A trader previewing a limited form sees it, as the server answers a preview.
 	if (form.audiences.length && !env.preview) {
 		if (!env.personalisation)

package/src/onsite/values-loader.js

@@ -0,0 +1,6 @@
+/**
+ * Shopper values in a form's text, only for a form whose text has one: a bundler splits this import
+ * out of ./onsite, and the CDN build swaps this module for cdn/values-loader.js, which loads
+ * dist/onsite-values.min.js.
+ */
+export const loadValues = () => import('./values.js');