| var iterate    = require('./lib/iterate.js') | 
|   , initState  = require('./lib/state.js') | 
|   , terminator = require('./lib/terminator.js') | 
|   ; | 
|   | 
| // Public API | 
| module.exports = serialOrdered; | 
| // sorting helpers | 
| module.exports.ascending  = ascending; | 
| module.exports.descending = descending; | 
|   | 
| /** | 
|  * Runs iterator over provided sorted array elements in series | 
|  * | 
|  * @param   {array|object} list - array or object (named list) to iterate over | 
|  * @param   {function} iterator - iterator to run | 
|  * @param   {function} sortMethod - custom sort function | 
|  * @param   {function} callback - invoked when all elements processed | 
|  * @returns {function} - jobs terminator | 
|  */ | 
| function serialOrdered(list, iterator, sortMethod, callback) | 
| { | 
|   var state = initState(list, sortMethod); | 
|   | 
|   iterate(list, iterator, state, function iteratorHandler(error, result) | 
|   { | 
|     if (error) | 
|     { | 
|       callback(error, result); | 
|       return; | 
|     } | 
|   | 
|     state.index++; | 
|   | 
|     // are we there yet? | 
|     if (state.index < (state['keyedList'] || list).length) | 
|     { | 
|       iterate(list, iterator, state, iteratorHandler); | 
|       return; | 
|     } | 
|   | 
|     // done here | 
|     callback(null, state.results); | 
|   }); | 
|   | 
|   return terminator.bind(state, callback); | 
| } | 
|   | 
| /* | 
|  * -- Sort methods | 
|  */ | 
|   | 
| /** | 
|  * sort helper to sort array elements in ascending order | 
|  * | 
|  * @param   {mixed} a - an item to compare | 
|  * @param   {mixed} b - an item to compare | 
|  * @returns {number} - comparison result | 
|  */ | 
| function ascending(a, b) | 
| { | 
|   return a < b ? -1 : a > b ? 1 : 0; | 
| } | 
|   | 
| /** | 
|  * sort helper to sort array elements in descending order | 
|  * | 
|  * @param   {mixed} a - an item to compare | 
|  * @param   {mixed} b - an item to compare | 
|  * @returns {number} - comparison result | 
|  */ | 
| function descending(a, b) | 
| { | 
|   return -1 * ascending(a, b); | 
| } |