perfgraph 0.1.0

package/dist/extract/critical-path.js

@@ -0,0 +1,95 @@
+/**
+ * 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.
+ */
+/** Safely treat any non-finite number as 0. */
+function safe(v) {
+    return Number.isFinite(v) && v >= 0 ? v : 0;
+}
+/**
+ * Determine whether a request is considered "render-blocking".
+ *
+ * - Document & Stylesheet requests are always blocking.
+ * - Scripts at VeryHigh priority are considered blocking (render-blocking JS).
+ * - Everything else (images, fonts, XHR, fetch, etc.) is non-blocking.
+ */
+function isBlocking(req) {
+    if (req.failed)
+        return false;
+    if (req.resourceType === 'Document')
+        return true;
+    if (req.resourceType === 'Stylesheet')
+        return true;
+    if (req.resourceType === 'Script' && req.priority === 'VeryHigh')
+        return true;
+    return false;
+}
+/**
+ * Walk the critical path tree recursively and aggregate metrics.
+ */
+function walkTree(node, reqMap) {
+    let totalChainLength = 0;
+    let blockingCount = 0;
+    let nonBlockingCount = 0;
+    let longestSingleRequest = 0;
+    let requestCount = 0;
+    let anyMatched = false;
+    const req = reqMap.get(node.url);
+    if (req) {
+        anyMatched = true;
+        const dur = safe(req.duration);
+        totalChainLength += dur;
+        longestSingleRequest = Math.max(longestSingleRequest, dur);
+        requestCount++;
+        if (isBlocking(req)) {
+            blockingCount++;
+        }
+        else {
+            nonBlockingCount++;
+        }
+    }
+    for (const child of node.children ?? []) {
+        const childResult = walkTree(child, reqMap);
+        totalChainLength += childResult.totalChainLength;
+        blockingCount += childResult.blockingCount;
+        nonBlockingCount += childResult.nonBlockingCount;
+        longestSingleRequest = Math.max(longestSingleRequest, childResult.longestSingleRequest);
+        requestCount += childResult.requestCount;
+        anyMatched = anyMatched || childResult.anyMatched;
+    }
+    return { totalChainLength, blockingCount, nonBlockingCount, longestSingleRequest, requestCount, anyMatched };
+}
+/**
+ * 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 function extractCriticalPath(ir) {
+    const cpInfo = ir.network.summary.criticalPath;
+    if (!cpInfo || !cpInfo.tree || !cpInfo.tree.url) {
+        return undefined;
+    }
+    // Build a map for O(1) request lookups by URL
+    const reqMap = new Map();
+    for (const req of ir.network.requests) {
+        reqMap.set(req.url, req);
+    }
+    const result = walkTree(cpInfo.tree, reqMap);
+    if (!result.anyMatched) {
+        return undefined;
+    }
+    return {
+        totalChainLength: result.totalChainLength,
+        requestCount: result.requestCount,
+        blockingCount: result.blockingCount,
+        nonBlockingCount: result.nonBlockingCount,
+        deepestChainDepth: cpInfo.depth,
+        longestSingleRequest: result.longestSingleRequest,
+        urlsOnLongestPath: cpInfo.urlsOnLongestPath?.length ? cpInfo.urlsOnLongestPath : undefined,
+    };
+}
+//# sourceMappingURL=critical-path.js.map

package/dist/extract/critical-path.js.map

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

package/dist/extract/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Feature Extraction — entry point.
+ *
+ * extract() принимает IRBundle, запускает все extractor-функции и собирает
+ * FeatureSet. Каждая фича опциональна (graceful degradation при нехватке данных).
+ */
+import type { IRBundle } from '../normalize/types.js';
+import type { FeatureSet } from './types.js';
+/**
+ * Извлечь все диагностические сигналы из IRBundle.
+ *
+ * Чистая функция: одинаковый IRBundle → одинаковый FeatureSet.
+ * Возвращает FeatureSet со всеми опциональными полями.
+ */
+export declare function extract(ir: IRBundle): FeatureSet;
+//# sourceMappingURL=index.d.ts.map

package/dist/extract/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extract/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAS7C;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,GAAG,UAAU,CAWhD"}

package/dist/extract/index.js

@@ -0,0 +1,32 @@
+/**
+ * Feature Extraction — entry point.
+ *
+ * extract() принимает IRBundle, запускает все extractor-функции и собирает
+ * FeatureSet. Каждая фича опциональна (graceful degradation при нехватке данных).
+ */
+import { extractLCPBreakdown } from './lcp-breakdown.js';
+import { extractCriticalPath } from './critical-path.js';
+import { extractMainThreadBlocking } from './main-thread.js';
+import { extractJSHotspots } from './js-hotspots.js';
+import { extractLayoutShifts } from './layout-shifts.js';
+import { extractThirdPartyOverhead } from './third-party.js';
+import { extractRenderBlocking } from './render-blocking.js';
+/**
+ * Извлечь все диагностические сигналы из IRBundle.
+ *
+ * Чистая функция: одинаковый IRBundle → одинаковый FeatureSet.
+ * Возвращает FeatureSet со всеми опциональными полями.
+ */
+export function extract(ir) {
+    return {
+        url: ir.meta.url || undefined,
+        lcpBreakdown: extractLCPBreakdown(ir),
+        criticalPath: extractCriticalPath(ir),
+        mainThreadBlocking: extractMainThreadBlocking(ir),
+        jsHotspots: extractJSHotspots(ir),
+        layoutShifts: extractLayoutShifts(ir),
+        thirdPartyOverhead: extractThirdPartyOverhead(ir),
+        renderBlocking: extractRenderBlocking(ir),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/extract/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extract/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,EAAY;IAClC,OAAO;QACL,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,SAAS;QAC7B,YAAY,EAAE,mBAAmB,CAAC,EAAE,CAAC;QACrC,YAAY,EAAE,mBAAmB,CAAC,EAAE,CAAC;QACrC,kBAAkB,EAAE,yBAAyB,CAAC,EAAE,CAAC;QACjD,UAAU,EAAE,iBAAiB,CAAC,EAAE,CAAC;QACjC,YAAY,EAAE,mBAAmB,CAAC,EAAE,CAAC;QACrC,kBAAkB,EAAE,yBAAyB,CAAC,EAAE,CAAC;QACjD,cAAc,EAAE,qBAAqB,CAAC,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/extract/js-hotspots.d.ts

@@ -0,0 +1,15 @@
+/**
+ * JS Hotspots extractor.
+ *
+ * Identifies JS execution hotspots from runtime IR data:
+ * hydration cost, long tasks, and execution context count.
+ */
+import type { IRBundle } from '../normalize/types.js';
+import type { JSHotspots } from './types.js';
+/**
+ * Extract JS hotspot metrics from an IRBundle.
+ *
+ * Never returns undefined — defaults to zero when runtime data is absent.
+ */
+export declare function extractJSHotspots(ir: IRBundle): JSHotspots;
+//# sourceMappingURL=js-hotspots.d.ts.map

package/dist/extract/js-hotspots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-hotspots.d.ts","sourceRoot":"","sources":["../../src/extract/js-hotspots.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,UAAU,CAU1D"}

package/dist/extract/js-hotspots.js

@@ -0,0 +1,22 @@
+/**
+ * JS Hotspots extractor.
+ *
+ * Identifies JS execution hotspots from runtime IR data:
+ * hydration cost, long tasks, and execution context count.
+ */
+/**
+ * Extract JS hotspot metrics from an IRBundle.
+ *
+ * Never returns undefined — defaults to zero when runtime data is absent.
+ */
+export function extractJSHotspots(ir) {
+    const { runtime } = ir;
+    return {
+        bootupTime: runtime.hydrationCost?.bootupTime ?? 0,
+        evaluatedScripts: runtime.hydrationCost?.evaluatedScripts ?? 0,
+        longTaskCount: runtime.eventLoopStats?.longTasks ?? 0,
+        maxBlockingDuration: runtime.eventLoopStats?.maxBlockingDuration ?? 0,
+        contextCount: runtime.executionContexts.length,
+    };
+}
+//# sourceMappingURL=js-hotspots.js.map

package/dist/extract/js-hotspots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-hotspots.js","sourceRoot":"","sources":["../../src/extract/js-hotspots.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAY;IAC5C,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAEvB,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,aAAa,EAAE,UAAU,IAAI,CAAC;QAClD,gBAAgB,EAAE,OAAO,CAAC,aAAa,EAAE,gBAAgB,IAAI,CAAC;QAC9D,aAAa,EAAE,OAAO,CAAC,cAAc,EAAE,SAAS,IAAI,CAAC;QACrD,mBAAmB,EAAE,OAAO,CAAC,cAAc,EAAE,mBAAmB,IAAI,CAAC;QACrE,YAAY,EAAE,OAAO,CAAC,iBAAiB,CAAC,MAAM;KAC/C,CAAC;AACJ,CAAC"}

package/dist/extract/layout-shifts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Layout Shifts extractor.
+ *
+ * Computes layout instability metrics from DOM IR layout shift candidates
+ * and the CLS value from Core Web Vitals.
+ *
+ * clusterScore — композитная оценка 0-1, основанная на CLS и
+ * структурных признаках нестабильности layout (сложные поддеревья,
+ * глубокое вложение).
+ */
+import type { IRBundle } from '../normalize/types.js';
+import type { LayoutShifts } from './types.js';
+/**
+ * Extract layout shift metrics from an IRBundle.
+ *
+ * Never returns undefined — defaults to zero when DOM/Layout data is absent.
+ */
+export declare function extractLayoutShifts(ir: IRBundle): LayoutShifts;
+//# sourceMappingURL=layout-shifts.d.ts.map

package/dist/extract/layout-shifts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-shifts.d.ts","sourceRoot":"","sources":["../../src/extract/layout-shifts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,YAAY,CAiC9D"}

package/dist/extract/layout-shifts.js

@@ -0,0 +1,47 @@
+/**
+ * Layout Shifts extractor.
+ *
+ * Computes layout instability metrics from DOM IR layout shift candidates
+ * and the CLS value from Core Web Vitals.
+ *
+ * clusterScore — композитная оценка 0-1, основанная на CLS и
+ * структурных признаках нестабильности layout (сложные поддеревья,
+ * глубокое вложение).
+ */
+/** Categories that contribute to layout shift risk when over-represented. */
+const HIGH_RISK_TAGS = new Set(['img', 'video', 'iframe', 'canvas', 'svg']);
+/**
+ * Extract layout shift metrics from an IRBundle.
+ *
+ * Never returns undefined — defaults to zero when DOM/Layout data is absent.
+ */
+export function extractLayoutShifts(ir) {
+    const { layoutShiftCandidates } = ir.dom;
+    const cls = ir.performance.coreWebVitals.cls;
+    const highComplexitySubtreeCount = layoutShiftCandidates?.highComplexitySubtrees ?? 0;
+    const deepNesting = (layoutShiftCandidates?.deepNesting ?? 0) > 0;
+    // clusterScore: heuristic weighted score combining CLS and structural risk
+    const clsScore = cls !== undefined && Number.isFinite(cls) ? Math.min(1, cls * 50) : 0;
+    const complexityScore = Math.min(1, highComplexitySubtreeCount / 10);
+    const nestingScore = deepNesting ? 0.3 : 0;
+    // Tag risk: look at tag distribution — too many img/video/iframe in small DOM
+    let tagRisk = 0;
+    const tags = ir.dom.tagDistribution;
+    if (tags.length > 0) {
+        const totalTags = tags.reduce((sum, t) => sum + t.count, 0);
+        if (totalTags > 0) {
+            const highRiskCount = tags
+                .filter((t) => HIGH_RISK_TAGS.has(t.tag))
+                .reduce((sum, t) => sum + t.count, 0);
+            tagRisk = Math.min(1, highRiskCount / totalTags);
+        }
+    }
+    const clusterScore = Math.min(1, clsScore * 0.5 + complexityScore * 0.25 + nestingScore * 0.15 + tagRisk * 0.1);
+    return {
+        cls: cls !== undefined && Number.isFinite(cls) ? cls : undefined,
+        highComplexitySubtreeCount,
+        deepNesting,
+        clusterScore,
+    };
+}
+//# sourceMappingURL=layout-shifts.js.map

package/dist/extract/layout-shifts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-shifts.js","sourceRoot":"","sources":["../../src/extract/layout-shifts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,6EAA6E;AAC7E,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAY;IAC9C,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;IACzC,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,GAAG,CAAC;IAE7C,MAAM,0BAA0B,GAAG,qBAAqB,EAAE,sBAAsB,IAAI,CAAC,CAAC;IACtF,MAAM,WAAW,GAAG,CAAC,qBAAqB,EAAE,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAElE,2EAA2E;IAC3E,MAAM,QAAQ,GAAG,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,0BAA0B,GAAG,EAAE,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3C,8EAA8E;IAC9E,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5D,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,aAAa,GAAG,IAAI;iBACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;iBACxC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACxC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,GAAG,GAAG,eAAe,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,GAAG,OAAO,GAAG,GAAG,CAAC,CAAC;IAEhH,OAAO;QACL,GAAG,EAAE,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;QAChE,0BAA0B;QAC1B,WAAW;QACX,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/extract/lcp-breakdown.d.ts

@@ -0,0 +1,19 @@
+/**
+ * LCP (Largest Contentful Paint) Breakdown extractor.
+ *
+ * Splits LCP time into 4 subparts per Chrome spec:
+ *   TTFB → Resource Load Delay → Resource Load Time → Element Render Delay
+ */
+import type { IRBundle } from '../normalize/types.js';
+import type { LCPBreakdown } from './types.js';
+/**
+ * Extract LCP breakdown from an IRBundle.
+ *
+ * Uses a fallback chain for the total LCP value:
+ *   1. Trace LCP from coreWebVitals.lcp
+ *   2. Lighthouse LCP from lighthouse.lcpNumericValue
+ *
+ * Returns undefined if neither source has LCP data.
+ */
+export declare function extractLCPBreakdown(ir: IRBundle): LCPBreakdown | undefined;
+//# sourceMappingURL=lcp-breakdown.d.ts.map

package/dist/extract/lcp-breakdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lcp-breakdown.d.ts","sourceRoot":"","sources":["../../src/extract/lcp-breakdown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAqB,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoD/C;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAwD1E"}

package/dist/extract/lcp-breakdown.js

@@ -0,0 +1,110 @@
+/**
+ * LCP (Largest Contentful Paint) Breakdown extractor.
+ *
+ * Splits LCP time into 4 subparts per Chrome spec:
+ *   TTFB → Resource Load Delay → Resource Load Time → Element Render Delay
+ */
+/** Safely clamp a number to 0 if it's negative, NaN, or Infinity. */
+function clamp(value) {
+    return Number.isFinite(value) && value >= 0 ? value : 0;
+}
+/**
+ * Find the Document request (first page navigation) from the network log.
+ */
+function findDocumentRequest(requests) {
+    return requests.find((r) => r.resourceType === 'Document');
+}
+/**
+ * Find the most likely LCP resource among network requests.
+ * Chrome LCP is typically the largest image (by bytes) or a text node.
+ * Returns undefined for text-only LCP.
+ */
+function findLcpResource(requests) {
+    const images = requests.filter((r) => r.resourceType === 'Image' && !r.failed);
+    if (images.length === 0)
+        return undefined;
+    return images.reduce((a, b) => (a.bytes >= b.bytes ? a : b));
+}
+/**
+ * Extract TTFB from the network document request or fallback to Lighthouse.
+ *
+ * Primary: sum of DNS + Connect + SSL + Wait from the Document request's timing.
+ * Fallback: Lighthouse audit 'server-response-time' numericValue.
+ * Last resort: 0.
+ */
+function extractTTFB(ir) {
+    // Primary: Document request timing
+    const doc = findDocumentRequest(ir.network.requests);
+    if (doc?.timing) {
+        const { dns = 0, connect = 0, ssl = 0, wait = 0 } = doc.timing;
+        const ttfb = dns + connect + ssl + wait;
+        if (Number.isFinite(ttfb))
+            return Math.max(0, ttfb);
+    }
+    // Fallback: Lighthouse server-response-time audit
+    const lhAudit = ir.lighthouse.failedAudits.find((a) => a.id === 'server-response-time');
+    if (lhAudit?.numericValue !== undefined && Number.isFinite(lhAudit.numericValue)) {
+        return Math.max(0, lhAudit.numericValue);
+    }
+    return 0;
+}
+/**
+ * Extract LCP breakdown from an IRBundle.
+ *
+ * Uses a fallback chain for the total LCP value:
+ *   1. Trace LCP from coreWebVitals.lcp
+ *   2. Lighthouse LCP from lighthouse.lcpNumericValue
+ *
+ * Returns undefined if neither source has LCP data.
+ */
+export function extractLCPBreakdown(ir) {
+    // Fallback chain: trace → Lighthouse
+    const totalLCP = ir.performance.coreWebVitals.lcp ?? ir.lighthouse.lcpNumericValue;
+    if (totalLCP === undefined || !Number.isFinite(totalLCP)) {
+        return undefined;
+    }
+    // Determine source
+    const hasTrace = ir.performance.coreWebVitals.lcp !== undefined;
+    const hasLighthouse = ir.lighthouse.lcpNumericValue !== undefined;
+    const source = hasTrace && hasLighthouse ? 'mixed' :
+        hasLighthouse ? 'lighthouse' : 'trace';
+    const ttfb = extractTTFB(ir);
+    const lcpResource = findLcpResource(ir.network.requests);
+    // Build lcpElement if Lighthouse provides selector info
+    const lcpElement = ir.lighthouse.lcpElementSelector
+        ? {
+            selector: ir.lighthouse.lcpElementSelector,
+            snippet: ir.lighthouse.lcpElementSnippet,
+            nodeLabel: ir.lighthouse.lcpElementNodeLabel,
+        }
+        : undefined;
+    // Text-only LCP: no image resource to load
+    if (!lcpResource) {
+        return {
+            ttfb,
+            resourceLoadDelay: 0,
+            resourceLoadTime: 0,
+            elementRenderDelay: clamp(totalLCP - ttfb),
+            totalLCP,
+            lcpElementUrl: undefined,
+            lcpResourceType: undefined,
+            lcpElement,
+            source,
+        };
+    }
+    const resourceLoadDelay = clamp(lcpResource.startTime - ttfb);
+    const resourceLoadTime = clamp(lcpResource.duration);
+    const elementRenderDelay = clamp(totalLCP - ttfb - resourceLoadDelay - resourceLoadTime);
+    return {
+        ttfb,
+        resourceLoadDelay,
+        resourceLoadTime,
+        elementRenderDelay,
+        totalLCP,
+        lcpElementUrl: lcpResource.url,
+        lcpResourceType: lcpResource.resourceType,
+        lcpElement,
+        source,
+    };
+}
+//# sourceMappingURL=lcp-breakdown.js.map

package/dist/extract/lcp-breakdown.js.map

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

package/dist/extract/main-thread.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Main Thread Blocking Score extractor.
+ *
+ * Computes a blocking score from thread activity and main thread busyness.
+ * Combines trace-level thread activity (by category) with the global
+ * mainThreadBusyness ratio to produce a 0-1 blocking score.
+ */
+import type { IRBundle } from '../normalize/types.js';
+import type { MainThreadBlocking } from './types.js';
+/**
+ * Extract main thread blocking metrics from an IRBundle.
+ *
+ * Returns undefined when traceSummary data is missing (zero duration).
+ */
+export declare function extractMainThreadBlocking(ir: IRBundle): MainThreadBlocking | undefined;
+//# sourceMappingURL=main-thread.d.ts.map

package/dist/extract/main-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-thread.d.ts","sourceRoot":"","sources":["../../src/extract/main-thread.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAiCtF"}

package/dist/extract/main-thread.js

@@ -0,0 +1,41 @@
+/**
+ * Main Thread Blocking Score extractor.
+ *
+ * Computes a blocking score from thread activity and main thread busyness.
+ * Combines trace-level thread activity (by category) with the global
+ * mainThreadBusyness ratio to produce a 0-1 blocking score.
+ */
+/**
+ * Extract main thread blocking metrics from an IRBundle.
+ *
+ * Returns undefined when traceSummary data is missing (zero duration).
+ */
+export function extractMainThreadBlocking(ir) {
+    const { traceSummary } = ir.performance;
+    const totalDuration = traceSummary.totalDuration;
+    if (!totalDuration || totalDuration <= 0) {
+        return undefined;
+    }
+    const busyMs = traceSummary.threadActivity.totalMs;
+    // idleMs = totalDuration - busyMs can produce absurd values (e.g. 210M ms ≈ 58h)
+    // when totalDuration (trace event timestamps, wall-clock anchored) and busyMs
+    // (CDP Tracing durations, monotonic clock) come from different clock domains.
+    // Clamp idleMs to a sane maximum so clock-domain mismatch doesn't pollute the output.
+    const IDLE_MS_MAX = 120_000; // 2 minutes — reasonable upper bound for idle time
+    const idleMs = Math.min(IDLE_MS_MAX, Math.max(0, totalDuration - busyMs));
+    const blockingRatio = totalDuration > 0 ? Math.min(1, Math.max(0, busyMs / totalDuration)) : 0;
+    // blockingScore blends mainThreadBusyness with the raw busy ratio
+    // to smooth out edge cases where one source is more reliable
+    const busynessScore = ir.performance.mainThreadBusyness;
+    const blockingScore = Number.isFinite(busynessScore)
+        ? Math.min(1, Math.max(0, (busynessScore + blockingRatio) / 2))
+        : blockingRatio;
+    return {
+        blockingScore,
+        busyMs,
+        idleMs,
+        blockingRatio,
+        categories: { ...traceSummary.threadActivity.byCategory },
+    };
+}
+//# sourceMappingURL=main-thread.js.map

package/dist/extract/main-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-thread.js","sourceRoot":"","sources":["../../src/extract/main-thread.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,EAAY;IACpD,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC;IACxC,MAAM,aAAa,GAAG,YAAY,CAAC,aAAa,CAAC;IAEjD,IAAI,CAAC,aAAa,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,OAAO,CAAC;IAEnD,iFAAiF;IACjF,8EAA8E;IAC9E,8EAA8E;IAC9E,sFAAsF;IACtF,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,mDAAmD;IAChF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC;IAE1E,MAAM,aAAa,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/F,kEAAkE;IAClE,6DAA6D;IAC7D,MAAM,aAAa,GAAG,EAAE,CAAC,WAAW,CAAC,kBAAkB,CAAC;IACxD,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAClD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,aAAa,CAAC;IAElB,OAAO;QACL,aAAa;QACb,MAAM;QACN,MAAM;QACN,aAAa;QACb,UAAU,EAAE,EAAE,GAAG,YAAY,CAAC,cAAc,CAAC,UAAU,EAAE;KAC1D,CAAC;AACJ,CAAC"}

package/dist/extract/render-blocking.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Render-Blocking Score extractor.
+ *
+ * Identifies render-blocking resources (stylesheets, render-blocking scripts)
+ * and computes a weighted score combining count, bytes, and Lighthouse
+ * numeric value when available.
+ */
+import type { IRBundle } from '../normalize/types.js';
+import type { RenderBlockingScore } from './types.js';
+/**
+ * Extract render-blocking metrics from an IRBundle.
+ *
+ * Returns undefined when there are no network requests.
+ */
+export declare function extractRenderBlocking(ir: IRBundle): RenderBlockingScore | undefined;
+//# sourceMappingURL=render-blocking.d.ts.map

package/dist/extract/render-blocking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-blocking.d.ts","sourceRoot":"","sources":["../../src/extract/render-blocking.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAqB,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AA0BtD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,GAAG,mBAAmB,GAAG,SAAS,CAgDnF"}

package/dist/extract/render-blocking.js

@@ -0,0 +1,79 @@
+/**
+ * Render-Blocking Score extractor.
+ *
+ * Identifies render-blocking resources (stylesheets, render-blocking scripts)
+ * and computes a weighted score combining count, bytes, and Lighthouse
+ * numeric value when available.
+ */
+/** Tags considered render-blocking by default. */
+const BLOCKING_TYPES = new Set(['Stylesheet', 'Document']);
+/**
+ * Check whether a request is render-blocking.
+ *
+ * - Stylesheet and Document are always blocking.
+ * - Scripts at VeryHigh priority are considered blocking.
+ * - Font preloads and other early-critical resources could be added here.
+ */
+function isRenderBlocking(req) {
+    if (req.failed)
+        return false;
+    if (BLOCKING_TYPES.has(req.resourceType))
+        return true;
+    if (req.resourceType === 'Script' && req.priority === 'VeryHigh')
+        return true;
+    return false;
+}
+/**
+ * Clamp a number to non-negative, returning 0 for NaN/Infinity.
+ */
+function safe(v) {
+    return Number.isFinite(v) && v >= 0 ? v : 0;
+}
+/**
+ * Extract render-blocking metrics from an IRBundle.
+ *
+ * Returns undefined when there are no network requests.
+ */
+export function extractRenderBlocking(ir) {
+    const requests = ir.network.requests;
+    if (requests.length === 0)
+        return undefined;
+    let blockingRequestCount = 0;
+    let blockingBytes = 0;
+    let blockingDuration = 0;
+    for (const req of requests) {
+        if (isRenderBlocking(req)) {
+            blockingRequestCount++;
+            blockingBytes += safe(req.bytes);
+            blockingDuration += safe(req.duration);
+        }
+    }
+    // Lighthouse render-blocking-resources audit
+    const lhAudit = ir.lighthouse.failedAudits.find((a) => a.id === 'render-blocking-resources');
+    const lhRenderBlockingMs = lhAudit?.numericValue !== undefined && Number.isFinite(lhAudit.numericValue)
+        ? lhAudit.numericValue
+        : undefined;
+    // Score: 0 = lots of blocking, 1 = no blocking
+    // Blend count (up to 20 resources = max penalty) and Lighthouse value
+    const countScore = Math.max(0, 1 - blockingRequestCount / 20);
+    const lhScore = lhAudit !== undefined && lhAudit.score !== undefined && Number.isFinite(lhAudit.score)
+        ? lhAudit.score
+        : undefined;
+    const renderBlockingScore = lhScore !== undefined
+        ? (countScore + lhScore) / 2
+        : countScore;
+    // Use Lighthouse insight data for URL-level details
+    const lighthouseResources = ir.lighthouse.renderBlockingResources;
+    const totalWastedMs = lighthouseResources
+        ?.reduce((sum, r) => sum + (r.wastedMs ?? 0), 0);
+    return {
+        blockingRequestCount,
+        blockingBytes,
+        blockingDuration,
+        renderBlockingScore,
+        lhRenderBlockingMs,
+        resources: lighthouseResources,
+        totalWastedMs: lighthouseResources ? totalWastedMs : undefined,
+    };
+}
+//# sourceMappingURL=render-blocking.js.map

package/dist/extract/render-blocking.js.map

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

package/dist/extract/third-party.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Third-Party Overhead extractor.
+ *
+ * Identifies and categorises requests to third-party origins and computes
+ * aggregate metrics: count, bytes, duration, and ratio vs first-party.
+ */
+import type { IRBundle } from '../normalize/types.js';
+import type { ThirdPartyOverhead } from './types.js';
+/**
+ * Extract third-party overhead metrics from an IRBundle.
+ *
+ * Returns undefined when there are no network requests.
+ */
+export declare function extractThirdPartyOverhead(ir: IRBundle): ThirdPartyOverhead | undefined;
+//# sourceMappingURL=third-party.d.ts.map

package/dist/extract/third-party.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"third-party.d.ts","sourceRoot":"","sources":["../../src/extract/third-party.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAqB,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA8DrD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CA6DtF"}