postcss 8.3.9 → 8.4.31

package/README.md

@@ -1,44 +1,28 @@
-# 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.
 
 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.
+---
 
-**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)
+<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](https://github.com/postcss/postcss#readme)** on GitHub.
+Read full docs **[here](https://postcss.org/)**.

package/lib/at-rule.d.ts

@@ -1,48 +1,53 @@
 import Container, { ContainerProps } from './container.js'
 
-interface AtRuleRaws {
-  /**
-   * The space symbols before the node. It also stores `*`
-   * and `_` symbols before the declaration (IE hack).
-   */
-  before?: string
+declare namespace AtRule {
+  export interface AtRuleRaws extends Record<string, unknown> {
+    /**
+     * The space symbols after the last child of the node to the end of the node.
+     */
+    after?: string
 
-  /**
-   * The space symbols after the last child of the node to the end of the node.
-   */
-  after?: string
+    /**
+     * The space between the at-rule name and its parameters.
+     */
+    afterName?: string
 
-  /**
-   * The space between the at-rule name and its parameters.
-   */
-  afterName?: string
+    /**
+     * The space symbols before the node. It also stores `*`
+     * and `_` symbols before the declaration (IE hack).
+     */
+    before?: string
 
-  /**
-   * The symbols between the last parameter and `{` for rules.
-   */
-  between?: string
+    /**
+     * The symbols between the last parameter and `{` for rules.
+     */
+    between?: string
 
-  /**
-   * Contains `true` if the last child has an (optional) semicolon.
-   */
-  semicolon?: boolean
+    /**
+     * The rule’s selector with comments.
+     */
+    params?: {
+      raw: string
+      value: string
+    }
 
-  /**
-   * The rule’s selector with comments.
-   */
-  params?: {
-    value: string
-    raw: string
+    /**
+     * Contains `true` if the last child has an (optional) semicolon.
+     */
+    semicolon?: boolean
   }
-}
 
-export interface AtRuleProps extends ContainerProps {
-  /** Name of the at-rule. */
-  name: string
-  /** Parameters following the name of the at-rule. */
-  params?: string | number
-  /** Information used to generate byte-to-byte equal node string as it was in the origin input. */
-  raws?: AtRuleRaws
+  export interface AtRuleProps extends ContainerProps {
+    /** Name of the at-rule. */
+    name: string
+    /** Parameters following the name of the at-rule. */
+    params?: number | string
+    /** Information used to generate byte-to-byte equal node string as it was in the origin input. */
+    raws?: AtRuleRaws
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define
+  export { AtRule_ as default }
 }
 
 /**
@@ -56,7 +61,7 @@ export interface AtRuleProps extends ContainerProps {
  * }
  * ```
  *
- * If it’s followed in the CSS by a {} block, this node will have
+ * If it’s followed in the CSS by a `{}` block, this node will have
  * a nodes property representing its children.
  *
  * ```js
@@ -70,11 +75,7 @@ export interface AtRuleProps extends ContainerProps {
  * media.nodes   //=> []
  * ```
  */
-export default class AtRule extends Container {
-  type: 'atrule'
-  parent: Container | undefined
-  raws: AtRuleRaws
-
+declare class AtRule_ extends Container {
   /**
    * The at-rule’s name immediately follows the `@`.
    *
@@ -85,10 +86,9 @@ export default class AtRule extends Container {
    * ```
    */
   name: string
-
   /**
    * The at-rule’s parameters, the values that follow the at-rule’s name
-   * but precede any {} block.
+   * but precede any `{}` block.
    *
    * ```js
    * const root  = postcss.parse('@media print, screen {}')
@@ -97,10 +97,19 @@ export default class AtRule extends Container {
    * ```
    */
   params: string
+  parent: Container | undefined
+
+  raws: AtRule.AtRuleRaws
+
+  type: 'atrule'
 
-  constructor(defaults?: AtRuleProps)
-  assign(overrides: object | AtRuleProps): this
-  clone(overrides?: Partial<AtRuleProps>): this
-  cloneBefore(overrides?: Partial<AtRuleProps>): this
-  cloneAfter(overrides?: Partial<AtRuleProps>): this
+  constructor(defaults?: AtRule.AtRuleProps)
+  assign(overrides: AtRule.AtRuleProps | object): this
+  clone(overrides?: Partial<AtRule.AtRuleProps>): AtRule
+  cloneAfter(overrides?: Partial<AtRule.AtRuleProps>): AtRule
+  cloneBefore(overrides?: Partial<AtRule.AtRuleProps>): AtRule
 }
+
+declare class AtRule extends AtRule_ {}
+
+export = AtRule

package/lib/comment.d.ts

@@ -1,56 +1,67 @@
 import Container from './container.js'
 import Node, { NodeProps } from './node.js'
 
-interface CommentRaws {
-  /**
-   * The space symbols before the node.
-   */
-  before?: string
+declare namespace Comment {
+  export interface CommentRaws extends Record<string, unknown> {
+    /**
+     * The space symbols before the node.
+     */
+    before?: string
 
-  /**
-   * The space symbols between `/*` and the comment’s text.
-   */
-  left?: string
+    /**
+     * The space symbols between `/*` and the comment’s text.
+     */
+    left?: string
 
-  /**
-   * The space symbols between the comment’s text.
-   */
-  right?: string
-}
+    /**
+     * The space symbols between the comment’s text.
+     */
+    right?: string
+  }
 
-export interface CommentProps extends NodeProps {
-  /** Content of the comment. */
-  text: string
-  /** Information used to generate byte-to-byte equal node string as it was in the origin input. */
-  raws?: CommentRaws
+  export interface CommentProps extends NodeProps {
+    /** Information used to generate byte-to-byte equal node string as it was in the origin input. */
+    raws?: CommentRaws
+    /** Content of the comment. */
+    text: string
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define
+  export { Comment_ as default }
 }
 
 /**
- * Represents a comment between declarations or statements (rule and at-rules).
+ * It represents a class that handles
+ * [CSS comments](https://developer.mozilla.org/en-US/docs/Web/CSS/Comments)
  *
  * ```js
  * Once (root, { Comment }) {
- *   let note = new Comment({ text: 'Note: …' })
+ *   const note = new Comment({ text: 'Note: …' })
  *   root.append(note)
  * }
  * ```
  *
- * Comments inside selectors, at-rule parameters, or declaration values
- * will be stored in the `raws` properties explained above.
+ * Remember that CSS comments inside selectors, at-rule parameters,
+ * or declaration values will be stored in the `raws` properties
+ * explained above.
  */
-export default class Comment extends Node {
-  type: 'comment'
+declare class Comment_ extends Node {
   parent: Container | undefined
-  raws: CommentRaws
-
+  raws: Comment.CommentRaws
   /**
    * The comment's text.
    */
   text: string
 
-  constructor(defaults?: CommentProps)
-  assign(overrides: object | CommentProps): this
-  clone(overrides?: Partial<CommentProps>): this
-  cloneBefore(overrides?: Partial<CommentProps>): this
-  cloneAfter(overrides?: Partial<CommentProps>): this
+  type: 'comment'
+
+  constructor(defaults?: Comment.CommentProps)
+  assign(overrides: Comment.CommentProps | object): this
+  clone(overrides?: Partial<Comment.CommentProps>): Comment
+  cloneAfter(overrides?: Partial<Comment.CommentProps>): Comment
+  cloneBefore(overrides?: Partial<Comment.CommentProps>): Comment
 }
+
+declare class Comment extends Comment_ {}
+
+export = Comment