@scalebun-release/web 2.2.2

package/dist/features/bugreport/collect.d.ts

@@ -0,0 +1,33 @@
+import type { ReplayCoord } from '../../core/replayCoord.js';
+export interface BugReportInput {
+    /** Required free-text from the reporter. */
+    message: string;
+    title?: string;
+    /** Optional reporter email (anonymous reports allowed). */
+    email?: string;
+}
+export interface BugReportPayload {
+    /** Idempotency key → BugReport.clientReportId (@unique). */
+    clientReportId: string;
+    title?: string;
+    message: string;
+    email?: string;
+    url?: string;
+    /** Recent console breadcrumbs (already scrubbed log items) for quick triage; full set is in-session. */
+    console?: unknown[];
+    /** Last replay frame known when the reporter pressed Send. Absent means no exact frame was captured. */
+    replaySeq?: number;
+    /** The keyframe segment containing `replaySeq`, when the recorder has one. */
+    replaySegmentId?: string;
+    /**
+     * Client wall-clock time when the report was created. Kept as `timestamp` for wire compatibility;
+     * the ingestion API persists it as `reportedAt`, distinct from server-side `createdAt`.
+     */
+    timestamp: number;
+}
+export interface BugReportReplayContext {
+    replayCoord?: ReplayCoord;
+}
+/** Build the POST body. `message` is scrubbed for obvious PII; `recentConsole` is capped. */
+export declare function buildBugReportPayload(input: BugReportInput, recentConsole?: readonly unknown[], replay?: BugReportReplayContext): BugReportPayload;
+//# sourceMappingURL=collect.d.ts.map

package/dist/features/bugreport/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../../src/features/bugreport/collect.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wGAAwG;IACxG,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,wGAAwG;IACxG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAUD,6FAA6F;AAC7F,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,aAAa,GAAE,SAAS,OAAO,EAAO,EACtC,MAAM,GAAE,sBAA2B,GAClC,gBAAgB,CAalB"}

package/dist/features/bugreport/collect.js

@@ -0,0 +1,30 @@
+/**
+ * Pure builder for the bug-report submit payload. The heavy evidence (replay frame, network, console
+ * breadcrumbs, errors) is NOT inlined here — it already flows through the session and is joined
+ * server-side by sessionId. This payload only carries the reporter's message + light context.
+ */
+import { uuid, now, scrubText } from '../../core/index.js';
+function currentUrl() {
+    try {
+        return typeof location !== 'undefined' ? location.href : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Build the POST body. `message` is scrubbed for obvious PII; `recentConsole` is capped. */
+export function buildBugReportPayload(input, recentConsole = [], replay = {}) {
+    const coord = replay.replayCoord;
+    return {
+        clientReportId: `bug_${uuid()}`,
+        ...(input.title ? { title: scrubText(input.title) } : {}),
+        message: scrubText(input.message ?? ''),
+        ...(input.email ? { email: input.email } : {}),
+        url: currentUrl(),
+        ...(recentConsole.length ? { console: recentConsole.slice(-20) } : {}),
+        ...(typeof coord?.seq === 'number' ? { replaySeq: coord.seq } : {}),
+        ...(coord?.segmentId ? { replaySegmentId: coord.segmentId } : {}),
+        timestamp: now(),
+    };
+}
+//# sourceMappingURL=collect.js.map

package/dist/features/bugreport/collect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.js","sourceRoot":"","sources":["../../../src/features/bugreport/collect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAmClD,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,OAAO,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,qBAAqB,CACnC,KAAqB,EACrB,gBAAoC,EAAE,EACtC,SAAiC,EAAE;IAEnC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;IACjC,OAAO;QACL,cAAc,EAAE,OAAO,IAAI,EAAE,EAAE;QAC/B,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QACvC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,GAAG,EAAE,UAAU,EAAE;QACjB,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,KAAK,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,SAAS,EAAE,GAAG,EAAE;KACjB,CAAC;AACJ,CAAC"}

package/dist/features/bugreport/widget.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Embeddable bug-report widget (F-BUG Phase 3). Vanilla DOM, zero deps, lazy-loaded (dynamic
+ * import) so it never weighs on the core bundle. A floating launcher opens a small form; submit
+ * delegates to the SDK's reportBug path (which auto-attaches the session's replay/console/network).
+ * Styles are inline + prefixed to avoid clashing with the host page. Never throws into the host.
+ */
+export type WidgetPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+/**
+ * Why a submit produced no report id. The submit path has SIX independent ways to fail and they need
+ * different things from the reader — "try again" is sound advice for exactly one of them and actively
+ * wrong for the rest (retrying a consent block or a disabled feature can never succeed).
+ *
+ * Codes rather than sentences cross the boundary on purpose: the prose lives here, in the lazily
+ * loaded chunk, instead of in the facade where every byte is measured by `size:check`.
+ */
+export type SubmitFailure = 'init' | 'off' | 'empty' | 'consent' | 'send';
+/**
+ * A submit result: the report id, or `{ e }` naming the branch that failed.
+ *
+ * The failure shape carries no `id` field on purpose — six `{ id: null, reason }` literals in the
+ * facade cost enough gzipped bytes to break the core-bundle gate outright. `string | null` is still
+ * accepted because it predates the reason codes and hosts may still pass it.
+ */
+export type SubmitResult = string | null | {
+    e: SubmitFailure;
+};
+export interface WidgetOptions {
+    position: WidgetPosition;
+    label: string;
+    /** Returns the created report id, or why there isn't one. */
+    onSubmit: (input: {
+        message: string;
+        email?: string;
+    }) => Promise<SubmitResult>;
+}
+export interface WidgetHandle {
+    destroy: () => void;
+}
+export declare function createBugReportWidget(opts: WidgetOptions): WidgetHandle;
+//# sourceMappingURL=widget.d.ts.map

package/dist/features/bugreport/widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.d.ts","sourceRoot":"","sources":["../../../src/features/bugreport/widget.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;AAEvF;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG;IAAE,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CACjF;AAUD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AA6CD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CA6FvE"}

package/dist/features/bugreport/widget.js

@@ -0,0 +1,145 @@
+/**
+ * Embeddable bug-report widget (F-BUG Phase 3). Vanilla DOM, zero deps, lazy-loaded (dynamic
+ * import) so it never weighs on the core bundle. A floating launcher opens a small form; submit
+ * delegates to the SDK's reportBug path (which auto-attaches the session's replay/console/network).
+ * Styles are inline + prefixed to avoid clashing with the host page. Never throws into the host.
+ */
+import { injectStyle } from '../../core/index.js';
+const FAILURE_TEXT = {
+    init: 'Reporting isn’t ready yet. Reload the page and try again.',
+    off: 'Bug reporting is turned off for this site.',
+    empty: 'Please describe the bug.',
+    consent: 'Reporting is paused until you accept the privacy notice on this page.',
+    send: 'Couldn’t reach the server. Check your connection and try again.',
+};
+const Z = 2147483000; // above almost everything, below the absolute max
+function corner(pos) {
+    const v = pos.startsWith('top') ? 'top: 16px;' : 'bottom: 16px;';
+    const h = pos.endsWith('right') ? 'right: 16px;' : 'left: 16px;';
+    return v + h;
+}
+// CSP-clean styles: injected once (nonce'd/adopted), scoped under [data-scalebun-bugreport] + prefixed
+// classes so nothing clashes with the host page — the reason the widget used inline styles before.
+function widgetCss(pos) {
+    return (`[data-scalebun-bugreport]{position:fixed;${corner(pos)}z-index:${Z};font-family:system-ui,sans-serif}` +
+        `[data-scalebun-bugreport] .sbbr-launch{cursor:pointer;border:none;border-radius:9999px;padding:10px 16px;font-size:13px;font-weight:600;color:#fff;background:#ef4444;box-shadow:0 2px 8px rgba(0,0,0,.2)}` +
+        // The launcher and the panel are SIBLINGS in one fixed box, so opening the panel used to leave
+        // the red pill sitting above it at z-index 2147483000 — floating over the page next to its own
+        // form. Nothing referenced .sbbr-launch on open at all. The panel replaces the launcher now.
+        `[data-scalebun-bugreport].sbbr-expanded .sbbr-launch{display:none}` +
+        // Width is min() rather than a flat 300px: on a 340px phone a fixed 300 leaves 4px of margin.
+        `[data-scalebun-bugreport] .sbbr-panel{display:none;width:min(300px,calc(100vw - 32px));background:#fff;color:#111827;border:1px solid #e5e7eb;border-radius:12px;padding:14px;box-shadow:0 8px 30px rgba(0,0,0,.18);margin-top:8px}` +
+        `[data-scalebun-bugreport] .sbbr-panel.sbbr-open{display:block}` +
+        `[data-scalebun-bugreport] .sbbr-title{font-size:14px;font-weight:700;margin-bottom:8px}` +
+        `[data-scalebun-bugreport] .sbbr-field{width:100%;box-sizing:border-box;font:inherit;font-size:13px;padding:8px;border:1px solid #e5e7eb;border-radius:8px}` +
+        `[data-scalebun-bugreport] textarea.sbbr-field{resize:vertical}` +
+        `[data-scalebun-bugreport] .sbbr-email{margin-top:8px}` +
+        `[data-scalebun-bugreport] .sbbr-status{font-size:12px;color:#6b7280;min-height:16px;margin-top:8px}` +
+        `[data-scalebun-bugreport] .sbbr-actions{display:flex;gap:8px;justify-content:flex-end;margin-top:8px}` +
+        `[data-scalebun-bugreport] .sbbr-btn{cursor:pointer;font:inherit;font-size:13px;padding:6px 12px;border-radius:8px}` +
+        `[data-scalebun-bugreport] .sbbr-cancel{border:1px solid #e5e7eb;background:#fff}` +
+        `[data-scalebun-bugreport] .sbbr-send{font-weight:600;border:none;background:#ef4444;color:#fff}` +
+        // The palette was light-only and hardcoded, so on a dark host the panel either glared white or
+        // was left to the browser's forced-dark heuristic to invert — an appearance nobody designed.
+        // Declaring the dark half means the widget decides how it looks on a dark page.
+        `@media(prefers-color-scheme:dark){` +
+        `[data-scalebun-bugreport] .sbbr-panel{background:#17161c;color:#ececf1;border-color:#2e2c36;box-shadow:0 8px 30px rgba(0,0,0,.5)}` +
+        `[data-scalebun-bugreport] .sbbr-field{background:#111016;color:#ececf1;border-color:#2e2c36}` +
+        `[data-scalebun-bugreport] .sbbr-field::placeholder{color:#8b8796}` +
+        `[data-scalebun-bugreport] .sbbr-status{color:#a5a1b0}` +
+        `[data-scalebun-bugreport] .sbbr-cancel{background:#221f2b;color:#ececf1;border-color:#2e2c36}` +
+        `}`);
+}
+export function createBugReportWidget(opts) {
+    if (typeof document === 'undefined')
+        return { destroy: () => { } };
+    const root = document.createElement('div');
+    root.setAttribute('data-scalebun-bugreport', '');
+    root.setAttribute('data-scalebun', '');
+    injectStyle(document, widgetCss(opts.position));
+    const launcher = document.createElement('button');
+    launcher.type = 'button';
+    launcher.className = 'sbbr-launch';
+    launcher.textContent = opts.label;
+    const panel = document.createElement('div');
+    panel.className = 'sbbr-panel';
+    panel.innerHTML = `
+    <div class="sbbr-title">Report a bug</div>
+    <textarea data-scalebun-msg class="sbbr-field" placeholder="What went wrong?" rows="4"></textarea>
+    <input data-scalebun-email class="sbbr-field sbbr-email" type="email" placeholder="Your email (optional)" />
+    <div data-scalebun-status class="sbbr-status"></div>
+    <div class="sbbr-actions">
+      <button type="button" data-scalebun-cancel class="sbbr-btn sbbr-cancel">Cancel</button>
+      <button type="button" data-scalebun-send class="sbbr-btn sbbr-send">Send</button>
+    </div>`;
+    root.appendChild(launcher);
+    root.appendChild(panel);
+    document.body.appendChild(root);
+    const msg = panel.querySelector('[data-scalebun-msg]');
+    const email = panel.querySelector('[data-scalebun-email]');
+    const status = panel.querySelector('[data-scalebun-status]');
+    const sendBtn = panel.querySelector('[data-scalebun-send]');
+    const cancelBtn = panel.querySelector('[data-scalebun-cancel]');
+    let open = false;
+    const setOpen = (v) => {
+        open = v;
+        panel.classList.toggle('sbbr-open', v);
+        root.classList.toggle('sbbr-expanded', v); // hides the launcher — see widgetCss
+        if (v)
+            msg.focus();
+    };
+    const onLauncher = () => setOpen(!open);
+    const onCancel = () => setOpen(false);
+    const onSend = async () => {
+        const message = msg.value.trim();
+        if (!message) {
+            status.textContent = 'Please describe the bug.';
+            return;
+        }
+        sendBtn.disabled = true;
+        status.textContent = 'Sending…';
+        let id = null;
+        let reason;
+        try {
+            const r = await opts.onSubmit({ message, email: email.value.trim() || undefined });
+            if (r && typeof r === 'object')
+                reason = r.e;
+            else
+                id = r ?? null;
+        }
+        catch {
+            // A THROWN submit is a delivery failure, not an unknown one. Reporting it as "try again" is
+            // right here and wrong for the other branches, which is the whole reason reason codes exist.
+            id = null;
+            reason = 'send';
+        }
+        sendBtn.disabled = false;
+        if (id) {
+            status.textContent = 'Thanks — your report was sent.';
+            msg.value = '';
+            email.value = '';
+            setTimeout(() => {
+                if (open)
+                    setOpen(false);
+                status.textContent = '';
+            }, 1500);
+        }
+        else {
+            // Never the old blanket "Could not send the report. Please try again." — five of the six ways
+            // this fails cannot be fixed by trying again, so that sentence sent the reader in a loop.
+            status.textContent = reason ? FAILURE_TEXT[reason] : FAILURE_TEXT.send;
+        }
+    };
+    launcher.addEventListener('click', onLauncher);
+    cancelBtn.addEventListener('click', onCancel);
+    sendBtn.addEventListener('click', onSend);
+    return {
+        destroy: () => {
+            launcher.removeEventListener('click', onLauncher);
+            cancelBtn.removeEventListener('click', onCancel);
+            sendBtn.removeEventListener('click', onSend);
+            root.remove();
+        },
+    };
+}
+//# sourceMappingURL=widget.js.map

package/dist/features/bugreport/widget.js.map

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

package/dist/features/coach/CoachmarkFeature.d.ts

@@ -0,0 +1,78 @@
+import type { TourSpec, TourContext } from './types.js';
+export interface CoachmarkDeps {
+    trackEvent: (name: string, props?: Record<string, unknown>) => void;
+    replayCoord: () => {
+        sessionId?: string;
+        seq?: number;
+        t?: number;
+    } | undefined;
+    /** For fetching dashboard-authored tours from the config lane (startById). Optional. */
+    apiBaseUrl?: string;
+    clientKey?: string;
+}
+type CoachEvent = {
+    event: string;
+} & Record<string, unknown>;
+export declare class CoachmarkFeature {
+    private readonly deps;
+    private readonly hub;
+    private readonly renderer;
+    private readonly engine;
+    private readonly listeners;
+    private toursCache;
+    constructor(deps: CoachmarkDeps);
+    start(tour: TourSpec, opts?: {
+        resume?: boolean;
+        context?: TourContext;
+    }): void;
+    /**
+     * Tell the dashboard which anchors this page actually has.
+     *
+     * Authors had to type an anchor key from memory into an empty box — so `checkout` when the code
+     * said `checkout-btn` published happily and the step silently degraded to a modal. Reporting the
+     * real keys turns that box into a list of what exists.
+     *
+     * Rides the normal analytics lane as `$coachmark_anchor_seen`, one event per key, so it needs no
+     * new endpoint and no table — the coach analytics service already reads `$coachmark_*` from the
+     * Event table.
+     *
+     * DEDUPED PER SESSION. A tour that restarts, or a SPA that re-renders, must not re-emit the same
+     * keys: the value is the SET of anchors, not a count of sightings, and an undeduped version would
+     * put a per-render event stream into the customer's analytics for no extra information.
+     *
+     * Safe to call as often as you like. Typically once after `init()` during integration; `start()`
+     * also calls it.
+     */
+    reportAnchors(): void;
+    /** Keys already reported this page-lifetime — see `reportAnchors`. */
+    private readonly reportedAnchors;
+    /** Fetch dashboard-published tours from the config lane. Best-effort — [] on any failure. Cached,
+     *  except a `preview` token (a one-off draft test) always does a fresh, un-cached fetch. */
+    fetchTours(preview?: string): Promise<TourSpec[]>;
+    /** Start a dashboard-authored tour by id. Returns false if the tour isn't published/found. Pass a
+     *  `preview` token (from the dashboard) to run a DRAFT tour before it's published. */
+    startById(id: string, opts?: {
+        resume?: boolean;
+        context?: TourContext;
+        preview?: string;
+    }): Promise<boolean>;
+    next(): void;
+    back(): void;
+    skip(): void;
+    end(): void;
+    notify(event: string): void;
+    current(): {
+        tourId: string | null;
+        index: number;
+        status: string;
+    };
+    /** Subscribe to a specific `$coachmark_*` event, or `'*'` for all. Returns an unsubscribe fn. */
+    on(event: string, cb: (e: CoachEvent) => void): () => void;
+    private emit;
+    private progress;
+    private persist;
+    private loadIndex;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=CoachmarkFeature.d.ts.map

package/dist/features/coach/CoachmarkFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoachmarkFeature.d.ts","sourceRoot":"","sources":["../../../src/features/coach/CoachmarkFeature.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpE,WAAW,EAAE,MAAM;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAChF,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAG9D,qBAAa,gBAAgB;IAOf,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;IAC7E,OAAO,CAAC,UAAU,CAA2B;gBAEhB,IAAI,EAAE,aAAa;IAchD,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,IAAI;IAM/E;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,IAAI,IAAI;IAQrB,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAErD;gGAC4F;IACtF,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgBvD;0FACsF;IAChF,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAMnH,IAAI,IAAI,IAAI;IACZ,IAAI,IAAI,IAAI;IACZ,IAAI,IAAI,IAAI;IACZ,GAAG,IAAI,IAAI;IACX,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAC3B,OAAO,IAAI;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAInE,iGAAiG;IACjG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAO1D,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,QAAQ;IAGhB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,SAAS;IAIjB,OAAO,IAAI,IAAI;CAMhB"}

package/dist/features/coach/CoachmarkFeature.js

@@ -0,0 +1,161 @@
+/**
+ * CoachmarkFeature (B2.3) — the lazy orchestrator wiring B1 (anchor/wait) + B2 (TourEngine + renderer).
+ * Fully lazy like PushFeature (NOT in the FEATURES manifest) — the facade loads it on first
+ * `ScaleBun.coachmarks()` use, so an app that never runs a tour pays ~zero eager cost. Every lifecycle
+ * event is replayCoord-stamped (the moat: watch the exact replay frame a user abandoned a step).
+ */
+import { ObserverHub } from './observers.js';
+import { CoachRenderer } from './overlay.js';
+import { TourEngine } from './tour.js';
+import { resolveAnchor, collectAnchorKeys } from './anchor.js';
+import { waitFor } from './wait.js';
+const PROGRESS_KEY = 'scalebun_coach_progress';
+export class CoachmarkFeature {
+    constructor(deps) {
+        this.deps = deps;
+        this.hub = new ObserverHub();
+        this.renderer = new CoachRenderer();
+        this.listeners = new Map();
+        this.toursCache = null;
+        /** Keys already reported this page-lifetime — see `reportAnchors`. */
+        this.reportedAnchors = new Set();
+        this.engine = new TourEngine({
+            hub: this.hub,
+            resolveAnchor: (spec) => resolveAnchor(spec),
+            waitFor: (getEl, opts, hub) => waitFor(getEl, opts, hub),
+            render: (ctx) => this.renderer.render(ctx),
+            hide: () => this.renderer.hide(),
+            emit: (name, props) => this.emit(name, props),
+            now: () => Date.now(),
+            persist: (id, i) => this.persist(id, i),
+            loadIndex: (id) => this.loadIndex(id),
+        });
+    }
+    start(tour, opts) {
+        // Keep the dashboard's anchor list fresh from real usage, not just from an explicit setup call.
+        this.reportAnchors();
+        this.engine.start(tour, opts);
+    }
+    /**
+     * Tell the dashboard which anchors this page actually has.
+     *
+     * Authors had to type an anchor key from memory into an empty box — so `checkout` when the code
+     * said `checkout-btn` published happily and the step silently degraded to a modal. Reporting the
+     * real keys turns that box into a list of what exists.
+     *
+     * Rides the normal analytics lane as `$coachmark_anchor_seen`, one event per key, so it needs no
+     * new endpoint and no table — the coach analytics service already reads `$coachmark_*` from the
+     * Event table.
+     *
+     * DEDUPED PER SESSION. A tour that restarts, or a SPA that re-renders, must not re-emit the same
+     * keys: the value is the SET of anchors, not a count of sightings, and an undeduped version would
+     * put a per-render event stream into the customer's analytics for no extra information.
+     *
+     * Safe to call as often as you like. Typically once after `init()` during integration; `start()`
+     * also calls it.
+     */
+    reportAnchors() {
+        for (const key of collectAnchorKeys()) {
+            if (this.reportedAnchors.has(key))
+                continue;
+            this.reportedAnchors.add(key);
+            this.emit('$coachmark_anchor_seen', { anchorKey: key });
+        }
+    }
+    /** Fetch dashboard-published tours from the config lane. Best-effort — [] on any failure. Cached,
+     *  except a `preview` token (a one-off draft test) always does a fresh, un-cached fetch. */
+    async fetchTours(preview) {
+        if (!preview && this.toursCache)
+            return this.toursCache;
+        const { apiBaseUrl, clientKey } = this.deps;
+        if (!apiBaseUrl || !clientKey || typeof fetch === 'undefined')
+            return preview ? [] : (this.toursCache = []);
+        try {
+            const url = `${apiBaseUrl}/sdk/coach/config${preview ? `?preview=${encodeURIComponent(preview)}` : ''}`;
+            const res = await fetch(url, { headers: { 'x-scalebun-client-key': clientKey }, cache: 'no-store' });
+            if (!res.ok)
+                return preview ? [] : (this.toursCache = []);
+            const data = (await res.json());
+            const tours = data.tours ?? [];
+            return preview ? tours : (this.toursCache = tours);
+        }
+        catch {
+            return preview ? [] : (this.toursCache = []);
+        }
+    }
+    /** Start a dashboard-authored tour by id. Returns false if the tour isn't published/found. Pass a
+     *  `preview` token (from the dashboard) to run a DRAFT tour before it's published. */
+    async startById(id, opts) {
+        const tour = (await this.fetchTours(opts?.preview)).find((t) => t.id === id);
+        if (!tour)
+            return false;
+        this.engine.start(tour, opts);
+        return true;
+    }
+    next() { this.engine.next(); }
+    back() { this.engine.back(); }
+    skip() { this.engine.skip(); }
+    end() { this.engine.end('abandoned', 'api'); }
+    notify(event) { this.engine.notify(event); }
+    current() {
+        return this.engine.state;
+    }
+    /** Subscribe to a specific `$coachmark_*` event, or `'*'` for all. Returns an unsubscribe fn. */
+    on(event, cb) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(cb);
+        return () => { this.listeners.get(event)?.delete(cb); };
+    }
+    emit(name, props) {
+        const rc = this.deps.replayCoord();
+        const payload = { ...props, ...(rc ? { replayCoord: rc } : {}) };
+        this.deps.trackEvent(name, payload); // → analytics lane (funnel + replay deep-link)
+        const e = { event: name, ...payload };
+        for (const cb of this.listeners.get(name) ?? []) {
+            try {
+                cb(e);
+            }
+            catch { /* host cb threw */ }
+        }
+        for (const cb of this.listeners.get('*') ?? []) {
+            try {
+                cb(e);
+            }
+            catch { /* host cb threw */ }
+        }
+    }
+    // ── durable resume (localStorage — a tiny {tourId: index} map) ──
+    progress() {
+        try {
+            return JSON.parse(localStorage.getItem(PROGRESS_KEY) || '{}');
+        }
+        catch {
+            return {};
+        }
+    }
+    persist(tourId, index) {
+        try {
+            const p = this.progress();
+            if (index < 0)
+                delete p[tourId];
+            else
+                p[tourId] = index;
+            localStorage.setItem(PROGRESS_KEY, JSON.stringify(p));
+        }
+        catch { /* storage unavailable */ }
+    }
+    loadIndex(tourId) {
+        return this.progress()[tourId];
+    }
+    dispose() {
+        this.engine.dispose();
+        this.renderer.hide();
+        this.hub.dispose();
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=CoachmarkFeature.js.map

package/dist/features/coach/CoachmarkFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoachmarkFeature.js","sourceRoot":"","sources":["../../../src/features/coach/CoachmarkFeature.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAYjC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAE/C,MAAM,OAAO,gBAAgB;IAO3B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;QAN/B,QAAG,GAAG,IAAI,WAAW,EAAE,CAAC;QACxB,aAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAE/B,cAAS,GAAG,IAAI,GAAG,EAAwC,CAAC;QACrE,eAAU,GAAsB,IAAI,CAAC;QAgD7C,sEAAsE;QACrD,oBAAe,GAAG,IAAI,GAAG,EAAU,CAAC;QA9CnD,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC;YAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC;YAC5C,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC;YACxD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;YAC1C,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;YAChC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;YAC7C,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAc,EAAE,IAAkD;QACtE,gGAAgG;QAChG,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa;QACX,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAKD;gGAC4F;IAC5F,KAAK,CAAC,UAAU,CAAC,OAAgB;QAC/B,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC;QACxD,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAC5C,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,IAAI,OAAO,KAAK,KAAK,WAAW;YAAE,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QAC5G,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,GAAG,UAAU,oBAAoB,OAAO,CAAC,CAAC,CAAC,YAAY,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACxG,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,uBAAuB,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;YACrG,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;YAC1D,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2B,CAAC;YAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAC/B,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;0FACsF;IACtF,KAAK,CAAC,SAAS,CAAC,EAAU,EAAE,IAAoE;QAC9F,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAW,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACpC,IAAI,KAAW,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACpC,IAAI,KAAW,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACpC,GAAG,KAAW,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,CAAC,KAAa,IAAU,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,iGAAiG;IACjG,EAAE,CAAC,KAAa,EAAE,EAA2B;QAC3C,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAAC,CAAC;QAC9D,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACZ,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEO,IAAI,CAAC,IAAY,EAAE,KAA+B;QACxD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACjE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,+CAA+C;QACpF,MAAM,CAAC,GAAe,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;QAClD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAAC,IAAI,CAAC;gBAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAAC,CAAC;QACjG,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAAC,IAAI,CAAC;gBAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAAC,CAAC;IAClG,CAAC;IAED,mEAAmE;IAC3D,QAAQ;QACd,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,IAAI,CAA2B,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;IACvH,CAAC;IACO,OAAO,CAAC,MAAc,EAAE,KAAa;QAC3C,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1B,IAAI,KAAK,GAAG,CAAC;gBAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;;gBAAM,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;YACxD,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;IACvC,CAAC;IACO,SAAS,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/features/coach/anchor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AnchorEngine (B1.2) — the reliability moat. A target is a PRIORITIZED list of strategies (selector →
+ * data-attr → text → aria → xpath → nth), tried in order; the first hit wins. When the primary fails but
+ * a lower strategy resolves, that's "self-healing" (the caller emits $coachmark_anchor_healed so the
+ * dashboard can auto-suggest fixing the brittle primary selector — a feedback loop no competitor has).
+ * Traversal pierces open shadow roots (composed), which Pendo/Appcues mostly can't. Pure DOM, no deps.
+ */
+import type { AnchorSpec, AnchorResult } from './types.js';
+type Scope = Document | ShadowRoot | Element;
+/**
+ * Every `data-scalebun-anchor` key currently on the page.
+ *
+ * WHY THIS EXISTS. Declaring an anchor in code — `data-scalebun-anchor="checkout"` on web,
+ * `<ScaleBunAnchor anchorKey="checkout">` on React Native — is the stable way to mark a tour target:
+ * a CSS rebuild renames classes, it does not rename a data attribute. But the dashboard made an
+ * author TYPE that key into an empty box with no idea what the developers had actually added, so
+ * `checkout` vs `checkout-btn` published happily and the step silently degraded to a modal.
+ *
+ * Enumerating what really exists turns that text box into a list of real choices, on both platforms.
+ * Reported through the normal analytics lane (see `CoachmarkFeature.reportAnchors`) so it needs no
+ * new endpoint and no table.
+ *
+ * Pierces shadow roots for the same reason the resolvers do — a design-system app keeps most of its
+ * buttons inside one.
+ */
+export declare function collectAnchorKeys(root?: Scope, limit?: number): string[];
+/** Resolve a spec to an element, trying each strategy in order. `strategyIndex > 0` ⇒ self-healed. */
+export declare function resolveAnchor(spec: AnchorSpec, root?: Scope): AnchorResult;
+/** Convenience: did resolution fall back past the primary strategy? (drives the heal telemetry). */
+export declare function didHeal(r: AnchorResult): boolean;
+export {};
+//# sourceMappingURL=anchor.d.ts.map

package/dist/features/coach/anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../src/features/coach/anchor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAkB,YAAY,EAAE,MAAM,SAAS,CAAC;AAExE,KAAK,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAkE7C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,GAAE,KAAyE,EAC/E,KAAK,SAAM,GACV,MAAM,EAAE,CAYV;AAED,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,KAAyE,GAAG,YAAY,CAS7I;AAED,oGAAoG;AACpG,wBAAgB,OAAO,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAEhD"}