postcss 8.2.13 → 8.3.1

package/lib/at-rule.d.ts

@@ -37,8 +37,11 @@ interface 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
 }
 
@@ -69,6 +72,7 @@ export interface AtRuleProps extends ContainerProps {
  */
 export default class AtRule extends Container {
   type: 'atrule'
+  parent: Container | undefined
   raws: AtRuleRaws
 
   /**
@@ -95,6 +99,7 @@ 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

package/lib/comment.d.ts

@@ -1,3 +1,4 @@
+import Container from './container.js'
 import Node, { NodeProps } from './node.js'
 
 interface CommentRaws {
@@ -18,7 +19,9 @@ interface 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
 }
 
@@ -37,6 +40,7 @@ export interface CommentProps extends NodeProps {
  */
 export default class Comment extends Node {
   type: 'comment'
+  parent: Container | undefined
   raws: CommentRaws
 
   /**
@@ -45,6 +49,7 @@ export default class Comment extends Node {
   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

package/lib/container.d.ts

@@ -27,7 +27,9 @@ 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 extends Node {
+export default abstract class Container<
+  Child extends Node = ChildNode
+> extends Node {
   /**
    * An array containing the container’s children.
    *
@@ -38,7 +40,7 @@ export default abstract class Container extends Node {
    * root.nodes[0].nodes[0].prop //=> 'color'
    * ```
    */
-  nodes: ChildNode[]
+  nodes: Child[]
 
   /**
    * The container’s first child.
@@ -47,7 +49,7 @@ export default abstract class Container extends Node {
    * rule.first === rules.nodes[0]
    * ```
    */
-  get first(): ChildNode | undefined
+  get first(): Child | undefined
 
   /**
    * The container’s last child.
@@ -56,7 +58,7 @@ export default abstract class Container extends Node {
    * rule.last === rule.nodes[rule.nodes.length - 1]
    * ```
    */
-  get last(): ChildNode | undefined
+  get last(): Child | undefined
 
   /**
    * Iterates through the container’s immediate children,
@@ -92,7 +94,7 @@ export default abstract class Container extends Node {
    * @return Returns `false` if iteration was broke.
    */
   each(
-    callback: (node: ChildNode, index: number) => false | void
+    callback: (node: Child, index: number) => false | void
   ): false | undefined
 
   /**
@@ -304,7 +306,7 @@ export default abstract class Container extends Node {
    * @param child New node.
    * @return This node for methods chain.
    */
-  push(child: ChildNode): this
+  push(child: Child): this
 
   /**
    * Insert new node before old node within the container.
@@ -318,14 +320,8 @@ export default abstract class Container extends Node {
    * @return This node for methods chain.
    */
   insertBefore(
-    oldNode: ChildNode | number,
-    newNode:
-      | ChildNode
-      | ChildProps
-      | string
-      | ChildNode[]
-      | ChildProps[]
-      | string[]
+    oldNode: Child | number,
+    newNode: Child | ChildProps | string | Child[] | ChildProps[] | string[]
   ): this
 
   /**
@@ -336,14 +332,8 @@ export default abstract class Container extends Node {
    * @return This node for methods chain.
    */
   insertAfter(
-    oldNode: ChildNode | number,
-    newNode:
-      | ChildNode
-      | ChildProps
-      | string
-      | ChildNode[]
-      | ChildProps[]
-      | string[]
+    oldNode: Child | number,
+    newNode: Child | ChildProps | string | Child[] | ChildProps[] | string[]
   ): this
 
   /**
@@ -360,7 +350,7 @@ export default abstract class Container extends Node {
    * @param child Child or child’s index.
    * @return This node for methods chain.
    */
-  removeChild(child: ChildNode | number): this
+  removeChild(child: Child | number): this
 
   /**
    * Removes all children from the container
@@ -420,7 +410,7 @@ export default abstract class Container extends Node {
    * @return Is every child pass condition.
    */
   every(
-    condition: (node: ChildNode, index: number, nodes: ChildNode[]) => boolean
+    condition: (node: Child, index: number, nodes: Child[]) => boolean
   ): boolean
 
   /**
@@ -435,7 +425,7 @@ export default abstract class Container extends Node {
    * @return Is some child pass condition.
    */
   some(
-    condition: (node: ChildNode, index: number, nodes: ChildNode[]) => boolean
+    condition: (node: Child, index: number, nodes: Child[]) => boolean
   ): boolean
 
   /**
@@ -448,5 +438,5 @@ export default abstract class Container extends Node {
    * @param child Child of the current container.
    * @return Child index.
    */
-  index(child: ChildNode | number): number
+  index(child: Child | number): number
 }

package/lib/container.js

@@ -310,7 +310,7 @@ class Container extends Node {
       for (let i of nodes) {
         if (i.parent) i.parent.removeChild(i, 'ignore')
       }
-    } else if (nodes.type === 'root') {
+    } else if (nodes.type === 'root' && this.type !== 'document') {
       nodes = nodes.nodes.slice(0)
       for (let i of nodes) {
         if (i.parent) i.parent.removeChild(i, 'ignore')

package/lib/declaration.d.ts

@@ -1,3 +1,4 @@
+import Container from './container.js'
 import Node from './node.js'
 
 interface DeclarationRaws {
@@ -27,8 +28,13 @@ interface 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
 }
 
@@ -51,6 +57,7 @@ export interface DeclarationProps {
  */
 export default class Declaration extends Node {
   type: 'decl'
+  parent: Container | undefined
   raws: DeclarationRaws
 
   /**
@@ -110,6 +117,7 @@ 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

package/lib/document.d.ts

@@ -0,0 +1,57 @@
+import Container, { ContainerProps } from './container.js'
+import { ProcessOptions } from './postcss.js'
+import Result from './result.js'
+import Root, { RootProps } from './root.js'
+
+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>
+}
+
+type ChildNode = Root
+type ChildProps = RootProps
+
+/**
+ * Represents a file and contains all its parsed nodes.
+ *
+ * **Experimental:** some aspects of this node could change within minor
+ * or patch version releases.
+ *
+ * ```js
+ * const document = htmlParser(
+ *   '<html><style>a{color:black}</style><style>b{z-index:2}</style>'
+ * )
+ * document.type         //=> 'document'
+ * document.nodes.length //=> 2
+ * ```
+ */
+export default class Document extends Container<Root> {
+  type: 'document'
+  parent: undefined
+
+  constructor(defaults?: DocumentProps)
+
+  /**
+   * Returns a `Result` instance representing the document’s CSS roots.
+   *
+   * ```js
+   * const root1 = postcss.parse(css1, { from: 'a.css' })
+   * const root2 = postcss.parse(css2, { from: 'b.css' })
+   * const document = postcss.document()
+   * document.append(root1)
+   * document.append(root2)
+   * const result = document.toResult({ to: 'all.css', map: true })
+   * ```
+   *
+   * @param opts Options.
+   * @return Result with current document’s CSS.
+   */
+  toResult(options?: ProcessOptions): Result
+}

package/lib/document.js

@@ -0,0 +1,33 @@
+'use strict'
+
+let Container = require('./container')
+
+let LazyResult, Processor
+
+class Document extends Container {
+  constructor(defaults) {
+    // type needs to be passed to super, otherwise child roots won't be normalized correctly
+    super({ type: 'document', ...defaults })
+
+    if (!this.nodes) {
+      this.nodes = []
+    }
+  }
+
+  toResult(opts = {}) {
+    let lazy = new LazyResult(new Processor(), this, opts)
+
+    return lazy.stringify()
+  }
+}
+
+Document.registerLazyResult = dependant => {
+  LazyResult = dependant
+}
+
+Document.registerProcessor = dependant => {
+  Processor = dependant
+}
+
+module.exports = Document
+Document.default = Document

package/lib/input.js

@@ -1,5 +1,6 @@
 'use strict'
 
+let { SourceMapConsumer, SourceMapGenerator } = require('source-map-js')
 let { fileURLToPath, pathToFileURL } = require('url')
 let { resolve, isAbsolute } = require('path')
 let { nanoid } = require('nanoid/non-secure')
@@ -10,6 +11,7 @@ let PreviousMap = require('./previous-map')
 
 let fromOffsetCache = Symbol('fromOffset cache')
 
+let sourceMapAvailable = Boolean(SourceMapConsumer && SourceMapGenerator)
 let pathAvailable = Boolean(resolve && isAbsolute)
 
 class Input {
@@ -43,7 +45,7 @@ class Input {
       }
     }
 
-    if (pathAvailable) {
+    if (pathAvailable && sourceMapAvailable) {
       let map = new PreviousMap(this.css, opts)
       if (map.text) {
         this.map = map
@@ -168,7 +170,7 @@ class Input {
         result.file = fileURLToPath(fromUrl)
       } else {
         // istanbul ignore next
-        throw new Error(`file: protocol is not available in this PostCSS build`);
+        throw new Error(`file: protocol is not available in this PostCSS build`)
       }
     }
 

package/lib/lazy-result.js

@@ -7,8 +7,10 @@ let warnOnce = require('./warn-once')
 let Result = require('./result')
 let parse = require('./parse')
 let Root = require('./root')
+let Document = require('./document')
 
 const TYPE_TO_CLASS_NAME = {
+  document: 'Document',
   root: 'Root',
   atrule: 'AtRule',
   rule: 'Rule',
@@ -20,6 +22,7 @@ const PLUGIN_PROPS = {
   postcssPlugin: true,
   prepare: true,
   Once: true,
+  Document: true,
   Root: true,
   Declaration: true,
   Rule: true,
@@ -30,6 +33,7 @@ const PLUGIN_PROPS = {
   AtRuleExit: true,
   CommentExit: true,
   RootExit: true,
+  DocumentExit: true,
   OnceExit: true
 }
 
@@ -73,7 +77,9 @@ function getEvents(node) {
 
 function toStack(node) {
   let events
-  if (node.type === 'root') {
+  if (node.type === 'document') {
+    events = ['Document', CHILDREN, 'DocumentExit']
+  } else if (node.type === 'root') {
     events = ['Root', CHILDREN, 'RootExit']
   } else {
     events = getEvents(node)
@@ -103,7 +109,11 @@ class LazyResult {
     this.processed = false
 
     let root
-    if (typeof css === 'object' && css !== null && css.type === 'root') {
+    if (
+      typeof css === 'object' &&
+      css !== null &&
+      (css.type === 'root' || css.type === 'document')
+    ) {
       root = cleanMarks(css)
     } else if (css instanceof LazyResult || css instanceof Result) {
       root = cleanMarks(css.root)
@@ -231,7 +241,13 @@ class LazyResult {
         this.walkSync(root)
       }
       if (this.listeners.OnceExit) {
-        this.visitSync(this.listeners.OnceExit, root)
+        if (root.type === 'document') {
+          for (let subRoot of root.nodes) {
+            this.visitSync(this.listeners.OnceExit, subRoot)
+          }
+        } else {
+          this.visitSync(this.listeners.OnceExit, root)
+        }
       }
     }
 
@@ -287,7 +303,9 @@ class LazyResult {
       } catch (e) {
         throw this.handleError(e, node.proxyOf)
       }
-      if (node.type !== 'root' && !node.parent) return true
+      if (node.type !== 'root' && node.type !== 'document' && !node.parent) {
+        return true
+      }
       if (isPromise(promise)) {
         throw this.getAsyncError()
       }
@@ -298,6 +316,18 @@ class LazyResult {
     this.result.lastPlugin = plugin
     try {
       if (typeof plugin === 'object' && plugin.Once) {
+        if (this.result.root.type === 'document') {
+          let roots = this.result.root.nodes.map(root =>
+            plugin.Once(root, this.helpers)
+          )
+
+          if (isPromise(roots[0])) {
+            return Promise.all(roots)
+          }
+
+          return roots
+        }
+
         return plugin.Once(this.result.root, this.helpers)
       } else if (typeof plugin === 'function') {
         return plugin(this.result.root, this.result)
@@ -385,7 +415,15 @@ class LazyResult {
         for (let [plugin, visitor] of this.listeners.OnceExit) {
           this.result.lastPlugin = plugin
           try {
-            await visitor(root, this.helpers)
+            if (root.type === 'document') {
+              let roots = root.nodes.map(subRoot =>
+                visitor(subRoot, this.helpers)
+              )
+
+              await Promise.all(roots)
+            } else {
+              await visitor(root, this.helpers)
+            }
           } catch (e) {
             throw this.handleError(e)
           }
@@ -439,7 +477,7 @@ class LazyResult {
     let visit = stack[stack.length - 1]
     let { node, visitors } = visit
 
-    if (node.type !== 'root' && !node.parent) {
+    if (node.type !== 'root' && node.type !== 'document' && !node.parent) {
       stack.pop()
       return
     }
@@ -501,3 +539,4 @@ module.exports = LazyResult
 LazyResult.default = LazyResult
 
 Root.registerLazyResult(LazyResult)
+Document.registerLazyResult(LazyResult)

package/lib/list.d.ts

@@ -1,4 +1,19 @@
 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).

package/lib/map-generator.js

@@ -1,9 +1,10 @@
 'use strict'
 
+let { SourceMapConsumer, SourceMapGenerator } = require('source-map-js')
 let { dirname, resolve, relative, sep } = require('path')
 let { pathToFileURL } = require('url')
-let mozilla = require('source-map')
 
+let sourceMapAvailable = Boolean(SourceMapConsumer && SourceMapGenerator)
 let pathAvailable = Boolean(dirname && resolve && relative && sep)
 
 class MapGenerator {
@@ -99,7 +100,7 @@ class MapGenerator {
       let map
 
       if (this.mapOpts.sourcesContent === false) {
-        map = new mozilla.SourceMapConsumer(prev.text)
+        map = new SourceMapConsumer(prev.text)
         if (map.sourcesContent) {
           map.sourcesContent = map.sourcesContent.map(() => null)
         }
@@ -206,7 +207,9 @@ class MapGenerator {
         return pathToFileURL(node.source.input.from).toString()
       } else {
         // istanbul ignore next
-        throw new Error('`map.absolute` option is not available in this PostCSS build')
+        throw new Error(
+          '`map.absolute` option is not available in this PostCSS build'
+        )
       }
     } else {
       return this.toUrl(this.path(node.source.input.from))
@@ -215,7 +218,7 @@ class MapGenerator {
 
   generateString() {
     this.css = ''
-    this.map = new mozilla.SourceMapGenerator({ file: this.outputFile() })
+    this.map = new SourceMapGenerator({ file: this.outputFile() })
 
     let line = 1
     let column = 1
@@ -282,7 +285,7 @@ class MapGenerator {
   generate() {
     this.clearAnnotation()
 
-    if (pathAvailable && this.isMap()) {
+    if (pathAvailable && sourceMapAvailable && this.isMap()) {
       return this.generateMap()
     }
 

package/lib/node.d.ts

@@ -5,14 +5,15 @@ import AtRule, { AtRuleProps } from './at-rule.js'
 import Rule, { RuleProps } from './rule.js'
 import { WarningOptions } from './warning.js'
 import CssSyntaxError from './css-syntax-error.js'
-import Container from './container.js'
 import Result from './result.js'
 import Input from './input.js'
 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
+export type AnyNode = AtRule | Rule | Declaration | Comment | Root | Document
 
 export type ChildProps =
   | AtRuleProps
@@ -97,7 +98,7 @@ export default abstract class Node {
    * root.nodes[0].parent === root
    * ```
    */
-  parent: Container | undefined
+  parent: Document | Container | undefined
 
   /**
    * The input source of the node.
@@ -251,6 +252,18 @@ export default abstract class Node {
    */
   toString(stringifier?: Stringifier | Syntax): string
 
+  /**
+   * Assigns properties to the current node.
+   *
+   * ```js
+   * decl.assign({ prop: 'word-wrap', value: 'break-word' })
+   * ```
+   *
+   * @param overrides New properties to override the node.
+   * @return Current node to methods chain.
+   */
+  assign(overrides: object): this
+
   /**
    * Returns an exact clone of the node.
    *

package/lib/node.js

@@ -84,6 +84,13 @@ class Node {
     return result
   }
 
+  assign(overrides = {}) {
+    for (let name in overrides) {
+      this[name] = overrides[name]
+    }
+    return this
+  }
+
   clone(overrides = {}) {
     let cloned = cloneNode(this)
     for (let name in overrides) {
@@ -151,7 +158,9 @@ class Node {
 
   root() {
     let result = this
-    while (result.parent) result = result.parent
+    while (result.parent && result.parent.type !== 'document') {
+      result = result.parent
+    }
     return result
   }
 

package/lib/postcss.d.ts

@@ -1,4 +1,4 @@
-import { SourceMapGenerator, RawSourceMap } from 'source-map'
+import { SourceMapGenerator, RawSourceMap } from 'source-map-js'
 
 import Node, {
   Position,
@@ -11,6 +11,7 @@ import Node, {
 } from './node.js'
 import Declaration, { DeclarationProps } from './declaration.js'
 import Root, { RootProps } from './root.js'
+import Document, { DocumentProps } from './document.js'
 import Comment, { CommentProps } from './comment.js'
 import AtRule, { AtRuleProps } from './at-rule.js'
 import Result, { Message } from './result.js'
@@ -40,6 +41,7 @@ export {
   ChildProps,
   AtRuleProps,
   RootProps,
+  DocumentProps,
   Warning,
   CssSyntaxError,
   Node,
@@ -50,6 +52,7 @@ export {
   AtRule,
   Rule,
   Root,
+  Document,
   Result,
   LazyResult,
   Input
@@ -61,6 +64,10 @@ export type SourceMap = SourceMapGenerator & {
 
 export type Helpers = { result: Result; postcss: Postcss } & Postcss
 
+type DocumentProcessor = (
+  document: Document,
+  helper: Helpers
+) => Promise<void> | void
 type RootProcessor = (root: Root, helper: Helpers) => Promise<void> | void
 type DeclarationProcessor = (
   decl: Declaration,
@@ -74,6 +81,20 @@ type CommentProcessor = (
 ) => Promise<void> | void
 
 interface Processors {
+  /**
+   * Will be called on `Document` node.
+   *
+   * Will be called again on children changes.
+   */
+  Document?: DocumentProcessor
+
+  /**
+   * Will be called on `Document` node, when all children will be processed.
+   *
+   * Will be called again on children changes.
+   */
+  DocumentExit?: DocumentProcessor
+
   /**
    * Will be called on `Root` node once.
    */
@@ -200,11 +221,11 @@ export type AcceptedPlugin =
     }
   | Processor
 
-export interface Parser {
+export interface Parser<RootNode = Root> {
   (
     css: string | { toString(): string },
     opts?: Pick<ProcessOptions, 'map' | 'from'>
-  ): Root
+  ): RootNode
 }
 
 export interface Builder {
@@ -224,7 +245,7 @@ export interface Syntax {
   /**
    * Function to generate AST by string.
    */
-  parse?: Parser
+  parse?: Parser<Root | Document>
 
   /**
    * Class to generate string by AST.
@@ -347,7 +368,7 @@ export interface Postcss {
   stringify: Stringifier
 
   /**
-   * Parses source css and returns a new `Root` node,
+   * Parses source css and returns a new `Root` or `Document` node,
    * which contains the source CSS nodes.
    *
    * ```js
@@ -415,6 +436,14 @@ export interface Postcss {
    */
   root(defaults?: RootProps): Root
 
+  /**
+   * Creates a new `Document` node.
+   *
+   * @param defaults Properties for the new node.
+   * @return New document node.
+   */
+  document(defaults?: DocumentProps): Document
+
   CssSyntaxError: typeof CssSyntaxError
   Declaration: typeof Declaration
   Container: typeof Container

package/lib/postcss.js

@@ -7,6 +7,7 @@ let Container = require('./container')
 let Processor = require('./processor')
 let stringify = require('./stringify')
 let fromJSON = require('./fromJSON')
+let Document = require('./document')
 let Warning = require('./warning')
 let Comment = require('./comment')
 let AtRule = require('./at-rule')
@@ -73,10 +74,12 @@ postcss.atRule = defaults => new AtRule(defaults)
 postcss.decl = defaults => new Declaration(defaults)
 postcss.rule = defaults => new Rule(defaults)
 postcss.root = defaults => new Root(defaults)
+postcss.document = defaults => new Document(defaults)
 
 postcss.CssSyntaxError = CssSyntaxError
 postcss.Declaration = Declaration
 postcss.Container = Container
+postcss.Document = Document
 postcss.Comment = Comment
 postcss.Warning = Warning
 postcss.AtRule = AtRule

package/lib/postcss.mjs

@@ -13,10 +13,12 @@ export const atRule = postcss.atRule
 export const rule = postcss.rule
 export const decl = postcss.decl
 export const root = postcss.root
+export const document = postcss.document
 
 export const CssSyntaxError = postcss.CssSyntaxError
 export const Declaration = postcss.Declaration
 export const Container = postcss.Container
+export const Document = postcss.Document
 export const Comment = postcss.Comment
 export const Warning = postcss.Warning
 export const AtRule = postcss.AtRule

package/lib/previous-map.d.ts

@@ -1,4 +1,4 @@
-import { SourceMapConsumer } from 'source-map'
+import { SourceMapConsumer } from 'source-map-js'
 
 import { ProcessOptions } from './postcss.js'
 

package/lib/previous-map.js

@@ -2,7 +2,7 @@
 
 let { existsSync, readFileSync } = require('fs')
 let { dirname, join } = require('path')
-let mozilla = require('source-map')
+let { SourceMapConsumer, SourceMapGenerator } = require('source-map-js')
 
 function fromBase64(str) {
   if (Buffer) {
@@ -30,7 +30,7 @@ class PreviousMap {
 
   consumer() {
     if (!this.consumerCache) {
-      this.consumerCache = new mozilla.SourceMapConsumer(this.text)
+      this.consumerCache = new SourceMapConsumer(this.text)
     }
     return this.consumerCache
   }
@@ -48,11 +48,15 @@ class PreviousMap {
   }
 
   getAnnotationURL(sourceMapString) {
-    return sourceMapString.match(/\/\*\s*# sourceMappingURL=((?:(?!sourceMappingURL=).)*)\*\//)[1].trim()
+    return sourceMapString
+      .match(/\/\*\s*# sourceMappingURL=((?:(?!sourceMappingURL=).)*)\*\//)[1]
+      .trim()
   }
 
   loadAnnotation(css) {
-    let annotations = css.match(/\/\*\s*# sourceMappingURL=(?:(?!sourceMappingURL=).)*\*\//gm)
+    let annotations = css.match(
+      /\/\*\s*# sourceMappingURL=(?:(?!sourceMappingURL=).)*\*\//gm
+    )
 
     if (annotations && annotations.length > 0) {
       // Locate the last sourceMappingURL to avoid picking up
@@ -107,9 +111,9 @@ class PreviousMap {
           }
           return map
         }
-      } else if (prev instanceof mozilla.SourceMapConsumer) {
-        return mozilla.SourceMapGenerator.fromSourceMap(prev).toString()
-      } else if (prev instanceof mozilla.SourceMapGenerator) {
+      } else if (prev instanceof SourceMapConsumer) {
+        return SourceMapGenerator.fromSourceMap(prev).toString()
+      } else if (prev instanceof SourceMapGenerator) {
         return prev.toString()
       } else if (this.isMap(prev)) {
         return JSON.stringify(prev)

package/lib/processor.js

@@ -2,10 +2,11 @@
 
 let LazyResult = require('./lazy-result')
 let Root = require('./root')
+let Document = require('./document')
 
 class Processor {
   constructor(plugins = []) {
-    this.version = '8.2.13'
+    this.version = '8.3.1'
     this.plugins = this.normalize(plugins)
   }
 
@@ -17,7 +18,9 @@ class Processor {
   process(css, opts = {}) {
     if (
       this.plugins.length === 0 &&
-      opts.parser === opts.stringifier &&
+      typeof opts.parser === 'undefined' &&
+      typeof opts.stringifier === 'undefined' &&
+      typeof opts.syntax === 'undefined' &&
       !opts.hideNothingWarning
     ) {
       if (process.env.NODE_ENV !== 'production') {
@@ -68,3 +71,4 @@ module.exports = Processor
 Processor.default = Processor
 
 Root.registerProcessor(Processor)
+Document.registerProcessor(Processor)

package/lib/root.d.ts

@@ -1,13 +1,30 @@
 import Container, { ContainerProps } from './container.js'
+import Document from './document.js'
 import { ProcessOptions } from './postcss.js'
 import Result from './result.js'
 
-interface RootRaws {
+interface RootRaws extends Record<string, any> {
   /**
    * The space symbols after the last child to the end of file.
    */
   after?: string
 
+  /**
+   * Non-CSS code before `Root`, when `Root` is inside `Document`.
+   *
+   * **Experimental:** some aspects of this node could change within minor
+   * or patch version releases.
+   */
+  codeBefore?: string
+
+  /**
+   * Non-CSS code after `Root`, when `Root` is inside `Document`.
+   *
+   * **Experimental:** some aspects of this node could change within minor
+   * or patch version releases.
+   */
+  codeAfter?: string
+
   /**
    * Is the last child has an (optional) semicolon.
    */
@@ -15,6 +32,10 @@ interface RootRaws {
 }
 
 export interface RootProps extends ContainerProps {
+  /**
+   * Information used to generate byte-to-byte equal node string
+   * as it was in the origin input.
+   * */
   raws?: RootRaws
 }
 
@@ -29,11 +50,9 @@ export interface RootProps extends ContainerProps {
  */
 export default class Root extends Container {
   type: 'root'
-  parent: undefined
+  parent: Document | undefined
   raws: RootRaws
 
-  constructor(defaults?: RootProps)
-
   /**
    * Returns a `Result` instance representing the root’s CSS.
    *
@@ -48,4 +67,7 @@ export default class Root extends Container {
    * @return Result with current root’s CSS.
    */
   toResult(options?: ProcessOptions): Result
+
+  constructor(defaults?: RootProps)
+  assign(overrides: object | RootProps): this
 }

package/lib/rule.d.ts

@@ -37,8 +37,11 @@ interface RuleRaws {
 }
 
 export interface RuleProps extends ContainerProps {
+  /** Selector or selectors of the rule. */
   selector?: string
+  /** Selectors of the rule represented as an array of strings. */
   selectors?: string[]
+  /** Information used to generate byte-to-byte equal node string as it was in the origin input. */
   raws?: RuleRaws
 }
 
@@ -62,6 +65,7 @@ export interface RuleProps extends ContainerProps {
  */
 export default class Rule extends Container {
   type: 'rule'
+  parent: Container | undefined
   raws: RuleRaws
 
   /**
@@ -93,6 +97,7 @@ export default class Rule extends Container {
   selectors: string[]
 
   constructor(defaults?: RuleProps)
+  assign(overrides: object | RuleProps): this
   clone(overrides?: Partial<RuleProps>): this
   cloneBefore(overrides?: Partial<RuleProps>): this
   cloneAfter(overrides?: Partial<RuleProps>): this

package/lib/stringifier.js

@@ -37,6 +37,10 @@ class Stringifier {
     this[node.type](node, semicolon)
   }
 
+  document(node) {
+    this.body(node)
+  }
+
   root(node) {
     this.body(node)
     if (node.raws.after) this.builder(node.raws.after)
@@ -129,11 +133,16 @@ class Stringifier {
 
     let parent = node.parent
 
-    // Hack for first rule in CSS
     if (detect === 'before') {
+      // Hack for first rule in CSS
       if (!parent || (parent.type === 'root' && parent.first === node)) {
         return ''
       }
+
+      // `root` nodes in `document` should use only their own raws
+      if (parent && parent.type === 'document') {
+        return ''
+      }
     }
 
     // Floating child without parent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postcss",
-  "version": "8.2.13",
+  "version": "8.3.1",
   "description": "Tool for transforming styles with JS plugins",
   "engines": {
     "node": "^10 || ^12 || >=14"
@@ -62,14 +62,15 @@
   "repository": "postcss/postcss",
   "dependencies": {
     "colorette": "^1.2.2",
-    "nanoid": "^3.1.22",
-    "source-map": "^0.6.1"
+    "nanoid": "^3.1.23",
+    "source-map-js": "^0.6.2"
   },
   "browser": {
     "./lib/terminal-highlight": false,
+    "source-map-js": false,
     "colorette": false,
-    "fs": false,
     "path": false,
-    "url": false
+    "url": false,
+    "fs": false
   }
 }