@scalebun/web 1.0.0

package/dist/features/forms/index.js

@@ -0,0 +1,405 @@
+/**
+ * Form analytics (F-FORM) — which field costs you money.
+ *
+ * Answers the CRO staple questions — completion rate, time per field, error fields, and above all
+ * *where people give up* — by watching ordinary DOM events and emitting a handful of analytics events
+ * onto the EXISTING lane. No parallel pipeline, no new backend table: `$form_*` events ride
+ * `/batch` → `events` exactly like `$submit` already does, so replay correlation, the Event Debugger
+ * and Explore work on them from day one.
+ *
+ * PRIVACY IS THE HARD RULE: **field VALUES are never read.** We record metadata only — a field KEY
+ * (name/id/type), how long it was focused, whether it changed, whether it errored. Password / hidden /
+ * card / one-time-code inputs are skipped entirely, as is any subtree under
+ * `[data-scalebun-no-capture]` (the same opt-out autocapture honours).
+ *
+ * BUNDLE: this module is a LAZY chunk, dynamically imported from the already-lazy autocapture chunk —
+ * so it costs the eager core ZERO bytes. (The 30 KB gate has ~470 B of headroom; nothing here may
+ * touch it.)
+ *
+ * VOLUME: terminal-summary model — `$form_start` plus ONE terminal event (`$submit` enriched, or
+ * `$form_abandon`) carrying a per-field summary. ~2–3 events per form, not one per field.
+ */
+import { scrubText } from '../../core';
+/** Inputs we never observe at all — not even metadata. */
+const SENSITIVE_TYPES = new Set(['password', 'hidden']);
+const SENSITIVE_AUTOCOMPLETE = /(^|\s|-)(cc-|new-password|current-password|one-time-code)/i;
+/** Non-data controls — buttons aren't fields. */
+const NON_FIELD_TYPES = new Set(['submit', 'button', 'reset', 'image']);
+const FIELD_SELECTOR = 'input, select, textarea';
+/** Bound the per-event payload and the live map — a pathological page can't blow up either. */
+const MAX_FIELDS_REPORTED = 30;
+const MAX_TRACKED_FORMS = 20;
+/** True for inputs whose mere presence in an event would be a privacy problem. Exported for tests. */
+export function isSensitiveField(el) {
+    const type = (el.getAttribute('type') || '').toLowerCase();
+    if (SENSITIVE_TYPES.has(type))
+        return true;
+    const ac = el.getAttribute('autocomplete') || '';
+    return SENSITIVE_AUTOCOMPLETE.test(ac);
+}
+/** A field we should measure: a real data control, not sensitive, not a button. Exported for tests. */
+export function isTrackableField(el) {
+    if (!el || typeof el.matches !== 'function' || !el.matches(FIELD_SELECTOR))
+        return false;
+    const type = (el.getAttribute('type') || '').toLowerCase();
+    if (NON_FIELD_TYPES.has(type))
+        return false;
+    return !isSensitiveField(el);
+}
+/**
+ * A stable, PII-safe key for a field: `name` → `id` → `type[index]`.
+ * NEVER derived from a value or placeholder — those carry user data. Exported for tests.
+ */
+export function fieldKeyOf(el, form) {
+    const name = el.getAttribute('name');
+    if (name)
+        return name;
+    if (el.id)
+        return el.id;
+    const type = (el.getAttribute('type') || el.tagName).toLowerCase();
+    let idx = -1;
+    try {
+        idx = Array.prototype.indexOf.call(form.elements, el);
+    }
+    catch {
+        /* elements unavailable */
+    }
+    return idx >= 0 ? `${type}[${idx}]` : type;
+}
+/** A label longer than this is prose, not a field name. Truncated rather than dropped. */
+const MAX_LABEL = 60;
+/**
+ * The field's VISIBLE name, for display only — never its identity.
+ *
+ * `fieldKeyOf` falls back to `type[index]` when a control has neither `name` nor `id`, which is
+ * correct as an identifier and useless to read: a dashboard row saying `tel[1]` cannot tell anyone
+ * which box on the page that is. This reads the field's accessible name instead, so the same row can
+ * say "Mobile number" while still being keyed on `tel[1]`.
+ *
+ * WHY THESE SOURCES AND NOT `placeholder`. `aria-label`, `<label>` and `aria-labelledby` are the
+ * platform's own definition of what a control is called — authored markup, the same class of data as
+ * `name` and `id`. `placeholder` is deliberately excluded here because `fieldKeyOf` already excludes
+ * it on the grounds that it can carry user data, and re-litigating that call as a side effect of a
+ * display change would be the wrong place to do it.
+ *
+ * Scrubbed and truncated regardless: a site CAN render user content into a label, and this is the one
+ * form string that reaches our servers, so it goes through the same redaction as any other free text.
+ */
+export function fieldLabelOf(el) {
+    let raw = '';
+    try {
+        raw = el.getAttribute('aria-label') || '';
+        if (!raw) {
+            const id = el.getAttribute('id');
+            const doc = el.ownerDocument;
+            if (id && doc) {
+                // CSS.escape is not universal; querySelector with a quoted attribute avoids it entirely.
+                raw = doc.querySelector(`label[for="${id}"]`)?.textContent || '';
+            }
+            if (!raw)
+                raw = el.closest?.('label')?.textContent || '';
+            if (!raw) {
+                const by = el.getAttribute('aria-labelledby');
+                // `split` always yields at least one entry, but the array index is still `string | undefined`
+                // under noUncheckedIndexedAccess — default it rather than assert.
+                if (by && doc)
+                    raw = doc.getElementById(by.split(/\s+/)[0] ?? '')?.textContent || '';
+            }
+        }
+    }
+    catch {
+        /* detached node, or a document that will not answer — no label is a fine answer */
+    }
+    const text = scrubText(raw.replace(/\s+/g, ' ').trim());
+    if (!text)
+        return undefined;
+    return text.length > MAX_LABEL ? `${text.slice(0, MAX_LABEL - 1)}…` : text;
+}
+/** djb2 — a tiny stable hash for the structural form id fallback. */
+function hash(s) {
+    let h = 5381;
+    for (let i = 0; i < s.length; i++)
+        h = ((h << 5) + h + s.charCodeAt(i)) | 0;
+    return (h >>> 0).toString(36);
+}
+/**
+ * A form's identity: `id` → `name` → a STRUCTURAL hash (tag + action path + sorted field names).
+ * The hash keeps dashboards stable for forms without an id/name, and never uses user data.
+ * Exported for tests.
+ */
+export function formIdOf(form) {
+    if (form.id)
+        return form.id;
+    const name = form.getAttribute('name');
+    if (name)
+        return name;
+    let action = '';
+    try {
+        action = (form.getAttribute('action') || '').split('?')[0] ?? '';
+    }
+    catch {
+        /* no action */
+    }
+    const names = [];
+    try {
+        for (const el of Array.from(form.elements)) {
+            const n = el.getAttribute?.('name');
+            if (n)
+                names.push(n);
+        }
+    }
+    catch {
+        /* elements unavailable */
+    }
+    return `form_${hash(`${form.tagName}|${action}|${names.sort().join(',')}`)}`;
+}
+const optedOut = (el) => !!el && typeof el.closest === 'function' && !!el.closest('[data-scalebun-no-capture]');
+/**
+ * Author-declared multi-step marker: `data-scalebun-step` on the form (or an ancestor). Read LIVE per
+ * event so a wizard that mutates the attribute as the user advances yields step-level drop-off — you
+ * see *which step* people give up on, not just the form. Author-provided ⇒ non-PII by construction.
+ * Exported for tests.
+ */
+export function stepOf(form) {
+    try {
+        const v = form.closest?.('[data-scalebun-step]')?.getAttribute('data-scalebun-step');
+        return v ? v : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Validation-heatmap anchor for an errored field: its viewport-space box + opt-in component name, in
+ * the SAME shape the journey tracker (H7) stamps on clicks — `{ ex, ey, ew, eh, component }`. That
+ * lets a validation heatmap re-project error markers onto the real-DOM backdrop with the existing
+ * anchoring machinery, no new plumbing. Integers only — never text or values. `undefined` when the
+ * field is detached/zero-sized so we don't emit a meaningless (0,0,0,0). Exported for tests.
+ */
+export function anchorOf(el) {
+    try {
+        const r = el.getBoundingClientRect?.();
+        if (!r || (r.width === 0 && r.height === 0))
+            return undefined;
+        const out = { ex: r.x | 0, ey: r.y | 0, ew: r.width | 0, eh: r.height | 0 };
+        const comp = el.closest?.('[data-scalebun-component]')?.getAttribute('data-scalebun-component');
+        if (comp)
+            out.component = comp;
+        return out;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** First failing constraint → a coarse, non-PII error type. */
+function errorTypeOf(el) {
+    const v = el.validity;
+    if (!v)
+        return 'invalid';
+    if (v.valueMissing)
+        return 'required';
+    if (v.typeMismatch)
+        return 'type';
+    if (v.patternMismatch)
+        return 'pattern';
+    if (v.tooShort)
+        return 'too_short';
+    if (v.tooLong)
+        return 'too_long';
+    if (v.rangeUnderflow || v.rangeOverflow || v.stepMismatch)
+        return 'range';
+    if (v.badInput)
+        return 'bad_input';
+    if (v.customError)
+        return 'custom';
+    return 'invalid';
+}
+const now = () => (typeof performance !== 'undefined' ? performance.now() : Date.now());
+export function installFormAnalytics(h) {
+    if (typeof document === 'undefined')
+        return { onSubmit: () => ({}), stop: () => { } };
+    let enabled = true;
+    // A Map (not a WeakMap) because abandonment must ITERATE the still-open forms on pagehide. Entries
+    // are deleted the moment a form terminates and the map is capped, so it stays tiny (a page has ~1
+    // form the user actually touches).
+    const forms = new Map();
+    const stateOf = (form) => {
+        let st = forms.get(form);
+        if (st)
+            return st;
+        if (forms.size >= MAX_TRACKED_FORMS)
+            return null;
+        st = { startedAt: now(), lastField: null, order: 0, fields: new Map() };
+        forms.set(form, st);
+        // First interaction with this form — the funnel's entry point.
+        h.onEvent({
+            name: '$form_start',
+            props: { form_id: formIdOf(form), form_name: form.getAttribute('name') || undefined, field_count: fieldCount(form), step: stepOf(form) },
+        });
+        return st;
+    };
+    const fieldCount = (form) => {
+        try {
+            return form.elements ? form.elements.length : 0;
+        }
+        catch {
+            return 0;
+        }
+    };
+    /** Per-field summary for a terminal event. Capped; metadata only. */
+    const summarize = (st) => Array.from(st.fields.entries())
+        .slice(0, MAX_FIELDS_REPORTED)
+        .map(([key, f]) => ({
+        key,
+        ms: Math.round(f.ms),
+        changed: f.changed,
+        errored: f.errored,
+        order: f.order,
+        // Omitted rather than null when there is no accessible name: absent means "unlabelled", which
+        // the dashboard renders differently from a label that happens to be empty.
+        ...(f.label ? { label: f.label } : {}),
+    }));
+    const fieldOf = (e) => {
+        if (!enabled)
+            return null;
+        const el = e.target;
+        if (!isTrackableField(el))
+            return null;
+        const form = el.form;
+        if (!form || optedOut(form) || optedOut(el))
+            return null;
+        const st = stateOf(form);
+        if (!st)
+            return null;
+        return { form, el, key: fieldKeyOf(el, form), st };
+    };
+    const onFocusIn = (e) => {
+        const ctx = fieldOf(e);
+        if (!ctx)
+            return;
+        const { st, key } = ctx;
+        let f = st.fields.get(key);
+        if (!f) {
+            // The label is read ONCE, here, because this is the only point in the pipeline where the
+            // element is still in hand — everything downstream works from the key alone.
+            f = {
+                ms: 0,
+                changed: false,
+                errored: false,
+                order: st.order++,
+                focusedAt: null,
+                label: fieldLabelOf(ctx.el),
+            };
+            st.fields.set(key, f);
+        }
+        f.focusedAt = now();
+        st.lastField = key; // where they were when they left — the drop-off field
+    };
+    const onFocusOut = (e) => {
+        const ctx = fieldOf(e);
+        if (!ctx)
+            return;
+        const f = ctx.st.fields.get(ctx.key);
+        if (!f || f.focusedAt == null)
+            return;
+        f.ms += now() - f.focusedAt;
+        f.focusedAt = null;
+    };
+    // First change only — no per-keystroke work, and we never read the value.
+    const onInput = (e) => {
+        const ctx = fieldOf(e);
+        if (!ctx)
+            return;
+        const f = ctx.st.fields.get(ctx.key);
+        if (f && !f.changed)
+            f.changed = true;
+    };
+    const onInvalid = (e) => {
+        const ctx = fieldOf(e);
+        if (!ctx)
+            return;
+        const f = ctx.st.fields.get(ctx.key);
+        if (f)
+            f.errored = true;
+        h.onEvent({
+            name: '$form_error',
+            props: {
+                form_id: formIdOf(ctx.form),
+                field_key: ctx.key,
+                error_type: errorTypeOf(ctx.el),
+                step: stepOf(ctx.form),
+                // Anchor for a validation heatmap — reuses the H7 element-anchoring shape (§11 of the plan).
+                ...(anchorOf(ctx.el) ?? {}),
+            },
+        });
+    };
+    /** The money event: a form the user started and never submitted, plus WHERE they stopped. */
+    const abandon = (form, st) => {
+        // close an open focus so the last field's time isn't lost
+        for (const f of st.fields.values()) {
+            if (f.focusedAt != null) {
+                f.ms += now() - f.focusedAt;
+                f.focusedAt = null;
+            }
+        }
+        h.onEvent({
+            name: '$form_abandon',
+            props: {
+                form_id: formIdOf(form),
+                last_field: st.lastField ?? undefined,
+                time_ms: Math.round(now() - st.startedAt),
+                fields_touched: st.fields.size,
+                field_stats: summarize(st),
+                step: stepOf(form), // which step they were on when they left — step-level drop-off
+            },
+        });
+    };
+    const flushAbandons = () => {
+        if (!enabled || !forms.size)
+            return;
+        for (const [form, st] of forms)
+            abandon(form, st);
+        forms.clear(); // emit once per page — pagehide and visibilitychange must not double-fire
+    };
+    const onVisibility = () => {
+        if (document.visibilityState === 'hidden')
+            flushAbandons();
+    };
+    document.addEventListener('focusin', onFocusIn, true);
+    document.addEventListener('focusout', onFocusOut, true);
+    document.addEventListener('input', onInput, true);
+    document.addEventListener('invalid', onInvalid, true); // `invalid` doesn't bubble — capture is required
+    document.addEventListener('visibilitychange', onVisibility);
+    window.addEventListener('pagehide', flushAbandons);
+    return {
+        onSubmit(form) {
+            const st = forms.get(form);
+            if (!st)
+                return {}; // submitted without ever focusing a field (autofill/programmatic)
+            forms.delete(form); // completed → must never be reported as abandoned
+            for (const f of st.fields.values()) {
+                if (f.focusedAt != null) {
+                    f.ms += now() - f.focusedAt;
+                    f.focusedAt = null;
+                }
+            }
+            return {
+                duration_ms: Math.round(now() - st.startedAt),
+                fields_touched: st.fields.size,
+                field_stats: summarize(st),
+                step: stepOf(form),
+            };
+        },
+        stop() {
+            enabled = false;
+            document.removeEventListener('focusin', onFocusIn, true);
+            document.removeEventListener('focusout', onFocusOut, true);
+            document.removeEventListener('input', onInput, true);
+            document.removeEventListener('invalid', onInvalid, true);
+            document.removeEventListener('visibilitychange', onVisibility);
+            window.removeEventListener('pagehide', flushAbandons);
+            forms.clear();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/features/forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/forms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAUvC,0DAA0D;AAC1D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxD,MAAM,sBAAsB,GAAG,4DAA4D,CAAC;AAC5F,iDAAiD;AACjD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AACxE,MAAM,cAAc,GAAG,yBAAyB,CAAC;AACjD,+FAA+F;AAC/F,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,sGAAsG;AACtG,MAAM,UAAU,gBAAgB,CAAC,EAAW;IAC1C,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IACjD,OAAO,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,gBAAgB,CAAC,EAAkB;IACjD,IAAI,CAAC,EAAE,IAAI,OAAQ,EAAc,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC;QAAE,OAAO,KAAK,CAAC;IACtG,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,EAAW,EAAE,IAAqB;IAC3D,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,EAAE,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IACnE,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,0FAA0F;AAC1F,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,EAAW;IACtC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC;YAC7B,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;gBACd,yFAAyF;gBACzF,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,WAAW,IAAI,EAAE,CAAC;YACnE,CAAC;YACD,IAAI,CAAC,GAAG;gBAAE,GAAG,GAAI,EAAkB,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,IAAI,EAAE,CAAC;YAC1E,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;gBAC9C,8FAA8F;gBAC9F,kEAAkE;gBAClE,IAAI,EAAE,IAAI,GAAG;oBAAE,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,WAAW,IAAI,EAAE,CAAC;YACvF,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mFAAmF;IACrF,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7E,CAAC;AAED,qEAAqE;AACrE,SAAS,IAAI,CAAC,CAAS;IACrB,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5E,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAqB;IAC5C,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IACD,OAAO,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,EAAkB,EAAW,EAAE,CAC/C,CAAC,CAAC,EAAE,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,IAAqB;IAC1C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,sBAAsB,CAAC,EAAE,YAAY,CAAC,oBAAoB,CAAC,CAAC;QACrF,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAW;IAClC,IAAI,CAAC;QACH,MAAM,CAAC,GAAI,EAAkB,CAAC,qBAAqB,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9D,MAAM,GAAG,GAAoC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7G,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,2BAA2B,CAAC,EAAE,YAAY,CAAC,yBAAyB,CAAC,CAAC;QAChG,IAAI,IAAI;YAAE,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC;QAC/B,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,SAAS,WAAW,CAAC,EAAW;IAC9B,MAAM,CAAC,GAAI,EAAuB,CAAC,QAAQ,CAAC;IAC5C,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,IAAI,CAAC,CAAC,YAAY;QAAE,OAAO,UAAU,CAAC;IACtC,IAAI,CAAC,CAAC,YAAY;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,CAAC,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,WAAW,CAAC;IACnC,IAAI,CAAC,CAAC,OAAO;QAAE,OAAO,UAAU,CAAC;IACjC,IAAI,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,YAAY;QAAE,OAAO,OAAO,CAAC;IAC1E,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,WAAW,CAAC;IACnC,IAAI,CAAC,CAAC,WAAW;QAAE,OAAO,QAAQ,CAAC;IACnC,OAAO,SAAS,CAAC;AACnB,CAAC;AAkBD,MAAM,GAAG,GAAG,GAAW,EAAE,CAAC,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AAQhG,MAAM,UAAU,oBAAoB,CAAC,CAAe;IAClD,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IACrF,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,mGAAmG;IACnG,kGAAkG;IAClG,mCAAmC;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEpD,MAAM,OAAO,GAAG,CAAC,IAAqB,EAAoB,EAAE;QAC1D,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,EAAE;YAAE,OAAO,EAAE,CAAC;QAClB,IAAI,KAAK,CAAC,IAAI,IAAI,iBAAiB;YAAE,OAAO,IAAI,CAAC;QACjD,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;QACxE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpB,+DAA+D;QAC/D,CAAC,CAAC,OAAO,CAAC;YACR,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE;SACzI,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,IAAqB,EAAU,EAAE;QACnD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC,CAAC;IAEF,qEAAqE;IACrE,MAAM,SAAS,GAAG,CAAC,EAAa,EAAkC,EAAE,CAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;SAC5B,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClB,GAAG;QACH,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,8FAA8F;QAC9F,2EAA2E;QAC3E,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvC,CAAC,CAAC,CAAC;IAER,MAAM,OAAO,GAAG,CAAC,CAAQ,EAAiF,EAAE;QAC1G,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,MAAM,EAAE,GAAG,CAAC,CAAC,MAA4B,CAAC;QAC1C,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,IAAI,GAAI,EAAuB,CAAC,IAAI,CAAC;QAC3C,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QACzD,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC;IACrD,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,CAAQ,EAAQ,EAAE;QACnC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;QACxB,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,yFAAyF;YACzF,6EAA6E;YAC7E,CAAC,GAAG;gBACF,EAAE,EAAE,CAAC;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE;gBACjB,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;aAC5B,CAAC;YACF,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACxB,CAAC;QACD,CAAC,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;QACpB,EAAE,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,sDAAsD;IAC5E,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,CAAQ,EAAQ,EAAE;QACpC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI;YAAE,OAAO;QACtC,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC;QAC5B,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC;IACrB,CAAC,CAAC;IAEF,0EAA0E;IAC1E,MAAM,OAAO,GAAG,CAAC,CAAQ,EAAQ,EAAE;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC;IACxC,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,CAAQ,EAAQ,EAAE;QACnC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC;YAAE,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC;QACxB,CAAC,CAAC,OAAO,CAAC;YACR,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE;gBACL,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;gBAC3B,SAAS,EAAE,GAAG,CAAC,GAAG;gBAClB,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/B,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;gBACtB,6FAA6F;gBAC7F,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;aAC5B;SACF,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,6FAA6F;IAC7F,MAAM,OAAO,GAAG,CAAC,IAAqB,EAAE,EAAa,EAAQ,EAAE;QAC7D,0DAA0D;QAC1D,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;gBACxB,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC;gBAC5B,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;QACD,CAAC,CAAC,OAAO,CAAC;YACR,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE;gBACL,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC;gBACvB,UAAU,EAAE,EAAE,CAAC,SAAS,IAAI,SAAS;gBACrC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC;gBACzC,cAAc,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI;gBAC9B,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC;gBAC1B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,+DAA+D;aACpF;SACF,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,GAAS,EAAE;QAC/B,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,OAAO;QACpC,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK;YAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClD,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,0EAA0E;IAC3F,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,GAAS,EAAE;QAC9B,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ;YAAE,aAAa,EAAE,CAAC;IAC7D,CAAC,CAAC;IAEF,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACtD,QAAQ,CAAC,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClD,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,iDAAiD;IACxG,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;IAC5D,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAEnD,OAAO;QACL,QAAQ,CAAC,IAAqB;YAC5B,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,EAAE;gBAAE,OAAO,EAAE,CAAC,CAAC,kEAAkE;YACtF,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,kDAAkD;YACtE,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;gBACnC,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;oBACxB,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC;oBAC5B,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,OAAO;gBACL,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC;gBAC7C,cAAc,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI;gBAC9B,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC;gBAC1B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;aACnB,CAAC;QACJ,CAAC;QACD,IAAI;YACF,OAAO,GAAG,KAAK,CAAC;YAChB,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YACzD,QAAQ,CAAC,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;YAC3D,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACrD,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YACzD,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;YAC/D,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YACtD,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/features/inapp/InApp2Feature.d.ts

@@ -0,0 +1,24 @@
+/**
+ * IAM 2.0 feature — the ignition wrapper that runs the in-app engine (`core/engine.ts`). Ultra-thin
+ * eager shell (mirrors ExitIntentFeature): feature-detect, then lazy-load the engine so it costs no
+ * eager-core bytes.
+ *
+ * Opt-in (`features.inapp2 ?? false`) and defaults to **'native'** engine mode — it renders only
+ * schema-driven native variants (a NEW authoring path), which are DISJOINT from the legacy in-app
+ * campaigns the `engage` feature renders. So the two coexist with no double-delivery and no
+ * cross-feature coupling. Flip to 'compat'/'legacy' explicitly via `config.inApp.engine`.
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+export declare class InApp2Feature implements IFeature {
+    readonly name = "inapp2";
+    private active;
+    private engine?;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): Promise<void>;
+    /** Facade seam: fire a named custom event trigger (e.g. after a feature is used). No-op if inactive. */
+    fireEvent(name: string): void;
+    /** Facade seam: identity changed — re-read config so segment-targeted variants can now serve. */
+    onIdentify(): void;
+    teardown(): void;
+}
+//# sourceMappingURL=InApp2Feature.d.ts.map

package/dist/features/inapp/InApp2Feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InApp2Feature.d.ts","sourceRoot":"","sources":["../../../src/features/inapp/InApp2Feature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGxE,qBAAa,aAAc,YAAW,QAAQ;IAC5C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAC,CAAc;IAE7B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAEK,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB/C,wGAAwG;IACxG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7B,iGAAiG;IACjG,UAAU,IAAI,IAAI;IAIlB,QAAQ,IAAI,IAAI;CAKjB"}

package/dist/features/inapp/InApp2Feature.js

@@ -0,0 +1,43 @@
+export class InApp2Feature {
+    constructor() {
+        this.name = 'inapp2';
+        this.active = false;
+    }
+    get isActive() {
+        return this.active;
+    }
+    async setup(ctx) {
+        if (typeof window === 'undefined' || typeof document === 'undefined')
+            return;
+        if (!ctx.clientKey || !ctx.apiBaseUrl)
+            return;
+        this.active = true;
+        const { InAppEngine } = await import('./core/engine');
+        if (!this.active)
+            return; // torn down while the chunk loaded
+        this.engine = new InAppEngine({
+            apiBaseUrl: ctx.apiBaseUrl,
+            clientKey: ctx.clientKey,
+            deviceId: ctx.deviceId,
+            appVersion: ctx.appVersion,
+            userId: () => ctx.getUserId?.(),
+            route: () => (typeof location !== 'undefined' ? location.pathname + location.search : ''),
+            config: { engine: 'native' }, // disjoint from engage's legacy delivery — no double-render
+        });
+        void this.engine.start();
+    }
+    /** Facade seam: fire a named custom event trigger (e.g. after a feature is used). No-op if inactive. */
+    fireEvent(name) {
+        this.engine?.fireEvent(name);
+    }
+    /** Facade seam: identity changed — re-read config so segment-targeted variants can now serve. */
+    onIdentify() {
+        void this.engine?.onIdentify();
+    }
+    teardown() {
+        this.active = false;
+        this.engine?.stop();
+        this.engine = undefined;
+    }
+}
+//# sourceMappingURL=InApp2Feature.js.map

package/dist/features/inapp/InApp2Feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InApp2Feature.js","sourceRoot":"","sources":["../../../src/features/inapp/InApp2Feature.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,aAAa;IAA1B;QACW,SAAI,GAAG,QAAQ,CAAC;QACjB,WAAM,GAAG,KAAK,CAAC;IAwCzB,CAAC;IArCC,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAmB;QAC7B,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAO;QAC7E,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,UAAU;YAAE,OAAO;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,mCAAmC;QAC7D,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC;YAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE;YAC/B,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,4DAA4D;SAC3F,CAAC,CAAC;QACH,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,wGAAwG;IACxG,SAAS,CAAC,IAAY;QACpB,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,iGAAiG;IACjG,UAAU;QACR,KAAK,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;CACF"}

package/dist/features/inapp/a11y/focus.d.ts

@@ -0,0 +1,24 @@
+/**
+ * IAM 2.0 a11y core — focus management (spec §7.6, P1.3).
+ *
+ * Shadow-DOM-aware focus trapping, background `inert`-ing, and focus restore — the WCAG 2.2 AA
+ * backbone for modal/takeover/palette surfaces. Because surfaces live inside a shadow root, the
+ * "active element" must be read from the root node, not `document` (which only ever reports the host).
+ */
+export declare function getFocusable(root: ParentNode): HTMLElement[];
+/**
+ * Trap Tab focus inside `container` (wrapping at both ends). Manual next/prev computation makes it
+ * robust across Shadow DOM boundaries where the browser's native tab order can escape the root.
+ * Returns a disposer.
+ */
+export declare function trapFocus(container: HTMLElement, doc?: Document): () => void;
+/** Move initial focus into the container (first focusable, else the container itself). */
+export declare function focusInitial(container: HTMLElement): void;
+/**
+ * Make everything except `exclude` inert + aria-hidden (so AT and Tab skip the background app while a
+ * modal is open). Restores prior attribute state on dispose.
+ */
+export declare function inertBackground(exclude: HTMLElement, doc?: Document): () => void;
+/** Capture the currently-focused element so focus can be restored when a surface closes. */
+export declare function captureFocus(doc?: Document): () => void;
+//# sourceMappingURL=focus.d.ts.map

package/dist/features/inapp/a11y/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/a11y/focus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,CAE5D;AAOD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,GAAE,QAAmB,GAAG,MAAM,IAAI,CAkBtF;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAOzD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,GAAE,QAAmB,GAAG,MAAM,IAAI,CAiB1F;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,GAAG,GAAE,QAAmB,GAAG,MAAM,IAAI,CASjE"}

package/dist/features/inapp/a11y/focus.js

@@ -0,0 +1,112 @@
+/**
+ * IAM 2.0 a11y core — focus management (spec §7.6, P1.3).
+ *
+ * Shadow-DOM-aware focus trapping, background `inert`-ing, and focus restore — the WCAG 2.2 AA
+ * backbone for modal/takeover/palette surfaces. Because surfaces live inside a shadow root, the
+ * "active element" must be read from the root node, not `document` (which only ever reports the host).
+ */
+const FOCUSABLE = [
+    'a[href]',
+    'button:not([disabled])',
+    'input:not([disabled])',
+    'select:not([disabled])',
+    'textarea:not([disabled])',
+    '[tabindex]:not([tabindex="-1"])',
+].join(',');
+function isVisible(el) {
+    // Layout-independent (works in jsdom and avoids forcing reflow): visible unless explicitly hidden.
+    if (el.hasAttribute('hidden') || el.getAttribute('aria-hidden') === 'true')
+        return false;
+    if (el.closest('[inert]'))
+        return false;
+    if (typeof getComputedStyle !== 'undefined') {
+        const cs = getComputedStyle(el);
+        if (cs.display === 'none' || cs.visibility === 'hidden')
+            return false;
+    }
+    return true;
+}
+export function getFocusable(root) {
+    return Array.from(root.querySelectorAll(FOCUSABLE)).filter(isVisible);
+}
+function activeIn(container) {
+    const rootNode = container.getRootNode();
+    return rootNode.activeElement ?? null;
+}
+/**
+ * Trap Tab focus inside `container` (wrapping at both ends). Manual next/prev computation makes it
+ * robust across Shadow DOM boundaries where the browser's native tab order can escape the root.
+ * Returns a disposer.
+ */
+export function trapFocus(container, doc = document) {
+    const onKey = (e) => {
+        if (e.key !== 'Tab')
+            return;
+        const f = getFocusable(container);
+        if (f.length === 0) {
+            e.preventDefault();
+            container.focus();
+            return;
+        }
+        const current = activeIn(container);
+        let idx = current ? f.indexOf(current) : -1;
+        e.preventDefault();
+        if (e.shiftKey)
+            idx = idx <= 0 ? f.length - 1 : idx - 1;
+        else
+            idx = idx === -1 || idx >= f.length - 1 ? 0 : idx + 1;
+        f[idx].focus();
+    };
+    container.addEventListener('keydown', onKey);
+    return () => container.removeEventListener('keydown', onKey);
+}
+/** Move initial focus into the container (first focusable, else the container itself). */
+export function focusInitial(container) {
+    const f = getFocusable(container);
+    if (f.length)
+        f[0].focus();
+    else {
+        container.setAttribute('tabindex', '-1');
+        container.focus();
+    }
+}
+/**
+ * Make everything except `exclude` inert + aria-hidden (so AT and Tab skip the background app while a
+ * modal is open). Restores prior attribute state on dispose.
+ */
+export function inertBackground(exclude, doc = document) {
+    const body = doc.body;
+    if (!body)
+        return () => { };
+    const changed = [];
+    for (const child of Array.from(body.children)) {
+        if (child === exclude || child.contains(exclude))
+            continue;
+        changed.push({ el: child, hadInert: child.hasAttribute('inert'), ariaWas: child.getAttribute('aria-hidden') });
+        child.setAttribute('inert', '');
+        child.setAttribute('aria-hidden', 'true');
+    }
+    return () => {
+        for (const { el, hadInert, ariaWas } of changed) {
+            if (!hadInert)
+                el.removeAttribute('inert');
+            if (ariaWas == null)
+                el.removeAttribute('aria-hidden');
+            else
+                el.setAttribute('aria-hidden', ariaWas);
+        }
+    };
+}
+/** Capture the currently-focused element so focus can be restored when a surface closes. */
+export function captureFocus(doc = document) {
+    const prev = doc.activeElement;
+    return () => {
+        try {
+            prev?.focus?.();
+        }
+        catch {
+            /* element gone — nothing to restore */
+        }
+    };
+}
+//# sourceMappingURL=focus.js.map

package/dist/features/inapp/a11y/focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.js","sourceRoot":"","sources":["../../../../src/features/inapp/a11y/focus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,SAAS,GAAG;IAChB,SAAS;IACT,wBAAwB;IACxB,uBAAuB;IACvB,wBAAwB;IACxB,0BAA0B;IAC1B,iCAAiC;CAClC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,SAAS,SAAS,CAAC,EAAe;IAChC,mGAAmG;IACnG,IAAI,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACzF,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,OAAO,gBAAgB,KAAK,WAAW,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,EAAE,CAAC,OAAO,KAAK,MAAM,IAAI,EAAE,CAAC,UAAU,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;IACxE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAc,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,QAAQ,CAAC,SAAsB;IACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,EAAqC,CAAC;IAC5E,OAAO,QAAQ,CAAC,aAAa,IAAI,IAAI,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,SAAsB,EAAE,MAAgB,QAAQ;IACxE,MAAM,KAAK,GAAG,CAAC,CAAgB,EAAE,EAAE;QACjC,IAAI,CAAC,CAAC,GAAG,KAAK,KAAK;YAAE,OAAO;QAC5B,MAAM,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnB,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAuB,CAAC;QAC1D,IAAI,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,IAAI,CAAC,CAAC,QAAQ;YAAE,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;;YACnD,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QAC3D,CAAC,CAAC,GAAG,CAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC,CAAC;IACF,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC7C,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,SAAsB;IACjD,MAAM,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,MAAM;QAAE,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,EAAE,CAAC;SACvB,CAAC;QACJ,SAAS,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACzC,SAAS,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAoB,EAAE,MAAgB,QAAQ;IAC5E,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAsE,EAAE,CAAC;IACtF,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QAC3D,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC/G,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,OAAO,EAAE,CAAC;YAChD,IAAI,CAAC,QAAQ;gBAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,OAAO,IAAI,IAAI;gBAAE,EAAE,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;;gBAClD,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,YAAY,CAAC,MAAgB,QAAQ;IACnD,MAAM,IAAI,GAAG,GAAG,CAAC,aAAmC,CAAC;IACrD,OAAO,GAAG,EAAE;QACV,IAAI,CAAC;YACH,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}