postcss 8.4.29 → 8.4.30

package/README.md

@@ -9,31 +9,20 @@ These plugins can lint your CSS, support variables and mixins,
 transpile future CSS syntax, inline images, and more.
 
 PostCSS is used by industry leaders including Wikipedia, Twitter, Alibaba,
-and JetBrains. The [Autoprefixer] PostCSS plugin is one of the most popular
-CSS processors.
+and JetBrains. The [Autoprefixer] and [Stylelint] PostCSS plugins is one of the most popular CSS tools.
 
-PostCSS takes a CSS file and provides an API to analyze and modify its rules
-(by transforming them into an [Abstract Syntax Tree]).
-This API can then be used by [plugins] to do a lot of useful things,
-e.g., to find errors automatically, or to insert vendor prefixes.
+---
 
-**Twitter account:** [@postcss](https://twitter.com/postcss)<br>
-**中文翻译**:          [`docs/README-cn.md`](./docs/README-cn.md)
+<img src="https://cdn.evilmartians.com/badges/logo-no-label.svg" alt="" width="22" height="16" />  Made in <b><a href="https://evilmartians.com/?utm_source=postcss&utm_campaign=devtools-button&utm_medium=github">Evil Martians</a></b>, product consulting for <b>developer tools</b>.
 
-For PostCSS commercial support (consulting, improving the front-end culture
-of your company, PostCSS plugins), contact [Evil Martians]
-at <postcss@evilmartians.com>.
+---
 
 [Abstract Syntax Tree]: https://en.wikipedia.org/wiki/Abstract_syntax_tree
 [Evil Martians]:        https://evilmartians.com/?utm_source=postcss
 [Autoprefixer]:         https://github.com/postcss/autoprefixer
+[Stylelint]:            https://stylelint.io/
 [plugins]:              https://github.com/postcss/postcss#plugins
 
-<a href="https://evilmartians.com/?utm_source=postcss">
-  <img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg"
-       alt="Sponsored by Evil Martians" width="236" height="54">
-</a>
-
 
 ## Docs
 Read full docs **[here](https://postcss.org/)**.

package/lib/container.d.ts

@@ -125,15 +125,6 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
   every(
     condition: (node: Child, index: number, nodes: Child[]) => boolean
   ): boolean
-  /**
-   * The container’s first child.
-   *
-   * ```js
-   * rule.first === rules.nodes[0]
-   * ```
-   */
-  get first(): Child | undefined
-
   /**
    * Returns a `child`’s index within the `Container#nodes` array.
    *
@@ -145,6 +136,7 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
    * @return Child index.
    */
   index(child: Child | number): number
+
   /**
    * Insert new node after old node within the container.
    *
@@ -156,24 +148,6 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
     oldNode: Child | number,
     newNode: Child | Child[] | ChildProps | ChildProps[] | string | string[]
   ): this
-
-  /**
-   * Traverses the container’s descendant nodes, calling callback
-   * for each comment node.
-   *
-   * Like `Container#each`, this method is safe
-   * to use if you are mutating arrays during iteration.
-   *
-   * ```js
-   * root.walkComments(comment => {
-   *   comment.remove()
-   * })
-   * ```
-   *
-   * @param callback Iterator receives each node and index.
-   * @return Returns `false` if iteration was broke.
-   */
-
   /**
    * Insert new node before old node within the container.
    *
@@ -189,14 +163,23 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
     oldNode: Child | number,
     newNode: Child | Child[] | ChildProps | ChildProps[] | string | string[]
   ): this
+
   /**
-   * The container’s last child.
+   * Traverses the container’s descendant nodes, calling callback
+   * for each comment node.
+   *
+   * Like `Container#each`, this method is safe
+   * to use if you are mutating arrays during iteration.
    *
    * ```js
-   * rule.last === rule.nodes[rule.nodes.length - 1]
+   * root.walkComments(comment => {
+   *   comment.remove()
+   * })
    * ```
+   *
+   * @param callback Iterator receives each node and index.
+   * @return Returns `false` if iteration was broke.
    */
-  get last(): Child | undefined
 
   /**
    * Inserts new nodes to the start of the container.
@@ -221,7 +204,6 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
   prepend(
     ...nodes: (ChildProps | ChildProps[] | Node | Node[] | string | string[])[]
   ): this
-
   /**
    * Add child to the end of the node.
    *
@@ -334,6 +316,7 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
   walk(
     callback: (node: ChildNode, index: number) => false | void
   ): false | undefined
+
   /**
    * Traverses the container’s descendant nodes, calling callback
    * for each at-rule node.
@@ -371,7 +354,6 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
   walkAtRules(
     callback: (atRule: AtRule, index: number) => false | void
   ): false | undefined
-
   walkComments(
     callback: (comment: Comment, indexed: number) => false | void
   ): false | undefined
@@ -413,9 +395,11 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
     propFilter: RegExp | string,
     callback: (decl: Declaration, index: number) => false | void
   ): false | undefined
+
   walkDecls(
     callback: (decl: Declaration, index: number) => false | void
   ): false | undefined
+
   /**
    * Traverses the container’s descendant nodes, calling callback
    * for each rule node.
@@ -445,6 +429,22 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
   walkRules(
     callback: (rule: Rule, index: number) => false | void
   ): false | undefined
+  /**
+   * The container’s first child.
+   *
+   * ```js
+   * rule.first === rules.nodes[0]
+   * ```
+   */
+  get first(): Child | undefined
+  /**
+   * The container’s last child.
+   *
+   * ```js
+   * rule.last === rule.nodes[rule.nodes.length - 1]
+   * ```
+   */
+  get last(): Child | undefined
 }
 
 declare class Container<Child extends Node = ChildNode> extends Container_<Child> {}

package/lib/container.js

@@ -64,11 +64,6 @@ class Container extends Node {
     return this.nodes.every(condition)
   }
 
-  get first() {
-    if (!this.proxyOf.nodes) return undefined
-    return this.proxyOf.nodes[0]
-  }
-
   getIterator() {
     if (!this.lastEach) this.lastEach = 0
     if (!this.indexes) this.indexes = {}
@@ -175,11 +170,6 @@ class Container extends Node {
     return this
   }
 
-  get last() {
-    if (!this.proxyOf.nodes) return undefined
-    return this.proxyOf.nodes[this.proxyOf.nodes.length - 1]
-  }
-
   normalize(nodes, sample) {
     if (typeof nodes === 'string') {
       nodes = cleanSource(parse(nodes).nodes)
@@ -393,6 +383,16 @@ class Container extends Node {
       }
     })
   }
+
+  get first() {
+    if (!this.proxyOf.nodes) return undefined
+    return this.proxyOf.nodes[0]
+  }
+
+  get last() {
+    if (!this.proxyOf.nodes) return undefined
+    return this.proxyOf.nodes[this.proxyOf.nodes.length - 1]
+  }
 }
 
 Container.registerParse = dependant => {

package/lib/input.d.ts

@@ -143,19 +143,6 @@ declare class Input_ {
     opts?: { plugin?: CssSyntaxError['plugin'] }
   ): CssSyntaxError
 
-  /**
-   * The CSS source identifier. Contains `Input#file` if the user
-   * set the `from` option, or `Input#id` if they did not.
-   *
-   * ```js
-   * const root = postcss.parse(css, { from: 'a.css' })
-   * root.source.input.from //=> "/home/ai/a.css"
-   *
-   * const root = postcss.parse(css)
-   * root.source.input.from //=> "<input css 1>"
-   * ```
-   */
-  get from(): string
   /**
    * Converts source offset to line and column.
    *
@@ -187,6 +174,19 @@ declare class Input_ {
     endLine?: number,
     endColumn?: number
   ): false | Input.FilePosition
+  /**
+   * The CSS source identifier. Contains `Input#file` if the user
+   * set the `from` option, or `Input#id` if they did not.
+   *
+   * ```js
+   * const root = postcss.parse(css, { from: 'a.css' })
+   * root.source.input.from //=> "/home/ai/a.css"
+   *
+   * const root = postcss.parse(css)
+   * root.source.input.from //=> "<input css 1>"
+   * ```
+   */
+  get from(): string
 }
 
 declare class Input extends Input_ {}

package/lib/input.js

@@ -124,10 +124,6 @@ class Input {
     return result
   }
 
-  get from() {
-    return this.file || this.id
-  }
-
   fromOffset(offset) {
     let lastLine, lineToIndex
     if (!this[fromOffsetCache]) {
@@ -238,6 +234,10 @@ class Input {
     }
     return json
   }
+
+  get from() {
+    return this.file || this.id
+  }
 }
 
 module.exports = Input

package/lib/lazy-result.d.ts

@@ -81,6 +81,32 @@ declare class LazyResult_<RootNode = Document | Root>
    */
   async(): Promise<Result<RootNode>>
 
+  /**
+   * Run plugin in sync way and return `Result`.
+   *
+   * @return Result with output content.
+   */
+  sync(): Result<RootNode>
+
+  /**
+   * Alias for the `LazyResult#css` property.
+   *
+   * ```js
+   * lazy + '' === lazy.css
+   * ```
+   *
+   * @return Output CSS.
+   */
+  toString(): string
+
+  /**
+   * Processes input CSS through synchronous plugins
+   * and calls `Result#warnings`.
+   *
+   * @return Warnings from plugins.
+   */
+  warnings(): Warning[]
+
   /**
    * An alias for the `css` property. Use it with syntaxes
    * that generate non-CSS output.
@@ -155,32 +181,6 @@ declare class LazyResult_<RootNode = Document | Root>
    * Required to implement the Promise interface.
    */
   get [Symbol.toStringTag](): string
-
-  /**
-   * Run plugin in sync way and return `Result`.
-   *
-   * @return Result with output content.
-   */
-  sync(): Result<RootNode>
-
-  /**
-   * Alias for the `LazyResult#css` property.
-   *
-   * ```js
-   * lazy + '' === lazy.css
-   * ```
-   *
-   * @return Output CSS.
-   */
-  toString(): string
-
-  /**
-   * Processes input CSS through synchronous plugins
-   * and calls `Result#warnings`.
-   *
-   * @return Warnings from plugins.
-   */
-  warnings(): Warning[]
 }
 
 declare class LazyResult<

package/lib/lazy-result.js

@@ -166,14 +166,6 @@ class LazyResult {
     return this.async().catch(onRejected)
   }
 
-  get content() {
-    return this.stringify().content
-  }
-
-  get css() {
-    return this.stringify().css
-  }
-
   finally(onFinally) {
     return this.async().then(onFinally, onFinally)
   }
@@ -221,18 +213,6 @@ class LazyResult {
     return error
   }
 
-  get map() {
-    return this.stringify().map
-  }
-
-  get messages() {
-    return this.sync().messages
-  }
-
-  get opts() {
-    return this.result.opts
-  }
-
   prepareVisitors() {
     this.listeners = {}
     let add = (plugin, type, cb) => {
@@ -271,14 +251,6 @@ class LazyResult {
     this.hasListener = Object.keys(this.listeners).length > 0
   }
 
-  get processor() {
-    return this.result.processor
-  }
-
-  get root() {
-    return this.sync().root
-  }
-
   async runAsync() {
     this.plugin = 0
     for (let i = 0; i < this.plugins.length; i++) {
@@ -382,10 +354,6 @@ class LazyResult {
     return this.result
   }
 
-  get [Symbol.toStringTag]() {
-    return 'LazyResult'
-  }
-
   sync() {
     if (this.error) throw this.error
     if (this.processed) return this.result
@@ -537,6 +505,38 @@ class LazyResult {
   warnings() {
     return this.sync().warnings()
   }
+
+  get content() {
+    return this.stringify().content
+  }
+
+  get css() {
+    return this.stringify().css
+  }
+
+  get map() {
+    return this.stringify().map
+  }
+
+  get messages() {
+    return this.sync().messages
+  }
+
+  get opts() {
+    return this.result.opts
+  }
+
+  get processor() {
+    return this.result.processor
+  }
+
+  get root() {
+    return this.sync().root
+  }
+
+  get [Symbol.toStringTag]() {
+    return 'LazyResult'
+  }
 }
 
 LazyResult.registerPostcss = dependant => {

package/lib/map-generator.js

@@ -17,6 +17,10 @@ class MapGenerator {
     this.opts = opts
     this.css = cssString
     this.usesFileUrls = !this.mapOpts.from && this.mapOpts.absolute
+
+    this.memoizedFileURLs = new Map()
+    this.memoizedPaths = new Map()
+    this.memoizedURLs = new Map()
   }
 
   addAnnotation() {
@@ -241,9 +245,11 @@ class MapGenerator {
   }
 
   path(file) {
-    if (file.indexOf('<') === 0) return file
-    if (/^\w+:\/\//.test(file)) return file
     if (this.mapOpts.absolute) return file
+    if (file.charCodeAt(0) === 60 /* `<` */) return file
+    if (/^\w+:\/\//.test(file)) return file
+    let cached = this.memoizedPaths.get(file)
+    if (cached) return cached
 
     let from = this.opts.to ? dirname(this.opts.to) : '.'
 
@@ -251,8 +257,10 @@ class MapGenerator {
       from = dirname(resolve(from, this.mapOpts.annotation))
     }
 
-    file = relative(from, file)
-    return file
+    let path = relative(from, file)
+    this.memoizedPaths.set(file, path)
+
+    return path
   }
 
   previous() {
@@ -318,8 +326,14 @@ class MapGenerator {
   }
 
   toFileUrl(path) {
+    let cached = this.memoizedFileURLs.get(path)
+    if (cached) return cached
+
     if (pathToFileURL) {
-      return pathToFileURL(path).toString()
+      let fileURL = pathToFileURL(path).toString()
+      this.memoizedFileURLs.set(path, fileURL)
+
+      return fileURL
     } else {
       throw new Error(
         '`map.absolute` option is not available in this PostCSS build'
@@ -328,10 +342,17 @@ class MapGenerator {
   }
 
   toUrl(path) {
+    let cached = this.memoizedURLs.get(path)
+    if (cached) return cached
+
     if (sep === '\\') {
       path = path.replace(/\\/g, '/')
     }
-    return encodeURI(path).replace(/[#?]/g, encodeURIComponent)
+
+    let url = encodeURI(path).replace(/[#?]/g, encodeURIComponent)
+    this.memoizedURLs.set(path, url)
+
+    return url
   }
 }
 

package/lib/no-work-result.d.ts

@@ -28,6 +28,9 @@ declare class NoWorkResult_ implements LazyResult<Root> {
   then: Promise<Result<Root>>['then']
   constructor(processor: Processor, css: string, opts: ResultOptions)
   async(): Promise<Result<Root>>
+  sync(): Result<Root>
+  toString(): string
+  warnings(): Warning[]
   get content(): string
   get css(): string
   get map(): SourceMap
@@ -36,9 +39,6 @@ declare class NoWorkResult_ implements LazyResult<Root> {
   get processor(): Processor
   get root(): Root
   get [Symbol.toStringTag](): string
-  sync(): Result<Root>
-  toString(): string
-  warnings(): Warning[]
 }
 
 declare class NoWorkResult extends NoWorkResult_ {}

package/lib/no-work-result.js

@@ -49,6 +49,37 @@ class NoWorkResult {
     return this.async().catch(onRejected)
   }
 
+  finally(onFinally) {
+    return this.async().then(onFinally, onFinally)
+  }
+
+  sync() {
+    if (this.error) throw this.error
+    return this.result
+  }
+
+  then(onFulfilled, onRejected) {
+    if (process.env.NODE_ENV !== 'production') {
+      if (!('from' in this._opts)) {
+        warnOnce(
+          'Without `from` option PostCSS could generate wrong source map ' +
+            'and will not find Browserslist config. Set it to CSS file path ' +
+            'or to `undefined` to prevent this warning.'
+        )
+      }
+    }
+
+    return this.async().then(onFulfilled, onRejected)
+  }
+
+  toString() {
+    return this._css
+  }
+
+  warnings() {
+    return []
+  }
+
   get content() {
     return this.result.css
   }
@@ -57,10 +88,6 @@ class NoWorkResult {
     return this.result.css
   }
 
-  finally(onFinally) {
-    return this.async().then(onFinally, onFinally)
-  }
-
   get map() {
     return this.result.map
   }
@@ -102,33 +129,6 @@ class NoWorkResult {
   get [Symbol.toStringTag]() {
     return 'NoWorkResult'
   }
-
-  sync() {
-    if (this.error) throw this.error
-    return this.result
-  }
-
-  then(onFulfilled, onRejected) {
-    if (process.env.NODE_ENV !== 'production') {
-      if (!('from' in this._opts)) {
-        warnOnce(
-          'Without `from` option PostCSS could generate wrong source map ' +
-            'and will not find Browserslist config. Set it to CSS file path ' +
-            'or to `undefined` to prevent this warning.'
-        )
-      }
-    }
-
-    return this.async().then(onFulfilled, onRejected)
-  }
-
-  toString() {
-    return this._css
-  }
-
-  warnings() {
-    return []
-  }
 }
 
 module.exports = NoWorkResult

package/lib/node.js

@@ -204,10 +204,6 @@ class Node {
     return this.parent.nodes[index - 1]
   }
 
-  get proxyOf() {
-    return this
-  }
-
   rangeBy(opts) {
     let start = {
       column: this.source.start.column,
@@ -375,6 +371,10 @@ class Node {
     for (let i in opts) data[i] = opts[i]
     return result.warn(text, data)
   }
+
+  get proxyOf() {
+    return this
+  }
 }
 
 module.exports = Node

package/lib/processor.js

@@ -7,7 +7,7 @@ let Root = require('./root')
 
 class Processor {
   constructor(plugins = []) {
-    this.version = '8.4.29'
+    this.version = '8.4.30'
     this.plugins = this.normalize(plugins)
   }
 

package/lib/result.d.ts

@@ -150,16 +150,6 @@ declare class Result_<RootNode = Document | Root> {
    */
   constructor(processor: Processor, root: RootNode, opts: Result.ResultOptions)
 
-  /**
-   * An alias for the `Result#css` property.
-   * Use it with syntaxes that generate non-CSS output.
-   *
-   * ```js
-   * result.css === result.content
-   * ```
-   */
-  get content(): string
-
   /**
    * Returns for `Result#css` content.
    *
@@ -199,6 +189,16 @@ declare class Result_<RootNode = Document | Root> {
    * @return Warnings from plugins.
    */
   warnings(): Warning[]
+
+  /**
+   * An alias for the `Result#css` property.
+   * Use it with syntaxes that generate non-CSS output.
+   *
+   * ```js
+   * result.css === result.content
+   * ```
+   */
+  get content(): string
 }
 
 declare class Result<RootNode = Document | Root> extends Result_<RootNode> {}

package/lib/result.js

@@ -12,10 +12,6 @@ class Result {
     this.map = undefined
   }
 
-  get content() {
-    return this.css
-  }
-
   toString() {
     return this.css
   }
@@ -36,6 +32,10 @@ class Result {
   warnings() {
     return this.messages.filter(i => i.type === 'warning')
   }
+
+  get content() {
+    return this.css
+  }
 }
 
 module.exports = Result

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postcss",
-  "version": "8.4.29",
+  "version": "8.4.30",
   "description": "Tool for transforming styles with JS plugins",
   "engines": {
     "node": "^10 || ^12 || >=14"