docs(sass): add sass processor

scripts/docs/processors/parse-sass.js

@@ -0,0 +1,143 @@
+var path = require('path');
+var fs = require('fs');
+var Q = require('q');
+var sassdoc = require('sassdoc');
+
+module.exports = function parseSass () {
+  return {
+    $runBefore: ['rendering-docs'],
+    $process: function (docs) {
+
+      var folders = [];
+      var docsByComponent = [];
+      var promises = [];
+      var returnPromise = Q.defer();
+
+      // for each doc, check if new folder(component)
+      // if yes, get styles promises
+      docs.forEach( function(doc, index) {
+        if (doc.fileInfo) {
+          var folder = doc.fileInfo.filePath
+            .split('/')
+            .filter( function (item, index, self) {
+              return index !== self.length -  1;
+            })
+            .join('/');
+          if(folders.indexOf(folder) === -1) {
+            folders.push(folder);
+            docsByComponent.push([doc]);
+            promises.push( getStyles(folder, docsByComponent.length - 1) );
+          } else {
+            docsByComponent[folders.indexOf(folder)].push(doc);
+          }
+        }
+      });
+
+      // when all promises are completed, add sass info
+      Q.allSettled(promises).spread( function () {
+        var folders = Array.prototype.map.bind(arguments)(function (item) {
+          return item.value;
+        });
+        appendStyles(folders, docsByComponent);
+        returnPromise.resolve(docs);
+      }).catch( function (error) {
+        console.log('Sass Error: ' + error);
+        returnPromise.resolve(docs);
+      });
+
+      return returnPromise.promise;
+    }
+  }
+};
+
+function appendStyles(folders, docsByComponent) {
+  folders.forEach( function (folder) {
+
+    var styles = formatStyles(folder);
+
+    if (styles.length) {
+      docsByComponent[folder.index].forEach( function (doc) {
+        doc.sassVariables = styles;
+      });
+    }
+  });
+}
+
+function formatStyles (folder) {
+
+  return folder.styles.filter( function (style) {
+      return style.data && style.data.length;
+  }).map( function (style) {
+
+    var props = style.data.filter( function (item) {
+      return item.property && item.property.length;
+    }).map( function (item) {
+
+      var property = item.property[0];
+
+      return {
+        name: item.context.name || '',
+        default: item.context.value || '',
+        description: property.description || '',
+      };
+    });
+
+    return { platform: style.platform, props: props };
+  });
+}
+
+function getStyles (folder, docIndex) {
+
+  var returnPromise = Q.defer();
+
+  // get component name
+  var component = folder.split('/').pop();
+
+  // generate file names to check
+  var extension = 'scss';
+  var files = [];
+
+  files.push({
+    platform: 'base',
+    path: path.join(folder, [component, extension].join('.'))
+  });
+
+  ['ios', 'md', 'wp'].forEach( function (platform) {
+    var fileName = [component, platform, extension].join('.');
+    files.push({
+      platform: platform,
+      path: path.join(folder, fileName)
+    });
+  });
+
+  // for each file, fetch styles
+  var promises = files.map( function (file) {
+    return Q.promise( function (resolve, reject) {
+      fs.access(file.path, function (err) {
+        if (!err) {
+          sassdoc.parse(file.path )
+            .then( function (data) {
+              resolve( { platform: file.platform, data: data });
+            }).catch( function (error) {
+              reject(error);
+            });
+        } else {
+          // file doesn't exist
+          resolve({ platform: file.platform, data: null });
+        }
+      });
+    });
+  });
+
+  // when all promises are finished, return the results
+  Q.allSettled(promises).then( function (results) {
+    var styles = results.map( function (style) {
+      return style.value;
+    });
+    returnPromise.resolve({ index: docIndex, styles: styles });
+  }).catch( function (error) {
+    returnPromise.reject(error);
+  });
+
+  return returnPromise.promise;
+}