Make DownloadBuilder a low level tool by exporting its main classes

Author: rxaviers

README.md

@@ -82,7 +82,7 @@ $ npm link download.jqueryui.com
 
 Temporarily change its `grunt.js` to use localhost instead of http://download.jqueryui.com.
 ```diff
-                var downloadBuilder = require( "download.jqueryui.com" )({
+                var frontend = require( "download.jqueryui.com" ).frontend({
 -                               host: "http://download.jqueryui.com"
 +                               host: "http://localhost:8088",
                                 env: "production"

frontend.js

@@ -9,8 +9,23 @@ var _ = require( "underscore" ),
 var errorTemplate = Handlebars.compile( fs.readFileSync( __dirname + "/template/500.html", "utf-8" ) ),
 	rootTemplate = Handlebars.compile( fs.readFileSync( __dirname + "/template/root.html", "utf-8" ) );
 
+/**
+ * Frontend( options )
+ * - options [ Object ]: key-value pairs detailed below.
+ *
+ * options
+ * - config [ Object ]: optional, if present used instead of the `config.json` file;
+ * - env [ String ]: optional, specify whether in development or production environment. Default: "development".
+ * - host [ String ]: optional, specify the host where download.jqueryui.com server is running. Default: "" (empty string).
+ *
+ */
 var Frontend = function( options ) {
 	options = _.extend( {}, Frontend.defaults, options );
+	if ( options.config && typeof options.config === "object" ) {
+		require( "./lib/config" ).get = function() {
+			return options.config;
+		};
+	}
 	this.download = new Download( options );
 	this.themeroller = new ThemeRoller( options );
 };

lib/config.js

@@ -32,9 +32,6 @@ Config = module.exports = function() {
 		jqueryUi.push( config.jqueryUi.legacy );
 	}
 	config.jqueryUi = jqueryUi.map(function( entry ) {
-		if ( entry.path && !entry.version ) {
-			entry.version = "skip";
-		}
 		if ( typeof entry !== "object" || !entry.version ) {
 			throw new Error( "Invalid jqueryUi entry " + JSON.stringify( entry ) + " in config.json" );
 		}

main.js

@@ -1,96 +1,41 @@
-var Main,
-	_ = require( "underscore" ),
-	Config = require( "./lib/config" );
+module.exports = {
+	/**
+	 * The Builder class.
+	 */
+	Builder: require( "./lib/builder" ),
 
-/**
- * Main( options ) -- or require( "download.jqueryui.com" )( options )
- * - options [ Object ]: key-value pairs detailed below.
- *
- * options
- * - config [ Object ]: optional, if present used instead of the `config.json` file;
- * - env [ String ]: optional, specify whether in development or production environment. Default: "development".
- * - host [ String ]: optional, specify the host where download.jqueryui.com server is running. Default: "" (empty string).
- *
- * attributes
- * - frontend [ Object ]: for more details see `frontend.js`.
- *
- */
-module.exports = function( options ) {
-	return new Main( options );
-};
+	/**
+	 * The JqueryUi class.
+	 */
+	JqueryUi: require( "./lib/jquery-ui" ),
 
-Main = function( options ) {
-	options = _.extend( {}, Main.defaults, options );
-	if ( options.config && typeof options.config === "object" ) {
-		Config.get = function() {
-			return options.config;
-		};
-	}
-	this.frontend = new ( require( "./frontend" ) )( options );
-};
+	/**
+	 * The JqueryUi class.
+	 */
+	Packer: require( "./lib/packer" ),
 
-Main.defaults = {
-	// Empty, check frontend.js's.
-};
+	/**
+	 * The Util object.
+	 */
+	util: require( "./lib/util" ),
 
-Main.prototype = {
+  /**
+	 * frontend( options )
+	 * - options [ Object ]: see `frontend.js` for more details.
+	 *
+	 * Returns a frontend instance.
+	 */
+	frontend: function( options ) {
+		return new ( require( "./frontend" ) )( options );
+	},
 
 	/**
-	 * Main#buildThemesBundle( callback )
-	 * - callback( err, bundleFiles ): bundleFiles is an Array of { path:<path>, data:<data> }'s.
+	 * themeGallery( jqueryUi )
+	 * - jqueryUi [ instanceof JqueryUi ]: see `frontend.js` for more details.
 	 *
-	 * Generates the theme bundle with base and all themes from themegallery.
+	 * Returns themeGallery using jqueryUi's version.
 	 */
-	buildThemesBundle: function( callback ) {
-		var allComponents, jqueryUi, success,
-			async = require( "async" ),
-			Builder = require( "./lib/builder" ),
-			Packer = require( "./lib/packer" ),
-			bundleFiles = [],
-			JqueryUi = require( "./lib/jquery-ui" ),
-			themeGallery = require( "./lib/themeroller.themegallery" )();
-
-		jqueryUi = JqueryUi.getStable();
-		allComponents = jqueryUi.components().map(function( component ) {
-			return component.name;
-		});
-
-		async.mapSeries( themeGallery, function( theme, callback ) {
-			var build = new Builder( jqueryUi, allComponents ),
-				packer = new Packer( build, theme, { skipDocs: true } ),
-				folderName = theme.folderName();
-			packer.pack(function( err, files ) {
-				if ( err ) {
-					return callback( err );
-				}
-				// Add theme files.
-				files
-					// Pick only theme files we need on the bundle.
-					.filter(function( file ) {
-						var themeCssOnlyRe = new RegExp( "development-bundle/themes/" + folderName + "/jquery.ui.theme.css" ),
-							themeDirRe = new RegExp( "css/" + folderName );
-						if ( themeCssOnlyRe.test( file.path ) || themeDirRe.test( file.path ) ) {
-							return true;
-						}
-						return false;
-					})
-					// Convert paths the way bundle needs and add it into bundleFiles.
-					.forEach(function( file ) {
-						// 1: Remove initial package name eg. "jquery-ui-1.10.0.custom".
-						// 2: Make jquery-ui-1.10.0.custom.css into jquery-ui.css, or jquery-ui-1.10.0.custom.min.css into jquery-ui.min.css
-						file.path = file.path
-							.split( "/" ).slice( 1 ).join( "/" ) /* 1 */
-							.replace( /development-bundle\/themes/, "css" )
-							.replace( /css/, "themes" )
-							.replace( /jquery-ui-.*?(\.min)*\.css/, "jquery-ui$1.css" ); /* 2 */
-						bundleFiles.push( file );
-					});
-
-				callback( null, files );
-			});
-		}, function( err ) {
-			callback( err, bundleFiles );
-		});
+	themeGallery: function( jqueryUi ) {
+		return require( "./lib/themeroller.themegallery" )( jqueryUi );
 	}
 };
-