@cxpinsight/react-native 0.2.0

package/lib/survey/validate.js

@@ -0,0 +1,159 @@
+"use strict";
+// Answer validation — spec §8 + type-specific rules. Kept in lockstep
+// with apps/frontend/src/components/survey/renderer/lib/validate.ts,
+// with two mobile simplifications:
+//
+//   - Mobile question components emit primitive values, not the
+//     compound {text,attachments} / {choice,otherText} shapes that
+//     the web renderer uses for allowAttachments + "Other". Whenever
+//     the value shape simplifies, the mobile helper's per-type path
+//     shrinks too.
+//   - inputType regexes stay identical so a text field flagged as
+//     invalid on web reads as invalid on mobile and vice versa.
+//
+// Order per spec §8: required → type-specific format → rules[] array.
+// Empty non-required answers are valid — a blank optional email
+// shouldn't complain about missing '@'.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAnswer = validateAnswer;
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const URL_RE = /^https?:\/\/[\w.\-]+(?:\.[\w.\-]+)+(?:[/?#][^\s]*)?$/i;
+function validateAnswer(question, value) {
+    const empty = isEmpty(value);
+    if ((question.required || question.isRequired) && empty) {
+        return 'This question requires an answer';
+    }
+    if (empty)
+        return null; // optional + blank → OK
+    const typeErr = validateByType(question, value);
+    if (typeErr)
+        return typeErr;
+    return validateRules(question, value);
+}
+function isEmpty(v) {
+    if (v === undefined || v === null)
+        return true;
+    if (typeof v === 'string')
+        return v.trim().length === 0;
+    if (Array.isArray(v))
+        return v.length === 0;
+    if (typeof v === 'number')
+        return Number.isNaN(v);
+    return false; // 0, false, non-empty obj → not empty
+}
+function validateByType(question, value) {
+    switch (question.type) {
+        case 'text':
+        case 'comment':
+        case 'email':
+        case 'number':
+            return validateTextish(question, value);
+        case 'checkbox':
+            return validateCheckbox(question, value);
+        case 'rating':
+        case 'csat':
+        case 'ces':
+        case 'nps':
+            return validateNumericRange(question, value);
+        default:
+            return null;
+    }
+}
+function validateTextish(question, value) {
+    const trimmed = String(value ?? '').trim();
+    const inputType = question.inputType || (question.type === 'email' ? 'email' : question.type === 'number' ? 'number' : undefined);
+    if (inputType === 'email' && !EMAIL_RE.test(trimmed)) {
+        return 'Please enter a valid email address (e.g., you@example.com)';
+    }
+    if (inputType === 'url' && !URL_RE.test(trimmed)) {
+        return 'Please enter a full URL, including https://';
+    }
+    if (inputType === 'number' && Number.isNaN(Number(trimmed))) {
+        return 'Please enter a number';
+    }
+    if (inputType === 'tel' && !/^[\d\s+\-()]{3,}$/.test(trimmed)) {
+        return 'Please enter a valid phone number';
+    }
+    const maxLength = typeof question.maxLength === 'number' ? question.maxLength : undefined;
+    if (maxLength !== undefined && trimmed.length > maxLength) {
+        return `Please keep this under ${maxLength} characters`;
+    }
+    return null;
+}
+function validateCheckbox(question, value) {
+    const arr = Array.isArray(value) ? value : [];
+    const count = arr.length;
+    const minCount = typeof question.minCount === 'number' ? question.minCount : undefined;
+    const maxCount = typeof question.maxCount === 'number' ? question.maxCount : undefined;
+    if (minCount !== undefined && count < minCount)
+        return `Please select at least ${minCount}`;
+    if (maxCount !== undefined && count > maxCount)
+        return `Please select at most ${maxCount}`;
+    return null;
+}
+function validateNumericRange(question, value) {
+    if (typeof value !== 'number')
+        return null;
+    const min = typeof question.minValue === 'number' ? question.minValue : undefined;
+    const max = typeof question.maxValue === 'number' ? question.maxValue : undefined;
+    if (min !== undefined && value < min)
+        return `Must be at least ${min}`;
+    if (max !== undefined && value > max)
+        return `Must be at most ${max}`;
+    return null;
+}
+function validateRules(question, value) {
+    const rules = Array.isArray(question.rules)
+        ? question.rules
+        : [];
+    if (rules.length === 0)
+        return null;
+    const str = typeof value === 'string' ? value : String(value ?? '');
+    for (const r of rules) {
+        const err = applyRule(r, str);
+        if (err)
+            return r.message || err;
+    }
+    return null;
+}
+function applyRule(rule, str) {
+    switch (rule.type) {
+        case 'minLength':
+            if (typeof rule.value === 'number' && str.length < rule.value)
+                return `At least ${rule.value} characters`;
+            return null;
+        case 'maxLength':
+            if (typeof rule.value === 'number' && str.length > rule.value)
+                return `At most ${rule.value} characters`;
+            return null;
+        case 'min':
+            if (typeof rule.value === 'number' && Number(str) < rule.value)
+                return `Must be at least ${rule.value}`;
+            return null;
+        case 'max':
+            if (typeof rule.value === 'number' && Number(str) > rule.value)
+                return `Must be at most ${rule.value}`;
+            return null;
+        case 'email':
+            if (!EMAIL_RE.test(str))
+                return 'Please enter a valid email address';
+            return null;
+        case 'url':
+            if (!URL_RE.test(str))
+                return 'Please enter a valid URL';
+            return null;
+        case 'pattern': {
+            if (typeof rule.value !== 'string')
+                return null;
+            try {
+                const re = new RegExp(rule.value);
+                return re.test(str) ? null : 'Format doesn\'t match';
+            }
+            catch {
+                return null;
+            }
+        }
+        default: return null;
+    }
+}
+//# sourceMappingURL=validate.js.map

package/lib/survey/validate.js.map

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

package/lib/survey/variablesResolver.d.ts

@@ -0,0 +1,10 @@
+import type { SurveyVariable } from '../types';
+export interface VariableSources {
+    sdkIdentifyData?: Record<string, unknown> | null;
+    linkTrackingData?: Record<string, unknown>;
+}
+export declare function resolveVariables(variables: SurveyVariable[] | undefined, sources: VariableSources, answers: Record<string, unknown>, contextDefaults?: Record<string, unknown>): Record<string, unknown>;
+declare const ATTR_NAMESPACES: readonly ['event', 'device', 'user', 'session', 'geo', 'location'];
+export declare function buildAttributeContext(signals: Partial<Record<(typeof ATTR_NAMESPACES)[number], Record<string, unknown>>> | undefined): Record<string, unknown>;
+export {};
+//# sourceMappingURL=variablesResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"variablesResolver.d.ts","sourceRoot":"","sources":["../../src/survey/variablesResolver.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,cAAc,EAAE,GAAG,SAAS,EACvC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAIhC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BzB;AAQD,QAAA,MAAM,eAAe,YAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,CAAU,CAAC;AAC3F,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GAC9F,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/lib/survey/variablesResolver.js

@@ -0,0 +1,107 @@
+"use strict";
+// Mobile variables resolver — spec §22.2, mobile-flavored.
+//
+// Web renderer sources variables from URL params, SDK identify(),
+// personalized-link tracking, static, and calculated. Mobile doesn't
+// have a URL bar, so `url` / `query` sources fall back to the same
+// pool as `sdk` — the identify() blob is the only user-supplied data
+// path on mobile. Static and calculated are unchanged.
+//
+// Merged pool priority (later overrides earlier):
+//   1. SDK identify (via sources.sdkIdentifyData)
+//   2. Personalized-link tracking data
+//   3. Static (design-time literal in variable.defaultValue)
+//   4. Calculated (evaluates last, may reference all others + answers)
+//
+// Unresolved refs fall back to defaultValue; if still absent, they
+// interpolate to empty string (per spec §22.2, done in
+// interpolate.ts). NEVER emit the literal `{{name}}` — that reads
+// as broken to the respondent.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveVariables = resolveVariables;
+exports.buildAttributeContext = buildAttributeContext;
+const expressionEval_1 = require("./expressionEval");
+function resolveVariables(variables, sources, answers, 
+// P4 — Attribute Context floor. The SDK's captured signals ({{user.plan}},
+// {{device.os}}, …) auto-seed as default variables; anything a survey author
+// declares below (static/link/calculated) overrides on name collision.
+contextDefaults) {
+    const out = { ...(contextDefaults || {}) };
+    if (!variables || variables.length === 0)
+        return out;
+    // First pass: non-calculated variables. Priority per spec §22.2.
+    for (const v of variables) {
+        if (v.source === 'calculated')
+            continue;
+        const val = resolveNonCalculated(v, sources);
+        if (val !== undefined)
+            out[v.name] = val;
+        else if (v.defaultValue !== undefined)
+            out[v.name] = v.defaultValue;
+    }
+    // Second pass: calculated. Runs against the already-populated pool
+    // + the current answers map. evaluateExpression reads both.
+    for (const v of variables) {
+        if (v.source !== 'calculated')
+            continue;
+        if (!v.expression)
+            continue;
+        try {
+            const val = (0, expressionEval_1.evaluateExpression)(v.expression, { variables: out, answers });
+            if (val !== undefined && val !== null)
+                out[v.name] = val;
+            else if (v.defaultValue !== undefined)
+                out[v.name] = v.defaultValue;
+        }
+        catch {
+            // Broken expression shouldn't crash the survey. Fall back to
+            // defaultValue if any, otherwise leave unset — empty-string
+            // fallback happens at interpolation time.
+            if (v.defaultValue !== undefined)
+                out[v.name] = v.defaultValue;
+        }
+    }
+    return out;
+}
+// Lockstep TS port of shared/models/settingsSchema.js `buildAttributeContext`
+// (the SDK is a standalone package and can't import shared/). Flattens the SDK's
+// known signal groups into the namespaced { 'ns.key': value } bag used to
+// auto-seed variables here and, later, to evaluate on-device targeting
+// conditions. Scalars only — objects/arrays are dropped so the bag stays flat
+// and matchable. Keep in sync with the shared JS version.
+const ATTR_NAMESPACES = ['event', 'device', 'user', 'session', 'geo', 'location'];
+function buildAttributeContext(signals) {
+    const out = {};
+    if (!signals)
+        return out;
+    for (const ns of ATTR_NAMESPACES) {
+        const group = signals[ns];
+        if (!group || typeof group !== 'object' || Array.isArray(group))
+            continue;
+        for (const k of Object.keys(group)) {
+            const val = group[k];
+            if (val == null || typeof val === 'object')
+                continue;
+            out[`${ns}.${k}`] = val;
+        }
+    }
+    return out;
+}
+function resolveNonCalculated(v, sources) {
+    switch (v.source) {
+        // No URL bar on mobile — fall URL-family sources through to SDK
+        // identity data so the same variable can be sourced by both web
+        // (URL param) and mobile (identify() blob) authors.
+        case 'url':
+        case 'query':
+        case 'sdk':
+            return sources.sdkIdentifyData?.[v.name];
+        case 'link':
+            return sources.linkTrackingData?.[v.name];
+        case 'static':
+            return v.defaultValue;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=variablesResolver.js.map

package/lib/survey/variablesResolver.js.map

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

package/lib/survey/voiceParsers.d.ts

@@ -0,0 +1,47 @@
+export type VoiceSupport = 'full' | 'matrix' | 'read' | 'partial';
+interface VQuestion {
+    type?: string;
+    title?: string;
+    text?: string;
+    label?: string;
+    options?: unknown;
+    choices?: unknown;
+    yesLabel?: string;
+    noLabel?: string;
+    minValue?: number;
+    maxValue?: number;
+    minLabel?: string;
+    maxLabel?: string;
+    rows?: unknown;
+    columns?: unknown;
+}
+export declare function parseAnswer(q: VQuestion, transcript: string): {
+    value: unknown;
+    parsed: boolean;
+};
+export declare function voiceSupport(type: string): VoiceSupport;
+export declare function voiceCanHandle(type: string): boolean;
+interface AuditQ {
+    type?: string;
+    isRequired?: boolean;
+    required?: boolean;
+}
+export declare function auditVoiceQuestions(questions: AuditQ[]): {
+    blocking: AuditQ[];
+    skippable: AuditQ[];
+};
+export declare function voiceDisclaimer(n: number, lang?: string): string;
+export declare function skipNoteText(lang?: string): string;
+export declare function scaffoldFor(lang: string): {
+    scale: (min: number, max: number, minL?: string, maxL?: string) => string;
+    binary: (y: string, n: string) => string;
+    options: (o: string[]) => string;
+    multi: (o: string[]) => string;
+    ranking: (o: string[]) => string;
+    date: () => string;
+    matrixStem: (stem: string) => string;
+    matrixRow: (row: string, cols: string[]) => string;
+};
+export declare function buildPromptText(q: VQuestion, lang: string): string;
+export {};
+//# sourceMappingURL=voiceParsers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voiceParsers.d.ts","sourceRoot":"","sources":["../../src/survey/voiceParsers.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAGlE,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnC;AAiHD,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAajG;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAYvD;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAA6C;AAElG,UAAU,MAAM;IAAG,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE;AAE5E,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAQpG;AACD,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhE;AACD,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlD;AAkCD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM;WA9B/B,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM;YACjE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM;aAC/B,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,MAAM;WACzB,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,MAAM;aACrB,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,MAAM;UAC1B,MAAM,MAAM;gBACN,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;eACzB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM;EAuB6E;AAIjI,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAYlE"}

package/lib/survey/voiceParsers.js

@@ -0,0 +1,310 @@
+"use strict";
+// Voice answer parsers + prompt scaffolds for the mobile hands-free session.
+//
+// Pure logic ported from the web SDK's voice.js / the React handsFreeVoice.tsx
+// so all three surfaces (web SDK, link renderer, mobile) parse spoken answers
+// identically. No native dependencies here — only string → value mapping.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAnswer = parseAnswer;
+exports.voiceSupport = voiceSupport;
+exports.voiceCanHandle = voiceCanHandle;
+exports.auditVoiceQuestions = auditVoiceQuestions;
+exports.voiceDisclaimer = voiceDisclaimer;
+exports.skipNoteText = skipNoteText;
+exports.scaffoldFor = scaffoldFor;
+exports.buildPromptText = buildPromptText;
+function normalize(s) {
+    try {
+        return String(s).toLowerCase().replace(/[^\p{L}\p{N}\s]/gu, ' ').replace(/\s+/g, ' ').trim();
+    }
+    catch {
+        return String(s).toLowerCase().replace(/[^a-z0-9\s]/gi, ' ').replace(/\s+/g, ' ').trim();
+    }
+}
+const YES_WORDS = ['yes', 'yeah', 'yep', 'sure', 'ok', 'okay', 'true', 'correct', 'right', 'affirmative', 'نعم', 'أجل', 'صحيح', 'أيوه', 'sí', 'si', 'oui', 'ja', 'sì'];
+const NO_WORDS = ['no', 'nope', 'nah', 'false', 'incorrect', 'negative', 'لا', 'كلا', 'non', 'nein'];
+// Explicit ordinals first (first/second/third) so "the second one" → index 1,
+// not the cardinal "one" (index 0) that also appears in the phrase. Whole-token.
+const ORDINAL_LIST = [
+    ['first', 0], ['second', 1], ['third', 2], ['fourth', 3], ['fifth', 4],
+    ['one', 0], ['two', 1], ['three', 2], ['four', 3], ['five', 4],
+    ['1', 0], ['2', 1], ['3', 2], ['4', 3], ['5', 4],
+];
+function ordinalIndex(tokens, count) {
+    for (const [word, idx] of ORDINAL_LIST)
+        if (tokens.indexOf(word) !== -1 && idx < count)
+            return idx;
+    return -1;
+}
+const NUMWORDS = {
+    zero: 0, one: 1, two: 2, three: 3, four: 4, five: 5, six: 6, seven: 7, eight: 8, nine: 9, ten: 10,
+    first: 1, second: 2, third: 3, fourth: 4, fifth: 5, sixth: 6, seventh: 7, eighth: 8, ninth: 9, tenth: 10,
+    'صفر': 0, 'واحد': 1, 'واحدة': 1, 'اثنان': 2, 'اثنين': 2, 'اتنين': 2, 'ثلاثة': 3, 'ثلاث': 3, 'أربعة': 4, 'اربعة': 4,
+    'خمسة': 5, 'خمس': 5, 'ستة': 6, 'سبعة': 7, 'سبع': 7, 'ثمانية': 8, 'ثماني': 8, 'تسعة': 9, 'عشرة': 10, 'عشر': 10,
+};
+function optLabel(o) { return String((o && (o.label != null ? o.label : (o.text != null ? o.text : (o.value != null ? o.value : o.alt)))) || ''); }
+function optVal(o) { return (o && o.value != null) ? o.value : optLabel(o); }
+function getOptions(q) { return Array.isArray(q.options) ? q.options : (Array.isArray(q.choices) ? q.choices : []); }
+function parseBinary(q, t) {
+    const tokens = normalize(t).split(' ').filter(Boolean);
+    const yes = typeof q.yesLabel === 'string' ? normalize(q.yesLabel) : '';
+    const no = typeof q.noLabel === 'string' ? normalize(q.noLabel) : '';
+    for (const tok of tokens) {
+        if (YES_WORDS.indexOf(tok) !== -1)
+            return true;
+        if (NO_WORDS.indexOf(tok) !== -1)
+            return false;
+        if (yes && tok === yes)
+            return true;
+        if (no && tok === no)
+            return false;
+    }
+    const norm = normalize(t);
+    if (yes && norm.indexOf(yes) !== -1)
+        return true;
+    if (no && norm.indexOf(no) !== -1)
+        return false;
+    return null;
+}
+function parseChoice(q, t) {
+    const options = getOptions(q);
+    if (!options.length)
+        return null;
+    const norm = normalize(t);
+    let best = null;
+    for (const o of options) {
+        const nl = normalize(optLabel(o));
+        if (nl && norm.indexOf(nl) !== -1 && (!best || nl.length > best.length))
+            best = { value: optVal(o), length: nl.length };
+    }
+    if (!best) {
+        const oi = ordinalIndex(norm.split(' ').filter(Boolean), options.length);
+        if (oi >= 0)
+            best = { value: optVal(options[oi]), length: 0 };
+    }
+    return best ? best.value : null;
+}
+function parseCheckbox(q, t) {
+    const options = getOptions(q);
+    if (!options.length)
+        return null;
+    const norm = normalize(t);
+    const picked = [];
+    for (const o of options) {
+        const nl = normalize(optLabel(o));
+        if (nl && norm.indexOf(nl) !== -1) {
+            const v = String(optVal(o));
+            if (picked.indexOf(v) === -1)
+                picked.push(v);
+        }
+    }
+    const toks = norm.split(' ').filter(Boolean);
+    for (const [word, idx] of ORDINAL_LIST)
+        if (toks.indexOf(word) !== -1 && idx < options.length) {
+            const v = String(optVal(options[idx]));
+            if (picked.indexOf(v) === -1)
+                picked.push(v);
+        }
+    return picked.length ? picked : null;
+}
+function parseRanking(q, t) {
+    const options = getOptions(q);
+    if (!options.length)
+        return null;
+    const norm = normalize(t);
+    const pos = [];
+    for (const o of options) {
+        const nl = normalize(optLabel(o));
+        if (!nl)
+            continue;
+        const p = norm.indexOf(nl);
+        if (p >= 0)
+            pos.push({ value: optVal(o), pos: p });
+    }
+    if (pos.length < 2)
+        return null;
+    pos.sort((a, b) => a.pos - b.pos);
+    return pos.map((x) => x.value);
+}
+function parseNumberInRange(t, min, max) {
+    const ascii = String(t).replace(/[٠-٩]/g, (d) => String('٠١٢٣٤٥٦٧٨٩'.indexOf(d))).replace(/[۰-۹]/g, (d) => String('۰۱۲۳۴۵۶۷۸۹'.indexOf(d)));
+    const norm = normalize(ascii);
+    const digits = norm.match(/\d+(?:\.\d+)?/g);
+    if (digits)
+        for (const m of digits) {
+            const n = Math.round(Number(m));
+            if (n >= min && n <= max)
+                return n;
+        }
+    const tokens = norm.split(/\s+/).filter(Boolean);
+    for (const tok of tokens) {
+        const w = NUMWORDS[tok];
+        if (w !== undefined && w >= min && w <= max)
+            return w;
+    }
+    return null;
+}
+function parseDate(t) {
+    const raw = String(t).trim();
+    const cleaned = raw.replace(/\b(the|of|on|at)\b/gi, ' ').replace(/(\d+)(st|nd|rd|th)\b/gi, '$1').replace(/\s+/g, ' ').trim();
+    const attempts = [raw, cleaned, raw.replace(/(\d+)(st|nd|rd|th)\b/gi, '$1')];
+    for (const c of attempts) {
+        if (!c)
+            continue;
+        const d = new Date(c);
+        if (!isNaN(d.getTime())) {
+            const m = String(d.getMonth() + 1).padStart(2, '0');
+            const day = String(d.getDate()).padStart(2, '0');
+            return `${d.getFullYear()}-${m}-${day}`;
+        }
+    }
+    return null;
+}
+function parseAnswer(q, transcript) {
+    const type = String(q.type || '').toLowerCase();
+    const trimmed = String(transcript || '').trim();
+    if (!trimmed)
+        return { value: undefined, parsed: false };
+    if (['binary', 'boolean', 'yesno', 'yes_no'].indexOf(type) !== -1) {
+        const b = parseBinary(q, trimmed);
+        return b !== null ? { value: b, parsed: true } : { value: undefined, parsed: false };
+    }
+    if (['radio', 'radiogroup', 'dropdown', 'select', 'imagepicker'].indexOf(type) !== -1) {
+        const c = parseChoice(q, trimmed);
+        return c != null ? { value: c, parsed: true } : { value: undefined, parsed: false };
+    }
+    if (type === 'rating') {
+        const r = parseNumberInRange(trimmed, typeof q.minValue === 'number' ? q.minValue : 1, typeof q.maxValue === 'number' ? q.maxValue : 5);
+        return r !== null ? { value: r, parsed: true } : { value: undefined, parsed: false };
+    }
+    if (type === 'nps') {
+        const n = parseNumberInRange(trimmed, 0, 10);
+        return n !== null ? { value: n, parsed: true } : { value: undefined, parsed: false };
+    }
+    if (type === 'checkbox') {
+        const ck = parseCheckbox(q, trimmed);
+        return ck ? { value: ck, parsed: true } : { value: undefined, parsed: false };
+    }
+    if (type === 'ranking') {
+        const rk = parseRanking(q, trimmed);
+        return rk ? { value: rk, parsed: true } : { value: undefined, parsed: false };
+    }
+    if (type === 'date') {
+        const dt = parseDate(trimmed);
+        return dt ? { value: dt, parsed: true } : { value: undefined, parsed: false };
+    }
+    if (['text', 'textbox', 'shorttext', 'comment', 'textarea', 'longtext'].indexOf(type) !== -1)
+        return { value: trimmed, parsed: true };
+    return { value: undefined, parsed: false };
+}
+function voiceSupport(type) {
+    switch (String(type || '').toLowerCase()) {
+        case 'text':
+        case 'textbox':
+        case 'shorttext':
+        case 'comment':
+        case 'textarea':
+        case 'longtext':
+        case 'binary':
+        case 'boolean':
+        case 'yesno':
+        case 'yes_no':
+        case 'radio':
+        case 'radiogroup':
+        case 'dropdown':
+        case 'select':
+        case 'rating':
+        case 'nps':
+        case 'checkbox':
+        case 'imagepicker':
+        case 'ranking':
+        case 'date':
+            return 'full';
+        case 'matrix': return 'matrix';
+        case 'content':
+        case 'html':
+        case 'image':
+        case 'expression':
+        case 'pagebreak': return 'read';
+        default: return 'partial';
+    }
+}
+// Can voice-only fully handle this question? ('partial' can't.)
+function voiceCanHandle(type) { return voiceSupport(type) !== 'partial'; }
+// blocking = required + unsupported (voice must not start); skippable = optional + unsupported.
+function auditVoiceQuestions(questions) {
+    const blocking = [], skippable = [];
+    (questions || []).forEach((q) => {
+        if (!q || String(q.type || '').toLowerCase() === 'pagebreak')
+            return;
+        if (voiceCanHandle(String(q.type || '')))
+            return;
+        if (q.isRequired || q.required)
+            blocking.push(q);
+        else
+            skippable.push(q);
+    });
+    return { blocking, skippable };
+}
+function voiceDisclaimer(n, lang) {
+    if (String(lang || '').split('-')[0] === 'ar')
+        return 'ملاحظة: ' + n + (n > 1 ? ' أسئلة' : ' سؤال') + ' لا يمكن الإجابة عليها صوتياً وسيتم تخطيها.';
+    return 'Heads up — ' + n + ' question' + (n > 1 ? 's' : '') + " can't be answered by voice and will be skipped.";
+}
+function skipNoteText(lang) {
+    if (String(lang || '').split('-')[0] === 'ar')
+        return 'هذا السؤال يحتاج إدخالاً يدوياً — سيتم تخطيه.';
+    return 'This one needs manual input — skipping it.';
+}
+// ── Prompt scaffolds (en / ar) ──────────────────────────────────────
+const SCAFFOLDS = {
+    en: {
+        scale: (min, max, minL, maxL) => { const r = `Answer with a number from ${min} to ${max}`; return (minL && maxL) ? `${r}. ${min} means ${minL}, ${max} means ${maxL}.` : `${r}.`; },
+        binary: (y, n) => `Please answer ${y || 'yes'} or ${n || 'no'}.`,
+        options: (o) => `Options are: ${o.join(', ')}.`,
+        multi: (o) => `Multiple choices allowed. Options are: ${o.join(', ')}. Say the ones that apply.`,
+        ranking: (o) => `Rank in order of preference: ${o.join(', ')}.`,
+        date: () => `Please say the date.`,
+        matrixStem: (stem) => `${stem}. I’ll ask you row by row.`,
+        matrixRow: (row, cols) => `${row}. Options: ${cols.join(', ')}.`,
+    },
+    ar: {
+        scale: (min, max, minL, maxL) => { const r = `أجب برقم من ${min} إلى ${max}`; return (minL && maxL) ? `${r}. ${min} يعني ${minL}، ${max} يعني ${maxL}.` : `${r}.`; },
+        binary: (y, n) => `يرجى الإجابة ${y || 'نعم'} أو ${n || 'لا'}.`,
+        options: (o) => `الخيارات: ${o.join('، ')}.`,
+        multi: (o) => `يمكن اختيار أكثر من إجابة. الخيارات: ${o.join('، ')}. قل الخيارات التي تنطبق.`,
+        ranking: (o) => `رتب حسب الأفضلية: ${o.join('، ')}.`,
+        date: () => `يرجى قول التاريخ.`,
+        matrixStem: (stem) => `${stem}. سأسألك عن كل صف على حدة.`,
+        matrixRow: (row, cols) => `${row}. الخيارات: ${cols.join('، ')}.`,
+    },
+};
+function scaffoldFor(lang) { return SCAFFOLDS[String(lang || 'en').split('-')[0].toLowerCase()] || SCAFFOLDS.en; }
+function optionLabels(q) { return getOptions(q).map(optLabel).filter(Boolean); }
+function buildPromptText(q, lang) {
+    const s = scaffoldFor(lang);
+    const base = String(q.title || q.text || q.label || '').replace(/<[^>]*>/g, '').trim();
+    const type = String(q.type || '').toLowerCase();
+    if (['binary', 'boolean', 'yesno', 'yes_no'].indexOf(type) !== -1)
+        return `${base}. ${s.binary(typeof q.yesLabel === 'string' ? q.yesLabel : '', typeof q.noLabel === 'string' ? q.noLabel : '')}`;
+    if (type === 'rating')
+        return `${base}. ${s.scale(typeof q.minValue === 'number' ? q.minValue : 1, typeof q.maxValue === 'number' ? q.maxValue : 5, typeof q.minLabel === 'string' ? q.minLabel : undefined, typeof q.maxLabel === 'string' ? q.maxLabel : undefined)}`;
+    if (type === 'nps')
+        return `${base}. ${s.scale(0, 10, typeof q.minLabel === 'string' ? q.minLabel : 'Not at all likely', typeof q.maxLabel === 'string' ? q.maxLabel : 'Extremely likely')}`;
+    if (['radio', 'radiogroup', 'dropdown', 'select', 'imagepicker'].indexOf(type) !== -1) {
+        const o = optionLabels(q);
+        return o.length ? `${base}. ${s.options(o)}` : base;
+    }
+    if (type === 'checkbox') {
+        const o = optionLabels(q);
+        return o.length ? `${base}. ${s.multi(o)}` : base;
+    }
+    if (type === 'ranking') {
+        const o = optionLabels(q);
+        return o.length ? `${base}. ${s.ranking(o)}` : base;
+    }
+    if (type === 'date')
+        return `${base}. ${s.date()}`;
+    return base;
+}
+//# sourceMappingURL=voiceParsers.js.map