[6a3a178] | 1 | import Container, { ContainerProps } from './container.js'
|
---|
| 2 | import Document from './document.js'
|
---|
| 3 | import { ProcessOptions } from './postcss.js'
|
---|
| 4 | import Result from './result.js'
|
---|
| 5 |
|
---|
| 6 | interface RootRaws extends Record<string, any> {
|
---|
| 7 | /**
|
---|
| 8 | * The space symbols after the last child to the end of file.
|
---|
| 9 | */
|
---|
| 10 | after?: string
|
---|
| 11 |
|
---|
| 12 | /**
|
---|
| 13 | * Non-CSS code before `Root`, when `Root` is inside `Document`.
|
---|
| 14 | *
|
---|
| 15 | * **Experimental:** some aspects of this node could change within minor
|
---|
| 16 | * or patch version releases.
|
---|
| 17 | */
|
---|
| 18 | codeBefore?: string
|
---|
| 19 |
|
---|
| 20 | /**
|
---|
| 21 | * Non-CSS code after `Root`, when `Root` is inside `Document`.
|
---|
| 22 | *
|
---|
| 23 | * **Experimental:** some aspects of this node could change within minor
|
---|
| 24 | * or patch version releases.
|
---|
| 25 | */
|
---|
| 26 | codeAfter?: string
|
---|
| 27 |
|
---|
| 28 | /**
|
---|
| 29 | * Is the last child has an (optional) semicolon.
|
---|
| 30 | */
|
---|
| 31 | semicolon?: boolean
|
---|
| 32 | }
|
---|
| 33 |
|
---|
| 34 | export interface RootProps extends ContainerProps {
|
---|
| 35 | /**
|
---|
| 36 | * Information used to generate byte-to-byte equal node string
|
---|
| 37 | * as it was in the origin input.
|
---|
| 38 | * */
|
---|
| 39 | raws?: RootRaws
|
---|
| 40 | }
|
---|
| 41 |
|
---|
| 42 | /**
|
---|
| 43 | * Represents a CSS file and contains all its parsed nodes.
|
---|
| 44 | *
|
---|
| 45 | * ```js
|
---|
| 46 | * const root = postcss.parse('a{color:black} b{z-index:2}')
|
---|
| 47 | * root.type //=> 'root'
|
---|
| 48 | * root.nodes.length //=> 2
|
---|
| 49 | * ```
|
---|
| 50 | */
|
---|
| 51 | export default class Root extends Container {
|
---|
| 52 | type: 'root'
|
---|
| 53 | parent: Document | undefined
|
---|
| 54 | raws: RootRaws
|
---|
| 55 |
|
---|
| 56 | /**
|
---|
| 57 | * Returns a `Result` instance representing the root’s CSS.
|
---|
| 58 | *
|
---|
| 59 | * ```js
|
---|
| 60 | * const root1 = postcss.parse(css1, { from: 'a.css' })
|
---|
| 61 | * const root2 = postcss.parse(css2, { from: 'b.css' })
|
---|
| 62 | * root1.append(root2)
|
---|
| 63 | * const result = root1.toResult({ to: 'all.css', map: true })
|
---|
| 64 | * ```
|
---|
| 65 | *
|
---|
| 66 | * @param opts Options.
|
---|
| 67 | * @return Result with current root’s CSS.
|
---|
| 68 | */
|
---|
| 69 | toResult(options?: ProcessOptions): Result
|
---|
| 70 |
|
---|
| 71 | constructor(defaults?: RootProps)
|
---|
| 72 | assign(overrides: object | RootProps): this
|
---|
| 73 | }
|
---|