@scalebun/web 1.0.0

package/dist/features/engage/EngageFeature.js

@@ -0,0 +1,221 @@
+import { uuid, now, getReplayCoord } from '../../core';
+import { EngageTransport } from './transport';
+const BUF_CAP = 32; // bounded ring — a burst of pre-config events can't grow unbounded
+const BUF_TTL_MS = 30000; // a buffered trigger older than this is stale on replay → dropped
+const SESSIONS_KEY = 'scalebun_engage_sessions';
+function currentPath() {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : '';
+    }
+    catch {
+        return '';
+    }
+}
+/** Cheap core-side gate: does the raw config carry ANY campaign/message? (Full parse is lazy.) */
+function hasCampaignsOrMessages(raw) {
+    const r = raw;
+    const len = (v) => (Array.isArray(v) ? v.length : 0);
+    return !!r && (len(r.campaigns) > 0 || len(r.inAppMessages) > 0);
+}
+export class EngageFeature {
+    constructor() {
+        this.name = 'engage';
+        this.ctx = null;
+        this.active = false;
+        this.screen = '';
+        // E1 — cold-start ring (open until the first config resolve; entries replayed on arm).
+        this.buffer = [];
+        this.bufferOpen = true;
+    }
+    get isActive() {
+        return this.active;
+    }
+    async setup(ctx) {
+        this.ctx = ctx;
+        if (typeof window === 'undefined' || typeof document === 'undefined')
+            return;
+        const clientKey = ctx.clientKey ?? '';
+        if (!clientKey || !ctx.apiBaseUrl)
+            return;
+        this.transport = new EngageTransport(ctx.apiBaseUrl, clientKey);
+        this.screen = currentPath();
+        this.active = true;
+        /**
+         * Recover anything a previous page load could not deliver.
+         *
+         * A submitted response that never reached the server is the worst failure this feature has — the
+         * visitor answered, saw the thank-you, and nothing arrived. Deliberately NOT awaited: replaying
+         * old answers must never delay this session's config fetch, and the backend is idempotent on
+         * `responseId`, so a replay of something that did land collapses server-side.
+         */
+        void this.transport.flushParked();
+        // Subscribe to producers BEFORE the config fetch so signals/navigation during the fetch are buffered.
+        this.unsub = ctx.onSignal((r) => this.onSignal(r));
+        this.onPop = () => this.onScreenView(currentPath());
+        window.addEventListener('popstate', this.onPop);
+        // Session-lifecycle triggers — fired now, buffered until the runtime arms in refresh().
+        const count = this.bumpSessionCount();
+        this.onLifecycle('session_start');
+        this.onLifecycle('app_open');
+        this.onLifecycle('n_sessions', count);
+        await this.refresh();
+    }
+    /** Fetch engage config; lazy-load + (re)arm the runtime when campaigns are present, then drain the
+     *  cold-start buffer. The heavy normalizer + matcher stay in the lazy chunk — core does only a shallow
+     *  presence check (an empty config is the common case and must cost ~nothing). */
+    async refresh() {
+        if (!this.transport)
+            return;
+        const raw = await this.transport.fetchConfig({
+            platform: 'web',
+            appVersion: this.ctx?.appVersion, // E0 — backend uses it for the minAppVersion gate
+            deviceId: this.ctx?.deviceId,
+            endUserId: this.ctx?.getUserId?.(), // backend resolves segment targeting off this
+        });
+        if (!hasCampaignsOrMessages(raw)) {
+            this.runtime?.setCampaigns([]);
+            this.runtime?.setMessages([]);
+            this.closeBuffer(); // cold-start window is over; nothing wanted the pre-config events
+            return;
+        }
+        const { normalizeConfig } = await import('./normalize');
+        const cfg = normalizeConfig(raw);
+        const rt = await this.ensureRuntime();
+        if (!rt)
+            return;
+        rt.setCampaigns(cfg.campaigns);
+        rt.setMessages(cfg.inAppMessages);
+        this.drain(rt); // replay buffered pre-config triggers against the now-loaded items
+    }
+    /** Lazy-load + construct the runtime on first need (config load, or a programmatic
+     *  emitRatingEvent/submit). Returns undefined only before setup / without a transport. */
+    async ensureRuntime() {
+        if (this.runtime)
+            return this.runtime;
+        if (!this.transport)
+            return undefined;
+        const { EngageRuntime } = await import('./runtime');
+        this.runtime = new EngageRuntime({
+            transport: this.transport,
+            deviceId: this.ctx?.deviceId ?? '',
+            sessionId: this.ctx?.sessionId ?? '',
+            uuid,
+            now,
+            currentScreen: () => this.screen,
+            replayCoord: getReplayCoord, // E6 — stamp the current replay frame on every engage signal
+            signal: (r) => this.ctx?.signal(r), // W5.1 — lets the runtime emit 'shake' onto the capture bus
+            // Forwarded opaquely; the runtime (lazy) is where it regains its real type.
+            ...(this.ctx?.onInAppGameRequest ? { gameHandler: this.ctx.onInAppGameRequest } : {}),
+        });
+        return this.runtime;
+    }
+    // ── E2 public surface (facade delegates here) ──────────────────────────────────
+    /** Programmatic submit for a host's own survey UI → 'success'|'error' (transport-retried). */
+    async submit(surveyId, result) {
+        const rt = await this.ensureRuntime();
+        return rt ? rt.submitFor(surveyId, result) : 'error';
+    }
+    /** Emit one rating-funnel event (works even without a served campaign). */
+    emitRatingEvent(type, input) {
+        void this.ensureRuntime().then((rt) => rt?.emitRatingEvent(type, input));
+    }
+    /** Dev/QA — clear on-device engage state (throttle/session/test-seen) so campaigns show again. */
+    async resetInAppState() {
+        const { clearEngageState } = await import('./throttle');
+        clearEngageState();
+    }
+    // ── Host-/producer-driven triggers (forward live, or buffer during cold-start) ──
+    onScreenView(screen) {
+        this.screen = screen; // keep the current screen accurate even while buffering (used on responses)
+        this.feed('screen', screen);
+    }
+    /**
+     * Identity changed (the host called identify()) — re-fetch config.
+     *
+     * The boot fetch is normally anonymous and the backend serves NO segment-targeted campaign to an
+     * anonymous request (it fails closed), so without this a visitor who logs in mid-session would see
+     * none of their targeted surveys or messages until a full page load.
+     */
+    onIdentify() {
+        if (this.active)
+            void this.refresh();
+    }
+    onCustomEvent(name) {
+        this.feed('custom', name);
+    }
+    onSignal(reason) {
+        this.feed('signal', reason);
+    }
+    onLifecycle(kind, count) {
+        this.feed('lifecycle', kind, count);
+    }
+    feed(ch, value, arg) {
+        if (this.runtime) {
+            this.dispatch(this.runtime, ch, value, arg, 0);
+            return;
+        }
+        if (!this.bufferOpen)
+            return;
+        this.buffer.push({ ch, value, arg, at: now() });
+        if (this.buffer.length > BUF_CAP)
+            this.buffer.shift(); // drop the oldest — bounded ring
+    }
+    dispatch(rt, ch, value, arg, elapsed) {
+        switch (ch) {
+            case 'screen':
+                rt.onScreenView(value, elapsed);
+                break;
+            case 'custom':
+                rt.onCustomEvent(value, elapsed);
+                break;
+            case 'signal':
+                rt.onSignal(value, elapsed);
+                break;
+            case 'lifecycle':
+                rt.onLifecycle(value, arg, elapsed);
+                break;
+        }
+    }
+    /** Replay the cold-start buffer into the armed runtime, honouring each entry's remaining delay. */
+    drain(rt) {
+        const cutoff = now() - BUF_TTL_MS;
+        for (const e of this.buffer) {
+            if (e.at < cutoff)
+                continue; // stale → drop
+            this.dispatch(rt, e.ch, e.value, e.arg, now() - e.at);
+        }
+        this.closeBuffer();
+    }
+    closeBuffer() {
+        this.bufferOpen = false;
+        this.buffer = [];
+    }
+    /** Running session number, persisted across launches; bumped exactly once per new session. */
+    bumpSessionCount() {
+        try {
+            const sid = this.ctx?.sessionId ?? '';
+            const raw = localStorage.getItem(SESSIONS_KEY);
+            const prev = raw ? JSON.parse(raw) : {};
+            if (prev.sessionId === sid && typeof prev.count === 'number')
+                return prev.count; // same session → no bump
+            const count = (typeof prev.count === 'number' ? prev.count : 0) + 1;
+            localStorage.setItem(SESSIONS_KEY, JSON.stringify({ sessionId: sid, count }));
+            return count;
+        }
+        catch {
+            return 1;
+        }
+    }
+    teardown() {
+        this.unsub?.();
+        this.unsub = undefined;
+        if (this.onPop && typeof window !== 'undefined')
+            window.removeEventListener('popstate', this.onPop);
+        this.onPop = undefined;
+        this.runtime?.stop();
+        this.runtime = undefined;
+        this.closeBuffer();
+        this.active = false;
+    }
+}
+//# sourceMappingURL=EngageFeature.js.map

package/dist/features/engage/EngageFeature.js.map

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

package/dist/features/engage/attachments.d.ts

@@ -0,0 +1,24 @@
+/**
+ * E3 — feedback attachment capture (LAZY chunk; loaded only when a survey has a screenshot/voice
+ * question). Zero third-party: screenshots reuse the replay masked DOM-snapshot (privacy-safe, no
+ * permission prompt, no rasterizer); voice uses MediaRecorder + optional Web Speech transcription.
+ * Every capture is feature-detected and degrades to null on unsupported/denied — never throws.
+ */
+import { type AttachmentDraft } from './types';
+/** Capture a masked DOM snapshot of the current document as the "screenshot" attachment. Reuses the
+ *  replay engine's serializer so the same masking applies — raw PII never leaves the page. */
+export declare function captureScreenshot(mask: boolean): Promise<AttachmentDraft | null>;
+export interface VoiceRecorder {
+    /** Live interim transcript (Web Speech; best-effort). */
+    onInterim(cb: (text: string) => void): void;
+    /** Live input level 0..1 (AnalyserNode RMS; best-effort) for a record-UI waveform. */
+    onLevel(cb: (rms: number) => void): void;
+    /** Stop + resolve the draft (or null on failure). `transcript` is the interim STT, user-editable after. */
+    stop(): Promise<AttachmentDraft | null>;
+    /** Abort without producing a draft (releases the mic). */
+    cancel(): void;
+}
+/** Start a voice recording (prompts for the mic). Hard-caps at VOICE_MAX_DURATION_MS. Returns null when
+ *  unsupported or the user denies the mic. */
+export declare function startVoiceRecording(): Promise<VoiceRecorder | null>;
+//# sourceMappingURL=attachments.d.ts.map

package/dist/features/engage/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../src/features/engage/attachments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAItE;8FAC8F;AAC9F,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAoBtF;AAED,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,SAAS,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5C,sFAAsF;IACtF,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACzC,2GAA2G;IAC3G,IAAI,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACxC,0DAA0D;IAC1D,MAAM,IAAI,IAAI,CAAC;CAChB;AAkCD;8CAC8C;AAC9C,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAiHzE"}

package/dist/features/engage/attachments.js

@@ -0,0 +1,209 @@
+/**
+ * E3 — feedback attachment capture (LAZY chunk; loaded only when a survey has a screenshot/voice
+ * question). Zero third-party: screenshots reuse the replay masked DOM-snapshot (privacy-safe, no
+ * permission prompt, no rasterizer); voice uses MediaRecorder + optional Web Speech transcription.
+ * Every capture is feature-detected and degrades to null on unsupported/denied — never throws.
+ */
+import { VOICE_MAX_DURATION_MS } from './types';
+const SNAPSHOT_MIME = 'application/scalebun-snapshot+json';
+/** Capture a masked DOM snapshot of the current document as the "screenshot" attachment. Reuses the
+ *  replay engine's serializer so the same masking applies — raw PII never leaves the page. */
+export async function captureScreenshot(mask) {
+    if (typeof document === 'undefined')
+        return null;
+    try {
+        const [{ takeSnapshot }, { NodeRegistry }] = await Promise.all([
+            import('../replay/engine/snapshot'),
+            import('../replay/engine/nodeRegistry'),
+        ]);
+        const snapshot = takeSnapshot(document, new NodeRegistry(), { maskAllText: mask, maskAllInputs: mask });
+        const blob = new Blob([JSON.stringify(snapshot)], { type: SNAPSHOT_MIME });
+        return {
+            kind: 'screenshot',
+            blob,
+            contentType: SNAPSHOT_MIME,
+            width: typeof window !== 'undefined' ? window.innerWidth : undefined,
+            height: typeof window !== 'undefined' ? window.innerHeight : undefined,
+            masked: mask,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// mp4/AAC first: it plays in ALL browsers (the dashboard viewer must be able to replay the note),
+// and Safari records only mp4. webm/ogg (opus) follow for Chrome/Firefox; '' = browser default.
+const AUDIO_MIME_LADDER = [
+    'audio/mp4;codecs=mp4a.40.2',
+    'audio/mp4',
+    'audio/webm;codecs=opus',
+    'audio/webm',
+    'audio/ogg;codecs=opus',
+    '',
+];
+/** Construct + start a MediaRecorder, trying the mp4-first ladder. iOS Safari can report a mime as
+ *  supported via isTypeSupported yet throw NotSupportedError on start(), so we confirm each rung by
+ *  actually starting it and falling through on any throw. Returns null when nothing records. */
+function startRecorder(stream) {
+    const MR = typeof MediaRecorder !== 'undefined' ? MediaRecorder : undefined;
+    if (!MR)
+        return null;
+    for (const cand of AUDIO_MIME_LADDER) {
+        if (cand && !MR.isTypeSupported?.(cand))
+            continue;
+        try {
+            const rec = new MR(stream, cand ? { mimeType: cand } : undefined);
+            const chunks = [];
+            rec.ondataavailable = (e) => { if (e.data && e.data.size)
+                chunks.push(e.data); }; // wired before start()
+            rec.start();
+            return { rec, mime: cand || rec.mimeType || '', chunks };
+        }
+        catch {
+            /* rung failed (e.g. the iOS isTypeSupported lie) — try the next */
+        }
+    }
+    return null;
+}
+/** Start a voice recording (prompts for the mic). Hard-caps at VOICE_MAX_DURATION_MS. Returns null when
+ *  unsupported or the user denies the mic. */
+export async function startVoiceRecording() {
+    if (typeof navigator === 'undefined' || !navigator.mediaDevices?.getUserMedia || typeof MediaRecorder === 'undefined')
+        return null;
+    let stream;
+    try {
+        stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+    }
+    catch {
+        return null; // permission denied / no device
+    }
+    const started = startRecorder(stream);
+    if (!started) {
+        for (const t of stream.getTracks())
+            t.stop();
+        return null;
+    }
+    const { rec, mime, chunks } = started;
+    const startedAt = Date.now();
+    // Live input-level meter (AnalyserNode RMS; best-effort) for the record-UI waveform.
+    let levelCb;
+    let audioCtx;
+    let rafId;
+    try {
+        const AC = globalThis.AudioContext
+            ?? globalThis.webkitAudioContext;
+        if (AC && typeof requestAnimationFrame === 'function') {
+            audioCtx = new AC();
+            const analyser = audioCtx.createAnalyser();
+            analyser.fftSize = 512;
+            audioCtx.createMediaStreamSource(stream).connect(analyser);
+            const buf = new Float32Array(analyser.fftSize);
+            const tick = () => {
+                analyser.getFloatTimeDomainData(buf);
+                let sum = 0;
+                for (let i = 0; i < buf.length; i++)
+                    sum += buf[i] * buf[i];
+                levelCb?.(Math.sqrt(sum / buf.length));
+                rafId = requestAnimationFrame(tick);
+            };
+            rafId = requestAnimationFrame(tick);
+        }
+    }
+    catch {
+        /* meter is optional — recording proceeds without it */
+    }
+    // Optional live transcription (Chromium-mostly, best-effort — never a gate).
+    let interim = '';
+    let interimCb;
+    const SR = globalThis.SpeechRecognition
+        ?? globalThis.webkitSpeechRecognition;
+    let sr;
+    if (typeof SR === 'function') {
+        try {
+            const inst = new SR();
+            inst.continuous = true;
+            inst.interimResults = true;
+            inst.onresult = (e) => {
+                const results = e.results;
+                let text = '';
+                for (let i = 0; i < results.length; i++)
+                    text += results[i][0].transcript;
+                interim = text;
+                interimCb?.(interim);
+            };
+            // Prefer on-device recognition where the browser confirms a local model (Chrome 139+) — a
+            // privacy win (audio never leaves the device). Only enable when `available()` says so, so we
+            // don't disable the cloud fallback on browsers/languages without a local pack.
+            try {
+                const avail = SR.available;
+                if (typeof avail === 'function') {
+                    const lang = typeof navigator !== 'undefined' ? navigator.language || 'en-US' : 'en-US';
+                    if ((await avail({ langs: [lang], processLocally: true })) === 'available') {
+                        inst.processLocally = true;
+                    }
+                }
+            }
+            catch {
+                /* stay on the browser default (usually cloud) */
+            }
+            inst.start();
+            sr = inst;
+        }
+        catch {
+            /* STT unavailable — voice note still records */
+        }
+    }
+    const release = () => {
+        try {
+            sr?.stop();
+        }
+        catch { /* ignore */ }
+        if (rafId != null && typeof cancelAnimationFrame === 'function')
+            cancelAnimationFrame(rafId);
+        try {
+            void audioCtx?.close();
+        }
+        catch { /* ignore */ }
+        for (const t of stream.getTracks())
+            t.stop();
+    };
+    // Hard cap: auto-stop the recorder at the limit (server + this both enforce it).
+    const cap = setTimeout(() => { if (rec.state !== 'inactive')
+        rec.stop(); }, VOICE_MAX_DURATION_MS);
+    return {
+        onInterim(cb) { interimCb = cb; },
+        onLevel(cb) { levelCb = cb; },
+        cancel() { clearTimeout(cap); try {
+            if (rec.state !== 'inactive')
+                rec.stop();
+        }
+        catch { /* ignore */ } release(); },
+        stop() {
+            clearTimeout(cap);
+            return new Promise((resolve) => {
+                rec.onstop = () => {
+                    release();
+                    const durationMs = Math.min(VOICE_MAX_DURATION_MS - 1, Date.now() - startedAt); // never emit ≥ cap
+                    if (!chunks.length) {
+                        resolve(null);
+                        return;
+                    }
+                    const contentType = mime || (chunks[0].type || 'audio/webm');
+                    resolve({
+                        kind: 'voice',
+                        blob: new Blob(chunks, { type: contentType }),
+                        contentType,
+                        durationMs,
+                        transcript: interim || undefined,
+                        transcriptApproved: false,
+                    });
+                };
+                if (rec.state !== 'inactive')
+                    rec.stop();
+                else
+                    rec.onstop?.(new Event('stop'));
+            });
+        },
+    };
+}
+//# sourceMappingURL=attachments.js.map

package/dist/features/engage/attachments.js.map

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

package/dist/features/engage/gameLogic.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Game-outcome logic — the WEB mirror of the RN SDK's `features/engage/engageGameLogic.ts`.
+ *
+ * The client NEVER decides an outcome. Everything here either builds a request for the host's
+ * backend or REFUSES a result that backend returned. There is no randomness, no probability, and no
+ * grant logic — by construction, so that reviewing this file is enough to know the browser cannot
+ * award itself a prize.
+ *
+ * Mirrors the RN module's behaviour function-for-function (only the animation/gesture helpers are
+ * omitted — the web mechanic blocks own their own drawing). `npm run test:gameparity` reads the RN
+ * source from disk and fails if the action map or the request shapes drift.
+ *
+ * Lives in a lazy chunk: it serves 8 of 100 variants and core has ~250 B of headroom.
+ */
+import type { InAppGameAction, InAppGameRequest, InAppGameResult, InAppGameVariantKey } from './gameTypes';
+type Dict = Record<string, unknown>;
+export declare function isInAppGameVariant(value: unknown): value is InAppGameVariantKey;
+export declare function inAppGameActionFor(value: unknown): InAppGameAction | null;
+/** Presentation-declared ids are validation hints, never probability or grant logic. */
+export declare function inAppGameAllowedOutcomeIds(ext: unknown): string[];
+/** Build a correctly discriminated host request from the mounted game. */
+export declare function buildInAppGameRequest(input: {
+    campaignId: string;
+    gameKey: string;
+    variantKey: InAppGameVariantKey;
+    attemptId: string;
+    attempt: number;
+    payload?: Dict;
+    allowedOutcomeIds?: string[];
+}): InAppGameRequest;
+/**
+ * Reject malformed, mismatched, or presentation-incompatible backend results.
+ *
+ * This is the security boundary. A host that is buggy, compromised, or replaying an old response
+ * must not be able to make the SDK paint a prize the campaign never authored — so a mismatched
+ * `attemptId` throws, and an outcome outside `allowedOutcomeIds` throws even though the host is
+ * nominally the authority. The client still never DECIDES; it only refuses.
+ */
+export declare function validateInAppGameResult(request: InAppGameRequest, value: unknown): InAppGameResult;
+/**
+ * Send Test / live preview ONLY: normalize the dashboard's authored mock result.
+ *
+ * An author previewing a spin wheel has no backend to ask, and the registry marks these keys
+ * preview-only ("removed before campaign persistence"). So the authored `resultIndex` / `prize` /
+ * `resultSymbols` become a result in the same shape a real host returns — and it is run through
+ * `validateInAppGameResult` like any other, so the preview cannot show something production would
+ * refuse. Returns null when nothing was authored, which the caller surfaces rather than inventing.
+ */
+export declare function authoredPreviewGameResult(request: InAppGameRequest, ext: unknown): InAppGameResult | null;
+/**
+ * A stable idempotency key per (variant, attempt).
+ *
+ * The host is expected to make a repeated `attemptId` return the SAME grant rather than a second
+ * one, so the SDK must reuse the id across retries of the same attempt — a fresh id on every retry
+ * would silently turn one network hiccup into two prizes. Callers keep the map for the message's
+ * lifetime.
+ */
+export declare function attemptIdFor(store: Map<string, string>, variantKey: string, attempt: number, seq: () => number): string;
+export {};
+//# sourceMappingURL=gameLogic.d.ts.map

package/dist/features/engage/gameLogic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameLogic.d.ts","sourceRoot":"","sources":["../../../src/features/engage/gameLogic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAkBrB,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAMpC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAE/E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAEzE;AAED,wFAAwF;AACxF,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAUjE;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,mBAAmB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,GAAG,gBAAgB,CAuBnB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,GACb,eAAe,CA8DjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,OAAO,GACX,eAAe,GAAG,IAAI,CAqExB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,MAAM,GAChB,MAAM,CASR"}