export type BundleMeasurements = Readonly<{ initialJsGzipBytes: number; lazyChunks: readonly Readonly<{ path: string; gzipBytes: number }>[]; }>; export type BundleThresholds = Readonly<{ initialJsGzipBytes: number; lazyChunkGzipBytes: number; }>; export function evaluateBundleBudget( measurements: BundleMeasurements, thresholds: BundleThresholds, ) { const initialPassed = measurements.initialJsGzipBytes <= thresholds.initialJsGzipBytes; const lazyResults = measurements.lazyChunks.map((chunk) => ({ ...chunk, threshold: thresholds.lazyChunkGzipBytes, passed: chunk.gzipBytes <= thresholds.lazyChunkGzipBytes, })); return Object.freeze({ initialPassed, lazyResults: Object.freeze(lazyResults), passed: initialPassed && lazyResults.every((chunk) => chunk.passed), }); } export type LabMetrics = Readonly<{ lcpMs: number; cls: number; namedInteractionMs: number; }>; export function evaluateLabBudget( report: Readonly<{ context?: Readonly>; metrics: LabMetrics; }>, thresholds: LabMetrics, ) { const requiredContext = [ "runner", "browser", "viewport", "network", "cpu", "cache", "build", ]; const missingContext = requiredContext.filter( (field) => report.context?.[field] === undefined, ); const results = { lcp: report.metrics.lcpMs <= thresholds.lcpMs, cls: report.metrics.cls <= thresholds.cls, namedInteraction: report.metrics.namedInteractionMs <= thresholds.namedInteractionMs, }; return Object.freeze({ missingContext: Object.freeze(missingContext), results: Object.freeze(results), passed: missingContext.length === 0 && Object.values(results).every(Boolean), }); } export function percentile75(values: readonly number[]): number | null { if (values.length === 0) return null; const sorted = [...values].sort((left, right) => left - right); return sorted[Math.ceil(sorted.length * 0.75) - 1]; } export type FieldMetrics = Readonly<{ p75LcpMs: number | null; p75Cls: number | null; p75InpMs: number | null; }>; export type FieldThresholds = Readonly<{ p75LcpMs: number; p75Cls: number; p75InpMs: number; minimumEligibleSamples: number | null; }>; export type FieldBudgetResult = Readonly<{ status: "PASS" | "FAIL_THRESHOLD" | "FAIL_UNVERIFIED"; passed: boolean; }>; export function evaluateFieldBudget( report: Readonly<{ metrics: FieldMetrics; eligibleSamples: number }>, thresholds: FieldThresholds, ): FieldBudgetResult { if ( thresholds.minimumEligibleSamples === null || report.eligibleSamples < thresholds.minimumEligibleSamples || Object.values(report.metrics).some((value) => value === null) ) { return Object.freeze({ status: "FAIL_UNVERIFIED", passed: false, }); } const metrics = report.metrics as Readonly<{ p75LcpMs: number; p75Cls: number; p75InpMs: number; }>; const passed = metrics.p75LcpMs <= thresholds.p75LcpMs && metrics.p75Cls <= thresholds.p75Cls && metrics.p75InpMs <= thresholds.p75InpMs; return Object.freeze({ status: passed ? "PASS" : "FAIL_THRESHOLD", passed, }); }