Allow npm package to be resolved via node module resolution

Created by: jsdf

Bootstrap currently publishes an npm package but as there is no index.js or main field in the package.json, even if it is installed via npm it can't be resolved by require.resolve().

This would be useful when using Bootstrap in projects with a node-based build system (grunt, gulp, etc). For example, something like:

var path = require('path')

// using require.resolve
var bootstrapPath = path.dirname(require.resolve('bootstrap'))
// alternatively, just using require, as index.js exports __dirname
var bootstrapPath = require('bootstrap')

// compile some less with bootstrap in the import paths
require('less').render(someLessData, {paths: [bootstrapPath + '/less']} , function(err, data) {
...
})

grunt/bs-commonjs-generator.js

@@ -2,17 +2,16 @@
 var fs = require('fs');
 var path = require('path');
 
-var destDir = 'dist/js';
-var destFilename = 'npm.js';
-var destFilepath = path.join(destDir, destFilename);
+module.exports = function generateCommonJSModule(grunt, srcFiles, destFilepath) {
+  var destDir = path.dirname(destFilepath);
 
-function srcPathToDestRequire(srcFilepath) {
-  var requirePath = path.relative(destDir, srcFilepath);
-  return "require('"+requirePath+"')";
-}
+  function srcPathToDestRequire(srcFilepath) {
+    var requirePath = path.relative(destDir, srcFilepath);
+    return "require('"+requirePath+"')";
+  }
 
-module.exports = function generateCommonJSModule(grunt, files) {
-  var moduleOutputJs = files.map(srcPathToDestRequire).join('\n');
+  var moduleOutputJs = srcFiles.map(srcPathToDestRequire).join('\n');
+  
   try {
     fs.writeFileSync(destFilepath, moduleOutputJs);
   }

Gruntfile.js

@@ -438,7 +438,7 @@ module.exports = function (grunt) {
   grunt.registerTask('test', testSubtasks);
 
   // JS distribution task.
-  grunt.registerTask('dist-js', ['concat', 'uglify:core']);
+  grunt.registerTask('dist-js', ['concat', 'uglify:core', 'commonjs']);
 
   // CSS distribution task.
   grunt.registerTask('less-compile', ['less:compileCore', 'less:compileTheme']);
@@ -464,8 +464,9 @@ module.exports = function (grunt) {
   });
 
   grunt.registerTask('commonjs', 'Generate CommonJS entrypoint module in dist dir.', function () {
-    var files = grunt.config.get('concat.bootstrap.src');
-    generateCommonJSModule(grunt, files);
+    var srcFiles = grunt.config.get('concat.bootstrap.src');
+    var destFilepath = 'dist/js/npm.js';
+    generateCommonJSModule(grunt, srcFiles, destFilepath);
   });
 
   // Docs task.