postcss 8.4.49 → 8.5.10

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright 2013 Andrey Sitnik <andrey@sitnik.ru>
+Copyright 2013 Andrey Sitnik <andrey@sitnik.es>
 
 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

package/README.md

@@ -9,20 +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] and [Stylelint] PostCSS plugins is one of the most popular CSS tools.
+and JetBrains. The [Autoprefixer] and [Stylelint] PostCSS plugins are some of the most popular CSS tools.
 
 ---
 
-<img src="https://cdn.evilmartians.com/badges/logo-no-label.svg" alt="" width="22" height="16" />  Made at <b><a href="https://evilmartians.com/devtools?utm_source=postcss&utm_campaign=devtools-button&utm_medium=github">Evil Martians</a></b>, product consulting for <b>developer tools</b>.
+<img src="https://cdn.evilmartians.com/badges/logo-no-label.svg" alt="" width="22" height="16" />  Built by
+<b><a href="https://evilmartians.com/devtools?utm_source=postcss&utm_campaign=devtools-button&utm_medium=github">Evil Martians</a></b>, go-to agency for <b>developer tools</b>.
 
 ---
 
-[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
-
+[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
 
 ## Docs
 Read full docs **[here](https://postcss.org/)**.

package/lib/at-rule.d.ts

@@ -49,7 +49,6 @@ declare namespace AtRule {
     raws?: AtRuleRaws
   }
 
-  // eslint-disable-next-line @typescript-eslint/no-use-before-define
   export { AtRule_ as default }
 }
 
@@ -97,19 +96,11 @@ declare class AtRule_ extends Container {
    * layer.nodes //=> undefined
    * ```
    */
-  nodes: Container['nodes']
+  nodes: Container['nodes'] | undefined
   parent: ContainerWithChildren | undefined
 
   raws: AtRule.AtRuleRaws
   type: 'atrule'
-  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
   /**
    * The at-rule’s name immediately follows the `@`.
    *
@@ -121,6 +112,7 @@ declare class AtRule_ extends Container {
    */
   get name(): string
   set name(value: string)
+
   /**
    * The at-rule’s parameters, the values that follow the at-rule’s name
    * but precede any `{}` block.
@@ -132,7 +124,14 @@ declare class AtRule_ extends Container {
    * ```
    */
   get params(): string
+
   set params(value: string)
+
+  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
 }
 
 declare class AtRule extends AtRule_ {}

package/lib/comment.d.ts

@@ -26,7 +26,6 @@ declare namespace Comment {
     text: string
   }
 
-  // eslint-disable-next-line @typescript-eslint/no-use-before-define
   export { Comment_ as default }
 }
 
@@ -49,18 +48,18 @@ declare class Comment_ extends Node {
   parent: Container | undefined
   raws: Comment.CommentRaws
   type: 'comment'
-  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
   /**
    * The comment's text.
    */
   get text(): string
+
   set text(value: string)
+
+  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
 }
 
 declare class Comment extends Comment_ {}

package/lib/container.d.ts

@@ -2,14 +2,13 @@ import AtRule from './at-rule.js'
 import Comment from './comment.js'
 import Declaration from './declaration.js'
 import Node, { ChildNode, ChildProps, NodeProps } from './node.js'
+import { Root } from './postcss.js'
 import Rule from './rule.js'
 
 declare namespace Container {
-  export class ContainerWithChildren<
-    Child extends Node = ChildNode
-  > extends Container_<Child> {
+  export type ContainerWithChildren<Child extends Node = ChildNode> = {
     nodes: Child[]
-  }
+  } & (AtRule | Root | Rule)
 
   export interface ValueOptions {
     /**
@@ -40,7 +39,6 @@ declare namespace Container {
     | string
     | undefined
 
-  // eslint-disable-next-line @typescript-eslint/no-use-before-define
   export { Container_ as default }
 }
 
@@ -65,25 +63,22 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
   nodes: Child[] | undefined
 
   /**
-   * An internal method that converts a {@link NewChild} into a list of actual
-   * child nodes that can then be added to this container.
-   *
-   * This ensures that the nodes' parent is set to this container, that they use
-   * the correct prototype chain, and that they're marked as dirty.
+   * The container’s first child.
    *
-   * @param mnodes The new node or nodes to add.
-   * @param sample A node from whose raws the new node's `before` raw should be
-   *               taken.
-   * @param type   This should be set to `'prepend'` if the new nodes will be
-   *               inserted at the beginning of the container.
-   * @hidden
+   * ```js
+   * rule.first === rules.nodes[0]
+   * ```
    */
-  protected normalize(
-    nodes: Container.NewChild,
-    sample: Node | undefined,
-    type?: 'prepend' | false
-  ): Child[]
+  get first(): Child | undefined
 
+  /**
+   * The container’s last child.
+   *
+   * ```js
+   * rule.last === rule.nodes[rule.nodes.length - 1]
+   * ```
+   */
+  get last(): Child | undefined
   /**
    * Inserts new nodes to the end of the container.
    *
@@ -107,10 +102,10 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
   append(...nodes: Container.NewChild[]): this
   assign(overrides: Container.ContainerProps | object): this
   clone(overrides?: Partial<Container.ContainerProps>): this
+
   cloneAfter(overrides?: Partial<Container.ContainerProps>): this
 
   cloneBefore(overrides?: Partial<Container.ContainerProps>): this
-
   /**
    * Iterates through the container’s immediate children,
    * calling `callback` for each child.
@@ -147,6 +142,7 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
   each(
     callback: (node: Child, index: number) => false | void
   ): false | undefined
+
   /**
    * Returns `true` if callback returns `true`
    * for all of the container’s children.
@@ -161,7 +157,6 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
   every(
     condition: (node: Child, index: number, nodes: Child[]) => boolean
   ): boolean
-
   /**
    * Returns a `child`’s index within the `Container#nodes` array.
    *
@@ -173,6 +168,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.
    *
@@ -182,19 +178,6 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
    */
   insertAfter(oldNode: Child | number, newNode: Container.NewChild): this
 
-  /**
-   * Insert new node before old node within the container.
-   *
-   * ```js
-   * rule.insertBefore(decl, decl.clone({ prop: '-webkit-' + decl.prop }))
-   * ```
-   *
-   * @param oldNode Child or child’s index.
-   * @param newNode New node.
-   * @return This node for methods chain.
-   */
-  insertBefore(oldNode: Child | number, newNode: Container.NewChild): this
-
   /**
    * Traverses the container’s descendant nodes, calling callback
    * for each comment node.
@@ -212,6 +195,18 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
    * @return Returns `false` if iteration was broke.
    */
 
+  /**
+   * Insert new node before old node within the container.
+   *
+   * ```js
+   * rule.insertBefore(decl, decl.clone({ prop: '-webkit-' + decl.prop }))
+   * ```
+   *
+   * @param oldNode Child or child’s index.
+   * @param newNode New node.
+   * @return This node for methods chain.
+   */
+  insertBefore(oldNode: Child | number, newNode: Container.NewChild): this
   /**
    * Inserts new nodes to the start of the container.
    *
@@ -233,6 +228,7 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
    * @return This node for methods chain.
    */
   prepend(...nodes: Container.NewChild[]): this
+
   /**
    * Add child to the end of the node.
    *
@@ -278,7 +274,6 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
     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
@@ -379,14 +374,13 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
     nameFilter: RegExp | string,
     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
-
   walkComments(
     callback: (comment: Comment, indexed: number) => false | void
   ): false | undefined
@@ -424,11 +418,9 @@ 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.
@@ -459,21 +451,24 @@ declare abstract class Container_<Child extends Node = ChildNode> extends Node {
     callback: (rule: Rule, index: number) => false | void
   ): false | undefined
   /**
-   * The container’s first child.
+   * An internal method that converts a {@link NewChild} into a list of actual
+   * child nodes that can then be added to this container.
    *
-   * ```js
-   * rule.first === rules.nodes[0]
-   * ```
-   */
-  get first(): Child | undefined
-  /**
-   * The container’s last child.
+   * This ensures that the nodes' parent is set to this container, that they use
+   * the correct prototype chain, and that they're marked as dirty.
    *
-   * ```js
-   * rule.last === rule.nodes[rule.nodes.length - 1]
-   * ```
+   * @param mnodes The new node or nodes to add.
+   * @param sample A node from whose raws the new node's `before` raw should be
+   *               taken.
+   * @param type   This should be set to `'prepend'` if the new nodes will be
+   *               inserted at the beginning of the container.
+   * @hidden
    */
-  get last(): Child | undefined
+  protected normalize(
+    nodes: Container.NewChild,
+    sample: Node | undefined,
+    type?: 'prepend' | false
+  ): Child[]
 }
 
 declare class Container<

package/lib/container.js

@@ -25,6 +25,16 @@ function markTreeDirty(node) {
 }
 
 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]
+  }
+
   append(...children) {
     for (let child of children) {
       let nodes = this.normalize(child, this.last)
@@ -391,16 +401,6 @@ 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/css-syntax-error.d.ts

@@ -16,7 +16,6 @@ declare namespace CssSyntaxError {
     line: number
   }
 
-  // eslint-disable-next-line @typescript-eslint/no-use-before-define
   export { CssSyntaxError_ as default }
 }
 

package/lib/declaration.d.ts

@@ -39,7 +39,6 @@ declare namespace Declaration {
     value: string
   }
 
-  // eslint-disable-next-line @typescript-eslint/no-use-before-define
   export { Declaration_ as default }
 }
 
@@ -68,14 +67,6 @@ declare class Declaration_ extends Node {
 
   type: 'decl'
 
-  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
   /**
    * It represents a specificity of the declaration.
    *
@@ -91,8 +82,8 @@ declare class Declaration_ extends Node {
    * ```
    */
   get important(): boolean
-
   set important(value: boolean)
+
   /**
    * The property name for a CSS declaration.
    *
@@ -106,6 +97,7 @@ declare class Declaration_ extends Node {
   get prop(): string
 
   set prop(value: string)
+
   /**
    * The property value for a CSS declaration.
    *
@@ -125,6 +117,7 @@ declare class Declaration_ extends Node {
    */
   get value(): string
   set value(value: string)
+
   /**
    * It represents a getter that returns `true` if a declaration starts with
    * `--` or `$`, which are used to declare variables in CSS and SASS/SCSS.
@@ -144,6 +137,12 @@ declare class Declaration_ extends Node {
    * ```
    */
   get 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
 }
 
 declare class Declaration extends Declaration_ {}

package/lib/declaration.js

@@ -3,6 +3,10 @@
 let Node = require('./node')
 
 class Declaration extends Node {
+  get variable() {
+    return this.prop.startsWith('--') || this.prop[0] === '$'
+  }
+
   constructor(defaults) {
     if (
       defaults &&
@@ -14,10 +18,6 @@ class Declaration extends Node {
     super(defaults)
     this.type = 'decl'
   }
-
-  get variable() {
-    return this.prop.startsWith('--') || this.prop[0] === '$'
-  }
 }
 
 module.exports = Declaration

package/lib/document.d.ts

@@ -16,7 +16,6 @@ declare namespace Document {
     raws?: Record<string, any>
   }
 
-  // eslint-disable-next-line @typescript-eslint/no-use-before-define
   export { Document_ as default }
 }
 

package/lib/fromJSON.d.ts

@@ -4,6 +4,6 @@ interface FromJSON extends JSONHydrator {
   default: FromJSON
 }
 
-declare const fromJSON: FromJSON
+declare let fromJSON: FromJSON
 
 export = fromJSON

package/lib/input.d.ts

@@ -18,6 +18,11 @@ declare namespace Input {
      */
     endLine?: number
 
+    /**
+     * Offset of exclusive end position in source file.
+     */
+    endOffset?: number
+
     /**
      * Absolute path to the source file.
      */
@@ -28,6 +33,11 @@ declare namespace Input {
      */
     line: number
 
+    /**
+     * Offset of inclusive start position in source file.
+     */
+    offset: number
+
     /**
      * Source code.
      */
@@ -39,7 +49,6 @@ declare namespace Input {
     url: string
   }
 
-  // eslint-disable-next-line @typescript-eslint/no-use-before-define
   export { Input_ as default }
 }
 
@@ -62,6 +71,17 @@ declare class Input_ {
    */
   css: string
 
+  /**
+   * Input source with support for non-CSS documents.
+   *
+   * ```js
+   * const input = postcss.parse('a{}', { from: file, document: '<style>a {}</style>' }).input
+   * input.document //=> "<style>a {}</style>"
+   * input.css //=> "a{}"
+   * ```
+   */
+  document: string
+
   /**
    * The absolute path to the CSS source file defined
    * with the `from` option.
@@ -100,12 +120,29 @@ declare class Input_ {
    */
   map: PreviousMap
 
+  /**
+   * 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
+
   /**
    * @param css  Input CSS source.
    * @param opts Process options.
    */
   constructor(css: string, opts?: ProcessOptions)
 
+  /**
+   * Returns `CssSyntaxError` with information about the error and its position.
+   */
   error(
     message: string,
     start:
@@ -126,29 +163,34 @@ declare class Input_ {
         },
     opts?: { plugin?: CssSyntaxError['plugin'] }
   ): CssSyntaxError
-
-  /**
-   * Returns `CssSyntaxError` with information about the error and its position.
-   */
   error(
     message: string,
     line: number,
     column: number,
     opts?: { plugin?: CssSyntaxError['plugin'] }
   ): CssSyntaxError
-
   error(
     message: string,
     offset: number,
     opts?: { plugin?: CssSyntaxError['plugin'] }
   ): CssSyntaxError
 
+  /**
+   * Converts source line and column to offset.
+   *
+   * @param line   Source line.
+   * @param column Source column.
+   * @return Source offset.
+   */
+  fromLineAndColumn(line: number, column: number): number
+
   /**
    * Converts source offset to line and column.
    *
    * @param offset Source offset.
    */
   fromOffset(offset: number): { col: number; line: number } | null
+
   /**
    * Reads the input source map and returns a symbol position
    * in the input source (e.g., in a Sass file that was compiled
@@ -174,22 +216,9 @@ declare class Input_ {
     endLine?: number,
     endColumn?: number
   ): false | Input.FilePosition
+
   /** Converts this to a JSON-friendly object representation. */
   toJSON(): object
-
-  /**
-   * 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_ {}