forked from rDrama/rDrama
103 lines
3.0 KiB
TypeScript
103 lines
3.0 KiB
TypeScript
|
import {
|
|||
|
AcceptedPlugin,
|
|||
|
Plugin,
|
|||
|
ProcessOptions,
|
|||
|
Transformer,
|
|||
|
TransformCallback
|
|||
|
} from './postcss.js'
|
|||
|
import LazyResult from './lazy-result.js'
|
|||
|
import Result from './result.js'
|
|||
|
import Root from './root.js'
|
|||
|
import NoWorkResult from './no-work-result.js'
|
|||
|
|
|||
|
/**
|
|||
|
* Contains plugins to process CSS. Create one `Processor` instance,
|
|||
|
* initialize its plugins, and then use that instance on numerous CSS files.
|
|||
|
*
|
|||
|
* ```js
|
|||
|
* const processor = postcss([autoprefixer, postcssNested])
|
|||
|
* processor.process(css1).then(result => console.log(result.css))
|
|||
|
* processor.process(css2).then(result => console.log(result.css))
|
|||
|
* ```
|
|||
|
*/
|
|||
|
export default class Processor {
|
|||
|
/**
|
|||
|
* Current PostCSS version.
|
|||
|
*
|
|||
|
* ```js
|
|||
|
* if (result.processor.version.split('.')[0] !== '6') {
|
|||
|
* throw new Error('This plugin works only with PostCSS 6')
|
|||
|
* }
|
|||
|
* ```
|
|||
|
*/
|
|||
|
version: string
|
|||
|
|
|||
|
/**
|
|||
|
* Plugins added to this processor.
|
|||
|
*
|
|||
|
* ```js
|
|||
|
* const processor = postcss([autoprefixer, postcssNested])
|
|||
|
* processor.plugins.length //=> 2
|
|||
|
* ```
|
|||
|
*/
|
|||
|
plugins: (Plugin | Transformer | TransformCallback)[]
|
|||
|
|
|||
|
/**
|
|||
|
* @param plugins PostCSS plugins
|
|||
|
*/
|
|||
|
constructor(plugins?: AcceptedPlugin[])
|
|||
|
|
|||
|
/**
|
|||
|
* Adds a plugin to be used as a CSS processor.
|
|||
|
*
|
|||
|
* PostCSS plugin can be in 4 formats:
|
|||
|
* * A plugin in `Plugin` format.
|
|||
|
* * A plugin creator function with `pluginCreator.postcss = true`.
|
|||
|
* PostCSS will call this function without argument to get plugin.
|
|||
|
* * A function. PostCSS will pass the function a @{link Root}
|
|||
|
* as the first argument and current `Result` instance
|
|||
|
* as the second.
|
|||
|
* * Another `Processor` instance. PostCSS will copy plugins
|
|||
|
* from that instance into this one.
|
|||
|
*
|
|||
|
* Plugins can also be added by passing them as arguments when creating
|
|||
|
* a `postcss` instance (see [`postcss(plugins)`]).
|
|||
|
*
|
|||
|
* Asynchronous plugins should return a `Promise` instance.
|
|||
|
*
|
|||
|
* ```js
|
|||
|
* const processor = postcss()
|
|||
|
* .use(autoprefixer)
|
|||
|
* .use(postcssNested)
|
|||
|
* ```
|
|||
|
*
|
|||
|
* @param plugin PostCSS plugin or `Processor` with plugins.
|
|||
|
* @return {Processes} Current processor to make methods chain.
|
|||
|
*/
|
|||
|
use(plugin: AcceptedPlugin): this
|
|||
|
|
|||
|
/**
|
|||
|
* Parses source CSS and returns a `LazyResult` Promise proxy.
|
|||
|
* Because some plugins can be asynchronous it doesn’t make
|
|||
|
* any transformations. Transformations will be applied
|
|||
|
* in the `LazyResult` methods.
|
|||
|
*
|
|||
|
* ```js
|
|||
|
* processor.process(css, { from: 'a.css', to: 'a.out.css' })
|
|||
|
* .then(result => {
|
|||
|
* console.log(result.css)
|
|||
|
* })
|
|||
|
* ```
|
|||
|
*
|
|||
|
* @param css String with input CSS or any object with a `toString()` method,
|
|||
|
* like a Buffer. Optionally, senda `Result` instance
|
|||
|
* and the processor will take the `Root` from it.
|
|||
|
* @param opts Options.
|
|||
|
* @return Promise proxy.
|
|||
|
*/
|
|||
|
process(
|
|||
|
css: string | { toString(): string } | Result | LazyResult | Root,
|
|||
|
options?: ProcessOptions
|
|||
|
): LazyResult | NoWorkResult
|
|||
|
}
|