@ulpi/browse 2.3.3 → 2.4.0

package/dist/types/mcp/server.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP (Model Context Protocol) server for @ulpi/browse.
+ *
+ * Exposes all browse commands as MCP tools over stdio transport.
+ * Each tool call maps to a browse command executed against a local
+ * BrowserTarget instance (no HTTP server needed).
+ */
+export declare function startMcpServer(jsonMode: boolean): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/types/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkKrE"}

package/dist/types/mcp/tools/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * MCP tool definitions registry — derives tool definitions from the
+ * command registry's MCP metadata. No hand-maintained tool arrays.
+ */
+export interface ToolProperty {
+    type: string;
+    description: string;
+    enum?: string[];
+    default?: unknown;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, ToolProperty>;
+        required?: string[];
+    };
+}
+/**
+ * Returns all MCP tool definitions for browse commands.
+ * Derived from registry — commands with `mcp` metadata are exposed as tools.
+ */
+export declare function getToolDefinitions(): ToolDefinition[];
+/**
+ * Map an MCP tool call to a browse command + args array.
+ *
+ * Looks up the command definition (preferred) or spec in the registry and uses
+ * its argDecode function to convert MCP params into CLI args. Virtual tools
+ * (e.g. perf-audit-save) use `mcp.commandName` to route to the actual handler.
+ */
+export declare function mapToolCallToCommand(toolName: string, params: Record<string, unknown>): {
+    command: string;
+    args: string[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/mcp/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACzC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAQrD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAuBrC"}

package/dist/types/network/buffers.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Shared buffers and types — extracted to break circular dependency
+ * between server.ts and browser-manager.ts
+ */
+export interface LogEntry {
+    timestamp: number;
+    level: string;
+    text: string;
+}
+export interface NetworkEntry {
+    timestamp: number;
+    method: string;
+    url: string;
+    status?: number;
+    duration?: number;
+    size?: number;
+    /** Request headers (populated when body capture is enabled) */
+    requestHeaders?: Record<string, string>;
+    /** Request body — POST/PUT/PATCH only (populated when body capture is enabled) */
+    requestBody?: string;
+    /** Response headers (populated when body capture is enabled) */
+    responseHeaders?: Record<string, string>;
+    /** Response body — text-like content types only, capped at NETWORK_BODY_LIMIT (populated when body capture is enabled) */
+    responseBody?: string;
+}
+/**
+ * Per-session buffer container.
+ * Each session (or parallel agent) gets its own instance so buffers
+ * don't bleed across concurrent operations.
+ */
+export declare class SessionBuffers {
+    consoleBuffer: LogEntry[];
+    networkBuffer: NetworkEntry[];
+    consoleTotalAdded: number;
+    networkTotalAdded: number;
+    lastConsoleFlushed: number;
+    lastNetworkFlushed: number;
+    consoleErrorCount: number;
+    networkPendingCount: number;
+    onConsoleEntry?: (entry: LogEntry) => void;
+    onNetworkEntry?: (entry: NetworkEntry) => void;
+    addConsoleEntry(entry: LogEntry): void;
+    addNetworkEntry(entry: NetworkEntry): void;
+    /** Called when a network entry gets its status (response arrived). */
+    resolveNetworkEntry(): void;
+}
+export declare const consoleBuffer: LogEntry[];
+export declare const networkBuffer: NetworkEntry[];
+export declare let consoleTotalAdded: number;
+export declare let networkTotalAdded: number;
+export declare function addConsoleEntry(entry: LogEntry): void;
+export declare function addNetworkEntry(entry: NetworkEntry): void;
+//# sourceMappingURL=buffers.d.ts.map

package/dist/types/network/buffers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffers.d.ts","sourceRoot":"","sources":["../../../src/network/buffers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,0HAA0H;IAC1H,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,aAAa,EAAE,QAAQ,EAAE,CAAM;IAC/B,aAAa,EAAE,YAAY,EAAE,CAAM;IACnC,iBAAiB,SAAK;IACtB,iBAAiB,SAAK;IAEtB,kBAAkB,SAAK;IACvB,kBAAkB,SAAK;IAEvB,iBAAiB,SAAK;IACtB,mBAAmB,SAAK;IAGxB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC3C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAE/C,eAAe,CAAC,KAAK,EAAE,QAAQ;IAW/B,eAAe,CAAC,KAAK,EAAE,YAAY;IAWnC,sEAAsE;IACtE,mBAAmB;CAGpB;AAOD,eAAO,MAAM,aAAa,EAAE,QAAQ,EAAO,CAAC;AAC5C,eAAO,MAAM,aAAa,EAAE,YAAY,EAAO,CAAC;AAIhD,eAAO,IAAI,iBAAiB,QAAI,CAAC;AACjC,eAAO,IAAI,iBAAiB,QAAI,CAAC;AAEjC,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,QAM9C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,QAMlD"}

package/dist/types/network/har.d.ts

@@ -0,0 +1,10 @@
+/**
+ * HAR 1.2 export — converts NetworkEntry[] to HTTP Archive format
+ */
+import type { NetworkEntry } from './buffers';
+export interface HarRecording {
+    startTime: number;
+    active: boolean;
+}
+export declare function formatAsHar(entries: NetworkEntry[], startTime: number): object;
+//# sourceMappingURL=har.d.ts.map

package/dist/types/network/har.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har.d.ts","sourceRoot":"","sources":["../../../src/network/har.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAWD,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA+C9E"}

package/dist/types/network/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Network domain — buffers, HAR export, and network types.
+ */
+export { type LogEntry, type NetworkEntry, SessionBuffers, consoleBuffer, networkBuffer, consoleTotalAdded, networkTotalAdded, addConsoleEntry, addNetworkEntry, } from './buffers';
+export { type HarRecording, formatAsHar, } from './har';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/network/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/network/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,YAAY,EACjB,WAAW,GACZ,MAAM,OAAO,CAAC"}

package/dist/types/perf-audit/diff.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Diff engine for perf-audit reports.
+ *
+ * Compares two PerfAuditReport snapshots (baseline vs current) and produces
+ * a structured diff with regression/improvement detection. Thresholds are
+ * aligned with Web Vitals "good" boundaries so small natural variance does
+ * not trigger false positives.
+ */
+import type { PerfAuditReport } from './index';
+export interface MetricDelta {
+    metric: string;
+    baseline: number | null;
+    current: number | null;
+    /** Absolute change (current - baseline) for timing/size metrics */
+    deltaMs?: number;
+    /** Percentage change ((current - baseline) / baseline * 100) */
+    deltaPct?: number;
+    verdict: 'regression' | 'improvement' | 'unchanged' | 'new' | 'missing';
+}
+export interface AuditDiff {
+    webVitals: MetricDelta[];
+    resourceSize: MetricDelta[];
+    coverage: MetricDelta[];
+    fixableCount: {
+        baseline: number;
+        current: number;
+        delta: number;
+    };
+    summary: {
+        regressions: number;
+        improvements: number;
+        unchanged: number;
+    };
+}
+/**
+ * Compare two PerfAuditReport snapshots and produce a structured diff.
+ *
+ * @param baseline - The earlier (reference) report
+ * @param current  - The later (comparison) report
+ * @returns AuditDiff with per-metric verdicts and a summary
+ */
+export declare function diffAuditReports(baseline: PerfAuditReport, current: PerfAuditReport): AuditDiff;
+//# sourceMappingURL=diff.d.ts.map

package/dist/types/perf-audit/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/perf-audit/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAC;AAM/D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,GAAG,aAAa,GAAG,WAAW,GAAG,KAAK,GAAG,SAAS,CAAC;CACzE;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3E;AA4LD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,eAAe,GACvB,SAAS,CAuEX"}

package/dist/types/perf-audit/dom-analysis.d.ts

@@ -0,0 +1,74 @@
+/**
+ * DOM complexity analysis and cross-metric correlation engine.
+ *
+ * analyzeDOMComplexity() evaluates the page DOM for node count, nesting
+ * depth, and largest subtree -- all factors that affect rendering cost.
+ *
+ * buildCorrelationReport() cross-references Web Vitals, resource data,
+ * and network entries to produce actionable attribution for LCP, CLS,
+ * TBT, and font-blocking issues.
+ */
+import type { Page } from 'playwright';
+import type { WebVitalsReport } from './web-vitals';
+import type { ResourceReport } from './resource-analyzer';
+import type { NetworkEntry } from '../network/buffers';
+export interface DOMComplexityReport {
+    totalNodes: number;
+    maxDepth: number;
+    largestSubtree: {
+        tag: string;
+        id: string | null;
+        className: string | null;
+        descendants: number;
+    } | null;
+    htmlSizeKB: number;
+}
+export interface CorrelationReport {
+    lcpAnalysis: {
+        element: string;
+        networkEntry: {
+            url: string;
+            sizeBytes: number;
+            durationMs: number;
+        } | null;
+        blockingResources: string[];
+        criticalPath: string;
+    } | null;
+    clsAttribution: Array<{
+        time: number;
+        value: number;
+        reason: string;
+        sourceElement: string;
+    }>;
+    longTaskAttribution: Array<{
+        domain: string;
+        totalTbtMs: number;
+        taskCount: number;
+        scripts: string[];
+    }>;
+    fontBlockingFcp: Array<{
+        family: string;
+        fontDisplay: string | null;
+        blockingMs: number | null;
+    }>;
+}
+/**
+ * Evaluate the page DOM for total node count, maximum nesting depth,
+ * the largest direct-child subtree of <body>, and overall HTML size.
+ *
+ * Runs inside page.evaluate() to avoid serializing the entire DOM across
+ * the Playwright wire. The subtree scan is limited to body > * children
+ * to avoid O(n^2) cost on deeply nested pages.
+ */
+export declare function analyzeDOMComplexity(page: Page): Promise<DOMComplexityReport>;
+/**
+ * Cross-reference Web Vitals, resource analysis, and raw network entries
+ * to produce actionable attribution for each core metric:
+ *
+ * - LCP: identify the element, its network cost, blocking resources, critical path
+ * - CLS: attribute each layout shift to images, fonts, ads, or dynamic content
+ * - Long Tasks: group by domain with TBT contribution
+ * - Font blocking: identify fonts that may have blocked FCP via FOIT
+ */
+export declare function buildCorrelationReport(webVitals: WebVitalsReport, resources: ResourceReport, networkEntries: NetworkEntry[]): CorrelationReport;
+//# sourceMappingURL=dom-analysis.d.ts.map

package/dist/types/perf-audit/dom-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-analysis.d.ts","sourceRoot":"","sources":["../../../src/perf-audit/dom-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,IAAI,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QAC5E,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,IAAI,CAAC;IAET,cAAc,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IAEH,mBAAmB,EAAE,KAAK,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;IAEH,eAAe,EAAE,KAAK,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC,CAAC;CACJ;AAMD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuDnF;AA8ID;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,eAAe,EAC1B,SAAS,EAAE,cAAc,EACzB,cAAc,EAAE,YAAY,EAAE,GAC7B,iBAAiB,CA6JnB"}

package/dist/types/perf-audit/formatter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Performance audit report formatter -- converts PerfAuditReport into
+ * human-readable text output (14 sections) or JSON output.
+ *
+ * The text formatter uses Google's Web Vitals thresholds for rating each
+ * metric, generates platform-aware recommendations when a SaaS platform
+ * is detected, and separates fixable items from platform constraints.
+ */
+import type { PerfAuditReport, BudgetEvalResult } from './index';
+/**
+ * Format a PerfAuditReport for output. When `json` is true, returns the
+ * report as pretty-printed JSON. Otherwise returns a human-readable text
+ * report with 14 sections, platform-aware recommendations, and Google
+ * Web Vitals ratings.
+ */
+export declare function formatPerfAudit(report: PerfAuditReport, json?: boolean): string;
+/**
+ * Format a BudgetEvalResult as a pass/fail table.
+ *
+ * Example output:
+ *   Budget:
+ *     ✓ LCP    1200ms  ≤  2500ms
+ *     ✗ TBT     450ms  >   300ms
+ *     - INP       ---  (not measured, skipped)
+ */
+export declare function formatBudgetResult(result: BudgetEvalResult): string;
+import type { AuditDiff } from './diff';
+/**
+ * Format an AuditDiff for output. When `json` is true, returns the diff as
+ * pretty-printed JSON. Otherwise returns a human-readable text report with
+ * Web Vitals, Resources, Coverage, and a summary line.
+ */
+export declare function formatAuditDiff(diff: AuditDiff, json?: boolean): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/types/perf-audit/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../../src/perf-audit/formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgFjF;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,OAAe,GACpB,MAAM,CAGR;AA+mBD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAyBnE;AAMD,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,QAAQ,CAAC;AAUrD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,IAAI,GAAE,OAAe,GACpB,MAAM,CAGR"}

package/dist/types/perf-audit/index.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Performance audit orchestrator -- ties together Web Vitals collection,
+ * resource analysis, DOM complexity measurement, coverage, and stack
+ * detection into a single actionable report.
+ *
+ * The audit flow:
+ *   1. Inject Web Vitals init script into the browser context
+ *   2. Optionally start code coverage (JS + CSS)
+ *   3. Reload the page to trigger fresh observers
+ *   4. Collect all metrics in parallel (web vitals, resources, DOM)
+ *   5. Optionally detect the technology stack
+ *   6. Stop coverage and compute unused bytes
+ *   7. Cross-reference metrics into a correlation report
+ *   8. Separate findings into fixable items vs platform limitations
+ */
+import type { BrowserTarget } from '../browser/target';
+import type { NetworkEntry } from '../network/buffers';
+import type { WebVitalsReport } from './web-vitals';
+import type { ResourceReport } from './resource-analyzer';
+import type { DOMComplexityReport, CorrelationReport } from './dom-analysis';
+import type { StackFingerprint } from '../detection';
+export interface PerfAuditOptions {
+    /** Collect JS and CSS coverage data (default: true) */
+    includeCoverage?: boolean;
+    /** Run stack/framework/SaaS detection (default: true) */
+    includeDetection?: boolean;
+}
+/**
+ * Performance budget thresholds.
+ * Keys are metric names (case-insensitive), values are numeric thresholds.
+ * Supported keys: lcp, cls, tbt, fcp, ttfb, inp
+ */
+export type PerfBudget = Record<string, number>;
+export interface BudgetLineResult {
+    /** Metric key (lowercase), e.g. "lcp" */
+    key: string;
+    /** The measured value (null means metric was not available — skipped) */
+    measured: number | null;
+    /** The budget threshold */
+    threshold: number;
+    /** true = metric was not measured, skip rather than fail */
+    skipped: boolean;
+    /** true = metric passes budget, false = exceeds budget */
+    passed: boolean;
+}
+export interface BudgetEvalResult {
+    lines: BudgetLineResult[];
+    /** true when all non-skipped metrics pass their budgets */
+    allPassed: boolean;
+}
+/**
+ * Parse a budget string like "lcp:2500,cls:0.1,tbt:300" into a Record.
+ * Unknown keys are silently ignored. Throws on malformed numeric values.
+ */
+export declare function parseBudget(raw: string): PerfBudget;
+/**
+ * Evaluate measured web vitals against a budget.
+ * Pure function — deterministic, no I/O, safe to unit-test with fixed fixtures.
+ *
+ * @param vitals - Partial map of metric key -> measured value (null = not measured)
+ * @param budget - Budget thresholds (from parseBudget)
+ */
+export declare function evaluateBudget(vitals: Partial<Record<string, number | null>>, budget: PerfBudget): BudgetEvalResult;
+export interface CoverageResult {
+    js: Array<{
+        url: string;
+        totalBytes: number;
+        usedBytes: number;
+        unusedBytes: number;
+        unusedPct: number;
+    }>;
+    css: Array<{
+        url: string;
+        totalBytes: number;
+        usedBytes: number;
+        unusedBytes: number;
+        unusedPct: number;
+    }>;
+}
+export type SectionStatus = 'ok' | 'partial' | 'skipped' | 'failed';
+export interface PerfAuditReport {
+    webVitals: WebVitalsReport;
+    resources: ResourceReport;
+    domComplexity: DOMComplexityReport;
+    correlations: CorrelationReport;
+    detection: StackFingerprint | null;
+    coverage: CoverageResult | null;
+    /** Actionable items the developer can fix */
+    fixable: string[];
+    /** Things constrained by the platform (SaaS/hosted) */
+    platformLimitations: string[];
+    /** Per-section status — tells agents exactly what worked and what didn't */
+    status: {
+        reload: SectionStatus;
+        webVitals: SectionStatus;
+        resources: SectionStatus;
+        domComplexity: SectionStatus;
+        detection: SectionStatus;
+        coverage: SectionStatus;
+        correlations: SectionStatus;
+    };
+    /** Human-readable warnings about partial failures or fallbacks */
+    warnings: string[];
+    /** Timing breakdown in ms — how long each phase took */
+    timing: {
+        totalMs: number;
+        reloadMs: number;
+        settleMs: number;
+        collectMs: number;
+        detectionMs: number;
+        coverageMs: number;
+    };
+}
+/**
+ * Run a full performance audit on the current page. Collects Web Vitals,
+ * analyzes resources, measures DOM complexity, optionally collects
+ * coverage and detects the technology stack, then cross-references
+ * everything into a single actionable report.
+ *
+ * The page is reloaded as part of the audit to inject the Web Vitals
+ * init script and collect fresh data.
+ *
+ * @param bm - BrowserManager with an active page
+ * @param networkEntries - Network entries from the session buffer
+ * @param options - Optional flags to skip coverage or detection
+ */
+export declare function runPerfAudit(bm: BrowserTarget, networkEntries: NetworkEntry[], options?: PerfAuditOptions): Promise<PerfAuditReport>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/perf-audit/index.d.ts.map

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

package/dist/types/perf-audit/persist.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Persistence layer for perf-audit reports.
+ *
+ * Saves, loads, lists, and deletes JSON report files under
+ * `<localDir>/audits/`.  Follows the same patterns as the
+ * `state save/load/list` implementation in `commands/meta.ts`.
+ */
+import type { PerfAuditReport } from './index';
+/**
+ * Persist a perf-audit report as pretty-printed JSON.
+ *
+ * Creates the `audits/` directory if it does not exist.
+ * Returns the absolute path of the written file.
+ */
+export declare function saveAudit(localDir: string, name: string, report: PerfAuditReport): string;
+/**
+ * Load a previously-saved perf-audit report by name.
+ *
+ * Throws a descriptive error when the file does not exist so the
+ * caller (or the AI agent) knows exactly what to do next.
+ */
+export declare function loadAudit(localDir: string, name: string): PerfAuditReport;
+/**
+ * List every saved audit report.
+ *
+ * Returns an empty array (no crash) when the `audits/` directory
+ * does not yet exist.  Results are sorted newest-first.
+ */
+export declare function listAudits(localDir: string): Array<{
+    name: string;
+    sizeBytes: number;
+    date: string;
+}>;
+/**
+ * Delete a saved audit report by name.
+ *
+ * Throws when the file does not exist.
+ */
+export declare function deleteAudit(localDir: string, name: string): void;
+//# sourceMappingURL=persist.d.ts.map

package/dist/types/perf-audit/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../src/perf-audit/persist.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAkB/C;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,GACtB,MAAM,CAOR;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,eAAe,CAQjB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,GACf,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB1D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQhE"}

package/dist/types/perf-audit/recommendations.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Recommendation engine for performance audit reports.
+ *
+ * Generates 3-5 prioritized, actionable recommendations from actual measured
+ * data. When a SaaS platform is detected, includes platform-specific
+ * suggestions tailored to Shopify, WordPress, Magento, and Wix.
+ *
+ * Recommendations are scored by estimated impact (bytes saved or ms reduced)
+ * and returned sorted by priority.
+ */
+import type { PerfAuditReport } from './index';
+/**
+ * Analyze the full PerfAuditReport and produce a prioritized list of
+ * actionable recommendation strings. Returns up to ~15 candidates
+ * sorted by estimated impact; the caller should cap at 3-5.
+ */
+export declare function generateRecommendations(report: PerfAuditReport): string[];
+//# sourceMappingURL=recommendations.d.ts.map

package/dist/types/perf-audit/recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../src/perf-audit/recommendations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAC;AAiD/D;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAkIzE"}

package/dist/types/perf-audit/resource-analyzer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Resource analyzer — categorizes network resources and audits images,
+ * fonts, and render-blocking elements for performance issues.
+ */
+import type { Page } from 'playwright';
+import type { NetworkEntry } from '../network/buffers';
+export interface ResourceCategory {
+    count: number;
+    totalSizeBytes: number;
+    largest: {
+        url: string;
+        sizeBytes: number;
+    } | null;
+}
+export interface ImageAuditItem {
+    src: string;
+    issues: string[];
+}
+export interface FontAuditItem {
+    family: string;
+    weight: string;
+    fontDisplay: string | null;
+    preloaded: boolean;
+    foitRisk: boolean;
+}
+export interface RenderBlockingItem {
+    type: 'script' | 'stylesheet';
+    url: string;
+    sizeBytes: number | null;
+}
+export interface ResourceReport {
+    categories: Record<string, ResourceCategory>;
+    thirdPartyByDomain: Record<string, {
+        count: number;
+        totalSizeBytes: number;
+    }>;
+    imageAudit: ImageAuditItem[];
+    fontAudit: FontAuditItem[];
+    renderBlocking: RenderBlockingItem[];
+}
+/**
+ * Analyze network resources and audit images, fonts, and render-blocking
+ * elements on the current page.
+ */
+export declare function analyzeResources(networkEntries: NetworkEntry[], page: Page): Promise<ResourceReport>;
+//# sourceMappingURL=resource-analyzer.d.ts.map

package/dist/types/perf-audit/resource-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-analyzer.d.ts","sourceRoot":"","sources":["../../../src/perf-audit/resource-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,cAAc,EAAE,kBAAkB,EAAE,CAAC;CACtC;AAibD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,YAAY,EAAE,EAC9B,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,cAAc,CAAC,CAwDzB"}

package/dist/types/perf-audit/web-vitals.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Web Vitals observer injection and collection for performance auditing.
+ *
+ * WEB_VITALS_INIT_SCRIPT is a plain string IIFE injected via context.addInitScript()
+ * before any page JS runs. It sets up buffered PerformanceObservers for LCP, CLS,
+ * INP, long tasks, and paint timings on window.__BROWSE_PERF_METRICS.
+ *
+ * collectWebVitals() reads the accumulated metrics after navigation completes.
+ */
+import type { Page } from 'playwright';
+export interface WebVitalsReport {
+    /** Time to First Byte (ms) from Navigation Timing API */
+    ttfb: number;
+    /** First Contentful Paint (ms), null if not observed */
+    fcp: number | null;
+    /** Largest Contentful Paint (ms), null if not observed */
+    lcp: number | null;
+    /** Cumulative Layout Shift (unitless), null if not observed */
+    cls: number | null;
+    /** Total Blocking Time (ms), null if no long tasks */
+    tbt: number | null;
+    /** Interaction to Next Paint (ms) -- p98 of interaction durations, null if none */
+    inp: number | null;
+    /** Details about the LCP element */
+    lcpElement: {
+        tag: string;
+        id?: string;
+        url?: string;
+        size: number;
+        fetchpriority?: string;
+        loading?: string;
+    } | null;
+    /** Individual layout shift entries (excluding input-driven shifts) */
+    layoutShifts: Array<{
+        time: number;
+        value: number;
+        sources: Array<{
+            tag: string;
+            id?: string;
+            shift: string;
+        }>;
+    }>;
+    /** Long tasks (>50ms) observed during page load */
+    longTasks: Array<{
+        time: number;
+        duration: number;
+        scriptUrl: string | null;
+    }>;
+    /** Raw paint timing entries */
+    paintTimings: {
+        fp: number | null;
+        fcp: number | null;
+    };
+}
+/**
+ * IIFE string that installs buffered PerformanceObservers on
+ * window.__BROWSE_PERF_METRICS. Each observer type is wrapped in its own
+ * try/catch so unsupported entry types degrade gracefully.
+ *
+ * Must be a plain string (not a function reference) because Playwright's
+ * addInitScript serialises string arguments directly into the page context.
+ */
+export declare const WEB_VITALS_INIT_SCRIPT = "(function() {\n  if (window.__BROWSE_PERF_METRICS) return;\n\n  var m = window.__BROWSE_PERF_METRICS = {\n    lcp: null,\n    lcpElement: null,\n    cls: 0,\n    clsShifts: [],\n    inp: null,\n    _interactions: [],\n    longTasks: [],\n    tbt: 0,\n    paintFP: null,\n    paintFCP: null\n  };\n\n  // 1. Largest Contentful Paint -------------------------------------------\n  try {\n    new PerformanceObserver(function(list) {\n      var entries = list.getEntries();\n      for (var i = 0; i < entries.length; i++) {\n        var e = entries[i];\n        m.lcp = e.startTime;\n        var el = e.element;\n        m.lcpElement = {\n          tag: el ? el.tagName.toLowerCase() : 'unknown',\n          id: el && el.id ? el.id : undefined,\n          className: el && el.className ? String(el.className) : undefined,\n          url: e.url || undefined,\n          size: e.size || 0,\n          fetchpriority: el ? el.getAttribute('fetchpriority') || undefined : undefined,\n          loading: el ? el.getAttribute('loading') || undefined : undefined\n        };\n      }\n    }).observe({ type: 'largest-contentful-paint', buffered: true });\n  } catch(_) {}\n\n  // 2. Layout Shift (CLS) -------------------------------------------------\n  try {\n    new PerformanceObserver(function(list) {\n      var entries = list.getEntries();\n      for (var i = 0; i < entries.length; i++) {\n        var e = entries[i];\n        var sources = [];\n        if (e.sources) {\n          for (var j = 0; j < e.sources.length; j++) {\n            var s = e.sources[j];\n            var node = s.node;\n            sources.push({\n              tag: node ? node.tagName.toLowerCase() : 'unknown',\n              id: node && node.id ? node.id : undefined,\n              currentRect: s.currentRect\n                ? s.currentRect.x + ',' + s.currentRect.y + ' ' + s.currentRect.width + 'x' + s.currentRect.height\n                : null,\n              previousRect: s.previousRect\n                ? s.previousRect.x + ',' + s.previousRect.y + ' ' + s.previousRect.width + 'x' + s.previousRect.height\n                : null\n            });\n          }\n        }\n        m.clsShifts.push({\n          value: e.value,\n          startTime: e.startTime,\n          hadRecentInput: e.hadRecentInput,\n          sources: sources\n        });\n        // CLS excludes input-driven shifts\n        if (!e.hadRecentInput) {\n          m.cls += e.value;\n        }\n      }\n    }).observe({ type: 'layout-shift', buffered: true });\n  } catch(_) {}\n\n  // 3. Event timing (INP) -------------------------------------------------\n  try {\n    new PerformanceObserver(function(list) {\n      var entries = list.getEntries();\n      for (var i = 0; i < entries.length; i++) {\n        var e = entries[i];\n        m._interactions.push(e.duration);\n      }\n    }).observe({ type: 'event', buffered: true, durationThreshold: 16 });\n  } catch(_) {}\n\n  // 4. Long Tasks (TBT) ---------------------------------------------------\n  try {\n    new PerformanceObserver(function(list) {\n      var entries = list.getEntries();\n      for (var i = 0; i < entries.length; i++) {\n        var e = entries[i];\n        var attr = e.attribution && e.attribution[0];\n        m.longTasks.push({\n          startTime: e.startTime,\n          duration: e.duration,\n          containerSrc: attr ? attr.containerSrc || null : null,\n          containerName: attr ? attr.containerName || null : null\n        });\n        // TBT = sum of (duration - 50ms) for each long task\n        if (e.duration > 50) {\n          m.tbt += (e.duration - 50);\n        }\n      }\n    }).observe({ type: 'longtask', buffered: true });\n  } catch(_) {}\n\n  // 5. Paint (FP + FCP) ---------------------------------------------------\n  try {\n    new PerformanceObserver(function(list) {\n      var entries = list.getEntries();\n      for (var i = 0; i < entries.length; i++) {\n        var e = entries[i];\n        if (e.name === 'first-paint') m.paintFP = e.startTime;\n        if (e.name === 'first-contentful-paint') m.paintFCP = e.startTime;\n      }\n    }).observe({ type: 'paint', buffered: true });\n  } catch(_) {}\n})();";
+/**
+ * Collect Web Vitals metrics from a page that had WEB_VITALS_INIT_SCRIPT
+ * injected before navigation. Also reads TTFB from the Navigation Timing API.
+ *
+ * Returns a structured WebVitalsReport. Fields are null when the browser did
+ * not emit the corresponding PerformanceObserver entries (e.g. no interactions
+ * means INP is null).
+ */
+export declare function collectWebVitals(page: Page): Promise<WebVitalsReport>;
+//# sourceMappingURL=web-vitals.d.ts.map

package/dist/types/perf-audit/web-vitals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-vitals.d.ts","sourceRoot":"","sources":["../../../src/perf-audit/web-vitals.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,0DAA0D;IAC1D,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,+DAA+D;IAC/D,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,sDAAsD;IACtD,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,mFAAmF;IACnF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,oCAAoC;IACpC,UAAU,EAAE;QACV,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;IACT,sEAAsE;IACtE,YAAY,EAAE,KAAK,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC7D,CAAC,CAAC;IACH,mDAAmD;IACnD,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC,CAAC;IACH,+BAA+B;IAC/B,YAAY,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACzD;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,imIAqH7B,CAAC;AAMP;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,CA2H3E"}