Allow extensions to opt-in to using the web-vitals attribution build via the od_use_web_vitals_attribution_build filter

plugins/optimization-detective/detect.js

@@ -1,5 +1,6 @@
 /**
  * @typedef {import("web-vitals").LCPMetric} LCPMetric
+ * @typedef {import("web-vitals").LCPMetricWithAttribution} LCPMetricWithAttribution
  * @typedef {import("./types.ts").ElementData} ElementData
  * @typedef {import("./types.ts").OnTTFBFunction} OnTTFBFunction
  * @typedef {import("./types.ts").OnFCPFunction} OnFCPFunction
@@ -490,13 +491,17 @@ export default async function detect( {
 		} );
 	}
 
-	/** @type {LCPMetric[]} */
+	/** @type {(LCPMetric|LCPMetricWithAttribution)[]} */
 	const lcpMetricCandidates = [];
 
 	// Obtain at least one LCP candidate. More may be reported before the page finishes loading.
 	await new Promise( ( resolve ) => {
 		onLCP(
-			( /** @type LCPMetric */ metric ) => {
+			/**
+			 *
+			 * @param {LCPMetric|LCPMetricWithAttribution} metric
+			 */
+			( metric ) => {
 				lcpMetricCandidates.push( metric );
 				resolve();
 			},
@@ -511,6 +516,7 @@ export default async function detect( {
 
 	// Stop observing.
 	disconnectIntersectionObserver();
+
 	if ( isDebug ) {
 		log( 'Detection is stopping.' );
 	}

plugins/optimization-detective/detection.php

@@ -70,8 +70,22 @@
  * @param OD_URL_Metric_Group_Collection $group_collection URL Metric group collection.
  */
 function od_get_detection_script( string $slug, OD_URL_Metric_Group_Collection $group_collection ): string {
+	$use_attribution_build = WP_DEBUG || wp_is_development_mode( 'plugin' );
+
+	/**
+	 * Filters whether to use the web-vitals.js build with attribution.
+	 *
+	 * @since n.e.x.t
+	 *
+	 * @param bool $use_attribution_build Whether to use the attribution build.
+	 */
+	$use_attribution_build = (bool) apply_filters( 'od_use_web_vitals_attribution_build', $use_attribution_build );
+
 	$web_vitals_lib_data = require __DIR__ . '/build/web-vitals.asset.php';
-	$web_vitals_lib_src  = plugins_url( add_query_arg( 'ver', $web_vitals_lib_data['version'], 'build/web-vitals.js' ), __FILE__ );
+	$web_vitals_lib_src  = $use_attribution_build ?
+		plugins_url( 'build/web-vitals-attribution.js', __FILE__ ) :
+		plugins_url( 'build/web-vitals.js', __FILE__ );
+	$web_vitals_lib_src  = add_query_arg( 'ver', $web_vitals_lib_data['version'], $web_vitals_lib_src );
 
 	/**
 	 * Filters the list of extension script module URLs to import when performing detection.

webpack.config.js

@@ -190,6 +190,11 @@ const optimizationDetective = ( env ) => {
 						to: `${ destination }/build/web-vitals.js`,
 						info: { minimized: true },
 					},
+					{
+						from: `${ source }/dist/web-vitals.attribution.js`,
+						to: `${ destination }/build/web-vitals-attribution.js`,
+						info: { minimized: true },
+					},
 					{
 						from: `${ source }/package.json`,
 						to: `${ destination }/build/web-vitals.asset.php`,