Gruntfile.js

module.exports = function (grunt) {

    // Force use of Unix newlines
    grunt.util.linefeed = '\n';

    var pkg = grunt.file.readJSON('package.json');

    var optionAnchor = function (option) {
        return option.toLowerCase().replace(/[^a-z0-9]/, '-');
    };

    var parseLink = function (link) {
        if (link) {
            var anchor, title, prefix = '',
                internal = link.match(/({@link (\$\.fn\.ajaxSelectPicker\.(?:defaults|locale)|AjaxBootstrapSelect(?:List|Request)?)#?([^\s]*)\s?([^}]*)})/);
            if (internal) {
                title = internal[4] ? internal[4] : internal[3];
                if (internal[2] === '$.fn.ajaxSelectPicker.defaults') {
                    anchor = 'options';
                    if (internal[3]) {
                        anchor = optionAnchor(internal[3]);
                        prefix = 'options';
                    }
                }
                else if (internal[2] === '$.fn.ajaxSelectPicker.locale') {
                    anchor = 'locale-strings';
                    if (internal[3]) {
                        anchor = optionAnchor(internal[3]);
                        prefix = 'locale';
                    }
                }
                else {
                    anchor = optionAnchor(internal[2]);
                }
                return link.replace(internal[0], '[' + (prefix ? prefix + '.' : '') + title + '](#' + prefix + anchor + ')');
            }
        }
        return link;
    };

    var multiLineParser = function (type, i, line, block) {
        // find the next instance of a parser (if there is one based on the @ symbol)
        // in order to isolate the current multi-line parser
        var nextParserIndex = block.indexOf('* @', i + 1),
            length = nextParserIndex > -1 ? nextParserIndex - i : block.length,
            newBlock = block.split('').splice(i - 1, length).join('');

        newBlock = (function (newBlock) {
            var ret = [];
            var lines = newBlock.split('\n');
            lines.forEach(function (line) {
                var pattern = '* ';
                var index = line.indexOf(pattern);
                if (index !== -1 && index <= (type.length + 4)) {
                    line = line.split('')
                        .splice((index + pattern.length), line.length)
                        .join('');
                }
                line = line.replace(new RegExp('^\\s+?@' + type + '\\s+'), '')
                    .replace(/\\s+$/, '');
                if (line.match(new RegExp('.*@' + type + '\\s*$'))) {
                    return;
                }
                if (line) {
                    ret.push(parseLink(line));
                }
            });
            return ret.join('\n> ');
        })(newBlock);
        return newBlock;
    };

    var parsers = {
        cfg: function (i, line, block) {
            var matches = line.match(/(?:\{([^}]+)\})?\s?([a-zA-Z0-9_]+)(?:\s?=\s?(.*))?\s?(\(required\))?/);
            var deprecated = block.match(/@deprecated (.*)/) || [];
            var member = block.match(/@member (.*)/) || [];
            var prefix = '';
            if (member && member[1]) {
                if (member[1] === '$.fn.ajaxSelectPicker.defaults') {
                    prefix = 'options.';
                }
                else if (member[1] === '$.fn.ajaxSelectPicker.locale') {
                    prefix = 'locale.';
                }
            }
            return {
                type: matches[1],
                name: prefix + matches[2],
                'default': matches[3],
                required: matches[4],
                dataAttribute: prefix === 'options.' && (!matches[1] || !/function/.test(matches[1].toLowerCase())) ? matches[2].replace(/([A-Z])/g, '-$1').toLowerCase() : null,
                dataAttributeMultiple: matches[1] && /object/.test(matches[1].toLowerCase()),
                deprecated: parseLink(deprecated[1])
            };
        },
        markdown: function (i, line, block) {
            return multiLineParser('markdown', i, line, block);
        }
    };

    // Project configuration.
    grunt.initConfig({
        // Grunt 1.0+ no longer has _. utility functions. Since there are other
        // node modules that are using lodash, just use that.
        _: require('lodash'),

        banner: '/*!\n' +
            ' * <%= pkg.title || pkg.name %>\n *\n' +
            ' * <%= pkg.description %>\n *\n' +
            ' * @version <%= pkg.version %>\n' +
            ' * @author <%= pkg.author.name %> - <%= pkg.author.url %>\n' +
            '<%= pkg.homepage ? " * @link " + pkg.homepage + "\\n" : "" %>' +
            ' * @copyright <%= grunt.template.today("yyyy") %> <%= pkg.author.name %>\n' +
            ' * @license Released under the <%= _.map(pkg.licenses, "type").join(", ") %> license.\n *\n' +
            ' * Contributors:' +
            '<% _.forEach(pkg.contributors, function(contributor) {%>\n *   <%= contributor.name %> - <%= contributor.url %><% }); %>\n *\n' +
            ' * Last build: <%= grunt.template.today("yyyy-mm-dd h:MM:ss TT Z") %>\n' +
            ' */\n',
        pkg: pkg,
        clean: {
            locale: ['dist/js/locale/*'],
            plugin: [
                'api-doc',
                'dist/js/<%= pkg.name %>.js',
                'dist/js/<%= pkg.name %>.min.js'
            ],
            styles: ['dist/css/']
        },
        dss: {
            docs: {
                files: {
                    docs: [
                        'src/js/ajaxSelectPicker.defaults.js',
                        'src/js/ajaxSelectPicker.locale/en-US.js'
                    ]
                },
                options: {
                    template: 'templates/',
                    template_index: 'jsdoc2md.handlebars',
                    output_index: '/options.md',
                    parsers: parsers,
                    handlebars_helpers: {
                        section: function (filename) {
                            if (filename === 'src/js/ajaxSelectPicker.defaults.js') {
                                return '## Options\n\nOptions can be passed via data attributes or through the JavaScript options object. For data attributes, append the option name to the `data-abs-` prefix. Options names (and any nested options) are always lower case and separated by `-`, such as in `data-abs-ajax-url="..."` or `data-abs-locale-search-placeholder="..."`.';
                            }
                            else if (filename === 'src/js/ajaxSelectPicker.locale/en-US.js') {
                                return '## Locale Strings\n\nSee: [options.locale](#optionslocale)';
                            }
                        }
                    }
                }
            }
        },
        concat: {
            plugin: {
                options: {
                    banner: '<%= banner %>' + '!(function ($, window) {\n\n',
                    footer: '\n})(jQuery, window);\n'
                },
                src: [
                    'src/js/classes/**/*.js',
                    'src/js/ajaxSelectPicker.js',
                    'src/js/ajaxSelectPicker.defaults.js',
                    'src/js/ajaxSelectPicker.locale/en-US.js'
                ],
                dest: 'dist/js/<%= pkg.name %>.js'
            }
        },
        copy: {
            locale: {
                files: [
                    {
                        expand: true,
                        cwd: 'src/js/ajaxSelectPicker.locale/',
                        src: [
                            '**/*.js'
                        ],
                        dest: 'dist/js/locale/',
                        rename: function (dest, src) {
                            return dest + src.replace(/(.*)\.js$/, pkg.name + '.$1.js');
                        }
                    }
                ],
                options: {
                    process: function (content, srcpath) {
                        return grunt.template.process('<%= banner %>') + '!(function ($) {\n' + content + '})(jQuery);\n';
                    }
                }
            }
        },
        eslint: {
            locale: [
                'src/js/ajaxSelectPicker.locale/**/*.js'
            ],
            plugin: [
                'Gruntfile.js',
                'src/js/classes/**/*.js',
                'src/js/ajaxSelectPicker.js',
                'src/js/ajaxSelectPicker.defaults.js',
                'src/js/ajaxSelectPicker.locale/en-US.js'
            ]
        },
        jsduck: {
            api: {
                src: [
                    'src/js/classes/**/*.js',
                    'src/js/ajaxSelectPicker.js',
                    'src/js/ajaxSelectPicker.defaults.js',
                    'src/js/ajaxSelectPicker.locale/en-US.js'
                ],
                dest: 'api-docs',
                options: {
                    categories: 'jsduck.categories.json',
                    external: ['jQuery', '$', 'jqXHR', 'Selectpicker'],
                    noSource: true,
                    warnings: ['-tag(default,description,example,name,optional,required,see)']
                }
            }
        },
        less: {
            options: {
                banner: '<%= banner %>'
            },
            plugin: {
                src: 'src/less/**/*.less',
                dest: 'dist/css/<%= pkg.name %>.css'
            }
        },
        uglify: {
            options: {
                preserveComments: function (node, comment) {
                    return /^!|@preserve|@license|@cc_on/i.test(comment.value);
                }
            },
            locale: {
                files: [
                    {
                        expand: true,
                        cwd: 'src/js/ajaxSelectPicker.locale/',
                        src: ['**/*.js'],
                        dest: 'dist/js/locale/',
                        ext: '.min.js',
                        rename: function (dest, src) {
                            return dest + src.replace(/(.*)\.min\.js$/, pkg.name + '.$1.min.js');
                        }
                    }
                ],
                options: {
                    banner: '<%= banner %>' + '!(function ($) {\n',
                    footer: '})(jQuery);\n'
                }
            },
            plugin: {
                src: 'dist/js/<%= pkg.name %>.js',
                dest: 'dist/js/<%= pkg.name %>.min.js'
            }
        },
        cssmin: {
            options: {
                keepSpecialComments: '*'
            },
            target: {
                files: {
                    'dist/css/ajax-bootstrap-select.min.css': ['dist/css/ajax-bootstrap-select.css']
                }
            }
        },
        watch: {
            docs: {
                files: [
                    '.verbrc.md',
                    'docs/**/*.md',
                    'docs/**/*.handlebars',
                    'src/js/ajaxSelectPicker.defaults.js',
                    'src/js/ajaxSelectPicker.locale/en-US.js'
                ],
                tasks: ['docs']
            },
            locale: {
                files: '<%= eslint.locale %>',
                tasks: ['locale']
            },
            styles: {
                files: '<%= less.plugin.src %>',
                tasks: ['styles']
            },
            plugin: {
                files: '<%= eslint.plugin %>',
                tasks: ['plugin']
            }
        },
        update_json: {
            options: {
                src: 'package.json',
                indent: '    '
            },
            bower: {
                src: 'package.json',
                dest: 'bower.json',
                fields: {
                    name: null,
                    version: null,
                    description: null,
                    repository: null
                }
            }
        },
        verb: {
            readme: {
                options: {
                    // For some reason, verb/plasma cannot find package.json.
                    config: pkg
                },
                files: [
                    {
                        src: ['.verbrc.md'],
                        dest: 'README.md'
                    },
                    {
                        expand: true,
                        cwd: 'docs',
                        src: ['**/*.tmpl.md'],
                        dest: '.',
                        ext: '.md'
                    }
                ]
            }
        }
    });

    // Load the grunt plugins.
    grunt.loadNpmTasks('grunt-contrib-clean');
    grunt.loadNpmTasks('grunt-contrib-concat');
    grunt.loadNpmTasks('grunt-contrib-copy');
    grunt.loadNpmTasks('grunt-contrib-less');
    grunt.loadNpmTasks('grunt-contrib-uglify');
    grunt.loadNpmTasks('grunt-contrib-watch');
    grunt.loadNpmTasks('grunt-contrib-cssmin');
    grunt.loadNpmTasks('grunt-dss');
    grunt.loadNpmTasks('grunt-eslint');
    grunt.loadNpmTasks('grunt-jsduck');
    grunt.loadNpmTasks('grunt-verb');
    grunt.loadNpmTasks('grunt-update-json');

    // Default task(s).
    grunt.registerTask('docs', ['dss', 'verb']);
    grunt.registerTask('locale', ['eslint:locale', 'clean:locale', 'copy:locale', 'uglify:locale']);
    grunt.registerTask('plugin', ['eslint:plugin', 'clean:plugin', 'concat:plugin', 'uglify:plugin', 'jsduck']);
    grunt.registerTask('styles', ['clean:styles', 'less', 'cssmin']);
    grunt.registerTask('default', ['docs', 'locale', 'plugin', 'styles', 'update_json']);
    grunt.registerTask('travis', ['locale', 'eslint:plugin', 'clean:plugin', 'concat:plugin', 'uglify:plugin', 'styles']);

};