uxinspect 0.2.0 → 0.11.0

package/dist/inp-audit.js

@@ -0,0 +1,202 @@
+const GOOD_THRESHOLD_MS = 200;
+const NEEDS_IMPROVEMENT_THRESHOLD_MS = 500;
+const DEFAULT_MAX_INTERACTIONS = 10;
+const DEFAULT_DELAY_MS = 500;
+const DURATION_THRESHOLD_MS = 16;
+const P98_MIN_SAMPLES = 50;
+export async function auditInp(page, opts = {}) {
+    const maxInteractions = opts.maxInteractions ?? DEFAULT_MAX_INTERACTIONS;
+    const delayBetweenMs = opts.delayBetweenMs ?? DEFAULT_DELAY_MS;
+    await installObserver(page);
+    const selectors = opts.interactSelectors && opts.interactSelectors.length > 0
+        ? opts.interactSelectors.slice(0, maxInteractions)
+        : await discoverInteractables(page, maxInteractions);
+    for (const selector of selectors) {
+        await page.click(selector, { trial: false, timeout: 2000 }).catch(() => { });
+        await page.waitForTimeout(delayBetweenMs);
+    }
+    await page.waitForTimeout(delayBetweenMs);
+    const records = await collectRecords(page);
+    const interactions = records.map((r) => ({
+        type: r.type,
+        target: r.target,
+        inputDelayMs: Math.max(0, r.inputDelayMs),
+        processingMs: Math.max(0, r.processingMs),
+        presentationDelayMs: Math.max(0, r.presentationDelayMs),
+        totalMs: Math.max(0, r.totalMs),
+        startTime: r.startTime,
+    }));
+    const inp = computeInp(interactions);
+    const good = inp !== null && inp <= GOOD_THRESHOLD_MS;
+    const poor = inp !== null && inp > NEEDS_IMPROVEMENT_THRESHOLD_MS;
+    const needsImprovement = inp !== null && !good && !poor;
+    const passed = !poor;
+    return {
+        page: page.url(),
+        interactions,
+        inp,
+        good,
+        needsImprovement,
+        poor,
+        passed,
+    };
+}
+async function installObserver(page) {
+    await page.evaluate((threshold) => {
+        const w = window;
+        if (w.__inpRecords)
+            return;
+        w.__inpRecords = [];
+        const cssPath = (el) => {
+            if (!el)
+                return '';
+            const parts = [];
+            let node = el;
+            let depth = 0;
+            while (node && node.nodeType === 1 && depth < 6) {
+                let part = node.tagName.toLowerCase();
+                if (node.id) {
+                    part += '#' + node.id;
+                    parts.unshift(part);
+                    break;
+                }
+                const parent = node.parentElement;
+                if (parent) {
+                    const siblings = Array.from(parent.children).filter((c) => c.tagName === node.tagName);
+                    if (siblings.length > 1) {
+                        const idx = siblings.indexOf(node) + 1;
+                        part += ':nth-of-type(' + idx + ')';
+                    }
+                }
+                parts.unshift(part);
+                node = parent;
+                depth++;
+            }
+            return parts.join(' > ');
+        };
+        const handle = (list) => {
+            const store = w.__inpRecords;
+            if (!store)
+                return;
+            for (const raw of list.getEntries()) {
+                const entry = raw;
+                const inputDelay = entry.processingStart - entry.startTime;
+                const processing = entry.processingEnd - entry.processingStart;
+                const presentation = (entry.startTime + entry.duration) - entry.processingEnd;
+                const tag = entry.target && entry.target.tagName ? entry.target.tagName.toLowerCase() : '';
+                const path = cssPath(entry.target ?? null);
+                const target = tag && path ? (path === tag ? tag : path) : (tag || path || '(unknown)');
+                store.push({
+                    type: entry.name,
+                    target,
+                    inputDelayMs: inputDelay,
+                    processingMs: processing,
+                    presentationDelayMs: presentation,
+                    totalMs: entry.duration,
+                    startTime: entry.startTime,
+                });
+            }
+        };
+        try {
+            const eventObs = new PerformanceObserver(handle);
+            eventObs.observe({ type: 'event', durationThreshold: threshold, buffered: true });
+        }
+        catch (_err) { /* unsupported */ }
+        try {
+            const firstInputObs = new PerformanceObserver(handle);
+            firstInputObs.observe({ type: 'first-input', buffered: true });
+        }
+        catch (_err) { /* unsupported */ }
+    }, DURATION_THRESHOLD_MS);
+}
+async function discoverInteractables(page, max) {
+    const discovered = await page.evaluate((limit) => {
+        const origin = window.location.origin;
+        const selectors = [];
+        const isVisible = (el) => {
+            const r = el.getBoundingClientRect();
+            if (r.width <= 0 || r.height <= 0)
+                return false;
+            const style = window.getComputedStyle(el);
+            if (style.visibility === 'hidden' || style.display === 'none')
+                return false;
+            if (parseFloat(style.opacity || '1') === 0)
+                return false;
+            return true;
+        };
+        const buildSelector = (el) => {
+            if (el.id)
+                return '#' + CSS.escape(el.id);
+            const parts = [];
+            let node = el;
+            let depth = 0;
+            while (node && node.nodeType === 1 && depth < 5) {
+                let part = node.tagName.toLowerCase();
+                const parent = node.parentElement;
+                if (parent) {
+                    const siblings = Array.from(parent.children).filter((c) => c.tagName === node.tagName);
+                    if (siblings.length > 1) {
+                        const idx = siblings.indexOf(node) + 1;
+                        part += ':nth-of-type(' + idx + ')';
+                    }
+                }
+                parts.unshift(part);
+                if (node.id) {
+                    parts[0] = node.tagName.toLowerCase() + '#' + CSS.escape(node.id);
+                    break;
+                }
+                node = parent;
+                depth++;
+            }
+            return parts.join(' > ');
+        };
+        const query = 'button, a[href], [role="button"], [role="menuitem"]';
+        const nodes = Array.from(document.querySelectorAll(query));
+        for (const node of nodes) {
+            if (selectors.length >= limit)
+                break;
+            if (!isVisible(node))
+                continue;
+            let navigates = false;
+            if (node.tagName === 'A') {
+                const href = node.getAttribute('href') || '';
+                if (href && !href.startsWith('#') && !href.startsWith('javascript:')) {
+                    try {
+                        const u = new URL(href, window.location.href);
+                        if (u.origin !== origin)
+                            navigates = true;
+                        else if (u.pathname !== window.location.pathname)
+                            navigates = true;
+                    }
+                    catch (_e) { /* ignore */ }
+                }
+            }
+            if (navigates)
+                continue;
+            selectors.push({ selector: buildSelector(node), navigates });
+        }
+        return selectors;
+    }, max);
+    return discovered.map((d) => d.selector).filter((s) => s.length > 0);
+}
+async function collectRecords(page) {
+    return page.evaluate(() => {
+        const w = window;
+        return w.__inpRecords ? w.__inpRecords.slice() : [];
+    });
+}
+function computeInp(interactions) {
+    if (interactions.length === 0)
+        return null;
+    const durations = interactions.map((i) => i.totalMs).filter((n) => Number.isFinite(n));
+    if (durations.length === 0)
+        return null;
+    if (durations.length >= P98_MIN_SAMPLES) {
+        const sorted = durations.slice().sort((a, b) => a - b);
+        const rank = Math.ceil(0.98 * sorted.length) - 1;
+        const idx = Math.min(Math.max(rank, 0), sorted.length - 1);
+        return sorted[idx];
+    }
+    return durations.reduce((m, v) => (v > m ? v : m), 0);
+}
+//# sourceMappingURL=inp-audit.js.map

package/dist/inp-audit.js.map

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

package/dist/js-coverage.d.ts

@@ -0,0 +1,20 @@
+import type { Page } from 'playwright';
+export interface JsCoverageFileEntry {
+    url: string;
+    total: number;
+    used: number;
+    unusedRatio: number;
+}
+export interface JsCoverageResult {
+    page: string;
+    totalBytes: number;
+    usedBytes: number;
+    unusedBytes: number;
+    unusedRatio: number;
+    byFile: JsCoverageFileEntry[];
+    passed: boolean;
+}
+export declare function auditJsCoverage(page: Page, opts?: {
+    threshold?: number;
+}): Promise<JsCoverageResult>;
+//# sourceMappingURL=js-coverage.d.ts.map

package/dist/js-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-coverage.d.ts","sourceRoot":"","sources":["../src/js-coverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;CACjB;AAqDD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAuD3B"}

package/dist/js-coverage.js

@@ -0,0 +1,81 @@
+function emptyResult(pageUrl) {
+    return {
+        page: pageUrl,
+        totalBytes: 0,
+        usedBytes: 0,
+        unusedBytes: 0,
+        unusedRatio: 0,
+        byFile: [],
+        passed: true,
+    };
+}
+function computeUsedBytes(entry) {
+    let used = 0;
+    for (const fn of entry.functions) {
+        for (const r of fn.ranges) {
+            if (r.count > 0) {
+                const len = r.endOffset - r.startOffset;
+                if (len > 0)
+                    used += len;
+            }
+        }
+    }
+    return used;
+}
+export async function auditJsCoverage(page, opts) {
+    const threshold = opts?.threshold ?? 0.4;
+    const pageUrl = page.url();
+    const coverage = page.coverage;
+    if (!coverage)
+        return emptyResult(pageUrl);
+    await coverage.startJSCoverage({ resetOnNavigation: false });
+    await page.reload({ waitUntil: 'networkidle' });
+    const entries = await coverage.stopJSCoverage();
+    const agg = new Map();
+    for (const entry of entries) {
+        if (!entry.url || entry.url.startsWith('data:'))
+            continue;
+        const total = entry.source?.length ?? 0;
+        if (total <= 0)
+            continue;
+        let used = computeUsedBytes(entry);
+        if (used > total)
+            used = total;
+        const prev = agg.get(entry.url);
+        if (prev) {
+            prev.total += total;
+            prev.used += used;
+        }
+        else {
+            agg.set(entry.url, { total, used });
+        }
+    }
+    let totalBytes = 0;
+    let usedBytes = 0;
+    const files = [];
+    for (const [url, v] of agg) {
+        totalBytes += v.total;
+        usedBytes += v.used;
+        const unused = Math.max(0, v.total - v.used);
+        files.push({
+            url,
+            total: v.total,
+            used: v.used,
+            unusedRatio: v.total > 0 ? unused / v.total : 0,
+        });
+    }
+    const unusedBytes = Math.max(0, totalBytes - usedBytes);
+    const unusedRatio = totalBytes > 0 ? unusedBytes / totalBytes : 0;
+    const byFile = files.sort((a, b) => b.unusedRatio - a.unusedRatio).slice(0, 30);
+    const passed = totalBytes === 0 ? true : unusedRatio <= threshold;
+    return {
+        page: pageUrl,
+        totalBytes,
+        usedBytes,
+        unusedBytes,
+        unusedRatio,
+        byFile,
+        passed,
+    };
+}
+//# sourceMappingURL=js-coverage.js.map

package/dist/js-coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-coverage.js","sourceRoot":"","sources":["../src/js-coverage.ts"],"names":[],"mappings":"AA6CA,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAoB;IAC5C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBAChB,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC;gBACxC,IAAI,GAAG,GAAG,CAAC;oBAAE,IAAI,IAAI,GAAG,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAU,EACV,IAA6B;IAE7B,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,GAAG,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAI,IAAoC,CAAC,QAAQ,CAAC;IAChE,IAAI,CAAC,QAAQ;QAAE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,QAAQ,CAAC,eAAe,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,CAAC;IAEhD,MAAM,GAAG,GAAG,IAAI,GAAG,EAA2C,CAAC;IAC/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QACzB,IAAI,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,IAAI,GAAG,KAAK;YAAE,IAAI,GAAG,KAAK,CAAC;QAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;YACpB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,KAAK,GAA0B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;QAC3B,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC;QACtB,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC;YACT,GAAG;YACH,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAChD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,OAAO;QACb,UAAU;QACV,SAAS;QACT,WAAW;QACX,WAAW;QACX,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/json-schema.d.ts

@@ -0,0 +1,27 @@
+export interface JsonSchema {
+    $schema?: string;
+    $id?: string;
+    $ref?: string;
+    title?: string;
+    description?: string;
+    type?: string | string[];
+    required?: string[];
+    properties?: Record<string, JsonSchema>;
+    additionalProperties?: boolean | JsonSchema;
+    items?: JsonSchema | JsonSchema[];
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    enum?: unknown[];
+    const?: unknown;
+    definitions?: Record<string, JsonSchema>;
+    minimum?: number;
+    maximum?: number;
+    pattern?: string;
+    format?: string;
+    default?: unknown;
+    examples?: unknown[];
+}
+export declare function generateConfigSchema(): JsonSchema;
+export declare function writeSchemaFile(outPath: string): Promise<void>;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../src/json-schema.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAyRD,wBAAgB,oBAAoB,IAAI,UAAU,CAyDjD;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpE"}

package/dist/json-schema.js

@@ -0,0 +1,284 @@
+import { writeFile } from 'node:fs/promises';
+function obj(properties, required, additional = false) {
+    const s = { type: 'object', properties };
+    if (required && required.length)
+        s.required = required;
+    s.additionalProperties = additional;
+    return s;
+}
+function boolOrOpts(optsProps) {
+    if (!optsProps)
+        return { type: 'boolean' };
+    return {
+        oneOf: [{ type: 'boolean' }, obj(optsProps)],
+    };
+}
+function str(extra = {}) {
+    return { type: 'string', ...extra };
+}
+function num(extra = {}) {
+    return { type: 'number', ...extra };
+}
+function bool() {
+    return { type: 'boolean' };
+}
+function arr(items) {
+    return { type: 'array', items };
+}
+function enumStr(values) {
+    return { type: 'string', enum: values };
+}
+function singleKeyStep(key, valueSchema, description) {
+    const properties = { [key]: valueSchema };
+    const s = obj(properties, [key]);
+    if (description)
+        s.description = description;
+    return s;
+}
+function buildChecksSchema() {
+    const properties = {
+        a11y: boolOrOpts(),
+        perf: boolOrOpts(),
+        visual: boolOrOpts(),
+        explore: boolOrOpts({ maxClicks: num() }),
+        seo: boolOrOpts(),
+        links: boolOrOpts({ maxLinks: num(), sameOriginOnly: bool() }),
+        pwa: boolOrOpts(),
+        security: boolOrOpts(),
+        retire: boolOrOpts(),
+        deadClicks: boolOrOpts({ maxElements: num(), waitAfterClickMs: num() }),
+        touchTargets: boolOrOpts({ minSize: num(), onlyViewport: bool() }),
+        keyboard: boolOrOpts({ maxTabs: num(), requireFocusRing: bool() }),
+        longTasks: boolOrOpts({ durationMs: num() }),
+        clsTimeline: boolOrOpts({ durationMs: num() }),
+        forms: boolOrOpts(),
+        structuredData: boolOrOpts(),
+        passiveSecurity: boolOrOpts(),
+        consoleErrors: boolOrOpts(),
+        sitemap: boolOrOpts({ checkUrls: bool(), sampleSize: num() }),
+        redirects: boolOrOpts({ maxHops: num() }),
+        exposedPaths: boolOrOpts({ concurrency: num(), extraPaths: arr(str()) }),
+        tls: boolOrOpts(),
+        crawl: boolOrOpts({ maxDepth: num(), maxPages: num(), sameOriginOnly: bool() }),
+        contentQuality: boolOrOpts({ minWords: num(), dupThreshold: num() }),
+        resourceHints: boolOrOpts(),
+        mixedContent: boolOrOpts(),
+        compression: boolOrOpts(),
+        cacheHeaders: boolOrOpts(),
+        cookieBanner: boolOrOpts(),
+        thirdParty: boolOrOpts(),
+        bundleSize: boolOrOpts(),
+        openGraph: boolOrOpts(),
+        robotsAudit: boolOrOpts(),
+        imageAudit: boolOrOpts(),
+        webfonts: boolOrOpts(),
+        motionPrefs: boolOrOpts(),
+        serviceWorker: boolOrOpts(),
+        rum: boolOrOpts({ durationMs: num() }),
+        amp: boolOrOpts(),
+        jsCoverage: boolOrOpts({ threshold: num() }),
+        cssCoverage: boolOrOpts({ threshold: num() }),
+        domSize: boolOrOpts({ maxNodes: num(), maxDepth: num(), maxChildren: num() }),
+        ariaAudit: boolOrOpts(),
+        headings: boolOrOpts(),
+        langAudit: boolOrOpts(),
+        protocols: boolOrOpts(),
+        fontLoading: boolOrOpts(),
+        prerenderAudit: boolOrOpts(),
+        headlessDetect: boolOrOpts(),
+        animations: boolOrOpts(),
+        eventListeners: boolOrOpts(),
+        darkMode: boolOrOpts({ screenshotDir: str(), sampleSelectors: arr(str()) }),
+        tables: boolOrOpts(),
+        svgs: boolOrOpts(),
+        media: boolOrOpts(),
+        readingLevel: boolOrOpts({ maxGrade: num(), mainSelector: str() }),
+        deadImages: boolOrOpts(),
+        pagination: boolOrOpts({ scrollProbes: num() }),
+        print: boolOrOpts({ screenshotPath: str() }),
+        canonical: boolOrOpts({ followChain: bool() }),
+    };
+    return obj(properties);
+}
+function buildStepVariants() {
+    const selText = obj({ selector: str(), text: str() }, ['selector', 'text']);
+    const httpMethod = enumStr(['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS']);
+    return [
+        singleKeyStep('goto', str(), 'Navigate to a URL or path.'),
+        singleKeyStep('click', str(), 'Click a selector.'),
+        singleKeyStep('type', selText, 'Type text into a field.'),
+        singleKeyStep('fill', selText, 'Fill a field (clears first).'),
+        singleKeyStep('waitFor', str(), 'Wait for a selector.'),
+        singleKeyStep('screenshot', str(), 'Capture a screenshot with the given name.'),
+        singleKeyStep('ai', str(), 'Natural-language AI-driven step.'),
+        singleKeyStep('drag', obj({ from: str(), to: str() }, ['from', 'to'])),
+        singleKeyStep('upload', obj({ selector: str(), files: { oneOf: [str(), arr(str())] } }, ['selector', 'files'])),
+        singleKeyStep('dialog', {
+            oneOf: [
+                enumStr(['accept', 'dismiss']),
+                obj({ accept: bool(), text: str() }),
+            ],
+        }),
+        singleKeyStep('scroll', obj({ selector: str(), x: num(), y: num() })),
+        singleKeyStep('select', obj({ selector: str(), value: { oneOf: [str(), arr(str())] } }, ['selector', 'value'])),
+        singleKeyStep('key', str(), 'Press a keyboard key.'),
+        singleKeyStep('eval', str(), 'Evaluate a JS expression in the page.'),
+        singleKeyStep('waitForResponse', {
+            oneOf: [str(), obj({ url: str(), status: num() }, ['url'])],
+        }),
+        singleKeyStep('waitForRequest', str()),
+        singleKeyStep('hover', str()),
+        singleKeyStep('check', str()),
+        singleKeyStep('uncheck', str()),
+        singleKeyStep('focus', str()),
+        singleKeyStep('blur', str()),
+        singleKeyStep('reload', { const: true }),
+        singleKeyStep('back', { const: true }),
+        singleKeyStep('forward', { const: true }),
+        singleKeyStep('newTab', str()),
+        singleKeyStep('switchTab', { oneOf: [num(), str()] }),
+        singleKeyStep('closeTab', { const: true }),
+        singleKeyStep('iframe', obj({
+            selector: str(),
+            steps: arr({ $ref: '#/definitions/Step' }),
+        }, ['selector', 'steps'])),
+        singleKeyStep('sleep', num(), 'Sleep for N ms.'),
+        singleKeyStep('waitForDownload', obj({ trigger: str(), saveAs: str() }, ['trigger', 'saveAs'])),
+        singleKeyStep('waitForPopup', obj({ trigger: str(), switchTo: bool() }, ['trigger'])),
+        singleKeyStep('cookie', obj({
+            name: str(),
+            value: str(),
+            domain: str(),
+            path: str(),
+            expires: num(),
+            httpOnly: bool(),
+            secure: bool(),
+            sameSite: enumStr(['Strict', 'Lax', 'None']),
+        }, ['name', 'value'])),
+        singleKeyStep('clearCookies', { const: true }),
+        // ApiStep variants (apiFlows uses these)
+        singleKeyStep('request', obj({
+            method: httpMethod,
+            url: str(),
+            headers: { type: 'object', additionalProperties: str() },
+            body: {},
+        }, ['method', 'url'])),
+        singleKeyStep('expect', obj({
+            status: num(),
+            statusIn: arr(num()),
+            headerIncludes: obj({ name: str(), value: str() }, ['name', 'value']),
+            bodyIncludes: str(),
+            jsonPath: obj({ path: str(), equals: {}, exists: bool() }, ['path']),
+        })),
+    ];
+}
+function buildViewport() {
+    return obj({ name: str(), width: num(), height: num() }, ['name', 'width', 'height']);
+}
+function buildFlow() {
+    return obj({ name: str(), steps: arr({ $ref: '#/definitions/Step' }) }, ['name', 'steps']);
+}
+function buildApiFlow() {
+    return obj({ name: str(), steps: arr({ $ref: '#/definitions/ApiStep' }) }, ['name', 'steps']);
+}
+function buildBudget() {
+    return obj({
+        perf: obj({
+            performance: num(),
+            accessibility: num(),
+            bestPractices: num(),
+            seo: num(),
+        }),
+        metrics: obj({ lcpMs: num(), fcpMs: num(), cls: num(), tbtMs: num(), siMs: num() }),
+        a11y: obj({ maxCritical: num(), maxSerious: num(), maxTotal: num() }),
+        visual: obj({ maxDiffRatio: num() }),
+        flows: obj({ maxFailures: num() }),
+    });
+}
+function buildMock() {
+    const httpMethod = enumStr(['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS']);
+    return obj({
+        pattern: str(),
+        method: httpMethod,
+        action: {
+            oneOf: [
+                { const: 'abort' },
+                obj({
+                    status: num(),
+                    headers: { type: 'object', additionalProperties: str() },
+                    body: str(),
+                    contentType: str(),
+                }),
+            ],
+        },
+    }, ['pattern', 'action']);
+}
+function buildNotify() {
+    return obj({
+        slackWebhook: str({ format: 'uri' }),
+        discordWebhook: str({ format: 'uri' }),
+        genericWebhook: str({ format: 'uri' }),
+        onlyOnFail: bool(),
+    });
+}
+export function generateConfigSchema() {
+    const stepSchema = { oneOf: buildStepVariants() };
+    const definitions = {
+        Step: stepSchema,
+        ApiStep: stepSchema,
+        Flow: buildFlow(),
+        ApiFlow: buildApiFlow(),
+        Viewport: buildViewport(),
+        Checks: buildChecksSchema(),
+        Budget: buildBudget(),
+        RouteMock: buildMock(),
+        Notify: buildNotify(),
+    };
+    const properties = {
+        url: str({ format: 'uri', description: 'Target URL to inspect.' }),
+        flows: arr({ $ref: '#/definitions/Flow' }),
+        viewports: arr({ $ref: '#/definitions/Viewport' }),
+        checks: { $ref: '#/definitions/Checks' },
+        output: obj({
+            dir: str(),
+            baselineDir: str(),
+            reportFormat: enumStr(['html', 'json', 'both']),
+        }),
+        ai: obj({ enabled: bool(), model: str() }),
+        headed: bool(),
+        parallel: bool(),
+        storageState: str(),
+        reporters: arr(enumStr(['html', 'json', 'junit', 'sarif', 'allure', 'tap'])),
+        browser: enumStr(['chromium', 'firefox', 'webkit']),
+        device: str(),
+        locale: str(),
+        timezoneId: str(),
+        geolocation: obj({ latitude: num(), longitude: num() }, ['latitude', 'longitude']),
+        network: enumStr(['slow-3g', 'fast-3g', '4g', 'wifi']),
+        trace: bool(),
+        video: bool(),
+        har: bool(),
+        budget: { $ref: '#/definitions/Budget' },
+        notify: { $ref: '#/definitions/Notify' },
+        mocks: arr({ $ref: '#/definitions/RouteMock' }),
+        debug: bool(),
+        slowMo: num({ minimum: 0 }),
+        apiFlows: arr({ $ref: '#/definitions/ApiFlow' }),
+    };
+    return {
+        $schema: 'http://json-schema.org/draft-07/schema#',
+        $id: 'https://uxinspect.com/schemas/config.json',
+        title: 'uxinspect config',
+        type: 'object',
+        required: ['url'],
+        properties,
+        additionalProperties: false,
+        definitions,
+    };
+}
+export async function writeSchemaFile(outPath) {
+    const schema = generateConfigSchema();
+    const json = JSON.stringify(schema, null, 2);
+    await writeFile(outPath, json + '\n', 'utf8');
+}
+//# sourceMappingURL=json-schema.js.map