postcss 8.4.25 → 8.4.26

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/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.26'
     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.26",
   "description": "Tool for transforming styles with JS plugins",
   "engines": {
     "node": "^10 || ^12 || >=14"