uxinspect 0.2.0 → 0.11.0

package/dist/clickjacking-audit.js.map

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

package/dist/cls-culprit.d.ts

@@ -0,0 +1,36 @@
+import type { Page } from 'playwright';
+export interface RectLite {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ShiftSource {
+    selector: string;
+    currentRect: RectLite;
+    previousRect: RectLite;
+    shiftDistance: number;
+}
+export interface ShiftEntry {
+    value: number;
+    startTime: number;
+    hadRecentInput: boolean;
+    sources: ShiftSource[];
+}
+export interface ClsCulpritResult {
+    page: string;
+    cls: number;
+    shifts: ShiftEntry[];
+    topCulprits: {
+        selector: string;
+        contribution: number;
+        count: number;
+    }[];
+    hints: string[];
+    passed: boolean;
+}
+export interface ClsCulpritOptions {
+    durationMs?: number;
+}
+export declare function auditClsCulprit(page: Page, opts?: ClsCulpritOptions): Promise<ClsCulpritResult>;
+//# sourceMappingURL=cls-culprit.d.ts.map

package/dist/cls-culprit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cls-culprit.d.ts","sourceRoot":"","sources":["../src/cls-culprit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,QAAQ,CAAC;IACtB,YAAY,EAAE,QAAQ,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,WAAW,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyBD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAkM3B"}

package/dist/cls-culprit.js

@@ -0,0 +1,203 @@
+export async function auditClsCulprit(page, opts = {}) {
+    const durationMs = opts.durationMs ?? 5000;
+    await page.addInitScript(() => {
+        const w = window;
+        if (w.__uxi_cls_culprit)
+            return;
+        w.__uxi_cls_culprit = [];
+        function buildSelector(node) {
+            if (!node)
+                return '(anonymous)';
+            if (node.id)
+                return '#' + node.id;
+            const testId = node.getAttribute('data-testid');
+            if (testId)
+                return '[data-testid="' + testId + '"]';
+            const tag = node.tagName ? node.tagName.toLowerCase() : 'node';
+            const classAttr = node.getAttribute('class') || '';
+            const classes = classAttr
+                .split(/\s+/)
+                .filter((c) => c.length > 0)
+                .slice(0, 2)
+                .join('.');
+            let base = tag + (classes ? '.' + classes : '');
+            const parent = node.parentElement;
+            if (parent && !node.id && parent.tagName) {
+                const siblings = Array.from(parent.children).filter((c) => c.tagName === node.tagName);
+                if (siblings.length > 1) {
+                    const idx = siblings.indexOf(node);
+                    if (idx >= 0)
+                        base += ':nth-of-type(' + (idx + 1) + ')';
+                }
+            }
+            return base;
+        }
+        function rectLite(r) {
+            if (!r)
+                return { x: 0, y: 0, width: 0, height: 0 };
+            return {
+                x: r.x || 0,
+                y: r.y || 0,
+                width: r.width || 0,
+                height: r.height || 0,
+            };
+        }
+        function resolveElement(n) {
+            if (!n)
+                return null;
+            const node = n;
+            if (node.nodeType === 1)
+                return node;
+            if (node.nodeType === 3 && node.parentElement)
+                return node.parentElement;
+            return null;
+        }
+        try {
+            const po = new PerformanceObserver((list) => {
+                const store = w.__uxi_cls_culprit;
+                if (!store)
+                    return;
+                for (const entry of list.getEntries()) {
+                    const e = entry;
+                    const rawSources = [];
+                    const srcArr = e.sources || [];
+                    for (const s of srcArr) {
+                        const el = resolveElement(s.node);
+                        const prev = rectLite(s.previousRect);
+                        const curr = rectLite(s.currentRect);
+                        const shiftDistance = Math.abs(curr.x - prev.x) + Math.abs(curr.y - prev.y);
+                        let tagName = '';
+                        let hasWidthAttr = false;
+                        let hasHeightAttr = false;
+                        let position = '';
+                        let className = '';
+                        if (el) {
+                            tagName = el.tagName || '';
+                            hasWidthAttr = el.hasAttribute('width');
+                            hasHeightAttr = el.hasAttribute('height');
+                            className = (el.getAttribute('class') || '').toLowerCase();
+                            try {
+                                position = getComputedStyle(el).position || '';
+                            }
+                            catch {
+                                position = '';
+                            }
+                        }
+                        rawSources.push({
+                            selector: buildSelector(el),
+                            tagName,
+                            hasWidthAttr,
+                            hasHeightAttr,
+                            position,
+                            className,
+                            currentRect: curr,
+                            previousRect: prev,
+                            shiftDistance,
+                        });
+                    }
+                    store.push({
+                        value: e.value,
+                        startTime: e.startTime,
+                        hadRecentInput: e.hadRecentInput,
+                        sources: rawSources,
+                    });
+                }
+            });
+            po.observe({ type: 'layout-shift', buffered: true });
+        }
+        catch {
+            // PerformanceObserver unsupported; leave store empty
+        }
+    });
+    await page.waitForTimeout(durationMs);
+    const raw = await page.evaluate(() => {
+        const w = window;
+        return w.__uxi_cls_culprit ?? [];
+    });
+    const shifts = raw.map((s) => ({
+        value: s.value,
+        startTime: s.startTime,
+        hadRecentInput: s.hadRecentInput,
+        sources: s.sources.map((src) => ({
+            selector: src.selector,
+            currentRect: src.currentRect,
+            previousRect: src.previousRect,
+            shiftDistance: src.shiftDistance,
+        })),
+    }));
+    const cls = shifts.reduce((sum, s) => sum + (s.hadRecentInput ? 0 : s.value), 0);
+    const contribMap = new Map();
+    for (const s of raw) {
+        if (s.hadRecentInput)
+            continue;
+        const n = s.sources.length || 1;
+        const perSource = s.value / n;
+        for (const src of s.sources) {
+            const prev = contribMap.get(src.selector) ?? { contribution: 0, count: 0 };
+            contribMap.set(src.selector, {
+                contribution: prev.contribution + perSource,
+                count: prev.count + 1,
+            });
+        }
+    }
+    const topCulprits = [...contribMap.entries()]
+        .map(([selector, stats]) => ({
+        selector,
+        contribution: stats.contribution,
+        count: stats.count,
+    }))
+        .sort((a, b) => b.contribution - a.contribution)
+        .slice(0, 10);
+    const hints = collectHints(raw);
+    return {
+        page: page.url(),
+        cls,
+        shifts,
+        topCulprits,
+        hints,
+        passed: cls <= 0.1,
+    };
+}
+function collectHints(raw) {
+    const out = new Set();
+    const fontHeavyTags = new Set(['H1', 'H2', 'H3', 'H4', 'P', 'SPAN', 'A', 'DIV']);
+    for (const s of raw) {
+        if (s.hadRecentInput)
+            continue;
+        for (const src of s.sources) {
+            const tag = src.tagName.toUpperCase();
+            if ((tag === 'IMG' || tag === 'IFRAME') && (!src.hasWidthAttr || !src.hasHeightAttr)) {
+                out.add('add explicit width & height attributes to <' +
+                    tag.toLowerCase() +
+                    '> elements (e.g., ' +
+                    src.selector +
+                    ')');
+            }
+            if (tag === 'VIDEO') {
+                out.add('set aspect-ratio or poster dimensions on <video> (e.g., ' + src.selector + ')');
+            }
+            if (src.currentRect.y < 100 &&
+                fontHeavyTags.has(tag) &&
+                src.shiftDistance > 0) {
+                out.add('preload fonts + use font-display: optional to prevent top-of-page text reflow');
+            }
+            if (src.position === 'absolute' && src.shiftDistance > 0) {
+                out.add('avoid animating top/left on position:absolute elements; use transform instead (e.g., ' +
+                    src.selector +
+                    ')');
+            }
+            const cls = src.className;
+            if (cls.includes('ad') ||
+                cls.includes('banner') ||
+                cls.includes('cookie') ||
+                cls.includes('consent') ||
+                cls.includes('promo')) {
+                out.add('reserve space with min-height for dynamically injected elements (e.g., ' +
+                    src.selector +
+                    ')');
+            }
+        }
+    }
+    return [...out];
+}
+//# sourceMappingURL=cls-culprit.js.map

package/dist/cls-culprit.js.map

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

package/dist/cls-timeline.d.ts

@@ -0,0 +1,30 @@
+import type { Page } from 'playwright';
+export interface DOMRectReadOnlyLite {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface LayoutShiftSample {
+    time: number;
+    value: number;
+    hadRecentInput: boolean;
+    sources: {
+        selector: string;
+        preRect: DOMRectReadOnlyLite;
+        currRect: DOMRectReadOnlyLite;
+    }[];
+}
+export interface CLSTimelineResult {
+    page: string;
+    cls: number;
+    worstElements: {
+        selector: string;
+        totalShift: number;
+        occurrences: number;
+    }[];
+    timeline: LayoutShiftSample[];
+    passed: boolean;
+}
+export declare function captureClsTimeline(page: Page, durationMs?: number): Promise<CLSTimelineResult>;
+//# sourceMappingURL=cls-timeline.d.ts.map

package/dist/cls-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cls-timeline.d.ts","sourceRoot":"","sources":["../src/cls-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAE5F,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,mBAAmB,CAAC;QAAC,QAAQ,EAAE,mBAAmB,CAAA;KAAE,EAAE,CAAC;CAC9F;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/E,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,SAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgElG"}

package/dist/cls-timeline.js

@@ -0,0 +1,61 @@
+export async function captureClsTimeline(page, durationMs = 5000) {
+    await page.evaluate(() => {
+        window.__uxi_cls = [];
+        function selFor(node) {
+            if (!node)
+                return '(none)';
+            if (node.id)
+                return '#' + node.id;
+            const t = node.getAttribute?.('data-testid');
+            if (t)
+                return '[' + 'data-testid' + '="' + t + '"]';
+            const cls = (node.className || '').toString().split(' ').filter(Boolean).slice(0, 2).join('.');
+            return (node.tagName || 'node').toLowerCase() + (cls ? '.' + cls : '');
+        }
+        function rectLite(r) {
+            return { x: r?.x || 0, y: r?.y || 0, width: r?.width || 0, height: r?.height || 0 };
+        }
+        new PerformanceObserver((list) => {
+            for (const e of list.getEntries()) {
+                const shift = {
+                    time: e.startTime,
+                    value: e.value,
+                    hadRecentInput: e.hadRecentInput,
+                    sources: (e.sources || []).map((s) => ({
+                        selector: selFor(s.node),
+                        preRect: rectLite(s.previousRect),
+                        currRect: rectLite(s.currentRect),
+                    })),
+                };
+                window.__uxi_cls.push(shift);
+            }
+        }).observe({ type: 'layout-shift', buffered: true });
+    });
+    await new Promise((resolve) => setTimeout(resolve, durationMs));
+    const timeline = await page.evaluate(() => window.__uxi_cls ?? []);
+    const cls = timeline.reduce((sum, s) => sum + (s.hadRecentInput ? 0 : s.value), 0);
+    const totals = new Map();
+    for (const sample of timeline) {
+        if (sample.hadRecentInput)
+            continue;
+        for (const src of sample.sources) {
+            const prev = totals.get(src.selector) ?? { totalShift: 0, occurrences: 0 };
+            totals.set(src.selector, {
+                totalShift: prev.totalShift + sample.value,
+                occurrences: prev.occurrences + 1,
+            });
+        }
+    }
+    const worstElements = [...totals.entries()]
+        .map(([selector, stats]) => ({ selector, ...stats }))
+        .sort((a, b) => b.totalShift - a.totalShift)
+        .slice(0, 5);
+    return {
+        page: page.url(),
+        cls,
+        worstElements,
+        timeline,
+        passed: cls < 0.1,
+    };
+}
+//# sourceMappingURL=cls-timeline.js.map

package/dist/cls-timeline.js.map

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

package/dist/codegen-converter.d.ts

@@ -0,0 +1,19 @@
+import type { Flow } from './types.js';
+export interface ConversionWarning {
+    line: number;
+    snippet: string;
+    reason: string;
+}
+export interface ConversionResult {
+    flow: Flow;
+    warnings: ConversionWarning[];
+    unconverted: string[];
+    coverage: number;
+}
+export interface ConvertOptions {
+    flowName?: string;
+}
+export declare function convertCodegen(source: string, opts?: ConvertOptions): ConversionResult;
+export declare function convertCodegenFile(inPath: string, opts?: ConvertOptions): Promise<ConversionResult>;
+export declare function flowToPlaywrightSnippet(flow: Flow): string;
+//# sourceMappingURL=codegen-converter.d.ts.map

package/dist/codegen-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen-converter.d.ts","sourceRoot":"","sources":["../src/codegen-converter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAQ,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoSD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,gBAAgB,CA0BtF;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGzG;AAuCD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQ1D"}