@scalebun/web 1.0.0

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

@@ -0,0 +1,77 @@
+/**
+ * IAM 2.0 Engagement Orchestrator (spec §8, P0.5) — attention as a scheduled resource.
+ *
+ * `decide()` is a **pure function**: same (candidates, occupants, budget, ctx) → same decisions. It is
+ * the window manager for attention. Nothing renders by "appearing"; every eligible+triggered candidate
+ * passes the deterministic pipeline (§8.5) and gets exactly one verdict:
+ *   SHOW | QUEUE(until safe) | DEFER(context) | DROP(reason) | PREEMPT(loser)
+ * Every decision carries a reason so §10 can observe/replay-correlate the full arbitration.
+ *
+ * The reference fixture (§8.8) — critical banner + tour + toast + AI panel + checklist, all live —
+ * is enforced by orchestrator.test.ts as a deterministic snapshot.
+ */
+import type { Category, FocusClass, PriorityTier, Zone } from '../types';
+export type Action = 'SHOW' | 'QUEUE' | 'DEFER' | 'DROP' | 'PREEMPT';
+/** A fully-resolved candidate — the engine fills zone/focus/cost/tier from the contract maps so
+ *  `decide` stays a pure function of its arguments (no table lookups, no DOM). */
+export interface Candidate {
+    id: string;
+    campaignId?: string;
+    zone: Zone;
+    focus: FocusClass;
+    /** attention cost (§8.3). 0 ⇒ ambient/passive (spends no budget). */
+    cost: number;
+    tier: PriorityTier;
+    category: Category;
+    /** author campaign priority 0..100 (§8.2). */
+    campaignPriority?: number;
+    /** never auto-interrupt — opens only on user action (AI panel, palette, launcher). */
+    interactionOnly?: boolean;
+    /** guidance surface (tour/coachmark/hotspot) — deferred while an alert is live (§8.5). */
+    guidance?: boolean;
+    triggeredAt: number;
+}
+export interface Occupant {
+    id: string;
+    zone: Zone;
+    focus: FocusClass;
+    tier: PriorityTier;
+}
+export interface Budget {
+    /** remaining attention tokens in the current rolling window. */
+    tokens: number;
+    interruptionsThisSession: number;
+    maxInterruptionsPerSession: number;
+    modalsToday: number;
+    maxModalsPerDay: number;
+    lastInterruptionAt: number;
+    minCooldownMs: number;
+}
+export type GuardVerdict = {
+    action: 'DEFER' | 'DROP';
+    reason: string;
+} | null;
+export interface DecideCtx {
+    now: number;
+    /** §11 RespectGuard verdict per candidate (typing/fullscreen/DND/first-load). null ⇒ allowed. */
+    guard?: (c: Candidate) => GuardVerdict;
+}
+export interface Decision {
+    id: string;
+    action: Action;
+    reason: string;
+    zone: Zone;
+    score: number;
+    /** for PREEMPT: the live occupant being displaced. */
+    preempts?: string;
+}
+export declare function scoreOf(c: Candidate, now: number): number;
+/**
+ * The deterministic arbitration pipeline. Processes candidates in descending score so higher-priority
+ * decisions constrain lower ones within the same tick (a shown interruption puts later ones on
+ * cooldown; a shown alert defers guidance).
+ */
+export declare function decide(candidates: Candidate[], occupants: Occupant[], budget: Budget, ctx: DecideCtx): Decision[];
+/** Default conservative attention budget (§8.3). */
+export declare function defaultBudget(): Budget;
+//# sourceMappingURL=orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/core/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEzE,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAErE;kFACkF;AAClF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;IAClB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB,EAAE,MAAM,CAAC;IACjC,0BAA0B,EAAE,MAAM,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAE/E,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,iGAAiG;IACjG,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,YAAY,CAAC;CACxC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAiBD,wBAAgB,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGzD;AAID;;;;GAIG;AACH,wBAAgB,MAAM,CACpB,UAAU,EAAE,SAAS,EAAE,EACvB,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,SAAS,GACb,QAAQ,EAAE,CAsHZ;AAED,oDAAoD;AACpD,wBAAgB,aAAa,IAAI,MAAM,CAUtC"}

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

@@ -0,0 +1,144 @@
+// ── Scoring (§8.2) ────────────────────────────────────────────────────────────
+const TIER_WEIGHT = {
+    critical: 1000,
+    high: 400,
+    normal: 200,
+    low: 100,
+    passive: 50,
+};
+const CATEGORY_BOOST = {
+    security: 300,
+    system: 250,
+    billing: 200,
+};
+const TIER_RANK = { critical: 4, high: 3, normal: 2, low: 1, passive: 0 };
+export function scoreOf(c, now) {
+    const recency = Math.max(0, Math.min(120, 120 - (now - c.triggeredAt) / 1000));
+    return TIER_WEIGHT[c.tier] + (c.campaignPriority ?? 0) + recency + (CATEGORY_BOOST[c.category] ?? 0);
+}
+const isFocusStealing = (z) => z === 'modal' || z === 'takeover';
+/**
+ * The deterministic arbitration pipeline. Processes candidates in descending score so higher-priority
+ * decisions constrain lower ones within the same tick (a shown interruption puts later ones on
+ * cooldown; a shown alert defers guidance).
+ */
+export function decide(candidates, occupants, budget, ctx) {
+    const now = ctx.now;
+    const scored = candidates
+        .map((c) => ({ c, score: scoreOf(c, now) }))
+        .sort((a, b) => b.score - a.score || a.c.id.localeCompare(b.c.id)); // stable, deterministic
+    const decisions = [];
+    const emit = (c, action, reason, score, preempts) => decisions.push({ id: c.id, action, reason, zone: c.zone, score, preempts });
+    // Running tick state — mutated as we accept SHOW/PREEMPT decisions.
+    const bestCampaign = new Map(); // campaignId → best score seen (dedupe)
+    const zoneWinner = new Map(); // zone → id that took it this tick
+    const toastLive = occupants.filter((o) => o.zone === 'toast').length;
+    let toastShown = 0;
+    let focusStealerLive = occupants.some((o) => isFocusStealing(o.zone));
+    let interruptionFiredThisTick = false;
+    let alertLive = occupants.some((o) => o.tier === 'critical') || false; // a live critical surface = "alert on screen"
+    let tokens = budget.tokens;
+    let interruptions = budget.interruptionsThisSession;
+    let modals = budget.modalsToday;
+    let lastInterruptionAt = budget.lastInterruptionAt;
+    for (const { c, score } of scored) {
+        // 1. dedupe per campaign — the top-scoring variant of a campaign wins; the rest DROP.
+        if (c.campaignId) {
+            if (bestCampaign.has(c.campaignId)) {
+                emit(c, 'DROP', 'dedupe:campaign', score);
+                continue;
+            }
+            bestCampaign.set(c.campaignId, score);
+        }
+        // 2. RespectGuard (§11) — hard context vetoes.
+        const g = ctx.guard?.(c);
+        if (g) {
+            emit(c, g.action, g.reason, score);
+            continue;
+        }
+        // 3. interaction-only surfaces never auto-interrupt.
+        if (c.interactionOnly) {
+            emit(c, 'DEFER', 'interaction-only', score);
+            continue;
+        }
+        // 4. guidance must not overlay a live alert.
+        if (c.guidance && alertLive) {
+            emit(c, 'DEFER', 'defer-until-clear', score);
+            continue;
+        }
+        // 5. per-zone arbitration — one active winner per zone (toast is the multi-slot exception).
+        const cap = c.zone === 'toast' ? 3 : 1;
+        if (cap === 1 && zoneWinner.has(c.zone)) {
+            // a higher-scoring candidate already claimed this zone this tick.
+            emit(c, c.cost > 0 ? 'QUEUE' : 'DROP', c.cost > 0 ? 'queue:zone-busy' : 'zone-lost', score);
+            continue;
+        }
+        // 6. global focus-stealing mutual exclusion (one blocking surface, ever — §8.7).
+        if (isFocusStealing(c.zone) && focusStealerLive) {
+            emit(c, 'QUEUE', 'queue:focus-busy', score);
+            continue;
+        }
+        // 7. toast stack cap (≤3 incl. live).
+        if (c.zone === 'toast' && toastLive + toastShown >= 3) {
+            emit(c, 'QUEUE', 'queue:toast-cap', score);
+            continue;
+        }
+        // 8. attention budget + cooldown (interruptive only; ambient/passive are free).
+        if (c.cost > 0) {
+            if (interruptions >= budget.maxInterruptionsPerSession) {
+                emit(c, 'QUEUE', 'queue:budget:interruptions', score);
+                continue;
+            }
+            if (c.zone === 'modal' && modals >= budget.maxModalsPerDay) {
+                emit(c, 'QUEUE', 'queue:budget:modals', score);
+                continue;
+            }
+            if (interruptionFiredThisTick || now - lastInterruptionAt < budget.minCooldownMs) {
+                emit(c, 'QUEUE', 'queue:cooldown', score);
+                continue;
+            }
+            if (tokens < c.cost) {
+                emit(c, 'QUEUE', 'queue:budget:tokens', score);
+                continue;
+            }
+        }
+        // 9. preemption — a critical winner may displace a live *ambient* lower-tier occupant of its zone.
+        let preempts;
+        if (c.tier === 'critical') {
+            const victim = occupants.find((o) => o.zone === c.zone && !isFocusStealing(o.zone) && TIER_RANK[o.tier] < TIER_RANK.critical);
+            if (victim)
+                preempts = victim.id;
+        }
+        // ── ACCEPT ──
+        emit(c, preempts ? 'PREEMPT' : 'SHOW', preempts ? 'preempt:critical' : 'show', score, preempts);
+        zoneWinner.set(c.zone, c.id);
+        if (c.zone === 'toast')
+            toastShown++;
+        if (isFocusStealing(c.zone))
+            focusStealerLive = true;
+        if (c.tier === 'critical')
+            alertLive = true;
+        if (c.cost > 0) {
+            tokens -= c.cost;
+            interruptions++;
+            if (c.zone === 'modal')
+                modals++;
+            interruptionFiredThisTick = true;
+            lastInterruptionAt = now;
+        }
+    }
+    return decisions;
+}
+/** Default conservative attention budget (§8.3). */
+export function defaultBudget() {
+    return {
+        tokens: 5,
+        interruptionsThisSession: 0,
+        maxInterruptionsPerSession: 3,
+        modalsToday: 0,
+        maxModalsPerDay: 2,
+        lastInterruptionAt: 0,
+        minCooldownMs: 90000,
+    };
+}
+//# sourceMappingURL=orchestrator.js.map

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

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

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

@@ -0,0 +1,51 @@
+/**
+ * IAM 2.0 RespectGuard (spec §11, P0.6) — "never annoy the user" as an enforced policy.
+ *
+ * Produces the per-candidate veto the Orchestrator consumes (`ctx.guard`). It encodes the hard
+ * invariants: never interrupt while the user is typing, in fullscreen/presentation, during the
+ * first-load grace window, under Do-Not-Disturb, or when the user is fatigued (consecutive
+ * dismissals → global back-off). Vetoes are almost always **DEFER** (transient — retry at a safe
+ * moment), never a silent DROP, so a message waits its turn instead of being lost.
+ *
+ * Crucially, guards apply only to surfaces that *can* annoy — interruptive (cost > 0), focus-stealing,
+ * or guidance. Ambient/passive surfaces (hints, inbox, hotspots) are never vetoed: they don't
+ * interrupt, so respecting the user never means hiding them.
+ */
+import type { Candidate, GuardVerdict } from './orchestrator';
+export interface RespectProbes {
+    isTyping?: () => boolean;
+    isFullscreen?: () => boolean;
+    isDnd?: () => boolean;
+    /** Tab-awareness (P3.8) — a backgrounded tab should never interrupt. */
+    isHidden?: () => boolean;
+    now?: () => number;
+}
+export interface RespectConfig {
+    /** Grace window after page load during which nothing interrupts (ms). */
+    firstLoadGraceMs?: number;
+    /** Consecutive dismissals before the fatigue back-off kicks in. */
+    fatigueThreshold?: number;
+    loadedAt?: number;
+}
+export declare class RespectGuard {
+    private isTyping;
+    private isFullscreen;
+    private isDnd;
+    private isHidden;
+    private now;
+    private graceMs;
+    private fatigueThreshold;
+    private loadedAt;
+    private consecutiveDismissals;
+    constructor(probes?: RespectProbes, config?: RespectConfig);
+    /** True for surfaces capable of interrupting/annoying — the only ones guards apply to. */
+    private canAnnoy;
+    /** The verdict fn to hand the Orchestrator. null ⇒ allowed. */
+    readonly guard: (c: Candidate) => GuardVerdict;
+    /** Fatigue tracking — a dismissal shrinks tolerance; an engagement resets it (§8.3 fatigue decay). */
+    recordDismiss(): void;
+    recordEngagement(): void;
+    /** Toggle Do-Not-Disturb (persisted). */
+    static setDnd(on: boolean): void;
+}
+//# sourceMappingURL=respect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"respect.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/core/respect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAyBD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,qBAAqB,CAAK;gBAEtB,MAAM,GAAE,aAAkB,EAAE,MAAM,GAAE,aAAkB;IAWlE,0FAA0F;IAC1F,OAAO,CAAC,QAAQ;IAIhB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,GAAI,GAAG,SAAS,KAAG,YAAY,CAS3C;IAEF,sGAAsG;IACtG,aAAa,IAAI,IAAI;IAGrB,gBAAgB,IAAI,IAAI;IAIxB,yCAAyC;IACzC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI;CAQjC"}

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

@@ -0,0 +1,78 @@
+const DND_KEY = 'scalebun_inapp_dnd';
+function defaultIsTyping() {
+    if (typeof document === 'undefined')
+        return false;
+    const el = document.activeElement;
+    if (!el)
+        return false;
+    const tag = el.tagName;
+    return tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT' || el.isContentEditable === true;
+}
+function defaultIsFullscreen() {
+    if (typeof document === 'undefined')
+        return false;
+    return !!document.fullscreenElement;
+}
+function defaultIsDnd() {
+    try {
+        return typeof localStorage !== 'undefined' && localStorage.getItem(DND_KEY) === '1';
+    }
+    catch {
+        return false;
+    }
+}
+export class RespectGuard {
+    constructor(probes = {}, config = {}) {
+        this.consecutiveDismissals = 0;
+        /** The verdict fn to hand the Orchestrator. null ⇒ allowed. */
+        this.guard = (c) => {
+            if (!this.canAnnoy(c))
+                return null; // ambient/passive: respecting the user ≠ hiding it
+            if (this.isHidden())
+                return { action: 'DEFER', reason: 'respect:hidden' };
+            if (this.isTyping())
+                return { action: 'DEFER', reason: 'respect:typing' };
+            if (this.isFullscreen())
+                return { action: 'DEFER', reason: 'respect:fullscreen' };
+            if (this.now() - this.loadedAt < this.graceMs)
+                return { action: 'DEFER', reason: 'respect:first-load' };
+            if (this.isDnd())
+                return { action: 'DEFER', reason: 'respect:dnd' };
+            if (this.consecutiveDismissals >= this.fatigueThreshold)
+                return { action: 'DEFER', reason: 'respect:fatigue' };
+            return null;
+        };
+        this.isTyping = probes.isTyping ?? defaultIsTyping;
+        this.isFullscreen = probes.isFullscreen ?? defaultIsFullscreen;
+        this.isDnd = probes.isDnd ?? defaultIsDnd;
+        this.isHidden = probes.isHidden ?? (() => typeof document !== 'undefined' && document.visibilityState === 'hidden');
+        this.now = probes.now ?? (() => Date.now());
+        this.graceMs = config.firstLoadGraceMs ?? 3000;
+        this.fatigueThreshold = config.fatigueThreshold ?? 2;
+        this.loadedAt = config.loadedAt ?? this.now();
+    }
+    /** True for surfaces capable of interrupting/annoying — the only ones guards apply to. */
+    canAnnoy(c) {
+        return c.cost > 0 || c.focus === 'focus-stealing' || !!c.guidance;
+    }
+    /** Fatigue tracking — a dismissal shrinks tolerance; an engagement resets it (§8.3 fatigue decay). */
+    recordDismiss() {
+        this.consecutiveDismissals++;
+    }
+    recordEngagement() {
+        this.consecutiveDismissals = 0;
+    }
+    /** Toggle Do-Not-Disturb (persisted). */
+    static setDnd(on) {
+        try {
+            if (on)
+                localStorage.setItem(DND_KEY, '1');
+            else
+                localStorage.removeItem(DND_KEY);
+        }
+        catch {
+            /* storage disabled */
+        }
+    }
+}
+//# sourceMappingURL=respect.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * IAM 2.0 host slot registry (spec §7.5 inline exception, P1.5).
+ *
+ * Inline surfaces (S8) render *in document flow* — inside a named element the host app registers
+ * (`scalebun.inapp.registerSlot('empty-state', el)`). Because an inline variant may become eligible before
+ * its slot exists (or the slot may mount/unmount with the SPA), the registry supports late binding:
+ * `whenAvailable` fires now if the slot is present, else the moment it registers.
+ */
+export declare class SlotRegistry {
+    private slots;
+    private waiters;
+    register(name: string, el: HTMLElement): void;
+    unregister(name: string): void;
+    get(name: string): HTMLElement | undefined;
+    /** Run `cb` with the slot element now (if present) or when it next registers. Returns a canceller. */
+    whenAvailable(name: string, cb: (el: HTMLElement) => void): () => void;
+    clear(): void;
+}
+//# sourceMappingURL=slots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/core/slots.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,OAAO,CAAqD;IAEpE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI;IAe7C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1C,sGAAsG;IACtG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI;IAYtE,KAAK,IAAI,IAAI;CAId"}

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

@@ -0,0 +1,53 @@
+/**
+ * IAM 2.0 host slot registry (spec §7.5 inline exception, P1.5).
+ *
+ * Inline surfaces (S8) render *in document flow* — inside a named element the host app registers
+ * (`scalebun.inapp.registerSlot('empty-state', el)`). Because an inline variant may become eligible before
+ * its slot exists (or the slot may mount/unmount with the SPA), the registry supports late binding:
+ * `whenAvailable` fires now if the slot is present, else the moment it registers.
+ */
+export class SlotRegistry {
+    constructor() {
+        this.slots = new Map();
+        this.waiters = new Map();
+    }
+    register(name, el) {
+        this.slots.set(name, el);
+        const ws = this.waiters.get(name);
+        if (ws) {
+            this.waiters.delete(name);
+            for (const w of ws) {
+                try {
+                    w(el);
+                }
+                catch {
+                    /* a waiter must not break registration */
+                }
+            }
+        }
+    }
+    unregister(name) {
+        this.slots.delete(name);
+    }
+    get(name) {
+        return this.slots.get(name);
+    }
+    /** Run `cb` with the slot element now (if present) or when it next registers. Returns a canceller. */
+    whenAvailable(name, cb) {
+        const existing = this.slots.get(name);
+        if (existing) {
+            cb(existing);
+            return () => { };
+        }
+        let set = this.waiters.get(name);
+        if (!set)
+            this.waiters.set(name, (set = new Set()));
+        set.add(cb);
+        return () => this.waiters.get(name)?.delete(cb);
+    }
+    clear() {
+        this.slots.clear();
+        this.waiters.clear();
+    }
+}
+//# sourceMappingURL=slots.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../../../../src/features/inapp/core/slots.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IAAzB;QACU,UAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;QACvC,YAAO,GAAG,IAAI,GAAG,EAA0C,CAAC;IA0CtE,CAAC;IAxCC,QAAQ,CAAC,IAAY,EAAE,EAAe;QACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBACnB,IAAI,CAAC;oBACH,CAAC,CAAC,EAAE,CAAC,CAAC;gBACR,CAAC;gBAAC,MAAM,CAAC;oBACP,0CAA0C;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,sGAAsG;IACtG,aAAa,CAAC,IAAY,EAAE,EAA6B;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,QAAQ,EAAE,CAAC;YACb,EAAE,CAAC,QAAQ,CAAC,CAAC;YACb,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QACpD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACZ,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

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

@@ -0,0 +1,58 @@
+/**
+ * IAM 2.0 targeting engine (spec §7.2, P0.3).
+ *
+ * Pure, client-side eligibility: given a variant + a snapshot of context (route, user profile, DOM,
+ * viewport), decide whether the variant *could* show — before the Orchestrator arbitrates *which*
+ * eligible variant actually wins its zone. Four matchers:
+ *   • route     — glob allow-list against the current path
+ *   • element   — a required CSS selector resolves (anchored surfaces / element gating)
+ *   • audience  — a lightweight predicate over the local user profile (segments + attributes)
+ *   • frequency — showOnce / maxImpressions / cooldown / persistDismiss, durable across reloads
+ *
+ * The server remains authoritative (it decides the served set); this is the last-mile client guard
+ * that also enforces the rules the server can't track per-device (frequency, DOM presence, viewport).
+ */
+import type { Variant } from '../types';
+/** Is `el` at least `minRatio` visible in the viewport? Reuses coach's pure visibleRatio. */
+export declare function elementVisible(el: Element, minRatio?: number, vp?: {
+    width: number;
+    height: number;
+}): boolean;
+export interface UserProfile {
+    segments?: Set<string> | string[];
+    attrs?: Record<string, unknown>;
+}
+export interface TargetingContext {
+    route: string;
+    profile?: UserProfile;
+    now: number;
+    viewportWidth?: number;
+    hasSelection?: boolean;
+    /** Injectable DOM probe (defaults to document.querySelector) — keeps the matcher testable. */
+    queryElement?: (selector: string) => boolean;
+}
+export declare function matchRoute(patterns: string[] | undefined, path: string): boolean;
+export declare function elementPresent(selector: string | undefined, ctx: TargetingContext): boolean;
+export declare function audienceMatch(expr: string | undefined, profile: UserProfile | undefined): boolean;
+/** Persists per-variant impression/dismiss state so showOnce/cooldown survive reloads. */
+export declare class FrequencyStore {
+    private readonly storage;
+    private map;
+    constructor(storage?: Storage | null);
+    private load;
+    private save;
+    /** Does this variant's frequency rule permit a show right now? */
+    canShow(v: Variant, now: number): boolean;
+    recordImpression(id: string, now: number): void;
+    recordDismiss(id: string, now: number): void;
+    /** Dev/QA reset. */
+    clear(): void;
+}
+export interface EligibilityResult {
+    eligible: boolean;
+    /** When ineligible, why (targeting|frequency|viewport|selection) — feeds §10 observability. */
+    reason?: string;
+}
+/** Does the variant pass targeting + frequency for this context? (Triggers gate *when*, not *if*.) */
+export declare function evaluateEligibility(v: Variant, ctx: TargetingContext, freq: FrequencyStore): EligibilityResult;
+//# sourceMappingURL=targeting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"targeting.d.ts","sourceRoot":"","sources":["../../../../src/features/inapp/core/targeting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,UAAU,CAAC;AAIvD,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,SAAM,EAAE,EAAE,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAK3G;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8FAA8F;IAC9F,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;CAC9C;AAwBD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhF;AAGD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAQ3F;AAyCD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAGjG;AAUD,0FAA0F;AAC1F,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,GAAG,CAA6B;gBAEX,OAAO,GAAE,OAAO,GAAG,IAAoB;IAIpE,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,IAAI;IAQZ,kEAAkE;IAClE,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAWzC,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ/C,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ5C,oBAAoB;IACpB,KAAK,IAAI,IAAI;CAId;AAGD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,iBAAiB,CAW9G"}