postcss 8.4.21 → 8.4.23

package/lib/list.d.ts

@@ -1,51 +1,57 @@
-export type List = {
-  /**
-   * Safely splits values.
-   *
-   * ```js
-   * Once (root, { list }) {
-   *   list.split('1px calc(10% + 1px)', [' ', '\n', '\t']) //=> ['1px', 'calc(10% + 1px)']
-   * }
-   * ```
-   *
-   * @param string separated values.
-   * @param separators array of separators.
-   * @param last boolean indicator.
-   * @return Split values.
-   */
-  split(string: string, separators: string[], last: boolean): string[]
-  /**
-   * Safely splits space-separated values (such as those for `background`,
-   * `border-radius`, and other shorthand properties).
-   *
-   * ```js
-   * Once (root, { list }) {
-   *   list.space('1px calc(10% + 1px)') //=> ['1px', 'calc(10% + 1px)']
-   * }
-   * ```
-   *
-   * @param str Space-separated values.
-   * @return Split values.
-   */
-  space(str: string): string[]
+declare namespace list {
+  type List = {
+    default: List
 
-  /**
-   * Safely splits comma-separated values (such as those for `transition-*`
-   * and `background` properties).
-   *
-   * ```js
-   * Once (root, { list }) {
-   *   list.comma('black, linear-gradient(white, black)')
-   *   //=> ['black', 'linear-gradient(white, black)']
-   * }
-   * ```
-   *
-   * @param str Comma-separated values.
-   * @return Split values.
-   */
-  comma(str: string): string[]
+    /**
+     * Safely splits values.
+     *
+     * ```js
+     * Once (root, { list }) {
+     *   list.split('1px calc(10% + 1px)', [' ', '\n', '\t']) //=> ['1px', 'calc(10% + 1px)']
+     * }
+     * ```
+     *
+     * @param string separated values.
+     * @param separators array of separators.
+     * @param last boolean indicator.
+     * @return Split values.
+     */
+    split(string: string, separators: string[], last: boolean): string[]
+
+    /**
+     * Safely splits space-separated values (such as those for `background`,
+     * `border-radius`, and other shorthand properties).
+     *
+     * ```js
+     * Once (root, { list }) {
+     *   list.space('1px calc(10% + 1px)') //=> ['1px', 'calc(10% + 1px)']
+     * }
+     * ```
+     *
+     * @param str Space-separated values.
+     * @return Split values.
+     */
+    space(str: string): string[]
+
+    /**
+     * Safely splits comma-separated values (such as those for `transition-*`
+     * and `background` properties).
+     *
+     * ```js
+     * Once (root, { list }) {
+     *   list.comma('black, linear-gradient(white, black)')
+     *   //=> ['black', 'linear-gradient(white, black)']
+     * }
+     * ```
+     *
+     * @param str Comma-separated values.
+     * @return Split values.
+     */
+    comma(str: string): string[]
+  }
 }
 
-declare const list: List
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+declare const list: list.List
 
-export default list
+export = list

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

@@ -5,6 +5,11 @@ import Warning from './warning.js'
 import Root from './root.js'
 import LazyResult from './lazy-result.js'
 
+declare namespace NoWorkResult {
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define
+  export { NoWorkResult_ as default }
+}
+
 /**
  * A Promise proxy for the result of PostCSS transformations.
  * This lazy result instance doesn't parse css unless `NoWorkResult#root` or `Result#root`
@@ -17,7 +22,7 @@ import LazyResult from './lazy-result.js'
  * let root = noWorkResult.root // now css is parsed because we accessed the root
  * ```
  */
-export default class NoWorkResult implements LazyResult {
+declare class NoWorkResult_ implements LazyResult {
   then: Promise<Result>['then']
   catch: Promise<Result>['catch']
   finally: Promise<Result>['finally']
@@ -35,3 +40,7 @@ export default class NoWorkResult implements LazyResult {
   sync(): Result
   async(): Promise<Result>
 }
+
+declare class NoWorkResult extends NoWorkResult_ {}
+
+export = NoWorkResult

package/lib/node.d.ts

@@ -1,7 +1,8 @@
 import Declaration, { DeclarationProps } from './declaration.js'
 import Comment, { CommentProps } from './comment.js'
 import { Stringifier, Syntax } from './postcss.js'
-import AtRule, { AtRuleProps } from './at-rule.js'
+import AtRule = require('./at-rule.js')
+import { AtRuleProps } from './at-rule.js'
 import Rule, { RuleProps } from './rule.js'
 import Warning, { WarningOptions } from './warning.js'
 import CssSyntaxError from './css-syntax-error.js'
@@ -11,84 +12,90 @@ import Root from './root.js'
 import Document from './document.js'
 import Container from './container.js'
 
-export type ChildNode = AtRule | Rule | Declaration | Comment
-
-export type AnyNode = AtRule | Rule | Declaration | Comment | Root | Document
-
-export type ChildProps =
-  | AtRuleProps
-  | RuleProps
-  | DeclarationProps
-  | CommentProps
-
-export interface Position {
-  /**
-   * Source offset in file. It starts from 0.
-   */
-  offset: number
-
-  /**
-   * Source line in file. In contrast to `offset` it starts from 1.
-   */
-  column: number
-
-  /**
-   * Source column in file.
-   */
-  line: number
-}
-
-export interface Range {
-  /**
-   * Start position, inclusive.
-   */
-  start: Position
-
-  /**
-   * End position, exclusive.
-   */
-  end: Position
-}
-
-export interface Source {
-  /**
-   * The file source of the node.
-   */
-  input: Input
-  /**
-   * The inclusive starting position of the node’s source.
-   */
-  start?: Position
-  /**
-   * The inclusive ending position of the node's source.
-   */
-  end?: Position
-}
-
-export interface NodeProps {
-  source?: Source
-}
-
-interface NodeErrorOptions {
-  /**
-   * Plugin name that created this error. PostCSS will set it automatically.
-   */
-  plugin?: string
-  /**
-   * A word inside a node's string, that should be highlighted as source
-   * of error.
-   */
-  word?: string
-  /**
-   * An index inside a node's string that should be highlighted as source
-   * of error.
-   */
-  index?: number
-  /**
-   * An ending index inside a node's string that should be highlighted as
-   * source of error.
-   */
-  endIndex?: number
+declare namespace Node {
+  export type ChildNode = AtRule.default | Rule | Declaration | Comment
+
+  export type AnyNode = AtRule.default | Rule | Declaration | Comment | Root | Document
+
+  export type ChildProps =
+    | AtRuleProps
+    | RuleProps
+    | DeclarationProps
+    | CommentProps
+
+  export interface Position {
+    /**
+     * Source offset in file. It starts from 0.
+     */
+    offset: number
+
+    /**
+     * Source line in file. In contrast to `offset` it starts from 1.
+     */
+    column: number
+
+    /**
+     * Source column in file.
+     */
+    line: number
+  }
+
+  export interface Range {
+    /**
+     * Start position, inclusive.
+     */
+    start: Position
+
+    /**
+     * End position, exclusive.
+     */
+    end: Position
+  }
+
+  export interface Source {
+    /**
+     * The file source of the node.
+     */
+    input: Input
+    /**
+     * The inclusive starting position of the node’s source.
+     */
+    start?: Position
+    /**
+     * The inclusive ending position of the node's source.
+     */
+    end?: Position
+  }
+
+  export interface NodeProps {
+    source?: Source
+  }
+
+  export interface NodeErrorOptions {
+    /**
+     * Plugin name that created this error. PostCSS will set it automatically.
+     */
+    plugin?: string
+    /**
+     * A word inside a node's string, that should be highlighted as source
+     * of error.
+     */
+    word?: string
+    /**
+     * An index inside a node's string that should be highlighted as source
+     * of error.
+     */
+    index?: number
+    /**
+     * An ending index inside a node's string that should be highlighted as
+     * source of error.
+     */
+    endIndex?: number
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-shadow
+  class Node extends Node_ {}
+  export { Node as default }
 }
 
 /**
@@ -97,7 +104,7 @@ interface NodeErrorOptions {
  * You should not extend this classes to create AST for selector or value
  * parser.
  */
-export default abstract class Node {
+declare abstract class Node_ {
   /**
    * tring representing the node’s type. Possible values are `root`, `atrule`,
    * `rule`, `decl`, or `comment`.
@@ -153,7 +160,7 @@ export default abstract class Node {
    * }
    * ```
    */
-  source?: Source
+  source?: Node.Source
 
   /**
    * Information to generate byte-to-byte equal node string as it was
@@ -222,7 +229,7 @@ export default abstract class Node {
    *
    * @return Error object to throw it.
    */
-  error(message: string, options?: NodeErrorOptions): CssSyntaxError
+  error(message: string, options?: Node.NodeErrorOptions): CssSyntaxError
 
   /**
    * This method is provided as a convenience wrapper for `Result#warn`.
@@ -337,7 +344,7 @@ export default abstract class Node {
    * @return Current node to methods chain.
    */
   replaceWith(
-    ...nodes: (ChildNode | ChildProps | ChildNode[] | ChildProps[])[]
+    ...nodes: (Node.ChildNode | Node.ChildProps | Node.ChildNode[] | Node.ChildProps[])[]
   ): this
 
   /**
@@ -355,7 +362,7 @@ export default abstract class Node {
    *
    * @return Next node.
    */
-  next(): ChildNode | undefined
+  next(): Node.ChildNode | undefined
 
   /**
    * Returns the previous child of the node’s parent.
@@ -370,7 +377,7 @@ export default abstract class Node {
    *
    * @return Previous node.
    */
-  prev(): ChildNode | undefined
+  prev(): Node.ChildNode | undefined
 
   /**
    * Insert new node before current node to current node’s parent.
@@ -384,7 +391,7 @@ export default abstract class Node {
    * @param newNode New node.
    * @return This node for methods chain.
    */
-  before(newNode: Node | ChildProps | string | Node[]): this
+  before(newNode: Node | Node.ChildProps | string | Node[]): this
 
   /**
    * Insert new node after current node to current node’s parent.
@@ -398,7 +405,7 @@ export default abstract class Node {
    * @param newNode New node.
    * @return This node for methods chain.
    */
-  after(newNode: Node | ChildProps | string | Node[]): this
+  after(newNode: Node | Node.ChildProps | string | Node[]): this
 
   /**
    * Finds the Root instance of the node’s tree.
@@ -457,7 +464,7 @@ export default abstract class Node {
    * @param index The symbol number in the node’s string.
    * @return Symbol position in file.
    */
-  positionInside(index: number): Position
+  positionInside(index: number): Node.Position
 
   /**
    * Get the position for a word or an index inside the node.
@@ -465,7 +472,7 @@ export default abstract class Node {
    * @param opts Options.
    * @return Position.
    */
-  positionBy(opts?: Pick<WarningOptions, 'word' | 'index'>): Position
+  positionBy(opts?: Pick<WarningOptions, 'word' | 'index'>): Node.Position
 
   /**
    * Get the range for a word or start and end index inside the node.
@@ -474,5 +481,9 @@ export default abstract class Node {
    * @param opts Options.
    * @return Range.
    */
-  rangeBy(opts?: Pick<WarningOptions, 'word' | 'index' | 'endIndex'>): Range
+  rangeBy(opts?: Pick<WarningOptions, 'word' | 'index' | 'endIndex'>): Node.Range
 }
+
+declare class Node extends Node_ {}
+
+export = Node

package/lib/parse.d.ts

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

package/lib/postcss.d.mts

@@ -0,0 +1,72 @@
+export {
+  // postcss function / namespace
+  default,
+
+  // Value exports from postcss.mjs
+  stringify,
+  fromJSON,
+  // @ts-expect-error This value exists, but it’s untyped.
+  plugin,
+  parse,
+  list,
+
+  document,
+  comment,
+  atRule,
+  rule,
+  decl,
+  root,
+
+  CssSyntaxError,
+  Declaration,
+  Container,
+  Processor,
+  Document,
+  Comment,
+  Warning,
+  AtRule,
+  Result,
+  Input,
+  Rule,
+  Root,
+  Node,
+
+  // Type-only exports
+  AcceptedPlugin,
+  AnyNode,
+  AtRuleProps,
+  Builder,
+  ChildNode,
+  ChildProps,
+  CommentProps,
+  ContainerProps,
+  DeclarationProps,
+  DocumentProps,
+  FilePosition,
+  Helpers,
+  JSONHydrator,
+  Message,
+  NodeErrorOptions,
+  NodeProps,
+  OldPlugin,
+  Parser,
+  Plugin,
+  PluginCreator,
+  Position,
+  Postcss,
+  ProcessOptions,
+  RootProps,
+  RuleProps,
+  Source,
+  SourceMap,
+  SourceMapOptions,
+  Stringifier,
+  Syntax,
+  TransformCallback,
+  Transformer,
+  WarningOptions,
+
+  // This is a class, but it’s not re-exported. That’s why it’s exported as type-only here.
+  type LazyResult,
+
+} from './postcss.js'