ugly-app 0.1.488 → 0.1.490

package/dist/client/inspect/popups.js

@@ -0,0 +1,116 @@
+import { now } from './report.js';
+import { describeElement } from './selectors.js';
+const POPUP_SELECTOR = '[role=dialog], [role=alertdialog], [data-popup], [data-toast], [role=status]';
+export function installPopups(state) {
+    if (typeof MutationObserver === 'undefined')
+        return;
+    if (typeof document === 'undefined')
+        return;
+    const tracked = new WeakSet();
+    const obs = new MutationObserver((mutations) => {
+        for (const m of mutations) {
+            for (const node of Array.from(m.addedNodes)) {
+                if (node.nodeType !== 1)
+                    continue;
+                const el = node;
+                scanForPopups(el, tracked, state);
+            }
+        }
+    });
+    obs.observe(document.body, { childList: true, subtree: true });
+    scanForPopups(document.body, tracked, state);
+}
+function scanForPopups(root, tracked, state) {
+    const candidates = [];
+    if (root.matches?.(POPUP_SELECTOR))
+        candidates.push(root);
+    const inside = root.querySelectorAll?.(POPUP_SELECTOR);
+    if (inside)
+        candidates.push(...Array.from(inside));
+    for (const el of candidates) {
+        if (tracked.has(el))
+            continue;
+        tracked.add(el);
+        recordPopup(el, state);
+    }
+}
+function recordPopup(el, state) {
+    const mountStart = now();
+    const observer = new MutationObserver(() => {
+        // observe attribute changes for animation class flips
+    });
+    observer.observe(el, {
+        attributes: true,
+        attributeFilter: ['style', 'class'],
+    });
+    let enterDoneAt = mountStart;
+    let droppedFrames = 0;
+    const startStyle = window.getComputedStyle(el);
+    const transitionMs = parseTransitionMs(startStyle.transitionDuration);
+    const animationMs = parseTransitionMs(startStyle.animationDuration);
+    const expectedMs = Math.max(transitionMs, animationMs);
+    const finish = () => {
+        observer.disconnect();
+        const entry = {
+            ts: mountStart,
+            selector: describeElement(el),
+            mountMs: enterDoneAt - mountStart,
+            enterAnimationMs: expectedMs,
+            droppedFrames,
+        };
+        state.popups.push(entry);
+    };
+    const onEnd = () => {
+        enterDoneAt = now();
+        el.removeEventListener('animationend', onEnd);
+        el.removeEventListener('transitionend', onEnd);
+        finish();
+    };
+    if (expectedMs > 0) {
+        el.addEventListener('animationend', onEnd, { once: true });
+        el.addEventListener('transitionend', onEnd, { once: true });
+        setTimeout(() => {
+            if (!enterDoneAt || enterDoneAt === mountStart) {
+                enterDoneAt = now();
+                finish();
+            }
+        }, expectedMs + 500);
+    }
+    else {
+        enterDoneAt = now();
+        finish();
+    }
+    // Frame drop sampling during enter animation
+    if (expectedMs > 0 && typeof requestAnimationFrame !== 'undefined') {
+        const budget = 1000 / 60;
+        let last = now();
+        const sample = () => {
+            const t = now();
+            const delta = t - last;
+            last = t;
+            if (delta > budget * 1.5) {
+                droppedFrames += Math.floor(delta / budget) - 1;
+            }
+            if (t - mountStart < expectedMs)
+                requestAnimationFrame(sample);
+        };
+        requestAnimationFrame(sample);
+    }
+}
+function parseTransitionMs(value) {
+    if (!value)
+        return 0;
+    const parts = value.split(',').map((p) => p.trim());
+    let max = 0;
+    for (const p of parts) {
+        let ms = 0;
+        if (p.endsWith('ms'))
+            ms = parseFloat(p);
+        else if (p.endsWith('s'))
+            ms = parseFloat(p) * 1000;
+        if (ms > max)
+            max = ms;
+    }
+    return max;
+}
+//# sourceMappingURL=popups.js.map

package/dist/client/inspect/popups.js.map

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

package/dist/client/inspect/report.d.ts

@@ -0,0 +1,33 @@
+import { RingBuffer } from './buffer.js';
+import { type AnimationEntry, type ClsSpike, type CoveredInput, type LongTaskEntry, type OverlapEntry, type PopupEntry, type RouteTransition, type SafeAreaViolation, type UglyInspectConfig, type UglyInspectReport } from './types.js';
+export interface InspectState {
+    config: UglyInspectConfig;
+    cls: RingBuffer<ClsSpike>;
+    longTasks: RingBuffer<LongTaskEntry>;
+    overlaps: RingBuffer<OverlapEntry>;
+    safeAreaViolations: RingBuffer<SafeAreaViolation>;
+    animations: RingBuffer<AnimationEntry>;
+    popups: RingBuffer<PopupEntry>;
+    routeTransitions: RingBuffer<RouteTransition>;
+    startedAt: number;
+    onDemandOverlaps: () => OverlapEntry[];
+    onDemandSafeArea: () => SafeAreaViolation[];
+    onDemandKeyboard: () => {
+        isOpen: boolean;
+        height: number;
+        coveredInputs: CoveredInput[];
+    };
+}
+export declare function createState(overrides?: Partial<UglyInspectConfig>): InspectState;
+export declare function now(): number;
+export declare function readReport(state: InspectState, opts?: {
+    since?: number;
+}): UglyInspectReport;
+export declare function readSafeAreaInsets(): {
+    t: number;
+    r: number;
+    b: number;
+    l: number;
+};
+export declare function emit(state: InspectState, event: string, data: Record<string, unknown>): void;
+//# sourceMappingURL=report.d.ts.map

package/dist/client/inspect/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/client/inspect/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,YAAY,EAEjB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1B,SAAS,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;IACrC,QAAQ,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IACnC,kBAAkB,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAClD,UAAU,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAC/B,gBAAgB,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,YAAY,EAAE,CAAC;IACvC,gBAAgB,EAAE,MAAM,iBAAiB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,YAAY,EAAE,CAAC;KAC/B,CAAC;CACH;AAED,wBAAgB,WAAW,CACzB,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACrC,YAAY,CAgBd;AAED,wBAAgB,GAAG,IAAI,MAAM,CAI5B;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,EACnB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,iBAAiB,CA2CnB;AAmCD,wBAAgB,kBAAkB,IAAI;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,CAuCA;AAED,wBAAgB,IAAI,CAClB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAGN"}

package/dist/client/inspect/report.js

@@ -0,0 +1,126 @@
+import { RingBuffer } from './buffer.js';
+import { DEFAULT_CONFIG, } from './types.js';
+export function createState(overrides) {
+    const config = { ...DEFAULT_CONFIG, ...overrides };
+    return {
+        config,
+        cls: new RingBuffer(config.bufferSize),
+        longTasks: new RingBuffer(config.bufferSize),
+        overlaps: new RingBuffer(config.bufferSize),
+        safeAreaViolations: new RingBuffer(config.bufferSize),
+        animations: new RingBuffer(config.bufferSize),
+        popups: new RingBuffer(config.bufferSize),
+        routeTransitions: new RingBuffer(config.bufferSize),
+        startedAt: now(),
+        onDemandOverlaps: () => [],
+        onDemandSafeArea: () => [],
+        onDemandKeyboard: () => ({ isOpen: false, height: 0, coveredInputs: [] }),
+    };
+}
+export function now() {
+    if (typeof performance !== 'undefined' && performance.now)
+        return performance.timeOrigin + performance.now();
+    return Date.now();
+}
+export function readReport(state, opts) {
+    const since = opts?.since ?? state.startedAt;
+    const getTs = (e) => e.ts;
+    const clsSpikes = state.cls.since(since, getTs);
+    const longTasks = state.longTasks.since(since, getTs);
+    const continuousOverlaps = state.overlaps.since(since, getTs);
+    const continuousSafeArea = state.safeAreaViolations.since(since, getTs);
+    const animations = state.animations.since(since, getTs);
+    const popups = state.popups.since(since, getTs);
+    const routeTransitions = state.routeTransitions.since(since, getTs);
+    const overlaps = mergeUnique(continuousOverlaps, state.onDemandOverlaps(), (e) => `${e.a.selector}|${e.b.selector}`);
+    const safeAreaViolations = mergeUnique(continuousSafeArea, state.onDemandSafeArea(), (e) => `${e.selector}|${e.side}`);
+    const keyboard = state.onDemandKeyboard();
+    const viewport = getViewport();
+    const path = typeof window !== 'undefined' ? window.location.pathname : '/';
+    return {
+        viewport,
+        route: { path, transitions: routeTransitions },
+        cls: {
+            total: clsSpikes.reduce((s, e) => s + e.value, 0),
+            spikes: clsSpikes,
+        },
+        longTasks,
+        overlaps,
+        safeAreaViolations,
+        keyboard,
+        animations,
+        popups,
+    };
+}
+function mergeUnique(a, b, keyOf) {
+    const seen = new Set();
+    const out = [];
+    for (const item of a) {
+        const k = keyOf(item);
+        if (!seen.has(k)) {
+            seen.add(k);
+            out.push(item);
+        }
+    }
+    for (const item of b) {
+        const k = keyOf(item);
+        if (!seen.has(k)) {
+            seen.add(k);
+            out.push(item);
+        }
+    }
+    return out;
+}
+function getViewport() {
+    if (typeof window === 'undefined') {
+        return { w: 0, h: 0, dpr: 1, safeAreaInsets: { t: 0, r: 0, b: 0, l: 0 } };
+    }
+    const insets = readSafeAreaInsets();
+    return {
+        w: window.innerWidth,
+        h: window.innerHeight,
+        dpr: window.devicePixelRatio || 1,
+        safeAreaInsets: insets,
+    };
+}
+export function readSafeAreaInsets() {
+    if (typeof window === 'undefined')
+        return { t: 0, r: 0, b: 0, l: 0 };
+    const w = window;
+    if (w.__safeAreaInsets) {
+        return {
+            t: w.__safeAreaInsets.top,
+            r: w.__safeAreaInsets.right,
+            b: w.__safeAreaInsets.bottom,
+            l: w.__safeAreaInsets.left,
+        };
+    }
+    try {
+        const stored = localStorage.getItem('__safeAreaInsets');
+        if (stored) {
+            const parsed = JSON.parse(stored);
+            return {
+                t: parsed.top,
+                r: parsed.right,
+                b: parsed.bottom,
+                l: parsed.left,
+            };
+        }
+    }
+    catch {
+        // localStorage unavailable
+    }
+    const style = window.getComputedStyle(document.documentElement);
+    return {
+        t: parseInt(style.getPropertyValue('--safe-area-inset-top') || '0', 10),
+        r: parseInt(style.getPropertyValue('--safe-area-inset-right') || '0', 10),
+        b: parseInt(style.getPropertyValue('--safe-area-inset-bottom') || '0', 10),
+        l: parseInt(style.getPropertyValue('--safe-area-inset-left') || '0', 10),
+    };
+}
+export function emit(state, event, data) {
+    if (!state.config.emitConsoleWarn)
+        return;
+    console.warn(`[ugly.ux] ${event}`, data);
+}
+//# sourceMappingURL=report.js.map

package/dist/client/inspect/report.js.map

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

package/dist/client/inspect/route.d.ts

@@ -0,0 +1,3 @@
+import { type InspectState } from './report.js';
+export declare function installRouteTracker(state: InspectState): void;
+//# sourceMappingURL=route.d.ts.map

package/dist/client/inspect/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/client/inspect/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,aAAa,CAAC;AAErD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAmC7D"}

package/dist/client/inspect/route.js

@@ -0,0 +1,30 @@
+import { now } from './report.js';
+export function installRouteTracker(state) {
+    if (typeof window === 'undefined' || typeof history === 'undefined')
+        return;
+    let current = window.location.pathname;
+    const record = (to) => {
+        if (to === current)
+            return;
+        state.routeTransitions.push({ ts: now(), from: current, to });
+        current = to;
+    };
+    const wrap = (method) => {
+        const original = history[method].bind(history);
+        history[method] = function (data, title, url) {
+            original(data, title, url);
+            const path = typeof url === 'string'
+                ? new URL(url, window.location.href).pathname
+                : url instanceof URL
+                    ? url.pathname
+                    : window.location.pathname;
+            record(path);
+        };
+    };
+    wrap('pushState');
+    wrap('replaceState');
+    window.addEventListener('popstate', () => {
+        record(window.location.pathname);
+    });
+}
+//# sourceMappingURL=route.js.map

package/dist/client/inspect/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../../src/client/inspect/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,GAAG,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,UAAU,mBAAmB,CAAC,KAAmB;IACrD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO;IAE5E,IAAI,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAEvC,MAAM,MAAM,GAAG,CAAC,EAAU,EAAQ,EAAE;QAClC,IAAI,EAAE,KAAK,OAAO;YAAE,OAAO;QAC3B,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9D,OAAO,GAAG,EAAE,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,CAAyC,MAAS,EAAQ,EAAE;QACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAA6B,CAAC;QAC3E,OAAO,CAAC,MAAM,CAAC,GAAG,UAEhB,IAAa,EACb,KAAa,EACb,GAAyB;YAEzB,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC3B,MAAM,IAAI,GACR,OAAO,GAAG,KAAK,QAAQ;gBACrB,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ;gBAC7C,CAAC,CAAC,GAAG,YAAY,GAAG;oBAClB,CAAC,CAAC,GAAG,CAAC,QAAQ;oBACd,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,CAA6B,CAAC;IAChC,CAAC,CAAC;IAEF,IAAI,CAAC,WAAW,CAAC,CAAC;IAClB,IAAI,CAAC,cAAc,CAAC,CAAC;IACrB,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/client/inspect/safearea.d.ts

@@ -0,0 +1,5 @@
+import { type InspectState } from './report.js';
+import { type SafeAreaViolation } from './types.js';
+export declare function installSafeArea(state: InspectState): void;
+export declare function scanSafeArea(state: InspectState): SafeAreaViolation[];
+//# sourceMappingURL=safearea.d.ts.map

package/dist/client/inspect/safearea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safearea.d.ts","sourceRoot":"","sources":["../../../src/client/inspect/safearea.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,YAAY,EAA2B,MAAM,aAAa,CAAC;AAE/E,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAEzD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,EAAE,CA4CrE"}

package/dist/client/inspect/safearea.js

@@ -0,0 +1,57 @@
+import { emit, now, readSafeAreaInsets } from './report.js';
+import { describeElement, INTERACTIVE_SELECTOR } from './selectors.js';
+export function installSafeArea(state) {
+    state.onDemandSafeArea = () => scanSafeArea(state);
+}
+export function scanSafeArea(state) {
+    if (typeof document === 'undefined' || typeof window === 'undefined')
+        return [];
+    const insets = readSafeAreaInsets();
+    if (insets.t === 0 && insets.r === 0 && insets.b === 0 && insets.l === 0) {
+        return [];
+    }
+    const vw = window.innerWidth;
+    const vh = window.innerHeight;
+    const safeRect = {
+        left: insets.l,
+        top: insets.t,
+        right: vw - insets.r,
+        bottom: vh - insets.b,
+    };
+    const out = [];
+    const nodes = Array.from(document.querySelectorAll(INTERACTIVE_SELECTOR));
+    for (const el of nodes) {
+        const style = window.getComputedStyle(el);
+        if (style.display === 'none' || style.visibility === 'hidden')
+            continue;
+        if (parseFloat(style.opacity) === 0)
+            continue;
+        const r = el.getBoundingClientRect();
+        if (r.width <= 0 || r.height <= 0)
+            continue;
+        let side = null;
+        if (insets.t > 0 && r.top < safeRect.top)
+            side = 't';
+        else if (insets.b > 0 && r.bottom > safeRect.bottom)
+            side = 'b';
+        else if (insets.l > 0 && r.left < safeRect.left)
+            side = 'l';
+        else if (insets.r > 0 && r.right > safeRect.right)
+            side = 'r';
+        if (!side)
+            continue;
+        const entry = {
+            ts: now(),
+            selector: describeElement(el),
+            rect: { x: r.x, y: r.y, w: r.width, h: r.height },
+            side,
+        };
+        out.push(entry);
+        emit(state, 'safe-area.violation', {
+            selector: entry.selector,
+            side,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=safearea.js.map

package/dist/client/inspect/safearea.js.map

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

package/dist/client/inspect/selectors.d.ts

@@ -0,0 +1,4 @@
+export declare function describeElement(el: Element): string;
+export declare function isInteractive(el: Element): boolean;
+export declare const INTERACTIVE_SELECTOR = "[data-id], [role], button, input, select, textarea, a[href]";
+//# sourceMappingURL=selectors.d.ts.map

package/dist/client/inspect/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../../src/client/inspect/selectors.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAQnD;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAWlD;AAED,eAAO,MAAM,oBAAoB,gEAC8B,CAAC"}

package/dist/client/inspect/selectors.js

@@ -0,0 +1,26 @@
+export function describeElement(el) {
+    const dataId = el.getAttribute?.('data-id');
+    if (dataId)
+        return `[data-id=${dataId}]`;
+    const role = el.getAttribute?.('role');
+    const tag = el.tagName.toLowerCase();
+    if (el.id)
+        return `${tag}#${el.id}`;
+    if (role)
+        return `${tag}[role=${role}]`;
+    return tag;
+}
+export function isInteractive(el) {
+    if (el.hasAttribute('data-id'))
+        return true;
+    if (el.hasAttribute('role'))
+        return true;
+    const tag = el.tagName.toLowerCase();
+    return (tag === 'button' ||
+        tag === 'input' ||
+        tag === 'select' ||
+        tag === 'textarea' ||
+        tag === 'a');
+}
+export const INTERACTIVE_SELECTOR = '[data-id], [role], button, input, select, textarea, a[href]';
+//# sourceMappingURL=selectors.js.map

package/dist/client/inspect/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../src/client/inspect/selectors.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,EAAW;IACzC,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,MAAM;QAAE,OAAO,YAAY,MAAM,GAAG,CAAC;IACzC,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,EAAE,CAAC,EAAE;QAAE,OAAO,GAAG,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;IACpC,IAAI,IAAI;QAAE,OAAO,GAAG,GAAG,SAAS,IAAI,GAAG,CAAC;IACxC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAW;IACvC,IAAI,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,CACL,GAAG,KAAK,QAAQ;QAChB,GAAG,KAAK,OAAO;QACf,GAAG,KAAK,QAAQ;QAChB,GAAG,KAAK,UAAU;QAClB,GAAG,KAAK,GAAG,CACZ,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAC/B,6DAA6D,CAAC"}

package/dist/client/inspect/types.d.ts

@@ -0,0 +1,115 @@
+export interface DOMRectLike {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface ClsSpike {
+    ts: number;
+    value: number;
+    sources: string[];
+}
+export interface LongTaskEntry {
+    ts: number;
+    duration: number;
+    during?: string;
+}
+export interface RouteTransition {
+    ts: number;
+    from: string;
+    to: string;
+}
+export interface OverlapEntry {
+    ts: number;
+    a: {
+        selector: string;
+        rect: DOMRectLike;
+    };
+    b: {
+        selector: string;
+        rect: DOMRectLike;
+    };
+    overlapArea: number;
+}
+export interface SafeAreaViolation {
+    ts: number;
+    selector: string;
+    rect: DOMRectLike;
+    side: 't' | 'r' | 'b' | 'l';
+}
+export interface CoveredInput {
+    selector: string;
+    rect: DOMRectLike;
+    coveredPx: number;
+}
+export interface AnimationEntry {
+    ts: number;
+    element: string;
+    name: string;
+    startedAt: number;
+    durationMs: number;
+    droppedFrames: number;
+    longestFrameMs: number;
+}
+export interface PopupEntry {
+    ts: number;
+    selector: string;
+    mountMs: number;
+    enterAnimationMs: number;
+    droppedFrames: number;
+}
+export interface UglyInspectReport {
+    viewport: {
+        w: number;
+        h: number;
+        dpr: number;
+        safeAreaInsets: {
+            t: number;
+            r: number;
+            b: number;
+            l: number;
+        };
+    };
+    route: {
+        path: string;
+        transitions: RouteTransition[];
+    };
+    cls: {
+        total: number;
+        spikes: ClsSpike[];
+    };
+    longTasks: LongTaskEntry[];
+    overlaps: OverlapEntry[];
+    safeAreaViolations: SafeAreaViolation[];
+    keyboard: {
+        isOpen: boolean;
+        height: number;
+        coveredInputs: CoveredInput[];
+    };
+    animations: AnimationEntry[];
+    popups: PopupEntry[];
+}
+export interface UglyInspectConfig {
+    clsSpikeThreshold: number;
+    longTaskThreshold: number;
+    overlapMinAreaPx: number;
+    bufferSize: number;
+    emitConsoleWarn: boolean;
+}
+export declare const DEFAULT_CONFIG: UglyInspectConfig;
+declare global {
+    interface Window {
+        __uglyInspect?: (opts?: {
+            since?: number;
+        }) => UglyInspectReport;
+        __uglyInspectMark?: () => number;
+        __uglyInspectReset?: () => void;
+        __uglyInspectConfig?: Partial<UglyInspectConfig>;
+        __uglyRouter?: {
+            push: (path: string) => void;
+            replace: (path: string) => void;
+            currentPath: () => string;
+        };
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/inspect/types.d.ts.map

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

package/dist/client/inspect/types.js

@@ -0,0 +1,8 @@
+export const DEFAULT_CONFIG = {
+    clsSpikeThreshold: 0.05,
+    longTaskThreshold: 50,
+    overlapMinAreaPx: 4,
+    bufferSize: 500,
+    emitConsoleWarn: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/client/inspect/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/inspect/types.ts"],"names":[],"mappings":"AAkGA,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,EAAE;IACrB,gBAAgB,EAAE,CAAC;IACnB,UAAU,EAAE,GAAG;IACf,eAAe,EAAE,KAAK;CACvB,CAAC"}

package/dist/playwright/index.d.ts

@@ -1,4 +1,7 @@
 import type { Browser, Page } from '@playwright/test';
+import type { UglyInspectReport } from '../client/inspect/types.js';
+export type { UglyInspectReport } from '../client/inspect/types.js';
+export type { AnimationEntry, ClsSpike, CoveredInput, DOMRectLike, LongTaskEntry, OverlapEntry, PopupEntry, RouteTransition, SafeAreaViolation, UglyInspectConfig, } from '../client/inspect/types.js';
 /**
  * Inject a JWT auth token as a cookie so Playwright pages load authenticated.
  * Call this before page.goto() on any page requiring auth.
@@ -13,4 +16,24 @@ export declare function injectAuthCookie(page: Page, token: string): Promise<voi
  * Create a new browser page pre-authenticated with the given token.
  */
 export declare function createBotPage(browser: Browser, token: string): Promise<Page>;
+export interface InspectWindowOptions {
+    settleMs?: number;
+}
+export declare function waitForApp(page: Page, opts?: {
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function inspectMark(page: Page): Promise<number>;
+export declare function inspectRead(page: Page, since: number): Promise<UglyInspectReport>;
+export declare function inspectWindow(page: Page, interact: () => Promise<void>, opts?: InspectWindowOptions): Promise<UglyInspectReport>;
+export declare function setDevice(page: Page, device: 'desktop' | 'ios' | 'android'): Promise<void>;
+export declare function simulateKeyboard(page: Page, heightPx: number): Promise<void>;
+export interface ExpectCleanOptions {
+    maxCls?: number;
+    maxLongtasks?: number;
+    allowOverlaps?: boolean;
+    allowSafeAreaViolations?: boolean;
+    allowKeyboardCoverage?: boolean;
+    maxDroppedFrames?: number;
+}
+export declare function expectClean(page: Page, opts?: ExpectCleanOptions): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/playwright/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAItD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAIf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EACV,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAIpC;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAIf;AAOD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAI7D;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC7B,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAK5B;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,GACpC,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Df"}