pax_global_header00006660000000000000000000000064133127700600014511gustar00rootroot0000000000000052 comment=51e35386da38994b441acac0b6e65888b3025756 postcss-6.0.23/000077500000000000000000000000001331277006000132775ustar00rootroot00000000000000postcss-6.0.23/.editorconfig000066400000000000000000000002631331277006000157550ustar00rootroot00000000000000root = true [*] indent_style = space indent_size = 4 end_of_line = lf charset = utf-8 trim_trailing_whitespace = true insert_final_newline = true [*.{json,yml}] indent_size = 2 postcss-6.0.23/.gitattributes000066400000000000000000000000111331277006000161620ustar00rootroot00000000000000* eol=lf postcss-6.0.23/.gitignore000066400000000000000000000001201331277006000152600ustar00rootroot00000000000000.DS_Store *~ node_modules/ npm-debug.log yarn-error.log build/ lib/*.js api/ postcss-6.0.23/.jsdocrc000066400000000000000000000004651331277006000147340ustar00rootroot00000000000000{ "source": { "includePattern": ".+\\.es6$" }, "opts": { "template": "node_modules/docdash", "destination": "./api/" }, "plugins": ["plugins/markdown"], "templates": { "default": { "layoutFile": "node_modules/docdash/tmpl/layout.tmpl", "includeDate": false } } } postcss-6.0.23/.npmignore000066400000000000000000000001661331277006000153010ustar00rootroot00000000000000node_modules/ npm-debug.log yarn-error.log yarn.lock build/ test/ .travis.yml appveyor.yml gulpfile.babel.js api/ postcss-6.0.23/.travis.yml000066400000000000000000000002131331277006000154040ustar00rootroot00000000000000language: node_js cache: yarn node_js: - node - "9" - "8" - "6" - "4" install: - YARN_IGNORE_ENGINES=true yarn git: depth: 5 postcss-6.0.23/.yaspellerrc000066400000000000000000000063301331277006000156270ustar00rootroot00000000000000{ "lang": "en", "format": "markdown", "fileExtensions": [".md"], "excludeFiles": [ ".git", "node_modules", "build", "api/*.es6.html", "README-cn.md" ], "ignoreCapitalization": true, "dictionary": [ "6to5", "ASE", "AtCSS", "Autoprefixer", "Base64", "cssnext", "cssnano", "Browserhacks", "CoffeeScript", "GitHub", "JetBrains", "WebStorm", "Traceur", "PostCSS", "PostCSS’s", "postcss", "Shopify", "Instagram", "Travis", "poststylus", "Gofmt", "CI", "MD5", "W3C", "WebP", "VK", "IE8", "IE9", "ES5", "ES6", "ENB", "Vapula", "Zagan", "SemVer", "Sass", "Sass’s", "SCSS", "Weibo", "PreCSS", "libsass", "CSSOM", "Popp", "Jeet", "Modernizr", "npm", "webpack", "Amdusias", "Anton", "Alexey", "Andres", "Andromalius", "Andrealphus", "Andalusian", "Andras", "asan", "Lind", "Zuo", "Jed", "Neal", "Valac", "Vue", "Briggs", "Bogdan", "Chadkin", "ClojureWerkz’s", "Dantalion", "Montoro", "Decarabia", "Dvornov", "Efremov", "Flauros", "Josiah", "Lydell", "Locati", "Lolspeak", "Matija", "Marohnić", "Maxime", "Michele", "Mohammad", "Nikitenko", "Savary", "Seere", "Suarez", "Thirouin", "Peterson", "Yakushev", "Younes", "Cimeies", "Autodetect", "autodetect", "codebases", "flexbox", "unprefixes", "regexp", "changelog", "Changelog", "Transpiler", "transpiler", "transpile", "transpiles", "transpiling", "tokenize", "tokenizer", "linter", "linters", "CamelCase", "rebases", "resolver", "minifier", "isolatable", "minifiers", "mixins", "mixin", "multitool", "io", "partials", "inlined", "inlines", "polyfill", "stylesheet", "stylesheets", "stringifier", "keyframes", "BEM", "CLI", "CSS3", "CSS4", "SugarSS", "SVG", "SVGO", "Markdown", "JS", "js", "vs", "pantone", "YIQ", "gitter", "evilmartians", "Less’s", "visualizer", "Rollup", "AtRule", "CssSyntaxError", "LazyResult", "RegExp", "atRule", "childIterator", "cloneAfter", "cloneBefore", "docdash", "withContent", "walkRules", "walkDecls", "walkComments", "unprefixed", "toResult", "showSourceCode", "replaceWith", "replaceValues", "removeChild", "removeAll", "prepend", "params", "insertBefore", "insertAfter", "decl", "es6", "stringify", "defaultType", "newParent", "otherNode", "SourceMapGenerator", "onFulfilled", "onRejected", "base64", "stringifing", "Browserify", "CodePen", "LTS", "Garet", "McKinley", "Semigradsky", "janschoenherr", "bumbleblym", "Packt", "Libby", "LTR", "RTL", "Orias", "Oleh", "Kuchuk", "Kalani", "Adamenko", "Eppstein", "Taskr", "AST", "EOL", "Keller", "Sylvain", "Pollet", "Villard" ] } postcss-6.0.23/CHANGELOG.md000066400000000000000000000431251331277006000151150ustar00rootroot00000000000000# Change Log This project adheres to [Semantic Versioning](http://semver.org/). ## 6.0.23 * Fix parsing nested at-rules without semicolon, params, and spaces. ## 6.0.22 * Fix `Node#prev` and `Node#next` on missed parent. ## 6.0.21 * Rename Chinese docs to fix `yarnpkg.com` issue. ## 6.0.20 * Better error message on `null` as input CSS. ## 6.0.19 * Fix TypeScript definitions for source maps (by Oleh Kuchuk). * Fix `source` field in TypeScript definitions (by Sylvain Pollet-Villard). ## 6.0.18 * Use primitive object in TypeScript definitions (by Sylvain Pollet-Villard). ## 6.0.17 * Fix parsing comment in selector between word tokens (by Oleh Kuchuk). ## 6.0.16 * Fix warning text (by Michael Keller). ## 6.0.15 * Add warning about missed `from` option on `process().then()` call. * Add IE 10 support. ## 6.0.14 * Fix TypeScript definitions (by Jed Mao). ## 6.0.13 * Fix TypeScript definitions for case of multiple PostCSS versions in `node_modules` (by Chris Eppstein). * Use `source-map` 0.6. ## 6.0.12 * Don’t copy `*` hack to declaration indent. ## 6.0.11 * Add upper case `!IMPORTANT` support. ## 6.0.10 * Reduce PostCSS size in webpack bundle. ## 6.0.9 * Improve error message for plugin with old PostCSS (by Igor Adamenko). ## 6.0.8 * Fix Node.js 4.2.2 support. ## 6.0.7 * Fix base64 decoding for old Node.js and browser. ## 6.0.6 * Fix `end` position in at-rule without semicolon (by Oleh Kuchuk). ## 6.0.5 * Move Babel config from `package.json` for `node_modules` compiling cases. ## 6.0.4 * Fix parsing `;;` after rules. * Use Chalk 2.0. ## 6.0.3 * Fix escape sequences parsing (by Oleh Kuchuk). * Added ability to force disable colors with an environment variable. * Improved color detection of some terminal apps. ## 6.0.2 * Keep `raws.before` on moving `Root` children to new `Root`. ## 6.0.1 * Fix parser extensibility to use it in Safe Parser. ## 6.0 “Marquis Orias” * Remove node.js 0.12 support. * Remove deprecated method from PostCSS 4. * Insert methods remove child from previous parent, instead of closing. * Insert methods and cloning doesn’t clean `raws` anymore. * Methods `moveTo`, `moveAfter`, `moveBefore` were deprecated. * Options was changed in `Plugin#process(css, processOptions, pluginOptions)`. * Add stream parser to reduce memory usage (by Oleh Kuchuk). * Add `before()`/`after()` shortcuts for `node.parent.insertBefore(node, x)`. * Add `Rule#raws.ownSemicolon` for semicolon after templates for `@apply`. * Use `babel-preset-env` to compile npm package. * Remove `js-base64` from dependencies (by Roman Dvornov). * Fix error message on single `:` in CSS. * Move tests to Jest. * Clean up test (by Gabriel Kalani). ## 5.2.18 * Fix TypeScript definitions for case of multiple PostCSS versions in `node_modules` (by Chris Eppstein). ## 5.2.17 * Add `postcss-sass` suggestion to syntax error on `.sass` input. ## 5.2.16 * Better error on wrong argument in node constructor. ## 5.2.15 * Fix TypeScript definitions (by bumbleblym). ## 5.2.14 * Fix browser bundle building in webpack (by janschoenherr). ## 5.2.13 * Do not add comment to important raws. * Fix JSDoc (by Dmitry Semigradsky). ## 5.2.12 * Fix typo in deprecation message (by Garet McKinley). ## 5.2.11 * Fix TypeScript definitions (by Jed Mao). ## 5.2.10 * Fix TypeScript definitions (by Jed Mao). ## 5.2.9 * Update TypeScript definitions (by Jed Mao). ## 5.2.8 * Fix error message (by Ben Briggs). ## 5.2.7 * Better error message on syntax object in plugins list. ## 5.2.6 * Fix `postcss.vendor` for values with spaces (by 刘祺). ## 5.2.5 * Better error message on unclosed string (by Ben Briggs). ## 5.2.4 * Improve terminal CSS syntax highlight (by Simon Lydell). ## 5.2.3 * Better color highlight in syntax error code frame. * Fix color highlight support in old systems. ## 5.2.2 * Update `Processor#version`. ## 5.2.1 * Fix source map path for CSS without `from` option (by Michele Locati). ## 5.2 “Duke Vapula” * Add syntax highlight to code frame in syntax error (by Andrey Popp). * Use Babel code frame style and size in syntax error. * Add `[` and `]` tokens to parse `[attr=;] {}` correctly. * Add `ignoreErrors` options to tokenizer (by Andrey Popp). * Fix error position on tab indent (by Simon Lydell). ## 5.1.2 * Suggests SCSS/Less parsers on parse errors depends on file extension. ## 5.1.1 * Fix TypeScript definitions (by Efremov Alexey). ## 5.1 “King and President Zagan” * Add URI in source map support (by Mark Finger). * Add `map.from` option (by Mark Finger). * Add `` mappings for nodes without source (by Bogdan Chadkin). * Add function value support to `map.prev` option (by Chris Montoro). * Add declaration value type check in shortcut creating (by 刘祺). * `Result#warn` now returns new created warning. * Don’t call plugin creator in `postcss.plugin` call. * Add source maps to PostCSS ES5 build. * Add JSDoc to PostCSS classes. * Clean npm package from unnecessary docs. ## 5.0.21 * Fix support with input source mao with `utf8` encoding name. ## 5.0.20 * Fix between raw value parsing (by David Clark). * Update TypeScript definitions (by Jed Mao). * Clean fake node.source after `append(string)`. ## 5.0.19 * Fix indent-based syntaxes support. ## 5.0.18 * Parse new lines according W3C CSS syntax specification. ## 5.0.17 * Fix options argument in `Node#warn` (by Ben Briggs). * Fix TypeScript definitions (by Jed Mao). ## 5.0.16 * Fix CSS syntax error position on unclosed quotes. ## 5.0.15 * Fix `Node#clone()` on `null` value somewhere in node. ## 5.0.14 * Allow to use PostCSS in webpack bundle without JSON loader. ## 5.0.13 * Fix `index` and `word` options in `Warning#toString` (by Bogdan Chadkin). * Fix input source content loading in errors. * Fix map options on using `LazyResult` as input CSS. * 100% test coverage. * Use Babel 6. ## 5.0.12 * Allow passing a previous map with no mappings (by Andreas Lind). ## 5.0.11 * Increase plugins performance by 1.5 times. ## 5.0.10 * Fix warning from nodes without source. ## 5.0.9 * Fix source map type detection (by @asan). ## 5.0.8 * Fixed a missed step in `5.0.7` that caused the module to be published as ES6 code. ## 5.0.7 * PostCSS now requires that node 0.12 is installed via the engines property in package.json (by Howard Zuo). ## 5.0.6 * Fix parsing nested at-rule without semicolon (by Matt Drake). * Trim `Declaration#value` (by Bogdan Chadkin). ## 5.0.5 * Fix multi-tokens property parsing (by Matt Drake). ## 5.0.4 * Fix start position in `Root#source`. * Fix source map annotation, when CSS uses `\r\n` (by Mohammad Younes). ## 5.0.3 * Fix `url()` parsing. * Fix using `selectors` in `Rule` constructor. * Add start source to `Root` node. ## 5.0.2 * Fix `remove(index)` to be compatible with 4.x plugin. ## 5.0.1 * Fix PostCSS 4.x plugins compatibility. * Fix type definition loading (by Jed Mao). ## 5.0 “President Valac” * Remove `safe` option. Move Safe Parser to separate project. * `Node#toString` does not include `before` for root nodes. * Remove plugin returning `Root` API. * Remove Promise polyfill for node.js 0.10. * Deprecate `eachInside`, `eachDecl`, `eachRule`, `eachAtRule` and `eachComment` in favor of `walk`, `walkDecls`, `walkRules`, `walkAtRules` and `walkComments` (by Jed Mao). * Deprecate `Container#remove` and `Node#removeSelf` in favor of `Container#removeChild` and `Node#remove` (by Ben Briggs). * Deprecate `Node#replace` in favor of `replaceWith` (by Ben Briggs). * Deprecate raw properties in favor of `Node#raws` object. * Deprecate `Node#style` in favor of `raw`. * Deprecate `CssSyntaxError#generated` in favor of `input`. * Deprecate `Node#cleanStyles` in favor of `cleanRaws`. * Deprecate `Root#prevMap` in favor of `Root.source.input.map`. * Add `syntax`, `parser` and `stringifier` options for Custom Syntaxes. * Add stringifier option to `Node#toString`. * Add `Result#content` alias for non-CSS syntaxes. * Add `plugin.process(css)` shortcut to every plugin function (by Ben Briggs). * Add multiple nodes support to insert methods (by Jonathan Neal). * Add `Node#warn` shortcut (by Ben Briggs). * Add `word` and `index` options to errors and warnings (by David Clark). * Add `line`, `column` properties to `Warning`. * Use `supports-color` library to detect color support in error output. * Add type definitions for TypeScript plugin developers (by Jed Mao). * `Rule#selectors` setter detects separators. * Add `postcss.stringify` method. * Throw descriptive errors for incorrectly formatted plugins. * Add docs to npm release. * Fix `url()` parsing. * Fix Windows support (by Jed Mao). ## 4.1.16 * Fix errors without stack trace. ## 4.1.15 * Allow asynchronous plugins to change processor plugins list (by Ben Briggs). ## 4.1.14 * Fix for plugins packs defined by `postcss.plugin`. ## 4.1.13 * Fix input inlined source maps with UTF-8 encoding. ## 4.1.12 * Update Promise polyfill. ## 4.1.11 * Fix error message on wrong plugin format. ## 4.1.10 * Fix Promise behavior on sync plugin errors. * Automatically fill `plugin` field in `CssSyntaxError`. * Fix warning message (by Ben Briggs). ## 4.1.9 * Speed up `node.clone()`. ## 4.1.8 * Accepts `Processor` instance in `postcss()` constructor too. ## 4.1.7 * Speed up `postcss.list` (by Bogdan Chadkin). ## 4.1.6 * Fix Promise behavior on parsing error. ## 4.1.5 * Parse at-words in declaration values. ## 4.1.4 * Fix Promise polyfill dependency (by Anton Yakushev and Matija Marohnić). ## 4.1.3 * Add Promise polyfill for node.js 0.10 and IE. ## 4.1.2 * List helpers can be accessed independently `var space = postcss.list.space`. ## 4.1.1 * Show deprecated message only once. ## 4.1 “Marquis Andras” * Asynchronous plugin support. * Add warnings from plugins and `Result#messages`. * Add `postcss.plugin()` to create plugins with a standard API. * Insert nodes by CSS string. * Show version warning message on error from an outdated plugin. * Send `Result` instance to plugins as the second argument. * Add `CssSyntaxError#plugin`. * Add `CssSyntaxError#showSourceCode()`. * Add `postcss.list` and `postcss.vendor` aliases. * Add `Processor#version`. * Parse wrong closing bracket. * Parse `!important` statement with spaces and comments inside (by Ben Briggs). * Throw an error on declaration without `prop` or `value` (by Philip Peterson). * Fix source map mappings position. * Add indexed source map support. * Always set `error.generated`. * Clean all source map annotation comments. ## 4.0.6 * Remove `babel` from released package dependencies (by Andres Suarez). ## 4.0.5 * Fix error message on double colon in declaration. ## 4.0.4 * Fix indent detection in some rare cases. ## 4.0.3 * Faster API with 6to5 Loose mode. * Fix indexed source maps support. ## 4.0.2 * Do not copy IE hacks to code style. ## 4.0.1 * Add `source.input` to `Root` too. ## 4.0 “Duke Flauros” * Rename `Container#childs` to `nodes`. * Rename `PostCSS#processors` to `plugins`. * Add `Node#replaceValues()` method. * Add `Node#moveTo()`, `moveBefore()` and `moveAfter()` methods. * Add `Node#cloneBefore()` and `cloneAfter()` shortcuts. * Add `Node#next()`, `prev()` and `root()` shortcuts. * Add `Node#replaceWith()` method. * Add `Node#error()` method. * Add `Container#removeAll()` method. * Add filter argument to `eachDecl()` and `eachAtRule()`. * Add `Node#source.input` and move `source.file` or `source.id` to `input`. * Change code indent, when node was moved. * Better fix code style on `Rule`, `AtRule` and `Comment` nodes changes. * Allow to create rules and at-rules by hash shortcut in append methods. * Add class name to CSS syntax error output. ## 3.0.7 * Fix IE filter parsing with multiple commands. * Safer way to consume PostCSS object as plugin (by Maxime Thirouin). ## 3.0.6 * Fix missing semicolon when comment comes after last declaration. * Fix Safe Mode declaration parsing on unclosed blocks. ## 3.0.5 * Fix parser to support difficult cases with backslash escape and brackets. * Add `CssSyntaxError#stack` (by Maxime Thirouin). ## 3.0.4 * Fix Safe Mode on unknown word before declaration. ## 3.0.3 * Increase tokenizer speed (by Roman Dvornov). ## 3.0.2 * Fix empty comment parsing. * Fix `Root#normalize` in some inserts. ## 3.0.1 * Fix Rhino JS runtime support. * Typo in deprecated warning (by Maxime Thirouin). ## 3.0 “Marquis Andrealphus” * New parser, which become the fastest ever CSS parser written in JavaScript. * Parser can now parse declarations and rules in one parent (like in `@page`) and nested declarations for plugins like `postcss-nested`. * Child nodes array is now in `childs` property, instead of `decls` and `rules`. * `map.inline` and `map.sourcesContent` options are now `true` by default. * Fix iterators (`each`, `insertAfter`) on children array changes. * Use previous source map to show origin source of CSS syntax error. * Use 6to5 ES6 compiler, instead of ES6 Transpiler. * Use code style for manually added rules from existing rules. * Use `from` option from previous source map `file` field. * Set `to` value to `from` if `to` option is missing. * Use better node source name when missing `from` option. * Show a syntax error when `;` is missed between declarations. * Allow to pass `PostCSS` instance or list of plugins to `use()` method. * Allow to pass `Result` instance to `process()` method. * Trim Unicode BOM on source maps parsing. * Parse at-rules without spaces like `@import"file"`. * Better previous `sourceMappingURL` annotation comment cleaning. * Do not remove previous `sourceMappingURL` comment on `map.annotation: false`. * Parse nameless at-rules in Safe Mode. * Fix source map generation for nodes without source. * Fix next child `before` if `Root` first child got removed. ## 2.2.6 * Fix map generation for nodes without source (by Josiah Savary). ## 2.2.5 * Fix source map with BOM marker support (by Mohammad Younes). * Fix source map paths (by Mohammad Younes). ## 2.2.4 * Fix `prepend()` on empty `Root`. ## 2.2.3 * Allow to use object shortcut in `use()` with functions like `autoprefixer`. ## 2.2.2 * Add shortcut to set processors in `use()` via object with `.postcss` property. ## 2.2.1 * Send `opts` from `Processor#process(css, opts)` to processors. ## 2.2 “Marquis Cimeies” * Use GNU style syntax error messages. * Add `Node#replace` method. * Add `CssSyntaxError#reason` property. ## 2.1.2 * Fix UTF-8 support in inline source map. * Fix source map `sourcesContent` if there is no `from` and `to` options. ## 2.1.1 * Allow to miss `to` and `from` options for inline source maps. * Add `Node#source.id` if file name is unknown. * Better detect splitter between rules in CSS concatenation tools. * Automatically clone node in insert methods. ## 2.1 “King Amdusias” * Change Traceur ES6 compiler to ES6 Transpiler. * Show broken CSS line in syntax error. ## 2.0 “King Belial” * Project was rewritten from CoffeeScript to ES6. * Add Safe Mode to works with live input or with hacks from legacy code. * More safer parser to pass all hacks from Browserhacks.com. * Use real properties instead of magic getter/setter for raw properties. ## 1.0 “Marquis Decarabia” * Save previous source map for each node to support CSS concatenation with multiple previous maps. * Add `map.sourcesContent` option to add origin content to `sourcesContent` inside map. * Allow to set different place of output map in annotation comment. * Allow to use arrays and `Root` in `Container#append` and same methods. * Add `Root#prevMap` with information about previous map. * Allow to use latest PostCSS from GitHub by npm. * `Result` now is lazy and it will generate output CSS only if you use `css` or `map` property. * Use separated `map.prev` option to set previous map. * Rename `inlineMap` option to `map.inline`. * Rename `mapAnnotation` option to `map.annotation`. * `Result#map` now return `SourceMapGenerator` object, instead of string. * Run previous map autodetect only if input CSS contains annotation comment. * Add `map: 'inline'` shortcut for `map: { inline: true }` option. * `Node#source.file` now will contains absolute path. * Clean `Declaration#between` style on node clone. ## 0.3.5 * Allow to use `Root` or `Result` as first argument in `process()`. * Save parsed AST to `Result#root`. ## 0.3.4 * Better space symbol detect to read UTF-8 BOM correctly. ## 0.3.3 * Remove source map hacks by using new Mozilla’s `source-map` (by Simon Lydell). ## 0.3.2 * Add URI encoding support for inline source maps. ## 0.3.1 * Fix relative paths from previous source map. * Safer space split in `Rule#selectors` (by Simon Lydell). ## 0.3 “Prince Seere” * Add `Comment` node for comments between declarations or rules. * Add source map annotation comment to output CSS. * Allow to inline source map to annotation comment by data:uri. * Fix source maps on Windows. * Fix source maps for subdirectory (by Dmitry Nikitenko and Simon Lydell). * Autodetect previous source map. * Add `first` and `last` shortcuts to container nodes. * Parse `!important` to separated property in `Declaration`. * Allow to break iteration by returning `false`. * Copy code style to new nodes. * Add `eachInside` method to recursively iterate all nodes. * Add `selectors` shortcut to get selectors array. * Add `toResult` method to `Rule` to simplify work with several input files. * Clean declaration’s `value`, rule’s `selector` and at-rule’s `params` by storing spaces in `between` property. ## 0.2 “Duke Dantalion” * Add source map support. * Add shortcuts to create nodes. * Method `process()` now returns object with `css` and `map` keys. * Origin CSS file option was renamed from `file` to `from`. * Rename `Node#remove()` method to `removeSelf()` to fix name conflict. * Node source was moved to `source` property with origin file and node end position. * You can set own CSS generate function. ## 0.1 “Count Andromalius” * Initial release. postcss-6.0.23/CONTRIBUTING.md000066400000000000000000000045061331277006000155350ustar00rootroot00000000000000# Contributing Guide to PostCSS If you want contribute to PostCSS, there are few things that you should be familiar with. ## In Case You Have Question About Using PostCSS * **Ask for help in [the chat]** If you stuck on something there is a big chance that someone had similar problem before. [the chat]: https://gitter.im/postcss/postcss ## Adding Your Plugin to the List If you created or found a plugin and want to add it to PostCSS plugins list follow this simple steps. PR should not change plugins defined in README it contains only favorite plugins and moderated by PostCSS author. Plugins submitted by community located in [`docs/plugins`]. * **Keep plugins order** Be sure that plugin not presented yet and find suitable position in alphabetic order for it. But plugins with `postcss-` prefix should come first. * **Check spelling** Before submitting PR be sure that spelling check pass. For that run command `npm test`. If it fails with unknown word error, add it as word to `.yaspellerrc` dictionary. * **Check PostCSS plugin guideline** Provided plugin should match plugin [guidelines]. - **Provide link to suggested plugin** Make sure your pull request description contains link to plugin you are willing to add. [`docs/plugins`]: https://github.com/postcss/postcss/blob/master/docs/plugins.md [guidelines]: https://github.com/postcss/postcss/blob/master/docs/guidelines/plugin.md ## TypeScript Declaration Improvements If you found a bug or want to add certain improvements to types declaration file * **Check current TypeScript styling** Be sure that your changes match TypeScript styling rules defined in typings file. * We use classes for existing JS classes like `Stringifier`. * Namespaces used for separating functions related to same subject. * Interfaces used for defining custom types. Make sure you read through declaration file writing [best practices] by TypeScript team. [best practices]: https://www.typescriptlang.org/docs/handbook/declaration-files/do-s-and-don-ts.html ## Core Development If you want to add new feature or fix existed issue - **Become familiar with PostCSS architecture** For gentle intro to PostCSS architecture look through our [guide]. [guide]: https://github.com/postcss/postcss/blob/master/docs/architecture.md postcss-6.0.23/LICENSE000066400000000000000000000021071331277006000143040ustar00rootroot00000000000000The MIT License (MIT) Copyright 2013 Andrey Sitnik Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. postcss-6.0.23/README-cn.md000066400000000000000000000355401331277006000151630ustar00rootroot00000000000000# PostCSS [![Gitter][chat-img]][chat] 哲学家的石头 - PostCSS 的 logo [chat-img]: https://img.shields.io/badge/Gitter-Join_the_PostCSS_chat-brightgreen.svg [chat]: https://gitter.im/postcss/postcss PostCSS 是一个允许使用 JS 插件转换样式的工具。 这些插件可以检查(lint)你的 CSS,支持 CSS Variables 和 Mixins, 编译尚未被浏览器广泛支持的先进的 CSS 语法,内联图片,以及其它很多优秀的功能。 PostCSS 在工业界被广泛地应用,其中不乏很多有名的行业领导者,如:维基百科,Twitter,阿里巴巴, JetBrains。PostCSS 的 [Autoprefixer] 插件是最流行的 CSS 处理工具之一。 PostCSS 接收一个 CSS 文件并提供了一个 API 来分析、修改它的规则(通过把 CSS 规则转换成一个[抽象语法树]的方式)。在这之后,这个 API 便可被许多[插件]利用来做有用的事情,比如寻错或自动添加 CSS vendor 前缀。 **Twitter 账号:** [@postcss](https://twitter.com/postcss)
**支持 / 讨论:** [Gitter](https://gitter.im/postcss/postcss)
如果需要 PostCSS 商业支持(如咨询,提升公司的前端文化, PostCSS 插件),请联系 [Evil Martians](https://evilmartians.com/?utm_source=postcss) 邮箱 。 [抽象语法树]: https://zh.wikipedia.org/wiki/%E6%8A%BD%E8%B1%A1%E8%AA%9E%E6%B3%95%E6%A8%B9 [Autoprefixer]: https://github.com/postcss/autoprefixer [插件]: https://github.com/postcss/postcss/blob/master/README-cn.md#%E6%8F%92%E4%BB%B6 由 Evil Martians 赞助 ## 插件 截止到目前,PostCSS 有 200 多个插件。你可以在 [插件列表] 或 [搜索目录] 找到它们。 下方的列表是我们最喜欢的插件 - 它们很好地演示了我们可以用 PostCSS 做些什么。 如果你有任何新的想法,[开发 PostCSS 插件] 非常简单易上手。 [搜索目录]: http://postcss.parts [插件列表]: https://github.com/postcss/postcss/blob/master/docs/plugins.md ### 解决全局 CSS 的问题 * [`postcss-use`] 允许你在 CSS 里明确地设置 PostCSS 插件,并且只在当前文件执行它们。 * [`postcss-modules`] 和 [`react-css-modules`] 可以自动以组件为单位隔绝 CSS 选择器。 * [`postcss-autoreset`] 是全局样式重置的又一个选择,它更适用于分离的组件。 * [`postcss-initial`] 添加了 `all: initial` 的支持,重置了所有继承的样式。 * [`cq-prolyfill`] 添加了容器查询的支持,允许添加响应于父元素宽度的样式. ### 提前使用先进的 CSS 特性 * [`autoprefixer`] 添加了 vendor 浏览器前缀,它使用 Can I Use 上面的数据。 * [`postcss-preset-env`] 允许你使用未来的 CSS 特性。 ### 更佳的 CSS 可读性 * [`precss`] 囊括了许多插件来支持类似 Sass 的特性,比如 CSS 变量,套嵌,mixins 等。 * [`postcss-sorting`] 给规则的内容以及@规则排序。 * [`postcss-utilities`] 囊括了最常用的简写方式和书写帮助。 * [`short`] 添加并拓展了大量的缩写属性。 ### 图片和字体 * [`postcss-assets`] 可以插入图片尺寸和内联文件。 * [`postcss-sprites`] 能生成雪碧图。 * [`font-magician`] 生成所有在 CSS 里需要的 `@font-face` 规则。 * [`postcss-inline-svg`] 允许你内联 SVG 并定制它的样式。 * [`postcss-write-svg`] 允许你在 CSS 里写简单的 SVG。 ### 提示器(Linters) * [`stylelint`] 是一个模块化的样式提示器。 * [`stylefmt`] 是一个能根据 `stylelint` 规则自动优化 CSS 格式的工具。 * [`doiuse`] 提示 CSS 的浏览器支持性,使用的数据来自于 Can I Use。 * [`colorguard`] 帮助你保持一个始终如一的调色板。 ### 其它 * [`postcss-rtl`] 在单个 CSS 文件里组合了两个方向(左到右,右到左)的样式。 * [`cssnano`] 是一个模块化的 CSS 压缩器。 * [`lost`] 是一个功能强大的 `calc()` 栅格系统。 * [`rtlcss`] 镜像翻转 CSS 样式,适用于 right-to-left 的应用场景。 [`postcss-inline-svg`]: https://github.com/TrySound/postcss-inline-svg [`postcss-preset-env`]: https://github.com/jonathantneal/postcss-preset-env [`react-css-modules`]: https://github.com/gajus/react-css-modules [`postcss-autoreset`]: https://github.com/maximkoretskiy/postcss-autoreset [`postcss-write-svg`]: https://github.com/jonathantneal/postcss-write-svg [`postcss-utilities`]: https://github.com/ismamz/postcss-utilities [`postcss-initial`]: https://github.com/maximkoretskiy/postcss-initial [`postcss-sprites`]: https://github.com/2createStudio/postcss-sprites [`postcss-modules`]: https://github.com/outpunk/postcss-modules [`postcss-sorting`]: https://github.com/hudochenkov/postcss-sorting [`postcss-assets`]: https://github.com/assetsjs/postcss-assets [开发 PostCSS 插件]: https://github.com/postcss/postcss/blob/master/docs/writing-a-plugin.md [`font-magician`]: https://github.com/jonathantneal/postcss-font-magician [`autoprefixer`]: https://github.com/postcss/autoprefixer [`cq-prolyfill`]: https://github.com/ausi/cq-prolyfill [`postcss-rtl`]: https://github.com/vkalinichev/postcss-rtl [`postcss-use`]: https://github.com/postcss/postcss-use [`css-modules`]: https://github.com/css-modules/css-modules [`colorguard`]: https://github.com/SlexAxton/css-colorguard [`stylelint`]: https://github.com/stylelint/stylelint [`stylefmt`]: https://github.com/morishitter/stylefmt [`cssnano`]: http://cssnano.co [`precss`]: https://github.com/jonathantneal/precss [`doiuse`]: https://github.com/anandthakker/doiuse [`rtlcss`]: https://github.com/MohammadYounes/rtlcss [`short`]: https://github.com/jonathantneal/postcss-short [`lost`]: https://github.com/peterramsing/lost ## 语法 PostCSS 可以转化样式到任意语法,不仅仅是 CSS。 如果还没有支持你最喜欢的语法,你可以编写一个解释器以及(或者)一个 stringifier 来拓展 PostCSS。 * [`sugarss`] 是一个以缩进为基础的语法,类似于 Sass 和 Stylus。 * [`postcss-syntax`] 通过文件扩展名自动切换语法。 * [`postcss-html`] 解析类 HTML 文件里`