mig.js

/**
 * Mig JS
 * @description - Modular utility Javascript library. Made mostly for fun and personal projects but free to another to use and distribute as they see fit
 * @author Will Busby
 * @version 0.2
 */
;(function(win, doc, arr) {
    'use strict';

	/**
	 * Main selector function
	 * @param  {String} b String selector
	 * @param  {undefined} c Placeholder variable to use for the start of the b variable string.
	 * @param  {undefined} i Placeholder to use for selector length
	 * @param  {undefined} d Placeholder to use for selector incrementor
	 * @return {mixed}   Mixed return of either single Element, HTMLCollection, or NodeList
	 */
    function _lookup(b, c, i, d) {
        c = b[0];
        i = b.length;
        d = 0;
        while (i-- && c !== 'q') {
            switch(b[i]) {
                case '.':
                    d++;
                    break;
                case '#':
                    d++;
                    break;
                case ' ' :
                case ':' :
                case '*' :
                case '[' :
                case '>' :
                c = 'q';
                break;
            }
        }
		if (d > 1) {
			c = 'q';
		}

        switch(c) {
            case '#' :
            return [doc.getElementById(b.substr(1))];
            case '.' :
            return doc.getElementsByClassName(b.substr(1));
            default :
            return doc.querySelectorAll(b);
        }
    }

    /**
     * The main Mig function
     * @param {Mixed} selector either a CSS string selector or DOM element(s)
     * @param {undefined} els placeholder variable for the future DOM array
	 * @return {Object} Mig instance         Returns an instance of Mig with prototype functions and Array functions
     */
    function Mig(selector, els) {
        els = '' + selector === selector && _lookup(selector) || selector[0] && selector || [selector];
		return this.push.apply(this, els);
    }

    /**
     * The selector function exposed to the global scope. Takes the same selector param as above but returns a new instance of Mig
     */
    win.m = function(a) {
		// console.time('find');
		// var b = new Mig(a);
		// console.timeEnd('find');
        // return b;
		return new Mig(a);
    };

    //This is key, it adds all Array prototype functions and acts like an array instead of an object. You can still assign functions to the prototype like an object.
    Mig.prototype = Object.create([]);

    /**
     * The main extension function
     */
    Mig.prototype.extend = function(name, fn) {
		Object.defineProperty(Mig.prototype, name, {
			configurable: false,
			value: fn,
			writable: false
		});
    };

    /**
     * Create a static Object of Mig so static functions can be used without having to select an element. Useful when registering global events with Mig.on('event', callback); and then Mig.on.trigger('event');
     */
    win.Mig = Object.create(Mig.prototype);
}(window, document, []));