uxinspect 0.2.0 → 0.11.0

package/dist/favicon-audit.js

@@ -0,0 +1,358 @@
+const MAX_SIZE_SAMPLES = 5;
+const REQUEST_TIMEOUT_MS = 10_000;
+const PNG_SIG = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+function parseSizesAttr(sizes) {
+    if (!sizes)
+        return [];
+    const out = [];
+    for (const token of sizes.split(/\s+/).filter((t) => t.length > 0)) {
+        if (token.toLowerCase() === 'any')
+            continue;
+        const m = /^(\d+)x(\d+)$/i.exec(token);
+        if (m) {
+            const w = Number.parseInt(m[1], 10);
+            const h = Number.parseInt(m[2], 10);
+            if (Number.isFinite(w) && Number.isFinite(h))
+                out.push({ w, h });
+        }
+    }
+    return out;
+}
+function extFromPath(urlStr) {
+    try {
+        const path = new URL(urlStr).pathname.toLowerCase();
+        const dot = path.lastIndexOf('.');
+        return dot >= 0 ? path.slice(dot + 1) : '';
+    }
+    catch {
+        return '';
+    }
+}
+function mimeMatches(declared, actual) {
+    if (!actual)
+        return true;
+    const d = declared.toLowerCase().trim();
+    const a = actual.toLowerCase().split(';')[0].trim();
+    if (d === a)
+        return true;
+    if ((d === 'image/jpg' && a === 'image/jpeg') || (d === 'image/jpeg' && a === 'image/jpg'))
+        return true;
+    return false;
+}
+function readPngSize(buf) {
+    if (buf.length < 24)
+        return null;
+    for (let i = 0; i < PNG_SIG.length; i++)
+        if (buf[i] !== PNG_SIG[i])
+            return null;
+    const w = buf.readUInt32BE(16);
+    const h = buf.readUInt32BE(20);
+    if (!Number.isFinite(w) || !Number.isFinite(h) || w === 0 || h === 0)
+        return null;
+    return { w, h };
+}
+function readJpegSize(buf) {
+    if (buf.length < 4 || buf[0] !== 0xff || buf[1] !== 0xd8)
+        return null;
+    let i = 2;
+    while (i < buf.length - 8) {
+        if (buf[i] !== 0xff) {
+            i++;
+            continue;
+        }
+        let marker = buf[i + 1];
+        while (marker === 0xff && i + 1 < buf.length) {
+            i++;
+            marker = buf[i + 1];
+        }
+        i += 2;
+        if (marker === 0xd8 || marker === 0xd9)
+            continue;
+        if (marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7))
+            continue;
+        if (i + 2 > buf.length)
+            return null;
+        const segLen = buf.readUInt16BE(i);
+        const isSof = (marker >= 0xc0 && marker <= 0xc3) || (marker >= 0xc5 && marker <= 0xc7) ||
+            (marker >= 0xc9 && marker <= 0xcb) || (marker >= 0xcd && marker <= 0xcf);
+        if (isSof) {
+            if (i + 7 > buf.length)
+                return null;
+            const h = buf.readUInt16BE(i + 3);
+            const w = buf.readUInt16BE(i + 5);
+            if (w === 0 || h === 0)
+                return null;
+            return { w, h };
+        }
+        i += segLen;
+    }
+    return null;
+}
+function detectSize(buf, ct) {
+    const c = (ct ?? '').toLowerCase();
+    if (c.includes('png'))
+        return readPngSize(buf);
+    if (c.includes('jpeg') || c.includes('jpg'))
+        return readJpegSize(buf);
+    return readPngSize(buf) ?? readJpegSize(buf);
+}
+async function collectLinks(page) {
+    return await page.evaluate(() => {
+        const rels = ['icon', 'apple-touch-icon', 'mask-icon', 'shortcut icon', 'manifest'];
+        const out = [];
+        const links = Array.from(document.querySelectorAll('link'));
+        for (const link of links) {
+            const relRaw = (link.getAttribute('rel') ?? '').trim().toLowerCase();
+            if (!relRaw)
+                continue;
+            const href = link.getAttribute('href');
+            if (!href)
+                continue;
+            const match = rels.find((r) => relRaw === r || relRaw.split(/\s+/).includes(r));
+            if (!match)
+                continue;
+            const rec = { rel: match, href };
+            const sizes = link.getAttribute('sizes');
+            if (sizes)
+                rec.sizes = sizes;
+            const type = link.getAttribute('type');
+            if (type)
+                rec.type = type;
+            out.push(rec);
+        }
+        return out;
+    });
+}
+function resolveAbs(href, base) {
+    try {
+        return new URL(href, base).toString();
+    }
+    catch {
+        return null;
+    }
+}
+async function fetchResource(page, url) {
+    try {
+        return await page.request.get(url, {
+            timeout: REQUEST_TIMEOUT_MS, failOnStatusCode: false, maxRedirects: 5,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+function applyHeaders(entry, res) {
+    entry.status = res.status();
+    const headers = res.headers();
+    const ct = headers['content-type'];
+    if (ct)
+        entry.contentType = ct;
+    const clen = headers['content-length'];
+    if (clen) {
+        const n = Number.parseInt(clen, 10);
+        if (Number.isFinite(n) && n >= 0)
+            entry.contentLengthBytes = n;
+    }
+    entry.exists = res.ok();
+}
+async function populateEntry(page, entry, sampleBudget) {
+    const res = await fetchResource(page, entry.href);
+    if (!res) {
+        entry.exists = false;
+        return;
+    }
+    applyHeaders(entry, res);
+    if (!entry.exists)
+        return;
+    const ct = entry.contentType;
+    const ext = extFromPath(entry.href);
+    const ctLower = (ct ?? '').toLowerCase();
+    const sizable = ctLower.includes('png') || ctLower.includes('jpeg') || ctLower.includes('jpg') ||
+        (!ct && (ext === 'png' || ext === 'jpg' || ext === 'jpeg'));
+    if (!sizable || sampleBudget.remaining <= 0)
+        return;
+    sampleBudget.remaining--;
+    try {
+        const body = await res.body();
+        if (entry.contentLengthBytes === undefined)
+            entry.contentLengthBytes = body.byteLength;
+        const dims = detectSize(body, ct);
+        if (dims) {
+            entry.actualWidth = dims.w;
+            entry.actualHeight = dims.h;
+        }
+    }
+    catch { /* body unavailable */ }
+}
+async function fetchManifest(page, manifestUrl) {
+    const res = await fetchResource(page, manifestUrl);
+    if (!res || !res.ok())
+        return null;
+    let text;
+    try {
+        text = await res.text();
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const raw = parsed.icons;
+    if (!Array.isArray(raw))
+        return { icons: [] };
+    const icons = [];
+    for (const item of raw) {
+        if (typeof item !== 'object' || item === null)
+            continue;
+        const src = item.src;
+        if (typeof src !== 'string' || src.length === 0)
+            continue;
+        const icon = { src };
+        const sizes = item.sizes;
+        if (typeof sizes === 'string')
+            icon.sizes = sizes;
+        const type = item.type;
+        if (typeof type === 'string')
+            icon.type = type;
+        icons.push(icon);
+    }
+    return { icons };
+}
+function evaluateEntry(entry, issues) {
+    if (!entry.exists) {
+        issues.push({
+            kind: 'favicon-404', href: entry.href,
+            detail: `${entry.rel} returned ${entry.status ?? 'no response'}`,
+        });
+        return;
+    }
+    if (entry.type && !mimeMatches(entry.type, entry.contentType)) {
+        issues.push({
+            kind: 'wrong-mime', href: entry.href,
+            detail: `declared type "${entry.type}" but server returned "${entry.contentType ?? 'unknown'}"`,
+        });
+    }
+    if (entry.actualWidth !== undefined && entry.actualHeight !== undefined) {
+        if (entry.actualWidth !== entry.actualHeight) {
+            issues.push({
+                kind: 'not-square', href: entry.href,
+                detail: `${entry.actualWidth}x${entry.actualHeight} is not square`,
+            });
+        }
+        for (const d of parseSizesAttr(entry.sizes)) {
+            if (entry.actualWidth < d.w || entry.actualHeight < d.h) {
+                issues.push({
+                    kind: 'too-small', href: entry.href,
+                    detail: `actual ${entry.actualWidth}x${entry.actualHeight} smaller than declared ${d.w}x${d.h}`,
+                });
+                break;
+            }
+        }
+    }
+}
+function buildEntry(rel, href, link) {
+    const entry = { rel, href, exists: false };
+    if (link.sizes)
+        entry.sizes = link.sizes;
+    if (link.type)
+        entry.type = link.type;
+    return entry;
+}
+export async function auditFavicons(page) {
+    const pageUrl = page.url();
+    const issues = [];
+    const icons = [];
+    const manifestIcons = [];
+    let rootFaviconIco = null;
+    const links = await collectLinks(page);
+    const sampleBudget = { remaining: MAX_SIZE_SAMPLES };
+    const manifestLinks = [];
+    const iconLinks = [];
+    for (const link of links) {
+        if (link.rel === 'manifest')
+            manifestLinks.push(link);
+        else
+            iconLinks.push(link);
+    }
+    for (const link of iconLinks) {
+        const abs = resolveAbs(link.href, pageUrl);
+        if (!abs)
+            continue;
+        const entry = buildEntry(link.rel, abs, link);
+        await populateEntry(page, entry, sampleBudget);
+        icons.push(entry);
+    }
+    let manifestFetched = false;
+    let manifestHadIcons = false;
+    for (const link of manifestLinks) {
+        const abs = resolveAbs(link.href, pageUrl);
+        if (!abs)
+            continue;
+        const parsed = await fetchManifest(page, abs);
+        if (!parsed) {
+            issues.push({
+                kind: 'manifest-not-fetchable', href: abs,
+                detail: 'manifest link declared but JSON could not be fetched or parsed',
+            });
+            continue;
+        }
+        manifestFetched = true;
+        if (parsed.icons.length > 0)
+            manifestHadIcons = true;
+        for (const icon of parsed.icons) {
+            const iconAbs = resolveAbs(icon.src, abs);
+            if (!iconAbs)
+                continue;
+            const entry = buildEntry('manifest', iconAbs, icon);
+            await populateEntry(page, entry, sampleBudget);
+            manifestIcons.push(entry);
+        }
+    }
+    const rootIcoUrl = resolveAbs('/favicon.ico', pageUrl);
+    if (rootIcoUrl) {
+        const entry = { rel: 'icon', href: rootIcoUrl, exists: false };
+        const res = await fetchResource(page, rootIcoUrl);
+        if (res)
+            applyHeaders(entry, res);
+        rootFaviconIco = entry;
+    }
+    const hasIconLink = iconLinks.some((l) => l.rel === 'icon' || l.rel === 'shortcut icon');
+    const hasAppleTouch = iconLinks.some((l) => l.rel === 'apple-touch-icon');
+    const hasManifest = manifestLinks.length > 0;
+    const rootIcoExists = rootFaviconIco?.exists ?? false;
+    if (!hasIconLink && !hasAppleTouch && !hasManifest && !rootIcoExists) {
+        issues.push({
+            kind: 'missing-favicon',
+            detail: 'no <link rel="icon">, apple-touch-icon, manifest, or /favicon.ico found',
+        });
+    }
+    for (const entry of icons)
+        evaluateEntry(entry, issues);
+    for (const entry of manifestIcons)
+        evaluateEntry(entry, issues);
+    if (!hasAppleTouch) {
+        issues.push({ kind: 'missing-apple-touch', detail: 'no <link rel="apple-touch-icon"> declared' });
+    }
+    if (hasManifest && manifestFetched && !manifestHadIcons) {
+        issues.push({ kind: 'missing-manifest-icon', detail: 'manifest was fetched but declares no icons[]' });
+    }
+    if (rootFaviconIco && !rootFaviconIco.exists) {
+        issues.push({
+            kind: 'root-favicon-ico-missing', href: rootFaviconIco.href,
+            detail: `/favicon.ico returned ${rootFaviconIco.status ?? 'no response'}`,
+        });
+    }
+    const fatal = new Set([
+        'missing-favicon', 'favicon-404', 'manifest-not-fetchable',
+    ]);
+    const passed = !issues.some((i) => fatal.has(i.kind));
+    return { page: pageUrl, icons, manifestIcons, rootFaviconIco, issues, passed };
+}
+//# sourceMappingURL=favicon-audit.js.map

package/dist/favicon-audit.js.map

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

package/dist/flaky-detector.d.ts

@@ -0,0 +1,32 @@
+import type { InspectConfig } from './types.js';
+export interface FlakyOptions {
+    runs: number;
+    concurrency?: number;
+    threshold?: number;
+}
+export interface FlowFlakiness {
+    name: string;
+    passes: number;
+    fails: number;
+    ratio: number;
+    flaky: boolean;
+    errors: string[];
+}
+export interface VisualFlakiness {
+    page: string;
+    viewport: string;
+    diffs: number[];
+    variance: number;
+}
+export interface FlakyReport {
+    totalRuns: number;
+    fullyPassing: number;
+    fullyFailing: number;
+    flows: FlowFlakiness[];
+    visualFlakiness: VisualFlakiness[];
+    flakyFlows: number;
+    passed: boolean;
+}
+export declare function detectFlakiness(cfg: InspectConfig, opts: FlakyOptions): Promise<FlakyReport>;
+export declare function formatFlakyReport(report: FlakyReport): string;
+//# sourceMappingURL=flaky-detector.d.ts.map

package/dist/flaky-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flaky-detector.d.ts","sourceRoot":"","sources":["../src/flaky-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAA6B,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAmLD,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CAsCtB;AA8BD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAqD7D"}

package/dist/flaky-detector.js

@@ -0,0 +1,254 @@
+const MAX_ERRORS_PER_FLOW = 5;
+const VISUAL_VARIANCE_EPSILON = 0.001;
+function clamp(value, min, max) {
+    if (Number.isNaN(value))
+        return min;
+    return Math.min(max, Math.max(min, Math.trunc(value)));
+}
+async function loadInspect() {
+    const mod = (await import('./index.js'));
+    return mod.inspect;
+}
+async function runSequential(inspectFn, cfg, runs) {
+    const results = [];
+    for (let i = 0; i < runs; i++) {
+        results.push(await inspectFn(cfg));
+    }
+    return results;
+}
+async function runConcurrent(inspectFn, cfg, runs, concurrency) {
+    const results = new Array(runs);
+    let nextIndex = 0;
+    async function worker() {
+        while (true) {
+            const index = nextIndex++;
+            if (index >= runs)
+                return;
+            results[index] = await inspectFn(cfg);
+        }
+    }
+    const workers = [];
+    const poolSize = Math.min(concurrency, runs);
+    for (let i = 0; i < poolSize; i++) {
+        workers.push(worker());
+    }
+    await Promise.all(workers);
+    return results;
+}
+function aggregateFlows(results, threshold, totalRuns) {
+    const acc = new Map();
+    for (const result of results) {
+        const flows = result.flows ?? [];
+        for (const flow of flows) {
+            let entry = acc.get(flow.name);
+            if (!entry) {
+                entry = {
+                    name: flow.name,
+                    passes: 0,
+                    fails: 0,
+                    errors: [],
+                    errorSet: new Set(),
+                };
+                acc.set(flow.name, entry);
+            }
+            if (flow.passed) {
+                entry.passes++;
+            }
+            else {
+                entry.fails++;
+            }
+            const errMsg = extractFlowError(flow);
+            if (errMsg && !entry.errorSet.has(errMsg)) {
+                entry.errorSet.add(errMsg);
+                if (entry.errors.length < MAX_ERRORS_PER_FLOW) {
+                    entry.errors.push(errMsg);
+                }
+            }
+        }
+    }
+    const out = [];
+    for (const entry of acc.values()) {
+        const denominator = entry.passes + entry.fails;
+        const ratio = denominator === 0 ? 0 : entry.fails / denominator;
+        const flaky = ratio > 0 && ratio < 1 && ratio >= threshold;
+        out.push({
+            name: entry.name,
+            passes: entry.passes,
+            fails: entry.fails,
+            ratio,
+            flaky,
+            errors: entry.errors,
+        });
+    }
+    // stabilise order: flaky first, then by name
+    out.sort((a, b) => {
+        if (a.flaky !== b.flaky)
+            return a.flaky ? -1 : 1;
+        return a.name.localeCompare(b.name);
+    });
+    void totalRuns;
+    return out;
+}
+function extractFlowError(flow) {
+    if (flow.error && flow.error.trim().length > 0)
+        return flow.error.trim();
+    for (const step of flow.steps ?? []) {
+        if (!step.passed && step.error && step.error.trim().length > 0) {
+            return step.error.trim();
+        }
+    }
+    return null;
+}
+function aggregateVisual(results) {
+    const buckets = new Map();
+    for (const result of results) {
+        const visuals = result.visual ?? [];
+        for (const v of visuals) {
+            const key = `${v.page}::${v.viewport}`;
+            let bucket = buckets.get(key);
+            if (!bucket) {
+                bucket = { page: v.page, viewport: v.viewport, diffs: [] };
+                buckets.set(key, bucket);
+            }
+            if (typeof v.diffRatio === 'number' && Number.isFinite(v.diffRatio)) {
+                bucket.diffs.push(v.diffRatio);
+            }
+        }
+    }
+    const out = [];
+    for (const bucket of buckets.values()) {
+        if (bucket.diffs.length < 2)
+            continue;
+        let min = bucket.diffs[0];
+        let max = bucket.diffs[0];
+        for (const d of bucket.diffs) {
+            if (d < min)
+                min = d;
+            if (d > max)
+                max = d;
+        }
+        const variance = max - min;
+        if (variance > VISUAL_VARIANCE_EPSILON) {
+            out.push({
+                page: bucket.page,
+                viewport: bucket.viewport,
+                diffs: bucket.diffs.slice(),
+                variance,
+            });
+        }
+    }
+    out.sort((a, b) => {
+        if (b.variance !== a.variance)
+            return b.variance - a.variance;
+        return `${a.page}::${a.viewport}`.localeCompare(`${b.page}::${b.viewport}`);
+    });
+    return out;
+}
+export async function detectFlakiness(cfg, opts) {
+    const runs = clamp(opts.runs, 2, 20);
+    const concurrency = clamp(opts.concurrency ?? 1, 1, 10);
+    const threshold = typeof opts.threshold === 'number' && Number.isFinite(opts.threshold)
+        ? Math.min(1, Math.max(0, opts.threshold))
+        : 0;
+    const inspectFn = await loadInspect();
+    const results = concurrency <= 1
+        ? await runSequential(inspectFn, cfg, runs)
+        : await runConcurrent(inspectFn, cfg, runs, concurrency);
+    let fullyPassing = 0;
+    let fullyFailing = 0;
+    for (const r of results) {
+        if (r.passed === true)
+            fullyPassing++;
+        else if (r.passed === false)
+            fullyFailing++;
+    }
+    const flows = aggregateFlows(results, threshold, runs);
+    const visualFlakiness = aggregateVisual(results);
+    let flakyFlows = 0;
+    for (const f of flows) {
+        if (f.flaky)
+            flakyFlows++;
+    }
+    return {
+        totalRuns: runs,
+        fullyPassing,
+        fullyFailing,
+        flows,
+        visualFlakiness,
+        flakyFlows,
+        passed: flakyFlows === 0 && fullyFailing === 0,
+    };
+}
+function trimOneLine(input, max) {
+    const collapsed = input.replace(/\s+/g, ' ').trim();
+    if (collapsed.length <= max)
+        return collapsed;
+    if (max <= 1)
+        return collapsed.slice(0, max);
+    return `${collapsed.slice(0, max - 1)}…`;
+}
+function padRight(s, width) {
+    if (s.length >= width)
+        return s;
+    return s + ' '.repeat(width - s.length);
+}
+function padLeft(s, width) {
+    if (s.length >= width)
+        return s;
+    return ' '.repeat(width - s.length) + s;
+}
+function formatPercent(ratio) {
+    const pct = ratio * 100;
+    if (!Number.isFinite(pct))
+        return '  0.0%';
+    return `${pct.toFixed(1)}%`;
+}
+function formatNumber(n, digits) {
+    if (!Number.isFinite(n))
+        return '0';
+    return n.toFixed(digits);
+}
+export function formatFlakyReport(report) {
+    const lines = [];
+    lines.push(`Flaky detector: ${report.totalRuns} runs`);
+    lines.push(`  ${report.fullyPassing} fully passing, ` +
+        `${report.fullyFailing} fully failing, ` +
+        `${report.flakyFlows} flaky flows`);
+    lines.push(`  status: ${report.passed ? 'PASS' : 'FAIL'}`);
+    if (report.flows.length > 0) {
+        lines.push('');
+        lines.push('Flows:');
+        const nameWidth = Math.min(32, Math.max(4, ...report.flows.map((f) => f.name.length)));
+        const header = `  ${padRight('name', nameWidth)}  ` +
+            `${padLeft('pass', 5)} ${padLeft('fail', 5)} ` +
+            `${padLeft('ratio', 7)}  flag  error`;
+        lines.push(header);
+        for (const f of report.flows) {
+            const name = trimOneLine(f.name, nameWidth);
+            const flag = f.flaky ? 'FLAKY' : f.fails === 0 ? 'ok   ' : 'fail ';
+            const err = f.errors.length > 0 ? trimOneLine(f.errors[0], 80) : '';
+            lines.push(`  ${padRight(name, nameWidth)}  ` +
+                `${padLeft(String(f.passes), 5)} ${padLeft(String(f.fails), 5)} ` +
+                `${padLeft(formatPercent(f.ratio), 7)}  ${flag} ${err}`.trimEnd());
+        }
+    }
+    if (report.visualFlakiness.length > 0) {
+        lines.push('');
+        lines.push('Visual flakiness:');
+        for (const v of report.visualFlakiness) {
+            let min = v.diffs[0] ?? 0;
+            let max = v.diffs[0] ?? 0;
+            for (const d of v.diffs) {
+                if (d < min)
+                    min = d;
+                if (d > max)
+                    max = d;
+            }
+            const key = trimOneLine(`${v.page}/${v.viewport}`, 50);
+            lines.push(`  ${key}: variance=${formatNumber(v.variance, 3)} ` +
+                `(min=${formatNumber(min, 3)} max=${formatNumber(max, 3)})`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=flaky-detector.js.map