@scalebun/web 1.0.0

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

@@ -0,0 +1,79 @@
+/**
+ * IAM 2.0 debug overlay (spec §10, P0.7) — a live, in-page inspector for the engine.
+ *
+ * Opt-in via `?scalebunDebug=1` (or `localStorage.scalebun_inapp_debug = '1'`). Renders a corner panel showing
+ * the self-metrics snapshot + the recent decision log so a developer can see, in real time, why a
+ * message did/didn't show and how the SDK is behaving. Intentionally dependency-free and lazy — it
+ * ships in its own chunk and never loads in production unless the flag is set.
+ */
+import { applyNonce } from '../../../core';
+const PANEL_ID = 'scalebun-inapp-debug';
+export function debugEnabled() {
+    try {
+        if (typeof location !== 'undefined' && /[?&]scalebunDebug=1\b/.test(location.search))
+            return true;
+        return typeof localStorage !== 'undefined' && localStorage.getItem('scalebun_inapp_debug') === '1';
+    }
+    catch {
+        return false;
+    }
+}
+export function mountDebugOverlay(metrics, log) {
+    if (typeof document === 'undefined' || !debugEnabled())
+        return () => { };
+    if (document.getElementById(PANEL_ID))
+        return () => { };
+    const host = document.createElement('div');
+    host.id = PANEL_ID;
+    const root = host.attachShadow({ mode: 'open' });
+    const style = applyNonce(document.createElement('style'));
+    style.textContent = `
+    .p{position:fixed;bottom:12px;left:12px;z-index:2147483646;width:320px;max-height:60vh;overflow:auto;
+       background:rgba(17,20,28,.96);color:#e6e9ef;border:1px solid #333b4a;border-radius:10px;
+       font:12px/1.45 ui-monospace,SFMono-Regular,Menlo,monospace;padding:10px 12px;box-shadow:0 10px 40px rgba(0,0,0,.5)}
+    .h{display:flex;justify-content:space-between;align-items:center;font-weight:700;margin-bottom:6px}
+    .h button{background:none;border:0;color:#9aa3b2;cursor:pointer;font:inherit}
+    .row{display:flex;justify-content:space-between;gap:8px;padding:1px 0}
+    .k{color:#9aa3b2}
+    .sec{margin-top:8px;border-top:1px solid #2a3140;padding-top:6px}
+    .d{padding:2px 0;border-bottom:1px solid #222833}
+    .a-SHOW{color:#5fd18b}.a-QUEUE{color:#e6c15f}.a-DEFER{color:#7c9dff}.a-DROP{color:#e0748a}.a-PREEMPT{color:#d18ee6}
+  `;
+    root.appendChild(style);
+    const panel = document.createElement('div');
+    panel.className = 'p';
+    root.appendChild(panel);
+    document.body.appendChild(host);
+    const esc = (s) => s.replace(/[<>&]/g, (c) => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;' })[c]);
+    const render = () => {
+        const m = metrics.snapshot();
+        const rows = [
+            ['renders', String(m.renders)],
+            ['render errors', String(m.renderErrors)],
+            ['anchor retries', String(m.anchorRetries)],
+            ['failed selectors', String(m.failedSelectors)],
+            ['render p (last/avg/max)', `${m.renderLatencyMs.last}/${m.renderLatencyMs.avg}/${m.renderLatencyMs.max}ms`],
+            ['interaction (last/avg)', `${m.interactionLatencyMs.last}/${m.interactionLatencyMs.avg}ms`],
+            ['layout shift', String(m.layoutShiftTotal)],
+            ['fps', String(m.fps)],
+            ['memory', m.memoryMb ? `${m.memoryMb}MB` : '—'],
+        ];
+        const decisions = log
+            .recent(12)
+            .map((d) => `<div class="d"><span class="a-${d.action}">${d.action}</span> ${esc(d.id)} <span class="k">${esc(d.reason)}</span></div>`)
+            .join('');
+        panel.innerHTML =
+            `<div class="h"><span>scalebun · in-app</span><button aria-label="close">×</button></div>` +
+                rows.map(([k, v]) => `<div class="row"><span class="k">${k}</span><span>${esc(v)}</span></div>`).join('') +
+                `<div class="sec"><div class="k">recent decisions</div>${decisions || '<div class="d k">none yet</div>'}</div>`;
+        panel.querySelector('button')?.addEventListener('click', stop, { once: true });
+    };
+    render();
+    const timer = setInterval(render, 1000);
+    function stop() {
+        clearInterval(timer);
+        host.remove();
+    }
+    return stop;
+}
+//# sourceMappingURL=debugOverlay.js.map

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

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

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

@@ -0,0 +1,70 @@
+/**
+ * IAM 2.0 engine (the ignition). Ties the finished pieces into ONE automatic delivery loop:
+ *   fetchConfig → migrate (legacy/native by mode) → arm triggers → on a matching+eligible trigger,
+ *   build a Candidate → the orchestrator `decide()`s which win → render the winners → wire their
+ *   analytics into the durable outbox. The arbitration/scoring lives in `decide()` (pure); this file
+ *   is the stateful plumbing: occupancy, budget, frequency, and the debounced tick.
+ *
+ * Everything here is lazy (loaded via the ReplayFeature-style dynamic import), so it costs no
+ * eager-core bytes. Fail-safe: any error degrades to "show nothing", never throws into the host.
+ */
+import { type InAppEvent } from './transport';
+import { type UserProfile } from './targeting';
+import { type MigrationConfig } from './migration';
+export interface EngineDeps {
+    apiBaseUrl: string;
+    clientKey: string;
+    deviceId?: string;
+    appVersion?: string;
+    /** Identified user id, read fresh per fetch — the backend resolves segment targeting off it. */
+    userId?: () => string | undefined;
+    /** Current route path (called fresh each time — the engine never caches it). */
+    route: () => string;
+    /** Local user profile for targeting/audience matching. */
+    profile?: () => UserProfile | undefined;
+    /** Engine mode (legacy/compat/native). Default 'compat'. */
+    config?: MigrationConfig;
+    now?: () => number;
+    /** Optional mirror of each analytics event onto the capture bus (error↔frame correlation). */
+    onEvent?: (e: InAppEvent) => void;
+}
+export declare class InAppEngine {
+    private readonly deps;
+    private readonly transport;
+    private readonly bus;
+    private readonly freq;
+    private readonly host;
+    private readonly slots;
+    private readonly now;
+    private variants;
+    private readonly pending;
+    private readonly live;
+    private readonly budget;
+    private tickTimer;
+    private unsub?;
+    private started;
+    constructor(deps: EngineDeps);
+    /** Fetch config, migrate, arm triggers, and fire the initial route so page-load campaigns qualify. */
+    start(): Promise<void>;
+    /**
+     * Re-read config because the identity changed (the host called identify()).
+     *
+     * The boot fetch is normally anonymous, and the backend serves NO segment-targeted variant to an
+     * anonymous request — it fails closed. Without this, a visitor who logs in mid-session would not
+     * see a single segment-targeted message until a full page load. Mobile does not need this because
+     * the provider re-renders on identity change; web holds one long-lived document.
+     */
+    onIdentify(): Promise<void>;
+    private load;
+    /** Facade seam: host fires a named custom event trigger (e.g. after a feature is used). */
+    fireEvent(name: string): void;
+    private onSignal;
+    private toCandidate;
+    private targetingCtx;
+    private scheduleTick;
+    private tick;
+    private show;
+    private close;
+    stop(): void;
+}
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/core/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAA8D,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE3G,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AASlE,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAClC,gFAAgF;IAChF,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACxC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;CACnC;AAID,qBAAa,WAAW;IAgBV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAfjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkE;IACvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAS;gBAEK,IAAI,EAAE,UAAU;IAe7C,sGAAsG;IAChG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAInB,IAAI;IA+BlB,2FAA2F;IAC3F,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7B,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,YAAY;YAQN,IAAI;YAoBJ,IAAI;IAwClB,OAAO,CAAC,KAAK;IAWb,IAAI,IAAI,IAAI;CAkBb"}

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

@@ -0,0 +1,248 @@
+/**
+ * IAM 2.0 engine (the ignition). Ties the finished pieces into ONE automatic delivery loop:
+ *   fetchConfig → migrate (legacy/native by mode) → arm triggers → on a matching+eligible trigger,
+ *   build a Candidate → the orchestrator `decide()`s which win → render the winners → wire their
+ *   analytics into the durable outbox. The arbitration/scoring lives in `decide()` (pure); this file
+ *   is the stateful plumbing: occupancy, budget, frequency, and the debounced tick.
+ *
+ * Everything here is lazy (loaded via the ReplayFeature-style dynamic import), so it costs no
+ * eager-core bytes. Fail-safe: any error degrades to "show nothing", never throws into the host.
+ */
+import { InAppTransport } from './transport';
+import { TriggerBus, routePlugin, eventPlugin, idlePlugin, matchTrigger } from './triggers';
+import { evaluateEligibility, FrequencyStore } from './targeting';
+import { decide } from './orchestrator';
+import { migrateConfig } from './migration';
+import { ShadowHost } from './host';
+import { SlotRegistry } from './slots';
+import { renderVariant } from '../surfaces/render';
+import { zoneForVariant, SURFACE_FOCUS, SURFACE_COST } from '../inappContract.web';
+import { normalizeConfig } from '../../engage/normalize';
+const TICK_DEBOUNCE_MS = 120;
+export class InAppEngine {
+    constructor(deps) {
+        this.deps = deps;
+        this.freq = new FrequencyStore();
+        this.host = new ShadowHost();
+        this.slots = new SlotRegistry();
+        this.variants = [];
+        this.pending = new Map(); // variantId → candidate awaiting a tick
+        this.live = new Map();
+        this.tickTimer = null;
+        this.started = false;
+        this.now = deps.now ?? (() => Date.now());
+        this.transport = new InAppTransport(deps.apiBaseUrl, deps.clientKey);
+        this.bus = new TriggerBus(this.now);
+        this.budget = {
+            tokens: 5,
+            interruptionsThisSession: 0,
+            maxInterruptionsPerSession: 5,
+            modalsToday: 0,
+            maxModalsPerDay: 3,
+            lastInterruptionAt: 0,
+            minCooldownMs: 30000,
+        };
+    }
+    /** Fetch config, migrate, arm triggers, and fire the initial route so page-load campaigns qualify. */
+    async start() {
+        if (this.started)
+            return;
+        this.started = true;
+        await this.load();
+    }
+    /**
+     * Re-read config because the identity changed (the host called identify()).
+     *
+     * The boot fetch is normally anonymous, and the backend serves NO segment-targeted variant to an
+     * anonymous request — it fails closed. Without this, a visitor who logs in mid-session would not
+     * see a single segment-targeted message until a full page load. Mobile does not need this because
+     * the provider re-renders on identity change; web holds one long-lived document.
+     */
+    async onIdentify() {
+        if (this.started)
+            await this.load();
+    }
+    async load() {
+        let raw;
+        try {
+            raw = await this.transport.fetchConfig({
+                platform: 'web',
+                appVersion: this.deps.appVersion,
+                deviceId: this.deps.deviceId,
+                endUserId: this.deps.userId?.(),
+                route: this.deps.route(),
+            });
+        }
+        catch {
+            return;
+        }
+        if (!this.started)
+            return; // torn down mid-fetch
+        const cfg = normalizeConfig(raw);
+        const nativeVariants = raw?.variants;
+        this.variants = migrateConfig({ legacyMessages: cfg.inAppMessages, nativeVariants, config: this.deps.config });
+        if (this.variants.length === 0)
+            return;
+        // Arm once. A boot fetch that returned nothing leaves the bus unarmed, so the post-identify load
+        // is what arms it — which is exactly the segment-targeted case.
+        if (!this.unsub) {
+            this.host.ensure();
+            this.bus.use(routePlugin());
+            this.bus.use(eventPlugin());
+            this.bus.use(idlePlugin());
+            this.unsub = this.bus.on((sig) => this.onSignal(sig));
+        }
+        this.bus.fire({ type: 'route', value: this.deps.route() }); // seed page-load / route-targeted variants
+    }
+    /** Facade seam: host fires a named custom event trigger (e.g. after a feature is used). */
+    fireEvent(name) {
+        if (this.started)
+            this.bus.fire({ type: 'event', value: name });
+    }
+    onSignal(sig) {
+        const ctx = this.targetingCtx();
+        for (const v of this.variants) {
+            if (this.live.has(v.id) || this.pending.has(v.id))
+                continue;
+            if (!v.triggers.some((ref) => matchTrigger(ref, sig)))
+                continue;
+            if (!evaluateEligibility(v, ctx, this.freq).eligible)
+                continue;
+            this.pending.set(v.id, this.toCandidate(v));
+        }
+        if (this.pending.size)
+            this.scheduleTick();
+    }
+    toCandidate(v) {
+        const guidance = v.surface === 'coachmark' || v.surface === 'tour' || v.surface === 'hotspot';
+        const interactionOnly = v.surface === 'launcher' || v.surface === 'palette';
+        return {
+            id: v.id,
+            zone: zoneForVariant(v),
+            focus: SURFACE_FOCUS[v.surface],
+            cost: SURFACE_COST[v.surface],
+            tier: v.priority,
+            category: v.category,
+            triggeredAt: this.now(),
+            guidance,
+            interactionOnly,
+        };
+    }
+    targetingCtx() {
+        const hasSelection = typeof window !== 'undefined' ? !!window.getSelection?.()?.toString() : false;
+        return {
+            route: this.deps.route(),
+            profile: this.deps.profile?.(),
+            now: this.now(),
+            viewportWidth: typeof window !== 'undefined' ? window.innerWidth : undefined,
+            hasSelection,
+        };
+    }
+    scheduleTick() {
+        if (this.tickTimer)
+            return;
+        this.tickTimer = setTimeout(() => {
+            this.tickTimer = null;
+            void this.tick();
+        }, TICK_DEBOUNCE_MS);
+    }
+    async tick() {
+        const candidates = [...this.pending.values()];
+        if (candidates.length === 0)
+            return;
+        const occupants = [...this.live.values()].map((l) => l.occ);
+        const decisions = decide(candidates, occupants, this.budget, { now: this.now() });
+        for (const d of decisions) {
+            const v = this.variants.find((x) => x.id === d.id);
+            if (!v)
+                continue;
+            if (d.action === 'SHOW' || d.action === 'PREEMPT') {
+                this.pending.delete(v.id);
+                if (d.action === 'PREEMPT' && d.preempts)
+                    this.close(d.preempts);
+                await this.show(v);
+            }
+            else if (d.action === 'DROP') {
+                this.pending.delete(v.id);
+            }
+            // QUEUE / DEFER → leave in `pending` for a later tick (when a zone frees).
+        }
+        if (this.pending.size)
+            this.scheduleTick();
+    }
+    async show(v) {
+        const t = this.now.bind(this);
+        const emit = (type, props) => {
+            const ev = { id: `${v.id}:${type}:${t()}`, type, variantId: v.id, ts: t(), props };
+            this.transport.outbox.enqueue(ev);
+            this.deps.onEvent?.(ev);
+        };
+        const hooks = {
+            onImpression: () => {
+                this.freq.recordImpression(v.id, t());
+                emit('impression');
+            },
+            onView: () => emit('view'),
+            onCtaClick: (action) => emit('cta_click', { action }),
+            onInteraction: (name) => emit('interaction', { name }),
+            onDismiss: (method) => {
+                this.freq.recordDismiss(v.id, t());
+                this.live.delete(v.id);
+                emit('dismiss', { method });
+                this.scheduleTick(); // a freed zone may let a QUEUEd candidate through
+            },
+        };
+        try {
+            const surface = await renderVariant(v, hooks, { host: this.host, slots: this.slots });
+            this.live.set(v.id, {
+                occ: { id: v.id, zone: zoneForVariant(v), focus: SURFACE_FOCUS[v.surface], tier: v.priority },
+                surface,
+            });
+            const cost = SURFACE_COST[v.surface];
+            if (cost > 0) {
+                this.budget.interruptionsThisSession++;
+                this.budget.lastInterruptionAt = t();
+                this.budget.tokens = Math.max(0, this.budget.tokens - cost);
+                if (zoneForVariant(v) === 'modal')
+                    this.budget.modalsToday++;
+            }
+        }
+        catch {
+            this.pending.delete(v.id);
+        }
+    }
+    close(variantId) {
+        const l = this.live.get(variantId);
+        if (!l)
+            return;
+        try {
+            l.surface.close();
+        }
+        catch {
+            /* never throw into the host */
+        }
+        this.live.delete(variantId);
+    }
+    stop() {
+        if (!this.started)
+            return;
+        this.started = false;
+        if (this.tickTimer) {
+            clearTimeout(this.tickTimer);
+            this.tickTimer = null;
+        }
+        this.unsub?.();
+        this.bus.stop();
+        for (const id of [...this.live.keys()])
+            this.close(id);
+        this.pending.clear();
+        void this.transport.outbox.flush();
+        try {
+            this.host.destroy();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * IAM 2.0 environment utilities (P3.8): clipboard, tab-visibility awareness, and viewport-safe
+ * (multi-monitor sane) positioning. Corner surfaces live in the fixed overlay layer, so they're
+ * already window-relative (never span monitors); `clampToViewport` guarantees any absolute placement
+ * stays inside the *current* window regardless of the desktop's monitor layout.
+ */
+/** Copy text to the clipboard (Clipboard API, execCommand fallback). Never throws. */
+export declare function copyToClipboard(text: string): Promise<boolean>;
+/** Is the tab currently visible? (false when backgrounded / minimized.) */
+export declare function isTabVisible(): boolean;
+/** Subscribe to tab visibility changes. Returns an unsubscribe fn. */
+export declare function onVisibilityChange(cb: (visible: boolean) => void): () => void;
+/** Clamp an (x,y,w,h) box to stay fully inside the current window viewport (multi-monitor safe). */
+export declare function clampToViewport(x: number, y: number, w: number, h: number, pad?: number, vp?: {
+    width: number;
+    height: number;
+}): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/core/environment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sFAAsF;AACtF,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBpE;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAK7E;AAED,oGAAoG;AACpG,wBAAgB,eAAe,CAC7B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,GAAG,SAAI,EACP,EAAE,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAO1B"}

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

@@ -0,0 +1,57 @@
+/**
+ * IAM 2.0 environment utilities (P3.8): clipboard, tab-visibility awareness, and viewport-safe
+ * (multi-monitor sane) positioning. Corner surfaces live in the fixed overlay layer, so they're
+ * already window-relative (never span monitors); `clampToViewport` guarantees any absolute placement
+ * stays inside the *current* window regardless of the desktop's monitor layout.
+ */
+/** Copy text to the clipboard (Clipboard API, execCommand fallback). Never throws. */
+export async function copyToClipboard(text) {
+    try {
+        if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
+            await navigator.clipboard.writeText(text);
+            return true;
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    try {
+        if (typeof document === 'undefined')
+            return false;
+        const ta = document.createElement('textarea');
+        ta.value = text;
+        ta.style.position = 'fixed';
+        ta.style.opacity = '0';
+        ta.setAttribute('aria-hidden', 'true');
+        document.body.appendChild(ta);
+        ta.select();
+        const ok = typeof document.execCommand === 'function' ? document.execCommand('copy') : false;
+        ta.remove();
+        return ok;
+    }
+    catch {
+        return false;
+    }
+}
+/** Is the tab currently visible? (false when backgrounded / minimized.) */
+export function isTabVisible() {
+    return typeof document === 'undefined' || document.visibilityState !== 'hidden';
+}
+/** Subscribe to tab visibility changes. Returns an unsubscribe fn. */
+export function onVisibilityChange(cb) {
+    if (typeof document === 'undefined')
+        return () => { };
+    const h = () => cb(isTabVisible());
+    document.addEventListener('visibilitychange', h);
+    return () => document.removeEventListener('visibilitychange', h);
+}
+/** Clamp an (x,y,w,h) box to stay fully inside the current window viewport (multi-monitor safe). */
+export function clampToViewport(x, y, w, h, pad = 8, vp) {
+    const vw = vp?.width ?? (typeof innerWidth !== 'undefined' ? innerWidth : 1024);
+    const vh = vp?.height ?? (typeof innerHeight !== 'undefined' ? innerHeight : 768);
+    return {
+        x: Math.max(pad, Math.min(x, Math.max(pad, vw - w - pad))),
+        y: Math.max(pad, Math.min(y, Math.max(pad, vh - h - pad))),
+    };
+}
+//# sourceMappingURL=environment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../../src/features/inapp/core/environment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,IAAI,CAAC;QACH,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC;YACvE,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IACD,IAAI,CAAC;QACH,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAO,KAAK,CAAC;QAClD,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAC9C,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC;QAChB,EAAE,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC5B,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;QACvB,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9B,EAAE,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,EAAE,GAAG,OAAO,QAAQ,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC7F,EAAE,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,CAAC;AAClF,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,kBAAkB,CAAC,EAA8B;IAC/D,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IACrD,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;IACjD,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,eAAe,CAC7B,CAAS,EACT,CAAS,EACT,CAAS,EACT,CAAS,EACT,GAAG,GAAG,CAAC,EACP,EAAsC;IAEtC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,OAAO,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChF,MAAM,EAAE,GAAG,EAAE,EAAE,MAAM,IAAI,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClF,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAC1D,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;KAC3D,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * 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.
+ */
+export type ThemeMode = 'light' | 'dark' | 'auto';
+/** Resolve 'auto' against the OS preference. */
+export declare function resolveScheme(mode: ThemeMode): 'light' | 'dark';
+/** Apply the IAM theme tokens as CSS vars on any element (Shadow host, or an inline nested host). */
+export declare function applyThemeVars(el: HTMLElement, mode: ThemeMode): void;
+export declare class ShadowHost {
+    private host?;
+    private root?;
+    private layer?;
+    private zones;
+    private sheet?;
+    private mql?;
+    private onScheme?;
+    private mode;
+    /** Idempotent: mounts the host + layer + base stylesheet. Safe to call repeatedly. */
+    ensure(): void;
+    private injectStyleTag;
+    /** 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. */
+    private adoptedIds;
+    addStyles(id: string, css: string): void;
+    /** Set explicit theme; 'auto' follows prefers-color-scheme. Ensures the host exists first. */
+    setTheme(mode: ThemeMode): void;
+    private applyTheme;
+    /**
+     * 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(): HTMLElement | undefined;
+    /** Get (creating on first use) the mount container for a zone key (§8.1). */
+    zone(zoneKey: string): HTMLElement;
+    /** Remove everything and detach. Safe to call multiple times. */
+    destroy(): void;
+    /** Test/debug access to the shadow root. */
+    get shadowRoot(): ShadowRoot | undefined;
+}
+//# sourceMappingURL=host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/core/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA2EH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAO/D;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAGrE;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,KAAK,CAAC,CAAgB;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,IAAI,CAAqB;IAEjC,sFAAsF;IACtF,MAAM,IAAI,IAAI;IAmDd,OAAO,CAAC,cAAc;IAMtB;kEAC8D;IAC9D,OAAO,CAAC,UAAU,CAAqB;IACvC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAsBxC,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAM/B,OAAO,CAAC,UAAU;IAKlB;;;;;;;OAOG;IACH,OAAO,IAAI,WAAW,GAAG,SAAS;IAIlC,6EAA6E;IAC7E,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAclC,iEAAiE;IACjE,OAAO,IAAI,IAAI;IAYf,4CAA4C;IAC5C,IAAI,UAAU,IAAI,UAAU,GAAG,SAAS,CAEvC;CACF"}