Docs

1 files changed, 95 insertions, 0 deletions

diff --git a/node_modules/postcss-reporter/lib/formatter.js b/node_modules/postcss-reporter/lib/formatter.js
new file mode 100644
index 0000000..7358cc6
--- /dev/null
+++ b/node_modules/postcss-reporter/lib/formatter.js
@@ -0,0 +1,95 @@
+var pico = require('picocolors');
+var path = require('path');
+var firstBy = require('thenby');
+var util = require('./util');
+
+var supportsLargeCharset =
+  process.platform !== 'win32' ||
+  process.env.CI ||
+  process.env.TERM === 'xterm-256color';
+var warningSymbol = supportsLargeCharset ? '⚠' : '!!';
+
+function createSortFunction(positionless, sortByPosition) {
+  var positionValue = 0
+
+  if (positionless === 'any') { positionValue = 1; }
+  if (positionless === 'first') { positionValue = 2; }
+  if (positionless === 'last') { positionValue = 0; }
+
+  var sortFunction = firstBy((m) => {
+    if (!m.line) return 1;
+    return positionValue;
+  })
+
+  if (sortByPosition) {
+    sortFunction = sortFunction.thenBy('line').thenBy('column');
+  }
+
+  return sortFunction;
+}
+
+module.exports = function (opts) {
+  var options = opts || {};
+  var sortByPosition =
+    typeof options.sortByPosition !== 'undefined'
+      ? options.sortByPosition
+      : true;
+  var positionless = options.positionless || 'first';
+
+  var sortFunction = createSortFunction(positionless, sortByPosition);
+
+  return function (input) {
+    var messages = input.messages.filter(function (message) {
+      return typeof message.text === 'string';
+    });
+    var source = input.source;
+
+    if (!messages.length) return '';
+
+    var orderedMessages = messages.sort(sortFunction);
+
+    var output = '\n';
+
+    if (source) {
+      output += pico.bold(pico.underline(logFrom(source))) + '\n';
+    }
+
+    orderedMessages.forEach(function (w) {
+      output += messageToString(w) + '\n';
+    });
+
+    return output;
+
+    function messageToString(message) {
+      var location = util.getLocation(message);
+      var str = '';
+
+      if (location.line) {
+        str += pico.bold(location.line);
+      }
+
+      if (location.column) {
+        str += pico.bold(':' + location.column);
+      }
+
+      if (location.line || location.column) {
+        str += '\t';
+      }
+
+      if (!options.noIcon && message.type === 'warning') {
+        str += pico.yellow(warningSymbol + '  ');
+      }
+
+      str += message.text;
+      if (!options.noPlugin) {
+        str += pico.yellow(' [' + message.plugin + ']');
+      }
+      return str;
+    }
+
+    function logFrom(fromValue) {
+      if (fromValue.charAt(0) === '<') return fromValue;
+      return path.relative(process.cwd(), fromValue).split(path.sep).join('/');
+    }
+  };
+};