@sparkletree/core 0.12.0 → 0.13.0

package/dist/server.js

@@ -0,0 +1,463 @@
+/**
+ * `@sparkletree/core/server` — server-side reads for pages rendered on the
+ * server.
+ *
+ * Text a visitor can see is never replaced, so live copy is decided before a
+ * slot is shown. A page rendered on the server can ask, at request time, for
+ * the live copy already cached for this visitor's context and render it as
+ * final text. When there is none, the slot keeps its reservation and the
+ * browser's stream and hold take over as usual.
+ *
+ * Server only. Nothing here belongs in a browser bundle, and calling it in a
+ * browser returns empty results without a request.
+ */
+import { resolvePublishableConfig } from "./fragments.js";
+import { warnDev } from "./devwarn.js";
+import { deviceTypeForViewport, hourInTimeZone, isValidTimeZone, timeOfDayForHour, } from "./visitorContext.js";
+import { flattenCustomContext } from "./context.js";
+import { randomId } from "./analytics.js";
+import { ISLAND_COPY_FIELDS, lengthBudgets, setLengthParams } from "./slots.js";
+/** Default total budget for a server read, in milliseconds. */
+export const SERVER_COPY_BUDGET_MS = 250;
+/** The largest budget a server read accepts, in milliseconds. */
+export const SERVER_COPY_MAX_BUDGET_MS = 1000;
+/** Path of the server read on the embed API. */
+const ISLAND_COPY_PATH = "/api/embed/v1/islands/copy";
+const ISLAND_FIELDS = ISLAND_COPY_FIELDS;
+/** The edge's bound on one parameter's value. */
+const MAX_PARAM_LENGTH = 128;
+/**
+ * The visitor context for one request, from its headers only.
+ *
+ * Reads exactly these headers and nothing else:
+ *
+ * - `Accept-Language`: the language;
+ * - `Sec-CH-UA-Mobile`, then `User-Agent`: the device bucket (`mobile` for
+ *   phones, `desktop` for everything else, tablets included: the browser
+ *   buckets by viewport width, and tablets are 768 CSS pixels or wider);
+ * - `x-vercel-ip-timezone`, then `cf-timezone`: the time zone, from which
+ *   the time of day is bucketed exactly as the browser does.
+ *
+ * The visitor's IP, cookies, full user agent, referrer and location are
+ * never read or forwarded. Never throws.
+ */
+export function deriveServerContext(headers, options = {}) {
+    const context = {};
+    try {
+        const read = headerReader(headers);
+        const language = primaryLanguage(read("accept-language"));
+        if (language)
+            context.language = language;
+        const deviceType = deviceTypeFromHeaders(read("sec-ch-ua-mobile"), read("user-agent"));
+        if (deviceType)
+            context.deviceType = deviceType;
+        const timezone = timeZoneFromHeaders(read) ?? validTimeZone(options.fallbackTimezone);
+        if (timezone)
+            context.timezone = timezone;
+        const now = options.now?.() ?? new Date();
+        context.timeOfDay = timeOfDayForHour(hourInTimeZone(now, timezone ?? "UTC"));
+    }
+    catch {
+        // Context is an enhancement; a page must never fail on it.
+    }
+    return context;
+}
+/**
+ * Read the cached live copy for this request's visitor, to render as final
+ * text on the server.
+ *
+ * Strictly a read: nothing is generated, and no impression is recorded (the
+ * browser records it when the island is seen). One call decides one variant
+ * for every island it names; call it once per request (for example through
+ * React's `cache`) and share the result between the islands.
+ *
+ * Never throws and never waits past `budgetMs`. A miss, an error, a timeout,
+ * a refused key or a call in a browser all return `null` islands, with the
+ * visitor context still derived.
+ */
+export async function getIslandCopy(options) {
+    const started = Date.now();
+    const islands = uniqueIslands(options.islands);
+    const context = deriveServerContext(options.headers, {
+        fallbackTimezone: options.fallbackTimezone,
+        now: options.now,
+    });
+    // A variant the caller already pinned stays the page's, whatever the read
+    // returns.
+    const pinKey = options.surfaceId ?? options.campaignId;
+    // One read is one page view: the provider scopes the browser's pins and
+    // impressions to it.
+    const viewed = { ...context, viewId: randomId() };
+    const requestContext = pinKey && options.variantId ? { ...viewed, pins: { [pinKey]: options.variantId } } : viewed;
+    const result = (reasons) => ({
+        islands: Object.fromEntries(islands.map((island) => [island, null])),
+        campaignId: null,
+        variantId: options.variantId ?? null,
+        context: requestContext,
+        reasons,
+        elapsedMs: Date.now() - started,
+    });
+    if (typeof window !== "undefined" && typeof document !== "undefined") {
+        warnDev("server-copy:browser", "getIslandCopy is a server-side read and was called in a browser. " +
+            "It returns no copy there; the islands hold and stream as usual.");
+        return result({ read: "browser" });
+    }
+    let organizationId;
+    let apiBase;
+    try {
+        ({ organizationId, apiBase } = resolvePublishableConfig({
+            publishableKey: options.publishableKey,
+            organizationId: options.organizationId,
+            apiBase: options.apiBase,
+        }, "getIslandCopy"));
+    }
+    catch (error) {
+        warnDev("server-copy:config", String(error?.message ?? error));
+        return result({ read: "config" });
+    }
+    if (islands.length === 0)
+        return result({});
+    const budgetMs = clampBudget(options.budgetMs);
+    const url = buildIslandCopyUrl({
+        apiBase,
+        organizationId,
+        campaignId: options.campaignId,
+        surfaceId: options.surfaceId,
+        variantId: options.variantId,
+        islands,
+        context,
+        acceptLanguage: compactAcceptLanguage(headerReader(options.headers)("accept-language")),
+        declared: options.declared,
+        lengths: Object.assign({}, ...islands.map((island) => lengthBudgets(options.fallbacks?.[island], ISLAND_FIELDS[island]))),
+        budgetMs,
+    });
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), budgetMs);
+    let body;
+    try {
+        const doFetch = options.fetchImpl ?? fetch;
+        const init = {
+            method: "GET",
+            headers: {
+                Accept: "application/json",
+                Authorization: `Bearer ${options.publishableKey}`,
+            },
+            // Per visitor: never served from or stored in a fetch cache (in
+            // Next.js this also keeps the route dynamic).
+            cache: "no-store",
+            redirect: "error",
+            signal: controller.signal,
+        };
+        let response;
+        try {
+            response = await doFetch(url, init);
+        }
+        catch (error) {
+            // Some server runtimes reject the `cache` option outright rather than
+            // ignoring it. Without a fetch cache there is nothing to opt out of,
+            // so ask again without it.
+            if (controller.signal.aborted || !(error instanceof TypeError) || !/cache/i.test(error.message)) {
+                throw error;
+            }
+            const { cache: _cache, ...withoutCache } = init;
+            response = await doFetch(url, withoutCache);
+        }
+        if (response.status === 401) {
+            const reason = await readReason(response);
+            if (reason === "live_key_required") {
+                warnDev("server-copy:test-key", "getIslandCopy needs a live publishable key (st_pk_live_). With a test key " +
+                    "every island is a miss: it holds and streams in the browser as usual.");
+            }
+            return result({ read: reason ?? "error" });
+        }
+        if (!response.ok)
+            return result({ read: "error" });
+        body = await response.json();
+    }
+    catch {
+        return result({ read: controller.signal.aborted ? "deadline" : "error" });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    return parseIslandCopyResponse(body, {
+        islands,
+        organizationId,
+        campaignId: options.campaignId,
+        surfaceId: options.surfaceId,
+        variantId: options.variantId,
+        context: requestContext,
+        fallbacks: options.fallbacks,
+        started,
+    });
+}
+// --- request ------------------------------------------------------------------
+function buildIslandCopyUrl(input) {
+    const url = new URL(ISLAND_COPY_PATH, input.apiBase);
+    const params = url.searchParams;
+    params.set("organization", input.organizationId);
+    // Same addressing rule as the stream: a surface wins over a campaign.
+    if (input.surfaceId)
+        params.set("surface", input.surfaceId);
+    else if (input.campaignId)
+        params.set("campaign", input.campaignId);
+    params.set("islands", input.islands.join(","));
+    if (input.variantId)
+        params.set("variant", input.variantId);
+    if (input.context.deviceType)
+        params.set("deviceType", input.context.deviceType);
+    if (input.context.timeOfDay)
+        params.set("timeOfDay", input.context.timeOfDay);
+    if (input.context.timezone)
+        params.set("timezone", input.context.timezone);
+    if (input.acceptLanguage)
+        params.set("language", input.acceptLanguage);
+    for (const [key, value] of Object.entries(declaredParams(input.declared))) {
+        params.set(key, value);
+    }
+    setLengthParams(params, input.lengths);
+    params.set("budgetMs", String(input.budgetMs));
+    return url.toString();
+}
+/**
+ * Declared placement as the stream sends it: long names and `x.*` customs,
+ * flattened by the same function the stream uses (`custom` entries win over
+ * literal `x.*` keys). Unknown keys are dropped.
+ */
+function declaredParams(declared) {
+    const out = {};
+    if (!declared)
+        return out;
+    const flat = flattenCustomContext(declared);
+    const put = (key, value) => {
+        if (typeof value === "string" && value.trim() !== "")
+            out[key] = value;
+    };
+    put("page", flat.page);
+    put("intent", flat.intent);
+    put("audience", flat.audience);
+    put("notes", flat.notes);
+    for (const [key, value] of Object.entries(flat)) {
+        if (key.startsWith("x."))
+            put(key, value);
+    }
+    return out;
+}
+function clampBudget(budgetMs) {
+    if (typeof budgetMs !== "number" || !Number.isFinite(budgetMs) || budgetMs <= 0) {
+        return SERVER_COPY_BUDGET_MS;
+    }
+    return Math.min(Math.round(budgetMs), SERVER_COPY_MAX_BUDGET_MS) || 1;
+}
+function uniqueIslands(islands) {
+    const out = [];
+    for (const island of islands ?? []) {
+        if ((island === "hero" || island === "cta") && !out.includes(island))
+            out.push(island);
+    }
+    return out;
+}
+async function readReason(response) {
+    try {
+        const body = (await response.json());
+        return typeof body?.reason === "string" ? body.reason : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// --- response -----------------------------------------------------------------
+function parseIslandCopyResponse(body, request) {
+    const empty = (reasons) => ({
+        islands: Object.fromEntries(request.islands.map((island) => [island, null])),
+        campaignId: null,
+        variantId: request.variantId ?? null,
+        context: request.context,
+        reasons,
+        elapsedMs: Date.now() - request.started,
+    });
+    if (!isRecord(body))
+        return empty({ read: "error" });
+    const campaignId = nonEmptyString(body.campaignId);
+    const variantId = nonEmptyString(body.variantId);
+    const bodyReason = nonEmptyString(body.reason);
+    // The answer must be about what was asked: this organization, the pinned
+    // campaign and the pinned variant. Anything else is not shown.
+    if ((nonEmptyString(body.organizationId) ?? request.organizationId) !== request.organizationId ||
+        (!request.surfaceId && request.campaignId && campaignId && campaignId !== request.campaignId) ||
+        (request.variantId && variantId && variantId !== request.variantId)) {
+        return empty({ read: "identity_mismatch" });
+    }
+    // The variant the server decided is the page's, hit or miss: the
+    // browser's stream then fills the cache entry this read missed.
+    const pinKey = request.surfaceId ?? request.campaignId;
+    const context = pinKey && variantId ? { ...request.context, pins: { [pinKey]: variantId } } : request.context;
+    const identity = { campaignId: campaignId ?? null, variantId: variantId ?? null };
+    const islandsBody = isRecord(body.islands) ? body.islands : {};
+    const found = {};
+    const reasons = {};
+    if (bodyReason)
+        reasons.read = bodyReason;
+    for (const island of request.islands) {
+        const entry = islandsBody[island];
+        const parsed = isRecord(entry)
+            ? parseIsland(island, entry, identity, request.fallbacks?.[island])
+            : { copy: null, reason: bodyReason ?? "miss" };
+        if (parsed.copy)
+            found[island] = parsed.copy;
+        else
+            reasons[island] = parsed.reason;
+    }
+    return {
+        islands: Object.fromEntries(request.islands.map((island) => [island, found[island] ?? null])),
+        campaignId: identity.campaignId,
+        variantId: identity.variantId,
+        context,
+        reasons,
+        elapsedMs: Date.now() - request.started,
+    };
+}
+function parseIsland(island, entry, identity, fallback) {
+    if (entry.source !== "cache") {
+        return { copy: null, reason: nonEmptyString(entry.reason) ?? "miss" };
+    }
+    // Every island of one read carries the read's campaign and variant.
+    const campaignId = nonEmptyString(entry.campaignId) ?? identity.campaignId;
+    const variantId = nonEmptyString(entry.variantId) ?? identity.variantId;
+    if (!campaignId ||
+        !variantId ||
+        (identity.campaignId && campaignId !== identity.campaignId) ||
+        (identity.variantId && variantId !== identity.variantId)) {
+        return { copy: null, reason: "identity_mismatch" };
+    }
+    const fieldsBody = isRecord(entry.fields) ? entry.fields : {};
+    const copy = {};
+    let any = false;
+    for (const field of ISLAND_FIELDS[island]) {
+        // A field the island's fallback does not have has no slot.
+        if (fallback && !(typeof fallback[field] === "string" && fallback[field].trim() !== "")) {
+            continue;
+        }
+        const text = fieldsBody[field];
+        if (typeof text === "string" && text.trim() !== "") {
+            copy[field] = text;
+            any = true;
+        }
+    }
+    if (!any)
+        return { copy: null, reason: "miss" };
+    const stale = entry.contentSource === "cached-stale" || entry.freshness === "stale";
+    return {
+        copy: {
+            copy,
+            contentSource: "cached",
+            freshness: stale ? "stale" : "fresh",
+            variantId,
+            campaignId,
+        },
+        reason: "miss",
+    };
+}
+// --- headers ------------------------------------------------------------------
+function headerReader(headers) {
+    if (!headers)
+        return () => undefined;
+    if (typeof headers.get === "function") {
+        const source = headers;
+        return (name) => {
+            try {
+                return source.get(name) ?? undefined;
+            }
+            catch {
+                return undefined;
+            }
+        };
+    }
+    const record = headers;
+    const lowered = new Map();
+    for (const [key, value] of Object.entries(record))
+        lowered.set(key.toLowerCase(), value);
+    return (name) => {
+        const value = lowered.get(name);
+        return Array.isArray(value) ? value.join(", ") : value;
+    };
+}
+/** Phones and other small-screen devices, by user agent. */
+const MOBILE_UA = /Mobi|iPhone|iPod|Android.+Mobile|Windows Phone|BlackBerry|BB10|Opera Mini|IEMobile/i;
+/** Tablets, by user agent. iPadOS reports a desktop user agent and lands as desktop. */
+const TABLET_UA = /iPad|Tablet|Android(?!.*Mobile)|Kindle|Silk|PlayBook/i;
+/**
+ * The device bucket, from `Sec-CH-UA-Mobile` when the browser sends it,
+ * else the user agent. Tablets bucket as desktop, as they do in the
+ * browser. Undefined when neither header is present.
+ */
+function deviceTypeFromHeaders(chMobile, userAgent) {
+    const hint = chMobile?.trim();
+    if (hint === "?1")
+        return deviceTypeForViewport(true);
+    if (hint === "?0")
+        return deviceTypeForViewport(false);
+    if (!userAgent)
+        return undefined;
+    if (TABLET_UA.test(userAgent))
+        return deviceTypeForViewport(false);
+    return deviceTypeForViewport(MOBILE_UA.test(userAgent));
+}
+function timeZoneFromHeaders(read) {
+    for (const name of ["x-vercel-ip-timezone", "cf-timezone"]) {
+        const value = validTimeZone(read(name));
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+function validTimeZone(value) {
+    const trimmed = value?.trim();
+    return trimmed && isValidTimeZone(trimmed) ? trimmed : undefined;
+}
+const LANGUAGE_ENTRY = /^([A-Za-z]{1,8}(?:-[A-Za-z0-9]{1,8})*|\*)(?:\s*;\s*q\s*=\s*([0-9.]+))?$/;
+function languageEntries(header) {
+    if (!header)
+        return [];
+    const entries = [];
+    for (const part of header.split(",")) {
+        const trimmed = part.trim();
+        const match = LANGUAGE_ENTRY.exec(trimmed);
+        if (!match)
+            continue;
+        const q = match[2] === undefined ? 1 : Number.parseFloat(match[2]);
+        if (!Number.isFinite(q) || q <= 0)
+            continue;
+        entries.push({ tag: match[1], q: Math.min(q, 1), raw: trimmed.replace(/\s+/g, "") });
+    }
+    return entries;
+}
+/** The visitor's preferred language tag, e.g. `sv-SE`. */
+function primaryLanguage(header) {
+    const best = languageEntries(header)
+        .filter((entry) => entry.tag !== "*")
+        .sort((a, b) => b.q - a.q)[0];
+    return best?.tag;
+}
+/**
+ * The Accept-Language value to forward: well-formed entries only, in the
+ * order the browser sent them, whole entries up to the parameter bound.
+ */
+function compactAcceptLanguage(header) {
+    let out = "";
+    for (const entry of languageEntries(header)) {
+        const next = out ? `${out},${entry.raw}` : entry.raw;
+        if (next.length > MAX_PARAM_LENGTH)
+            break;
+        out = next;
+    }
+    return out || undefined;
+}
+// --- small helpers ------------------------------------------------------------
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/slots.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Copy slots: what each island's slots are, how long their copy may be, and
+ * when visible copy is allowed to change.
+ *
+ * Two rules live here because the browser and the server must apply them
+ * identically:
+ *
+ *   - The fallback sets the size. Each field's fallback defines its slot, so
+ *     its length is sent with every request as that field's length budget
+ *     (`len.<field>=<characters>`), and the server writes copy to fit. The
+ *     server read and the browser's stream compute the budget with the same
+ *     function, so they ask for, and cache, the same copy.
+ *   - Visible copy changes only on a visitor's action. A change to what an
+ *     island would show (a context or campaign change) replaces visible text
+ *     only when the visitor caused it: the interaction handler calls
+ *     `markVisitorChange()` before it updates state. Any other change waits
+ *     until the slot is off screen or the next page view.
+ */
+import type { CopyField } from "./state.js";
+/** The copy fields each island has. */
+export declare const ISLAND_COPY_FIELDS: Readonly<Record<"hero" | "cta", readonly CopyField[]>>;
+/** Prefix of the length-budget query parameters: `len.headline=42`. */
+export declare const LENGTH_PARAM_PREFIX = "len.";
+/**
+ * The length of copy as a length budget counts it: Unicode code points, so
+ * an emoji or an accented letter written as one character counts as one.
+ */
+export declare function copyLength(text: string): number;
+/**
+ * The length budget per field: the length of each field's fallback, for the
+ * fields named in `fields` whose fallback is not empty. A field without a
+ * fallback has no slot and no budget.
+ */
+export declare function lengthBudgets(fallback: Partial<Record<CopyField, string | undefined>> | null | undefined, fields: readonly CopyField[]): Partial<Record<CopyField, number>>;
+/** Add `len.<field>` parameters for `budgets`, in field order. */
+export declare function setLengthParams(params: URLSearchParams, budgets: Partial<Record<CopyField, number>> | null | undefined): void;
+/**
+ * How long a `markVisitorChange()` call stays valid for the change it
+ * announces: the state update it precedes renders well inside this.
+ */
+export declare const VISITOR_CHANGE_WINDOW_MS = 1000;
+/**
+ * Announce that the visitor caused the next change to what islands and
+ * fragments show — call it in the interaction handler (a click, a submit, a
+ * choice) before the state update that changes their campaign, context or
+ * declaration:
+ *
+ * ```tsx
+ * onClick={() => {
+ *   markVisitorChange();
+ *   setAudience("teams");
+ * }}
+ * ```
+ *
+ * Visible copy then changes once, with one cross-fade. Without it, a change
+ * keeps the visible copy until the slot is off screen or the next page view.
+ */
+export declare function markVisitorChange(): void;
+/** Internal: the current visitor-change generation, to remember as seen. */
+export declare function visitorChangeGeneration(): number;
+/**
+ * Internal: has the visitor announced a change since generation `seen`, recently
+ * enough that the change being rendered now is the one they caused?
+ */
+export declare function isVisitorChange(seen: number): boolean;
+//# sourceMappingURL=slots.d.ts.map

package/dist/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../src/slots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,uCAAuC;AACvC,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC,CAGrF,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3E,MAAM,EAAE,SAAS,SAAS,EAAE,GAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAOpC;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAC7D,IAAI,CAQN;AAID;;;GAGG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAW7C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/slots.js

@@ -0,0 +1,102 @@
+/**
+ * Copy slots: what each island's slots are, how long their copy may be, and
+ * when visible copy is allowed to change.
+ *
+ * Two rules live here because the browser and the server must apply them
+ * identically:
+ *
+ *   - The fallback sets the size. Each field's fallback defines its slot, so
+ *     its length is sent with every request as that field's length budget
+ *     (`len.<field>=<characters>`), and the server writes copy to fit. The
+ *     server read and the browser's stream compute the budget with the same
+ *     function, so they ask for, and cache, the same copy.
+ *   - Visible copy changes only on a visitor's action. A change to what an
+ *     island would show (a context or campaign change) replaces visible text
+ *     only when the visitor caused it: the interaction handler calls
+ *     `markVisitorChange()` before it updates state. Any other change waits
+ *     until the slot is off screen or the next page view.
+ */
+/** The copy fields each island has. */
+export const ISLAND_COPY_FIELDS = {
+    hero: ["greeting", "headline", "body"],
+    cta: ["cta"],
+};
+/** Prefix of the length-budget query parameters: `len.headline=42`. */
+export const LENGTH_PARAM_PREFIX = "len.";
+/**
+ * The length of copy as a length budget counts it: Unicode code points, so
+ * an emoji or an accented letter written as one character counts as one.
+ */
+export function copyLength(text) {
+    return Array.from(text).length;
+}
+/**
+ * The length budget per field: the length of each field's fallback, for the
+ * fields named in `fields` whose fallback is not empty. A field without a
+ * fallback has no slot and no budget.
+ */
+export function lengthBudgets(fallback, fields) {
+    const out = {};
+    for (const field of fields) {
+        const text = fallback?.[field];
+        if (typeof text === "string" && text.trim() !== "")
+            out[field] = copyLength(text);
+    }
+    return out;
+}
+/** Add `len.<field>` parameters for `budgets`, in field order. */
+export function setLengthParams(params, budgets) {
+    if (!budgets)
+        return;
+    for (const field of ["greeting", "headline", "body", "cta"]) {
+        const value = budgets[field];
+        if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+            params.set(`${LENGTH_PARAM_PREFIX}${field}`, String(Math.round(value)));
+        }
+    }
+}
+// --- visitor-initiated changes ------------------------------------------------
+/**
+ * How long a `markVisitorChange()` call stays valid for the change it
+ * announces: the state update it precedes renders well inside this.
+ */
+export const VISITOR_CHANGE_WINDOW_MS = 1000;
+let visitorGeneration = 0;
+let visitorMarkedAt = Number.NEGATIVE_INFINITY;
+function clock() {
+    return typeof performance !== "undefined" && typeof performance.now === "function"
+        ? performance.now()
+        : Date.now();
+}
+/**
+ * Announce that the visitor caused the next change to what islands and
+ * fragments show — call it in the interaction handler (a click, a submit, a
+ * choice) before the state update that changes their campaign, context or
+ * declaration:
+ *
+ * ```tsx
+ * onClick={() => {
+ *   markVisitorChange();
+ *   setAudience("teams");
+ * }}
+ * ```
+ *
+ * Visible copy then changes once, with one cross-fade. Without it, a change
+ * keeps the visible copy until the slot is off screen or the next page view.
+ */
+export function markVisitorChange() {
+    visitorGeneration += 1;
+    visitorMarkedAt = clock();
+}
+/** Internal: the current visitor-change generation, to remember as seen. */
+export function visitorChangeGeneration() {
+    return visitorGeneration;
+}
+/**
+ * Internal: has the visitor announced a change since generation `seen`, recently
+ * enough that the change being rendered now is the one they caused?
+ */
+export function isVisitorChange(seen) {
+    return visitorGeneration !== seen && clock() - visitorMarkedAt <= VISITOR_CHANGE_WINDOW_MS;
+}
+//# sourceMappingURL=slots.js.map

package/dist/slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../src/slots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,uCAAuC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAA2D;IACxF,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC;IACtC,GAAG,EAAE,CAAC,KAAK,CAAC;CACb,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA2E,EAC3E,MAA4B;IAE5B,MAAM,GAAG,GAAuC,EAAE,CAAC;IACnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAC7B,MAAuB,EACvB,OAA8D;IAE9D,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,KAAK,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAU,EAAE,CAAC;QACrE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACrE,MAAM,CAAC,GAAG,CAAC,GAAG,mBAAmB,GAAG,KAAK,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,IAAI,iBAAiB,GAAG,CAAC,CAAC;AAC1B,IAAI,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC;AAE/C,SAAS,KAAK;IACZ,OAAO,OAAO,WAAW,KAAK,WAAW,IAAI,OAAO,WAAW,CAAC,GAAG,KAAK,UAAU;QAChF,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE;QACnB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB;IAC/B,iBAAiB,IAAI,CAAC,CAAC;IACvB,eAAe,GAAG,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB;IACrC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,iBAAiB,KAAK,IAAI,IAAI,KAAK,EAAE,GAAG,eAAe,IAAI,wBAAwB,CAAC;AAC7F,CAAC"}