perfgraph 0.1.0

package/dist/distill/insights.js

@@ -0,0 +1,317 @@
+/**
+ * Agent-optimized summary layer that fuses Lighthouse insights,
+ * extracted features, and evidence data into a compact Insights structure.
+ *
+ * The result can be serialized to `insights.toon` (~5-15 KB for a typical SPA).
+ *
+ * @packageDocumentation
+ */
+import { buildLighthouseInsights } from '../normalize/lighthouse-insights.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function safeNumber(value) {
+    return typeof value === 'number' ? value : undefined;
+}
+/** Navigate to the LHR root — handles { lhr: {...} } wrapper used by LighthouseRawData. */
+function getLHRRoot(raw) {
+    if (!isRecord(raw))
+        return {};
+    if (isRecord(raw.lhr))
+        return raw.lhr;
+    return raw;
+}
+/** Extract numericValue from a Lighthouse audit by ID. */
+function getAuditNumericValue(lhr, auditId) {
+    const audits = isRecord(lhr.audits) ? lhr.audits : {};
+    const audit = isRecord(audits[auditId])
+        ? audits[auditId]
+        : undefined;
+    return safeNumber(audit?.numericValue);
+}
+/** Extract category scores from Lighthouse. */
+function extractScores(raw) {
+    const lhr = getLHRRoot(raw);
+    const categories = isRecord(lhr.categories) ? lhr.categories : {};
+    const getScore = (name) => {
+        const cat = categories[name];
+        return isRecord(cat) ? safeNumber(cat.score) : undefined;
+    };
+    return {
+        performance: getScore('performance'),
+        accessibility: getScore('accessibility'),
+        bestPractices: getScore('best-practices'),
+        seo: getScore('seo'),
+    };
+}
+// ---------------------------------------------------------------------------
+// Build helpers
+// ---------------------------------------------------------------------------
+/** Build lcpElement from Lighthouse insights + features. */
+function buildLcpElement(insights, features) {
+    const lb = insights.lcpBreakdown;
+    if (!lb)
+        return undefined;
+    return {
+        selector: lb.lcpElementSelector ?? '',
+        snippet: lb.lcpElementSnippet,
+        nodeLabel: lb.lcpElementNodeLabel,
+        renderDelayMs: lb.elementRenderDelay,
+        resourceLoadDelayMs: features.lcpBreakdown?.resourceLoadDelay,
+        resourceLoadTimeMs: features.lcpBreakdown?.resourceLoadTime,
+        ttfbMs: lb.timeToFirstByte,
+    };
+}
+/** Build renderBlocking array from Lighthouse insights. */
+function buildRenderBlocking(insights) {
+    const rb = insights.renderBlocking;
+    if (!rb || !rb.resources)
+        return [];
+    return rb.resources.map((r) => ({
+        url: r.url,
+        bytes: r.totalBytes,
+        wastedMs: r.wastedMs,
+    }));
+}
+/** Convert a NetworkChainNode to a CriticalPathNode. */
+function convertChainNode(node) {
+    const result = {
+        url: node.url,
+        durationMs: node.navStartToEndTime,
+    };
+    if (node.children) {
+        const children = Object.values(node.children).map(convertChainNode);
+        if (children.length > 0) {
+            result.children = children;
+        }
+    }
+    return result;
+}
+/** Build criticalPath from features + Lighthouse insights. */
+function buildCriticalPath(features, insights) {
+    const cp = features.criticalPath;
+    const ndt = insights.networkDependencyTree;
+    if (!cp && !ndt)
+        return undefined;
+    let tree;
+    if (ndt?.chains) {
+        const entries = Object.values(ndt.chains);
+        if (entries.length > 0) {
+            tree = convertChainNode(entries[0]);
+        }
+    }
+    return {
+        depth: cp?.deepestChainDepth ?? 0,
+        longestChainMs: ndt?.longestChainDuration ?? cp?.longestSingleRequest,
+        tree,
+    };
+}
+/** Collect warnings from multiple sources. */
+function buildWarnings(lighthouseJson) {
+    const warnings = [];
+    // From LighthouseRawData.warnings (collection-level warnings)
+    const raw = lighthouseJson;
+    if (Array.isArray(raw.warnings)) {
+        for (const w of raw.warnings) {
+            if (typeof w === 'string')
+                warnings.push(w);
+        }
+    }
+    // From LHR runtime warnings
+    const lhr = getLHRRoot(lighthouseJson);
+    if (Array.isArray(lhr.warnings)) {
+        for (const w of lhr.warnings) {
+            if (typeof w === 'string')
+                warnings.push(w);
+        }
+    }
+    return warnings;
+}
+function buildRecommendations(input) {
+    const recs = [];
+    // Critical: LCP > 4000ms
+    if (input.lcpMs !== undefined && input.lcpMs > 4000) {
+        recs.push({
+            priority: 'critical',
+            title: 'Optimize Largest Contentful Paint',
+            action: 'Reduce LCP by optimizing server response time, eliminating render-blocking resources, and optimizing images.',
+            evidence: [`LCP: ${input.lcpMs}ms`],
+        });
+    }
+    // Critical: TBT > 600ms
+    if (input.tbtMs !== undefined && input.tbtMs > 600) {
+        recs.push({
+            priority: 'critical',
+            title: 'Reduce Total Blocking Time',
+            action: 'Break up long tasks, reduce JavaScript execution time, and consider code splitting.',
+            evidence: [`TBT: ${input.tbtMs}ms`],
+        });
+    }
+    // Critical: CLS > 0.25
+    if (input.cls !== undefined && input.cls > 0.25) {
+        recs.push({
+            priority: 'critical',
+            title: 'Reduce Cumulative Layout Shift',
+            action: 'Set explicit dimensions on images and embeds, avoid inserting content above existing content.',
+            evidence: [`CLS: ${input.cls}`],
+        });
+    }
+    // High: LCP > 2500ms (not already critical)
+    if (input.lcpMs !== undefined &&
+        input.lcpMs > 2500 &&
+        input.lcpMs <= 4000) {
+        recs.push({
+            priority: 'high',
+            title: 'Improve LCP to meet 2.5s threshold',
+            action: 'Optimize server response time (TTFB), preload key resources, and optimize the LCP element.',
+            evidence: [`LCP: ${input.lcpMs}ms`],
+        });
+    }
+    // High: render blocking resources exist
+    if (input.renderBlocking.length > 0) {
+        const totalWasted = input.renderBlocking.reduce((s, r) => s + (r.wastedMs ?? 0), 0);
+        const evidence = [
+            `${input.renderBlocking.length} render-blocking resources`,
+        ];
+        if (totalWasted > 0) {
+            evidence.push(`Potential savings: ${totalWasted}ms`);
+        }
+        recs.push({
+            priority: 'high',
+            title: 'Reduce render-blocking resources',
+            action: 'Defer non-critical CSS and JavaScript, inline critical styles, and use preload for key resources.',
+            evidence,
+        });
+    }
+    // High: deep critical chain
+    if (input.criticalPath && input.criticalPath.depth > 5) {
+        recs.push({
+            priority: 'high',
+            title: 'Optimize critical request chain',
+            action: 'Reduce sequential network requests by inlining critical resources, using HTTP/2, and preloading key assets.',
+            evidence: [`Critical chain depth: ${input.criticalPath.depth}`],
+        });
+    }
+    // Medium: high FCP
+    if (input.fcpMs !== undefined && input.fcpMs > 3000) {
+        recs.push({
+            priority: 'medium',
+            title: 'Improve First Contentful Paint',
+            action: 'Reduce server response time and eliminate render-blocking resources above the fold.',
+            evidence: [`FCP: ${input.fcpMs}ms`],
+        });
+    }
+    // Medium: third-party overhead
+    const tp = input.features.thirdPartyOverhead;
+    if (tp && tp.thirdPartyRatio > 0.3) {
+        recs.push({
+            priority: 'medium',
+            title: 'Reduce third-party code overhead',
+            action: 'Audit third-party scripts for necessity, defer non-critical ones, use async loading.',
+            evidence: [
+                `Third-party ratio: ${(tp.thirdPartyRatio * 100).toFixed(1)}%`,
+            ],
+        });
+    }
+    // Medium: many long tasks
+    const js = input.features.jsHotspots;
+    if (js && js.longTaskCount > 10) {
+        recs.push({
+            priority: 'medium',
+            title: 'Reduce JavaScript long tasks',
+            action: 'Break up JavaScript execution into smaller chunks, use requestIdleCallback, consider web workers.',
+            evidence: [`${js.longTaskCount} long tasks detected`],
+        });
+    }
+    return recs;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Build a compact Insights structure from extracted features and raw
+ * Lighthouse data.
+ *
+ * The result is designed to be serialized as `insights.toon` (~5-15 KB)
+ * and consumed by AI agents for quick performance diagnosis.
+ *
+ * @param features - Extracted feature set from `extract()`
+ * @param lighthouseJson - Raw Lighthouse JSON (LighthouseRawData or plain LHR)
+ * @returns A compact Insights structure
+ */
+export function buildInsights(features, lighthouseJson) {
+    // 1. Parse Lighthouse insight audits
+    const lighthouseInsights = buildLighthouseInsights(lighthouseJson);
+    // 2. Lighthouse scores block
+    const scores = extractScores(lighthouseJson);
+    // 3. Navigate to LHR audit container
+    const lhr = getLHRRoot(lighthouseJson);
+    // 4. Metrics from Lighthouse audits (fallback chain)
+    const lcpAuditMs = getAuditNumericValue(lhr, 'largest-contentful-paint');
+    const fcpMs = getAuditNumericValue(lhr, 'first-contentful-paint');
+    const clsAudit = getAuditNumericValue(lhr, 'cumulative-layout-shift');
+    const tbtAudit = getAuditNumericValue(lhr, 'total-blocking-time');
+    // LCP: prefer FeatureSet breakdown total, then Lighthouse insight
+    // composite, then raw audit
+    const lcpMs = features.lcpBreakdown?.totalLCP ??
+        (lighthouseInsights.lcpBreakdown
+            ? lighthouseInsights.lcpBreakdown.timeToFirstByte +
+                lighthouseInsights.lcpBreakdown.elementRenderDelay
+            : undefined) ??
+        lcpAuditMs;
+    // CLS: prefer FeatureSet, then raw audit
+    const cls = features.layoutShifts?.cls ?? clsAudit;
+    // TBT: prefer Lighthouse audit (the real TBT metric) when it's sane,
+    // otherwise use FeatureSet busyMs, or undefined if both are absurd.
+    // In headless/automated environments Lighthouse TBT can be wildly inflated
+    // (e.g. 151s) due to CDP overhead or browser throttling — we cap at 60s
+    // and fall back to busyMs as a best-effort proxy.
+    const TBT_SANE_MAX = 60_000; // 60 seconds — anything above is an artifact
+    const tbtMs = tbtAudit !== undefined && tbtAudit >= 0 && tbtAudit <= TBT_SANE_MAX
+        ? tbtAudit
+        : features.mainThreadBlocking?.busyMs !== undefined &&
+            features.mainThreadBlocking?.busyMs <= TBT_SANE_MAX
+            ? features.mainThreadBlocking?.busyMs
+            : undefined;
+    // 5. LCP element
+    const lcpElement = buildLcpElement(lighthouseInsights, features);
+    // 6. Render-blocking resources
+    const renderBlocking = buildRenderBlocking(lighthouseInsights);
+    // 7. Critical path
+    const criticalPath = buildCriticalPath(features, lighthouseInsights);
+    // 8. Warnings
+    const warnings = buildWarnings(lighthouseJson);
+    // 9. Data-driven recommendations
+    const topRecommendations = buildRecommendations({
+        lcpMs,
+        fcpMs,
+        cls,
+        tbtMs,
+        renderBlocking,
+        criticalPath,
+        features,
+    });
+    return {
+        url: features.url ?? '',
+        analyzedAt: new Date().toISOString(),
+        lighthouse: {
+            performance: scores.performance,
+            accessibility: scores.accessibility,
+            bestPractices: scores.bestPractices,
+            seo: scores.seo,
+            lcpMs,
+            fcpMs,
+            cls,
+            tbtMs,
+        },
+        lcpElement,
+        renderBlocking,
+        criticalPath,
+        warnings,
+        topRecommendations,
+    };
+}
+//# sourceMappingURL=insights.js.map

package/dist/distill/insights.js.map

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

package/dist/distill/summaries.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Compact summary builders for large raw data files.
+ *
+ * Each function takes a raw data structure (network.json, lighthouse.json,
+ * coverage.json) and returns a small summary object that can be written
+ * as a companion file (~1-5 KB) for agent consumption.
+ *
+ * @packageDocumentation
+ */
+import type { NetworkRawData, LighthouseRawData, CoverageRawData } from '../collect/types.js';
+export interface NetworkSummary {
+    totalRequests: number;
+    totalBytes: number;
+    topRequestsByDuration: Array<{
+        url: string;
+        duration: number;
+        resourceType: string;
+        bytes: number;
+    }>;
+    blockingResources: Array<{
+        url: string;
+        resourceType: string;
+    }>;
+    initiatorChains: Array<{
+        url: string;
+        depth: number;
+    }>;
+}
+export interface LighthouseSummary {
+    categories: Record<string, number>;
+    failedInsightAudits: Array<{
+        id: string;
+        title: string;
+        score: number;
+    }>;
+}
+export interface CoverageSummary {
+    unusedBytesByUrl: Array<{
+        url: string;
+        totalBytes: number;
+        unusedBytes: number;
+        unusedPercentage: number;
+    }>;
+}
+/**
+ * Build a compact summary of network request data.
+ *
+ * @param network - Raw network data from NetworkCollector
+ * @returns A compact NetworkSummary (~1-3 KB)
+ */
+export declare function buildNetworkSummary(network: NetworkRawData): NetworkSummary;
+/**
+ * Build a compact summary of Lighthouse audit results.
+ *
+ * @param lighthouse - Raw Lighthouse data from LighthouseCollector
+ * @returns A compact LighthouseSummary (~1-2 KB)
+ */
+export declare function buildLighthouseSummary(lighthouse: LighthouseRawData): LighthouseSummary;
+/**
+ * Build a compact summary of JS/CSS code coverage data.
+ *
+ * Coverage data from CDP does not include the full script source, so
+ * `totalBytes` is approximated as the maximum `endOffset` across all
+ * coverage ranges. This gives a lower-bound estimate of the script size;
+ * truly uncovered code that falls outside any range is not counted.
+ *
+ * @param coverage - Raw coverage data from CoverageCollector
+ * @returns A compact CoverageSummary (~1-3 KB)
+ */
+export declare function buildCoverageSummary(coverage: CoverageRawData): CoverageSummary;
+//# sourceMappingURL=summaries.d.ts.map

package/dist/distill/summaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summaries.d.ts","sourceRoot":"","sources":["../../src/distill/summaries.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,eAAe,EAEhB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE,KAAK,CAAC;QAC3B,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,iBAAiB,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,eAAe,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,mBAAmB,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,KAAK,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;CACJ;AAyCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAgC3E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,iBAAiB,GAC5B,iBAAiB,CA8BnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,GACxB,eAAe,CA6DjB"}

package/dist/distill/summaries.js

@@ -0,0 +1,165 @@
+/**
+ * Compact summary builders for large raw data files.
+ *
+ * Each function takes a raw data structure (network.json, lighthouse.json,
+ * coverage.json) and returns a small summary object that can be written
+ * as a companion file (~1-5 KB) for agent consumption.
+ *
+ * @packageDocumentation
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Merge overlapping CoverageRange[] so that intersecting spans are
+ * counted once. Returns a new sorted, non-overlapping array.
+ */
+function mergeRanges(ranges) {
+    if (ranges.length === 0)
+        return [];
+    const sorted = [...ranges].sort((a, b) => a.startOffset - b.startOffset);
+    const merged = [{ ...sorted[0] }];
+    for (let i = 1; i < sorted.length; i++) {
+        const last = merged[merged.length - 1];
+        const current = sorted[i];
+        if (current.startOffset <= last.endOffset) {
+            // Extend last range if current ends further
+            if (current.endOffset > last.endOffset) {
+                last.endOffset = current.endOffset;
+            }
+        }
+        else {
+            merged.push({ ...current });
+        }
+    }
+    return merged;
+}
+// ---------------------------------------------------------------------------
+// Summary builders
+// ---------------------------------------------------------------------------
+/**
+ * Build a compact summary of network request data.
+ *
+ * @param network - Raw network data from NetworkCollector
+ * @returns A compact NetworkSummary (~1-3 KB)
+ */
+export function buildNetworkSummary(network) {
+    const requests = network.requests ?? [];
+    // Sort by response receive time descending (longest first)
+    const sorted = [...requests].sort((a, b) => {
+        const durA = a.response?.timing?.receiveHeadersEnd ?? 0;
+        const durB = b.response?.timing?.receiveHeadersEnd ?? 0;
+        return durB - durA;
+    });
+    return {
+        totalRequests: requests.length,
+        totalBytes: requests.reduce((s, r) => s + (r.response?.encodedDataLength ?? 0), 0),
+        topRequestsByDuration: sorted.slice(0, 20).map((r) => ({
+            url: r.url,
+            duration: r.response?.timing?.receiveHeadersEnd ?? 0,
+            resourceType: r.type ?? 'unknown',
+            bytes: r.response?.encodedDataLength ?? 0,
+        })),
+        blockingResources: requests
+            .filter((r) => r.type === 'Stylesheet' || r.type === 'Script')
+            .map((r) => ({
+            url: r.url,
+            resourceType: r.type ?? 'unknown',
+        })),
+        initiatorChains: [], // Placeholder — real initiator chain data from IR
+    };
+}
+/**
+ * Build a compact summary of Lighthouse audit results.
+ *
+ * @param lighthouse - Raw Lighthouse data from LighthouseCollector
+ * @returns A compact LighthouseSummary (~1-2 KB)
+ */
+export function buildLighthouseSummary(lighthouse) {
+    const lhr = isRecord(lighthouse.lhr) ? lighthouse.lhr : {};
+    // Extract category scores
+    const categories = {};
+    const catObj = isRecord(lhr.categories) ? lhr.categories : {};
+    for (const [id, cat] of Object.entries(catObj)) {
+        if (isRecord(cat) && typeof cat.score === 'number') {
+            categories[id] = cat.score;
+        }
+    }
+    // Extract failed insight audits (score < 0.5)
+    const failedInsightAudits = [];
+    const auditsObj = isRecord(lhr.audits) ? lhr.audits : {};
+    for (const [id, audit] of Object.entries(auditsObj)) {
+        if (isRecord(audit) &&
+            typeof audit.score === 'number' &&
+            audit.score < 0.5) {
+            failedInsightAudits.push({
+                id,
+                title: typeof audit.title === 'string' ? audit.title : id,
+                score: audit.score,
+            });
+        }
+    }
+    return { categories, failedInsightAudits };
+}
+/**
+ * Build a compact summary of JS/CSS code coverage data.
+ *
+ * Coverage data from CDP does not include the full script source, so
+ * `totalBytes` is approximated as the maximum `endOffset` across all
+ * coverage ranges. This gives a lower-bound estimate of the script size;
+ * truly uncovered code that falls outside any range is not counted.
+ *
+ * @param coverage - Raw coverage data from CoverageCollector
+ * @returns A compact CoverageSummary (~1-3 KB)
+ */
+export function buildCoverageSummary(coverage) {
+    const entries = [];
+    // ---- JS scripts ----
+    for (const script of coverage.js ?? []) {
+        const allRanges = [];
+        for (const fn of script.functions ?? []) {
+            for (const range of fn.ranges ?? []) {
+                allRanges.push(range);
+            }
+        }
+        if (allRanges.length === 0)
+            continue;
+        const merged = mergeRanges(allRanges);
+        const totalBytes = merged[merged.length - 1].endOffset;
+        const usedBytes = merged.reduce((sum, r) => sum + (r.endOffset - r.startOffset), 0);
+        const unusedBytes = Math.max(0, totalBytes - usedBytes);
+        entries.push({
+            url: script.url || '(inline)',
+            totalBytes,
+            unusedBytes,
+            unusedPercentage: totalBytes > 0
+                ? Math.round((unusedBytes / totalBytes) * 100)
+                : 0,
+        });
+    }
+    // ---- CSS stylesheets ----
+    for (const sheet of coverage.css ?? []) {
+        const ranges = sheet.ranges ?? [];
+        if (ranges.length === 0)
+            continue;
+        const merged = mergeRanges(ranges);
+        const totalBytes = merged[merged.length - 1].endOffset;
+        const usedBytes = merged.reduce((sum, r) => sum + (r.endOffset - r.startOffset), 0);
+        const unusedBytes = Math.max(0, totalBytes - usedBytes);
+        entries.push({
+            url: sheet.url || '(inline)',
+            totalBytes,
+            unusedBytes,
+            unusedPercentage: totalBytes > 0
+                ? Math.round((unusedBytes / totalBytes) * 100)
+                : 0,
+        });
+    }
+    // Sort by unused bytes descending, take top 10
+    entries.sort((a, b) => b.unusedBytes - a.unusedBytes);
+    return { unusedBytesByUrl: entries.slice(0, 10) };
+}
+//# sourceMappingURL=summaries.js.map

package/dist/distill/summaries.js.map

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

package/dist/extract/critical-path.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Critical Path Length extractor.
+ *
+ * Computes metrics from the critical path chain derived in the Network IR:
+ * total chain length (duration sum), request counts, depth, and longest
+ * single request.
+ */
+import type { IRBundle } from '../normalize/types.js';
+import type { CriticalPath } from './types.js';
+/**
+ * Extract critical path metrics from an IRBundle.
+ *
+ * Returns undefined when the critical path info is empty or none of its
+ * tree URLs can be matched to a network request.
+ */
+export declare function extractCriticalPath(ir: IRBundle): CriticalPath | undefined;
+//# sourceMappingURL=critical-path.d.ts.map

package/dist/extract/critical-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"critical-path.d.ts","sourceRoot":"","sources":["../../src/extract/critical-path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAA2C,MAAM,uBAAuB,CAAC;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA2E/C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CA2B1E"}