'use strict';

// MODULES //

var factory = require( './factory.js' );


// SAMPLE //

var sample = factory();


// EXPORTS //

module.exports = sample;

@@ -76,24 +76,882 @@
  SAMPLE //%0A%0A
+/**%0A* Samples elements from an array-like object.%0A*%0A* @function sample%0A* @type %7BFunction%7D%0A* @param %7BArrayLike%7D x - array-like object to sample elements from%0A* @param %7BOptions%7D %5Boptions%5D - function options%0A* @param %7BNonNegativeInteger%7D %5Boptions.size%5D - sample size%0A* @param %7BProbabilityArray%7D %5Boptions.probs%5D - element probabilities%0A* @param %7Bboolean%7D %5Boptions.replace=true%5D - boolean indicating whether to sample with replacement%0A* @throws %7BTypeError%7D first argument must be array-like%0A* @throws %7BTypeError%7D options argument must be an object%0A* @throws %7BTypeError%7D must provide valid options%0A* @throws %7BRangeError%7D %60size%60 option must be smaller or equal to the length of %60x%60 when %60replace%60 is set to false%0A* @returns %7BArray%7D sample%0A*%0A* @example%0A* * var out = sample( %5B 3, null, NaN, 'abc', function()%7B%7D %5D );%0A* // e.g., returns %5B 3, 'abc', null, 3, null %5D%0A*/%0A
 var sample =

Add JSDoc comment