@scalebun/web 1.0.0

package/dist/features/inapp/surfaces/toast.d.ts

@@ -0,0 +1,7 @@
+/**
+ * S10 — Toast surface (P1.2). Transient corner card; stacks in the toast zone (cap enforced by the
+ * Orchestrator). Optional auto-dismiss. role=status + aria-live=polite for non-intrusive SR announce.
+ */
+import type { SurfaceInstance, SurfaceMountCtx } from './surface';
+export declare function toastSurface(ctx: SurfaceMountCtx): SurfaceInstance;
+//# sourceMappingURL=toast.d.ts.map

package/dist/features/inapp/surfaces/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/surfaces/toast.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGlE,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,CAgDlE"}

package/dist/features/inapp/surfaces/toast.js

@@ -0,0 +1,48 @@
+import { renderVariantBlocks } from './surface';
+export function toastSurface(ctx) {
+    const { doc, variant } = ctx;
+    const root = doc.createElement('div');
+    root.className = 'scalebun-toast';
+    root.setAttribute('role', variant.a11y?.role ?? 'status');
+    root.setAttribute('aria-live', variant.a11y?.liveRegion ?? 'polite');
+    const body = doc.createElement('div');
+    body.className = 'scalebun-body';
+    for (const node of renderVariantBlocks(ctx))
+        body.appendChild(node);
+    root.appendChild(body);
+    if (variant.dismiss?.xButton !== false) {
+        const x = doc.createElement('button');
+        x.type = 'button';
+        x.className = 'scalebun-x';
+        x.setAttribute('aria-label', 'Dismiss');
+        x.textContent = '×';
+        x.addEventListener('click', () => ctx.requestClose('x'));
+        root.appendChild(x);
+    }
+    // Auto-dismiss timer (pauses on hover so a user reading it isn't cut off).
+    let timer = null;
+    const autoMs = variant.dismiss?.autoDismissMs;
+    const arm = () => {
+        if (autoMs && autoMs > 0)
+            timer = setTimeout(() => ctx.requestClose('auto'), autoMs);
+    };
+    const clear = () => {
+        if (timer != null) {
+            clearTimeout(timer);
+            timer = null;
+        }
+    };
+    if (autoMs && autoMs > 0) {
+        root.addEventListener('mouseenter', clear);
+        root.addEventListener('mouseleave', arm);
+        arm();
+    }
+    return {
+        el: root,
+        destroy: () => {
+            clear();
+            root.remove();
+        },
+    };
+}
+//# sourceMappingURL=toast.js.map

package/dist/features/inapp/surfaces/toast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.js","sourceRoot":"","sources":["../../../../src/features/inapp/surfaces/toast.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,UAAU,YAAY,CAAC,GAAoB;IAC/C,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IAE7B,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,CAAC,SAAS,GAAG,gBAAgB,CAAC;IAClC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,IAAI,QAAQ,CAAC,CAAC;IAC1D,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,IAAI,QAAQ,CAAC,CAAC;IAErE,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,CAAC,SAAS,GAAG,eAAe,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,mBAAmB,CAAC,GAAG,CAAC;QAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACpE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAEvB,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC,CAAC,IAAI,GAAG,QAAQ,CAAC;QAClB,CAAC,CAAC,SAAS,GAAG,YAAY,CAAC;QAC3B,CAAC,CAAC,YAAY,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QACxC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC;QACpB,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,2EAA2E;IAC3E,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC;IAC9C,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,IAAI,MAAM,IAAI,MAAM,GAAG,CAAC;YAAE,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACvF,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,IAAI,MAAM,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QACzC,GAAG,EAAE,CAAC;IACR,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/features/inapp/surfaces/toolbar.d.ts

@@ -0,0 +1,8 @@
+/**
+ * S16 — Toolbar / Menu callout surface (P2.4). A compact callout anchored to a nav/toolbar/menu item
+ * ("New in menu", nav guidance). Non-blocking, anchored via the unified LiveAnchor. Structurally a
+ * lightweight popover with callout styling + a small pointer toward the item.
+ */
+import type { SurfaceInstance, SurfaceMountCtx } from './surface';
+export declare function toolbarSurface(ctx: SurfaceMountCtx): SurfaceInstance;
+//# sourceMappingURL=toolbar.d.ts.map

package/dist/features/inapp/surfaces/toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/surfaces/toolbar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAalE,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,CAuDpE"}

package/dist/features/inapp/surfaces/toolbar.js

@@ -0,0 +1,62 @@
+import { renderVariantBlocks } from './surface';
+import { LiveAnchor, specFromSelector } from '../anchor/controller';
+function anchorSelector(ctx) {
+    return ctx.variant.targeting?.element ?? ctx.variant.triggers.find((t) => (t.type === 'element' || t.type === 'hover') && t.match)?.match;
+}
+function preferredSide(ctx) {
+    const p = ctx.variant.surfaceOptions?.placement;
+    return p === 'top' || p === 'left' || p === 'right' ? p : 'bottom';
+}
+export function toolbarSurface(ctx) {
+    const { doc, variant } = ctx;
+    const selector = anchorSelector(ctx);
+    const root = doc.createElement('div');
+    root.className = 'scalebun-toolbar-callout';
+    root.setAttribute('role', variant.a11y?.role ?? 'dialog');
+    root.setAttribute('aria-label', variant.name);
+    root.style.position = 'absolute';
+    const body = doc.createElement('div');
+    body.className = 'scalebun-pop-body';
+    for (const node of renderVariantBlocks(ctx))
+        body.appendChild(node);
+    root.appendChild(body);
+    if (variant.dismiss?.xButton !== false) {
+        const x = doc.createElement('button');
+        x.type = 'button';
+        x.className = 'scalebun-x scalebun-pop-x';
+        x.setAttribute('aria-label', 'Dismiss');
+        x.textContent = '×';
+        x.addEventListener('click', () => ctx.requestClose('x'));
+        root.appendChild(x);
+    }
+    const anchor = selector
+        ? new LiveAnchor({
+            spec: specFromSelector(selector),
+            size: () => {
+                const r = root.getBoundingClientRect();
+                return { width: r.width || root.offsetWidth || 220, height: r.height || root.offsetHeight || 80 };
+            },
+            preferred: { side: preferredSide(ctx), align: 'center' },
+            offset: variant.surfaceOptions?.offset,
+            hooks: {
+                onReposition: (pos) => {
+                    root.style.top = `${pos.y}px`;
+                    root.style.left = `${pos.x}px`;
+                    root.setAttribute('data-placement', pos.placement.side);
+                },
+                onHeal: () => ctx.metrics?.recordAnchorRetry(),
+                onMiss: () => ctx.metrics?.recordFailedSelector(selector),
+                onLost: () => ctx.requestClose('auto'),
+            },
+        })
+        : null;
+    return {
+        el: root,
+        afterMount: () => anchor?.start(),
+        destroy: () => {
+            anchor?.stop();
+            root.remove();
+        },
+    };
+}
+//# sourceMappingURL=toolbar.js.map

package/dist/features/inapp/surfaces/toolbar.js.map

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

package/dist/features/inapp/surfaces/tour.d.ts

@@ -0,0 +1,14 @@
+/**
+ * S6 — Product Tour surface (P2.3). A sequenced, resumable, branching multi-step flow. Rather than
+ * reimplement the step machine, this drives the coach/ **TourEngine** — sequencing, anchor wait, the
+ * never-dead-end fallback ladder (anchor-fail → centered modal), advance conditions, durable resume,
+ * and branching all come from there. This surface only supplies the DOM: it maps the inapp tour steps
+ * to coach CoachSteps and renders each step as a coachmark card + spotlight (positioned via the
+ * unified LiveAnchor), with Back/Skip/Next controls and a progress indicator.
+ *
+ * Resume: the engine persists the current step index (localStorage, keyed by variant id), so a tour
+ * survives navigation/refresh and continues where the user left off.
+ */
+import type { SurfaceInstance, SurfaceMountCtx } from './surface';
+export declare function tourSurface(ctx: SurfaceMountCtx): SurfaceInstance;
+//# sourceMappingURL=tour.d.ts.map

package/dist/features/inapp/surfaces/tour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/surfaces/tour.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAwBlE,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,CA2LjE"}

package/dist/features/inapp/surfaces/tour.js

@@ -0,0 +1,199 @@
+import { TourEngine } from '../../coach/tour';
+import { resolveAnchor } from '../../coach/anchor';
+import { waitFor } from '../../coach/wait';
+import { ObserverHub } from '../../coach/observers';
+import { LiveAnchor, specFromSelector, selectorFromSpec } from '../anchor/controller';
+const key = (id) => `scalebun_inapp_tour_${id}`;
+function toCoachStep(s) {
+    const side = s.placement === 'top' || s.placement === 'left' || s.placement === 'right' ? s.placement : 'bottom';
+    return {
+        id: s.id,
+        anchor: s.anchor ? specFromSelector(s.anchor) : undefined,
+        title: s.title,
+        body: s.body,
+        placement: s.anchor ? { side, align: 'center' } : undefined,
+        advance: s.advance ?? 'next',
+        fallback: 'modal', // anchor-fail → centered card; never dead-ends
+    };
+}
+export function tourSurface(ctx) {
+    const { doc, variant } = ctx;
+    const steps = variant.surfaceOptions?.steps ?? [];
+    const hub = new ObserverHub();
+    const root = doc.createElement('div');
+    root.className = 'scalebun-tour-root';
+    let stepCleanup = () => { };
+    const paint = (rc) => {
+        const card = doc.createElement('div');
+        card.className = 'scalebun-coachmark scalebun-tour-card';
+        card.setAttribute('role', 'dialog');
+        card.setAttribute('aria-label', rc.step.title ?? variant.name);
+        card.style.position = rc.el ? 'absolute' : 'fixed';
+        if (rc.step.title) {
+            const h = doc.createElement('h2');
+            h.className = 'scalebun-h';
+            h.textContent = rc.step.title;
+            card.appendChild(h);
+        }
+        if (rc.step.body) {
+            const p = doc.createElement('p');
+            p.className = 'scalebun-text';
+            p.textContent = rc.step.body;
+            card.appendChild(p);
+        }
+        // nav row: progress · Back · Skip · Next/Done
+        const nav = doc.createElement('div');
+        nav.className = 'scalebun-tour-nav';
+        const prog = doc.createElement('span');
+        prog.className = 'scalebun-tour-prog';
+        prog.textContent = `${rc.index + 1} / ${rc.total}`;
+        nav.appendChild(prog);
+        const btns = doc.createElement('span');
+        btns.className = 'scalebun-tour-btns';
+        const mkBtn = (label, cls, fn) => {
+            const b = doc.createElement('button');
+            b.type = 'button';
+            b.className = `scalebun-btn ${cls}`;
+            b.textContent = label;
+            b.addEventListener('click', fn);
+            return b;
+        };
+        if (rc.index > 0)
+            btns.appendChild(mkBtn('Back', 'scalebun-btn-ghost', rc.controls.back));
+        btns.appendChild(mkBtn('Skip', 'scalebun-btn-ghost', rc.controls.skip));
+        btns.appendChild(mkBtn(rc.index + 1 >= rc.total ? 'Done' : 'Next', 'scalebun-btn-primary', rc.controls.next));
+        nav.appendChild(btns);
+        card.appendChild(nav);
+        // close (×)
+        const x = doc.createElement('button');
+        x.type = 'button';
+        x.className = 'scalebun-x scalebun-pop-x';
+        x.setAttribute('aria-label', 'End tour');
+        x.textContent = '×';
+        x.addEventListener('click', rc.controls.close);
+        card.appendChild(x);
+        root.appendChild(card);
+        let spot = null;
+        let anchor = null;
+        /**
+         * Drop to the centered presentation — the SAME shape a step gets when its anchor never
+         * resolved at all (the `else` branch below, and the engine's `fallback: 'modal'` ladder).
+         */
+        const degradeToCenter = () => {
+            anchor?.stop();
+            anchor = null;
+            spot?.remove();
+            spot = null;
+            card.style.position = 'fixed';
+            card.style.top = '';
+            card.style.left = '';
+            card.removeAttribute('data-placement');
+            card.classList.add('scalebun-tour-center');
+        };
+        if (rc.el && rc.step.anchor) {
+            const selector = selectorFromSpec(rc.step.anchor);
+            spot = doc.createElement('div');
+            spot.className = 'scalebun-coach-spot';
+            root.appendChild(spot);
+            const pad = 6;
+            anchor = new LiveAnchor({
+                spec: rc.step.anchor,
+                size: () => {
+                    const r = card.getBoundingClientRect();
+                    return { width: r.width || card.offsetWidth || 300, height: r.height || card.offsetHeight || 120 };
+                },
+                preferred: rc.step.placement,
+                hooks: {
+                    onReposition: (pos, el) => {
+                        card.style.top = `${pos.y}px`;
+                        card.style.left = `${pos.x}px`;
+                        card.setAttribute('data-placement', pos.placement.side);
+                        const a = el.getBoundingClientRect();
+                        spot.style.top = `${a.y - pad}px`;
+                        spot.style.left = `${a.x - pad}px`;
+                        spot.style.width = `${a.width + pad * 2}px`;
+                        spot.style.height = `${a.height + pad * 2}px`;
+                    },
+                    onHeal: () => ctx.metrics?.recordAnchorRetry(),
+                    // Name the selector that broke. This recorded an EMPTY STRING, so anchor-health collected
+                    // a row per failure that identified nothing — the one signal an author needs to find drift.
+                    onMiss: () => ctx.metrics?.recordFailedSelector(selector),
+                    /**
+                     * A vanished anchor DEGRADES the step; it does not skip it.
+                     *
+                     * This called `rc.controls.skip()`, which silently advanced past content the author wrote
+                     * — and it disagreed with the engine's own ladder: a step whose anchor never resolved is
+                     * still SHOWN, centered (`fallback: 'modal'`). Same failure, two behaviours, and the
+                     * destructive one fired only after the anchor had briefly worked, so it was invisible in
+                     * testing and only appeared once a customer's DOM changed.
+                     *
+                     * Now both paths land on the centered card, the failure is recorded against the real
+                     * selector, and it emits so the drift is visible in analytics rather than only in a
+                     * local metrics object.
+                     */
+                    onLost: (reason) => {
+                        degradeToCenter();
+                        ctx.metrics?.recordFailedSelector(selector);
+                        ctx.hooks.onInteraction(`anchor-lost:${reason}`);
+                    },
+                },
+            });
+            anchor.start();
+        }
+        else {
+            card.classList.add('scalebun-tour-center'); // anchorless/degraded → centered
+        }
+        return () => {
+            anchor?.stop();
+            spot?.remove();
+            card.remove();
+        };
+    };
+    const engine = new TourEngine({
+        hub,
+        resolveAnchor,
+        waitFor,
+        render: (rc) => {
+            stepCleanup();
+            stepCleanup = paint(rc);
+        },
+        hide: () => {
+            stepCleanup();
+            stepCleanup = () => { };
+        },
+        emit: (name) => ctx.hooks.onInteraction(name), // step lifecycle → analytics
+        now: () => Date.now(),
+        persist: (id, i) => {
+            try {
+                if (i < 0)
+                    localStorage.removeItem(key(id));
+                else
+                    localStorage.setItem(key(id), String(i));
+            }
+            catch {
+                /* storage disabled */
+            }
+        },
+        loadIndex: (id) => {
+            try {
+                const v = localStorage.getItem(key(id));
+                return v != null ? Number(v) : undefined;
+            }
+            catch {
+                return undefined;
+            }
+        },
+    });
+    const tourSpec = { id: variant.id, version: 1, steps: steps.map(toCoachStep) };
+    return {
+        el: root,
+        afterMount: () => engine.start(tourSpec, { resume: true }),
+        destroy: () => {
+            stepCleanup();
+            engine.dispose();
+            hub.dispose();
+            root.remove();
+        },
+    };
+}
+//# sourceMappingURL=tour.js.map

package/dist/features/inapp/surfaces/tour.js.map

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

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

@@ -0,0 +1,163 @@
+/**
+ * In-App Messaging 2.0 — shared type foundation.
+ *
+ * These are the schema-driven contract *types* for the web-native IAM engine (spec:
+ * docs/WEB-IN-APP-MESSAGING-2.0-SPEC.md §7.1, §C). Everything downstream — registry rows, the
+ * renderer, the targeting engine, the Orchestrator — speaks this vocabulary. Variants are **pure
+ * data** over these types; no renderer ever switches on a variant id.
+ *
+ * Zero runtime: types only. The runtime enumerations + validators live in `inappContract.web.ts`.
+ */
+/** Platforms a variant may target. Web is now a first-class member of the shared registry. */
+export type Platform = 'web' | 'ios' | 'android';
+/** The 20 catalog categories (Task 2). Drives the implicit priority category-boost (§8.2). */
+export type Category = 'announcement' | 'release_notes' | 'feature_discovery' | 'onboarding' | 'coachmark' | 'survey_feedback' | 'nps' | 'upsell' | 'billing' | 'security' | 'system' | 'retention' | 'education' | 'social_proof' | 'ai_assist' | 'navigation' | 'checklist' | 'changelog' | 'empty_state' | 'misc';
+/** The 16 web-native render surfaces. A variant names exactly one; the renderer lazy-loads it. */
+export type Surface = 'modal' | 'slideover' | 'panel' | 'popover' | 'coachmark' | 'tour' | 'hotspot' | 'inline' | 'banner' | 'toast' | 'center' | 'launcher' | 'palette' | 'checklist' | 'takeover' | 'toolbar';
+/** Finite screen real-estate slots the Orchestrator arbitrates. Each surface maps to one zone. */
+export type Zone = 'takeover' | 'modal' | 'top-banner' | 'bottom-banner' | 'toast' | 'side-right' | 'side-left' | 'anchored' | 'launcher' | 'palette' | 'center' | `inline:${string}`;
+/** How aggressively a surface seizes the user's focus — drives mutual-exclusion rules. */
+export type FocusClass = 'focus-stealing' | 'ambient' | 'on-demand' | 'in-flow' | 'none';
+export type PriorityTier = 'critical' | 'high' | 'normal' | 'low' | 'passive';
+export type BlockKind = 'heading' | 'text' | 'richtext' | 'markdown' | 'image' | 'illustration' | 'video' | 'lottie' | 'code' | 'playground' | 'embed' | 'chart' | 'sparkline' | 'stat' | 'table' | 'countdown' | 'carousel' | 'qr' | 'confetti' | 'product-grid' | 'spinwheel' | 'scratch' | 'slot' | 'streak' | 'form' | 'nps' | 'rating' | 'poll' | 'quiz' | 'emoji' | 'steps' | 'checklist' | 'progress' | 'timeline' | 'list' | 'feature-grid' | 'plan-cards' | 'cta' | 'shortcut' | 'avatar' | 'testimonial' | 'social-proof' | 'callout' | 'badge' | 'divider' | 'spacer';
+/** A single ordered block. `props` is block-kind-specific and validated by the block renderer. */
+export interface ContentBlock {
+    kind: BlockKind;
+    /** Block-specific configuration (text content, src, cta actions, …). Kept loose at the type
+     *  layer; each block renderer narrows + validates its own props. */
+    props?: Record<string, unknown>;
+}
+export type TriggerType = 'manual' | 'route' | 'event' | 'idle' | 'element' | 'hover' | 'selection' | 'keyboard' | 'right-click' | 'schedule' | 'no-data' | 'exit-intent';
+export interface TriggerRef {
+    type: TriggerType;
+    /** For route: path/glob. For event: event name. For element/hover/selection: CSS selector.
+     *  For keyboard: a key combo. For schedule: an ISO window. Interpretation is per-type. */
+    match?: string;
+    /** For idle: milliseconds. For element: visibility ratio ×100. Generic numeric arg. */
+    arg?: number;
+}
+export interface TargetingRule {
+    /** Audience predicate expression (segment id or attribute filter). Opaque to the SDK core;
+     *  evaluated by the targeting engine against the local user profile. */
+    audience?: string;
+    /** Route allow-list (globs). Empty ⇒ any route. */
+    route?: string[];
+    /** CSS selector that must resolve for element-anchored surfaces. */
+    element?: string;
+    /** Requires a live text selection (for selection-triggered assist). */
+    selection?: boolean;
+    /** Minimum viewport width (px) — desktop-only surfaces gate here. */
+    minViewport?: number;
+}
+/** One step of a Product Tour (S6). Maps to a coach `CoachStep` at mount. */
+export interface TourStep {
+    id: string;
+    /** CSS selector for the step's anchor. Omit for a centered (anchorless) step. */
+    anchor?: string;
+    title?: string;
+    body?: string;
+    placement?: 'top' | 'bottom' | 'left' | 'right';
+    /** How the step advances. Default 'next' (the Next button). */
+    advance?: 'next' | 'anchor-click';
+}
+/** One entry in a Command Palette (S13). */
+export interface PaletteCommand {
+    id: string;
+    label: string;
+    /** Right-aligned hint (e.g. a shortcut or section). */
+    hint?: string;
+    /** Action key routed to the host on select. */
+    action: string;
+    /** Optional deep link / value for the action. */
+    value?: string;
+}
+export interface SurfaceOptions {
+    placement?: 'center' | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    size?: 'sm' | 'md' | 'lg' | 'xl' | 'full';
+    resizable?: boolean;
+    pinnable?: boolean;
+    dockable?: boolean;
+    backdrop?: boolean;
+    spotlight?: boolean;
+    offset?: number;
+    maxWidth?: number;
+    /** Host slot id for inline (S8) surfaces → resolves the `inline:<slot>` zone. */
+    slot?: string;
+    /** Sequenced steps for a Product Tour (S6). */
+    steps?: TourStep[];
+    /** Commands for a Command Palette (S13). */
+    commands?: PaletteCommand[];
+}
+export interface FrequencyRule {
+    showOnce?: boolean;
+    maxImpressions?: number;
+    /** Milliseconds between eligible re-shows. */
+    cooldown?: number;
+    snoozable?: boolean;
+}
+export interface DismissRule {
+    escClose?: boolean;
+    backdropClose?: boolean;
+    xButton?: boolean;
+    autoDismissMs?: number;
+    remindLater?: boolean;
+    /** Persist the dismissal across sessions (localStorage) vs session-only. */
+    persistDismiss?: boolean;
+}
+export type MotionName = 'none' | 'fade' | 'scale' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right' | 'pop';
+export interface MotionSpec {
+    enter?: MotionName;
+    exit?: MotionName;
+    /** Fallback when prefers-reduced-motion — must be opacity-only or 'none'. */
+    reducedMotionFallback?: 'fade' | 'none';
+}
+export interface A11ySpec {
+    role?: 'dialog' | 'alertdialog' | 'region' | 'status' | 'complementary' | 'menu';
+    labelledBy?: string;
+    describedBy?: string;
+    focusTrap?: boolean;
+    liveRegion?: 'off' | 'polite' | 'assertive';
+    restoreFocus?: boolean;
+}
+export interface AnalyticsSpec {
+    /** Custom event name overrides; defaults derive from surface + variant id. */
+    impression?: string;
+    conversion?: string;
+    /** Additional interaction events this variant emits (e.g. 'step_next'). */
+    interaction?: string[];
+}
+export interface VariantContract {
+    /** Blocks this variant's surface requires to render meaningfully (client-guard check). */
+    requiredBlocks?: BlockKind[];
+    sdkMinVersion?: string;
+    payloadVersion?: number;
+    /** Block-prop keys that are preview-only and must be STRIPPED from the served payload
+     *  (e.g. a quiz answer key). Server-authoritative outcomes (§P4.2). */
+    previewOnlyFields?: string[];
+}
+export interface Variant {
+    id: string;
+    key: string;
+    name: string;
+    descriptor?: string;
+    category: Category;
+    platforms: Platform[];
+    surface: Surface;
+    surfaceOptions?: SurfaceOptions;
+    blocks: ContentBlock[];
+    priority: PriorityTier;
+    triggers: TriggerRef[];
+    targeting?: TargetingRule;
+    frequency?: FrequencyRule;
+    dismiss?: DismissRule;
+    a11y?: A11ySpec;
+    motion?: MotionSpec;
+    analytics?: AnalyticsSpec;
+    contract?: VariantContract;
+}
+/** The canonical registry shape (vendored verbatim SDK/dashboard/backend, guarded by sha256). */
+export interface InAppRegistry {
+    version: number;
+    variants: Variant[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/features/inapp/types.js

@@ -0,0 +1,12 @@
+/**
+ * In-App Messaging 2.0 — shared type foundation.
+ *
+ * These are the schema-driven contract *types* for the web-native IAM engine (spec:
+ * docs/WEB-IN-APP-MESSAGING-2.0-SPEC.md §7.1, §C). Everything downstream — registry rows, the
+ * renderer, the targeting engine, the Orchestrator — speaks this vocabulary. Variants are **pure
+ * data** over these types; no renderer ever switches on a variant id.
+ *
+ * Zero runtime: types only. The runtime enumerations + validators live in `inappContract.web.ts`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/inapp/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/features/inbox/InboxFeature.d.ts

@@ -0,0 +1,57 @@
+/**
+ * F-INBOX — Persistent Message Inbox (eager shell). Kept intentionally tiny (subscription hub + lazy
+ * loader) so it costs ~nothing against the 28 KB core gate; the model/store/sync live in the lazy
+ * runtime chunk (loaded on first inbox() use). Mirrors the EngageFeature shell→ensureRuntime pattern.
+ *
+ * A1.1: wires the headless controller against an in-memory runtime. A1.2 adds the IndexedDB store,
+ * A1.3 the delta sync, A1.4 the sync triggers + consent gate — none change this shell's surface.
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+import type { InboxController } from './types';
+export declare class InboxFeature implements IFeature {
+    readonly name = "inbox";
+    private ctx;
+    private active;
+    private runtime?;
+    private syncEngine?;
+    private loading?;
+    private widget?;
+    /** Last dashboard-authored theme seen on a sync. Kept so a remount reapplies it without waiting
+     *  for the next round trip, and so a theme that lands AFTER mount is not lost. */
+    private remoteTheme?;
+    private mountOpts?;
+    private stateSubs;
+    private unreadSubs;
+    private pendingCta;
+    private lastState;
+    private controllerRef;
+    private onVisible?;
+    private onAttention?;
+    private onSwMessage?;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): void;
+    /** Sync only if the runtime is already loaded (a passive trigger never forces the lazy chunk). */
+    private triggerSync;
+    /**
+     * Apply a dashboard-authored theme that arrived on a sync.
+     *
+     * ⚠️ Remounts only when the theme ACTUALLY CHANGED. `sync()` runs on every focus and reconnect and
+     * the response carries the theme each time, so remounting unconditionally would tear down and
+     * rebuild the panel — closing it under the user's cursor — several times a session.
+     *
+     * ⚠️ A remount reuses the ORIGINAL `mount()` options, so the host's placement survives. Losing
+     * `trigger` here would silently detach the host's own bell.
+     */
+    private applyTheme;
+    /** Force a pull now, loading the runtime if needed (used by the live push→inbox delivery poke). */
+    private refreshNow;
+    private pushState;
+    private ensureRuntime;
+    /** Forward a runtime method by name once the lazy chunk resolves (compact — keeps the eager shell
+     *  small against the core gate). `void`-returning methods tolerate an undefined result pre-load. */
+    private call;
+    /** Stable headless controller (cached). Returned by the facade's `ScaleBun.inbox()`. */
+    controller(): InboxController;
+    teardown(): void;
+}
+//# sourceMappingURL=InboxFeature.d.ts.map

package/dist/features/inbox/InboxFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboxFeature.d.ts","sourceRoot":"","sources":["../../../src/features/inbox/InboxFeature.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAKxE,OAAO,KAAK,EACV,eAAe,EAChB,MAAM,SAAS,CAAC;AAIjB,qBAAa,YAAa,YAAW,QAAQ;IAC3C,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAY;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAoC;IACpD,OAAO,CAAC,MAAM,CAAC,CAAoB;IACnC;sFACkF;IAClF,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,SAAS,CAAC,CAAoB;IAGtC,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,UAAU,CAAkD;IACpE,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,SAAS,CAAC,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,WAAW,CAAC,CAA4B;IAEhD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IA+BhC,kGAAkG;IAClG,OAAO,CAAC,WAAW;IAInB;;;;;;;;;OASG;IACH,OAAO,CAAC,UAAU;IAWlB,mGAAmG;IACnG,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,SAAS,CAOf;IAEF,OAAO,CAAC,aAAa;IAgCrB;wGACoG;IACpG,OAAO,CAAC,IAAI;IAIZ,wFAAwF;IACxF,UAAU,IAAI,eAAe;IA+C7B,QAAQ,IAAI,IAAI;CAqBjB"}