postcss 8.4.26 → 8.4.28

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/lazy-result.d.ts

@@ -1,3 +1,4 @@
+import Document from './document.js'
 import { SourceMap } from './postcss.js'
 import Processor from './processor.js'
 import Result, { Message, ResultOptions } from './result.js'
@@ -18,7 +19,9 @@ declare namespace LazyResult {
  * const lazy = postcss([autoprefixer]).process(css)
  * ```
  */
-declare class LazyResult_ implements PromiseLike<Result> {
+declare class LazyResult_<RootNode = Document | Root>
+  implements PromiseLike<Result<RootNode>>
+{
   /**
    * Processes input CSS through synchronous and asynchronous plugins
    * and calls onRejected for each error thrown in any plugin.
@@ -33,7 +36,7 @@ declare class LazyResult_ implements PromiseLike<Result> {
    * })
    * ```
    */
-  catch: Promise<Result>['catch']
+  catch: Promise<Result<RootNode>>['catch']
 
   /**
    * Processes input CSS through synchronous and asynchronous plugins
@@ -47,7 +50,7 @@ declare class LazyResult_ implements PromiseLike<Result> {
    * })
    * ```
    */
-  finally: Promise<Result>['finally']
+  finally: Promise<Result<RootNode>>['finally']
 
   /**
    * Processes input CSS through synchronous and asynchronous plugins
@@ -62,7 +65,7 @@ declare class LazyResult_ implements PromiseLike<Result> {
    * })
    * ```
    */
-  then: Promise<Result>['then']
+  then: Promise<Result<RootNode>>['then']
 
   /**
    * @param processor Processor used for this transformation.
@@ -76,7 +79,7 @@ declare class LazyResult_ implements PromiseLike<Result> {
    *
    * @return Result with output content.
    */
-  async(): Promise<Result>
+  async(): Promise<Result<RootNode>>
 
   /**
    * An alias for the `css` property. Use it with syntaxes
@@ -145,7 +148,7 @@ declare class LazyResult_ implements PromiseLike<Result> {
    *
    * PostCSS runners should always use `LazyResult#then`.
    */
-  get root(): Root
+  get root(): RootNode
 
   /**
    * Returns the default string description of an object.
@@ -158,7 +161,7 @@ declare class LazyResult_ implements PromiseLike<Result> {
    *
    * @return Result with output content.
    */
-  sync(): Result
+  sync(): Result<RootNode>
 
   /**
    * Alias for the `LazyResult#css` property.
@@ -180,6 +183,8 @@ declare class LazyResult_ implements PromiseLike<Result> {
   warnings(): Warning[]
 }
 
-declare class LazyResult extends LazyResult_ {}
+declare class LazyResult<
+  RootNode = Document | Root
+> extends LazyResult_<RootNode> {}
 
 export = LazyResult

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

@@ -22,12 +22,12 @@ declare namespace NoWorkResult {
  * let root = noWorkResult.root // now css is parsed because we accessed the root
  * ```
  */
-declare class NoWorkResult_ implements LazyResult {
-  catch: Promise<Result>['catch']
-  finally: Promise<Result>['finally']
-  then: Promise<Result>['then']
+declare class NoWorkResult_ implements LazyResult<Root> {
+  catch: Promise<Result<Root>>['catch']
+  finally: Promise<Result<Root>>['finally']
+  then: Promise<Result<Root>>['then']
   constructor(processor: Processor, css: string, opts: ResultOptions)
-  async(): Promise<Result>
+  async(): Promise<Result<Root>>
   get content(): string
   get css(): string
   get map(): SourceMap
@@ -36,7 +36,7 @@ declare class NoWorkResult_ implements LazyResult {
   get processor(): Processor
   get root(): Root
   get [Symbol.toStringTag](): string
-  sync(): Result
+  sync(): Result<Root>
   toString(): string
   warnings(): Warning[]
 }

package/lib/parser.js

@@ -332,6 +332,7 @@ class Parser {
       this.current.raws.semicolon = this.semicolon
     }
     this.current.raws.after = (this.current.raws.after || '') + this.spaces
+    this.root.source.end = this.getPosition(this.tokenizer.position())
   }
 
   freeSemicolon(token) {

package/lib/postcss.d.ts

@@ -236,11 +236,11 @@ declare namespace postcss {
     (data: object[]): Node[]
   }
 
-  export interface Syntax {
+  export interface Syntax<RootNode = Document | Root> {
     /**
      * Function to generate AST by string.
      */
-    parse?: Parser
+    parse?: Parser<RootNode>
 
     /**
      * Class to generate string by AST.
@@ -304,7 +304,7 @@ declare namespace postcss {
     sourcesContent?: boolean
   }
 
-  export interface ProcessOptions {
+  export interface ProcessOptions<RootNode = Document | Root> {
     /**
      * The path of the CSS source file. You should always set `from`,
      * because it is used in source map generation and syntax error messages.
@@ -319,17 +319,17 @@ declare namespace postcss {
     /**
      * Function to generate AST by string.
      */
-    parser?: Parser | Syntax
+    parser?: Parser<RootNode> | Syntax<RootNode>
 
     /**
      * Class to generate string by AST.
      */
-    stringifier?: Stringifier | Syntax
+    stringifier?: Stringifier | Syntax<RootNode>
 
     /**
      * Object with parse and stringify.
      */
-    syntax?: Syntax
+    syntax?: Syntax<RootNode>
 
     /**
      * The path where you'll put the output CSS file. You should always set `to`

package/lib/processor.d.ts

@@ -1,3 +1,4 @@
+import Document from './document.js'
 import LazyResult from './lazy-result.js'
 import NoWorkResult from './no-work-result.js'
 import {
@@ -72,9 +73,12 @@ declare class Processor_ {
    * @return Promise proxy.
    */
   process(
-    css: { toString(): string } | LazyResult | Result | Root | string,
-    options?: ProcessOptions
+    css: { toString(): string } | LazyResult | Result | Root | string
   ): LazyResult | NoWorkResult
+  process<RootNode extends Document | Root = Root>(
+    css: { toString(): string } | LazyResult | Result | Root | string,
+    options: ProcessOptions<RootNode>
+  ): LazyResult<RootNode>
 
   /**
    * Adds a plugin to be used as a CSS processor.

package/lib/processor.js

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

package/lib/result.d.ts

@@ -60,7 +60,7 @@ declare namespace Result {
  * const result2 = postcss.parse(css).toResult()
  * ```
  */
-declare class Result_ {
+declare class Result_<RootNode = Document | Root> {
   /**
    * A CSS string representing of `Result#root`.
    *
@@ -141,14 +141,14 @@ declare class Result_ {
    * root.toResult().root === root
    * ```
    */
-  root: Document | Root
+  root: RootNode
 
   /**
    * @param processor Processor used for this transformation.
    * @param root      Root node after all transformations.
    * @param opts      Options from the `Processor#process` or `Root#toResult`.
    */
-  constructor(processor: Processor, root: Document | Root, opts: Result.ResultOptions)
+  constructor(processor: Processor, root: RootNode, opts: Result.ResultOptions)
 
   /**
    * An alias for the `Result#css` property.
@@ -201,6 +201,6 @@ declare class Result_ {
   warnings(): Warning[]
 }
 
-declare class Result extends Result_ {}
+declare class Result<RootNode = Document | Root> extends Result_<RootNode> {}
 
 export = Result

package/package.json

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