@monoes/monobrowse 1.0.12 → 1.0.13

package/dist/src/report/a11y.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Accessibility rules computed from the CDP accessibility tree.
+ *
+ * Deliberate scope limit: colour contrast is NOT computed here. Contrast
+ * needs resolved foreground/background pixels or computed styles, and the AX
+ * tree carries neither — guessing it would produce confident nonsense. The
+ * report says so explicitly instead.
+ *
+ * Every rule is a pure function of a node array, so the fixtures in the tests
+ * are just hand-written AX trees.
+ */
+import type { A11yFinding, AxNode, FocusCandidate } from './types.js';
+/**
+ * Depth-first document order. `Accessibility.getFullAXTree` usually returns
+ * nodes pre-ordered already, but heading-order is the one rule where a
+ * reordered array would silently produce wrong findings, so we walk childIds
+ * ourselves. Nodes unreachable from a root are appended in array order rather
+ * than dropped.
+ */
+export declare function orderNodes(nodes: AxNode[]): AxNode[];
+/**
+ * Nameless controls, images without alt text, and unlabelled form fields.
+ *
+ * `ignored` nodes are skipped: that is how `<img alt="">` correctly escapes
+ * the image rule — a deliberately decorative image is dropped from the AX
+ * tree, while `<img>` with no alt attribute at all stays in it with an empty
+ * name, which is the bug we want to report.
+ */
+export declare function findNamingIssues(nodes: AxNode[], locators?: Map<number, string>): A11yFinding[];
+/**
+ * Headings that skip a level (h1 -> h3), plus a document whose first heading
+ * is not h1. Both break the outline screen-reader users navigate by.
+ */
+export declare function findHeadingIssues(nodes: AxNode[], locators?: Map<number, string>): A11yFinding[];
+/**
+ * Interactive elements pulled out of the keyboard tab order by a negative
+ * tabindex. They stay clickable with a mouse and stay in the AX tree, so
+ * nothing else in this file can see them — the candidates come from a DOM
+ * sweep in collect.ts.
+ */
+export declare function findFocusOrderIssues(candidates: FocusCandidate[]): A11yFinding[];
+export interface A11yInput {
+    nodes: AxNode[];
+    focusCandidates?: FocusCandidate[];
+    locators?: Map<number, string>;
+}
+export declare function runA11yRules({ nodes, focusCandidates, locators }: A11yInput): A11yFinding[];
+export declare function countA11y(findings: A11yFinding[]): {
+    errors: number;
+    warnings: number;
+};
+//# sourceMappingURL=a11y.d.ts.map

package/dist/src/report/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../../src/report/a11y.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuDtE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAsBpD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,EAAE,CA6C/F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,EAAE,CAoChG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,CAgBhF;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,eAAoB,EAAE,QAAQ,EAAE,EAAE,SAAS,GAAG,WAAW,EAAE,CAMhG;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAQvF"}

package/dist/src/report/a11y.js

@@ -0,0 +1,231 @@
+/**
+ * Accessibility rules computed from the CDP accessibility tree.
+ *
+ * Deliberate scope limit: colour contrast is NOT computed here. Contrast
+ * needs resolved foreground/background pixels or computed styles, and the AX
+ * tree carries neither — guessing it would produce confident nonsense. The
+ * report says so explicitly instead.
+ *
+ * Every rule is a pure function of a node array, so the fixtures in the tests
+ * are just hand-written AX trees.
+ */
+/** Roles whose whole purpose is to be activated — a nameless one is unusable. */
+const COMMAND_ROLES = new Set([
+    'button',
+    'link',
+    'menuitem',
+    'menuitemcheckbox',
+    'menuitemradio',
+    'tab',
+    'switch',
+    'treeitem',
+]);
+/** Roles that take user input and therefore need a programmatic label. */
+const FORM_FIELD_ROLES = new Set([
+    'textbox',
+    'searchbox',
+    'combobox',
+    'listbox',
+    'checkbox',
+    'radio',
+    'slider',
+    'spinbutton',
+]);
+const IMAGE_ROLES = new Set(['image', 'img']);
+/** Natively focusable tags — a negative tabindex on these removes them from the tab order. */
+const NATIVELY_FOCUSABLE = new Set(['a', 'button', 'input', 'select', 'textarea', 'summary']);
+function strValue(v) {
+    return typeof v === 'string' ? v : v == null ? '' : String(v);
+}
+function roleOf(node) {
+    return strValue(node.role?.value).toLowerCase();
+}
+function nameOf(node) {
+    return strValue(node.name?.value).trim();
+}
+function propOf(node, name) {
+    return node.properties?.find((p) => p.name === name)?.value?.value;
+}
+function locatorFor(node, locators) {
+    if (node.backendDOMNodeId !== undefined) {
+        const found = locators?.get(node.backendDOMNodeId);
+        if (found)
+            return found;
+    }
+    return `ax-node:${node.nodeId}`;
+}
+/**
+ * Depth-first document order. `Accessibility.getFullAXTree` usually returns
+ * nodes pre-ordered already, but heading-order is the one rule where a
+ * reordered array would silently produce wrong findings, so we walk childIds
+ * ourselves. Nodes unreachable from a root are appended in array order rather
+ * than dropped.
+ */
+export function orderNodes(nodes) {
+    const byId = new Map();
+    for (const n of nodes)
+        byId.set(String(n.nodeId), n);
+    const ids = new Set(byId.keys());
+    const roots = nodes.filter((n) => n.parentId === undefined || !ids.has(String(n.parentId)));
+    const seen = new Set();
+    const ordered = [];
+    const visit = (node) => {
+        const id = String(node.nodeId);
+        if (seen.has(id))
+            return;
+        seen.add(id);
+        ordered.push(node);
+        for (const childId of node.childIds ?? []) {
+            const child = byId.get(String(childId));
+            if (child)
+                visit(child);
+        }
+    };
+    for (const root of roots)
+        visit(root);
+    for (const node of nodes)
+        if (!seen.has(String(node.nodeId)))
+            ordered.push(node);
+    return ordered;
+}
+/**
+ * Nameless controls, images without alt text, and unlabelled form fields.
+ *
+ * `ignored` nodes are skipped: that is how `<img alt="">` correctly escapes
+ * the image rule — a deliberately decorative image is dropped from the AX
+ * tree, while `<img>` with no alt attribute at all stays in it with an empty
+ * name, which is the bug we want to report.
+ */
+export function findNamingIssues(nodes, locators) {
+    const findings = [];
+    for (const node of nodes) {
+        if (node.ignored)
+            continue;
+        const role = roleOf(node);
+        if (!role)
+            continue;
+        const name = nameOf(node);
+        if (name)
+            continue;
+        if (FORM_FIELD_ROLES.has(role)) {
+            findings.push({
+                rule: 'form-field-no-label',
+                impact: 'error',
+                role,
+                name: null,
+                locator: locatorFor(node, locators),
+                detail: `${role} has no accessible name — no <label>, aria-label or aria-labelledby resolves to one`,
+            });
+            continue;
+        }
+        if (COMMAND_ROLES.has(role)) {
+            findings.push({
+                rule: 'unlabelled-control',
+                impact: 'error',
+                role,
+                name: null,
+                locator: locatorFor(node, locators),
+                detail: `${role} has no accessible name — a screen reader announces it as just "${role}"`,
+            });
+            continue;
+        }
+        if (IMAGE_ROLES.has(role)) {
+            findings.push({
+                rule: 'image-missing-alt',
+                impact: 'error',
+                role,
+                name: null,
+                locator: locatorFor(node, locators),
+                detail: 'image has no alt text (use alt="" if it is purely decorative)',
+            });
+        }
+    }
+    return findings;
+}
+/**
+ * Headings that skip a level (h1 -> h3), plus a document whose first heading
+ * is not h1. Both break the outline screen-reader users navigate by.
+ */
+export function findHeadingIssues(nodes, locators) {
+    const findings = [];
+    let previous = null;
+    for (const node of orderNodes(nodes)) {
+        if (node.ignored)
+            continue;
+        if (roleOf(node) !== 'heading')
+            continue;
+        const raw = propOf(node, 'level');
+        const level = typeof raw === 'number' ? raw : Number.parseInt(strValue(raw), 10);
+        if (!Number.isFinite(level) || level < 1)
+            continue;
+        const name = nameOf(node);
+        if (previous === null) {
+            if (level > 1) {
+                findings.push({
+                    rule: 'heading-order-jump',
+                    impact: 'warning',
+                    role: 'heading',
+                    name: name || null,
+                    locator: locatorFor(node, locators),
+                    detail: `document outline starts at h${level} — the first heading should be h1`,
+                });
+            }
+        }
+        else if (level > previous + 1) {
+            findings.push({
+                rule: 'heading-order-jump',
+                impact: 'warning',
+                role: 'heading',
+                name: name || null,
+                locator: locatorFor(node, locators),
+                detail: `heading level jumps h${previous} -> h${level}`,
+            });
+        }
+        previous = level;
+    }
+    return findings;
+}
+/**
+ * Interactive elements pulled out of the keyboard tab order by a negative
+ * tabindex. They stay clickable with a mouse and stay in the AX tree, so
+ * nothing else in this file can see them — the candidates come from a DOM
+ * sweep in collect.ts.
+ */
+export function findFocusOrderIssues(candidates) {
+    const findings = [];
+    for (const c of candidates) {
+        if (c.tabindex >= 0)
+            continue;
+        const interactive = NATIVELY_FOCUSABLE.has(c.tag.toLowerCase()) || c.role !== '';
+        if (!interactive)
+            continue;
+        findings.push({
+            rule: 'negative-tabindex',
+            impact: 'warning',
+            role: c.role || c.tag.toLowerCase(),
+            name: c.name,
+            locator: c.locator,
+            detail: `<${c.tag.toLowerCase()}> has tabindex="${c.tabindex}" — mouse users can reach it, keyboard users cannot`,
+        });
+    }
+    return findings;
+}
+export function runA11yRules({ nodes, focusCandidates = [], locators }) {
+    return [
+        ...findNamingIssues(nodes, locators),
+        ...findHeadingIssues(nodes, locators),
+        ...findFocusOrderIssues(focusCandidates),
+    ];
+}
+export function countA11y(findings) {
+    let errors = 0;
+    let warnings = 0;
+    for (const f of findings) {
+        if (f.impact === 'error')
+            errors++;
+        else
+            warnings++;
+    }
+    return { errors, warnings };
+}
+//# sourceMappingURL=a11y.js.map

package/dist/src/report/a11y.js.map

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

package/dist/src/report/analyze.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Budget evaluation — the step that makes "the agent tested it" mean
+ * something. Pure function of CaptureData + Budget, so CI behaviour is
+ * testable without a browser.
+ */
+import type { Budget, BudgetFailure, CaptureData, ConsoleEntry, Report, RequestEntry, VerdictValue } from './types.js';
+export declare function consoleErrors(entries: ConsoleEntry[]): ConsoleEntry[];
+export declare function consoleWarnings(entries: ConsoleEntry[]): ConsoleEntry[];
+export declare function failedRequests(requests: RequestEntry[]): RequestEntry[];
+export interface Evaluation {
+    verdict: VerdictValue;
+    failures: BudgetFailure[];
+    /** Budgets that were set but could not be checked — the page never reported the metric. */
+    unmeasured: string[];
+}
+export declare function evaluateBudget(data: CaptureData, budget: Budget): Evaluation;
+export declare function buildReport(data: CaptureData, budget: Budget): Report;
+/** One line for a CI log / agent transcript. */
+export declare function summarizeVerdict(report: Report): string;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/src/report/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/report/analyze.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAEV,MAAM,EACN,aAAa,EACb,WAAW,EACX,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAKpB,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAErE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAEvE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAEvE;AAgCD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,2FAA2F;IAC3F,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CA+E5E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAmBrE;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMvD"}

package/dist/src/report/analyze.js

@@ -0,0 +1,136 @@
+/**
+ * Budget evaluation — the step that makes "the agent tested it" mean
+ * something. Pure function of CaptureData + Budget, so CI behaviour is
+ * testable without a browser.
+ */
+import { countA11y } from './a11y.js';
+import { budgetLabel, formatThreshold } from './budget.js';
+/** How many concrete examples to quote in a failure's `detail`. */
+const DETAIL_SAMPLE = 3;
+export function consoleErrors(entries) {
+    return entries.filter((e) => e.type === 'error');
+}
+export function consoleWarnings(entries) {
+    return entries.filter((e) => e.type === 'warn' || e.type === 'warning');
+}
+export function failedRequests(requests) {
+    return requests.filter((r) => r.failed);
+}
+function truncate(text, max = 160) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+}
+function sample(items) {
+    // Not `.map(truncate)`: map passes the index as the second argument, which
+    // would become truncate's `max` and shave every sample down to nothing.
+    const shown = items.slice(0, DETAIL_SAMPLE).map((item) => truncate(item));
+    const rest = items.length - shown.length;
+    return rest > 0 ? `${shown.join(' | ')} (+${rest} more)` : shown.join(' | ');
+}
+function describeRequest(r) {
+    const status = r.status !== undefined ? String(r.status) : (r.errorText ?? 'no response');
+    return `${status} ${r.method} ${r.url}`;
+}
+export function evaluateBudget(data, budget) {
+    const failures = [];
+    const unmeasured = [];
+    const cErrors = consoleErrors(data.console);
+    const failed = failedRequests(data.requests);
+    const a11y = countA11y(data.a11y);
+    const counts = [
+        {
+            key: 'maxConsoleErrors',
+            actual: cErrors.length,
+            detail: sample(cErrors.map((e) => e.text)),
+        },
+        {
+            key: 'maxPageErrors',
+            actual: data.pageErrors.length,
+            detail: sample(data.pageErrors.map((e) => e.text)),
+        },
+        {
+            key: 'maxFailedRequests',
+            actual: failed.length,
+            detail: sample(failed.map(describeRequest)),
+        },
+        {
+            key: 'maxA11yErrors',
+            actual: a11y.errors,
+            detail: sample(data.a11y
+                .filter((f) => f.impact === 'error')
+                .map((f) => `${f.rule} at ${f.locator}`)),
+        },
+    ];
+    for (const check of counts) {
+        const limit = budget[check.key];
+        if (limit === null)
+            continue;
+        if (check.actual > limit) {
+            failures.push({
+                budget: check.key,
+                expected: formatThreshold(check.key, limit),
+                actual: String(check.actual),
+                detail: check.detail || undefined,
+            });
+        }
+    }
+    const ms = (v) => `${Math.round(v)}ms`;
+    const score = (v) => v.toFixed(4).replace(/0+$/, '').replace(/\.$/, '');
+    const metrics = [
+        { key: 'lcpMs', actual: data.vitals.lcp, format: ms },
+        { key: 'clsScore', actual: data.vitals.cls, format: score },
+        { key: 'inpMs', actual: data.vitals.inp, format: ms },
+        { key: 'fcpMs', actual: data.vitals.fcp, format: ms },
+        { key: 'ttfbMs', actual: data.vitals.ttfb, format: ms },
+    ];
+    for (const metric of metrics) {
+        const limit = budget[metric.key];
+        if (limit === null)
+            continue;
+        if (metric.actual === undefined || !Number.isFinite(metric.actual)) {
+            // A page that never fires an LCP entry (no contentful paint, an
+            // observer the browser does not support, a collector that timed out)
+            // must not be silently graded as passing — but it is not a breach
+            // either. Surface it as unmeasured and let the report say so.
+            unmeasured.push(budgetLabel(metric.key));
+            continue;
+        }
+        if (metric.actual > limit) {
+            failures.push({
+                budget: metric.key,
+                expected: formatThreshold(metric.key, limit),
+                actual: metric.format(metric.actual),
+            });
+        }
+    }
+    return { verdict: failures.length > 0 ? 'fail' : 'pass', failures, unmeasured };
+}
+export function buildReport(data, budget) {
+    const evaluation = evaluateBudget(data, budget);
+    const a11y = countA11y(data.a11y);
+    return {
+        ...data,
+        budget,
+        verdict: evaluation.verdict,
+        failures: evaluation.failures,
+        unmeasured: evaluation.unmeasured,
+        counts: {
+            consoleErrors: consoleErrors(data.console).length,
+            consoleWarnings: consoleWarnings(data.console).length,
+            pageErrors: data.pageErrors.length,
+            requests: data.requests.length,
+            failedRequests: failedRequests(data.requests).length,
+            a11yErrors: a11y.errors,
+            a11yWarnings: a11y.warnings,
+        },
+    };
+}
+/** One line for a CI log / agent transcript. */
+export function summarizeVerdict(report) {
+    if (report.verdict === 'pass') {
+        return `PASS — ${report.counts.requests} requests, 0 budget failures`;
+    }
+    const names = report.failures.map((f) => budgetLabel(f.budget)).join(', ');
+    return `FAIL — ${report.failures.length} budget failure(s): ${names}`;
+}
+//# sourceMappingURL=analyze.js.map

package/dist/src/report/analyze.js.map

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

package/dist/src/report/budget.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Budget parsing for `monobrowse report`.
+ *
+ * A budget is what turns "the agent looked at the page" into "the agent
+ * tested the page": the thresholds the run is gated on. Defaults are the
+ * strict ones you actually want in CI — zero errors, zero failed requests,
+ * Core Web Vitals at Google's "good" boundary.
+ */
+import type { Budget } from './types.js';
+export declare const DEFAULT_BUDGET: Budget;
+export declare function budgetLabel(key: keyof Budget): string;
+/** `2500` -> `<= 2500ms`, `0` -> `<= 0`, `0.1` -> `<= 0.1`. */
+export declare function formatThreshold(key: keyof Budget, value: number): string;
+/**
+ * Turn a parsed JSON object into a Budget, merged over the defaults.
+ *
+ * Unknown keys throw rather than being ignored: a typo'd `max_console_error`
+ * silently loosening a CI gate is exactly the failure mode budgets exist to
+ * prevent.
+ */
+export declare function parseBudget(input: unknown, source?: string): Budget;
+/**
+ * Resolve `--budget`. The value is either inline JSON (starts with `{`) or a
+ * path to a JSON file. Omitted means DEFAULT_BUDGET.
+ */
+export declare function loadBudget(spec?: string): Promise<Budget>;
+//# sourceMappingURL=budget.d.ts.map

package/dist/src/report/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/report/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,eAAO,MAAM,cAAc,EAAE,MAU5B,CAAC;AAiDF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,MAAM,GAAG,MAAM,CAErD;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxE;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAW,GAAG,MAAM,CA4BrE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B/D"}

package/dist/src/report/budget.js

@@ -0,0 +1,143 @@
+/**
+ * Budget parsing for `monobrowse report`.
+ *
+ * A budget is what turns "the agent looked at the page" into "the agent
+ * tested the page": the thresholds the run is gated on. Defaults are the
+ * strict ones you actually want in CI — zero errors, zero failed requests,
+ * Core Web Vitals at Google's "good" boundary.
+ */
+import { readFile } from 'node:fs/promises';
+export const DEFAULT_BUDGET = {
+    maxConsoleErrors: 0,
+    maxPageErrors: 0,
+    maxFailedRequests: 0,
+    maxA11yErrors: 0,
+    lcpMs: 2500,
+    clsScore: 0.1,
+    inpMs: 200,
+    fcpMs: null,
+    ttfbMs: null,
+};
+/** Every spelling we accept, normalized (lowercased, `_`/`-` stripped). */
+const KEY_ALIASES = {
+    maxconsoleerrors: 'maxConsoleErrors',
+    consoleerrors: 'maxConsoleErrors',
+    maxpageerrors: 'maxPageErrors',
+    pageerrors: 'maxPageErrors',
+    maxfailedrequests: 'maxFailedRequests',
+    failedrequests: 'maxFailedRequests',
+    maxa11yerrors: 'maxA11yErrors',
+    a11yerrors: 'maxA11yErrors',
+    maxaccessibilityerrors: 'maxA11yErrors',
+    lcp: 'lcpMs',
+    lcpms: 'lcpMs',
+    cls: 'clsScore',
+    clsscore: 'clsScore',
+    inp: 'inpMs',
+    inpms: 'inpMs',
+    fcp: 'fcpMs',
+    fcpms: 'fcpMs',
+    ttfb: 'ttfbMs',
+    ttfbms: 'ttfbMs',
+};
+const BUDGET_UNITS = {
+    maxConsoleErrors: 'count',
+    maxPageErrors: 'count',
+    maxFailedRequests: 'count',
+    maxA11yErrors: 'count',
+    lcpMs: 'ms',
+    clsScore: 'score',
+    inpMs: 'ms',
+    fcpMs: 'ms',
+    ttfbMs: 'ms',
+};
+const BUDGET_LABELS = {
+    maxConsoleErrors: 'Console errors',
+    maxPageErrors: 'Uncaught page errors',
+    maxFailedRequests: 'Failed requests',
+    maxA11yErrors: 'Accessibility errors',
+    lcpMs: 'LCP (Largest Contentful Paint)',
+    clsScore: 'CLS (Cumulative Layout Shift)',
+    inpMs: 'INP (Interaction to Next Paint)',
+    fcpMs: 'FCP (First Contentful Paint)',
+    ttfbMs: 'TTFB (Time to First Byte)',
+};
+export function budgetLabel(key) {
+    return BUDGET_LABELS[key];
+}
+/** `2500` -> `<= 2500ms`, `0` -> `<= 0`, `0.1` -> `<= 0.1`. */
+export function formatThreshold(key, value) {
+    const unit = BUDGET_UNITS[key];
+    if (unit === 'ms')
+        return `<= ${value}ms`;
+    return `<= ${value}`;
+}
+function normalizeKey(raw) {
+    return raw.toLowerCase().replace(/[_\-\s]/g, '');
+}
+/**
+ * Turn a parsed JSON object into a Budget, merged over the defaults.
+ *
+ * Unknown keys throw rather than being ignored: a typo'd `max_console_error`
+ * silently loosening a CI gate is exactly the failure mode budgets exist to
+ * prevent.
+ */
+export function parseBudget(input, source = 'budget') {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new Error(`Invalid ${source}: expected a JSON object of budget keys`);
+    }
+    const budget = { ...DEFAULT_BUDGET };
+    for (const [rawKey, rawValue] of Object.entries(input)) {
+        const key = KEY_ALIASES[normalizeKey(rawKey)];
+        if (!key) {
+            throw new Error(`Unknown budget key "${rawKey}" in ${source}. Known keys: ${Object.keys(DEFAULT_BUDGET).join(', ')}`);
+        }
+        if (rawValue === null) {
+            budget[key] = null;
+            continue;
+        }
+        if (typeof rawValue !== 'number' || !Number.isFinite(rawValue)) {
+            throw new Error(`Budget "${rawKey}" must be a number or null, got ${JSON.stringify(rawValue)}`);
+        }
+        if (rawValue < 0) {
+            throw new Error(`Budget "${rawKey}" must not be negative, got ${rawValue}`);
+        }
+        budget[key] = rawValue;
+    }
+    return budget;
+}
+/**
+ * Resolve `--budget`. The value is either inline JSON (starts with `{`) or a
+ * path to a JSON file. Omitted means DEFAULT_BUDGET.
+ */
+export async function loadBudget(spec) {
+    if (spec === undefined || spec === '')
+        return { ...DEFAULT_BUDGET };
+    const trimmed = spec.trim();
+    if (trimmed.startsWith('{')) {
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch (err) {
+            throw new Error(`--budget is not valid JSON: ${err.message}`);
+        }
+        return parseBudget(parsed, 'inline --budget');
+    }
+    let text;
+    try {
+        text = await readFile(trimmed, 'utf8');
+    }
+    catch {
+        throw new Error(`Budget file not found or unreadable: ${trimmed}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (err) {
+        throw new Error(`Budget file ${trimmed} is not valid JSON: ${err.message}`);
+    }
+    return parseBudget(parsed, trimmed);
+}
+//# sourceMappingURL=budget.js.map

package/dist/src/report/budget.js.map

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