@cxpinsight/survey-spec 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -15,8 +15,8 @@ export { evaluateTree, compareValues, MAX_TREE_DEPTH } from './evaluateTree';
 export type { ConditionNode, Operand, TreeContext } from './evaluateTree';
 export { resolveVariable } from './resolveVariable';
 export { splitIntoPages } from './pageFlow';
-export { complianceGate, questionForValidation, validateAnswer, impliedChoices, impliedActions, impliedStepActions, impliedEqualProminence, safeActionHref, safeImageSrc, isDeferChoice, canSwipeToDismiss, autoDismissMs, deadlineCountdown, formatCountdown, outcomeFor, voiceUsable, rewardToShow, cardClickTarget, cardHoverEffect, resolveAction } from './validate';
-export type { ComplianceState, EscapeHatch, ComplianceInput, ComplianceVerdict, ValidatableQuestion, OutcomeKind, OutcomeInput, ActionKind, RawAction, ResolvedAction } from './validate';
+export { complianceGate, questionForValidation, validateAnswer, impliedChoices, impliedActions, impliedStepActions, impliedEqualProminence, safeActionHref, safeImageSrc, isDeferChoice, canSwipeToDismiss, showsClose, autoDismissMs, deadlineCountdown, formatCountdown, outcomeFor, voiceUsable, rewardToShow, rewardTerms, showsConfirmation, confirmationText, showsQuestionLabel, collectsAnswer, answerShape, resolveBranding, resolveTheme, resolveThemeDecision, cardClickTarget, cardIsClickable, cardHoverEffect, showActionButton, imageLayout, imageScrim, imageDesign, triggerVariables, resolveAction } from './validate';
+export type { ComplianceState, EscapeHatch, ComplianceInput, ComplianceVerdict, ValidatableQuestion, OutcomeKind, OutcomeInput, ActionKind, RawAction, ResolvedAction, ImageLayout, ImageDesign, TriggerContext } from './validate';
 export { validateAnswerCode } from './validate';
 export { wordMessage, EN_MESSAGES, MESSAGE_CODES } from './messages';
 export type { ValidationMessage } from './messages';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1W,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1L,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EACL,mBAAmB,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EACzE,kBAAkB,EAAE,SAAS,EAAE,iBAAiB,EAChD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EACjD,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EACtE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,GAC7D,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzmB,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACpO,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EACL,mBAAmB,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EACzE,kBAAkB,EAAE,SAAS,EAAE,iBAAiB,EAChD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EACjD,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EACtE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,GAC7D,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.optionValueOf = exports.optionLabelOf = exports.shortCode = exports.buildPromptText = exports.scaffoldFor = exports.skipNoteText = exports.voiceDisclaimer = exports.auditVoiceQuestions = exports.voiceCanHandle = exports.voiceSupport = exports.distinctiveLabels = exports.matchDate = exports.matchNumberInRange = exports.rankOptions = exports.matchOptions = exports.matchOption = exports.matchBoolean = exports.normalizeTranscript = exports.MESSAGE_CODES = exports.EN_MESSAGES = exports.wordMessage = exports.validateAnswerCode = exports.resolveAction = exports.cardHoverEffect = exports.cardClickTarget = exports.rewardToShow = exports.voiceUsable = exports.outcomeFor = exports.formatCountdown = exports.deadlineCountdown = exports.autoDismissMs = exports.canSwipeToDismiss = exports.isDeferChoice = exports.safeImageSrc = exports.safeActionHref = exports.impliedEqualProminence = exports.impliedStepActions = exports.impliedActions = exports.impliedChoices = exports.validateAnswer = exports.questionForValidation = exports.complianceGate = exports.splitIntoPages = exports.resolveVariable = exports.MAX_TREE_DEPTH = exports.compareValues = exports.evaluateTree = exports.isParseable = exports.evaluateCondition = exports.evaluateExpression = void 0;
-exports.optionLabelsOf = exports.voiceOptionsOf = void 0;
+exports.matchBoolean = exports.normalizeTranscript = exports.MESSAGE_CODES = exports.EN_MESSAGES = exports.wordMessage = exports.validateAnswerCode = exports.resolveAction = exports.triggerVariables = exports.imageDesign = exports.imageScrim = exports.imageLayout = exports.showActionButton = exports.cardHoverEffect = exports.cardIsClickable = exports.cardClickTarget = exports.resolveThemeDecision = exports.resolveTheme = exports.resolveBranding = exports.answerShape = exports.collectsAnswer = exports.showsQuestionLabel = exports.confirmationText = exports.showsConfirmation = exports.rewardTerms = exports.rewardToShow = exports.voiceUsable = exports.outcomeFor = exports.formatCountdown = exports.deadlineCountdown = exports.autoDismissMs = exports.showsClose = exports.canSwipeToDismiss = exports.isDeferChoice = exports.safeImageSrc = exports.safeActionHref = exports.impliedEqualProminence = exports.impliedStepActions = exports.impliedActions = exports.impliedChoices = exports.validateAnswer = exports.questionForValidation = exports.complianceGate = exports.splitIntoPages = exports.resolveVariable = exports.MAX_TREE_DEPTH = exports.compareValues = exports.evaluateTree = exports.isParseable = exports.evaluateCondition = exports.evaluateExpression = void 0;
+exports.optionLabelsOf = exports.voiceOptionsOf = exports.optionValueOf = exports.optionLabelOf = exports.shortCode = exports.buildPromptText = exports.scaffoldFor = exports.skipNoteText = exports.voiceDisclaimer = exports.auditVoiceQuestions = exports.voiceCanHandle = exports.voiceSupport = exports.distinctiveLabels = exports.matchDate = exports.matchNumberInRange = exports.rankOptions = exports.matchOptions = exports.matchOption = void 0;
 /**
  * @cxpinsight/survey-spec
  *
@@ -38,14 +38,30 @@ Object.defineProperty(exports, "safeActionHref", { enumerable: true, get: functi
 Object.defineProperty(exports, "safeImageSrc", { enumerable: true, get: function () { return validate_1.safeImageSrc; } });
 Object.defineProperty(exports, "isDeferChoice", { enumerable: true, get: function () { return validate_1.isDeferChoice; } });
 Object.defineProperty(exports, "canSwipeToDismiss", { enumerable: true, get: function () { return validate_1.canSwipeToDismiss; } });
+Object.defineProperty(exports, "showsClose", { enumerable: true, get: function () { return validate_1.showsClose; } });
 Object.defineProperty(exports, "autoDismissMs", { enumerable: true, get: function () { return validate_1.autoDismissMs; } });
 Object.defineProperty(exports, "deadlineCountdown", { enumerable: true, get: function () { return validate_1.deadlineCountdown; } });
 Object.defineProperty(exports, "formatCountdown", { enumerable: true, get: function () { return validate_1.formatCountdown; } });
 Object.defineProperty(exports, "outcomeFor", { enumerable: true, get: function () { return validate_1.outcomeFor; } });
 Object.defineProperty(exports, "voiceUsable", { enumerable: true, get: function () { return validate_1.voiceUsable; } });
 Object.defineProperty(exports, "rewardToShow", { enumerable: true, get: function () { return validate_1.rewardToShow; } });
+Object.defineProperty(exports, "rewardTerms", { enumerable: true, get: function () { return validate_1.rewardTerms; } });
+Object.defineProperty(exports, "showsConfirmation", { enumerable: true, get: function () { return validate_1.showsConfirmation; } });
+Object.defineProperty(exports, "confirmationText", { enumerable: true, get: function () { return validate_1.confirmationText; } });
+Object.defineProperty(exports, "showsQuestionLabel", { enumerable: true, get: function () { return validate_1.showsQuestionLabel; } });
+Object.defineProperty(exports, "collectsAnswer", { enumerable: true, get: function () { return validate_1.collectsAnswer; } });
+Object.defineProperty(exports, "answerShape", { enumerable: true, get: function () { return validate_1.answerShape; } });
+Object.defineProperty(exports, "resolveBranding", { enumerable: true, get: function () { return validate_1.resolveBranding; } });
+Object.defineProperty(exports, "resolveTheme", { enumerable: true, get: function () { return validate_1.resolveTheme; } });
+Object.defineProperty(exports, "resolveThemeDecision", { enumerable: true, get: function () { return validate_1.resolveThemeDecision; } });
 Object.defineProperty(exports, "cardClickTarget", { enumerable: true, get: function () { return validate_1.cardClickTarget; } });
+Object.defineProperty(exports, "cardIsClickable", { enumerable: true, get: function () { return validate_1.cardIsClickable; } });
 Object.defineProperty(exports, "cardHoverEffect", { enumerable: true, get: function () { return validate_1.cardHoverEffect; } });
+Object.defineProperty(exports, "showActionButton", { enumerable: true, get: function () { return validate_1.showActionButton; } });
+Object.defineProperty(exports, "imageLayout", { enumerable: true, get: function () { return validate_1.imageLayout; } });
+Object.defineProperty(exports, "imageScrim", { enumerable: true, get: function () { return validate_1.imageScrim; } });
+Object.defineProperty(exports, "imageDesign", { enumerable: true, get: function () { return validate_1.imageDesign; } });
+Object.defineProperty(exports, "triggerVariables", { enumerable: true, get: function () { return validate_1.triggerVariables; } });
 Object.defineProperty(exports, "resolveAction", { enumerable: true, get: function () { return validate_1.resolveAction; } });
 var validate_2 = require("./validate");
 Object.defineProperty(exports, "validateAnswerCode", { enumerable: true, get: function () { return validate_2.validateAnswerCode; } });

package/dist/validate.d.ts

@@ -177,6 +177,34 @@ export declare function canSwipeToDismiss(display: {
 } | null | undefined, delivery?: {
     mustShow?: unknown;
 } | null): boolean;
+/**
+ * Is the ✕ drawn?
+ *
+ * TWO RENDERERS, TWO ANSWERS, from one authored survey. Web resolved an unset
+ * `showClose` to "hidden on a notification, shown everywhere else" — a
+ * deliberate rule, written down: a banner is swiped away, and canSwipeToDismiss
+ * turns the gesture on precisely when the ✕ is off. The phone read
+ * `showClose !== false`, so an unset notification kept its ✕ AND, because its
+ * display is a plain merge that leaves the value undefined, never enabled the
+ * swipe. The same notification was dismissable two different ways depending on
+ * which screen you were looking at, and a panel describing it could only be
+ * right about one of them.
+ *
+ * ONLY WHERE THE GESTURE REPLACES IT. Dropping the ✕ from a notification that
+ * cannot be swiped — a modal, a fullscreen takeover, a must-show — would leave
+ * no way out at all. That trap was already live on web, which hid the mark on
+ * every notification regardless of mode; asking canSwipeToDismiss here closes
+ * it on both.
+ *
+ * An explicit value always wins: '' / null / undefined mean "inherit", the same
+ * convention the rest of `display` uses.
+ */
+export declare function showsClose(display: {
+    mode?: unknown;
+    showClose?: unknown;
+} | null | undefined, interactionType?: unknown, delivery?: {
+    mustShow?: unknown;
+} | null): boolean;
 /**
  * How long before this surface dismisses ITSELF, in ms. 0 = never.
  *
@@ -367,6 +395,116 @@ export declare function complianceGate(input: ComplianceInput): ComplianceVerdic
  * regardless of what the survey or the application says.
  */
 export declare function voiceUsable(questions: ValidatableQuestion[] | null | undefined): boolean;
+export declare function collectsAnswer(question: {
+    type?: unknown;
+} | null | undefined): boolean;
+/**
+ * The part of a question set that responses are keyed by.
+ *
+ * Two sets with the same shape can be swapped without orphaning a single
+ * answer — which is the only thing the lock has to protect. Order is included
+ * because a reordered set changes nothing about the keys but IS how a
+ * different survey can be smuggled in with matching ids.
+ */
+export declare function answerShape(questions: Array<{
+    id?: unknown;
+    name?: unknown;
+    type?: unknown;
+}> | null | undefined): string;
+export declare function resolveBranding(survey: {
+    branding?: Record<string, unknown> | null;
+    applicationBranding?: Record<string, unknown> | null;
+    settings?: {
+        themeDetached?: unknown;
+    } | null;
+} | null | undefined): Record<string, unknown>;
+/**
+ * LIGHT OR DARK, AND WHO GETS TO SAY.
+ *
+ * Five answers can arrive at once and they were ranked differently on each
+ * renderer, so the same card came out white on a phone and dark in a browser.
+ * The order, highest first:
+ *
+ *   pinned     a theme set on THIS interaction. An author who picked dark
+ *              meant it; 'auto' or absent steps aside.
+ *   user       identify({ theme }) — the host telling us about this person.
+ *   declared   init({ theme }), or on the web a live <html data-theme>/dark
+ *              class. The host telling us about the surface.
+ *   appDefault the APPLICATION's theme. A default, with exactly the standing
+ *              `defaultLanguage` has always had.
+ *   device     Appearance on a phone, prefers-color-scheme in a browser.
+ *
+ * `device` is LAST, which is the part that is easy to get wrong — it was
+ * ranked above `appDefault` for a day and broke both renderers in opposite
+ * directions. It describes the hardware, not the surface the card is drawn
+ * into: an app shipping `userInterfaceStyle: "dark"` is dark on a light
+ * handset, and a light website is light to a visitor whose desktop is dark.
+ * A card that trusts the device paints itself against the surface holding it.
+ * A host whose theme genuinely tracks the device says so through `declared`,
+ * which is a statement rather than a guess.
+ */
+export type ThemeSource = 'pinned' | 'user' | 'declared' | 'appDefault' | 'device' | 'fallback';
+/**
+ * The same decision, with WHICH CANDIDATE WON attached.
+ *
+ * Diagnostics, and worth having: the question "why is this card light?" was
+ * asked four times across two renderers and answered wrongly twice, because
+ * from the outside every tier produces the same two words. A host running in
+ * debug can now read the reason instead of inferring it from a screenshot.
+ */
+export declare function resolveThemeDecision(input: {
+    pinned?: unknown;
+    user?: unknown;
+    declared?: unknown;
+    appDefault?: unknown;
+    device?: unknown;
+} | null | undefined): {
+    theme: 'light' | 'dark';
+    from: ThemeSource;
+};
+export declare function resolveTheme(input: {
+    pinned?: unknown;
+    user?: unknown;
+    declared?: unknown;
+    appDefault?: unknown;
+    device?: unknown;
+} | null | undefined): 'light' | 'dark';
+/**
+ * DOES THE CARD SHOW A CONFIRMATION AFTER IT IS ACCEPTED?
+ *
+ * An offer's ending is hardcoded: "It's yours", "Use this at checkout." Two
+ * more sentences about somebody else's business, written by us, in a screen an
+ * author could neither reword nor turn off — the same shape as the small print
+ * that shipped inside a template.
+ *
+ * Off is a real answer: an offer whose reward is applied by the host app, or
+ * one that navigates somewhere it is already applied, has nothing to confirm —
+ * the card dwelling on a thank-you is a step between the customer and the thing
+ * they just asked for.
+ *
+ * WITH ONE REFUSAL. A code is handed over ON that screen and nowhere else, so
+ * hiding it would take the discount away at the moment of giving it. That is
+ * not a preference, so it is not offered as one: the flag is ignored and the
+ * screen shows.
+ */
+export declare function showsConfirmation(survey: {
+    settings?: {
+        showConfirmation?: unknown;
+    } | null;
+    reward?: {
+        type?: unknown;
+        value?: unknown;
+    } | null;
+} | null | undefined): boolean;
+/**
+ * The words on that screen, the author's where they wrote any.
+ *
+ * `thankYouMessage` is the field every other interaction already uses for
+ * this, so an offer reaching for a second one would be a second place to look.
+ */
+export declare function confirmationText(survey: {
+    thankYouMessage?: unknown;
+} | null | undefined, fallback: string): string;
 /** The reward, ready to show — or null when there is nothing to hand over. */
 export declare function rewardToShow(survey: {
     reward?: {
@@ -381,6 +519,63 @@ export declare function rewardToShow(survey: {
     whereValid: string;
     expiresAt: string | null;
 } | null;
+/**
+ * Does this question draw a label above itself?
+ *
+ * Every renderer emitted one unconditionally, so a question whose whole
+ * content IS its content — a picture, a block of copy — drew an EMPTY label
+ * and its margin above itself. The way round that was to compose such things
+ * outside the question flow, which puts things on a card that the survey
+ * schema does not describe.
+ *
+ * `hideLabel` is a declared question option now, and this is the one rule all
+ * three renderers ask:
+ *
+ *   hideLabel === true   → never, even with text
+ *   hideLabel === false  → always, even empty (an author who wants the space)
+ *   unset                → only if there is something to say
+ */
+export declare function showsQuestionLabel(question: {
+    type?: unknown;
+    hideLabel?: unknown;
+    text?: unknown;
+    title?: unknown;
+    label?: unknown;
+} | null | undefined): boolean;
+/**
+ * THE SMALL PRINT ON AN OFFER — the author's words, not ours.
+ *
+ * "Valid on your first order only. Cannot be combined with other offers."
+ * shipped as a `content` question in the first-purchase template, which made it
+ * three separate problems:
+ *
+ *   • It is a claim about somebody else's business, stated by us.
+ *   • A `content` question lives in `questions`, which is SCHEMA — so the one
+ *     kind of text most likely to need correcting could not be corrected on a
+ *     LIVE offer, which is the only time correcting it matters.
+ *   • The template translated its title, description and choices into Arabic
+ *     and not this, so an Arabic offer carried English legal text.
+ *
+ * It belongs to the reward, beside what the customer gets and where it is
+ * valid. Empty means no small print, which is the right default: an offer with
+ * no conditions should not be made to invent some.
+ *
+ * FALLS BACK TO THE LEGACY QUESTION so offers created before this keep showing
+ * what they already show. Tags are stripped rather than rendered — the text is
+ * drawn as text by all three renderers, and `<small>` was only ever standing in
+ * for the styling the card now does itself.
+ */
+export declare function rewardTerms(survey: {
+    reward?: {
+        terms?: unknown;
+    } | null;
+    questions?: Array<{
+        id?: unknown;
+        type?: unknown;
+        html?: unknown;
+        text?: unknown;
+    }> | null;
+} | null | undefined): string;
 /**
  * Where clicking the CARD ITSELF should take someone, or null.
  *
@@ -400,6 +595,148 @@ export declare function cardClickTarget(display: {
 } | null | undefined, actions: Array<{
     href?: string;
 }> | null | undefined): string | null;
+/**
+ * May the whole card be pressed?
+ *
+ * SEPARATE FROM WHERE IT GOES, and that separation is the fix. cardClickTarget
+ * answers "what destination does the card carry", and returns null when there
+ * is none — but a notification whose action is "tell your app" or "call an
+ * endpoint" has no destination and is still entirely pressable: pressing it
+ * records the answer and runs the action, which is the whole point of those
+ * two kinds.
+ *
+ * Reading the target as the permission meant that on any non-URL action the
+ * card lost its pointer cursor, its hover treatment and its click handler at
+ * once — so "What the card does under the cursor" did nothing, with no clue
+ * why.
+ *
+ * The safety argument is unchanged and lives here: exactly ONE action. That is
+ * the notification shape, and it excludes every consent choice — on a
+ * two-action compliance takeover a stray click anywhere would otherwise record
+ * agreement, which a consent record must never manufacture.
+ */
+export declare function cardIsClickable(display: {
+    cardClickable?: unknown;
+} | null | undefined, actions: Array<{
+    href?: string;
+}> | null | undefined): boolean;
+/**
+ * Is the action BUTTON drawn?
+ *
+ * A card whose whole surface is the action does not always need a button
+ * repeating it — "Resume" written twice on a banner two lines tall is the
+ * button competing with the card for the same press. So an author may hide it
+ * and let the card carry the action alone.
+ *
+ * ONLY WHEN THE CARD CAN ACTUALLY TAKE THE PRESS. Hiding the button on a card
+ * that is not clickable leaves a surface with something to say and no way to
+ * say yes to it — the respondent's only exit is the dismissal, which records
+ * the opposite of what the author was asking for. So the hide is honoured
+ * strictly when cardIsClickable agrees, and ignored otherwise.
+ *
+ * That also inherits the one-action guard: a two-action consent takeover can
+ * never hide its buttons, because a card that silently picks one of two
+ * answers is the thing consent must never do.
+ */
+export declare function showActionButton(display: {
+    cardClickable?: unknown;
+    showAction?: unknown;
+} | null | undefined, actions: Array<{
+    href?: string;
+}> | null | undefined): boolean;
+export interface TriggerContext {
+    definitionId?: unknown;
+    eventName?: unknown;
+    eventType?: unknown;
+    eventData?: unknown;
+    pathname?: unknown;
+}
+/**
+ * The variables a response carries about what made the interaction appear.
+ *
+ * `eventData` is spread FIRST so a caller's own values (URL params, identify()
+ * traits) still win when merged on top — the triggering event describes the
+ * occasion, not the respondent.
+ */
+export declare function triggerVariables(tc: TriggerContext | null | undefined): Record<string, unknown>;
+export type ImageLayout = 'beside' | 'above' | 'below' | 'background' | 'half' | 'none';
+export declare function imageLayout(display: {
+    imageLayout?: unknown;
+} | null | undefined, interactionType: unknown, hasImage: boolean): ImageLayout;
+/**
+ * EVERYTHING ABOUT THE PICTURE, RESOLVED ONCE.
+ *
+ * Layout alone was enough while the answer was "a square, a band, or the whole
+ * card". An offer wants the picture to CARRY the card — half of it, cropped to
+ * the part that matters, with the seam between image and words softened — and
+ * that is five more decisions. Asked one at a time they drift: the preview
+ * centres a band the phone left-aligns, and nobody notices until an author
+ * says the two do not match.
+ *
+ * WHAT IS DELIBERATELY ABSENT: blur. The React Native SDK declares no
+ * dependencies beyond AsyncStorage, and React Native has no blur primitive —
+ * `react-native-svg` is an OPTIONAL peer, so it cannot be relied on either. A
+ * Blur control would work in the preview and do nothing on a phone, which is
+ * the exact class of control this codebase has spent a long time removing.
+ * Everything below works natively on both.
+ */
+export interface ImageDesign {
+    layout: ImageLayout;
+    /** For 'half': which half the picture takes. Mirrored in a right-to-left
+     *  card, because the whole card is. */
+    side: 'left' | 'right' | 'top';
+    /** For 'half': the share of the card the picture takes, 20-80. */
+    split: number;
+    /** How wide a band is, as a share of the card, 20-100. Alignment only means
+     *  something once this is less than the whole width. */
+    width: number;
+    /** Where the picture sits in the space it is given. Vertical for a square
+     *  beside the text, horizontal for a band narrower than the card.
+     *
+     *  BOX POSITION, NOT FOCAL POINT. The obvious reading — which part of a
+     *  cropped photograph you see — is object-position, and React Native has no
+     *  equivalent: it would work in the preview and do nothing on a phone. This
+     *  moves the picture's box, which both runtimes do natively. */
+    align: 'start' | 'center' | 'end';
+    /** How it fills that space. 'contain' shows all of it and may letterbox. */
+    fit: 'cover' | 'contain';
+    /** WHICH PART STAYS VISIBLE when 'cover' crops, 0-100 on each axis, 50 being
+     *  the centre crop every renderer does by default.
+     *
+     *  The thing that makes one picture work at three different shapes: a face
+     *  near the top survives a wide band, a product on the right survives a left
+     *  half. Without it an author has to re-crop the file for each layout.
+     *
+     *  Meaningless under 'contain', which shows all of it — the editor offers it
+     *  only where it bites. */
+    focusX: number;
+    focusY: number;
+    /** Card colour painted over the picture, 0-100. Only where words sit ON it. */
+    scrim: number;
+    /** How far the picture dissolves into the card at the seam, 0-100. A hard
+     *  edge between a photograph and a block of text is the main thing that
+     *  makes a split card look unfinished. */
+    fade: number;
+}
+export declare function imageDesign(display: {
+    imageLayout?: unknown;
+    imageSide?: unknown;
+    imageSplit?: unknown;
+    imageWidth?: unknown;
+    imageAlign?: unknown;
+    imageFit?: unknown;
+    imageScrim?: unknown;
+    imageFade?: unknown;
+    imageFocusX?: unknown;
+    imageFocusY?: unknown;
+} | null | undefined, interactionType: unknown, hasImage: boolean): ImageDesign;
+/** How much of the card colour is painted over the picture, 0-100.
+ *
+ *  Only where the words sit ON the picture: behind the whole card, or across
+ *  a half. The layouts that keep image and text in separate boxes need none. */
+export declare function imageScrim(display: {
+    imageScrim?: unknown;
+} | null | undefined): number;
 /** Hover treatment for a clickable card. Pointer devices only. */
 export declare function cardHoverEffect(display: {
     hoverEffect?: unknown;
@@ -407,7 +744,11 @@ export declare function cardHoverEffect(display: {
 export type ActionKind = 'url' | 'event' | 'webhook';
 export interface RawAction {
     type?: unknown;
+    /** The endpoint for a webhook, or the legacy destination for type 'url'. */
     value?: unknown;
+    /** Where the press navigates, independent of kind — so an action can both
+     *  take someone somewhere and report that it happened. */
+    href?: unknown;
     /** For 'event': the name the host application listens for. */
     eventName?: unknown;
     /** Template payload — values may contain {{variable}} references. */
@@ -415,8 +756,12 @@ export interface RawAction {
 }
 export interface ResolvedAction {
     kind: ActionKind;
-    /** Navigable target for 'url', endpoint for 'webhook'. Null when unusable. */
+    /** Navigable target for 'url', endpoint for 'webhook'. Null when unusable.
+     *  Unchanged in meaning — hosts read it — see `destination` below. */
     href: string | null;
+    /** Where the press NAVIGATES, whatever the kind. Set only from action.href,
+     *  so it is never confused with an endpoint. Null when there is none. */
+    destination: string | null;
     eventName: string | null;
     /** Payload with every {{reference}} substituted. */
     payload: Record<string, string>;

package/dist/validate.d.ts.map

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

package/dist/validate.js

@@ -10,6 +10,7 @@ exports.safeImageSrc = safeImageSrc;
 exports.impliedStepActions = impliedStepActions;
 exports.impliedEqualProminence = impliedEqualProminence;
 exports.canSwipeToDismiss = canSwipeToDismiss;
+exports.showsClose = showsClose;
 exports.autoDismissMs = autoDismissMs;
 exports.deadlineCountdown = deadlineCountdown;
 exports.formatCountdown = formatCountdown;
@@ -17,8 +18,23 @@ exports.outcomeFor = outcomeFor;
 exports.questionForValidation = questionForValidation;
 exports.complianceGate = complianceGate;
 exports.voiceUsable = voiceUsable;
+exports.collectsAnswer = collectsAnswer;
+exports.answerShape = answerShape;
+exports.resolveBranding = resolveBranding;
+exports.resolveThemeDecision = resolveThemeDecision;
+exports.resolveTheme = resolveTheme;
+exports.showsConfirmation = showsConfirmation;
+exports.confirmationText = confirmationText;
 exports.rewardToShow = rewardToShow;
+exports.showsQuestionLabel = showsQuestionLabel;
+exports.rewardTerms = rewardTerms;
 exports.cardClickTarget = cardClickTarget;
+exports.cardIsClickable = cardIsClickable;
+exports.showActionButton = showActionButton;
+exports.triggerVariables = triggerVariables;
+exports.imageLayout = imageLayout;
+exports.imageDesign = imageDesign;
+exports.imageScrim = imageScrim;
 exports.cardHoverEffect = cardHoverEffect;
 exports.resolveAction = resolveAction;
 const messages_1 = require("./messages");
@@ -414,9 +430,15 @@ interpolate = (s) => s) {
             // Interpolated BEFORE the scheme check, never after: a template that
             // resolves to `javascript:` has to be caught on what it BECAME, not on
             // the harmless-looking string it started as.
-            const rawHref = (o.action && typeof o.action === 'object')
-                ? o.action.value
+            const act = (o.action && typeof o.action === 'object')
+                ? o.action
                 : undefined;
+            // href first — see safeActionHref. Interpolated the same way, because a
+            // destination is a template wherever it is stored.
+            const rawHref = act
+                ? (typeof act.href === 'string' && act.href ? act.href : act.value)
+                : undefined;
+            const viaHref = !!(act && typeof act.href === 'string' && act.href);
             const resolved = typeof rawHref === 'string' && rawHref
                 ? interpolate(rawHref)
                 : rawHref;
@@ -427,7 +449,9 @@ interpolate = (s) => s) {
             const usable = typeof resolved === 'string' && /\{\{.*\}\}/.test(resolved)
                 ? undefined
                 : resolved;
-            const href = safeActionHref(usable === undefined ? undefined : { ...o.action, value: usable });
+            const href = safeActionHref(usable === undefined ? undefined
+                : viaHref ? { ...o.action, href: usable }
+                    : { ...o.action, value: usable });
             if (value !== '' || label !== '') {
                 const entry = href ? { value, label: label || value, href } : { value, label: label || value };
                 // "Remind me later" — see isDeferChoice. Carried through because a
@@ -485,9 +509,21 @@ function safeActionHref(action) {
     if (!action || typeof action !== 'object')
         return undefined;
     const a = action;
-    if (String(a.type || '').toLowerCase() !== 'url')
-        return undefined;
-    const v = typeof a.value === 'string' ? a.value.trim() : '';
+    // A DESTINATION IS NOT A KIND OF ACTION, IT IS A PROPERTY OF ONE.
+    //
+    // Reading the destination out of `value` meant `value` had to be a URL, which
+    // meant type had to be 'url', which made "take them somewhere" and "report
+    // this press" mutually exclusive. They are not: a button on an abandoned-cart
+    // nudge that opens the cart AND tells your backend is the ordinary case, and
+    // an author asked why it had to be one or the other.
+    //
+    // `href` carries the destination on its own, whatever the action's kind. The
+    // legacy pair (type 'url' + value) still resolves, so nothing already
+    // authored changes.
+    const explicit = typeof a.href === 'string' ? a.href.trim() : '';
+    const legacy = String(a.type || '').toLowerCase() === 'url'
+        && typeof a.value === 'string' ? a.value.trim() : '';
+    const v = explicit || legacy;
     if (!v)
         return undefined; // '' = not configured yet
     // Reject anything whose scheme could execute in the host document.
@@ -627,6 +663,36 @@ function canSwipeToDismiss(display, delivery) {
         return false; // fullscreen / modal never swipe
     return display.showClose === false; // the gesture REPLACES the ✕
 }
+/**
+ * Is the ✕ drawn?
+ *
+ * TWO RENDERERS, TWO ANSWERS, from one authored survey. Web resolved an unset
+ * `showClose` to "hidden on a notification, shown everywhere else" — a
+ * deliberate rule, written down: a banner is swiped away, and canSwipeToDismiss
+ * turns the gesture on precisely when the ✕ is off. The phone read
+ * `showClose !== false`, so an unset notification kept its ✕ AND, because its
+ * display is a plain merge that leaves the value undefined, never enabled the
+ * swipe. The same notification was dismissable two different ways depending on
+ * which screen you were looking at, and a panel describing it could only be
+ * right about one of them.
+ *
+ * ONLY WHERE THE GESTURE REPLACES IT. Dropping the ✕ from a notification that
+ * cannot be swiped — a modal, a fullscreen takeover, a must-show — would leave
+ * no way out at all. That trap was already live on web, which hid the mark on
+ * every notification regardless of mode; asking canSwipeToDismiss here closes
+ * it on both.
+ *
+ * An explicit value always wins: '' / null / undefined mean "inherit", the same
+ * convention the rest of `display` uses.
+ */
+function showsClose(display, interactionType, delivery) {
+    const raw = display?.showClose;
+    if (raw !== undefined && raw !== null && raw !== '')
+        return raw !== false;
+    if (String(interactionType || '').toLowerCase() !== 'notify')
+        return true;
+    return !canSwipeToDismiss({ ...(display || {}), showClose: false }, delivery);
+}
 /**
  * How long before this surface dismisses ITSELF, in ms. 0 = never.
  *
@@ -882,6 +948,178 @@ function voiceUsable(questions) {
             && t !== 'image' && t !== 'expression' && t !== 'pagebreak';
     });
 }
+/**
+ * Does this question record an answer?
+ *
+ * WHAT THE QUESTION LOCK IS ACTUALLY FOR. A survey that has started collecting
+ * refuses edits to `questions`, because responses are keyed by question id and
+ * a moved key orphans the data already gathered. That is a real rule — and it
+ * was applied to the WHOLE array, including questions that record nothing.
+ *
+ * A `content` block, a picture, a page break: none of them has an answer, so
+ * changing their words cannot orphan anything. Locking them made the offer's
+ * small print — the text most likely to need correcting on a running offer —
+ * uneditable for the same reason a rating scale is, which is not the same
+ * reason at all. The headline and the description sit right beside it and were
+ * never locked, because they are not in `questions`.
+ *
+ * NOT voiceUsable's list. That one also excludes `implied`, because a button
+ * cannot be spoken — but an implied question very much records an answer, and
+ * for this question it must count.
+ */
+const RECORDS_NOTHING = ['html', 'content', 'image', 'expression', 'pagebreak', 'page_break'];
+function collectsAnswer(question) {
+    if (!question)
+        return false;
+    return RECORDS_NOTHING.indexOf(String(question.type || '').toLowerCase()) < 0;
+}
+/**
+ * The part of a question set that responses are keyed by.
+ *
+ * Two sets with the same shape can be swapped without orphaning a single
+ * answer — which is the only thing the lock has to protect. Order is included
+ * because a reordered set changes nothing about the keys but IS how a
+ * different survey can be smuggled in with matching ids.
+ */
+function answerShape(questions) {
+    if (!Array.isArray(questions))
+        return '';
+    return questions
+        .filter((q) => collectsAnswer(q))
+        .map((q) => `${String(q?.id ?? q?.name ?? '')}:${String(q?.type ?? '').toLowerCase()}`)
+        .join('|');
+}
+/**
+ * THE BRANDING CASCADE: survey.branding ▶ applicationBranding ▶ built-in.
+ *
+ * A survey stores only what its author changed, so everything else has to
+ * resolve up to the application at render time. The web SDK learned this once
+ * already — it read `surveyData.branding` alone and an application palette
+ * stopped there — and the React Native SDK never learned it at all: it took
+ * `raw.branding` and nothing else, so an interaction with no palette of its own
+ * drew the SDK's built-in lime on a phone no matter what the application said,
+ * and an application-level button padding never arrived either.
+ *
+ * Reported as both, separately, which is what an unresolved layer looks like
+ * from the outside: a list of unrelated settings that "do not apply on mobile".
+ *
+ * Nested groups merge per KEY, and `palette` one level deeper again because it
+ * is keyed by theme — a survey overriding one surface must not drop the
+ * application's others. '' / null / undefined mean INHERIT, the same convention
+ * `display` uses.
+ */
+const BRANDING_GROUPS = ['palette', 'style', 'typography', 'layout'];
+function resolveBranding(survey) {
+    const own = (survey?.branding || {});
+    // A detached survey carries its own theme and stops inheriting entirely.
+    if (survey?.settings?.themeDetached)
+        return own;
+    const app = (survey?.applicationBranding || {});
+    const keep = (v) => v !== undefined && v !== null && v !== '';
+    const out = { ...app };
+    for (const [k, v] of Object.entries(own))
+        if (keep(v))
+            out[k] = v;
+    // THEME IS THE ONE FIELD THAT DOES NOT MERGE, because it is the one field a
+    // respondent has an opinion about. Every other branding key is the brand's
+    // to decide — a colour, a radius, a font. Light-vs-dark is the reader's, and
+    // an application-level value folded into `theme` here became indistinguish-
+    // able from an author pinning this one card, so it outranked the respondent's
+    // own device on every surface. It is carried separately instead, and the
+    // renderers place it where a default belongs: under everything the SDK can
+    // tell us about the person, over nothing but the built-in. Exactly the
+    // standing `defaultLanguage` has always had, which is why language was right
+    // and theme was wrong.
+    if (keep(app.theme))
+        out.themeDefault = app.theme;
+    if (!keep(own.theme))
+        delete out.theme;
+    for (const g of BRANDING_GROUPS) {
+        const a = app[g];
+        const o = own[g];
+        if (!a || !o || typeof a !== 'object' || typeof o !== 'object')
+            continue;
+        const merged = { ...a };
+        for (const [kk, ov] of Object.entries(o)) {
+            const av = merged[kk];
+            if (av && ov && typeof av === 'object' && typeof ov === 'object'
+                && !Array.isArray(av) && !Array.isArray(ov)) {
+                const deep = { ...av };
+                for (const [k3, v3] of Object.entries(ov)) {
+                    if (keep(v3))
+                        deep[k3] = v3;
+                }
+                merged[kk] = deep;
+            }
+            else if (keep(ov)) {
+                merged[kk] = ov;
+            }
+        }
+        out[g] = merged;
+    }
+    return out;
+}
+/**
+ * The same decision, with WHICH CANDIDATE WON attached.
+ *
+ * Diagnostics, and worth having: the question "why is this card light?" was
+ * asked four times across two renderers and answered wrongly twice, because
+ * from the outside every tier produces the same two words. A host running in
+ * debug can now read the reason instead of inferring it from a screenshot.
+ */
+function resolveThemeDecision(input) {
+    const pick = (v) => {
+        const t = typeof v === 'string' ? v.toLowerCase() : '';
+        return t === 'light' || t === 'dark' ? t : undefined; // 'auto' steps aside
+    };
+    const order = ['pinned', 'user', 'declared', 'appDefault', 'device'];
+    for (const from of order) {
+        const theme = pick(input?.[from]);
+        if (theme)
+            return { theme, from };
+    }
+    return { theme: 'dark', from: 'fallback' };
+}
+function resolveTheme(input) {
+    return resolveThemeDecision(input).theme;
+}
+/**
+ * DOES THE CARD SHOW A CONFIRMATION AFTER IT IS ACCEPTED?
+ *
+ * An offer's ending is hardcoded: "It's yours", "Use this at checkout." Two
+ * more sentences about somebody else's business, written by us, in a screen an
+ * author could neither reword nor turn off — the same shape as the small print
+ * that shipped inside a template.
+ *
+ * Off is a real answer: an offer whose reward is applied by the host app, or
+ * one that navigates somewhere it is already applied, has nothing to confirm —
+ * the card dwelling on a thank-you is a step between the customer and the thing
+ * they just asked for.
+ *
+ * WITH ONE REFUSAL. A code is handed over ON that screen and nowhere else, so
+ * hiding it would take the discount away at the moment of giving it. That is
+ * not a preference, so it is not offered as one: the flag is ignored and the
+ * screen shows.
+ */
+function showsConfirmation(survey) {
+    if (survey?.settings?.showConfirmation !== false)
+        return true;
+    // The only thing the customer cannot get any other way.
+    const r = survey?.reward;
+    const isCode = String(r?.type || '') === 'code' && !!String(r?.value ?? '').trim();
+    return isCode;
+}
+/**
+ * The words on that screen, the author's where they wrote any.
+ *
+ * `thankYouMessage` is the field every other interaction already uses for
+ * this, so an offer reaching for a second one would be a second place to look.
+ */
+function confirmationText(survey, fallback) {
+    const own = String(survey?.thankYouMessage ?? '')
+        .replace(/<[^>]*>/g, '').replace(/&nbsp;/gi, ' ').trim();
+    return own || fallback;
+}
 /** The reward, ready to show — or null when there is nothing to hand over. */
 function rewardToShow(survey) {
     const r = survey?.reward;
@@ -904,6 +1142,82 @@ function rewardToShow(survey) {
         expiresAt: survey?.endDate ? new Date(String(survey.endDate)).toISOString() : null,
     };
 }
+/**
+ * Does this question draw a label above itself?
+ *
+ * Every renderer emitted one unconditionally, so a question whose whole
+ * content IS its content — a picture, a block of copy — drew an EMPTY label
+ * and its margin above itself. The way round that was to compose such things
+ * outside the question flow, which puts things on a card that the survey
+ * schema does not describe.
+ *
+ * `hideLabel` is a declared question option now, and this is the one rule all
+ * three renderers ask:
+ *
+ *   hideLabel === true   → never, even with text
+ *   hideLabel === false  → always, even empty (an author who wants the space)
+ *   unset                → only if there is something to say
+ */
+function showsQuestionLabel(question) {
+    if (!question)
+        return false;
+    // AN IMPLIED QUESTION NEVER SHOWS ONE, whatever it carries.
+    //
+    // Its `text` — "Offer accepted?" — is the analytics prompt, what the recorded
+    // answer MEANS, not copy for the customer. Its choices are the buttons. Both
+    // renderers had that as a special case beside this one, which is precisely
+    // how a rule ends up applied in one place and not the other: the first thing
+    // that happened when the phone started asking this function instead was the
+    // stray authoring text coming back.
+    if (String(question.type || '').toLowerCase() === 'implied')
+        return false;
+    if (question.hideLabel === true)
+        return false;
+    if (question.hideLabel === false)
+        return true;
+    const text = question.title ?? question.text ?? question.label ?? '';
+    return String(text).trim().length > 0;
+}
+/**
+ * THE SMALL PRINT ON AN OFFER — the author's words, not ours.
+ *
+ * "Valid on your first order only. Cannot be combined with other offers."
+ * shipped as a `content` question in the first-purchase template, which made it
+ * three separate problems:
+ *
+ *   • It is a claim about somebody else's business, stated by us.
+ *   • A `content` question lives in `questions`, which is SCHEMA — so the one
+ *     kind of text most likely to need correcting could not be corrected on a
+ *     LIVE offer, which is the only time correcting it matters.
+ *   • The template translated its title, description and choices into Arabic
+ *     and not this, so an Arabic offer carried English legal text.
+ *
+ * It belongs to the reward, beside what the customer gets and where it is
+ * valid. Empty means no small print, which is the right default: an offer with
+ * no conditions should not be made to invent some.
+ *
+ * FALLS BACK TO THE LEGACY QUESTION so offers created before this keep showing
+ * what they already show. Tags are stripped rather than rendered — the text is
+ * drawn as text by all three renderers, and `<small>` was only ever standing in
+ * for the styling the card now does itself.
+ */
+function rewardTerms(survey) {
+    const own = survey?.reward?.terms;
+    if (own != null && String(own).trim())
+        return String(own).trim();
+    const qs = Array.isArray(survey?.questions) ? survey.questions : [];
+    for (const q of qs) {
+        if (String(q?.id || '') !== 'offer_terms')
+            continue;
+        if (String(q?.type || '').toLowerCase() !== 'content')
+            continue;
+        const raw = String(q?.html ?? q?.text ?? '');
+        const text = raw.replace(/<[^>]*>/g, '').replace(/&nbsp;/gi, ' ').trim();
+        if (text)
+            return text;
+    }
+    return '';
+}
 /**
  * Where clicking the CARD ITSELF should take someone, or null.
  *
@@ -928,6 +1242,160 @@ function cardClickTarget(display, actions) {
     const own = safeActionHref({ type: 'url', value: display?.cardHref });
     return own || acts[0].href || null;
 }
+/**
+ * May the whole card be pressed?
+ *
+ * SEPARATE FROM WHERE IT GOES, and that separation is the fix. cardClickTarget
+ * answers "what destination does the card carry", and returns null when there
+ * is none — but a notification whose action is "tell your app" or "call an
+ * endpoint" has no destination and is still entirely pressable: pressing it
+ * records the answer and runs the action, which is the whole point of those
+ * two kinds.
+ *
+ * Reading the target as the permission meant that on any non-URL action the
+ * card lost its pointer cursor, its hover treatment and its click handler at
+ * once — so "What the card does under the cursor" did nothing, with no clue
+ * why.
+ *
+ * The safety argument is unchanged and lives here: exactly ONE action. That is
+ * the notification shape, and it excludes every consent choice — on a
+ * two-action compliance takeover a stray click anywhere would otherwise record
+ * agreement, which a consent record must never manufacture.
+ */
+function cardIsClickable(display, actions) {
+    const acts = Array.isArray(actions) ? actions : [];
+    if (acts.length !== 1)
+        return false;
+    // OPT IN, NOT OPT OUT.
+    //
+    // This read `!== false`, so a card with one action was pressable anywhere on
+    // its surface unless someone had turned that off. A whole card that navigates
+    // is a real behaviour to choose, not a default to discover: on a notification
+    // it means the message and the dismissal target overlap, and the author who
+    // never opened this panel never agreed to it.
+    //
+    // The guard above still holds either way — two actions are never
+    // card-clickable, because a card that silently picks one of two answers is
+    // the thing consent must never do.
+    return display?.cardClickable === true;
+}
+/**
+ * Is the action BUTTON drawn?
+ *
+ * A card whose whole surface is the action does not always need a button
+ * repeating it — "Resume" written twice on a banner two lines tall is the
+ * button competing with the card for the same press. So an author may hide it
+ * and let the card carry the action alone.
+ *
+ * ONLY WHEN THE CARD CAN ACTUALLY TAKE THE PRESS. Hiding the button on a card
+ * that is not clickable leaves a surface with something to say and no way to
+ * say yes to it — the respondent's only exit is the dismissal, which records
+ * the opposite of what the author was asking for. So the hide is honoured
+ * strictly when cardIsClickable agrees, and ignored otherwise.
+ *
+ * That also inherits the one-action guard: a two-action consent takeover can
+ * never hide its buttons, because a card that silently picks one of two
+ * answers is the thing consent must never do.
+ */
+function showActionButton(display, actions) {
+    if (display?.showAction !== false)
+        return true; // shown unless hidden
+    return !cardIsClickable(display, actions); // hide only if the card takes it
+}
+/**
+ * The variables a response carries about what made the interaction appear.
+ *
+ * `eventData` is spread FIRST so a caller's own values (URL params, identify()
+ * traits) still win when merged on top — the triggering event describes the
+ * occasion, not the respondent.
+ */
+function triggerVariables(tc) {
+    const out = {};
+    if (!tc || typeof tc !== 'object')
+        return out;
+    const data = tc.eventData;
+    if (data && typeof data === 'object') {
+        for (const [k, v] of Object.entries(data)) {
+            if (v != null && v !== '')
+                out[k] = v;
+        }
+    }
+    // Underscore-prefixed so they cannot collide with an author's own event
+    // field — `eventName` is a plausible thing to put in eventData.
+    if (tc.definitionId)
+        out._triggerDefinition = String(tc.definitionId);
+    if (tc.eventName)
+        out._triggerEvent = String(tc.eventName);
+    if (tc.pathname)
+        out._triggerPath = String(tc.pathname);
+    return out;
+}
+const IMAGE_LAYOUTS = ['beside', 'above', 'below', 'background', 'half'];
+/** Which interactions compose their own picture. Everything else leaves the
+ *  `image` question where it is. */
+const COMPOSES_IMAGE = ['notify', 'offer'];
+function imageLayout(display, interactionType, hasImage) {
+    if (!hasImage)
+        return 'none';
+    const kind = String(interactionType || '').toLowerCase();
+    if (COMPOSES_IMAGE.indexOf(kind) < 0)
+        return 'none';
+    const raw = String(display?.imageLayout || '').toLowerCase();
+    if (IMAGE_LAYOUTS.indexOf(raw) >= 0)
+        return raw;
+    // UNSET IS THE SHAPE EACH ONE ALREADY HAD. A notification has always drawn
+    // the square beside its text, and changing that under every existing
+    // notification would be a redesign nobody asked for. An offer has no
+    // incumbent layout to preserve and the picture is the offer, so it leads.
+    return kind === 'notify' ? 'beside' : 'above';
+}
+const SIDES = ['left', 'right', 'top'];
+const ALIGNS = ['start', 'center', 'end'];
+/** Clamped to a range with a stated default — never NaN, never out of bounds. */
+function pct(v, dflt, lo = 0, hi = 100) {
+    const n = Number(v);
+    if (!isFinite(n))
+        return dflt;
+    return Math.max(lo, Math.min(hi, Math.round(n)));
+}
+function imageDesign(display, interactionType, hasImage) {
+    const layout = imageLayout(display, interactionType, hasImage);
+    const rawSide = String(display?.imageSide || '').toLowerCase();
+    const rawAlign = String(display?.imageAlign || '').toLowerCase();
+    return {
+        layout,
+        side: (SIDES.indexOf(rawSide) >= 0 ? rawSide : 'left'),
+        // 20-80 rather than 0-100: a 5% sliver is not a half, and a 95% one leaves
+        // the words a gutter. A control should refuse what the layout cannot be.
+        split: pct(display?.imageSplit, 50, 20, 80),
+        width: pct(display?.imageWidth, 100, 20, 100),
+        // Centre is right for a band and wrong for a square beside text, which
+        // should sit level with the headline it belongs to.
+        align: (ALIGNS.indexOf(rawAlign) >= 0 ? rawAlign
+            : (layout === 'beside' ? 'start' : 'center')),
+        fit: String(display?.imageFit || '').toLowerCase() === 'contain' ? 'contain' : 'cover',
+        focusX: pct(display?.imageFocusX, 50),
+        focusY: pct(display?.imageFocusY, 50),
+        // 40 BEHIND THE CARD, 0 EVERYWHERE ELSE.
+        //
+        // The scrim exists because words sit ON the picture, which is true by
+        // construction of a backdrop and not of a half — there the text has its own
+        // side. Carrying the backdrop's default across would have dimmed every
+        // split image by 40% that nobody asked to dim.
+        scrim: layout === 'background' ? imageScrim(display) : pct(display?.imageScrim, 0),
+        fade: pct(display?.imageFade, 0),
+    };
+}
+/** How much of the card colour is painted over the picture, 0-100.
+ *
+ *  Only where the words sit ON the picture: behind the whole card, or across
+ *  a half. The layouts that keep image and text in separate boxes need none. */
+function imageScrim(display) {
+    const n = Number(display?.imageScrim);
+    if (!isFinite(n))
+        return 40;
+    return Math.max(0, Math.min(100, Math.round(n)));
+}
 /** Hover treatment for a clickable card. Pointer devices only. */
 function cardHoverEffect(display) {
     const v = String(display?.hoverEffect || '').toLowerCase();
@@ -954,6 +1422,19 @@ function resolveAction(action, interpolate = (s) => s) {
     const template = typeof action.value === 'string' ? action.value : '';
     const substituted = template ? interpolate(template) : '';
     const href = substituted ? safeActionHref({ type: 'url', value: substituted }) || null : null;
+    // WHERE THE PRESS NAVIGATES, kept separate from `href` on purpose.
+    //
+    // `href` has always meant two different things depending on kind — the
+    // destination for a 'url' action, the endpoint to call for a 'webhook' one —
+    // and hosts read it that way, so it is left exactly as it was. Now that one
+    // action can BOTH navigate and report, the navigation target needs a name of
+    // its own: without it, a button with an endpoint in `value` and a destination
+    // in `href` would send the customer to the customer's own backend.
+    const destTemplate = typeof action.href === 'string' ? action.href : '';
+    const destSubstituted = destTemplate ? interpolate(destTemplate) : '';
+    const destination = destSubstituted
+        ? safeActionHref({ href: destSubstituted }) || null
+        : null;
     const payload = {};
     const p = action.payload;
     if (p && typeof p === 'object' && !Array.isArray(p)) {
@@ -981,7 +1462,7 @@ function resolveAction(action, interpolate = (s) => s) {
     const eventName = typeof action.eventName === 'string' && action.eventName.trim()
         ? action.eventName.trim() : null;
     // Nothing to do: no destination, no event name, no payload.
-    if (!href && !eventName && Object.keys(payload).length === 0)
+    if (!href && !destination && !eventName && Object.keys(payload).length === 0)
         return null;
-    return { kind, href, eventName, payload };
+    return { kind, href, destination, eventName, payload };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxpinsight/survey-spec",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "The survey specification the renderers share — expression evaluation first. Source of truth for behaviour that must be identical on web, links and mobile.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",