postcss 8.4.20 → 8.4.22

package/lib/at-rule.d.ts

@@ -1,48 +1,53 @@
 import Container, { ContainerProps } from './container.js'
 
-interface AtRuleRaws extends Record<string, unknown> {
-  /**
-   * 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 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.
-   */
-  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 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
+    /**
+     * Contains `true` if the last child has an (optional) semicolon.
+     */
+    semicolon?: boolean
 
-  /**
-   * The rule’s selector with comments.
-   */
-  params?: {
-    value: string
-    raw: string
+    /**
+     * The rule’s selector with comments.
+     */
+    params?: {
+      value: string
+      raw: string
+    }
   }
-}
 
-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?: string | number
+    /** 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 }
 }
 
 /**
@@ -70,10 +75,10 @@ export interface AtRuleProps extends ContainerProps {
  * media.nodes   //=> []
  * ```
  */
-export default class AtRule extends Container {
+declare class AtRule_ extends Container {
   type: 'atrule'
   parent: Container | undefined
-  raws: AtRuleRaws
+  raws: AtRule.AtRuleRaws
 
   /**
    * The at-rule’s name immediately follows the `@`.
@@ -98,9 +103,13 @@ export default class AtRule extends Container {
    */
   params: string
 
-  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: object | AtRule.AtRuleProps): this
+  clone(overrides?: Partial<AtRule.AtRuleProps>): this
+  cloneBefore(overrides?: Partial<AtRule.AtRuleProps>): this
+  cloneAfter(overrides?: Partial<AtRule.AtRuleProps>): this
 }
+
+declare class AtRule extends AtRule_ {}
+
+export = AtRule

package/lib/comment.d.ts

@@ -1,28 +1,33 @@
 import Container from './container.js'
 import Node, { NodeProps } from './node.js'
 
-interface CommentRaws extends Record<string, unknown> {
-  /**
-   * 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 {
+    /** 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
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define
+  export { Comment_ as default }
 }
 
 /**
@@ -38,19 +43,23 @@ export interface CommentProps extends NodeProps {
  * Comments inside selectors, at-rule parameters, or declaration values
  * will be stored in the `raws` properties explained above.
  */
-export default class Comment extends Node {
+declare class Comment_ extends Node {
   type: 'comment'
   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
+  constructor(defaults?: Comment.CommentProps)
+  assign(overrides: object | Comment.CommentProps): this
+  clone(overrides?: Partial<Comment.CommentProps>): this
+  cloneBefore(overrides?: Partial<Comment.CommentProps>): this
+  cloneAfter(overrides?: Partial<Comment.CommentProps>): this
 }
+
+declare class Comment extends Comment_ {}
+
+export = Comment

package/lib/container.d.ts

@@ -4,20 +4,25 @@ import Comment from './comment.js'
 import AtRule from './at-rule.js'
 import Rule from './rule.js'
 
-interface ValueOptions {
-  /**
-   * An array of property names.
-   */
-  props?: string[]
+declare namespace Container {
+  export interface ValueOptions {
+    /**
+     * An array of property names.
+     */
+    props?: string[]
 
-  /**
-   * String that’s used to narrow down values and speed up the regexp search.
-   */
-  fast?: string
-}
+    /**
+     * String that’s used to narrow down values and speed up the regexp search.
+     */
+    fast?: string
+  }
+
+  export interface ContainerProps extends NodeProps {
+    nodes?: (ChildNode | ChildProps)[]
+  }
 
-export interface ContainerProps extends NodeProps {
-  nodes?: (ChildNode | ChildProps)[]
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define
+  export { Container_ as default }
 }
 
 /**
@@ -27,7 +32,7 @@ export interface ContainerProps extends NodeProps {
  * Note that all containers can store any content. If you write a rule inside
  * a rule, PostCSS will parse it.
  */
-export default abstract class Container<
+declare abstract class Container_<
   Child extends Node = ChildNode
 > extends Node {
   /**
@@ -390,7 +395,7 @@ export default abstract class Container<
    */
   replaceValues(
     pattern: string | RegExp,
-    options: ValueOptions,
+    options: Container.ValueOptions,
     replaced: string | { (substring: string, ...args: any[]): string }
   ): this
   replaceValues(
@@ -440,3 +445,7 @@ export default abstract class Container<
    */
   index(child: Child | number): number
 }
+
+declare class Container<Child extends Node = ChildNode> extends Container_<Child> {}
+
+export = Container

package/lib/css-syntax-error.d.ts

@@ -1,18 +1,23 @@
 import { FilePosition } from './input.js'
 
-/**
- * A position that is part of a range.
- */
-export interface RangePosition {
+declare namespace CssSyntaxError {
   /**
-   * The line number in the input.
+   * A position that is part of a range.
    */
-  line: number
+  export interface RangePosition {
+    /**
+     * The line number in the input.
+     */
+    line: number
 
-  /**
-   * The column number in the input.
-   */
-  column: number
+    /**
+     * The column number in the input.
+     */
+    column: number
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define
+  export { CssSyntaxError_ as default }
 }
 
 /**
@@ -44,7 +49,7 @@ export interface RangePosition {
  * }
  * ```
  */
-export default class CssSyntaxError {
+declare class CssSyntaxError_ {
   /**
    * Instantiates a CSS syntax error. Can be instantiated for a single position
    * or for a range.
@@ -59,8 +64,8 @@ export default class CssSyntaxError {
    */
   constructor(
     message: string,
-    lineOrStartPos?: number | RangePosition,
-    columnOrEndPos?: number | RangePosition,
+    lineOrStartPos?: number | CssSyntaxError.RangePosition,
+    columnOrEndPos?: number | CssSyntaxError.RangePosition,
     source?: string,
     file?: string,
     plugin?: string
@@ -237,3 +242,7 @@ export default class CssSyntaxError {
    */
   showSourceCode(color?: boolean): string
 }
+
+declare class CssSyntaxError extends CssSyntaxError_ {}
+
+export = CssSyntaxError

package/lib/declaration.d.ts

@@ -1,41 +1,46 @@
 import Container from './container.js'
 import Node from './node.js'
 
-interface DeclarationRaws extends Record<string, unknown> {
-  /**
-   * The space symbols before the node. It also stores `*`
-   * and `_` symbols before the declaration (IE hack).
-   */
-  before?: string
+declare namespace Declaration {
+  export interface DeclarationRaws extends Record<string, unknown> {
+    /**
+     * The space symbols before the node. It also stores `*`
+     * and `_` symbols before the declaration (IE hack).
+     */
+    before?: string
 
-  /**
-   * The symbols between the property and value for declarations.
-   */
-  between?: string
+    /**
+     * The symbols between the property and value for declarations.
+     */
+    between?: string
 
-  /**
-   * The content of the important statement, if it is not just `!important`.
-   */
-  important?: string
+    /**
+     * The content of the important statement, if it is not just `!important`.
+     */
+    important?: string
 
-  /**
-   * Declaration value with comments.
-   */
-  value?: {
+    /**
+     * Declaration value with comments.
+     */
+    value?: {
+      value: string
+      raw: string
+    }
+  }
+
+  export interface DeclarationProps {
+    /** Name of the declaration. */
+    prop: string
+    /** Value of the declaration. */
     value: string
-    raw: string
+    /** Whether the declaration has an `!important` annotation. */
+    important?: boolean
+    /** Information used to generate byte-to-byte equal node string as it was in the origin input. */
+    raws?: DeclarationRaws
   }
-}
 
-export interface DeclarationProps {
-  /** Name of the declaration. */
-  prop: string
-  /** Value of the declaration. */
-  value: string
-  /** Whether the declaration has an `!important` annotation. */
-  important?: boolean
-  /** Information used to generate byte-to-byte equal node string as it was in the origin input. */
-  raws?: DeclarationRaws
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define
+  export { Declaration_ as default }
 }
 
 /**
@@ -55,10 +60,10 @@ export interface DeclarationProps {
  * decl.toString() //=> ' color: black'
  * ```
  */
-export default class Declaration extends Node {
+declare class Declaration_ extends Node {
   type: 'decl'
   parent: Container | undefined
-  raws: DeclarationRaws
+  raws: Declaration.DeclarationRaws
 
   /**
    * The declaration's property name.
@@ -116,9 +121,13 @@ export default class Declaration extends Node {
    */
   variable: boolean
 
-  constructor(defaults?: DeclarationProps)
-  assign(overrides: object | DeclarationProps): this
-  clone(overrides?: Partial<DeclarationProps>): this
-  cloneBefore(overrides?: Partial<DeclarationProps>): this
-  cloneAfter(overrides?: Partial<DeclarationProps>): this
+  constructor(defaults?: Declaration.DeclarationProps)
+  assign(overrides: object | Declaration.DeclarationProps): this
+  clone(overrides?: Partial<Declaration.DeclarationProps>): this
+  cloneBefore(overrides?: Partial<Declaration.DeclarationProps>): this
+  cloneAfter(overrides?: Partial<Declaration.DeclarationProps>): this
 }
+
+declare class Declaration extends Declaration_ {}
+
+export = Declaration

package/lib/document.d.ts

@@ -1,22 +1,24 @@
 import Container, { ContainerProps } from './container.js'
 import { ProcessOptions } from './postcss.js'
 import Result from './result.js'
-import Root, { RootProps } from './root.js'
+import Root from './root.js'
 
-export interface DocumentProps extends ContainerProps {
-  nodes?: Root[]
+declare namespace Document {
+  export interface DocumentProps extends ContainerProps {
+    nodes?: Root[]
 
-  /**
-   * Information to generate byte-to-byte equal node string as it was
-   * in the origin input.
-   *
-   * Every parser saves its own properties.
-   */
-  raws?: Record<string, any>
-}
+    /**
+     * Information to generate byte-to-byte equal node string as it was
+     * in the origin input.
+     *
+     * Every parser saves its own properties.
+     */
+    raws?: Record<string, any>
+  }
 
-type ChildNode = Root
-type ChildProps = RootProps
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define
+  export { Document_ as default }
+}
 
 /**
  * Represents a file and contains all its parsed nodes.
@@ -32,11 +34,11 @@ type ChildProps = RootProps
  * document.nodes.length //=> 2
  * ```
  */
-export default class Document extends Container<Root> {
+declare class Document_ extends Container<Root> {
   type: 'document'
   parent: undefined
 
-  constructor(defaults?: DocumentProps)
+  constructor(defaults?: Document.DocumentProps)
 
   /**
    * Returns a `Result` instance representing the document’s CSS roots.
@@ -55,3 +57,7 @@ export default class Document extends Container<Root> {
    */
   toResult(options?: ProcessOptions): Result
 }
+
+declare class Document extends Document_ {}
+
+export = Document

package/lib/fromJSON.d.ts

@@ -1,5 +1,9 @@
 import { JSONHydrator } from './postcss.js'
 
-declare const fromJSON: JSONHydrator
+interface FromJSON extends JSONHydrator {
+  default: FromJSON
+}
 
-export default fromJSON
+declare const fromJSON: FromJSON
+
+export = fromJSON

package/lib/input.d.ts

@@ -1,41 +1,46 @@
-import { ProcessOptions } from './postcss.js'
+import { CssSyntaxError, ProcessOptions } from './postcss.js'
 import PreviousMap from './previous-map.js'
 
-export interface FilePosition {
-  /**
-   * URL for the source file.
-   */
-  url: string
-
-  /**
-   * Absolute path to the source file.
-   */
-  file?: string
-
-  /**
-   * Line of inclusive start position in source file.
-   */
-  line: number
-
-  /**
-   * Column of inclusive start position in source file.
-   */
-  column: number
-
-  /**
-   * Line of exclusive end position in source file.
-   */
-  endLine?: number
+declare namespace Input {
+  export interface FilePosition {
+    /**
+     * URL for the source file.
+     */
+    url: string
+
+    /**
+     * Absolute path to the source file.
+     */
+    file?: string
+
+    /**
+     * Line of inclusive start position in source file.
+     */
+    line: number
+
+    /**
+     * Column of inclusive start position in source file.
+     */
+    column: number
+
+    /**
+     * Line of exclusive end position in source file.
+     */
+    endLine?: number
+
+    /**
+     * Column of exclusive end position in source file.
+     */
+    endColumn?: number
 
-  /**
-   * Column of exclusive end position in source file.
-   */
-  endColumn?: number
+    /**
+     * Source code.
+     */
+    source?: string
+  }
 
-  /**
-   * Source code.
-   */
-  source?: string
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define
+  export { Input_ as default }
 }
 
 /**
@@ -46,7 +51,7 @@ export interface FilePosition {
  * const input = root.source.input
  * ```
  */
-export default class Input {
+declare class Input_ {
   /**
    * Input CSS source.
    *
@@ -139,7 +144,7 @@ export default class Input {
     column: number,
     endLine?: number,
     endColumn?: number
-  ): FilePosition | false
+  ): Input.FilePosition | false
 
   /**
    * Converts source offset to line and column.
@@ -147,4 +152,43 @@ export default class Input {
    * @param offset Source offset.
    */
   fromOffset(offset: number): { line: number; col: number } | null
+
+  /**
+   * 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
+  error(
+    message: string,
+    start:
+      | {
+          offset: number
+        }
+      | {
+          line: number
+          column: number
+        },
+    end:
+      | {
+          offset: number
+        }
+      | {
+          line: number
+          column: number
+        },
+    opts?: { plugin?: CssSyntaxError['plugin'] }
+  ): CssSyntaxError
 }
+
+declare class Input extends Input_ {}
+
+export = Input

package/lib/input.js

@@ -108,7 +108,7 @@ class Input {
     if (line && typeof line === 'object') {
       let start = line
       let end = column
-      if (typeof line.offset === 'number') {
+      if (typeof start.offset === 'number') {
         let pos = this.fromOffset(start.offset)
         line = pos.line
         column = pos.col