mdb-ui-kit/Gruntfile.js

module.exports = function (grunt) {
  'use strict';

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

  RegExp.quote = function (string) {
    return string.replace(/[-\\^$*+?.()|[\]{}]/g, '\\$&');
  };

  var referenceDocNotice =
    '$1\n\n'
    + '[//]: # DO NOT EDIT IT WILL BE OVERWRITTEN - copy of bootstrap documentation generated by grunt docs-copy-bootstrap-docs\n\n'
    + '{% callout info %}\n**Bootstrap Reference Documentation** \n'
    + 'This is reference documentation from <a href="http://getbootstrap.com">Bootstrap</a>. \n'
    + 'It is being rendered with Material Design for Bootstrap to demonstrate default styling. \n'
    + 'See addons(TODO: add link) for additional Material Design elements.\n'
    + '{% endcallout %}'
    + '\n\n$2'

  var fs = require('fs');
  var path = require('path');
  var glob = require('glob');
  var isTravis = require('is-travis');
  var npmShrinkwrap = require('npm-shrinkwrap');
  var mq4HoverShim = require('mq4-hover-shim');
  var autoprefixer = require('autoprefixer')({
    browsers: [
      //
      // Official browser support policy:
      // http://v4-alpha.getbootstrap.com/getting-started/browsers-devices/#supported-browsers
      //
      'Chrome >= 35', // Exact version number here is kinda arbitrary
      // Rather than using Autoprefixer's native "Firefox ESR" version specifier string,
      // we deliberately hardcode the number. This is to avoid unwittingly severely breaking the previous ESR in the event that:
      // (a) we happen to ship a new Bootstrap release soon after the release of a new ESR,
      //     such that folks haven't yet had a reasonable amount of time to upgrade; and
      // (b) the new ESR has unprefixed CSS properties/values whose absence would severely break webpages
      //     (e.g. `box-sizing`, as opposed to `background: linear-gradient(...)`).
      //     Since they've been unprefixed, Autoprefixer will stop prefixing them,
      //     thus causing them to not work in the previous ESR (where the prefixes were required).
      'Firefox >= 31', // Current Firefox Extended Support Release (ESR)
      // Note: Edge versions in Autoprefixer & Can I Use refer to the EdgeHTML rendering engine version,
      // NOT the Edge app version shown in Edge's "About" screen.
      // For example, at the time of writing, Edge 20 on an up-to-date system uses EdgeHTML 12.
      // See also https://github.com/Fyrd/caniuse/issues/1928
      'Edge >= 12',
      'Explorer >= 9',
      // Out of leniency, we prefix these 1 version further back than the official policy.
      'iOS >= 7',
      'Safari >= 7.1',
      // The following remain NOT officially supported, but we're lenient and include their prefixes to avoid severely breaking in them.
      'Android 2.3',
      'Android >= 4',
      'Opera >= 12'
    ]
  });

  var generateCommonJSModule = require('./grunt/bs-commonjs-generator.js');
  var configBridge = grunt.file.readJSON('./grunt/configBridge.json', {encoding: 'utf8'});

  Object.keys(configBridge.paths).forEach(function (key) {
    configBridge.paths[key].forEach(function (val, i, arr) {
      arr[i] = path.join('./docs/assets', val);
    });
  });

  // Project configuration.
  grunt.initConfig({

    // Metadata.
    pkg: grunt.file.readJSON('package.json'),
    banner: '/*!\n' +
    ' * Bootstrap Material Design v<%= pkg.version %> (<%= pkg.homepage %>)\n' +
    ' * Copyright 2014-<%= grunt.template.today("yyyy") %> <%= pkg.author %>\n' +
    ' * Licensed under MIT (https://github.com/FezVrasta/bootstrap-material-design/blob/master/LICENSE)\n' +
    ' */\n',
    jqueryCheck: 'if (typeof jQuery === \'undefined\') {\n' +
    '  throw new Error(\'Bootstrap Material Design\\\'s JavaScript requires jQuery\')\n' +
    '}\n',
    jqueryVersionCheck: '+function ($) {\n' +
    '  var version = $.fn.jquery.split(\' \')[0].split(\'.\')\n' +
    '  if ((version[0] < 2 && version[1] < 9) || (version[0] == 1 && version[1] == 9 && version[2] < 1) || (version[0] >= 3)) {\n' +
    '    throw new Error(\'Bootstrap Material Design\\\'s JavaScript requires at least jQuery v1.9.1 but less than v3.0.0\')\n' +
    '  }\n' +
    '}(jQuery);\n\n',

    // Task configuration.
    clean: {
      dist: 'dist',
      docs: 'docs/dist'
    },

    // JS build configuration
    lineremover: {
      es6Import: {
        files: {
          '<%= concat.bootstrap.dest %>': '<%= concat.bootstrap.dest %>'
        },
        options: {
          exclusionPattern: /^(import|export)/g
        }
      }
    },

    babel: {
      core: {
        options: {
          sourceMap: true,
          modules: 'ignore'
        },
        files: {
          'dist/js/babel/baseInput.js': 'js/src/baseInput.js',
          'dist/js/babel/baseToggle.js': 'js/src/baseToggle.js',
          'dist/js/babel/util.js': 'js/src/util.js',
          'dist/js/babel/ripples.js': 'js/src/ripples.js',
          'dist/js/babel/autofill.js': 'js/src/autofill.js',
          'dist/js/babel/text.js': 'js/src/text.js',
          'dist/js/babel/textarea.js': 'js/src/textarea.js',
          'dist/js/babel/select.js': 'js/src/select.js',
          'dist/js/babel/checkbox.js': 'js/src/checkbox.js',
          'dist/js/babel/checkboxInline.js': 'js/src/checkboxInline.js',
          'dist/js/babel/switch.js': 'js/src/switch.js',
          'dist/js/babel/radio.js': 'js/src/radio.js',
          'dist/js/babel/radioInline.js': 'js/src/radioInline.js',
          'dist/js/babel/fileInput.js': 'js/src/file.js',
          'dist/js/babel/bootstrapMaterialDesign.js': 'js/src/bootstrapMaterialDesign.js',
        }
      },
      docs: {
        options: {
          sourceMap: true,
          modules: 'ignore'
        },
        files: {
          'docs/assets/js/dist/style.js': 'docs/assets/js/src/style.js',
          'docs/assets/js/dist/application.js': 'docs/assets/js/src/application.js',

          // generate core so we have local debugging
          'docs/dist/js/babel/baseInput.js': 'js/src/baseInput.js',
          'docs/dist/js/babel/baseToggle.js': 'js/src/baseToggle.js',
          'docs/dist/js/babel/util.js': 'js/src/util.js',
          'docs/dist/js/babel/ripples.js': 'js/src/ripples.js',
          'docs/dist/js/babel/autofill.js': 'js/src/autofill.js',
          'docs/dist/js/babel/text.js': 'js/src/text.js',
          'docs/dist/js/babel/textarea.js': 'js/src/textarea.js',
          'docs/dist/js/babel/select.js': 'js/src/select.js',
          'docs/dist/js/babel/checkbox.js': 'js/src/checkbox.js',
          'docs/dist/js/babel/checkboxInline.js': 'js/src/checkboxInline.js',
          'docs/dist/js/babel/switch.js': 'js/src/switch.js',
          'docs/dist/js/babel/radio.js': 'js/src/radio.js',
          'docs/dist/js/babel/radioInline.js': 'js/src/radioInline.js',
          'docs/dist/js/babel/fileInput.js': 'js/src/file.js',
          'docs/dist/js/babel/bootstrapMaterialDesign.js': 'js/src/bootstrapMaterialDesign.js',
        }
      },
      dist: {
        options: {
          modules: 'ignore'
        },
        files: {
          '<%= concat.bootstrap.dest %>': '<%= concat.bootstrap.dest %>'
        }
      },
      umd: {
        options: {
          modules: 'umd'
        },
        files: {
          'dist/js/umd/baseInput.js': 'js/src/baseInput.js',
          'dist/js/umd/baseToggle.js': 'js/src/baseToggle.js',
          'dist/js/umd/util.js': 'js/src/util.js',
          'dist/js/umd/ripples.js': 'js/src/ripples.js',
          'dist/js/umd/autofill.js': 'js/src/autofill.js',
          'dist/js/umd/text.js': 'js/src/text.js',
          'dist/js/umd/textarea.js': 'js/src/textarea.js',
          'dist/js/umd/select.js': 'js/src/select.js',
          'dist/js/umd/checkbox.js': 'js/src/checkbox.js',
          'dist/js/umd/checkboxInline.js': 'js/src/checkboxInline.js',
          'dist/js/umd/switch.js': 'js/src/switch.js',
          'dist/js/umd/radio.js': 'js/src/radio.js',
          'dist/js/umd/radioInline.js': 'js/src/radioInline.js',
          'dist/js/umd/fileInput.js': 'js/src/file.js',
          'dist/js/umd/bootstrapMaterialDesign.js': 'js/src/bootstrapMaterialDesign.js',
        }
      }
    },

    eslint: {
      options: {
        configFile: 'js/.eslintrc'
      },
      target: ['js/src/*.js', 'docs/assets/js/src/*.js']
    },

    jscs: {
      options: {
        config: 'js/.jscsrc'
      },
      grunt: {
        src: ['Gruntfile.js', 'grunt/*.js']
      },
      core: {
        src: 'js/src/*.js'
      },
      test: {
        src: 'js/tests/unit/*.js'
      },
      assets: {
        options: {
          requireCamelCaseOrUpperCaseIdentifiers: null
        },
        src: ['docs/assets/js/src/*.js', 'docs/assets/js/*.js', '!docs/assets/js/*.min.js']
      }
    },

    stamp: {
      options: {
        banner: '<%= banner %>\n<%= jqueryCheck %>\n<%= jqueryVersionCheck %>\n+function ($) {\n',
        footer: '\n}(jQuery);'
      },
      bootstrap: {
        files: {
          src: '<%= concat.bootstrap.dest %>'
        }
      }
    },

    concat: {
      options: {
        stripBanners: false,
        sourceMap: true
      },
      bootstrap: {
        src: [
          'dist/js/babel/baseInput.js',
          'dist/js/babel/baseToggle.js',
          'dist/js/babel/util.js',
          'dist/js/babel/ripples.js',
          'dist/js/babel/autofill.js',
          'dist/js/babel/text.js',
          'dist/js/babel/textarea.js',
          'dist/js/babel/select.js',
          'dist/js/babel/checkbox.js',
          'dist/js/babel/checkboxInline.js',
          'dist/js/babel/switch.js',
          'dist/js/babel/radio.js',
          'dist/js/babel/radioInline.js',
          'dist/js/babel/file.js',
          'dist/js/babel/bootstrapMaterialDesign.js',
        ],
        dest: 'dist/js/<%= pkg.name %>.js'
      }
    },

    uglify: {
      options: {
        compress: {
          warnings: false
        },
        mangle: true,
        preserveComments: /^!|@preserve|@license|@cc_on/i
      },
      core: {
        src: '<%= concat.bootstrap.dest %>',
        dest: 'dist/js/<%= pkg.name %>.min.js'
      },
      docsJs: {
        src: configBridge.paths.docsJs,
        dest: 'docs/assets/js/docs.min.js'
      }
    },

    qunit: {
      options: {
        inject: 'js/tests/unit/phantom.js'
      },
      files: 'js/tests/index.html'
    },

    // CSS build configuration
    scsslint: {
      options: {
        bundleExec: true,
        config: 'scss/.scss-lint.yml',
        reporterOutput: null
      },
      src: ['scss/*.scss', '!scss/_normalize.scss']
    },

    postcss: {
      core: {
        options: {
          map: true,
          processors: [
            mq4HoverShim.postprocessorFor({hoverSelectorPrefix: '.bs-true-hover '}),
            autoprefixer
          ]
        },
        src: 'dist/css/*.css'
      },
      docs: {
        options: {
          processors: [
            autoprefixer
          ]
        },
        src: 'docs/assets/css/*.css'
      },
      examples: {
        options: {
          processors: [
            autoprefixer
          ]
        },
        expand: true,
        cwd: 'docs/examples/',
        src: ['**/*.css'],
        dest: 'docs/examples/'
      }
    },

    cssmin: {
      options: {
        // TODO: disable `zeroUnits` optimization once clean-css 3.2 is released
        //    and then simplify the fix for https://github.com/twbs/bootstrap/issues/14837 accordingly
        compatibility: 'ie9',
        keepSpecialComments: '*',
        sourceMap: true,
        noAdvanced: true
      },
      core: {
        files: [
          {
            expand: true,
            cwd: 'dist/css',
            src: ['*.css', '!*.min.css'],
            dest: 'dist/css',
            ext: '.min.css'
          }
        ]
      },
      docs: {
        src: 'docs/assets/css/docs.css',
        dest: 'docs/assets/css/docs.min.css'
      }
    },

    csscomb: {
      options: {
        config: 'scss/.csscomb.json'
      },
      dist: {
        expand: true,
        cwd: 'dist/css/',
        src: ['*.css', '!*.min.css'],
        dest: 'dist/css/'
      },
      examples: {
        expand: true,
        cwd: 'docs/examples/',
        src: '**/*.css',
        dest: 'docs/examples/'
      },
      docs: {
        src: 'docs/assets/css/src/docs.css',
        dest: 'docs/assets/css/src/docs.css'
      }
    },

    copy: {
      docs: {
        expand: true,
        cwd: 'dist/',
        src: [
          '**/*',
          '!js/babel',
          '!js/babel/**/*',
          '!js/umd',
          '!js/umd/**/*',
          '!js/npm.js'
        ],
        dest: 'docs/dist/'
      },
      'bs-docs-js-vendor': {
        expand: true,
        cwd: '../bootstrap/docs/assets/js/vendor',
        src: [
          '**/*'
        ],
        dest: 'docs/assets/js/vendor/'
      },

      'bs-docs-scss': {
        options: {
          // https://regex101.com/r/hG8lU4/1
          process: function (content, srcpath) {
            return content.replace(/([\s\S]+)/mg, "// DO NOT EDIT IT WILL BE OVERWRITTEN - copy of bootstrap documentation generated by grunt docs-copy-bootstrap-docs\n\n$1");
          }
        },
        expand: true,
        cwd: '../bootstrap/docs/assets/scss',
        src: [
          '**/*',
          '!docs.scss' // keep variable customizations
        ],
        dest: 'docs/assets/scss/'
      },
      'bs-docs-components': {
        options: {
          // //https://regex101.com/r/cZ7aO8/2
          process: function (content, srcpath) {
            return content.replace(/(---[\s\S]+?---)([\s\S]+)/mg, referenceDocNotice);
          }
        },
        expand: true,
        cwd: '../bootstrap/docs/components',
        src: [
          '**/*'
        ],
        dest: 'docs/components/'
      },
      'bs-docs-content': {
        options: {
          // //https://regex101.com/r/cZ7aO8/2
          process: function (content, srcpath) {
            return content
              // insert docs reference
              .replace(/(---[\s\S]+?---)([\s\S]+)/mg, referenceDocNotice)
              // remove sample text 'display' as this is a particular style and is confusing
              .replace(/Fancy display heading/, 'Fancy heading');
          }
        },
        expand: true,
        cwd: '../bootstrap/docs/content',
        src: [
          '**/*'
        ],
        dest: 'docs/content/'
      }
    },

    connect: {
      server: {
        options: {
          port: 3000,
          base: '.'
        }
      }
    },

    jekyll: {
      options: {
        bundleExec: true,
        config: '_config.yml',
        incremental: false
      },
      docs: {},
      github: {
        options: {
          raw: 'github: true'
        }
      }
    },

    htmllint: {
      options: {
        ignore: [
          'Element “img” is missing required attribute “src”.',
          'Attribute “autocomplete” is only allowed when the input type is “color”, “date”, “datetime”, “datetime-local”, “email”, “month”, “number”, “password”, “range”, “search”, “tel”, “text”, “time”, “url”, or “week”.',
          'Attribute “autocomplete” not allowed on element “button” at this point.',
          'Element “div” not allowed as child of element “progress” in this context. (Suppressing further errors from this subtree.)',
          'Consider using the “h1” element as a top-level heading only (all “h1” elements are treated as top-level headings by many screen readers and other tools).',
          'The “datetime” input type is not supported in all browsers. Please be sure to test, and consider using a polyfill.'
        ]
      },
      src: ['_gh_pages/**/*.html', 'js/tests/visual/*.html']
    },

    watch: {
      src: {
        files: '<%= jscs.core.src %>',
        tasks: ['babel:core', 'babel:docs']
      },

      docsjs: {
        files: ['docs/assets/js/src/*.js'],
        tasks: ['babel:docs']
      },

      // FIXME: restore this after getting fundamentals done, just trying to reduce churn while developing
      //sass: {
      //  files: 'scss/**/*.scss',
      //  tasks: ['dist-css', 'docs']
      //},
      docs: { // watch both the source and docs scss
        files: ['docs/assets/scss/**/*.scss', 'scss/**/*.scss'],
        tasks: ['scsslint', 'sass:docs'] //FIXME: docs-css yanks sourcemap from local docs.css, working around just doing the minimal compile here ['docs-css'] //['dist-css', 'docs']
      }
    },

    sed: {
      versionNumber: {
        pattern: (function () {
          var old = grunt.option('oldver');
          return old ? RegExp.quote(old) : old;
        })(),
        replacement: grunt.option('newver'),
        recursive: true
      }
    },

    'saucelabs-qunit': {
      all: {
        options: {
          build: process.env.TRAVIS_JOB_ID,
          concurrency: 10,
          maxRetries: 3,
          maxPollRetries: 4,
          urls: ['http://127.0.0.1:3000/js/tests/index.html?hidepassed'],
          browsers: grunt.file.readYAML('grunt/sauce_browsers.yml')
        }
      }
    },

    exec: {
      npmUpdate: {
        command: 'npm update'
      }
    },

    buildcontrol: {
      options: {
        dir: '_gh_pages',
        commit: true,
        push: true,
        message: 'Built %sourceName% from commit %sourceCommit% on branch %sourceBranch%'
      },
      pages: {
        options: {
          // FIXME: change this when we are ready!!!
          //remote: 'git@github.com:FezVrasta/bootstrap-material-design.git',
          remote: 'git@github.com:rosskevin/bootstrap-material-design.git',
          branch: 'gh-pages'
        }
      }
    },

    compress: {
      main: {
        options: {
          archive: 'bootstrap-material-design-<%= pkg.version %>-dist.zip',
          mode: 'zip',
          level: 9,
          pretty: true
        },
        files: [
          {
            expand: true,
            cwd: 'dist/',
            src: ['**'],
            dest: 'bootstrap-material-design-<%= pkg.version %>-dist'
          }
        ]
      }
    }

  });


  // These plugins provide necessary tasks.
  require('load-grunt-tasks')(grunt, {
    scope: 'devDependencies',
    // Exclude Sass compilers. We choose the one to load later on.
    pattern: ['grunt-*', '!grunt-sass', '!grunt-contrib-sass']
  });
  require('time-grunt')(grunt);

  // Docs HTML validation task
  grunt.registerTask('validate-html', ['jekyll:docs', 'htmllint']);

  var runSubset = function (subset) {
    return !process.env.MDB_TEST || process.env.MDB_TEST === subset;
  };
  var isUndefOrNonZero = function (val) {
    return val === undefined || val !== '0';
  };

  // Test task.
  var testSubtasks = [];
  // Skip core tests if running a different subset of the test suite
  if (runSubset('core') &&
      // Skip core tests if this is a Savage build
    process.env.TRAVIS_REPO_SLUG !== 'twbs-savage/bootstrap') {
    testSubtasks = testSubtasks.concat(['dist-css', 'dist-js', 'test-scss', 'test-js', 'docs']);
  }
  // Skip HTML validation if running a different subset of the test suite
  if (runSubset('validate-html') &&
    isTravis &&
      // Skip HTML5 validator when [skip validator] is in the commit message
    isUndefOrNonZero(process.env.MDB_DO_VALIDATOR)) {
    testSubtasks.push('validate-html');
  }
  // Only run Sauce Labs tests if there's a Sauce access key
  if (typeof process.env.SAUCE_ACCESS_KEY !== 'undefined' &&
      // Skip Sauce if running a different subset of the test suite
    runSubset('sauce-js-unit') &&
      // Skip Sauce on Travis when [skip sauce] is in the commit message
    isUndefOrNonZero(process.env.MDB_DO_SAUCE)) {
    testSubtasks.push('babel:core');
    testSubtasks.push('connect');
    testSubtasks.push('saucelabs-qunit');
  }
  grunt.registerTask('test', testSubtasks);
  grunt.registerTask('test-js', ['eslint', 'jscs:core', 'jscs:test', 'jscs:grunt', 'qunit']);

  // JS distribution task.
  grunt.registerTask('dist-js', ['eslint', 'babel:core', 'concat', 'lineremover', 'babel:dist', 'stamp', 'uglify:core', 'commonjs']);

  grunt.registerTask('test-scss', ['scsslint']);

  // CSS distribution task.
  // Supported Compilers: sass (Ruby) and libsass.
  (function (sassCompilerName) {
    require('./grunt/bs-sass-compile/' + sassCompilerName + '.js')(grunt);
  })(process.env.MDB_SASS || 'libsass');
  // grunt.registerTask('sass-compile', ['sass:core', 'sass:extras', 'sass:docs']);
  grunt.registerTask('sass-compile', ['sass:core', 'sass:docs']);

  grunt.registerTask('dist-css', ['sass-compile', 'postcss:core', 'csscomb:dist', 'cssmin:core', 'cssmin:docs']);

  // Full distribution task.
  grunt.registerTask('dist', ['clean:dist', 'dist-css', 'dist-js']);

  // Default task.
  grunt.registerTask('default', ['clean:dist', 'test']);

  // Version numbering task.
  // grunt change-version-number --oldver=A.B.C --newver=X.Y.Z
  // This can be overzealous, so its changes should always be manually reviewed!
  //grunt.registerTask('change-version-number', 'sed');

  grunt.registerTask('commonjs', ['babel:umd', 'npm-js']);

  grunt.registerTask('npm-js', 'Generate npm-js entrypoint module in dist dir.', function () {
    var srcFiles = Object.keys(grunt.config.get('babel.umd.files')).map(function (filename) {
      return './' + path.join('umd', path.basename(filename))
    })
    var destFilepath = 'dist/js/npm.js';
    generateCommonJSModule(grunt, srcFiles, destFilepath);
  });

  // Docs task.
  grunt.registerTask('docs-css', ['sass:docs', 'postcss:docs', 'postcss:examples', 'csscomb:docs', 'csscomb:examples', 'cssmin:docs']);
  grunt.registerTask('docs-js', ['babel:docs', 'uglify:docsJs']);
  grunt.registerTask('lint-docs-js', ['jscs:assets']);
  grunt.registerTask('docs-copy-bootstrap-docs', ['copy:bs-docs-js-vendor', 'copy:bs-docs-scss', 'copy:bs-docs-components', 'copy:bs-docs-content']);

  grunt.registerTask('docs', ['clean:docs', 'docs-copy-bootstrap-docs', 'docs-css', 'docs-js', 'lint-docs-js', 'copy:docs']);

  grunt.registerTask('prep-release', ['dist', 'docs', 'jekyll:github', 'htmlmin', 'compress']);

  // Publish to GitHub
  grunt.registerTask('publish', ['buildcontrol:pages']);

  // Task for updating the cached npm packages used by the Travis build (which are controlled by test-infra/npm-shrinkwrap.json).
  // This task should be run and the updated file should be committed whenever Bootstrap's dependencies change.
  grunt.registerTask('update-shrinkwrap', ['exec:npmUpdate', '_update-shrinkwrap']);
  grunt.registerTask('_update-shrinkwrap', function () {
    var done = this.async();
    npmShrinkwrap({dev: true, dirname: __dirname}, function (err) {
      if (err) {
        grunt.fail.warn(err);
      }
      var dest = 'grunt/npm-shrinkwrap.json';
      fs.renameSync('npm-shrinkwrap.json', dest);
      grunt.log.writeln('File ' + dest.cyan + ' updated.');
      done();
    });
  });
};