Added a combined option to the build process. Updated the readme.

Signed-off-by: Lanny McNie <[email protected]>

Author: Lanny McNie

build/Gruntfile.js

@@ -35,6 +35,17 @@ module.exports = function (grunt) {
 					}
 				},
 
+				concat: {
+					options: {
+						separator: ''
+					},
+					build: {
+						files: {
+							'output/<%= pkg.name.toLowerCase() %>-<%= version %>.combined.js': getCombinedSource()
+						}
+					}
+				},
+
 				// Build docs using yuidoc
 				yuidoc: {
 					compile: {
@@ -118,7 +129,44 @@ module.exports = function (grunt) {
 		return config[name];
 	}
 
+	function getCombinedSource() {
+		var configs = [
+			{cwd: '', config:'config.json', source:'source'}
+		];
+
+		return combineSource(configs);
+	}
+
+	function combineSource(configs) {
+		// Pull out all the source paths.
+		var sourcePaths = [];
+		for (var i=0;i<configs.length;i++) {
+			var o = configs[i];
+			var json = grunt.file.readJSON(path.resolve(o.cwd, o.config));
+			var sources = json[o.source];
+			sources.forEach(function(item, index, array) {
+				array[index] = path.resolve(o.cwd, item);
+			});
+			sourcePaths = sourcePaths.concat(sources);
+		}
+
+		// Remove duplicates (Like EventDispatcher)
+		var dups = {};
+		var clean = [];
+		for (i=0;i<sourcePaths.length;i++) {
+			var src = sourcePaths[i];
+			var cleanSrc = src.substr(src.lastIndexOf('src' + path.sep));
+			if  (dups[cleanSrc] == null) {
+				clean.push(src);
+				dups[cleanSrc] = true;
+			}
+		}
+
+		return clean;
+	}
+
 	// Load all the tasks we need
+	grunt.loadNpmTasks('grunt-contrib-concat');
 	grunt.loadNpmTasks('grunt-contrib-uglify');
 	grunt.loadNpmTasks('grunt-contrib-yuidoc');
 	grunt.loadNpmTasks('grunt-contrib-compress');
@@ -162,4 +210,12 @@ module.exports = function (grunt) {
 	grunt.registerTask('coreBuild', [
 		"updateversion", "uglify", "docs", "copy:src"
 	]);
+
+	/**
+	 * Task for exporting combined view.
+	 *
+	 */
+	grunt.registerTask('combine', 'Combine all source into a single, un-minified file.', [
+		"concat"
+	]);
 };

build/README.md

@@ -1,28 +1,25 @@
-## We use grunt (http://gruntjs.com/) to manage our build process.
-
-If you previously used an older process, you may want to clean up the node_modules and output folders.
+## SoundJS uses [Grunt](http://gruntjs.com/) to manage the build process.
 
 ## To use
 
 ### Install dependencies
 
 Node (0.10.x or greater is required):
 
-   # check the version
-   node -v
+	# check the version
+	node -v
 
-If your node is out of date, install the latest from:
-http://nodejs.org/
+If your node is out of date, install the latest from [NodeJS.org](http://nodejs.org/)
 
 After node is setup, install the other dependencies:
 
-   # Install the grunt command line utility
-   sudo npm install grunt-cli -g
+	# Install the grunt command line utility
+	sudo npm install grunt-cli -g
 
-   # Install all the dependencies for this project.
-   npm install
+	 # Install all the dependencies for this project.
+	npm install
 
-### Setup
+# Setup
 
 You'll need to change the default settings to suit your work environment.
 We have 2 config files:
@@ -37,7 +34,7 @@ Please adjust these settings to match your environment. All paths can either be
 ### Building
 To export a release build for this library run:
 
-   grunt build
+	grunt build
 
 This command will:
 
@@ -49,16 +46,23 @@ This command will:
 * Copy the built js file to ../lib
 * Copy All examples from ../examples to config.examples_out_path
 
-To build the NEXT version run:
+**NEXT version**
+
+The same process as above, but uses "NEXT" as the version. This is used to generate minified builds with the latest source between tags.
+
+	grunt next
+
+**Combined File**
 
-grunt next
+The same as the NEXT process, but will not minify the source code. All code formatting and comments are left intact.
 
-Does the exact same process as above but uses NEXT as the version.
+	grunt combine
 
 
 ### All commands
 
-grunt build -  Build everything based on the version in package.json
-grunt next - Build everything using the NEXT version.
-grunt docs - Build only the docs
-grunt uglify - Create the Easel and MovieClip min files. (Will use NEXT as the version)
+* grunt build -  Build everything based on the version in package.json
+* grunt next - Build everything using the NEXT version.
+* grunt combine - Build a NEXT version, but leave comments and formatting intact.
+* grunt docs - Build only the docs
+* grunt uglify - Create the SoundJS and FlashPlugin min files. (Will use NEXT as the version)