@scalebun/web 1.0.0

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

@@ -0,0 +1,19 @@
+/**
+ * IAM 2.0 shared surface mount lifecycle (P1.2+).
+ *
+ * `mountSurface` owns the parts every surface shares: adopt the block+surface CSS once, resolve the
+ * zone, run the surface renderer, place it, fire the impression, arm the real-view observer, and give
+ * back a handle whose `close(method)` tears down + records the dismiss exactly once. Surfaces stay
+ * tiny — they only build their own chrome and call `requestClose` when the user dismisses.
+ */
+import type { Variant } from '../types';
+import type { ShadowHost } from '../core/host';
+import type { DismissMethod } from '../core/analytics';
+import { type AnchorMetricsSink, type SurfaceHooks, type SurfaceRenderer } from './surface';
+export interface MountedSurface {
+    variantId: string;
+    el: HTMLElement;
+    close(method: DismissMethod): void;
+}
+export declare function mountSurface(host: ShadowHost, variant: Variant, renderer: SurfaceRenderer, hooks: SurfaceHooks, metrics?: AnchorMetricsSink): MountedSurface;
+//# sourceMappingURL=mount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/surfaces/mount.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,OAAO,EAAe,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAA8C,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAErJ,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,WAAW,CAAC;IAChB,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CACpC;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,cAAc,CA0BhB"}

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

@@ -0,0 +1,29 @@
+import { zoneForVariant } from '../inappContract.web';
+import { BLOCKS_CSS } from '../blocks/styles';
+import { SURFACES_CSS } from './styles';
+import { observeView } from './surface';
+export function mountSurface(host, variant, renderer, hooks, metrics) {
+    host.addStyles('scalebun-blocks', BLOCKS_CSS);
+    host.addStyles('scalebun-surfaces', SURFACES_CSS);
+    const zone = host.zone(zoneForVariant(variant));
+    const doc = zone.ownerDocument;
+    let inst = null;
+    let disposeView = () => { };
+    let closed = false;
+    const close = (method) => {
+        if (closed || !inst)
+            return;
+        closed = true;
+        disposeView();
+        hooks.onDismiss(method);
+        inst.destroy();
+    };
+    const ctx = { variant, host, doc, hooks, requestClose: close, metrics };
+    inst = renderer(ctx);
+    zone.appendChild(inst.el);
+    inst.afterMount?.();
+    hooks.onImpression();
+    disposeView = observeView(inst.el, hooks.onView);
+    return { variantId: variant.id, el: inst.el, close };
+}
+//# sourceMappingURL=mount.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mount.js","sourceRoot":"","sources":["../../../../src/features/inapp/surfaces/mount.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,WAAW,EAA+G,MAAM,WAAW,CAAC;AAQrJ,MAAM,UAAU,YAAY,CAC1B,IAAgB,EAChB,OAAgB,EAChB,QAAyB,EACzB,KAAmB,EACnB,OAA2B;IAE3B,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC;IAE/B,IAAI,IAAI,GAA2B,IAAI,CAAC;IACxC,IAAI,WAAW,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;IACvC,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,MAAM,KAAK,GAAG,CAAC,MAAqB,EAAQ,EAAE;QAC5C,IAAI,MAAM,IAAI,CAAC,IAAI;YAAE,OAAO;QAC5B,MAAM,GAAG,IAAI,CAAC;QACd,WAAW,EAAE,CAAC;QACd,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACxB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,GAAG,GAAoB,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACzF,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACrB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;IACpB,KAAK,CAAC,YAAY,EAAE,CAAC;IACrB,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEjD,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;AACvD,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * S13 — Command Palette surface (P3.4). A ⌘K-style centered overlay: a search box + a filtered,
+ * keyboard-navigable command list. On-demand focus (semi-blocking): it focuses the input and traps
+ * Esc/Enter/arrows, but doesn't inert the whole app. Commands come from the variant's
+ * surfaceOptions.commands; selecting one routes an action to the host (and follows a deep link).
+ */
+import type { SurfaceInstance, SurfaceMountCtx } from './surface';
+export declare function paletteSurface(ctx: SurfaceMountCtx): SurfaceInstance;
+//# sourceMappingURL=palette.d.ts.map

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

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

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

@@ -0,0 +1,127 @@
+import { trapFocus, captureFocus } from '../a11y/focus';
+export function paletteSurface(ctx) {
+    const { doc, variant } = ctx;
+    const commands = variant.surfaceOptions?.commands ?? [];
+    const restoreFocus = captureFocus(doc);
+    const root = doc.createElement('div');
+    root.className = 'scalebun-palette-backdrop';
+    const box = doc.createElement('div');
+    box.className = 'scalebun-palette';
+    box.setAttribute('role', 'dialog');
+    box.setAttribute('aria-label', variant.name);
+    const input = doc.createElement('input');
+    input.className = 'scalebun-palette-input';
+    input.type = 'text';
+    input.setAttribute('role', 'combobox');
+    input.setAttribute('aria-expanded', 'true');
+    input.placeholder = 'Type a command or search…';
+    box.appendChild(input);
+    const list = doc.createElement('ul');
+    list.className = 'scalebun-palette-list';
+    list.setAttribute('role', 'listbox');
+    box.appendChild(list);
+    root.appendChild(box);
+    let filtered = commands.slice();
+    let active = 0;
+    const activate = (cmd) => {
+        if (!cmd)
+            return;
+        ctx.hooks.onCtaClick(cmd.action);
+        ctx.hooks.onInteraction(`palette_select:${cmd.id}`);
+        if (cmd.action === 'link' && cmd.value) {
+            try {
+                if (typeof window !== 'undefined')
+                    window.location.assign(cmd.value);
+            }
+            catch {
+                /* nav blocked */
+            }
+        }
+        ctx.requestClose('cta');
+    };
+    const renderList = () => {
+        list.replaceChildren();
+        if (filtered.length === 0) {
+            const li = doc.createElement('li');
+            li.className = 'scalebun-palette-empty';
+            li.textContent = 'No matches';
+            list.appendChild(li);
+            return;
+        }
+        filtered.forEach((cmd, i) => {
+            const li = doc.createElement('li');
+            li.className = 'scalebun-palette-item' + (i === active ? ' active' : '');
+            li.setAttribute('role', 'option');
+            li.setAttribute('aria-selected', String(i === active));
+            const label = doc.createElement('span');
+            label.className = 'scalebun-palette-label';
+            label.textContent = cmd.label;
+            li.appendChild(label);
+            if (cmd.hint) {
+                const hint = doc.createElement('span');
+                hint.className = 'scalebun-palette-hint';
+                hint.textContent = cmd.hint;
+                li.appendChild(hint);
+            }
+            li.addEventListener('mousemove', () => {
+                active = i;
+                paint();
+            });
+            li.addEventListener('click', () => activate(cmd));
+            list.appendChild(li);
+        });
+    };
+    const paint = () => {
+        Array.from(list.children).forEach((li, i) => {
+            li.classList.toggle('active', i === active);
+            li.setAttribute('aria-selected', String(i === active));
+        });
+    };
+    const filter = () => {
+        const q = input.value.trim().toLowerCase();
+        filtered = q ? commands.filter((c) => c.label.toLowerCase().includes(q) || c.action.toLowerCase().includes(q)) : commands.slice();
+        active = 0;
+        renderList();
+    };
+    input.addEventListener('input', filter);
+    const onKey = (e) => {
+        if (e.key === 'Escape') {
+            e.stopPropagation();
+            ctx.requestClose('esc');
+        }
+        else if (e.key === 'ArrowDown') {
+            e.preventDefault();
+            active = Math.min(filtered.length - 1, active + 1);
+            paint();
+        }
+        else if (e.key === 'ArrowUp') {
+            e.preventDefault();
+            active = Math.max(0, active - 1);
+            paint();
+        }
+        else if (e.key === 'Enter') {
+            e.preventDefault();
+            activate(filtered[active]);
+        }
+    };
+    box.addEventListener('keydown', onKey);
+    if (variant.dismiss?.backdropClose !== false) {
+        root.addEventListener('mousedown', (e) => {
+            if (e.target === root)
+                ctx.requestClose('backdrop');
+        });
+    }
+    const releaseTrap = trapFocus(box, doc);
+    renderList();
+    return {
+        el: root,
+        afterMount: () => input.focus(),
+        destroy: () => {
+            releaseTrap();
+            box.removeEventListener('keydown', onKey);
+            root.remove();
+            restoreFocus();
+        },
+    };
+}
+//# sourceMappingURL=palette.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * S3 — Docked side panel + AI assistant shell (P3.5). A persistent left/right rail hosting a chat
+ * thread + composer. Ambient (never steals focus). The SDK provides the SHELL and the streaming
+ * plumbing only — the host wires the model: on submit it emits `ai_prompt:<text>`, and the engine/host
+ * streams the answer back via `appendAssistant(token)` / `endAssistant()` exposed on the root element.
+ * (No LLM ships in the SDK.)
+ */
+import type { SurfaceInstance, SurfaceMountCtx } from './surface';
+export interface PanelStreamApi {
+    appendAssistant(token: string): void;
+    endAssistant(): void;
+}
+export declare function panelSurface(ctx: SurfaceMountCtx): SurfaceInstance;
+//# sourceMappingURL=panel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/surfaces/panel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,YAAY,IAAI,IAAI,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,CA+FlE"}

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

@@ -0,0 +1,91 @@
+export function panelSurface(ctx) {
+    const { doc, variant } = ctx;
+    const left = variant.surfaceOptions?.placement === 'left';
+    const root = doc.createElement('div');
+    root.className = 'scalebun-panel ' + (left ? 'scalebun-panel-left' : 'scalebun-panel-right');
+    root.setAttribute('role', variant.a11y?.role ?? 'complementary');
+    root.setAttribute('aria-label', variant.name);
+    // header
+    const header = doc.createElement('div');
+    header.className = 'scalebun-panel-head';
+    const title = doc.createElement('div');
+    title.className = 'scalebun-panel-title';
+    title.textContent = variant.name;
+    header.appendChild(title);
+    if (variant.dismiss?.xButton !== false) {
+        const x = doc.createElement('button');
+        x.type = 'button';
+        x.className = 'scalebun-x';
+        x.setAttribute('aria-label', 'Close panel');
+        x.textContent = '×';
+        x.addEventListener('click', () => ctx.requestClose('x'));
+        header.appendChild(x);
+    }
+    root.appendChild(header);
+    // thread
+    const thread = doc.createElement('div');
+    thread.className = 'scalebun-panel-thread';
+    thread.setAttribute('role', 'log');
+    thread.setAttribute('aria-live', 'polite');
+    root.appendChild(thread);
+    const greeting = variant.blocks.find((b) => b.kind === 'text')?.props?.text;
+    if (typeof greeting === 'string')
+        addBubble('assistant', greeting);
+    // composer
+    const composer = doc.createElement('form');
+    composer.className = 'scalebun-panel-composer';
+    const input = doc.createElement('textarea');
+    input.className = 'scalebun-panel-input';
+    input.rows = 1;
+    input.placeholder = 'Ask anything…';
+    const send = doc.createElement('button');
+    send.type = 'submit';
+    send.className = 'scalebun-btn scalebun-btn-primary scalebun-panel-send';
+    send.textContent = 'Send';
+    composer.append(input, send);
+    root.appendChild(composer);
+    let streaming = null;
+    function addBubble(role, text) {
+        const b = doc.createElement('div');
+        b.className = `scalebun-bubble scalebun-bubble-${role}`;
+        b.textContent = text;
+        thread.appendChild(b);
+        thread.scrollTop = thread.scrollHeight;
+        return b;
+    }
+    const submit = (e) => {
+        e.preventDefault();
+        const text = input.value.trim();
+        if (!text)
+            return;
+        addBubble('user', text);
+        input.value = '';
+        ctx.hooks.onInteraction(`ai_prompt:${text}`);
+        // open an empty assistant bubble the host can stream into
+        streaming = addBubble('assistant', '');
+        streaming.classList.add('streaming');
+    };
+    composer.addEventListener('submit', submit);
+    // Streaming API exposed on the element for the host/engine to drive.
+    const stream = {
+        appendAssistant: (token) => {
+            if (!streaming)
+                streaming = addBubble('assistant', '');
+            streaming.textContent = (streaming.textContent ?? '') + token;
+            thread.scrollTop = thread.scrollHeight;
+        },
+        endAssistant: () => {
+            streaming?.classList.remove('streaming');
+            streaming = null;
+        },
+    };
+    root.scalebunStream = stream;
+    return {
+        el: root,
+        destroy: () => {
+            composer.removeEventListener('submit', submit);
+            root.remove();
+        },
+    };
+}
+//# sourceMappingURL=panel.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * S4 — Anchored popover surface (P1.6, unified with coach/ in P2.1). Attaches to a DOM element using
+ * the LiveAnchor controller: multi-strategy self-healing resolution + a shared MutationObserver that
+ * re-finds the anchor as the SPA/virtualized DOM churns + arrow-aware flip/shift positioning. If the
+ * anchor vanishes and can't be re-found within the grace window, the popover degrades gracefully
+ * (closes) rather than floating in a dead spot. Ambient (never steals focus).
+ */
+import type { SurfaceInstance, SurfaceMountCtx } from './surface';
+export declare function popoverSurface(ctx: SurfaceMountCtx): SurfaceInstance;
+//# sourceMappingURL=popover.d.ts.map

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

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

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

@@ -0,0 +1,66 @@
+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 popoverSurface(ctx) {
+    const { doc, variant } = ctx;
+    const selector = anchorSelector(ctx);
+    const root = doc.createElement('div');
+    root.className = 'scalebun-popover';
+    root.setAttribute('role', variant.a11y?.role ?? 'dialog');
+    root.setAttribute('aria-label', variant.name);
+    root.style.position = 'absolute';
+    const maxW = variant.surfaceOptions?.maxWidth;
+    if (maxW)
+        root.style.maxWidth = `${maxW}px`;
+    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 body = doc.createElement('div');
+    body.className = 'scalebun-pop-body';
+    for (const node of renderVariantBlocks(ctx))
+        body.appendChild(node);
+    root.appendChild(body);
+    const anchor = selector
+        ? new LiveAnchor({
+            spec: specFromSelector(selector),
+            size: () => {
+                const r = root.getBoundingClientRect();
+                return { width: r.width || root.offsetWidth || 320, height: r.height || root.offsetHeight || 120 };
+            },
+            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(), // anchor-health telemetry (§10)
+                onMiss: () => ctx.metrics?.recordFailedSelector(selector),
+                // Graceful fallback (P2.1 exit criterion): anchor gone past grace → don't float; degrade.
+                onLost: () => ctx.requestClose('auto'),
+            },
+        })
+        : null;
+    return {
+        el: root,
+        afterMount: () => anchor?.start(),
+        destroy: () => {
+            anchor?.stop();
+            root.remove();
+        },
+    };
+}
+//# sourceMappingURL=popover.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * IAM 2.0 headless renderer (P1.6/P1.7) — the registry-driven mount entry point.
+ *
+ * `SURFACE_LOADERS` maps a surface to a **lazy import** of its renderer; `renderVariant` picks the
+ * loader by `variant.surface`, imports exactly that chunk, and mounts it. This is the "no renderer
+ * switch on variant id" contract in code: adding a surface = one registry row + one chunk; the engine
+ * and every framework adapter call this same function. Pay-per-capability bundling falls out for free
+ * (a page that only shows a toast never downloads the modal/popover code).
+ */
+import type { Surface, Variant } from '../types';
+import type { ShadowHost } from '../core/host';
+import type { SlotRegistry } from '../core/slots';
+import type { AnchorMetricsSink, SurfaceHooks, SurfaceRenderer } from './surface';
+export declare const SURFACE_LOADERS: Partial<Record<Surface, () => Promise<SurfaceRenderer>>>;
+export interface RenderDeps {
+    host: ShadowHost;
+    slots?: SlotRegistry;
+    /** Optional anchor-health sink (satisfied by the engine's SelfMetrics). */
+    metrics?: AnchorMetricsSink;
+}
+/** A live surface the caller can close. `close()` records the dismiss + tears down. */
+export interface RenderedSurface {
+    variantId: string;
+    close(): void;
+}
+/** True if a surface has a renderer available (built + registered). */
+export declare function isSurfaceSupported(surface: Surface): boolean;
+/**
+ * Lazy-load the right surface and mount the variant. Returns a handle to close it. Unsupported
+ * surfaces (not yet built) resolve to an inert handle rather than throwing — the engine logs and
+ * moves on.
+ */
+export declare function renderVariant(variant: Variant, hooks: SurfaceHooks, deps: RenderDeps): Promise<RenderedSurface>;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/surfaces/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIlF,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC,CAgBpF,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED,uFAAuF;AACvF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAmBrH"}

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

@@ -0,0 +1,52 @@
+import { mountSurface } from './mount';
+import { ensureHeavyBlocks } from '../blocks/heavy';
+export const SURFACE_LOADERS = {
+    banner: () => import('./banner').then((m) => m.bannerSurface),
+    toast: () => import('./toast').then((m) => m.toastSurface),
+    modal: () => import('./modal').then((m) => m.modalSurface),
+    slideover: () => import('./slideover').then((m) => m.slideoverSurface),
+    popover: () => import('./popover').then((m) => m.popoverSurface),
+    coachmark: () => import('./coachmark').then((m) => m.coachmarkSurface),
+    tour: () => import('./tour').then((m) => m.tourSurface),
+    hotspot: () => import('./hotspot').then((m) => m.hotspotSurface),
+    toolbar: () => import('./toolbar').then((m) => m.toolbarSurface),
+    palette: () => import('./palette').then((m) => m.paletteSurface),
+    panel: () => import('./panel').then((m) => m.panelSurface),
+    checklist: () => import('./checklist').then((m) => m.checklistSurface),
+    takeover: () => import('./takeover').then((m) => m.takeoverSurface),
+    launcher: () => import('./launcher').then((m) => m.launcherSurface),
+    // 'center' (S11) mounts via center/panel.mountCenterPanel, not the surface renderer.
+};
+/** True if a surface has a renderer available (built + registered). */
+export function isSurfaceSupported(surface) {
+    return surface === 'inline' || surface in SURFACE_LOADERS;
+}
+/**
+ * Lazy-load the right surface and mount the variant. Returns a handle to close it. Unsupported
+ * surfaces (not yet built) resolve to an inert handle rather than throwing — the engine logs and
+ * moves on.
+ */
+export async function renderVariant(variant, hooks, deps) {
+    // Load any lazy/heavy block chunks THIS variant uses (spinwheel, scratch, carousel, countdown,
+    // chart, video, …) before mounting — otherwise renderBlocks silently skips an unregistered block
+    // and the surface paints with the block missing (e.g. a spin-wheel modal shows no wheel). Idempotent
+    // + per-block resilient; runs in parallel with the surface chunk. Kinds are pulled from the variant.
+    const heavy = ensureHeavyBlocks((variant.blocks ?? []).map((b) => b.kind));
+    if (variant.surface === 'inline') {
+        if (!deps.slots)
+            return inert(variant.id);
+        const [{ mountInline }] = await Promise.all([import('./inline'), heavy]);
+        const inline = mountInline(deps.slots, variant, hooks);
+        return { variantId: variant.id, close: () => inline.close() };
+    }
+    const loader = SURFACE_LOADERS[variant.surface];
+    if (!loader)
+        return inert(variant.id);
+    const [renderer] = await Promise.all([loader(), heavy]);
+    const mounted = mountSurface(deps.host, variant, renderer, hooks, deps.metrics);
+    return { variantId: variant.id, close: () => mounted.close('x') };
+}
+function inert(variantId) {
+    return { variantId, close: () => { } };
+}
+//# sourceMappingURL=render.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../../src/features/inapp/surfaces/render.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAuB,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,eAAe,GAA6D;IACvF,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;IAC7D,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1D,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1D,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACtE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IAChE,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACtE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IACvD,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IAChE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IAChE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IAChE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1D,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACtE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;IACnE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;IACnE,qFAAqF;CACtF,CAAC;AAeF,uEAAuE;AACvE,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,eAAe,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAgB,EAAE,KAAmB,EAAE,IAAgB;IACzF,+FAA+F;IAC/F,iGAAiG;IACjG,qGAAqG;IACrG,qGAAqG;IACrG,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3E,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACvD,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtC,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAmB,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAChG,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,KAAK,CAAC,SAAiB;IAC9B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * S2 — Slide-over panel surface (P1.4). Right/left overlay panel: changelog, wizard, details.
+ * Ambient (never steals focus). Resizable via a drag handle (width persists per variant) and
+ * pinnable (a pinned panel opts out of outside-click dismissal). Overlay mode by construction — it
+ * lives in the fixed shadow layer, so it never reflows the host document.
+ */
+import type { SurfaceInstance, SurfaceMountCtx } from './surface';
+export declare function slideoverSurface(ctx: SurfaceMountCtx): SurfaceInstance;
+//# sourceMappingURL=slideover.d.ts.map

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

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