postcss 8.4.25 → 8.4.27

package/README.md

@@ -1,12 +1,9 @@
-# PostCSS [![Gitter][chat-img]][chat]
+# PostCSS
 
 <img align="right" width="95" height="95"
      alt="Philosopher’s stone, logo of PostCSS"
      src="https://postcss.org/logo.svg">
 
-[chat-img]: https://img.shields.io/badge/Gitter-Join_the_PostCSS_chat-brightgreen.svg
-[chat]:     https://gitter.im/postcss/postcss
-
 PostCSS is a tool for transforming styles with JS plugins.
 These plugins can lint your CSS, support variables and mixins,
 transpile future CSS syntax, inline images, and more.
@@ -20,10 +17,8 @@ PostCSS takes a CSS file and provides an API to analyze and modify its rules
 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.
 
-**Support / Discussion:** [Gitter](https://gitter.im/postcss/postcss)<br>
-**Twitter account:**      [@postcss](https://twitter.com/postcss)<br>
-**VK.com page:**          [postcss](https://vk.com/postcss)<br>
-**中文翻译**:              [`docs/README-cn.md`](./docs/README-cn.md)
+**Twitter account:** [@postcss](https://twitter.com/postcss)<br>
+**中文翻译**:          [`docs/README-cn.md`](./docs/README-cn.md)
 
 For PostCSS commercial support (consulting, improving the front-end culture
 of your company, PostCSS plugins), contact [Evil Martians]

package/lib/at-rule.d.ts

@@ -105,9 +105,9 @@ declare class AtRule_ extends Container {
 
   constructor(defaults?: AtRule.AtRuleProps)
   assign(overrides: AtRule.AtRuleProps | object): this
-  clone(overrides?: Partial<AtRule.AtRuleProps>): this
-  cloneAfter(overrides?: Partial<AtRule.AtRuleProps>): this
-  cloneBefore(overrides?: Partial<AtRule.AtRuleProps>): this
+  clone(overrides?: Partial<AtRule.AtRuleProps>): AtRule
+  cloneAfter(overrides?: Partial<AtRule.AtRuleProps>): AtRule
+  cloneBefore(overrides?: Partial<AtRule.AtRuleProps>): AtRule
 }
 
 declare class AtRule extends AtRule_ {}

package/lib/comment.d.ts

@@ -57,9 +57,9 @@ declare class Comment_ extends Node {
 
   constructor(defaults?: Comment.CommentProps)
   assign(overrides: Comment.CommentProps | object): this
-  clone(overrides?: Partial<Comment.CommentProps>): this
-  cloneAfter(overrides?: Partial<Comment.CommentProps>): this
-  cloneBefore(overrides?: Partial<Comment.CommentProps>): this
+  clone(overrides?: Partial<Comment.CommentProps>): Comment
+  cloneAfter(overrides?: Partial<Comment.CommentProps>): Comment
+  cloneBefore(overrides?: Partial<Comment.CommentProps>): Comment
 }
 
 declare class Comment extends Comment_ {}

package/lib/container.d.ts

@@ -32,9 +32,7 @@ declare namespace Container {
  * Note that all containers can store any content. If you write a rule inside
  * a rule, PostCSS will parse it.
  */
-declare abstract class Container_<
-  Child extends Node = ChildNode
-> extends Node {
+declare abstract class Container_<Child extends Node = ChildNode> extends Node {
   /**
    * An array containing the container’s children.
    *
@@ -71,6 +69,11 @@ declare abstract class Container_<
     ...nodes: (ChildProps | ChildProps[] | Node | Node[] | string | string[])[]
   ): this
 
+  assign(overrides: Container.ContainerProps | object): this
+  clone(overrides?: Partial<Container.ContainerProps>): Container<Child>
+  cloneAfter(overrides?: Partial<Container.ContainerProps>): Container<Child>
+  cloneBefore(overrides?: Partial<Container.ContainerProps>): Container<Child>
+
   /**
    * Iterates through the container’s immediate children,
    * calling `callback` for each child.
@@ -122,7 +125,6 @@ declare abstract class Container_<
   every(
     condition: (node: Child, index: number, nodes: Child[]) => boolean
   ): boolean
-
   /**
    * The container’s first child.
    *
@@ -155,6 +157,23 @@ declare abstract class Container_<
     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.
    *
@@ -202,6 +221,7 @@ declare abstract class Container_<
   prepend(
     ...nodes: (ChildProps | ChildProps[] | Node | Node[] | string | string[])[]
   ): this
+
   /**
    * Add child to the end of the node.
    *
@@ -214,23 +234,6 @@ declare abstract class Container_<
    */
   push(child: Child): 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.
-   */
-
   /**
    * Removes all children from the container
    * and cleans their parent properties.
@@ -243,6 +246,7 @@ declare abstract class Container_<
    * @return This node for methods chain.
    */
   removeAll(): this
+
   /**
    * Removes node from the container and cleans the parent properties
    * from the node and its children.
@@ -259,6 +263,11 @@ declare abstract class Container_<
    */
   removeChild(child: Child | number): this
 
+  replaceValues(
+    pattern: RegExp | string,
+    replaced: { (substring: string, ...args: any[]): string } | string
+  ): this
+
   /**
    * Passes all declaration values within the container that match pattern
    * through callback, replacing those values with the returned result
@@ -288,11 +297,6 @@ declare abstract class Container_<
     replaced: { (substring: string, ...args: any[]): string } | string
   ): this
 
-  replaceValues(
-    pattern: RegExp | string,
-    replaced: { (substring: string, ...args: any[]): string } | string
-  ): this
-
   /**
    * Returns `true` if callback returns `true` for (at least) one
    * of the container’s children.
@@ -330,11 +334,6 @@ declare abstract class Container_<
   walk(
     callback: (node: ChildNode, index: number) => false | void
   ): false | undefined
-
-  walkAtRules(
-    callback: (atRule: AtRule, index: number) => false | void
-  ): false | undefined
-
   /**
    * Traverses the container’s descendant nodes, calling callback
    * for each at-rule node.
@@ -369,6 +368,10 @@ declare abstract class Container_<
     callback: (atRule: AtRule, index: number) => false | void
   ): false | undefined
 
+  walkAtRules(
+    callback: (atRule: AtRule, index: number) => false | void
+  ): false | undefined
+
   walkComments(
     callback: (comment: Comment, indexed: number) => false | void
   ): false | undefined
@@ -376,9 +379,6 @@ declare abstract class Container_<
   walkComments(
     callback: (comment: Comment, indexed: number) => false | void
   ): false | undefined
-  walkDecls(
-    callback: (decl: Declaration, index: number) => false | void
-  ): false | undefined
 
   /**
    * Traverses the container’s descendant nodes, calling callback
@@ -413,11 +413,9 @@ declare abstract class Container_<
     propFilter: RegExp | string,
     callback: (decl: Declaration, index: number) => false | void
   ): false | undefined
-
-  walkRules(
-    callback: (rule: Rule, index: number) => false | void
+  walkDecls(
+    callback: (decl: Declaration, index: number) => false | void
   ): false | undefined
-
   /**
    * Traverses the container’s descendant nodes, calling callback
    * for each rule node.
@@ -444,6 +442,9 @@ declare abstract class Container_<
     selectorFilter: RegExp | string,
     callback: (rule: Rule, index: number) => false | void
   ): false | undefined
+  walkRules(
+    callback: (rule: Rule, index: number) => false | void
+  ): false | undefined
 }
 
 declare class Container<Child extends Node = ChildNode> extends Container_<Child> {}

package/lib/declaration.d.ts

@@ -58,8 +58,8 @@ declare namespace Declaration {
  * const root = postcss.parse('a { color: black }')
  * const decl = root.first?.first
  *
- * console.log(decl.type)       //=> 'decl'
- * console.log(decl.toString()) //=> ' color: black'
+ * decl.type       //=> 'decl'
+ * decl.toString() //=> ' color: black'
  * ```
  */
 declare class Declaration_ extends Node {
@@ -73,20 +73,22 @@ declare class Declaration_ extends Node {
    * ```js
    * const root = postcss.parse('a { color: black !important; color: red }')
    *
-   * console.log(root.first?.first?.important) //=> true
-   * console.log(root.first?.last?.important)  //=> undefined
+   * root.first.first.important //=> true
+   * root.first.last.important  //=> undefined
    * ```
    */
   important: boolean
+
   parent: Container | undefined
+
   /**
    * The property name for a CSS declaration.
    *
    * ```js
    * const root = postcss.parse('a { color: black }')
-   * const decl = root.first?.first
+   * const decl = root.first.first
    *
-   * console.log(decl.prop) //=> 'color'
+   * decl.prop //=> 'color'
    * ```
    */
   prop: string
@@ -107,9 +109,9 @@ declare class Declaration_ extends Node {
    *
    * ```js
    * const root = postcss.parse('a { color: black }')
-   * const decl = root.first?.first
+   * const decl = root.first.first
    *
-   * console.log(decl.value) //=> 'black'
+   * decl.value //=> 'black'
    * ```
    */
   value: string
@@ -120,25 +122,25 @@ declare class Declaration_ extends Node {
    *
    * ```js
    * const root = postcss.parse(':root { --one: 1 }')
-   * const one = root.first?.first
+   * const one = root.first.first
    *
-   * console.log(one?.variable) //=> true
+   * one.variable //=> true
    * ```
    *
    * ```js
    * const root = postcss.parse('$one: 1')
    * const one = root.first
    *
-   * console.log(one?.variable) //=> true
+   * one.variable //=> true
    * ```
    */
   variable: boolean
 
   constructor(defaults?: Declaration.DeclarationProps)
   assign(overrides: Declaration.DeclarationProps | object): this
-  clone(overrides?: Partial<Declaration.DeclarationProps>): this
-  cloneAfter(overrides?: Partial<Declaration.DeclarationProps>): this
-  cloneBefore(overrides?: Partial<Declaration.DeclarationProps>): this
+  clone(overrides?: Partial<Declaration.DeclarationProps>): Declaration
+  cloneAfter(overrides?: Partial<Declaration.DeclarationProps>): Declaration
+  cloneBefore(overrides?: Partial<Declaration.DeclarationProps>): Declaration
 }
 
 declare class Declaration extends Declaration_ {}

package/lib/document.d.ts

@@ -40,6 +40,11 @@ declare class Document_ extends Container<Root> {
 
   constructor(defaults?: Document.DocumentProps)
 
+  assign(overrides: Document.DocumentProps | object): this
+  clone(overrides?: Partial<Document.DocumentProps>): Document
+  cloneAfter(overrides?: Partial<Document.DocumentProps>): Document
+  cloneBefore(overrides?: Partial<Document.DocumentProps>): Document
+
   /**
    * Returns a `Result` instance representing the document’s CSS roots.
    *

package/lib/node.d.ts

@@ -128,7 +128,7 @@ declare abstract class Node_ {
    * It represents parent of the current node.
    *
    * ```js
-   * console.log(root.nodes[0].parent === root) //=> true
+   * root.nodes[0].parent === root //=> true
    * ```
    */
   parent: Container | Document | undefined
@@ -164,7 +164,7 @@ declare abstract class Node_ {
    *
    * ```js
    * const root = postcss.parse('a {\n  color:black\n}')
-   * console.log(root.first.first.raws) //=> { before: '\n  ', between: ':' }
+   * root.first.first.raws //=> { before: '\n  ', between: ':' }
    * ```
    */
   raws: any
@@ -183,9 +183,9 @@ declare abstract class Node_ {
    * source to a node created manually.
    *
    * ```js
-   * console.log(decl.source.input.from) //=> '/home/ai/source.css'
-   * console.log(decl.source.start)      //=> { line: 10, column: 2 }
-   * console.log(decl.source.end)        //=> { line: 10, column: 12 }
+   * decl.source.input.from //=> '/home/ai/source.css'
+   * decl.source.start      //=> { line: 10, column: 2 }
+   * decl.source.end        //=> { line: 10, column: 12 }
    * ```
    *
    * ```js
@@ -227,7 +227,7 @@ declare abstract class Node_ {
    *   value: 'black'
    * })
    *
-   * console.log(declaration.type) //=> 'decl'
+   * declaration.type //=> 'decl'
    * ```
    */
   type: string
@@ -303,7 +303,7 @@ declare abstract class Node_ {
    *
    * @return Duplicate of the node instance.
    */
-  clone(overrides?: object): Node_
+  clone(overrides?: object): Node
 
   /**
    * Shortcut to clone the node and insert the resulting cloned node
@@ -312,7 +312,7 @@ declare abstract class Node_ {
    * @param overrides New properties to override in the clone.
    * @return New node.
    */
-  cloneAfter(overrides?: object): this
+  cloneAfter(overrides?: object): Node
 
   /**
    * Shortcut to clone the node and insert the resulting cloned node
@@ -326,7 +326,7 @@ declare abstract class Node_ {
    *
    * @return New node
    */
-  cloneBefore(overrides?: object): this
+  cloneBefore(overrides?: object): Node
 
   /**
    * It creates an instance of the class `CssSyntaxError` and parameters passed
@@ -502,7 +502,7 @@ declare abstract class Node_ {
    * depending on it's type.
    *
    * ```js
-   * console.log(new Rule({ selector: 'a' }).toString()) //=> "a {}"
+   * new Rule({ selector: 'a' }).toString() //=> "a {}"
    * ```
    *
    * @param stringifier A syntax to use in string generation.

package/lib/processor.js

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

package/lib/root.d.ts

@@ -61,6 +61,10 @@ declare class Root_ extends Container {
   constructor(defaults?: Root.RootProps)
 
   assign(overrides: object | Root.RootProps): this
+  clone(overrides?: Partial<Root.RootProps>): Root
+  cloneAfter(overrides?: Partial<Root.RootProps>): Root
+  cloneBefore(overrides?: Partial<Root.RootProps>): Root
+
   /**
    * Returns a `Result` instance representing the root’s CSS.
    *
@@ -74,7 +78,7 @@ declare class Root_ extends Container {
    * @param opts Options.
    * @return Result with current root’s CSS.
    */
- toResult(options?: ProcessOptions): Result
+  toResult(options?: ProcessOptions): Result
 }
 
 declare class Root extends Root_ {}

package/lib/rule.d.ts

@@ -103,9 +103,9 @@ declare class Rule_ extends Container {
 
   constructor(defaults?: Rule.RuleProps)
   assign(overrides: object | Rule.RuleProps): this
-  clone(overrides?: Partial<Rule.RuleProps>): this
-  cloneAfter(overrides?: Partial<Rule.RuleProps>): this
-  cloneBefore(overrides?: Partial<Rule.RuleProps>): this
+  clone(overrides?: Partial<Rule.RuleProps>): Rule
+  cloneAfter(overrides?: Partial<Rule.RuleProps>): Rule
+  cloneBefore(overrides?: Partial<Rule.RuleProps>): Rule
 }
 
 declare class Rule extends Rule_ {}

package/package.json

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