uxinspect 0.2.0 → 0.11.0

package/README.md

@@ -2,8 +2,9 @@
 
 > All-in-one UI/UX testing — tests like a real human, every click, every screen, every accessibility rule, in one CLI.
 
-[![npm](https://img.shields.io/npm/v/uxinspect.svg)](https://npmjs.com/package/uxinspect)
-[![license](https://img.shields.io/npm/l/uxinspect.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/uxinspect.svg?color=10B981)](https://npmjs.com/package/uxinspect)
+[![license](https://img.shields.io/npm/l/uxinspect.svg?color=10B981)](LICENSE)
+[![checks](https://img.shields.io/badge/checks-38-10B981)](#checks)
 
 ## What it does
 
@@ -57,7 +58,7 @@ export default {
   ],
   checks: { a11y: true, visual: true, perf: true, explore: true },
   parallel: true,
-  reporters: ['html', 'json', 'junit', 'sarif'],
+  reporters: ['html', 'json', 'junit', 'sarif', 'allure', 'tap'],
   ai: { enabled: true },
 } satisfies InspectConfig;
 ```
@@ -79,25 +80,331 @@ const result = await inspect({
 if (!result.passed) process.exit(1);
 ```
 
-## CLI options
+## Programmatic helpers
+
+Composable helpers that sit alongside `inspect()` for specialized flows and integrations.
+
+### `flaky` — retry with flake detection
+
+Re-runs a block until it passes, classifies intermittent failures as flakes.
+
+```ts
+import { retryWithFlakeDetection, inspect } from 'uxinspect';
+
+const result = await retryWithFlakeDetection(
+  () => inspect(config),
+  { maxAttempts: 3 },
+);
+```
+
+### `websocket` — WebSocket flow support
+
+Drive WebSocket endpoints with a step-based flow.
+
+```ts
+import { runWebSocketFlow } from 'uxinspect';
+
+await runWebSocketFlow({
+  url: 'wss://example.com/socket',
+  steps: [
+    { send: '{"type":"ping"}' },
+    { expect: { contains: 'pong' } },
+  ],
+});
+```
+
+### `graphql` — GraphQL flow support
+
+Query/mutation steps with variable interpolation and assertions.
+
+```ts
+import { runGraphQLFlow } from 'uxinspect';
+
+await runGraphQLFlow({
+  endpoint: 'https://example.com/graphql',
+  steps: [
+    { query: '{ viewer { id } }', expect: { path: 'data.viewer.id' } },
+  ],
+});
+```
+
+### `service-worker` — Service Worker audit
+
+Checks registration, scope, cache strategy, and update flow.
+
+```ts
+import { auditServiceWorker } from 'uxinspect';
+
+const report = await auditServiceWorker(page);
+```
+
+### `rum` — Real User Monitoring
+
+Collect field metrics from a page, or inject the RUM client script into production.
+
+```ts
+import { collectRUM, rumClientScript } from 'uxinspect';
+
+const metrics = await collectRUM(page);
+
+// In your production HTML:
+// <script>${rumClientScript()}</script>
+```
+
+### `github-annotations` — GitHub Actions PR annotations
+
+Emits `::error` / `::warning` workflow commands so findings surface as inline PR annotations.
+
+```ts
+import { emitGitHubAnnotations } from 'uxinspect';
+
+emitGitHubAnnotations(result);
+```
+
+### `amp` — AMP HTML validation
+
+Validates AMP markup on the current page.
+
+```ts
+import { validateAmp } from 'uxinspect';
+
+const ampReport = await validateAmp(page);
+```
+
+### `bdd` — Gherkin feature file runner
+
+Parse Gherkin syntax, map steps to flows, and hand them to `inspect()`.
+
+```ts
+import { readFileSync } from 'node:fs';
+import { parseFeature, featureToFlows, builtinSteps, inspect } from 'uxinspect';
+
+const feature = parseFeature(readFileSync('login.feature', 'utf8'));
+const flows = featureToFlows(feature, builtinSteps);
+await inspect({ url: 'https://example.com', flows });
+```
+
+### `mailbox` — email intercept for signup flows
+
+Wait for a verification email during a test run.
+
+```ts
+import { waitForEmail } from 'uxinspect';
+
+const email = await waitForEmail(
+  { provider: 'mailpit', baseUrl: 'https://mail.example.com' },
+  { subjectContains: 'Verify' },
+);
+```
+
+## Checks
+
+100+ built-in audits. 65+ wired into `inspect()` single-run (enable via `checks` or `--all`); all available as library imports.
+
+### Accessibility & UX
+
+| Check | Key | One-liner |
+|---|---|---|
+| Accessibility | `a11y` | WCAG violations via axe-core on every viewport |
+| Keyboard | `keyboard` | Focus trap, tab order, visible focus rings |
+| Touch targets | `touchTargets` | WCAG 2.5.5 / 2.5.8 target-size (44/24 px) audit |
+| Dead clicks | `deadClicks` | Flags elements that look clickable but do nothing |
+| Motion prefs | `motionPrefs` | `prefers-reduced-motion`, dark-mode, print, forced-colors |
+| Forms | `forms` | Label, autocomplete, required, validation audit |
+
+```ts
+checks: {
+  a11y: true,
+  keyboard: true,
+  touchTargets: true,
+  deadClicks: true,
+  motionPrefs: true,
+  forms: true,
+}
+```
+
+### Performance
+
+| Check | Key | One-liner |
+|---|---|---|
+| Lighthouse | `perf` | Core Web Vitals + Lighthouse scoring |
+| Long tasks | `longTasks` | Long tasks, LoAF attribution, INP capture |
+| CLS timeline | `clsTimeline` | Layout shift timeline with node attribution |
+| Bundle size | `bundleSize` | JS/CSS byte budget + duplicate package detection |
+| Webfonts | `webfonts` | `font-display`, FOIT/FOUT, oversize font files |
+| Images | `imageAudit` | Alt text, lazy-load, modern format, intrinsic dims |
+| Resource hints | `resourceHints` | `preload` / `prefetch` / `preconnect` audit |
+| Cache headers | `cacheHeaders` | `Cache-Control`, `ETag`, `immutable` audit |
+| Compression | `compression` | gzip / brotli + HTTP/2 / HTTP/3 negotiation |
+
+```ts
+checks: {
+  perf: true,
+  longTasks: true,
+  clsTimeline: true,
+  bundleSize: true,
+  webfonts: true,
+  imageAudit: true,
+  resourceHints: true,
+  cacheHeaders: true,
+  compression: true,
+}
+```
+
+### Security
+
+| Check | Key | One-liner |
+|---|---|---|
+| Headers | `security` | CSP, HSTS, X-Frame-Options, Referrer-Policy, etc. |
+| Passive smells | `passiveSecurity` | Surface-level security red flags |
+| Retire.js | `retire` | Vulnerable JS library scan (12 lib signatures) |
+| TLS | `tls` | Socket audit: protocol, cipher, cert chain |
+| Exposed paths | `exposedPaths` | Sensitive path scan (35 signatures) |
+| Mixed content | `mixedContent` | Insecure resources on HTTPS pages |
+
+```ts
+checks: {
+  security: true,
+  passiveSecurity: true,
+  retire: true,
+  tls: true,
+  exposedPaths: true,
+  mixedContent: true,
+}
+```
+
+### SEO & Content
+
+| Check | Key | One-liner |
+|---|---|---|
+| SEO | `seo` | Meta tags, heading structure, canonical |
+| Sitemap | `sitemap` | `sitemap.xml` fetch + schema validation |
+| Robots | `robotsAudit` | `robots.txt` + meta robots + `X-Robots-Tag` |
+| Structured data | `structuredData` | JSON-LD, microdata, `hreflang` |
+| Open Graph | `openGraph` | OpenGraph + Twitter Card validation |
+| Content quality | `contentQuality` | Flesch-Kincaid readability + duplicate detection |
+| Links | `links` | Broken link check across crawled pages |
+
+```ts
+checks: {
+  seo: true,
+  sitemap: true,
+  robotsAudit: true,
+  structuredData: true,
+  openGraph: true,
+  contentQuality: true,
+  links: true,
+}
+```
+
+### Network & Infra
+
+| Check | Key | One-liner |
+|---|---|---|
+| PWA | `pwa` | Manifest + service worker audit |
+| Redirects | `redirects` | Redirect chain length + loop detection |
+| Crawl | `crawl` | BFS site crawl with configurable depth |
+| Third-party | `thirdParty` | Tracker / ad / analytics script analysis |
+
+```ts
+checks: {
+  pwa: true,
+  redirects: true,
+  crawl: true,
+  thirdParty: true,
+}
+```
+
+### Visual
+
+| Check | Key | One-liner |
+|---|---|---|
+| Visual diff | `visual` | Pixelmatch diff against stored baselines |
+
+```ts
+checks: { visual: true }
+```
+
+### Privacy & Compliance
+
+| Check | Key | One-liner |
+|---|---|---|
+| Cookie banner | `cookieBanner` | GDPR consent popup detection |
+| Console errors | `consoleErrors` | Browser console capture across the run |
+
+```ts
+checks: {
+  cookieBanner: true,
+  consoleErrors: true,
+}
+```
+
+### Exploration
+
+| Check | Key | One-liner |
+|---|---|---|
+| Explore | `explore` | Heuristic automated crawling + interaction |
+| AI | `ai` | Keyless AI instructions (Playwright role/text locators) |
+
+```ts
+checks: {
+  explore: true,
+  ai: true,
+}
+```
+
+## CLI flags
+
+Every check has a matching flag. Use `--all` to turn them all on, or pick individually. Flags are boolean; prefix with `--no-` to disable (e.g. `--no-a11y`).
+
+### Core flags
 
 | Flag | Default | Description |
 |------|---------|-------------|
 | `--url` | required | URL to inspect |
-| `--config` | — | Config file (`.ts`/`.js`/`.json`) |
-| `--a11y` | `true` | Accessibility audit |
-| `--perf` | `false` | Performance audit |
-| `--visual` | `true` | Visual diff against baseline |
-| `--explore` | `false` | Auto-click every interactive element |
+| `--config` | — | Config file (`.ts` / `.js` / `.json`) |
 | `--out` | `./uxinspect-report` | Report directory |
 | `--baselines` | `./uxinspect-baselines` | Visual baseline directory |
-| `--ai` | `false` | Enable keyless AI flow steps |
 | `--headed` | `false` | Run with visible browser |
 | `--parallel` | `false` | Run flows in parallel |
 | `--storage-state` | — | Path to auth storageState JSON |
-| `--reporters` | `html,json` | Comma list: `html`, `json`, `junit`, `sarif` |
-| `--publish` | — | Dashboard URL to upload report (e.g. `https://dash.example.com`) |
+| `--reporters` | `html,json` | Comma list: `html`, `json`, `junit`, `sarif`, `allure`, `tap` |
+| `--publish` | — | Dashboard URL to upload report |
 | `--publish-token` | — | Bearer token for dashboard upload |
+| `--all` | `false` | Enable every check below |
+
+### Check flags
+
+| Category | Flag |
+|---|---|
+| Accessibility & UX | `--a11y` `--keyboard` `--touch-targets` `--dead-clicks` `--motion-prefs` `--forms` |
+| Performance | `--perf` `--long-tasks` `--cls-timeline` `--bundle-size` `--webfonts` `--image-audit` `--resource-hints` `--cache-headers` `--compression` |
+| Security | `--security` `--passive-security` `--retire` `--tls` `--exposed-paths` `--mixed-content` |
+| SEO & Content | `--seo` `--sitemap` `--robots-audit` `--structured-data` `--open-graph` `--content-quality` `--links` |
+| Network & Infra | `--pwa` `--redirects` `--crawl` `--third-party` |
+| Visual | `--visual` |
+| Privacy & Compliance | `--cookie-banner` `--console-errors` |
+| Exploration | `--explore` `--ai` |
+
+Example:
+
+```bash
+uxinspect run --url https://example.com --all
+uxinspect run --url https://example.com --a11y --perf --retire --seo --visual
+```
+
+## Reporters
+
+Pick any combination via `reporters: [...]` or `--reporters html,json,...`.
+
+| Reporter | Output | Use |
+|---|---|---|
+| `html` | `report.html` | Human-readable dashboard with screenshots |
+| `json` | `report.json` | Machine-readable full result tree |
+| `junit` | `junit.xml` | CI test result ingestion |
+| `sarif` | `report.sarif` | Code scanning / security tab ingestion |
+| `allure` | `allure-results/` | Directory for the Allure UI |
+| `tap` | `report.tap` | TAP 14 stream for TAP-compatible tooling |
 
 ## AI without keys
 
@@ -136,17 +443,20 @@ uxinspect report ./uxinspect-report --port 4173
 
 ## How it compares
 
-| Capability | uxinspect | Cypress | Visual SaaS | A11y plugin |
+| Capability | uxinspect | E2E frameworks | Visual SaaS | A11y plugins |
 |---|:-:|:-:|:-:|:-:|
-| Real-user clicks | ✅ | ✅ | — | — |
-| Multi-browser | ✅ | partial | — | — |
-| Accessibility | ✅ | plugin | — | ✅ |
-| Performance | ✅ | — | — | — |
-| Visual diff | ✅ | plugin | ✅ paid | — |
-| Auto-explore | ✅ | — | — | — |
-| AI helpers | ✅ | — | — | — |
-| One report | ✅ | — | — | — |
-| Open source | ✅ MIT | mixed | ❌ | ✅ |
+| Real-user clicks | yes | yes | — | — |
+| Multi-browser | yes | partial | — | — |
+| Accessibility | yes | plugin | — | yes |
+| Performance | yes | — | — | — |
+| Visual diff | yes | plugin | paid | — |
+| Security headers | yes | — | — | — |
+| Vuln JS scan | yes | — | — | — |
+| SEO / structured data | yes | — | — | — |
+| Auto-explore | yes | — | — | — |
+| AI helpers | yes | — | — | — |
+| One report | yes | — | — | — |
+| Open source | MIT | mixed | no | yes |
 
 ## License
 

package/dist/a11y-filter.d.ts

@@ -0,0 +1,15 @@
+import type { Page } from 'playwright';
+import type { A11yResult, A11yViolation } from './types.js';
+export type WcagLevel = 'wcag2a' | 'wcag2aa' | 'wcag2aaa' | 'wcag21a' | 'wcag21aa' | 'wcag22aa' | 'best-practice';
+export interface A11yFilterOptions {
+    include?: WcagLevel[];
+    excludeBestPractice?: boolean;
+    runOnlyRules?: string[];
+    disableRules?: string[];
+    elementExclude?: string[];
+    impactMinimum?: 'minor' | 'moderate' | 'serious' | 'critical';
+}
+export declare const WCAG_TAG_GROUPS: Record<string, WcagLevel[]>;
+export declare function filterViolationsByImpact(violations: A11yViolation[], minimum: A11yFilterOptions['impactMinimum']): A11yViolation[];
+export declare function runFilteredA11y(page: Page, opts: A11yFilterOptions): Promise<A11yResult>;
+//# sourceMappingURL=a11y-filter.d.ts.map

package/dist/a11y-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-filter.d.ts","sourceRoot":"","sources":["../src/a11y-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,SAAS,GACT,UAAU,GACV,UAAU,GACV,eAAe,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;CAC/D;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAcvD,CAAC;AAwEF,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,aAAa,EAAE,EAC3B,OAAO,EAAE,iBAAiB,CAAC,eAAe,CAAC,GAC1C,aAAa,EAAE,CAIjB;AAmBD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,UAAU,CAAC,CAsCrB"}

package/dist/a11y-filter.js

@@ -0,0 +1,107 @@
+export const WCAG_TAG_GROUPS = {
+    a: ['wcag2a', 'wcag21a'],
+    aa: ['wcag2aa', 'wcag21aa', 'wcag22aa'],
+    aaa: ['wcag2aaa'],
+    all: ['wcag2a', 'wcag2aa', 'wcag2aaa', 'wcag21a', 'wcag21aa', 'wcag22aa'],
+    allWithBestPractice: [
+        'wcag2a',
+        'wcag2aa',
+        'wcag2aaa',
+        'wcag21a',
+        'wcag21aa',
+        'wcag22aa',
+        'best-practice',
+    ],
+};
+const DEFAULT_TAGS = ['wcag2a', 'wcag2aa', 'wcag21aa', 'wcag22aa'];
+const IMPACT_ORDER = {
+    minor: 0,
+    moderate: 1,
+    serious: 2,
+    critical: 3,
+};
+async function loadAxeBuilder() {
+    try {
+        const mod = (await import('@axe-core/playwright'));
+        return mod.AxeBuilder ?? mod.default ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeImpact(impact) {
+    if (impact === 'critical' || impact === 'serious' || impact === 'moderate' || impact === 'minor') {
+        return impact;
+    }
+    return 'minor';
+}
+function toViolation(v) {
+    return {
+        id: v.id,
+        impact: normalizeImpact(v.impact),
+        description: v.description,
+        help: v.help,
+        helpUrl: v.helpUrl,
+        nodes: v.nodes.map((n) => ({
+            html: n.html,
+            target: Array.isArray(n.target) ? n.target.filter((t) => typeof t === 'string') : [],
+        })),
+    };
+}
+export function filterViolationsByImpact(violations, minimum) {
+    if (!minimum)
+        return violations;
+    const threshold = IMPACT_ORDER[minimum];
+    return violations.filter((v) => IMPACT_ORDER[v.impact] >= threshold);
+}
+function resolveTags(opts) {
+    const base = opts.include && opts.include.length > 0 ? [...opts.include] : [...DEFAULT_TAGS];
+    const excludeBP = opts.excludeBestPractice ?? true;
+    const hasBP = base.includes('best-practice');
+    if (!excludeBP && !hasBP) {
+        base.push('best-practice');
+    }
+    if (excludeBP && hasBP) {
+        return base.filter((t) => t !== 'best-practice');
+    }
+    return base;
+}
+function emptyResult(page) {
+    return { page: page.url(), violations: [], passed: true };
+}
+export async function runFilteredA11y(page, opts) {
+    const AxeBuilder = await loadAxeBuilder();
+    if (!AxeBuilder) {
+        return emptyResult(page);
+    }
+    try {
+        let builder = new AxeBuilder({ page });
+        if (opts.runOnlyRules && opts.runOnlyRules.length > 0) {
+            builder = builder.withRules(opts.runOnlyRules);
+        }
+        else {
+            const tags = resolveTags(opts);
+            builder = builder.withTags(tags);
+        }
+        if (opts.disableRules && opts.disableRules.length > 0) {
+            builder = builder.disableRules(opts.disableRules);
+        }
+        if (opts.elementExclude && opts.elementExclude.length > 0) {
+            for (const selector of opts.elementExclude) {
+                builder = builder.exclude(selector);
+            }
+        }
+        const result = await builder.analyze();
+        const mapped = result.violations.map(toViolation);
+        const filtered = filterViolationsByImpact(mapped, opts.impactMinimum);
+        return {
+            page: page.url(),
+            violations: filtered,
+            passed: filtered.length === 0,
+        };
+    }
+    catch {
+        return emptyResult(page);
+    }
+}
+//# sourceMappingURL=a11y-filter.js.map

package/dist/a11y-filter.js.map

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

package/dist/ab-compare.d.ts

@@ -0,0 +1,23 @@
+import type { InspectResult } from './types.js';
+export interface Diff {
+    check: string;
+    delta: string;
+    aValue: string | number;
+    bValue: string | number;
+    direction: 'regression' | 'improvement';
+    severity: 'minor' | 'major' | 'critical';
+}
+export interface CompareResult {
+    labelA: string;
+    labelB: string;
+    regressions: Diff[];
+    improvements: Diff[];
+    unchanged: number;
+    summary: {
+        regressedChecks: number;
+        improvedChecks: number;
+    };
+    passed: boolean;
+}
+export declare function compareInspect(a: InspectResult, b: InspectResult): CompareResult;
+//# sourceMappingURL=ab-compare.d.ts.map

package/dist/ab-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ab-compare.d.ts","sourceRoot":"","sources":["../src/ab-compare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,SAAS,EAAE,YAAY,GAAG,aAAa,CAAC;IACxC,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,YAAY,EAAE,IAAI,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,MAAM,EAAE,OAAO,CAAC;CACjB;AA0QD,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,aAAa,CA+EhF"}