DOM: Add deep argument to getItems

Previously the function only returned the topmost items in a folder, this
was different from how the function behaves when no argument is given,
where all items in the project is returned.

If no arg is given, it returns all items in the project.
If the folder is not found (when the argument is a string) an empty
arrayEx is returned.
If deep is not disabled, it returns all items in subfolders as well,
else it returns only the items in the folder.

Author: runegan

lib/dom.js

@@ -5,15 +5,57 @@ aeq.extend({
 	 * Gets all the item in a folder or project.
 	 * @method
 	 * @memberof aeq
-	 * @memberof aeq
 	 * @param  {FolderItem} [folder=app.project] The Folder to get items from.
-	 * @return {aeq.arrayEx}         Array of Item objects
+	 * @param  {boolean} [deep=true]             When `true`, gets items from
+	 *                                           subfolders as well.
+	 * @return {aeq.arrayEx}                     Array of Item objects
 	 */
-	getItems: function( folder ) {
-		folder = aeq.project.getFolder(folder) || app.project;
-		var items = aeq.normalizeCollection( folder.items );
+	getItems: function(folder, deep) {
+		// If no arguments are given, just return all items in project.
+		if (folder === undefined) {
+			return aeq.normalizeCollection(app.project.items);
+		}
+
+		deep = setDefault(deep, true);
+		folder = aeq.project.getFolder(folder);
+		if (folder === null) {
+			return aeq.arrayEx();
+		}
+
+		if (deep) {
+			return aeq.getItemsDeep(folder);
+		}
+
+		return aeq.normalizeCollection(folder.items);
+	},
 
-		return aeq.arrayEx( items );
+	/**
+	 * Returns an {@link aeq.arrayEx} with all items in a folder, and items in
+	 * subfolders.
+	 * @method
+	 * @param  {FolderItem} folder    The folder to flatten.
+	 * @return {aeq.arrayEx}          ArrayEx with Item objects.
+	 */
+	getItemsDeep: function(folder, returnArrayEx) {
+		// The returnArrayEx param is so we can skip the converting to arrayEx when
+		// recursing. It is not meant to be used outside of this function.
+		var item,
+			items = [],
+			len = folder.items.length;
+
+		for (var i=1; i <= len; i++) {
+			item = folder.items[i];
+			if (aeq.isFolderItem(item)) {
+				// Add all items in subfolder to the `items` array.
+				items.push.apply(items, aeq.getItemsDeep(item, false));
+			}
+			items.push(item);
+		}
+		// Skip converting to arrayEx when function is called by it self.
+		if (returnArrayEx === false) {
+			return items;
+		}
+		return aeq.arrayEx(items);
 	},
 
 	/**