@scalebun/web 1.0.0

package/dist/features/inapp/core/host.js

@@ -0,0 +1,239 @@
+/**
+ * IAM 2.0 Shadow-DOM host (spec §7.5, P0.2).
+ *
+ * ONE shadow root hosts the entire overlay layer. `all: initial` at the boundary means host-page CSS
+ * can't leak in and our styles can't leak out. Theming rides on CSS custom properties applied to the
+ * shadow root; a single shared stylesheet is adopted once (Constructable Stylesheets) rather than
+ * re-injected per message — smaller, CSP-friendlier, no FOUC. Falls back to a `<style>` element where
+ * `adoptedStyleSheets` is unavailable.
+ *
+ * The host exposes named mount points per zone (§8.1). Surfaces mount into these; the host itself is
+ * headless — it knows nothing about variants or surfaces.
+ */
+import { applyNonce } from '../../../core';
+const HOST_ID = 'scalebun-inapp-host';
+/**
+ * The base reset + theme tokens. Kept tiny; surface-specific CSS ships with each lazy surface chunk.
+ *
+ * NOTE ON `pointer-events` — the full-bleed zones (`.zone-modal` / `.zone-takeover` / `.zone-palette`,
+ * all `inset: 0`) are deliberately `none`, and each surface ROOT opts itself back in
+ * (`.scalebun-backdrop`, `.scalebun-takeover`, `.scalebun-palette-backdrop` in the surface CSS;
+ * `.scalebun-coachmark` et al. for `.zone-anchored`). This is load-bearing, not tidiness:
+ *
+ *   Zones are created on first use and CACHED for the host's lifetime — nothing removes a zone when
+ *   its surface unmounts, only `destroy()` clears them. A surface teardown removes only its own root.
+ *   So a full-viewport zone left at `pointer-events: auto` keeps swallowing every click on the host
+ *   page after its surface is gone: at `z-index: 2147483600` the page still renders and scrolls, but
+ *   no button, link or route responds. Reported first against a gamified spin-wheel campaign
+ *   (dismiss the wheel → the whole app goes dead). Regression-tested in
+ *   `__tests__/zone-pointer-events.test.ts`.
+ *
+ * The narrower zones (banner/toast/side/launcher) stay `auto` — they collapse to zero size when empty,
+ * so they cannot intercept anything, and their surface roots do NOT set `pointer-events`.
+ *
+ * Comments live out here rather than inside the template literal: everything in the string is shipped
+ * to every page load.
+ */
+const BASE_CSS = `
+:host{ all: initial; }
+.layer{
+  position: fixed; inset: 0; z-index: 2147483600;
+  pointer-events: none;            /* the layer is transparent to clicks; surfaces opt back in */
+  font-family: var(--scalebun-font, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif);
+  color: var(--scalebun-fg);
+}
+.layer > *{ pointer-events: auto; }
+.zone{ position: absolute; }
+.zone-top-banner{ top: 0; left: 0; right: 0; }
+.zone-bottom-banner{ bottom: 0; left: 0; right: 0; }
+.zone-toast{ bottom: 16px; right: 16px; display: flex; flex-direction: column; gap: 8px; align-items: flex-end; }
+.zone-side-right{ top: 0; right: 0; bottom: 0; }
+.zone-side-left{ top: 0; left: 0; bottom: 0; }
+.zone-launcher{ bottom: 16px; right: 16px; }
+/* full-bleed zones: click-transparent by design — see the BASE_CSS docblock */
+.zone-modal, .zone-takeover, .zone-palette{ inset: 0; display: flex; align-items: center; justify-content: center; pointer-events: none; }
+.zone-anchored{ inset: 0; pointer-events: none; }
+.zone-center{ top: 0; right: 0; }
+@media (prefers-reduced-motion: reduce){ .layer *{ animation: none !important; transition: none !important; } }
+`;
+/** Theme tokens for light/dark. Applied as CSS vars on the shadow root :host. */
+const THEME_VARS = {
+    light: {
+        '--scalebun-bg': '#ffffff',
+        '--scalebun-fg': '#111827',
+        '--scalebun-muted': '#6b7280',
+        '--scalebun-border': '#e5e7eb',
+        '--scalebun-accent': '#4f46e5',
+        '--scalebun-accent-fg': '#ffffff',
+        '--scalebun-shadow': '0 10px 40px rgba(0,0,0,.15)',
+        '--scalebun-radius': '12px',
+    },
+    dark: {
+        '--scalebun-bg': '#1f2430',
+        '--scalebun-fg': '#f3f4f6',
+        '--scalebun-muted': '#9aa3b2',
+        '--scalebun-border': '#333b4a',
+        '--scalebun-accent': '#7c83ff',
+        '--scalebun-accent-fg': '#0b0d12',
+        '--scalebun-shadow': '0 10px 40px rgba(0,0,0,.5)',
+        '--scalebun-radius': '12px',
+    },
+};
+/** Resolve 'auto' against the OS preference. */
+export function resolveScheme(mode) {
+    if (mode === 'light' || mode === 'dark')
+        return mode;
+    try {
+        return typeof matchMedia !== 'undefined' && matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+    }
+    catch {
+        return 'light';
+    }
+}
+/** Apply the IAM theme tokens as CSS vars on any element (Shadow host, or an inline nested host). */
+export function applyThemeVars(el, mode) {
+    const vars = THEME_VARS[resolveScheme(mode)];
+    for (const [k, v] of Object.entries(vars))
+        el.style.setProperty(k, v);
+}
+export class ShadowHost {
+    constructor() {
+        this.zones = new Map();
+        this.mode = 'auto';
+        /** Adopt an extra stylesheet once, keyed by id (blocks/surfaces register their CSS on first use).
+         *  Idempotent — a second call with the same id is a no-op. */
+        this.adoptedIds = new Set();
+    }
+    /** Idempotent: mounts the host + layer + base stylesheet. Safe to call repeatedly. */
+    ensure() {
+        if (this.host || typeof document === 'undefined')
+            return;
+        const host = document.createElement('div');
+        host.id = HOST_ID;
+        host.setAttribute('data-scalebun', 'inapp');
+        // The host box itself is inert layout-wise; the fixed `.layer` inside does the positioning.
+        // Host isolation reset. Kept as an inline style deliberately: `all: initial` at the shadow BOUNDARY
+        // is a strong isolation + zero-CLS guarantee (verified in hardening.test.ts) that a class rule can't
+        // match in jsdom, and moving it to a class would weaken specificity vs the host page. This is the one
+        // documented CSP residual — a strict `style-src` without 'unsafe-inline' should allow this single
+        // inline declaration (or accept the host inheriting page styles). See docs/WEB-SDK-CSP.md.
+        host.style.cssText = 'all: initial; position: static;';
+        this.host = host;
+        const root = host.attachShadow({ mode: 'open' });
+        this.root = root;
+        // Shared stylesheet (adopted once) with graceful degrade to a <style> element.
+        if (typeof CSSStyleSheet !== 'undefined' && 'adoptedStyleSheets' in root) {
+            try {
+                const sheet = new CSSStyleSheet();
+                sheet.replaceSync(BASE_CSS);
+                root.adoptedStyleSheets = [sheet];
+                this.sheet = sheet;
+            }
+            catch {
+                this.injectStyleTag(root);
+            }
+        }
+        else {
+            this.injectStyleTag(root);
+        }
+        const layer = document.createElement('div');
+        layer.className = 'layer';
+        layer.setAttribute('role', 'presentation');
+        root.appendChild(layer);
+        this.layer = layer;
+        document.body.appendChild(host);
+        this.applyTheme();
+        // React to OS theme flips while in 'auto'.
+        if (typeof matchMedia !== 'undefined') {
+            this.mql = matchMedia('(prefers-color-scheme: dark)');
+            this.onScheme = () => {
+                if (this.mode === 'auto')
+                    this.applyTheme();
+            };
+            this.mql.addEventListener?.('change', this.onScheme);
+        }
+    }
+    injectStyleTag(root) {
+        const style = applyNonce(document.createElement('style'));
+        style.textContent = BASE_CSS;
+        root.appendChild(style);
+    }
+    addStyles(id, css) {
+        this.ensure();
+        if (this.adoptedIds.has(id) || !this.root)
+            return;
+        this.adoptedIds.add(id);
+        const root = this.root;
+        if (typeof CSSStyleSheet !== 'undefined' && 'adoptedStyleSheets' in root) {
+            try {
+                const sheet = new CSSStyleSheet();
+                sheet.replaceSync(css);
+                const cur = root.adoptedStyleSheets;
+                root.adoptedStyleSheets = [...cur, sheet];
+                return;
+            }
+            catch {
+                /* fall through to <style> */
+            }
+        }
+        const style = applyNonce(document.createElement('style'));
+        style.setAttribute('data-scalebun-styles', id);
+        style.textContent = css;
+        root.appendChild(style);
+    }
+    /** Set explicit theme; 'auto' follows prefers-color-scheme. Ensures the host exists first. */
+    setTheme(mode) {
+        this.mode = mode;
+        this.ensure();
+        this.applyTheme();
+    }
+    applyTheme() {
+        if (!this.host)
+            return;
+        applyThemeVars(this.host, this.mode);
+    }
+    /**
+     * The host element, for callers that need to layer their OWN CSS vars over the theme defaults.
+     *
+     * Engage campaigns carry author-chosen brand colours on a different token vocabulary (the frozen
+     * mobile contract), so `richInApp` maps them onto `--scalebun-*` here. Returns undefined before
+     * `ensure()`. ⚠️ `setTheme` re-runs `applyThemeVars` and would overwrite any override — set the
+     * mode first, then layer.
+     */
+    element() {
+        return this.host;
+    }
+    /** Get (creating on first use) the mount container for a zone key (§8.1). */
+    zone(zoneKey) {
+        this.ensure();
+        let el = this.zones.get(zoneKey);
+        if (el)
+            return el;
+        el = document.createElement('div');
+        // zone-<key> class; the dynamic `inline:<slot>` family shares the base zone styling.
+        const base = zoneKey.startsWith('inline:') ? 'inline' : zoneKey;
+        el.className = `zone zone-${base}`;
+        el.setAttribute('data-zone', zoneKey);
+        this.layer?.appendChild(el);
+        this.zones.set(zoneKey, el);
+        return el;
+    }
+    /** Remove everything and detach. Safe to call multiple times. */
+    destroy() {
+        if (this.mql && this.onScheme)
+            this.mql.removeEventListener?.('change', this.onScheme);
+        this.onScheme = undefined;
+        this.mql = undefined;
+        this.zones.clear();
+        this.host?.remove();
+        this.host = undefined;
+        this.root = undefined;
+        this.layer = undefined;
+        this.sheet = undefined;
+    }
+    /** Test/debug access to the shadow root. */
+    get shadowRoot() {
+        return this.root;
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/features/inapp/core/host.js.map

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

package/dist/features/inapp/core/keyboard.d.ts

@@ -0,0 +1,27 @@
+/**
+ * IAM 2.0 chord manager (spec §P3.4). Registers global keyboard shortcuts (⌘K / Ctrl+K, etc.) with
+ * **no host conflicts**: by default a chord does NOT fire while the user is typing in an input /
+ * textarea / contenteditable (unless registered `global`). `mod` matches ⌘ on macOS and Ctrl
+ * elsewhere. Pure DOM, injectable target for testing.
+ */
+export interface Chord {
+    mod: boolean;
+    shift: boolean;
+    alt: boolean;
+    key: string;
+}
+export declare function parseCombo(combo: string): Chord;
+export declare function isEditableTarget(el: EventTarget | null): boolean;
+export declare function matchesChord(e: KeyboardEvent, c: Chord): boolean;
+export declare class ChordManager {
+    private bindings;
+    private onKey?;
+    private target;
+    /** Register a combo (e.g. 'mod+k'). `global:true` fires even while typing. Returns an unregister fn. */
+    register(combo: string, handler: (e: KeyboardEvent) => void, opts?: {
+        global?: boolean;
+    }): () => void;
+    start(target?: Window | Document): void;
+    stop(): void;
+}
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/features/inapp/core/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/core/keyboard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAU/C;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAKhE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,GAAG,OAAO,CAGhE;AAQD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAC,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAAkC;IAEhD,wGAAwG;IACxG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,MAAM,IAAI;IAQzG,KAAK,CAAC,MAAM,GAAE,MAAM,GAAG,QAAwE,GAAG,IAAI;IAmBtG,IAAI,IAAI,IAAI;CAKb"}

package/dist/features/inapp/core/keyboard.js

@@ -0,0 +1,69 @@
+export function parseCombo(combo) {
+    const c = { mod: false, shift: false, alt: false, key: '' };
+    for (const raw of combo.toLowerCase().split('+')) {
+        const p = raw.trim();
+        if (p === 'mod' || p === 'cmd' || p === 'ctrl' || p === 'meta' || p === 'control' || p === 'command')
+            c.mod = true;
+        else if (p === 'shift')
+            c.shift = true;
+        else if (p === 'alt' || p === 'option' || p === 'opt')
+            c.alt = true;
+        else if (p)
+            c.key = p;
+    }
+    return c;
+}
+export function isEditableTarget(el) {
+    const node = el;
+    if (!node || typeof node.tagName !== 'string')
+        return false;
+    const tag = node.tagName;
+    return tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT' || node.isContentEditable === true;
+}
+export function matchesChord(e, c) {
+    const mod = e.metaKey || e.ctrlKey;
+    return mod === c.mod && e.shiftKey === c.shift && e.altKey === c.alt && e.key.toLowerCase() === c.key;
+}
+export class ChordManager {
+    constructor() {
+        this.bindings = [];
+        this.target = null;
+    }
+    /** Register a combo (e.g. 'mod+k'). `global:true` fires even while typing. Returns an unregister fn. */
+    register(combo, handler, opts = {}) {
+        const b = { chord: parseCombo(combo), handler, global: !!opts.global };
+        this.bindings.push(b);
+        return () => {
+            this.bindings = this.bindings.filter((x) => x !== b);
+        };
+    }
+    start(target = typeof window !== 'undefined' ? window : undefined) {
+        if (this.onKey || !target)
+            return;
+        this.target = target;
+        this.onKey = (e) => {
+            const editable = isEditableTarget(e.target);
+            for (const b of this.bindings) {
+                if (!matchesChord(e, b.chord))
+                    continue;
+                if (editable && !b.global)
+                    continue; // don't hijack typing
+                e.preventDefault();
+                try {
+                    b.handler(e);
+                }
+                catch {
+                    /* handler threw — never break other bindings */
+                }
+            }
+        };
+        target.addEventListener('keydown', this.onKey);
+    }
+    stop() {
+        if (this.onKey && this.target)
+            this.target.removeEventListener('keydown', this.onKey);
+        this.onKey = undefined;
+        this.target = null;
+    }
+}
+//# sourceMappingURL=keyboard.js.map

package/dist/features/inapp/core/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../../../src/features/inapp/core/keyboard.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,CAAC,GAAU,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IACnE,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;aAC9G,IAAI,CAAC,KAAK,OAAO;YAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC;aAClC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,KAAK;YAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;aAC/D,IAAI,CAAC;YAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAsB;IACrD,MAAM,IAAI,GAAG,EAAwB,CAAC;IACtC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;IACzB,OAAO,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,iBAAiB,KAAK,IAAI,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAgB,EAAE,CAAQ;IACrD,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC;IACnC,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC;AACxG,CAAC;AAQD,MAAM,OAAO,YAAY;IAAzB;QACU,aAAQ,GAAc,EAAE,CAAC;QAEzB,WAAM,GAA6B,IAAI,CAAC;IAmClD,CAAC;IAjCC,wGAAwG;IACxG,QAAQ,CAAC,KAAa,EAAE,OAAmC,EAAE,OAA6B,EAAE;QAC1F,MAAM,CAAC,GAAY,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAChF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAA4B,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,SAAmB;QAC7F,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAgB,EAAE,EAAE;YAChC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC5C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACxC,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,MAAM;oBAAE,SAAS,CAAC,sBAAsB;gBAC3D,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC;oBACH,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACf,CAAC;gBAAC,MAAM,CAAC;oBACP,gDAAgD;gBAClD,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,KAAsB,CAAC,CAAC;IAClE,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,KAAsB,CAAC,CAAC;QACvG,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;CACF"}

package/dist/features/inapp/core/metrics.d.ts

@@ -0,0 +1,73 @@
+/**
+ * IAM 2.0 self-observability (spec §10, P0.7) — the SDK observes itself.
+ *
+ * Two pieces:
+ *   • `SelfMetrics` — health counters/timings the engine feeds as it works: render latency, chunk
+ *     load time, anchor retries, failed selectors, render errors, interaction latency, layout shift,
+ *     animation fps, memory. Snapshotted for the telemetry lane (§P0.8) and the debug overlay.
+ *   • `DecisionLog` — a bounded ring of every Orchestrator decision (§8), enabling
+ *     `scalebun.inapp.explain(id)` → "why did / didn't this show?".
+ *
+ * Zero-dependency; all timing via `performance.now()` when present.
+ */
+import type { Decision } from './orchestrator';
+export interface MetricsSnapshot {
+    renders: number;
+    renderErrors: number;
+    anchorRetries: number;
+    failedSelectors: number;
+    recentFailedSelectors: string[];
+    renderLatencyMs: {
+        last: number;
+        avg: number;
+        max: number;
+    };
+    interactionLatencyMs: {
+        last: number;
+        avg: number;
+        max: number;
+    };
+    chunkLoadMs: Record<string, number>;
+    layoutShiftTotal: number;
+    fps: number;
+    memoryMb: number;
+}
+export declare class SelfMetrics {
+    private renders;
+    private renderErrors;
+    private anchorRetries;
+    private failedSelectors;
+    private renderLatency;
+    private interactionLatency;
+    private chunkLoad;
+    private layoutShiftTotal;
+    private fpsValue;
+    private memoryMbValue;
+    private rafId;
+    recordRender(latencyMs: number): void;
+    recordRenderError(): void;
+    recordAnchorRetry(): void;
+    recordFailedSelector(selector: string): void;
+    recordChunkLoad(name: string, ms: number): void;
+    recordInteractionLatency(ms: number): void;
+    recordLayoutShift(value: number): void;
+    /** Time an async chunk import → records its load ms under `name`. */
+    timeImport<T>(name: string, importer: () => Promise<T>): Promise<T>;
+    /** Start a rAF-based fps sampler + periodic memory read. Returns a stop fn. */
+    startSampling(): () => void;
+    snapshot(): MetricsSnapshot;
+}
+export interface LoggedDecision extends Decision {
+    campaignId?: string;
+    at: number;
+}
+export declare class DecisionLog {
+    private readonly cap;
+    private ring;
+    constructor(cap?: number);
+    record(decisions: Decision[], campaignOf: (id: string) => string | undefined, at?: number): void;
+    /** Why did / didn't `idOrCampaign` show? Most recent first. */
+    explain(idOrCampaign: string): LoggedDecision[];
+    recent(n?: number): LoggedDecision[];
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/features/inapp/core/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/core/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAkB/C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,oBAAoB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,kBAAkB,CAAe;IACzC,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAuB;IAEpC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC,iBAAiB,IAAI,IAAI;IAGzB,iBAAiB,IAAI,IAAI;IAGzB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI5C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAG/C,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAG1C,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAItC,qEAAqE;IAC/D,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAOzE,+EAA+E;IAC/E,aAAa,IAAI,MAAM,IAAI;IA2B3B,QAAQ,IAAI,eAAe;CAoB5B;AAGD,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,WAAW;IAEV,OAAO,CAAC,QAAQ,CAAC,GAAG;IADhC,OAAO,CAAC,IAAI,CAAwB;gBACP,GAAG,SAAM;IAEtC,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EAAE,EAAE,GAAE,MAAmB,GAAG,IAAI;IAO5G,+DAA+D;IAC/D,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,EAAE;IAI/C,MAAM,CAAC,CAAC,SAAK,GAAG,cAAc,EAAE;CAGjC"}

package/dist/features/inapp/core/metrics.js

@@ -0,0 +1,125 @@
+const nowMs = () => (typeof performance !== 'undefined' ? performance.now() : Date.now());
+const emptyStat = () => ({ count: 0, sum: 0, max: 0, last: 0 });
+function push(s, v) {
+    s.count++;
+    s.sum += v;
+    s.max = Math.max(s.max, v);
+    s.last = v;
+}
+export class SelfMetrics {
+    constructor() {
+        this.renders = 0;
+        this.renderErrors = 0;
+        this.anchorRetries = 0;
+        this.failedSelectors = [];
+        this.renderLatency = emptyStat();
+        this.interactionLatency = emptyStat();
+        this.chunkLoad = {};
+        this.layoutShiftTotal = 0;
+        this.fpsValue = 0;
+        this.memoryMbValue = 0;
+        this.rafId = null;
+    }
+    recordRender(latencyMs) {
+        this.renders++;
+        push(this.renderLatency, latencyMs);
+    }
+    recordRenderError() {
+        this.renderErrors++;
+    }
+    recordAnchorRetry() {
+        this.anchorRetries++;
+    }
+    recordFailedSelector(selector) {
+        this.failedSelectors.push(selector);
+        if (this.failedSelectors.length > 20)
+            this.failedSelectors.shift();
+    }
+    recordChunkLoad(name, ms) {
+        this.chunkLoad[name] = Math.round(ms);
+    }
+    recordInteractionLatency(ms) {
+        push(this.interactionLatency, ms);
+    }
+    recordLayoutShift(value) {
+        this.layoutShiftTotal += value;
+    }
+    /** Time an async chunk import → records its load ms under `name`. */
+    async timeImport(name, importer) {
+        const t0 = nowMs();
+        const mod = await importer();
+        this.recordChunkLoad(name, nowMs() - t0);
+        return mod;
+    }
+    /** Start a rAF-based fps sampler + periodic memory read. Returns a stop fn. */
+    startSampling() {
+        if (typeof requestAnimationFrame === 'undefined')
+            return () => { };
+        let last = nowMs();
+        let frames = 0;
+        let acc = 0;
+        const loop = () => {
+            const t = nowMs();
+            const dt = t - last;
+            last = t;
+            frames++;
+            acc += dt;
+            if (acc >= 1000) {
+                this.fpsValue = Math.round((frames * 1000) / acc);
+                frames = 0;
+                acc = 0;
+                const mem = performance.memory;
+                if (mem)
+                    this.memoryMbValue = Math.round(mem.usedJSHeapSize / (1024 * 1024));
+            }
+            this.rafId = requestAnimationFrame(loop);
+        };
+        this.rafId = requestAnimationFrame(loop);
+        return () => {
+            if (this.rafId != null)
+                cancelAnimationFrame(this.rafId);
+            this.rafId = null;
+        };
+    }
+    snapshot() {
+        const stat = (s) => ({
+            last: Math.round(s.last),
+            avg: s.count ? Math.round(s.sum / s.count) : 0,
+            max: Math.round(s.max),
+        });
+        return {
+            renders: this.renders,
+            renderErrors: this.renderErrors,
+            anchorRetries: this.anchorRetries,
+            failedSelectors: this.failedSelectors.length,
+            recentFailedSelectors: this.failedSelectors.slice(-5),
+            renderLatencyMs: stat(this.renderLatency),
+            interactionLatencyMs: stat(this.interactionLatency),
+            chunkLoadMs: { ...this.chunkLoad },
+            layoutShiftTotal: Number(this.layoutShiftTotal.toFixed(4)),
+            fps: this.fpsValue,
+            memoryMb: this.memoryMbValue,
+        };
+    }
+}
+export class DecisionLog {
+    constructor(cap = 200) {
+        this.cap = cap;
+        this.ring = [];
+    }
+    record(decisions, campaignOf, at = Date.now()) {
+        for (const d of decisions) {
+            this.ring.push({ ...d, campaignId: campaignOf(d.id), at });
+        }
+        if (this.ring.length > this.cap)
+            this.ring.splice(0, this.ring.length - this.cap);
+    }
+    /** Why did / didn't `idOrCampaign` show? Most recent first. */
+    explain(idOrCampaign) {
+        return this.ring.filter((d) => d.id === idOrCampaign || d.campaignId === idOrCampaign).reverse();
+    }
+    recent(n = 20) {
+        return this.ring.slice(-n).reverse();
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/features/inapp/core/metrics.js.map

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

package/dist/features/inapp/core/migration.d.ts

@@ -0,0 +1,32 @@
+/**
+ * IAM 2.0 migration (spec §7.9, P4.4 = phase M5). The engine has three modes, flag-selected, so the
+ * cutover from the legacy 7-layout widget is safe and reversible:
+ *   • 'legacy'  — the old 7-layout widget serves (unchanged; the ultimate rollback).
+ *   • 'compat'  — legacy InAppMessages are mapped to new surfaces via `legacyToVariant` (M0). Live
+ *                 campaigns render on the new engine with NO re-authoring.
+ *   • 'native'  — new schema-driven variants only.
+ * The backend keeps serving the legacy flat mirror to very old embeds regardless (mirror-degrade).
+ */
+import type { InAppMessage } from '../../engage/types';
+import type { Variant } from '../types';
+export type InAppEngineMode = 'legacy' | 'compat' | 'native';
+export interface MigrationConfig {
+    /** Which engine to run. Default 'compat' (safe: new engine, legacy campaigns still work). */
+    engine?: InAppEngineMode;
+}
+export declare function resolveEngineMode(config?: MigrationConfig): InAppEngineMode;
+/** Should the new (v2) engine run at all? (false only in 'legacy' mode.) */
+export declare function useNewEngine(config?: MigrationConfig): boolean;
+/**
+ * Produce the variant set the new engine should render from a served config, per mode:
+ *   • compat — map legacy InAppMessages → variants (dropping any that can't be made valid).
+ *   • native — use the provided native variants as-is.
+ *   • legacy — none (the old widget handles it).
+ * Always returns contract-valid variants only, so a migrated campaign never dead-ends at the guard.
+ */
+export declare function migrateConfig(opts: {
+    legacyMessages?: InAppMessage[];
+    nativeVariants?: Variant[];
+    config?: MigrationConfig;
+}): Variant[];
+//# sourceMappingURL=migration.d.ts.map

package/dist/features/inapp/core/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/core/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAIxC,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,6FAA6F;IAC7F,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,eAAe,CAE3E;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE;IAAE,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,CAAA;CAAE,GAC9F,OAAO,EAAE,CAOX"}

package/dist/features/inapp/core/migration.js

@@ -0,0 +1,28 @@
+import { legacyConfigToVariants } from './compat';
+import { isValidVariant } from '../inappContract.web';
+export function resolveEngineMode(config) {
+    return config?.engine ?? 'compat';
+}
+/** Should the new (v2) engine run at all? (false only in 'legacy' mode.) */
+export function useNewEngine(config) {
+    return resolveEngineMode(config) !== 'legacy';
+}
+/**
+ * Produce the variant set the new engine should render from a served config, per mode:
+ *   • compat — map legacy InAppMessages → variants (dropping any that can't be made valid).
+ *   • native — use the provided native variants as-is.
+ *   • legacy — none (the old widget handles it).
+ * Always returns contract-valid variants only, so a migrated campaign never dead-ends at the guard.
+ */
+export function migrateConfig(opts) {
+    const mode = resolveEngineMode(opts.config);
+    if (mode === 'legacy')
+        return [];
+    const out = [];
+    if (mode === 'native' || mode === 'compat')
+        out.push(...(opts.nativeVariants ?? []));
+    if (mode === 'compat')
+        out.push(...legacyConfigToVariants(opts.legacyMessages));
+    return out.filter(isValidVariant);
+}
+//# sourceMappingURL=migration.js.map

package/dist/features/inapp/core/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../../../src/features/inapp/core/migration.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAStD,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,OAAO,MAAM,EAAE,MAAM,IAAI,QAAQ,CAAC;AACpC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,MAAwB;IACnD,OAAO,iBAAiB,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,IAA+F;IAE/F,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC;IACrF,IAAI,IAAI,KAAK,QAAQ;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IAChF,OAAO,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AACpC,CAAC"}