264 lines
22 KiB
JavaScript
264 lines
22 KiB
JavaScript
|
"use strict";
|
|||
|
|
|
|||
|
|
exports.__esModule = true;
|
|||
|
|
exports.default = void 0;
|
|||
|
|
|
|||
|
|
var _lazyResult = _interopRequireDefault(require("./lazy-result"));
|
|||
|
|
|
|||
|
|
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Contains plugins to process CSS. Create one `Processor` instance,
|
|||
|
|
* initialize its plugins, and then use that instance on numerous CSS files.
|
|||
|
|
*
|
|||
|
|
* @example
|
|||
|
|
* const processor = postcss([autoprefixer, precss])
|
|||
|
|
* processor.process(css1).then(result => console.log(result.css))
|
|||
|
|
* processor.process(css2).then(result => console.log(result.css))
|
|||
|
|
*/
|
|||
|
|
var Processor =
|
|||
|
|
/*#__PURE__*/
|
|||
|
|
function () {
|
|||
|
|
/**
|
|||
|
|
* @param {Array.<Plugin|pluginFunction>|Processor} plugins PostCSS plugins.
|
|||
|
|
* See {@link Processor#use} for plugin format.
|
|||
|
|
*/
|
|||
|
|
function Processor(plugins) {
|
|||
|
|
if (plugins === void 0) {
|
|||
|
|
plugins = [];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Current PostCSS version.
|
|||
|
|
*
|
|||
|
|
* @type {string}
|
|||
|
|
*
|
|||
|
|
* @example
|
|||
|
|
* if (result.processor.version.split('.')[0] !== '6') {
|
|||
|
|
* throw new Error('This plugin works only with PostCSS 6')
|
|||
|
|
* }
|
|||
|
|
*/
|
|||
|
|
this.version = '7.0.17';
|
|||
|
|
/**
|
|||
|
|
* Plugins added to this processor.
|
|||
|
|
*
|
|||
|
|
* @type {pluginFunction[]}
|
|||
|
|
*
|
|||
|
|
* @example
|
|||
|
|
* const processor = postcss([autoprefixer, precss])
|
|||
|
|
* processor.plugins.length //=> 2
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
this.plugins = this.normalize(plugins);
|
|||
|
|
}
|
|||
|
|
/**
|
|||
|
|
* Adds a plugin to be used as a CSS processor.
|
|||
|
|
*
|
|||
|
|
* PostCSS plugin can be in 4 formats:
|
|||
|
|
* * A plugin created by {@link postcss.plugin} method.
|
|||
|
|
* * A function. PostCSS will pass the function a @{link Root}
|
|||
|
|
* as the first argument and current {@link Result} instance
|
|||
|
|
* as the second.
|
|||
|
|
* * An object with a `postcss` method. PostCSS will use that method
|
|||
|
|
* as described in #2.
|
|||
|
|
* * Another {@link Processor} instance. PostCSS will copy plugins
|
|||
|
|
* from that instance into this one.
|
|||
|
|
*
|
|||
|
|
* Plugins can also be added by passing them as arguments when creating
|
|||
|
|
* a `postcss` instance (see [`postcss(plugins)`]).
|
|||
|
|
*
|
|||
|
|
* Asynchronous plugins should return a `Promise` instance.
|
|||
|
|
*
|
|||
|
|
* @param {Plugin|pluginFunction|Processor} plugin PostCSS plugin
|
|||
|
|
* or {@link Processor}
|
|||
|
|
* with plugins.
|
|||
|
|
*
|
|||
|
|
* @example
|
|||
|
|
* const processor = postcss()
|
|||
|
|
* .use(autoprefixer)
|
|||
|
|
* .use(precss)
|
|||
|
|
*
|
|||
|
|
* @return {Processes} Current processor to make methods chain.
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
|
|||
|
|
var _proto = Processor.prototype;
|
|||
|
|
|
|||
|
|
_proto.use = function use(plugin) {
|
|||
|
|
this.plugins = this.plugins.concat(this.normalize([plugin]));
|
|||
|
|
return this;
|
|||
|
|
}
|
|||
|
|
/**
|
|||
|
|
* Parses source CSS and returns a {@link LazyResult} Promise proxy.
|
|||
|
|
* Because some plugins can be asynchronous it doesn’t make
|
|||
|
|
* any transformations. Transformations will be applied
|
|||
|
|
* in the {@link LazyResult} methods.
|
|||
|
|
*
|
|||
|
|
* @param {string|toString|Result} css String with input CSS or any object
|
|||
|
|
* with a `toString()` method,
|
|||
|
|
* like a Buffer. Optionally, send
|
|||
|
|
* a {@link Result} instance
|
|||
|
|
* and the processor will take
|
|||
|
|
* the {@link Root} from it.
|
|||
|
|
* @param {processOptions} [opts] Options.
|
|||
|
|
*
|
|||
|
|
* @return {LazyResult} Promise proxy.
|
|||
|
|
*
|
|||
|
|
* @example
|
|||
|
|
* processor.process(css, { from: 'a.css', to: 'a.out.css' })
|
|||
|
|
* .then(result => {
|
|||
|
|
* console.log(result.css)
|
|||
|
|
* })
|
|||
|
|
*/
|
|||
|
|
;
|
|||
|
|
|
|||
|
|
_proto.process = function (_process) {
|
|||
|
|
function process(_x) {
|
|||
|
|
return _process.apply(this, arguments);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
process.toString = function () {
|
|||
|
|
return _process.toString();
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
return process;
|
|||
|
|
}(function (css, opts) {
|
|||
|
|
if (opts === void 0) {
|
|||
|
|
opts = {};
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (this.plugins.length === 0 && opts.parser === opts.stringifier) {
|
|||
|
|
if (process.env.NODE_ENV !== 'production') {
|
|||
|
|
if (typeof console !== 'undefined' && console.warn) {
|
|||
|
|
console.warn('You did not set any plugins, parser, or stringifier. ' + 'Right now, PostCSS does nothing. Pick plugins for your case ' + 'on https://www.postcss.parts/ and use them in postcss.config.js.');
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return new _lazyResult.default(this, css, opts);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
_proto.normalize = function normalize(plugins) {
|
|||
|
|
var normalized = [];
|
|||
|
|
|
|||
|
|
for (var _iterator = plugins, _isArray = Array.isArray(_iterator), _i = 0, _iterator = _isArray ? _iterator : _iterator[Symbol.iterator]();;) {
|
|||
|
|
var _ref;
|
|||
|
|
|
|||
|
|
if (_isArray) {
|
|||
|
|
if (_i >= _iterator.length) break;
|
|||
|
|
_ref = _iterator[_i++];
|
|||
|
|
} else {
|
|||
|
|
_i = _iterator.next();
|
|||
|
|
if (_i.done) break;
|
|||
|
|
_ref = _i.value;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
var i = _ref;
|
|||
|
|
if (i.postcss) i = i.postcss;
|
|||
|
|
|
|||
|
|
if (typeof i === 'object' && Array.isArray(i.plugins)) {
|
|||
|
|
normalized = normalized.concat(i.plugins);
|
|||
|
|
} else if (typeof i === 'function') {
|
|||
|
|
normalized.push(i);
|
|||
|
|
} else if (typeof i === 'object' && (i.parse || i.stringify)) {
|
|||
|
|
if (process.env.NODE_ENV !== 'production') {
|
|||
|
|
throw new Error('PostCSS syntaxes cannot be used as plugins. Instead, please use ' + 'one of the syntax/parser/stringifier options as outlined ' + 'in your PostCSS runner documentation.');
|
|||
|
|
}
|
|||
|
|
} else {
|
|||
|
|
throw new Error(i + ' is not a PostCSS plugin');
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return normalized;
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
return Processor;
|
|||
|
|
}();
|
|||
|
|
|
|||
|
|
var _default = Processor;
|
|||
|
|
/**
|
|||
|
|
* @callback builder
|
|||
|
|
* @param {string} part Part of generated CSS connected to this node.
|
|||
|
|
* @param {Node} node AST node.
|
|||
|
|
* @param {"start"|"end"} [type] Node’s part type.
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @callback parser
|
|||
|
|
*
|
|||
|
|
* @param {string|toString} css String with input CSS or any object
|
|||
|
|
* with toString() method, like a Buffer.
|
|||
|
|
* @param {processOptions} [opts] Options with only `from` and `map` keys.
|
|||
|
|
*
|
|||
|
|
* @return {Root} PostCSS AST
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @callback stringifier
|
|||
|
|
*
|
|||
|
|
* @param {Node} node Start node for stringifing. Usually {@link Root}.
|
|||
|
|
* @param {builder} builder Function to concatenate CSS from node’s parts
|
|||
|
|
* or generate string and source map.
|
|||
|
|
*
|
|||
|
|
* @return {void}
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @typedef {object} syntax
|
|||
|
|
* @property {parser} parse Function to generate AST by string.
|
|||
|
|
* @property {stringifier} stringify Function to generate string by AST.
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @typedef {object} toString
|
|||
|
|
* @property {function} toString
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @callback pluginFunction
|
|||
|
|
* @param {Root} root Parsed input CSS.
|
|||
|
|
* @param {Result} result Result to set warnings or check other plugins.
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @typedef {object} Plugin
|
|||
|
|
* @property {function} postcss PostCSS plugin function.
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @typedef {object} processOptions
|
|||
|
|
* @property {string} from The path of the CSS source file.
|
|||
|
|
* You should always set `from`,
|
|||
|
|
* because it is used in source map
|
|||
|
|
* generation and syntax error messages.
|
|||
|
|
* @property {string} to The path where you’ll put the output
|
|||
|
|
* CSS file. You should always set `to`
|
|||
|
|
* to generate correct source maps.
|
|||
|
|
* @property {parser} parser Function to generate AST by string.
|
|||
|
|
* @property {stringifier} stringifier Class to generate string by AST.
|
|||
|
|
* @property {syntax} syntax Object with `parse` and `stringify`.
|
|||
|
|
* @property {object} map Source map options.
|
|||
|
|
* @property {boolean} map.inline Does source map should
|
|||
|
|
* be embedded in the output
|
|||
|
|
* CSS as a base64-encoded
|
|||
|
|
* comment.
|
|||
|
|
* @property {string|object|false|function} map.prev Source map content
|
|||
|
|
* from a previous
|
|||
|
|
* processing step
|
|||
|
|
* (for example, Sass).
|
|||
|
|
* PostCSS will try to find
|
|||
|
|
* previous map automatically,
|
|||
|
|
* so you could disable it by
|
|||
|
|
* `false` value.
|
|||
|
|
* @property {boolean} map.sourcesContent Does PostCSS should set
|
|||
|
|
* the origin content to map.
|
|||
|
|
* @property {string|false} map.annotation Does PostCSS should set
|
|||
|
|
* annotation comment to map.
|
|||
|
|
* @property {string} map.from Override `from` in map’s
|
|||
|
|
* sources`.
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
exports.default = _default;
|
|||
|
|
module.exports = exports.default;
|
|||
|
|
//# sourceMappingURL=data:application/json;charset=utf8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbInByb2Nlc3Nvci5lczYiXSwibmFtZXMiOlsiUHJvY2Vzc29yIiwicGx1Z2lucyIsInZlcnNpb24iLCJub3JtYWxpemUiLCJ1c2UiLCJwbHVnaW4iLCJjb25jYXQiLCJwcm9jZXNzIiwiY3NzIiwib3B0cyIsImxlbmd0aCIsInBhcnNlciIsInN0cmluZ2lmaWVyIiwiZW52IiwiTk9ERV9FTlYiLCJjb25zb2xlIiwid2FybiIsIkxhenlSZXN1bHQiLCJub3JtYWxpemVkIiwiaSIsInBvc3Rjc3MiLCJBcnJheSIsImlzQXJyYXkiLCJwdXNoIiwicGFyc2UiLCJzdHJpbmdpZnkiLCJFcnJvciJdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFBQTs7OztBQUVBOzs7Ozs7Ozs7SUFTTUEsUzs7O0FBQ0o7Ozs7QUFJQSxxQkFBYUMsT0FBYixFQUEyQjtBQUFBLFFBQWRBLE9BQWM7QUFBZEEsTUFBQUEsT0FBYyxHQUFKLEVBQUk7QUFBQTs7QUFDekI7Ozs7Ozs7Ozs7QUFVQSxTQUFLQyxPQUFMLEdBQWUsUUFBZjtBQUNBOzs7Ozs7Ozs7O0FBU0EsU0FBS0QsT0FBTCxHQUFlLEtBQUtFLFNBQUwsQ0FBZUYsT0FBZixDQUFmO0FBQ0Q7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O1NBNkJBRyxHLEdBQUEsYUFBS0MsTUFBTCxFQUFhO0FBQ1gsU0FBS0osT0FBTCxHQUFlLEtBQUtBLE9BQUwsQ0FBYUssTUFBYixDQUFvQixLQUFLSCxTQUFMLENBQWUsQ0FBQ0UsTUFBRCxDQUFmLENBQXBCLENBQWY7QUFDQSxXQUFPLElBQVA7QUFDRDtBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7U0FzQkFFLE87Ozs7Ozs7Ozs7SUFBQSxVQUFTQyxHQUFULEVBQWNDLElBQWQsRUFBMEI7QUFBQSxRQUFaQSxJQUFZO0FBQVpBLE1BQUFBLElBQVksR0FBTCxFQUFLO0FBQUE7O0FBQ3hCLFFBQUksS0FBS1IsT0FBTCxDQUFhUyxNQUFiLEtBQXdCLENBQXhCLElBQTZCRCxJQUFJLENBQUNFLE1BQUwsS0FBZ0JGLElBQUksQ0FBQ0csV0FBdEQsRUFBbUU7QUFDakUsVUFBSUwsT0FBTyxDQUFDTSxHQUFSLENBQVlDLFFBQVosS0FBeUIsWUFBN0IsRUFBMkM7QUFDekMsWUFBSSxPQUFPQyxPQUFQLEtBQW1CLFdBQW5CLElBQWtDQSxPQUFPLENBQUNDLElBQTlDLEVBQW9EO0FBQ2xERCxVQUFBQSxPQUFPLENBQUNDLElBQVIsQ0FDRSwwREFDQSw4REFEQSxHQUVBLGtFQUhGO0FBS0Q7QUFDRjtBQUNGOztBQUNELFdBQU8sSUFBSUMsbUJBQUosQ0FBZSxJQUFmLEVBQXFCVCxHQUFyQixFQUEwQkMsSUFBMUIsQ0FBUDtBQUNELEc7O1NBRUROLFMsR0FBQSxtQkFBV0YsT0FBWCxFQUFvQjtBQUNsQixRQUFJaUIsVUFBVSxHQUFHLEVBQWpCOztBQUNBLHlCQUFjakIsT0FBZCxrSEFBdUI7QUFBQTs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBOztBQUFBLFVBQWRrQixDQUFjO0FBQ3JCLFVBQUlBLENBQUMsQ0FBQ0MsT0FBTixFQUFlRCxDQUFDLEdBQUdBLENBQUMsQ0FBQ0MsT0FBTjs7QUFFZixVQUFJLE9BQU9ELENBQVAsS0FBYSxRQUFiLElBQXlCRSxLQUFLLENBQUNDLE9BQU4sQ0FBY0gsQ0FBQyxDQUFDbEIsT0FBaEIsQ0FBN0IsRUFBdUQ7QUFDckRpQixRQUFBQSxVQUFVLEdBQUdBLFVBQVUsQ0FBQ1osTUFBWCxDQUFrQmEsQ0FBQyxDQUFDbEIsT0FBcEIsQ0FBYjtBQUNELE9BRkQsTUFFTyxJQUFJLE9BQU9rQixDQUFQLEtBQWEsVUFBakIsRUFBNkI7QUFDbENELFFBQUFBLFVBQVUsQ0FBQ0ssSUFBWCxDQUFnQkosQ0FBaEI7QUFDRCxPQUZNLE1BRUEsSUFBSSxPQUFPQSxDQUFQLEtBQWEsUUFBYixLQUEwQkEsQ0FBQyxDQUFDSyxLQUFGLElBQVdMLENBQUMsQ0FBQ00sU0FBdkMsQ0FBSixFQUF1RDtBQUM1RCxZQUFJbEIsT0FBTyxDQUFDTSxHQUFSLENBQVlDLFFBQVosS0FBeUIsWUFBN0IsRUFBMkM7QUFDekMsZ0JBQU0sSUFBSVksS0FBSixDQUNKLHFFQUNBLDJEQURBLEdBRUEsdUNBSEksQ0FBTjtBQUtEO0FBQ0YsT0FSTSxNQVFBO0FBQ0wsY0FBTSxJQUFJQSxLQUFKLENBQVVQLENBQUMsR0FBRywwQkFBZCxDQUFOO0FBQ0Q7QUFDRjs7QUFDRCxXQUFPRCxVQUFQO0FBQ0QsRzs7Ozs7ZUFHWWxCLFM7QUFFZjs7Ozs7OztBQU9BOzs7Ozs7Ozs7O0FBVUE7Ozs7Ozs7Ozs7QUFVQTs7Ozs7O0FBTUE7Ozs7O0FBS0E7Ozs7OztBQU1BOzs7OztBQUtBIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IExhenlSZXN1bHQgZnJvbSAnLi9sYXp5LXJlc3VsdCdcblxuLyoqXG4gKiBDb250YWlucyBwbHVnaW5zIHRvIHByb2Nlc3MgQ1NTLiBDcmVhdGUgb25lIGBQcm9jZXNzb3JgIGluc3RhbmNlLFxuICogaW5pdGlhbGl6ZSBpdHMgcGx1Z2lucywgYW5kIHRoZW4gdXNlIHRoYXQgaW5zdGFuY2Ugb24gbnVtZXJvdXMgQ1NTIGZpbGVzLlxuICpcbiAqIEBleGFtcGxlXG4gKiBjb25zdCBwcm9jZXNzb3IgPSBwb3N0Y3NzKFthdXRvcHJlZml4ZXIsIHByZWNzc10pXG4gKiBwcm9jZXNzb3IucHJvY2Vzcyhjc3MxKS50aGVuKHJlc3VsdCA9PiBjb25zb2xlLmxvZyhyZXN1bHQuY3NzKSlcbiAqIHByb2Nlc3Nvci5wcm9jZXNzKGNzczIpLnRoZW4ocmVzdWx0ID0+IGNvbnNvbGUubG9nKHJlc3VsdC5jc3MpKVxuICovXG5jbGFzcyBQcm9jZXNzb3Ige1xuICAvKipcbiAgICogQHBhcmFtIHtBcnJheS48UGx1Z2lufHBsdWdpbkZ1bmN0aW9uPnxQcm9jZXNzb3J9IHBsdWdpbnMgUG9zdENTUyBwbHVnaW5zLlxuICAgKiAgICAgICAgU2VlIHtAbGluayBQcm9jZXNzb3IjdXNlfSBmb3IgcGx1Z2luIGZvcm1hdC5cbiAgICovXG4gIGNvbnN0cnVjdG9yIChwbHVnaW5zID0gW10pIHtcbiAgICAvKipcbiAgICAgKiBDdXJyZW50IFBvc3RDU1MgdmVyc2lvbi5cbiAgICAgKlxuICAgICAqIEB0eXBlIHtzdHJpbmd9XG4gICAgICpcbiAgICAgKiBAZXhhbXBsZVxuICAgICAqIGlmIChyZXN1bHQucHJvY2Vzc29yLnZlcnNpb24uc3BsaXQoJy4nKVswXSAhPT0gJzYnKSB7XG4gICAgICogICB0aHJvdyBuZXcgRXJyb3IoJ1RoaXMgcGx1Z2luIHdvcmtzIG9ubHkgd2l0aCBQb3N0Q1NTIDYnKVxuICAgICAqIH1cbiAgICAgKi9cbiAgICB0aGlzLnZlcnNpb24gPSAnNy4wLjE3J1xuICAgIC8qKlxuICAgICAqIFBsdWdpbnMgYWRkZWQgdG8gdGhpcyBw
|