@monoes/monobrowse 1.0.12 → 1.0.13

package/dist/src/__tests__/profiler-heap.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=profiler-heap.test.d.ts.map

package/dist/src/__tests__/profiler-heap.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-heap.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/profiler-heap.test.ts"],"names":[],"mappings":""}

package/dist/src/__tests__/profiler-heap.test.js

@@ -0,0 +1,154 @@
+/**
+ * Regression cover for the 0-byte heap snapshot.
+ *
+ * Chrome emits `HeapProfiler.reportHeapSnapshotProgress` with finished:true
+ * BEFORE it streams a single `addHeapSnapshotChunk` (verified against Chrome
+ * 153). startHeapSnapshot used to resolve on that progress event, detach its
+ * chunk listener and write an empty file every time. The stub below replays
+ * that exact ordering, so a regression fails here rather than in a profiling
+ * session nobody notices until DevTools refuses to load the snapshot.
+ */
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { startHeapSnapshot } from '../browser/profiler.js';
+/**
+ * A CdpClient that replays Chrome's real takeHeapSnapshot sequence: progress
+ * events first, then the chunks, and only then the command response.
+ */
+function heapClient(sessionId, options = {}) {
+    const { chunks = ['{"snapshot":', '{"node_count":2}', '}'], emitProgressFirst = true } = options;
+    const listeners = new Map();
+    const calls = [];
+    const emit = (event, params, sid) => {
+        for (const fn of listeners.get(event) ?? [])
+            fn(params, sid);
+    };
+    // Chrome delivers each of these in its own WebSocket frame, so the stub
+    // yields between them. Emitting synchronously would paper over the very
+    // bug this file exists to catch: the buggy implementation resolved on the
+    // progress event, and only lost the chunks because they arrived a turn
+    // later, after its `finally` had detached the listener.
+    const tick = () => new Promise((r) => setTimeout(r, 0));
+    const client = {
+        on: vi.fn((event, fn) => {
+            if (!listeners.has(event))
+                listeners.set(event, new Set());
+            listeners.get(event).add(fn);
+            return () => listeners.get(event)?.delete(fn);
+        }),
+        send: vi.fn(async (method, _params, _sid) => {
+            calls.push(method);
+            if (method === 'HeapProfiler.takeHeapSnapshot') {
+                if (emitProgressFirst) {
+                    emit('HeapProfiler.reportHeapSnapshotProgress', { done: 1, total: 1, finished: true }, sessionId);
+                    await tick();
+                }
+                for (const chunk of chunks) {
+                    emit('HeapProfiler.addHeapSnapshotChunk', { chunk }, options.chunkSessionId ?? sessionId);
+                    await tick();
+                }
+            }
+            return {};
+        }),
+    };
+    return { client, calls, listeners };
+}
+const dirs = [];
+async function outPath(name = 'heap.heapsnapshot') {
+    const dir = await mkdtemp(join(tmpdir(), 'monobrowse-heap-'));
+    dirs.push(dir);
+    return join(dir, name);
+}
+afterEach(async () => {
+    await Promise.all(dirs.splice(0).map((d) => rm(d, { recursive: true, force: true })));
+});
+let seq = 0;
+const nextSession = () => `sid-${++seq}`;
+describe('startHeapSnapshot', () => {
+    it('writes every streamed chunk, not an empty file', async () => {
+        const path = await outPath();
+        const sid = nextSession();
+        const { client } = heapClient(sid);
+        const written = await startHeapSnapshot(client, sid, path);
+        expect(written).toBe(path);
+        const contents = await readFile(path, 'utf8');
+        expect(contents).toBe('{"snapshot":{"node_count":2}}');
+        expect(contents.length).toBeGreaterThan(0);
+    });
+    it('does not resolve on the finished progress event that precedes the chunks', async () => {
+        // The regression: with emitProgressFirst the old implementation resolved
+        // before any chunk arrived. Ordering is the whole point of this case.
+        const path = await outPath();
+        const sid = nextSession();
+        const { client } = heapClient(sid, {
+            emitProgressFirst: true,
+            chunks: ['a'.repeat(64), 'b'.repeat(64)],
+        });
+        await startHeapSnapshot(client, sid, path);
+        expect((await readFile(path, 'utf8')).length).toBe(128);
+    });
+    it('works when Chrome sends no progress events at all', async () => {
+        const path = await outPath();
+        const sid = nextSession();
+        const { client } = heapClient(sid, { emitProgressFirst: false, chunks: ['{}'] });
+        await expect(startHeapSnapshot(client, sid, path)).resolves.toBe(path);
+        await expect(readFile(path, 'utf8')).resolves.toBe('{}');
+    });
+    it('asks Chrome not to report progress, since nothing consumes it', async () => {
+        const path = await outPath();
+        const sid = nextSession();
+        const { client } = heapClient(sid);
+        await startHeapSnapshot(client, sid, path);
+        const take = client.send.mock.calls.find((c) => c[0] === 'HeapProfiler.takeHeapSnapshot');
+        expect(take?.[1]).toEqual({ reportProgress: false });
+    });
+    it('enables and disables the heap profiler around the capture', async () => {
+        const path = await outPath();
+        const sid = nextSession();
+        const { client, calls } = heapClient(sid);
+        await startHeapSnapshot(client, sid, path);
+        expect(calls).toEqual([
+            'HeapProfiler.enable',
+            'HeapProfiler.takeHeapSnapshot',
+            'HeapProfiler.disable',
+        ]);
+    });
+    it('ignores chunks belonging to another session', async () => {
+        const path = await outPath();
+        const sid = nextSession();
+        const { client } = heapClient(sid, { chunkSessionId: 'other-session' });
+        await expect(startHeapSnapshot(client, sid, path)).rejects.toThrow(/no data/i);
+    });
+    it('fails loudly instead of writing a 0-byte snapshot', async () => {
+        const path = await outPath();
+        const sid = nextSession();
+        const { client } = heapClient(sid, { chunks: [] });
+        await expect(startHeapSnapshot(client, sid, path)).rejects.toThrow(/produced no data/);
+        await expect(readFile(path, 'utf8')).rejects.toThrow();
+    });
+    it('detaches its chunk listener once the snapshot is done', async () => {
+        const path = await outPath();
+        const sid = nextSession();
+        const { client, listeners } = heapClient(sid);
+        await startHeapSnapshot(client, sid, path);
+        expect(listeners.get('HeapProfiler.addHeapSnapshotChunk')?.size ?? 0).toBe(0);
+    });
+    it('releases the in-progress guard after a failure, so a retry is possible', async () => {
+        const failing = {
+            on: vi.fn(() => () => { }),
+            send: vi.fn(async (method) => {
+                if (method === 'HeapProfiler.takeHeapSnapshot')
+                    throw new Error('target crashed');
+                return {};
+            }),
+        };
+        const sid = nextSession();
+        await expect(startHeapSnapshot(failing, sid)).rejects.toThrow('target crashed');
+        const path = await outPath();
+        const { client } = heapClient(sid);
+        await expect(startHeapSnapshot(client, sid, path)).resolves.toBe(path);
+    });
+});
+//# sourceMappingURL=profiler-heap.test.js.map

package/dist/src/__tests__/profiler-heap.test.js.map

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

package/dist/src/__tests__/report-a11y.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=report-a11y.test.d.ts.map

package/dist/src/__tests__/report-a11y.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-a11y.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/report-a11y.test.ts"],"names":[],"mappings":""}

package/dist/src/__tests__/report-a11y.test.js

@@ -0,0 +1,147 @@
+/**
+ * The a11y rules are pure functions over a CDP accessibility tree, so the
+ * fixtures here are hand-written AX node arrays — no Chrome involved.
+ */
+import { describe, expect, it } from 'vitest';
+import { countA11y, findFocusOrderIssues, findHeadingIssues, findNamingIssues, orderNodes, runA11yRules, } from '../report/a11y.js';
+function node(partial) {
+    return partial;
+}
+function ax(nodeId, role, name = '', extra = {}) {
+    return node({ nodeId, role: { value: role }, name: { value: name }, ...extra });
+}
+function heading(nodeId, level, name = `h${level}`) {
+    return node({
+        nodeId,
+        role: { value: 'heading' },
+        name: { value: name },
+        properties: [{ name: 'level', value: { value: level } }],
+    });
+}
+describe('findNamingIssues', () => {
+    it('flags a button with no accessible name', () => {
+        const findings = findNamingIssues([ax(1, 'button', '')]);
+        expect(findings).toHaveLength(1);
+        expect(findings[0]).toMatchObject({
+            rule: 'unlabelled-control',
+            impact: 'error',
+            role: 'button',
+            name: null,
+            locator: 'ax-node:1',
+        });
+    });
+    it('leaves named controls alone, including whitespace-trimmed names', () => {
+        expect(findNamingIssues([ax(1, 'button', 'Save'), ax(2, 'link', 'Home')])).toEqual([]);
+    });
+    it('treats a whitespace-only name as no name', () => {
+        expect(findNamingIssues([ax(1, 'link', '   ')])).toHaveLength(1);
+    });
+    it('reports an unlabelled form field under its own rule, not unlabelled-control', () => {
+        const findings = findNamingIssues([ax(1, 'textbox', '')]);
+        expect(findings[0].rule).toBe('form-field-no-label');
+        expect(findings[0].impact).toBe('error');
+    });
+    it('flags an image with no alt text', () => {
+        const findings = findNamingIssues([ax(1, 'image', '')]);
+        expect(findings[0].rule).toBe('image-missing-alt');
+    });
+    it('does not flag a decorative image, which the AX tree marks ignored', () => {
+        expect(findNamingIssues([ax(1, 'image', '', { ignored: true })])).toEqual([]);
+    });
+    it('uses a resolved CSS selector as the locator when one is supplied', () => {
+        const locators = new Map([[42, '#submit']]);
+        const findings = findNamingIssues([ax(1, 'button', '', { backendDOMNodeId: 42 })], locators);
+        expect(findings[0].locator).toBe('#submit');
+    });
+    it('ignores roles that carry no naming requirement', () => {
+        expect(findNamingIssues([ax(1, 'paragraph', ''), ax(2, 'generic', '')])).toEqual([]);
+    });
+});
+describe('findHeadingIssues', () => {
+    it('flags a skipped heading level', () => {
+        const findings = findHeadingIssues([heading(1, 1), heading(2, 3)]);
+        expect(findings).toHaveLength(1);
+        expect(findings[0].rule).toBe('heading-order-jump');
+        expect(findings[0].impact).toBe('warning');
+        expect(findings[0].detail).toContain('h1 -> h3');
+    });
+    it('accepts a well-formed outline, including going back up a level', () => {
+        expect(findHeadingIssues([heading(1, 1), heading(2, 2), heading(3, 3), heading(4, 2)])).toEqual([]);
+    });
+    it('flags a document whose first heading is not h1', () => {
+        const findings = findHeadingIssues([heading(1, 2)]);
+        expect(findings[0].detail).toContain('starts at h2');
+    });
+    it('reads levels in document order, not array order', () => {
+        // Array order says h1, h3, h2 (a jump); tree order says h1, h2, h3 (fine).
+        const nodes = [
+            node({ nodeId: 'root', role: { value: 'main' }, childIds: ['a', 'c', 'b'] }),
+            { ...heading('b', 3), parentId: 'root' },
+            { ...heading('a', 1), parentId: 'root' },
+            { ...heading('c', 2), parentId: 'root' },
+        ];
+        expect(findHeadingIssues(nodes)).toEqual([]);
+    });
+    it('skips headings with no usable level property', () => {
+        expect(findHeadingIssues([ax(1, 'heading', 'Untitled')])).toEqual([]);
+    });
+});
+describe('orderNodes', () => {
+    it('walks childIds depth-first and keeps unreachable nodes rather than dropping them', () => {
+        const nodes = [
+            node({ nodeId: 'r', childIds: ['x'] }),
+            node({ nodeId: 'x', parentId: 'r', childIds: ['y'] }),
+            node({ nodeId: 'y', parentId: 'x' }),
+            node({ nodeId: 'orphan', parentId: 'gone' }),
+        ];
+        expect(orderNodes(nodes).map((n) => n.nodeId)).toEqual(['r', 'x', 'y', 'orphan']);
+    });
+    it('does not loop forever on a cyclic tree', () => {
+        const nodes = [
+            node({ nodeId: 'a', childIds: ['b'] }),
+            node({ nodeId: 'b', parentId: 'a', childIds: ['a'] }),
+        ];
+        expect(orderNodes(nodes)).toHaveLength(2);
+    });
+});
+describe('findFocusOrderIssues', () => {
+    const candidate = (partial) => ({
+        tag: 'button',
+        role: '',
+        name: 'Next',
+        tabindex: -1,
+        locator: '#next',
+        ...partial,
+    });
+    it('flags a natively focusable element taken out of the tab order', () => {
+        const findings = findFocusOrderIssues([candidate({})]);
+        expect(findings).toHaveLength(1);
+        expect(findings[0]).toMatchObject({ rule: 'negative-tabindex', impact: 'warning' });
+        expect(findings[0].detail).toContain('tabindex="-1"');
+    });
+    it('ignores non-negative tabindex', () => {
+        expect(findFocusOrderIssues([candidate({ tabindex: 0 })])).toEqual([]);
+    });
+    it('ignores a plain container that is merely script-focusable', () => {
+        expect(findFocusOrderIssues([candidate({ tag: 'div', role: '' })])).toEqual([]);
+    });
+    it('flags a div that claims an interactive role', () => {
+        expect(findFocusOrderIssues([candidate({ tag: 'div', role: 'button' })])).toHaveLength(1);
+    });
+});
+describe('runA11yRules', () => {
+    it('combines every rule and counts errors separately from warnings', () => {
+        const findings = runA11yRules({
+            nodes: [ax(1, 'button', ''), ax(2, 'image', ''), heading(3, 1), heading(4, 4)],
+            focusCandidates: [{ tag: 'a', role: '', name: 'Skip', tabindex: -1, locator: '#skip' }],
+        });
+        expect(findings.map((f) => f.rule).sort()).toEqual([
+            'heading-order-jump',
+            'image-missing-alt',
+            'negative-tabindex',
+            'unlabelled-control',
+        ]);
+        expect(countA11y(findings)).toEqual({ errors: 2, warnings: 2 });
+    });
+});
+//# sourceMappingURL=report-a11y.test.js.map

package/dist/src/__tests__/report-a11y.test.js.map

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

package/dist/src/__tests__/report-analyze.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=report-analyze.test.d.ts.map

package/dist/src/__tests__/report-analyze.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-analyze.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/report-analyze.test.ts"],"names":[],"mappings":""}

package/dist/src/__tests__/report-analyze.test.js

@@ -0,0 +1,157 @@
+/**
+ * Budget evaluation decides the exit code, so these cover the boundaries
+ * (at the limit passes, one over fails) and the cases where a metric simply
+ * was not measured — which must not silently grade as a pass.
+ */
+import { describe, expect, it } from 'vitest';
+import { buildReport, evaluateBudget, failedRequests, summarizeVerdict, } from '../report/analyze.js';
+import { DEFAULT_BUDGET, parseBudget } from '../report/budget.js';
+function capture(partial = {}) {
+    return {
+        url: 'https://example.test/',
+        finalUrl: 'https://example.test/',
+        title: 'Example',
+        capturedAt: '2026-09-21T10:00:00.000Z',
+        durationMs: 1234,
+        console: [],
+        pageErrors: [],
+        requests: [],
+        vitals: {},
+        a11y: [],
+        screenshots: [],
+        notes: [],
+        ...partial,
+    };
+}
+const consoleEntry = (type, text) => ({
+    type,
+    text,
+    timestamp: 0,
+});
+const request = (partial = {}) => ({
+    url: 'https://example.test/api',
+    method: 'GET',
+    failed: false,
+    ...partial,
+});
+const a11yError = (rule) => ({
+    rule,
+    impact: 'error',
+    role: 'button',
+    name: null,
+    locator: '#x',
+    detail: 'no name',
+});
+describe('evaluateBudget', () => {
+    it('passes a clean page against the defaults', () => {
+        const result = evaluateBudget(capture({ vitals: { lcp: 900, cls: 0.02, inp: 80 } }), DEFAULT_BUDGET);
+        expect(result.verdict).toBe('pass');
+        expect(result.failures).toEqual([]);
+        expect(result.unmeasured).toEqual([]);
+    });
+    it('fails on a console error and names expected vs actual', () => {
+        const result = evaluateBudget(capture({ console: [consoleEntry('error', 'Uncaught TypeError: x is not a function')] }), parseBudget({ lcp: null, cls: null, inp: null }));
+        expect(result.verdict).toBe('fail');
+        expect(result.failures).toHaveLength(1);
+        expect(result.failures[0]).toMatchObject({
+            budget: 'maxConsoleErrors',
+            expected: '<= 0',
+            actual: '1',
+        });
+        expect(result.failures[0].detail).toContain('Uncaught TypeError');
+    });
+    it('does not count console warnings as errors', () => {
+        const result = evaluateBudget(capture({ console: [consoleEntry('warn', 'deprecated')] }), parseBudget({ lcp: null, cls: null, inp: null }));
+        expect(result.verdict).toBe('pass');
+    });
+    it('fails on failed requests and quotes the first few', () => {
+        const requests = [
+            request({ failed: true, status: 500, url: 'https://example.test/a' }),
+            request({ failed: true, errorText: 'net::ERR_NAME_NOT_RESOLVED', url: 'https://x.test/b' }),
+            request({ status: 200 }),
+        ];
+        const result = evaluateBudget(capture({ requests }), DEFAULT_BUDGET);
+        const failure = result.failures.find((f) => f.budget === 'maxFailedRequests');
+        expect(failure).toBeDefined();
+        expect(failure?.actual).toBe('2');
+        expect(failure?.detail).toContain('500 GET https://example.test/a');
+        expect(failure?.detail).toContain('net::ERR_NAME_NOT_RESOLVED');
+    });
+    it('treats a metric exactly at the limit as passing, and one over as failing', () => {
+        const budget = parseBudget({ lcp: 2500, cls: null, inp: null });
+        expect(evaluateBudget(capture({ vitals: { lcp: 2500 } }), budget).verdict).toBe('pass');
+        const over = evaluateBudget(capture({ vitals: { lcp: 2501 } }), budget);
+        expect(over.verdict).toBe('fail');
+        expect(over.failures[0]).toMatchObject({
+            budget: 'lcpMs',
+            expected: '<= 2500ms',
+            actual: '2501ms',
+        });
+    });
+    it('records an unmeasured metric instead of passing it', () => {
+        const result = evaluateBudget(capture({ vitals: {} }), parseBudget({ lcp: 2500, cls: null, inp: null }));
+        expect(result.verdict).toBe('pass');
+        expect(result.unmeasured).toEqual(['LCP (Largest Contentful Paint)']);
+    });
+    it('skips a budget set to null entirely', () => {
+        const result = evaluateBudget(capture({ vitals: { lcp: 99_000 } }), parseBudget({ lcp: null, cls: null, inp: null }));
+        expect(result.verdict).toBe('pass');
+        expect(result.unmeasured).toEqual([]);
+    });
+    it('counts a11y errors but not a11y warnings against the a11y budget', () => {
+        const a11y = [
+            a11yError('unlabelled-control'),
+            { ...a11yError('heading-order-jump'), impact: 'warning' },
+        ];
+        const result = evaluateBudget(capture({ a11y }), DEFAULT_BUDGET);
+        const failure = result.failures.find((f) => f.budget === 'maxA11yErrors');
+        expect(failure?.actual).toBe('1');
+        expect(failure?.detail).toContain('unlabelled-control at #x');
+    });
+    it('reports a CLS breach as a score, not milliseconds', () => {
+        const result = evaluateBudget(capture({ vitals: { cls: 0.42 } }), parseBudget({ lcp: null, inp: null }));
+        expect(result.failures[0]).toMatchObject({
+            budget: 'clsScore',
+            expected: '<= 0.1',
+            actual: '0.42',
+        });
+    });
+});
+describe('failedRequests', () => {
+    it('selects only entries marked failed', () => {
+        expect(failedRequests([request({ failed: true }), request()])).toHaveLength(1);
+    });
+});
+describe('buildReport', () => {
+    it('carries the verdict, the failure list and the headline counts', () => {
+        const report = buildReport(capture({
+            console: [consoleEntry('error', 'boom'), consoleEntry('warn', 'meh')],
+            requests: [request({ failed: true, status: 404 }), request({ status: 200 })],
+            a11y: [a11yError('image-missing-alt')],
+            vitals: { lcp: 1000, cls: 0, inp: 10 },
+        }), DEFAULT_BUDGET);
+        expect(report.verdict).toBe('fail');
+        expect(report.counts).toEqual({
+            consoleErrors: 1,
+            consoleWarnings: 1,
+            pageErrors: 0,
+            requests: 2,
+            failedRequests: 1,
+            a11yErrors: 1,
+            a11yWarnings: 0,
+        });
+        expect(report.failures.map((f) => f.budget).sort()).toEqual([
+            'maxA11yErrors',
+            'maxConsoleErrors',
+            'maxFailedRequests',
+        ]);
+    });
+    it('summarizes a pass and a fail in one line each', () => {
+        const pass = buildReport(capture({ vitals: { lcp: 10, cls: 0, inp: 1 } }), DEFAULT_BUDGET);
+        expect(summarizeVerdict(pass)).toContain('PASS');
+        const fail = buildReport(capture({ pageErrors: [{ text: 'boom', timestamp: 0 }] }), DEFAULT_BUDGET);
+        expect(summarizeVerdict(fail)).toContain('FAIL');
+        expect(summarizeVerdict(fail)).toContain('Uncaught page errors');
+    });
+});
+//# sourceMappingURL=report-analyze.test.js.map

package/dist/src/__tests__/report-analyze.test.js.map

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

package/dist/src/__tests__/report-budget.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=report-budget.test.d.ts.map

package/dist/src/__tests__/report-budget.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-budget.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/report-budget.test.ts"],"names":[],"mappings":""}

package/dist/src/__tests__/report-budget.test.js

@@ -0,0 +1,80 @@
+/**
+ * Budgets are the CI gate, so the parser's job is to be strict: a typo'd key
+ * must fail loudly rather than quietly disabling a check.
+ */
+import { mkdtemp, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { DEFAULT_BUDGET, formatThreshold, loadBudget, parseBudget } from '../report/budget.js';
+describe('DEFAULT_BUDGET', () => {
+    it('gates on zero errors and the Core Web Vitals "good" boundaries', () => {
+        expect(DEFAULT_BUDGET).toMatchObject({
+            maxConsoleErrors: 0,
+            maxPageErrors: 0,
+            maxFailedRequests: 0,
+            maxA11yErrors: 0,
+            lcpMs: 2500,
+            clsScore: 0.1,
+            inpMs: 200,
+        });
+    });
+});
+describe('parseBudget', () => {
+    it('merges over the defaults rather than replacing them', () => {
+        const budget = parseBudget({ lcpMs: 4000 });
+        expect(budget.lcpMs).toBe(4000);
+        expect(budget.maxConsoleErrors).toBe(0);
+    });
+    it('accepts short and snake_case spellings', () => {
+        const budget = parseBudget({ lcp: 3000, cls: 0.25, max_console_errors: 5, 'a11y-errors': 2 });
+        expect(budget).toMatchObject({
+            lcpMs: 3000,
+            clsScore: 0.25,
+            maxConsoleErrors: 5,
+            maxA11yErrors: 2,
+        });
+    });
+    it('treats null as "do not enforce"', () => {
+        expect(parseBudget({ lcp: null }).lcpMs).toBeNull();
+    });
+    it('rejects an unknown key instead of silently ignoring it', () => {
+        expect(() => parseBudget({ maxConsoleError: 0 })).toThrow(/Unknown budget key/);
+    });
+    it('rejects non-numeric and negative values', () => {
+        expect(() => parseBudget({ lcp: 'fast' })).toThrow(/must be a number/);
+        expect(() => parseBudget({ lcp: -1 })).toThrow(/negative/);
+    });
+    it('rejects a non-object budget', () => {
+        expect(() => parseBudget([1, 2])).toThrow(/expected a JSON object/);
+        expect(() => parseBudget(null)).toThrow(/expected a JSON object/);
+    });
+});
+describe('loadBudget', () => {
+    it('returns the defaults when nothing is passed', async () => {
+        await expect(loadBudget()).resolves.toEqual(DEFAULT_BUDGET);
+    });
+    it('parses inline JSON', async () => {
+        await expect(loadBudget('{"lcp": 1000}')).resolves.toMatchObject({ lcpMs: 1000 });
+    });
+    it('reads a budget file', async () => {
+        const dir = await mkdtemp(join(tmpdir(), 'monobrowse-budget-'));
+        const file = join(dir, 'budget.json');
+        await writeFile(file, JSON.stringify({ maxFailedRequests: 3 }), 'utf8');
+        await expect(loadBudget(file)).resolves.toMatchObject({ maxFailedRequests: 3 });
+    });
+    it('names the file it could not read', async () => {
+        await expect(loadBudget('/nope/does-not-exist.json')).rejects.toThrow(/Budget file not found/);
+    });
+    it('reports malformed inline JSON as such', async () => {
+        await expect(loadBudget('{oops}')).rejects.toThrow(/not valid JSON/);
+    });
+});
+describe('formatThreshold', () => {
+    it('units millisecond budgets and leaves counts and scores bare', () => {
+        expect(formatThreshold('lcpMs', 2500)).toBe('<= 2500ms');
+        expect(formatThreshold('clsScore', 0.1)).toBe('<= 0.1');
+        expect(formatThreshold('maxConsoleErrors', 0)).toBe('<= 0');
+    });
+});
+//# sourceMappingURL=report-budget.test.js.map

package/dist/src/__tests__/report-budget.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-budget.test.js","sourceRoot":"","sources":["../../../src/__tests__/report-budget.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE/F,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,CAAC,cAAc,CAAC,CAAC,aAAa,CAAC;YACnC,gBAAgB,EAAE,CAAC;YACnB,aAAa,EAAE,CAAC;YAChB,iBAAiB,EAAE,CAAC;YACpB,aAAa,EAAE,CAAC;YAChB,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9F,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,IAAI;YACd,gBAAgB,EAAE,CAAC;YACnB,aAAa,EAAE,CAAC;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACvE,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QACpE,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;QAClC,MAAM,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QACtC,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QACxE,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,CAAC,eAAe,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/__tests__/report-diff.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=report-diff.test.d.ts.map

package/dist/src/__tests__/report-diff.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-diff.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/report-diff.test.ts"],"names":[],"mappings":""}