Create Modernizr.load() API

The Modernizr module needs a way to afford other modules the chance to load assets if they depend on a Modernizr test via hook_modernizr_info(). For example, a the Geolocation Field might want to load a JavaScript shim if native support is lacking:

// Imaginary Geolocation example
function geolocation_modernizr_load() {

  // For the following key, the first 'geolocation' is the Drupal module
  // used as a namespace. The second 'geolocation' is the Modernizr test.
  $load['geolocation_geolocation'] = array(
    'test' => 'Modernizr.geolocation',  // This is the Modernizr test
    'yep'  => '',                       // If the test passed, the browser has built-in support for what we need.
    'nope' => '/'. drupal_get_path('module', 'geolocation') . '/js/geolocation_shim.js', //Missing Geolocation; load polyfill
    'both' => '/'. drupal_get_path('module', 'geolocation') . '/js/geolocation_main.js', // Always load module functionality
    'callback' => '',                   // Execute stuff after each resource is downloaded. Takes an anonymous function.
    'complete' => '',                   // A final callback after all resources are fetched. Takes an anonymous function.
  );

  return $load;
}

// Another example for a theme
function mytheme_modernizr_load() {

  $load['mytheme_borderradius'] = array(
    'test' => 'Modernizr.borderradius',                                    // Modernizr test for border-radius
    'nope' => '/'. drupal_get_path('theme', 'mytheme') . '/js/css3pie.js', // Missing border-radius support; load polyfill
  );

  return $load;
}

Which would output something like:

Modernizr.load([{
  test: Modernizr.geolocation,
  nope: '/sites/all/modules/contrib/geolocation/js/geolocation_shim.js',
  both: '/sites/all/modules/contrib/geolocation/js/geolocation_main.js',
},{
  test: Modernizr.borderradius,
  nope: '/sites/all/themes/mytheme/js/css3pie.js',
}]);

Read yepnope.js documentation to find out more about each parameter. This example is based on yepnope 1.5. All parameters are optional.