/**
 * jQuery.timers - Timer abstractions for jQuery
 * Written by Blair Mitchelmore (blair DOT mitchelmore AT gmail DOT com)
 * Licensed under the WTFPL (http://sam.zoy.org/wtfpl/).
 * Date: 2009/10/16
 *
 * @author Blair Mitchelmore
 * @version 1.2
 *
 **/

jQuery.fn.extend({
        everyTime: function(interval, label, fn, times) {
                return this.each(function() {
                        jQuery.timer.add(this, interval, label, fn, times);
                });
        },
        oneTime: function(interval, label, fn) {
                return this.each(function() {
                        jQuery.timer.add(this, interval, label, fn, 1);
                });
        },
        stopTime: function(label, fn) {
                return this.each(function() {
                        jQuery.timer.remove(this, label, fn);
                });
        }
});

jQuery.extend({
        timer: {
                global: [],
                guid: 1,
                dataKey: "jQuery.timer",
                regex: /^([0-9]+(?:\.[0-9]*)?)\s*(.*s)?$/,
                powers: {
                        // Yeah this is major overkill...
                        'ms': 1,
                        'cs': 10,
                        'ds': 100,
                        's': 1000,
                        'das': 10000,
                        'hs': 100000,
                        'ks': 1000000
                },
                timeParse: function(value) {
                        if (value == undefined || value == null)
                                return null;
                        var result = this.regex.exec(jQuery.trim(value.toString()));
                        if (result[2]) {
                                var num = parseFloat(result[1]);
                                var mult = this.powers[result[2]] || 1;
                                return num * mult;
                        } else {
                                return value;
                        }
                },
                add: function(element, interval, label, fn, times) {
                        var counter = 0;

                        if (jQuery.isFunction(label)) {
                                if (!times)
                                        times = fn;
                                fn = label;
                                label = interval;
                        }

                        interval = jQuery.timer.timeParse(interval);

                        if (typeof interval != 'number' || isNaN(interval) || interval < 0)
                                return;

                        if (typeof times != 'number' || isNaN(times) || times < 0)
                                times = 0;

                        times = times || 0;

                        var timers = jQuery.data(element, this.dataKey) || jQuery.data(element, this.dataKey, {});

                        if (!timers[label])
                                timers[label] = {};

                        fn.timerID = fn.timerID || this.guid++;

                        var handler = function() {
                                if ((++counter > times && times !== 0) || fn.call(element, counter) === false)
                                        jQuery.timer.remove(element, label, fn);
                        };

                        handler.timerID = fn.timerID;

                        if (!timers[label][fn.timerID])
                                timers[label][fn.timerID] = window.setInterval(handler,interval);

                        this.global.push( element );

                },
                remove: function(element, label, fn) {
                        var timers = jQuery.data(element, this.dataKey), ret;

                        if ( timers ) {

                                if (!label) {
                                        for ( label in timers )
                                                this.remove(element, label, fn);
                                } else if ( timers[label] ) {
                                        if ( fn ) {
                                                if ( fn.timerID ) {
                                                        window.clearInterval(timers[label][fn.timerID]);
                                                        delete timers[label][fn.timerID];
                                                }
                                        } else {
                                                for ( var fn in timers[label] ) {
                                                        window.clearInterval(timers[label][fn]);
                                                        delete timers[label][fn];
                                                }
                                        }

                                        for ( ret in timers[label] ) break;
                                        if ( !ret ) {
                                                ret = null;
                                                delete timers[label];
                                        }
                                }

                                for ( ret in timers ) break;
                                if ( !ret )
                                        jQuery.removeData(element, this.dataKey);
                        }
                }
        }
});

jQuery(window).bind("unload", function() {
        jQuery.each(jQuery.timer.global, function(index, item) {
                jQuery.timer.remove(item);
        });
}); 

