postcss 8.4.24 → 8.4.25

package/lib/at-rule.d.ts

@@ -2,12 +2,6 @@ import Container, { ContainerProps } from './container.js'
 
 declare namespace AtRule {
   export interface AtRuleRaws extends Record<string, unknown> {
-    /**
-     * The space symbols before the node. It also stores `*`
-     * and `_` symbols before the declaration (IE hack).
-     */
-    before?: string
-
     /**
      * The space symbols after the last child of the node to the end of the node.
      */
@@ -19,29 +13,35 @@ declare namespace AtRule {
     afterName?: string
 
     /**
-     * The symbols between the last parameter and `{` for rules.
+     * The space symbols before the node. It also stores `*`
+     * and `_` symbols before the declaration (IE hack).
      */
-    between?: string
+    before?: string
 
     /**
-     * Contains `true` if the last child has an (optional) semicolon.
+     * The symbols between the last parameter and `{` for rules.
      */
-    semicolon?: boolean
+    between?: string
 
     /**
      * The rule’s selector with comments.
      */
     params?: {
-      value: string
       raw: string
+      value: 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
+    params?: number | string
     /** Information used to generate byte-to-byte equal node string as it was in the origin input. */
     raws?: AtRuleRaws
   }
@@ -76,10 +76,6 @@ declare namespace AtRule {
  * ```
  */
 declare class AtRule_ extends Container {
-  type: 'atrule'
-  parent: Container | undefined
-  raws: AtRule.AtRuleRaws
-
   /**
    * The at-rule’s name immediately follows the `@`.
    *
@@ -90,7 +86,6 @@ declare class AtRule_ extends Container {
    * ```
    */
   name: string
-
   /**
    * The at-rule’s parameters, the values that follow the at-rule’s name
    * but precede any `{}` block.
@@ -102,12 +97,17 @@ declare class AtRule_ extends Container {
    * ```
    */
   params: string
+  parent: Container | undefined
+
+  raws: AtRule.AtRuleRaws
+
+  type: 'atrule'
 
   constructor(defaults?: AtRule.AtRuleProps)
-  assign(overrides: object | AtRule.AtRuleProps): this
+  assign(overrides: AtRule.AtRuleProps | object): this
   clone(overrides?: Partial<AtRule.AtRuleProps>): this
-  cloneBefore(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

@@ -20,10 +20,10 @@ declare namespace Comment {
   }
 
   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
+    /** Content of the comment. */
+    text: string
   }
 
   // eslint-disable-next-line @typescript-eslint/no-use-before-define
@@ -31,33 +31,35 @@ declare namespace Comment {
 }
 
 /**
- * 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.
  */
 declare class Comment_ extends Node {
-  type: 'comment'
   parent: Container | undefined
   raws: Comment.CommentRaws
-
   /**
    * The comment's text.
    */
   text: string
 
+  type: 'comment'
+
   constructor(defaults?: Comment.CommentProps)
-  assign(overrides: object | Comment.CommentProps): this
+  assign(overrides: Comment.CommentProps | object): this
   clone(overrides?: Partial<Comment.CommentProps>): this
-  cloneBefore(overrides?: Partial<Comment.CommentProps>): this
   cloneAfter(overrides?: Partial<Comment.CommentProps>): this
+  cloneBefore(overrides?: Partial<Comment.CommentProps>): this
 }
 
 declare class Comment extends Comment_ {}