@cxpinsight/react-native 0.2.0

package/lib/survey/styleContract.js

@@ -0,0 +1,365 @@
+"use strict";
+/**
+ * Survey style contract — the shared theming vocabulary.
+ *
+ * Why this exists
+ * ---------------
+ * `customCss` cannot work on React Native: RN has no CSS engine, so arbitrary
+ * CSS has nothing to act on. Rather than accept a permanent styling gap between
+ * web and mobile, theming moves to a *structured* contract that both platforms
+ * implement. A customer brands once; it applies everywhere.
+ *
+ * The trade, stated honestly: this is comprehensive, not arbitrary. Every
+ * surface the renderer draws is themeable. Author-invented selectors, cascade
+ * tricks and layout restructuring are not — those stay web-only via `customCss`.
+ *
+ * Relationship to `themePalette.ts`
+ * ---------------------------------
+ * `ThemePalette` (9 fields) is the shipped subset of this contract and stays
+ * working — `toLegacyPalette()` derives it, so existing callers and any host app
+ * passing `brandingPalette` are unaffected. This widens the vocabulary from 9
+ * fields to full coverage of the ~200 style properties the native renderer sets.
+ *
+ * Web mapping
+ * -----------
+ * The web renderer exposes the same concepts as `--vp-color-*` / `--vp-fs-*`
+ * custom properties. Field names here are the canonical vocabulary; the web side
+ * maps onto them. `CSS_VAR_MAP` at the bottom records that mapping so the two
+ * cannot drift silently.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CSS_VAR_MAP = exports.LIGHT_CONTRACT = exports.DARK_CONTRACT = void 0;
+exports.resolveStyleContract = resolveStyleContract;
+exports.toLegacyPalette = toLegacyPalette;
+exports.fromAuthoredPalette = fromAuthoredPalette;
+/* ------------------------------------------------------------------ defaults */
+/**
+ * Numeric defaults are the values the native renderer SHIPS, audited from the
+ * StyleSheets at git HEAD — not idealised values. Changing any of them changes
+ * how every unstyled survey looks, so they are deliberately unlovely:
+ * `ratingRadius` is 12 while `npsRadius` is 8 because the two components
+ * genuinely differ today. Unifying them is a design decision for later, not
+ * something this migration should smuggle in.
+ */
+const SHARED = {
+    cardRadius: 20, // SurveyModal.card
+    cardPadding: 24, // SurveyModal.card
+    // Per-side padding. Unset means "use cardPadding", which is why these carry
+    // no numeric default — a default here would silently win over the shorthand.
+    cardPaddingTop: undefined,
+    cardPaddingRight: undefined,
+    cardPaddingBottom: undefined,
+    cardPaddingLeft: undefined,
+    inputRadius: 12, // TextQuestion / DateQuestion
+    optionRadius: 12, // MultipleChoiceQuestion row
+    ratingRadius: 12, // RatingQuestion button
+    npsRadius: 8, // NPSQuestion button — genuinely differs from rating
+    buttonRadius: 12, // SurveyModal back/next
+    buttonPaddingY: 14, // SurveyModal back/next — the prior literal
+    buttonFontSize: 15, // back/next label — the prior literal
+    fontSizeHeading: 20,
+    fontSizeLabel: 15,
+    fontSizeInput: 15,
+    fontSizeDescription: 13,
+    fontSizeSmall: 12,
+    fontWeightHeading: '600',
+    fontWeightLabel: '500',
+    lineHeightBody: 1.5,
+    fieldGap: 8, // RatingQuestion row gap
+    sectionGap: 20,
+    topRuleHeight: 0,
+};
+exports.DARK_CONTRACT = {
+    ...SHARED,
+    accent: '#D6F551',
+    accentHover: '#C3E144',
+    accentText: '#030712',
+    ground: 'rgba(0,0,0,0.6)',
+    card: 'rgba(17,24,39,0.95)',
+    cardBorder: 'rgba(255,255,255,0.1)',
+    input: 'rgba(255,255,255,0.06)',
+    inputBorder: 'rgba(255,255,255,0.12)',
+    inputText: '#ffffff',
+    placeholder: 'rgba(255,255,255,0.3)',
+    inputFocusBorder: '#D6F551',
+    inputErrorBorder: '#f87171',
+    // #f87171 (Tailwind red-400) is a deliberate SDK choice, tuned to read on the
+    // dark card — not the web renderer's danger red. See SurveyModal:1254.
+    errorText: '#f87171',
+    headingColor: '#ffffff',
+    textPrimary: '#ffffff',
+    textSecondary: 'rgba(255,255,255,0.8)',
+    textMuted: 'rgba(255,255,255,0.5)',
+    optionBg: 'rgba(255,255,255,0.06)',
+    optionBorder: 'rgba(255,255,255,0.12)',
+    optionSelectedBg: '#D6F5511A', // accent + 1A — matches the shipped `${primaryColor}1A`
+    optionSelectedBorder: '#D6F551',
+    indicatorBorder: 'rgba(255,255,255,0.3)',
+    indicatorChecked: '#D6F551',
+    // Audited from RatingQuestion/NPSQuestion StyleSheets — these are 0.08/0.15,
+    // deliberately NOT the palette's 0.06/0.12. In dark theme SurveyModal passes
+    // `palette={isLight ? palette : undefined}`, so the StyleSheet values are what
+    // actually render. Matching the palette here would change dark appearance.
+    ratingBg: 'rgba(255,255,255,0.08)',
+    ratingBorder: 'rgba(255,255,255,0.15)',
+    ratingText: 'rgba(255,255,255,0.8)',
+    ratingEmpty: 'rgba(255,255,255,0.3)',
+    ratingFilledBg: '#D6F551',
+    ratingFilledBorder: '#D6F551',
+    ratingFilledText: '#030712',
+    primaryBg: '#D6F551',
+    primaryText: '#030712',
+    primaryBorder: '#D6F551',
+    // Audited from SurveyModal.backButton — not 'transparent'/0.2 as first drafted.
+    secondaryBg: 'rgba(255,255,255,0.08)',
+    secondaryText: 'rgba(255,255,255,0.8)',
+    secondaryBorder: 'rgba(255,255,255,0.12)',
+    closeBg: 'rgba(255,255,255,0.1)',
+    closeText: 'rgba(255,255,255,0.6)',
+    brandNameColor: 'rgba(255,255,255,0.7)',
+    descriptionColor: 'rgba(255,255,255,0.6)',
+    progressText: 'rgba(255,255,255,0.4)',
+    progressTrack: 'rgba(255,255,255,0.08)',
+    requiredMark: '#ef4444',
+    chipBg: 'rgba(255,255,255,0.04)',
+    chipBorder: 'rgba(255,255,255,0.12)',
+    chipText: 'rgba(255,255,255,0.7)',
+    hintBg: 'rgba(255,255,255,0.04)',
+    hintBorder: 'rgba(255,255,255,0.08)',
+    hintText: 'rgba(255,255,255,0.55)',
+    topRuleColor: '#D6F551',
+};
+/** Not a naive inversion — values are re-chosen to hold contrast on a pale ground. */
+exports.LIGHT_CONTRACT = {
+    ...SHARED,
+    accent: '#65a30d',
+    accentHover: '#4d7c0f',
+    accentText: '#ffffff',
+    ground: 'rgba(0,0,0,0.4)',
+    card: '#ffffff',
+    cardBorder: 'rgba(0,0,0,0.08)',
+    input: 'rgba(0,0,0,0.03)',
+    inputBorder: 'rgba(0,0,0,0.08)',
+    inputText: '#111827',
+    placeholder: 'rgba(0,0,0,0.4)',
+    inputFocusBorder: '#65a30d',
+    inputErrorBorder: '#C22F38',
+    errorText: '#C22F38',
+    headingColor: '#0f172a',
+    textPrimary: '#111827',
+    textSecondary: 'rgba(0,0,0,0.75)',
+    textMuted: 'rgba(0,0,0,0.5)',
+    // Mirrors LIGHT's palette.input — light-theme option rows used palette.input,
+    // not white. Verified by the equivalence test.
+    optionBg: 'rgba(0,0,0,0.03)',
+    optionBorder: 'rgba(0,0,0,0.08)',
+    optionSelectedBg: '#65a30d1A', // accent + 1A
+    optionSelectedBorder: '#65a30d',
+    indicatorBorder: 'rgba(0,0,0,0.25)',
+    indicatorChecked: '#65a30d',
+    // Light theme receives the palette, so these mirror LIGHT's input/border/
+    // textSecondary rather than the dark StyleSheet values.
+    ratingBg: 'rgba(0,0,0,0.03)',
+    ratingBorder: 'rgba(0,0,0,0.08)',
+    ratingText: 'rgba(0,0,0,0.75)',
+    ratingEmpty: 'rgba(0,0,0,0.3)',
+    ratingFilledBg: '#65a30d',
+    ratingFilledBorder: '#65a30d',
+    ratingFilledText: '#ffffff',
+    primaryBg: '#65a30d',
+    primaryText: '#ffffff',
+    primaryBorder: '#65a30d',
+    secondaryBg: 'rgba(0,0,0,0.06)',
+    secondaryText: 'rgba(0,0,0,0.75)',
+    secondaryBorder: 'rgba(0,0,0,0.12)',
+    closeBg: 'rgba(0,0,0,0.06)',
+    closeText: 'rgba(0,0,0,0.6)',
+    brandNameColor: 'rgba(0,0,0,0.7)',
+    descriptionColor: 'rgba(0,0,0,0.6)',
+    progressText: 'rgba(0,0,0,0.4)',
+    progressTrack: 'rgba(0,0,0,0.08)',
+    requiredMark: '#C22F38',
+    chipBg: 'rgba(0,0,0,0.04)',
+    chipBorder: 'rgba(0,0,0,0.12)',
+    chipText: 'rgba(0,0,0,0.7)',
+    hintBg: 'rgba(0,0,0,0.04)',
+    hintBorder: 'rgba(0,0,0,0.08)',
+    hintText: 'rgba(0,0,0,0.55)',
+    topRuleColor: '#65a30d',
+};
+/* ------------------------------------------------------------------ resolve */
+/**
+ * Resolve the contract for a render.
+ *
+ * Precedence, HIGHEST first — deliberately identical to the shipped
+ * `themePalette()` so ownership rules do not change:
+ *   1. `initOverride`   — the host app, via CXPinsight.init({ brandingPalette })
+ *   2. `surveyOverride` — survey.branding.palette
+ *   3. `primaryColor`   — convenience, fans out to every accent-derived field
+ *   4. theme defaults (light | dark)
+ *
+ * The host app wins because it owns the surface the survey appears on: an app in
+ * a dark skin must be able to stop a survey rendering light inside it. This
+ * matches themePalette()'s documented layering — do not invert it.
+ *
+ * Also mirrors themePalette()'s *truthy* override test: a field present but
+ * empty/undefined falls through rather than blanking the value, which a plain
+ * object spread would not do.
+ */
+function resolveStyleContract(args) {
+    const base = args.theme === 'light' ? exports.LIGHT_CONTRACT : exports.DARK_CONTRACT;
+    // A single primaryColor should be enough for most brands, so fan it out to
+    // every field an accent legitimately drives.
+    const fromPrimary = args.primaryColor
+        ? {
+            accent: args.primaryColor,
+            accentHover: args.primaryColor,
+            primaryBg: args.primaryColor,
+            primaryBorder: args.primaryColor,
+            inputFocusBorder: args.primaryColor,
+            indicatorChecked: args.primaryColor,
+            // Shipped behaviour: the selected option tint is the accent at 1A alpha.
+            optionSelectedBg: `${args.primaryColor}1A`,
+            optionSelectedBorder: args.primaryColor,
+            ratingFilledBg: args.primaryColor,
+            ratingFilledBorder: args.primaryColor,
+            topRuleColor: args.primaryColor,
+        }
+        : {};
+    const out = { ...base, ...fromPrimary };
+    const so = args.surveyOverride || {};
+    const io = args.initOverride || {};
+    // Iterate the UNION of base keys and override keys, not just the base:
+    // optional fields (fontFamily, fontFamilyHeading) have no default, so they are
+    // absent from `base` and iterating it alone made them impossible to set.
+    const keys = new Set([
+        ...Object.keys(base),
+        ...Object.keys(so),
+        ...Object.keys(io),
+    ]);
+    // Presence, not truthiness. A truthy test silently discarded every ZERO an
+    // author set — padding 0, radius 0, a square corner — because 0 is falsy. It
+    // was invisible while the contract held only colours and non-zero sizes; per-
+    // side padding makes 0 an ordinary value, so the test has to mean what it says.
+    const isSet = (v) => v !== undefined && v !== null && v !== '';
+    keys.forEach((k) => {
+        if (isSet(io[k]))
+            out[k] = io[k];
+        else if (isSet(so[k]))
+            out[k] = so[k];
+    });
+    return out;
+}
+/** Existing callers of themePalette() keep the exact same shape. */
+function toLegacyPalette(c) {
+    return {
+        card: c.card,
+        cardBorder: c.cardBorder,
+        input: c.input,
+        inputBorder: c.inputBorder,
+        textPrimary: c.textPrimary,
+        textSecondary: c.textSecondary,
+        textMuted: c.textMuted,
+        placeholder: c.placeholder,
+        indicatorBorder: c.indicatorBorder,
+    };
+}
+/* ------------------------------------------------------------- web alignment */
+/**
+ * Which web custom property carries each contract field.
+ *
+ * `null` means the web renderer has no dedicated property yet — those are the
+ * additive gaps to fill so both platforms cover the same surface. Recording
+ * them here (rather than in prose) means a golden test can assert the two
+ * implementations haven't drifted.
+ */
+exports.CSS_VAR_MAP = {
+    accent: '--vp-color-accent',
+    accentHover: '--vp-color-accent-dark',
+    accentText: null,
+    card: null,
+    cardBorder: null,
+    input: '--vp-color-input-bg',
+    inputBorder: '--vp-color-input-border',
+    inputText: '--vp-color-text',
+    placeholder: null,
+    textPrimary: '--vp-color-text',
+    textSecondary: '--vp-color-text-muted',
+    textMuted: '--vp-color-text-faint',
+    indicatorBorder: null,
+    fontFamily: '--vp-font-family',
+    fontSizeLabel: '--vp-fs-label',
+    fontSizeInput: '--vp-fs-input',
+    fontSizeDescription: '--vp-fs-desc',
+    fontSizeSmall: '--vp-fs-error',
+    cardRadius: '--vp-radius',
+};
+/**
+ * Translate an authored palette into a contract override.
+ *
+ * One author field legitimately fans out to several contract fields: `border`
+ * covers input, option and rating outlines, because the web renderer's single
+ * `--vp-color-input-border` reaches all three.
+ *
+ * ⚠ The text tiers are OFF BY ONE between the two vocabularies:
+ *      authored `text`      → contract `textPrimary`
+ *      authored `textMuted` → contract `textSecondary`   (not `textMuted`!)
+ *      authored `textFaint` → contract `textMuted` + `placeholder`
+ * This mirrors the web token names exactly. Do not "simplify" it.
+ *
+ * Keys that are already contract field names pass through untouched, so a
+ * palette written against the SDK vocabulary still works.
+ */
+function fromAuthoredPalette(authored) {
+    if (!authored)
+        return {};
+    const a = authored;
+    const out = {};
+    const set = (k, v) => {
+        if (v)
+            out[k] = v;
+    };
+    // Surface
+    set('ground', a.bg);
+    // Text tiers — note the deliberate off-by-one against the authored names.
+    set('textPrimary', a.text);
+    set('inputText', a.text);
+    set('headingColor', a.text);
+    set('textSecondary', a.textMuted);
+    set('ratingText', a.textMuted);
+    set('textMuted', a.textFaint);
+    set('placeholder', a.textFaint);
+    // Borders — one authored field, three surfaces.
+    set('cardBorder', a.border);
+    set('inputBorder', a.border);
+    set('optionBorder', a.border);
+    set('ratingBorder', a.border);
+    // Card-ish surfaces
+    set('card', a.cardBg);
+    set('optionBg', a.cardBg);
+    // Input-ish surfaces
+    set('input', a.inputBg);
+    set('ratingBg', a.inputBg);
+    // Touch has no hover; the nearest meaningful analogue is the selected row.
+    set('optionSelectedBg', a.hoverBg);
+    // Pass through anything already named as a contract field, so a palette
+    // authored against the SDK vocabulary (or a future widened editor) still works.
+    //
+    // AUTHORED_KEYS is excluded because `textMuted` exists in BOTH vocabularies
+    // with DIFFERENT meanings: authored `textMuted` is the SECONDARY tier, while
+    // contract `textMuted` is the FAINT tier. Without this exclusion the loop
+    // clobbers the correctly-mapped value with the wrong tier.
+    const AUTHORED_KEYS = new Set([
+        'bg', 'text', 'textMuted', 'textFaint', 'border', 'cardBg', 'inputBg', 'hoverBg',
+    ]);
+    const contractKeys = Object.keys(exports.DARK_CONTRACT);
+    for (const k of contractKeys) {
+        if (AUTHORED_KEYS.has(k))
+            continue;
+        const v = a[k];
+        if (v)
+            out[k] = v;
+    }
+    return out;
+}
+//# sourceMappingURL=styleContract.js.map

package/lib/survey/styleContract.js.map

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

package/lib/survey/themePalette.d.ts

@@ -0,0 +1,56 @@
+export type ThemeName = 'light' | 'dark';
+export interface ThemePalette {
+    card: string;
+    cardBorder: string;
+    input: string;
+    inputBorder: string;
+    textPrimary: string;
+    textSecondary: string;
+    textMuted: string;
+    placeholder: string;
+    indicatorBorder: string;
+}
+/** Overrides shape accepted from either the survey's own branding or the
+ *  host app's CXPinsight.init({ brandingPalette }). Every field optional
+ *  so a caller can partial-override just what they care about. */
+export interface PaletteOverride {
+    card?: string;
+    cardBorder?: string;
+    input?: string;
+    inputBorder?: string;
+    textPrimary?: string;
+    textSecondary?: string;
+    textMuted?: string;
+    placeholder?: string;
+    indicatorBorder?: string;
+}
+/** A platform/SDK named theme. `palette` carries per-mode overrides so a named
+ *  theme resolves straight into themePalette()'s initOverride layer. */
+export interface NamedTheme {
+    name: string;
+    label?: string;
+    theme?: ThemeName;
+    primaryColor?: string;
+    palette?: {
+        light?: PaletteOverride;
+        dark?: PaletteOverride;
+    };
+}
+/** Resolve init({ theme }) against the platform's named-theme library.
+ *  Ownership (decided with the user): a platform theme of the same name
+ *  OVERRIDES an SDK-supplied inline theme; else the SDK inline theme is used;
+ *  else null (fall through to the survey/app default). `initTheme` is either a
+ *  name string or an inline NamedTheme object. Pure — safe to unit-test. */
+export declare function resolveNamedTheme(initTheme: string | NamedTheme | undefined | null, applicationThemes?: NamedTheme[] | null): NamedTheme | null;
+/** Extract the PaletteOverride for the active mode from a resolved named theme,
+ *  ready to pass as themePalette()'s initOverride. */
+export declare function namedThemePaletteOverride(resolved: NamedTheme | null, mode: ThemeName): PaletteOverride | undefined;
+/** Palette resolver with layered overrides (parity with the web widget's
+ *  themePalette). Precedence highest → lowest:
+ *    1. `initOverride`  — app passed to CXPinsight.init({ brandingPalette })
+ *    2. `surveyOverride` — survey.branding.palette on the survey definition
+ *    3. built-in DARK / LIGHT defaults
+ *  Missing fields at each layer fall through — an author can override just
+ *  `card` and leave everything else default. */
+export declare function themePalette(theme: ThemeName | undefined, surveyOverride?: PaletteOverride, initOverride?: PaletteOverride): ThemePalette;
+//# sourceMappingURL=themePalette.d.ts.map

package/lib/survey/themePalette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themePalette.d.ts","sourceRoot":"","sources":["../../src/survey/themePalette.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,YAAY;IAE3B,IAAI,EAAS,MAAM,CAAC;IACpB,UAAU,EAAG,MAAM,CAAC;IACpB,KAAK,EAAQ,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,EAAI,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAM,MAAM,CAAC;IACtB,WAAW,EAAI,MAAM,CAAC;IAEtB,eAAe,EAAE,MAAM,CAAC;CACzB;AASD;;kEAEkE;AAClE,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;wEACwE;AACxE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,eAAe,CAAC;QAAC,IAAI,CAAC,EAAE,eAAe,CAAA;KAAE,CAAC;CAC/D;AAED;;;;4EAI4E;AAC5E,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,EACjD,iBAAiB,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,GACtC,UAAU,GAAG,IAAI,CAQnB;AAED;sDACsD;AACtD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,UAAU,GAAG,IAAI,EAC3B,IAAI,EAAE,SAAS,GACd,eAAe,GAAG,SAAS,CAG7B;AAED;;;;;;gDAMgD;AAChD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,cAAc,CAAC,EAAE,eAAe,EAChC,YAAY,CAAC,EAAE,eAAe,GAC7B,YAAY,CAMd"}

package/lib/survey/themePalette.js

@@ -0,0 +1,63 @@
+"use strict";
+// Theme palette (spec §24 branding.theme). Every surface color the
+// mobile modal + question components render — bg, border, text
+// variants, input backgrounds — routed through this single helper so
+// the light-theme override lands in ONE place instead of duplicating
+// the palette lookup at every StyleSheet site.
+//
+// Design decisions:
+//   - Dark is the SDK default. When the caller omits `theme` or
+//     passes anything but 'light', the palette returns the same
+//     values the base StyleSheets already hardcode; question
+//     components use `theme?.textPrimary` with a fallback so a
+//     missing palette silently keeps LTR/dark behavior.
+//   - Light-theme values match the web renderer's design tokens
+//     (near-black on white card, subtle grey borders, low-opacity
+//     muted secondary text).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveNamedTheme = resolveNamedTheme;
+exports.namedThemePaletteOverride = namedThemePaletteOverride;
+exports.themePalette = themePalette;
+const styleContract_1 = require("./styleContract");
+// Derived, not restated. styleContract.ts is the single source of truth for
+// every value; these two exist so the shipped 9-field shape keeps working.
+// A golden test asserts these stay byte-identical to what shipped.
+const DARK = (0, styleContract_1.toLegacyPalette)(styleContract_1.DARK_CONTRACT);
+const LIGHT = (0, styleContract_1.toLegacyPalette)(styleContract_1.LIGHT_CONTRACT);
+/** Resolve init({ theme }) against the platform's named-theme library.
+ *  Ownership (decided with the user): a platform theme of the same name
+ *  OVERRIDES an SDK-supplied inline theme; else the SDK inline theme is used;
+ *  else null (fall through to the survey/app default). `initTheme` is either a
+ *  name string or an inline NamedTheme object. Pure — safe to unit-test. */
+function resolveNamedTheme(initTheme, applicationThemes) {
+    if (!initTheme)
+        return null;
+    const name = typeof initTheme === 'string' ? initTheme : initTheme.name;
+    const lib = Array.isArray(applicationThemes) ? applicationThemes : [];
+    const platformMatch = name ? lib.find((t) => t && t.name === name) : undefined;
+    if (platformMatch)
+        return platformMatch; // platform overrides SDK
+    if (typeof initTheme === 'object')
+        return initTheme; // SDK inline theme
+    return null; // name-only, no library match
+}
+/** Extract the PaletteOverride for the active mode from a resolved named theme,
+ *  ready to pass as themePalette()'s initOverride. */
+function namedThemePaletteOverride(resolved, mode) {
+    if (!resolved || !resolved.palette)
+        return undefined;
+    return resolved.palette[mode];
+}
+/** Palette resolver with layered overrides (parity with the web widget's
+ *  themePalette). Precedence highest → lowest:
+ *    1. `initOverride`  — app passed to CXPinsight.init({ brandingPalette })
+ *    2. `surveyOverride` — survey.branding.palette on the survey definition
+ *    3. built-in DARK / LIGHT defaults
+ *  Missing fields at each layer fall through — an author can override just
+ *  `card` and leave everything else default. */
+function themePalette(theme, surveyOverride, initOverride) {
+    // Delegates to the contract resolver so precedence lives in exactly one
+    // place. Behaviour is unchanged — see the golden test.
+    return (0, styleContract_1.toLegacyPalette)((0, styleContract_1.resolveStyleContract)({ theme, surveyOverride, initOverride }));
+}
+//# sourceMappingURL=themePalette.js.map

package/lib/survey/themePalette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"themePalette.js","sourceRoot":"","sources":["../../src/survey/themePalette.ts"],"names":[],"mappings":";AAAA,mEAAmE;AACnE,+DAA+D;AAC/D,qEAAqE;AACrE,qEAAqE;AACrE,+CAA+C;AAC/C,EAAE;AACF,oBAAoB;AACpB,gEAAgE;AAChE,gEAAgE;AAChE,6DAA6D;AAC7D,+DAA+D;AAC/D,wDAAwD;AACxD,gEAAgE;AAChE,kEAAkE;AAClE,6BAA6B;;;;;AAE7B,mDAEyB;AAmBzB,4EAA4E;AAC5E,2EAA2E;AAC3E,mEAAmE;AACnE,MAAM,IAAI,GAAiB,IAAA,+BAAe,EAAC,6BAAa,CAAC,CAAC;AAE1D,MAAM,KAAK,GAAiB,IAAA,+BAAe,EAAC,8BAAc,CAAC,CAAC;AA2B5D;;;;4EAI4E;AAC5E,2BACE,SAAiD,EACjD,iBAAuC;IAEvC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;IACxE,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC,CAAc,yBAAyB;IAC/E,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,CAAE,mBAAmB;IACzE,OAAO,IAAI,CAAC,CAA0C,8BAA8B;AACtF,CAAC;AAED;sDACsD;AACtD,mCACE,QAA2B,EAC3B,IAAe;IAEf,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACrD,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;gDAMgD;AAChD,sBACE,KAA4B,EAC5B,cAAgC,EAChC,YAA8B;IAE9B,wEAAwE;IACxE,uDAAuD;IACvD,OAAO,IAAA,+BAAe,EACpB,IAAA,oCAAoB,EAAC,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAC9D,CAAC;AACJ,CAAC"}

package/lib/survey/translationLookup.d.ts

@@ -0,0 +1,4 @@
+import type { SurveyDefinition } from '../types';
+export declare function surveyText(survey: SurveyDefinition, lang: string | undefined, field: 'title' | 'description' | 'thankYouMessage', fallback: string | undefined): string | undefined;
+export declare function questionText(survey: SurveyDefinition, lang: string | undefined, qId: string, field: 'text' | 'description', fallback: string | undefined): string | undefined;
+//# sourceMappingURL=translationLookup.d.ts.map

package/lib/survey/translationLookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translationLookup.d.ts","sourceRoot":"","sources":["../../src/survey/translationLookup.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAmBjD,wBAAgB,UAAU,CACxB,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,iBAAiB,EAClD,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CAKpB;AAKD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,aAAa,EAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CASpB"}

package/lib/survey/translationLookup.js

@@ -0,0 +1,62 @@
+"use strict";
+// Translation text lookup — spec §26.1 shape:
+//
+//   translations[langCode] = {
+//     title?, description?, thankYouMessage?,
+//     questions?: { [qId]: { text?, description?, ... } },
+//     sections?:  { [sId]: { title?, description? } },
+//   }
+//
+// Callers pass the survey definition, the currently-selected
+// language code, and the field path they want localized. The lookup
+// walks translations[lang] and returns the override if present,
+// otherwise the caller-supplied fallback (usually the authored text
+// on the base question/survey object).
+//
+// Defensive lookup — the translations blob is stored as
+// Record<string, unknown> at the type level, so every hop is
+// null-safe. A malformed translations key (e.g. `questions` as an
+// array instead of a map) silently falls through to the fallback,
+// matching web renderer behavior.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.surveyText = surveyText;
+exports.questionText = questionText;
+// Read `translations[lang]` cheaply and safely. Returns null when
+// there's no entry for this language OR when the entry isn't an
+// object (older servers occasionally send an empty string).
+function translationsFor(survey, lang) {
+    if (!lang)
+        return null;
+    const t = survey.translations?.[lang];
+    if (!t || typeof t !== 'object' || Array.isArray(t))
+        return null;
+    return t;
+}
+// Survey-level string lookup: title, description, thankYouMessage.
+// Falls back to `fallback` when the translations override is absent
+// or empty (empty string is treated as "no translation" per web
+// renderer — otherwise a blank `title` field silently blanks the UI).
+function surveyText(survey, lang, field, fallback) {
+    const t = translationsFor(survey, lang);
+    const v = t?.[field];
+    if (typeof v === 'string' && v.length > 0)
+        return v;
+    return fallback;
+}
+// Question-level string lookup — `text` or `description`.
+// translations[lang].questions[qId][field] takes precedence over the
+// authored field on the question object.
+function questionText(survey, lang, qId, field, fallback) {
+    const t = translationsFor(survey, lang);
+    const questions = t?.questions;
+    if (!questions || typeof questions !== 'object' || Array.isArray(questions))
+        return fallback;
+    const q = questions[qId];
+    if (!q || typeof q !== 'object' || Array.isArray(q))
+        return fallback;
+    const v = q[field];
+    if (typeof v === 'string' && v.length > 0)
+        return v;
+    return fallback;
+}
+//# sourceMappingURL=translationLookup.js.map

package/lib/survey/translationLookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translationLookup.js","sourceRoot":"","sources":["../../src/survey/translationLookup.ts"],"names":[],"mappings":";AAAA,8CAA8C;AAC9C,EAAE;AACF,+BAA+B;AAC/B,8CAA8C;AAC9C,2DAA2D;AAC3D,uDAAuD;AACvD,MAAM;AACN,EAAE;AACF,6DAA6D;AAC7D,oEAAoE;AACpE,gEAAgE;AAChE,oEAAoE;AACpE,uCAAuC;AACvC,EAAE;AACF,wDAAwD;AACxD,6DAA6D;AAC7D,kEAAkE;AAClE,kEAAkE;AAClE,kCAAkC;;;;AAIlC,kEAAkE;AAClE,gEAAgE;AAChE,4DAA4D;AAC5D,SAAS,eAAe,CACtB,MAAwB,EACxB,IAAwB;IAExB,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mEAAmE;AACnE,oEAAoE;AACpE,gEAAgE;AAChE,sEAAsE;AACtE,oBACE,MAAwB,EACxB,IAAwB,EACxB,KAAkD,EAClD,QAA4B;IAE5B,MAAM,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACpD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,0DAA0D;AAC1D,qEAAqE;AACrE,yCAAyC;AACzC,sBACE,MAAwB,EACxB,IAAwB,EACxB,GAAW,EACX,KAA6B,EAC7B,QAA4B;IAE5B,MAAM,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,CAAC,EAAE,SAAS,CAAC;IAC/B,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7F,MAAM,CAAC,GAAI,SAAqC,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IACrE,MAAM,CAAC,GAAI,CAA6B,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACpD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/lib/survey/validate.d.ts

@@ -0,0 +1,3 @@
+import type { SurveyQuestion } from '../types';
+export declare function validateAnswer(question: SurveyQuestion, value: unknown): string | null;
+//# sourceMappingURL=validate.d.ts.map

package/lib/survey/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/survey/validate.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK/C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAWtF"}