@monoes/monobrowse 1.0.11 → 1.0.13

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

@@ -0,0 +1,320 @@
+/**
+ * Shared shapes for `monobrowse report` — the one-command page test rig.
+ *
+ * The pipeline is collect (drive the browser) -> analyze (a11y rules +
+ * budget evaluation) -> render (self-contained HTML). Only `collect` talks
+ * to Chrome; everything downstream is a pure function over these types,
+ * which is what makes the analyzer and the renderer unit-testable without
+ * launching a browser.
+ */
+export type A11yRuleId = 'unlabelled-control' | 'image-missing-alt' | 'form-field-no-label' | 'heading-order-jump' | 'negative-tabindex';
+export type A11yImpact = 'error' | 'warning';
+export interface A11yFinding {
+    rule: A11yRuleId;
+    impact: A11yImpact;
+    /** ARIA role as the AX tree reports it, lowercased. */
+    role: string;
+    /** Accessible name, or null when the finding IS the missing name. */
+    name: string | null;
+    /** CSS selector when we could resolve one, else `ax-node:<id>`. */
+    locator: string;
+    detail: string;
+}
+/**
+ * The subset of CDP's `Accessibility.AXNode` these rules read. Declared here
+ * rather than imported because snapshot.ts keeps its own copy private, and
+ * because tests feed in hand-written fixture trees.
+ *
+ * Note `nodeId` is a string on the wire (`AXNodeId`); number is accepted so
+ * fixtures can stay terse.
+ */
+export interface AxNode {
+    nodeId: string | number;
+    ignored?: boolean;
+    role?: {
+        value?: unknown;
+    };
+    name?: {
+        value?: unknown;
+    };
+    properties?: Array<{
+        name: string;
+        value?: {
+            value?: unknown;
+        };
+    }>;
+    backendDOMNodeId?: number;
+    parentId?: string | number;
+    childIds?: Array<string | number>;
+}
+/**
+ * An element the DOM says has a negative tabindex. The AX tree cannot
+ * report tabindex at all, so this comes from a separate DOM sweep.
+ */
+export interface FocusCandidate {
+    tag: string;
+    role: string;
+    name: string | null;
+    tabindex: number;
+    locator: string;
+}
+export interface ConsoleEntry {
+    type: string;
+    text: string;
+    url?: string;
+    lineNumber?: number;
+    timestamp: number;
+}
+export interface PageErrorEntry {
+    text: string;
+    url?: string;
+    lineNumber?: number;
+    columnNumber?: number;
+    timestamp: number;
+}
+export interface RequestEntry {
+    url: string;
+    method: string;
+    /**
+     * Wall-clock ms the request started, when the CDP monotonic clock could be
+     * aligned to Date.now(). Absent otherwise — the evidence timeline (RIG-11)
+     * is the only consumer and it degrades to omitting the request.
+     */
+    startedAtMs?: number;
+    status?: number;
+    mimeType?: string;
+    durationMs?: number;
+    encodedSize?: number;
+    /** True for a 4xx/5xx response or a request that never got one. */
+    failed: boolean;
+    /** CDP `Network.loadingFailed` errorText / blockedReason, when we saw one. */
+    errorText?: string;
+}
+export interface VitalsData {
+    lcp?: number;
+    fcp?: number;
+    cls?: number;
+    ttfb?: number;
+    inp?: number;
+    domInteractive?: number;
+    domContentLoaded?: number;
+    loadTime?: number;
+    resources?: number;
+}
+export interface Screenshot {
+    /** Device name, or 'page' for the default viewport shot. */
+    label: string;
+    width: number;
+    height: number;
+    /** `data:image/png;base64,...` — inlined so the HTML stays self-contained. */
+    dataUrl: string;
+    /** Where captureScreenshot also dropped the PNG, for callers that want it. */
+    path?: string;
+}
+export interface CaptureData {
+    /** URL as requested on the command line. */
+    url: string;
+    /** URL after redirects / client-side navigation. */
+    finalUrl: string;
+    title: string;
+    capturedAt: string;
+    durationMs: number;
+    console: ConsoleEntry[];
+    pageErrors: PageErrorEntry[];
+    requests: RequestEntry[];
+    vitals: VitalsData;
+    a11y: A11yFinding[];
+    screenshots: Screenshot[];
+    /**
+     * Flat AX-tree signature used for the structural diff. Optional because a
+     * page whose AX tree we could not read still produces a valid report.
+     */
+    structure?: StructureNode[];
+    /** Screencast frames + timeline, present only when evidence was recorded. */
+    evidence?: Evidence;
+    /** Raw recorder output, consumed by runReport and never serialized. */
+    recording?: Recording;
+    /** Anything that degraded — a timeout, a collector that came back empty. */
+    notes: string[];
+}
+/** `null` means "do not enforce this one". */
+export interface Budget {
+    maxConsoleErrors: number | null;
+    maxPageErrors: number | null;
+    maxFailedRequests: number | null;
+    maxA11yErrors: number | null;
+    lcpMs: number | null;
+    clsScore: number | null;
+    inpMs: number | null;
+    fcpMs: number | null;
+    ttfbMs: number | null;
+}
+export interface BudgetFailure {
+    /** The budget key that was breached, e.g. `lcpMs`. */
+    budget: keyof Budget;
+    /** Human-readable threshold, e.g. `<= 2500ms`. */
+    expected: string;
+    /** Human-readable measurement, e.g. `3120ms`. */
+    actual: string;
+    /** Concrete evidence — which errors, which requests. */
+    detail?: string;
+}
+export type VerdictValue = 'pass' | 'fail';
+export interface Report extends CaptureData {
+    budget: Budget;
+    verdict: VerdictValue;
+    failures: BudgetFailure[];
+    /** Budgets we could not evaluate (e.g. the page reported no LCP). */
+    unmeasured: string[];
+    counts: {
+        consoleErrors: number;
+        consoleWarnings: number;
+        pageErrors: number;
+        requests: number;
+        failedRequests: number;
+        a11yErrors: number;
+        a11yWarnings: number;
+    };
+    /** This run against the previous N for the same URL (RIG-13). */
+    trend?: TrendReport;
+    /** This run against the immediately previous one (RIG-10). */
+    diff?: RunDiff;
+}
+/** One AX-tree element, addressed by a path of `role[n]` segments. */
+export interface StructureNode {
+    path: string;
+    role: string;
+    name: string | null;
+    depth: number;
+}
+export interface StructureDiff {
+    gained: StructureNode[];
+    lost: StructureNode[];
+    /** Same slot, same role, different accessible name. */
+    renamed: Array<{
+        path: string;
+        role: string;
+        from: string | null;
+        to: string | null;
+    }>;
+    /** Same role and name, different path — reordered, not added or removed. */
+    moved: Array<{
+        role: string;
+        name: string | null;
+        from: string;
+        to: string;
+    }>;
+    unchanged: number;
+    /** gained + lost + renamed. `moved` is excluded: moving is rarely a defect. */
+    changed: number;
+}
+export interface ImageSize {
+    width: number;
+    height: number;
+}
+export interface PixelDiff {
+    /** False when a screenshot could not be decoded; see `note`. */
+    comparable: boolean;
+    changedPixels: number;
+    totalPixels: number;
+    changedPercent: number;
+    previousSize: ImageSize | null;
+    currentSize: ImageSize | null;
+    sizeChanged: boolean;
+    /** Highlight image, `data:image/png;base64,...`. Absent when nothing changed. */
+    diffDataUrl?: string;
+    /** Integer downscale factor applied to the highlight image, when > 1. */
+    scale?: number;
+    note?: string;
+}
+export interface RunDiff {
+    previousRunId: string;
+    previousCapturedAt: string;
+    structure?: StructureDiff;
+    pixels?: PixelDiff;
+    notes: string[];
+}
+export type TrendDirection = 'improved' | 'regressed' | 'flat' | 'new';
+export interface TrendPoint {
+    capturedAt: string;
+    value: number | null;
+}
+export interface TrendSeries {
+    /** Metric key, e.g. `lcp` or `consoleErrors`. */
+    key: string;
+    label: string;
+    unit: 'ms' | 'score' | 'count';
+    /** Oldest to newest; the last point is this run. */
+    points: TrendPoint[];
+    current: number | null;
+    previous: number | null;
+    oldest: number | null;
+    deltaFromPrevious: number | null;
+    deltaFromOldest: number | null;
+    direction: TrendDirection;
+    /** Set when drift across the whole window is big enough to name out loud. */
+    creep?: string;
+}
+export interface TrendReport {
+    /** How many prior runs this run was compared against. */
+    runs: number;
+    windowFrom: string | null;
+    series: TrendSeries[];
+    verdictHistory: Array<{
+        capturedAt: string;
+        verdict: VerdictValue;
+    }>;
+    /** The sentences worth reading first, e.g. slow LCP decay. */
+    headlines: string[];
+}
+/** One screencast frame as the recorder buffers it, before selection. */
+export interface RawFrame {
+    /** Milliseconds since the run started. */
+    offsetMs: number;
+    /** Base64 JPEG, as CDP hands it over. */
+    data: string;
+    bytes: number;
+}
+/**
+ * The recorder's raw output, carried on CaptureData so `runReport` can turn
+ * it into an Evidence block once the verdict is known. Stripped from the JSON
+ * sibling — it is working material, not part of the report.
+ */
+export interface Recording {
+    /** `Date.now()` at the start of the run: the zero of every frame offset. */
+    startedAtMs: number;
+    frames: RawFrame[];
+    /** Frames already dropped to keep the in-memory buffer bounded. */
+    droppedFrames: number;
+    /** True when the caller asked for a recording regardless of the verdict. */
+    requested: boolean;
+}
+export interface EvidenceFrame {
+    /** Milliseconds since the run started. */
+    offsetMs: number;
+    /** `data:image/jpeg;base64,...` */
+    dataUrl: string;
+    bytes: number;
+}
+export type TimelineKind = 'frame' | 'console' | 'pageerror' | 'request' | 'marker';
+export interface TimelineEntry {
+    offsetMs: number;
+    kind: TimelineKind;
+    label: string;
+    detail?: string;
+    severity: 'info' | 'warning' | 'error';
+    /** Index into `Evidence.frames` for a `frame` entry. */
+    frameIndex?: number;
+}
+export interface Evidence {
+    reason: 'budget-failure' | 'requested';
+    /** Offset the timeline is centred on — the first failure we could locate. */
+    focusOffsetMs: number | null;
+    frames: EvidenceFrame[];
+    timeline: TimelineEntry[];
+    /** Frames captured but dropped to stay inside the count/byte budget. */
+    droppedFrames: number;
+    totalBytes: number;
+    notes: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/report/types.js

@@ -0,0 +1,11 @@
+/**
+ * Shared shapes for `monobrowse report` — the one-command page test rig.
+ *
+ * The pipeline is collect (drive the browser) -> analyze (a11y rules +
+ * budget evaluation) -> render (self-contained HTML). Only `collect` talks
+ * to Chrome; everything downstream is a pure function over these types,
+ * which is what makes the analyzer and the renderer unit-testable without
+ * launching a browser.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/report/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

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

@@ -0,0 +1,17 @@
+/** Small shared helpers for the report collectors. */
+/** Budget for one non-navigation collector (AX tree, screenshot, eval). */
+export declare const STEP_TIMEOUT_MS = 15000;
+export declare function sleep(ms: number): Promise<void>;
+export declare function message(err: unknown): string;
+/**
+ * Races a promise against a timer. Used everywhere in collect.ts so a wedged
+ * page degrades into a note instead of hanging the command forever.
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, label: string): Promise<T>;
+/**
+ * HTML-escape a value for interpolation into the report. Lives here rather
+ * than in render.ts so the renderer and its section modules can share it
+ * without importing each other.
+ */
+export declare function escapeHtml(value: unknown): string;
+//# sourceMappingURL=util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/report/util.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,2EAA2E;AAC3E,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAa/F;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOjD"}

package/dist/src/report/util.js

@@ -0,0 +1,45 @@
+/** Small shared helpers for the report collectors. */
+/** Budget for one non-navigation collector (AX tree, screenshot, eval). */
+export const STEP_TIMEOUT_MS = 15_000;
+export function sleep(ms) {
+    return new Promise((r) => {
+        const t = setTimeout(r, ms);
+        t.unref?.();
+    });
+}
+export function message(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * Races a promise against a timer. Used everywhere in collect.ts so a wedged
+ * page degrades into a note instead of hanging the command forever.
+ */
+export async function withTimeout(promise, ms, label) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms);
+                timer.unref?.();
+            }),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * HTML-escape a value for interpolation into the report. Lives here rather
+ * than in render.ts so the renderer and its section modules can share it
+ * without importing each other.
+ */
+export function escapeHtml(value) {
+    return String(value ?? '')
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+//# sourceMappingURL=util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../src/report/util.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QACvB,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,OAAmB,EAAE,EAAU,EAAE,KAAa;IACjF,IAAI,KAAgD,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,OAAO;YACP,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpF,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAClB,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC"}