Docs

3 files changed, 215 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('/');
+    }
+  };
+};
diff --git a/node_modules/postcss-reporter/lib/reporter.js b/node_modules/postcss-reporter/lib/reporter.js
new file mode 100644
index 0000000..71872a9
--- /dev/null
+++ b/node_modules/postcss-reporter/lib/reporter.js
@@ -0,0 +1,101 @@
+var defaultFormatter = require('./formatter');
+var pico = require('picocolors');
+var util = require('./util');
+
+module.exports = function (opts = {}) {
+  var formatter =
+    opts.formatter ||
+    defaultFormatter({
+      noIcon: opts.noIcon,
+      noPlugin: opts.noPlugin,
+    });
+
+  var pluginFilter;
+  if (!opts.plugins) {
+    // Every plugin
+    pluginFilter = function () {
+      return true;
+    };
+  } else if (
+    opts.plugins.every(function (plugin) {
+      return plugin[0] === '!';
+    })
+  ) {
+    // Deny list
+    pluginFilter = function (message) {
+      return opts.plugins.indexOf('!' + message.plugin) === -1;
+    };
+  } else {
+    // Allow list
+    pluginFilter = function (message) {
+      return opts.plugins.indexOf(message.plugin) !== -1;
+    };
+  }
+
+  var messageFilter = opts.filter || ((message) => message.type === 'warning');
+
+  return {
+    postcssPlugin: 'postcss-reporter',
+    OnceExit(css, { result }) {
+      var messagesToLog = result.messages
+        .filter(pluginFilter)
+        .filter(messageFilter);
+
+      var resultSource = !result.root.source
+        ? ''
+        : result.root.source.input.file || result.root.source.input.id;
+
+      var sourceGroupedMessages = messagesToLog.reduce((grouped, message) => {
+        const key = util.getLocation(message).file || resultSource;
+
+        if (!grouped.hasOwnProperty(key)) {
+          grouped[key] = [];
+        }
+
+        grouped[key].push(message);
+
+        return grouped;
+      }, {});
+
+      var report = '';
+      for (const source in sourceGroupedMessages) {
+        if (sourceGroupedMessages.hasOwnProperty(source)) {
+          report += formatter({
+            messages: sourceGroupedMessages[source],
+            source: source,
+          });
+        }
+      }
+
+      if (opts.clearReportedMessages) {
+        result.messages = result.messages.filter(message => !messagesToLog.includes(message));
+      }
+
+      if (opts.clearAllMessages) {
+        var messagesToClear = result.messages.filter(pluginFilter);
+        result.messages = result.messages.filter(message => !messagesToClear.includes(message));
+      }
+
+      if (!report) return;
+
+      console.log(report);
+
+      if (opts.throwError && shouldThrowError()) {
+        throw new Error(
+          pico.red(
+            pico.bold('\n** postcss-reporter: warnings or errors were found **')
+          )
+        );
+      }
+
+      function shouldThrowError() {
+        return (
+          messagesToLog.length &&
+          messagesToLog.some((message) => {
+            return message.type === 'warning' || message.type === 'error';
+          })
+        );
+      }
+    },
+  };
+};
diff --git a/node_modules/postcss-reporter/lib/util.js b/node_modules/postcss-reporter/lib/util.js
new file mode 100644
index 0000000..094b3ac
--- /dev/null
+++ b/node_modules/postcss-reporter/lib/util.js
@@ -0,0 +1,19 @@
+exports.getLocation = function (message) {
+  var messageNode = message.node;
+
+  var location = {
+    line: message.line,
+    column: message.column,
+  };
+
+  var messageInput = messageNode && messageNode.source && messageNode.source.input;
+
+  if (!messageInput) return location;
+
+  var originLocation =
+    messageInput.origin && messageInput.origin(message.line, message.column);
+  if (originLocation) return originLocation;
+
+  location.file = messageInput.file || messageInput.id;
+  return location;
+};