123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302 |
- import * as mozilla from 'source-map';
-
- /**
- * @param plugins Can also be included with the Processor#use method.
- * @returns A processor that will apply plugins as CSS processors.
- */
- declare function postcss(plugins?: postcss.AcceptedPlugin[]): postcss.Processor;
- declare function postcss(...plugins: postcss.AcceptedPlugin[]): postcss.Processor;
- declare namespace postcss {
- type AcceptedPlugin = Plugin<any> | Transformer | {
- postcss: TransformCallback | Processor;
- } | Processor;
- /**
- * Creates a PostCSS plugin with a standard API.
- * @param name Plugin name. Same as in name property in package.json. It will
- * be saved in plugin.postcssPlugin property.
- * @param initializer Will receive plugin options and should return functions
- * to modify nodes in input CSS.
- */
- function plugin<T>(name: string, initializer: PluginInitializer<T>): Plugin<T>;
- interface Plugin<T> extends Transformer {
- (opts?: T): Transformer;
- postcss: Transformer;
- process: (css: string | {
- toString(): string;
- } | Result, opts?: any) => LazyResult;
- }
- interface Transformer extends TransformCallback {
- postcssPlugin?: string;
- postcssVersion?: string;
- }
- interface TransformCallback {
- /**
- * @returns Asynchronous plugins should return a promise.
- */
- (root: Root, result?: Result): void | Function | any;
- }
- interface PluginInitializer<T> {
- (pluginOptions?: T): Transformer;
- }
- /**
- * Contains helpers for working with vendor prefixes.
- */
- export namespace vendor {
- /**
- * @returns The vendor prefix extracted from the input string.
- */
- function prefix(prop: string): string;
- /**
- * @returns The input string stripped of its vendor prefix.
- */
- function unprefixed(prop: string): string;
- }
- export class Stringifier {
- builder: Stringifier.Builder;
- constructor(builder?: Stringifier.Builder);
- stringify(node: Node, semicolon?: boolean): void;
- root(node: any): void;
- comment(node: any): void;
- decl(node: any, semicolon: any): void;
- rule(node: any): void;
- atrule(node: any, semicolon: any): void;
- body(node: any): void;
- block(node: any, start: any): void;
- raw(node: Node, own: string, detect?: string): any;
- rawSemicolon(root: any): any;
- rawEmptyBody(root: any): any;
- rawIndent(root: any): any;
- rawBeforeComment(root: any, node: any): any;
- rawBeforeDecl(root: any, node: any): any;
- rawBeforeRule(root: any): any;
- rawBeforeClose(root: any): any;
- rawBeforeOpen(root: any): any;
- rawColon(root: any): any;
- beforeAfter(node: any, detect: any): any;
- rawValue(node: any, prop: any): any;
- }
- export namespace Stringifier {
- interface Builder {
- (str: string, node?: Node, str2?: string): void;
- }
- }
- /**
- * Default function to convert a node tree into a CSS string.
- */
- function stringify(node: Node, builder: Stringifier.Builder): void;
- /**
- * Parses source CSS.
- * @param css The CSS to parse.
- * @param options
- * @returns {} A new Root node, which contains the source CSS nodes.
- */
- function parse(css: string | {
- toString(): string;
- } | LazyResult | Result, options?: {
- from?: string;
- map?: postcss.SourceMapOptions;
- }): Root;
- /**
- * Contains helpers for safely splitting lists of CSS values, preserving
- * parentheses and quotes.
- */
- export namespace list {
- /**
- * Safely splits space-separated values (such as those for background,
- * border-radius and other shorthand properties).
- */
- function space(str: string): string[];
- /**
- * Safely splits comma-separated values (such as those for transition-* and
- * background properties).
- */
- function comma(str: string): string[];
- }
- /**
- * Creates a new Comment node.
- * @param defaults Properties for the new Comment node.
- * @returns The new node.
- */
- function comment(defaults?: CommentNewProps): Comment;
- /**
- * Creates a new AtRule node.
- * @param defaults Properties for the new AtRule node.
- * @returns The new node.
- */
- function atRule(defaults?: AtRuleNewProps): AtRule;
- /**
- * Creates a new Declaration node.
- * @param defaults Properties for the new Declaration node.
- * @returns The new node.
- */
- function decl(defaults?: DeclarationNewProps): Declaration;
- /**
- * Creates a new Rule node.
- * @param defaults Properties for the new Rule node.
- * @returns The new node.
- */
- function rule(defaults?: RuleNewProps): Rule;
- /**
- * Creates a new Root node.
- * @param defaults Properties for the new Root node.
- * @returns The new node.
- */
- function root(defaults?: object): Root;
- interface SourceMapOptions {
- /**
- * Indicates that the source map should be embedded in the output CSS as a
- * Base64-encoded comment. By default, it is true. But if all previous maps
- * are external, not inline, PostCSS will not embed the map even if you do
- * not set this option.
- *
- * If you have an inline source map, the result.map property will be empty,
- * as the source map will be contained within the text of result.css.
- */
- inline?: boolean;
- /**
- * Source map content from a previous processing step (e.g., Sass compilation).
- * PostCSS will try to read the previous source map automatically (based on comments
- * within the source CSS), but you can use this option to identify it manually.
- * If desired, you can omit the previous map with prev: false.
- */
- prev?: any;
- /**
- * Indicates that PostCSS should set the origin content (e.g., Sass source)
- * of the source map. By default, it is true. But if all previous maps do not
- * contain sources content, PostCSS will also leave it out even if you do not set
- * this option.
- */
- sourcesContent?: boolean;
- /**
- * Indicates that PostCSS should add annotation comments to the CSS. By default,
- * PostCSS will always add a comment with a path to the source map. PostCSS will
- * not add annotations to CSS files that do not contain any comments.
- *
- * By default, PostCSS presumes that you want to save the source map as
- * opts.to + '.map' and will use this path in the annotation comment. A different
- * path can be set by providing a string value for annotation.
- *
- * If you have set inline: true, annotation cannot be disabled.
- */
- annotation?: boolean | string;
- /**
- * If true, PostCSS will try to correct any syntax errors that it finds in the CSS.
- * This is useful for legacy code filled with hacks. Another use-case is interactive
- * tools with live input — for example, the Autoprefixer demo.
- */
- safe?: boolean;
- }
- /**
- * A Processor instance contains plugins to process CSS. Create one
- * Processor instance, initialize its plugins, and then use that instance
- * on numerous CSS files.
- */
- interface Processor {
- /**
- * Adds a plugin to be used as a CSS processor. Plugins can also be
- * added by passing them as arguments when creating a postcss instance.
- */
- use(plugin: AcceptedPlugin): Processor;
- /**
- * Parses source CSS. Because some plugins can be asynchronous it doesn't
- * make any transformations. Transformations will be applied in LazyResult's
- * methods.
- * @param css Input CSS or any object with toString() method, like a file
- * stream. If a Result instance is passed the processor will take the
- * existing Root parser from it.
- */
- process(css: string | {
- toString(): string;
- } | Result, options?: ProcessOptions): LazyResult;
- /**
- * Contains plugins added to this processor.
- */
- plugins: Plugin<any>[];
- /**
- * Contains the current version of PostCSS (e.g., "4.0.5").
- */
- version: string;
- }
- interface ProcessOptions extends Syntax {
- /**
- * The path of the CSS source file. You should always set from, because it is
- * used in source map generation and syntax error messages.
- */
- from?: string;
- /**
- * The path where you'll put the output CSS file. You should always set it
- * to generate correct source maps.
- */
- to?: string;
- syntax?: Syntax;
- /**
- * Enable Safe Mode, in which PostCSS will try to fix CSS syntax errors.
- */
- safe?: boolean;
- map?: postcss.SourceMapOptions;
- /**
- * Function to generate AST by string.
- */
- parser?: Parse | Syntax;
- /**
- * Class to generate string by AST.
- */
- stringifier?: Stringify | Syntax;
- }
- interface Syntax {
- /**
- * Function to generate AST by string.
- */
- parse?: Parse;
- /**
- * Class to generate string by AST.
- */
- stringify?: Stringify;
- }
- interface Parse {
- (css?: string, opts?: postcss.SourceMapOptions): Root;
- }
- interface Stringify {
- (node?: postcss.Node, builder?: any): postcss.Result | void;
- }
- /**
- * A promise proxy for the result of PostCSS transformations.
- */
- interface LazyResult {
- /**
- * Processes input CSS through synchronous and asynchronous plugins.
- * @param onRejected Called if any plugin throws an error.
- */
- then(onFulfilled: (result: Result) => void, onRejected?: (error: Error) => void): Function | any;
- /**
- * Processes input CSS through synchronous and asynchronous plugins.
- * @param onRejected Called if any plugin throws an error.
- */
- catch(onRejected: (error: Error) => void): Function | any;
- /**
- * Alias for css property.
- */
- toString(): string;
- /**
- * Processes input CSS through synchronous plugins and converts Root to
- * CSS string. This property will only work with synchronous plugins. If
- * the processor contains any asynchronous plugins it will throw an error.
- * In this case, you should use LazyResult#then() instead.
- * @returns Result#css.
- */
- css: string;
- /**
- * Alias for css property to use when syntaxes generate non-CSS output.
- */
- content: string;
- /**
- * Processes input CSS through synchronous plugins. This property will
- * work only with synchronous plugins. If processor contains any
- * asynchronous plugins it will throw an error. You should use
- * LazyResult#then() instead.
- */
- map: ResultMap;
- /**
- * Processes input CSS through synchronous plugins. This property will work
- * only with synchronous plugins. If processor contains any asynchronous
- * plugins it will throw an error. You should use LazyResult#then() instead.
- */
- root: Root;
- /**
- * Processes input CSS through synchronous plugins and calls Result#warnings().
- * This property will only work with synchronous plugins. If the processor
- * contains any asynchronous plugins it will throw an error. In this case,
- * you should use LazyResult#then() instead.
- */
- warnings(): ResultMessage[];
- /**
- * Processes input CSS through synchronous plugins. This property will work
- * only with synchronous plugins. If processor contains any asynchronous
- * plugins it will throw an error. You should use LazyResult#then() instead.
- */
- messages: ResultMessage[];
- /**
- * @returns A processor used for CSS transformations.
- */
- processor: Processor;
- /**
- * @returns Options from the Processor#process(css, opts) call that produced
- * this Result instance.
- */
- opts: ResultOptions;
- }
- /**
- * Provides the result of the PostCSS transformations.
- */
- interface Result {
- /**
- * Alias for css property.
- */
- toString(): string;
- /**
- * Creates an instance of Warning and adds it to messages.
- * @param message Used in the text property of the message object.
- * @param options Properties for Message object.
- */
- warn(message: string, options?: WarningOptions): void;
- /**
- * @returns Warnings from plugins, filtered from messages.
- */
- warnings(): ResultMessage[];
- /**
- * A CSS string representing this Result's Root instance.
- */
- css: string;
- /**
- * Alias for css property to use with syntaxes that generate non-CSS output.
- */
- content: string;
- /**
- * An instance of the SourceMapGenerator class from the source-map library,
- * representing changes to the Result's Root instance.
- * This property will have a value only if the user does not want an inline
- * source map. By default, PostCSS generates inline source maps, written
- * directly into the processed CSS. The map property will be empty by default.
- * An external source map will be generated — and assigned to map — only if
- * the user has set the map.inline option to false, or if PostCSS was passed
- * an external input source map.
- */
- map: ResultMap;
- /**
- * Contains the Root node after all transformations.
- */
- root?: Root;
- /**
- * Contains messages from plugins (e.g., warnings or custom messages).
- * Add a warning using Result#warn() and get all warnings
- * using the Result#warnings() method.
- */
- messages: ResultMessage[];
- /**
- * The Processor instance used for this transformation.
- */
- processor?: Processor;
- /**
- * Options from the Processor#process(css, opts) or Root#toResult(opts) call
- * that produced this Result instance.
- */
- opts?: ResultOptions;
- }
- interface ResultOptions extends ProcessOptions {
- /**
- * The CSS node that was the source of the warning.
- */
- node?: postcss.Node;
- /**
- * Name of plugin that created this warning. Result#warn() will fill it
- * automatically with plugin.postcssPlugin value.
- */
- plugin?: string;
- }
- interface ResultMap {
- /**
- * Add a single mapping from original source line and column to the generated
- * source's line and column for this source map being created. The mapping
- * object should have the following properties:
- * @param mapping
- * @returns {}
- */
- addMapping(mapping: mozilla.Mapping): void;
- /**
- * Set the source content for an original source file.
- * @param sourceFile The URL of the original source file.
- * @param sourceContent The content of the source file.
- */
- setSourceContent(sourceFile: string, sourceContent: string): void;
- /**
- * Applies a SourceMap for a source file to the SourceMap. Each mapping to
- * the supplied source file is rewritten using the supplied SourceMap.
- * Note: The resolution for the resulting mappings is the minimium of this
- * map and the supplied map.
- * @param sourceMapConsumer The SourceMap to be applied.
- * @param sourceFile The filename of the source file. If omitted, sourceMapConsumer
- * file will be used, if it exists. Otherwise an error will be thrown.
- * @param sourceMapPath The dirname of the path to the SourceMap to be applied.
- * If relative, it is relative to the SourceMap. This parameter is needed when
- * the two SourceMaps aren't in the same directory, and the SourceMap to be
- * applied contains relative source paths. If so, those relative source paths
- * need to be rewritten relative to the SourceMap.
- * If omitted, it is assumed that both SourceMaps are in the same directory;
- * thus, not needing any rewriting (Supplying '.' has the same effect).
- */
- applySourceMap(
- sourceMapConsumer: mozilla.SourceMapConsumer,
- sourceFile?: string,
- sourceMapPath?: string
- ): void;
- /**
- * Renders the source map being generated to JSON.
- */
- toJSON: () => mozilla.RawSourceMap;
- /**
- * Renders the source map being generated to a string.
- */
- toString: () => string;
- }
- interface ResultMessage {
- type: string;
- text?: string;
- plugin?: string;
- browsers?: string[];
- }
- /**
- * Represents a plugin warning. It can be created using Result#warn().
- */
- interface Warning {
- /**
- * @returns Error position, message.
- */
- toString(): string;
- /**
- * Contains the warning message.
- */
- text: string;
- /**
- * Contains the name of the plugin that created this warning. When you
- * call Result#warn(), it will fill this property automatically.
- */
- plugin: string;
- /**
- * The CSS node that caused the warning.
- */
- node: Node;
- /**
- * The line in the input file with this warning's source.
- */
- line: number;
- /**
- * Column in the input file with this warning's source.
- */
- column: number;
- }
- interface WarningOptions extends ResultOptions {
- /**
- * A word inside a node's string that should be highlighted as source
- * of warning.
- */
- word?: string;
- /**
- * The index inside a node's string that should be highlighted as
- * source of warning.
- */
- index?: number;
- }
- /**
- * The CSS parser throws this error for broken CSS.
- */
- interface CssSyntaxError extends InputOrigin {
- name: string;
- /**
- * @returns Error position, message and source code of broken part.
- */
- toString(): string;
- /**
- * @param color Whether arrow should be colored red by terminal color codes.
- * By default, PostCSS will use process.stdout.isTTY and
- * process.env.NODE_DISABLE_COLORS.
- * @returns A few lines of CSS source that caused the error. If CSS has
- * input source map without sourceContent this method will return an empty
- * string.
- */
- showSourceCode(color?: boolean): string;
- /**
- * Contains full error text in the GNU error format.
- */
- message: string;
- /**
- * Contains only the error description.
- */
- reason: string;
- /**
- * Contains the PostCSS plugin name if the error didn't come from the
- * CSS parser.
- */
- plugin?: string;
- input?: InputOrigin;
- }
- interface InputOrigin {
- /**
- * If parser's from option is set, contains the absolute path to the
- * broken file. PostCSS will use the input source map to detect the
- * original error location. If you wrote a Sass file, then compiled it
- * to CSS and parsed it with PostCSS, PostCSS will show the original
- * position in the Sass file. If you need the position in the PostCSS
- * input (e.g., to debug the previous compiler), use error.input.file.
- */
- file?: string;
- /**
- * Contains the source line of the error. PostCSS will use the input
- * source map to detect the original error location. If you wrote a Sass
- * file, then compiled it to CSS and parsed it with PostCSS, PostCSS
- * will show the original position in the Sass file. If you need the
- * position in the PostCSS input (e.g., to debug the previous
- * compiler), use error.input.line.
- */
- line?: number;
- /**
- * Contains the source column of the error. PostCSS will use input
- * source map to detect the original error location. If you wrote a
- * Sass file, then compiled it to CSS and parsed it with PostCSS,
- * PostCSS will show the original position in the Sass file. If you
- * need the position in the PostCSS input (e.g., to debug the
- * previous compiler), use error.input.column.
- */
- column?: number;
- /**
- * Contains the source code of the broken file. PostCSS will use the
- * input source map to detect the original error location. If you wrote
- * a Sass file, then compiled it to CSS and parsed it with PostCSS,
- * PostCSS will show the original position in the Sass file. If you need
- * the position in the PostCSS input (e.g., to debug the previous
- * compiler), use error.input.source.
- */
- source?: string;
- }
- export class PreviousMap {
- private inline;
- annotation: string;
- root: string;
- private consumerCache;
- text: string;
- file: string;
- constructor(css: any, opts: any);
- consumer(): mozilla.SourceMapConsumer;
- withContent(): boolean;
- startWith(string: string, start: string): boolean;
- loadAnnotation(css: string): void;
- decodeInline(text: string): string;
- loadMap(
- file: any,
- prev: string | Function | mozilla.SourceMapConsumer | mozilla.SourceMapGenerator | mozilla.RawSourceMap
- ): string;
- isMap(map: any): boolean;
- }
- /**
- * Represents the source CSS.
- */
- interface Input {
- /**
- * The absolute path to the CSS source file defined with the "from" option.
- */
- file: string;
- /**
- * The unique ID of the CSS source. Used if "from" option is not provided
- * (because PostCSS does not know the file path).
- */
- id: string;
- /**
- * The CSS source identifier. Contains input.file if the user set the
- * "from" option, or input.id if they did not.
- */
- from: string;
- /**
- * Represents the input source map passed from a compilation step before
- * PostCSS (e.g., from the Sass compiler).
- */
- map: PreviousMap;
- /**
- * Reads the input source map.
- * @returns A symbol position in the input source (e.g., in a Sass file
- * that was compiled to CSS before being passed to PostCSS):
- */
- origin(line: number, column: number): InputOrigin;
- }
- type ChildNode = AtRule | Rule | Declaration | Comment;
- type Node = Root | ChildNode;
- interface NodeBase {
- /**
- * Returns the input source of the node. The property is used in source
- * map generation. If you create a node manually
- * (e.g., with postcss.decl() ), that node will not have a source
- * property and will be absent from the source map. For this reason, the
- * plugin developer should consider cloning nodes to create new ones
- * (in which case the new node's source will reference the original,
- * cloned node) or setting the source property manually.
- */
- source: NodeSource;
- /**
- * Contains information to generate byte-to-byte equal node string as it
- * was in origin input.
- */
- raws: NodeRaws;
- /**
- * @returns A CSS string representing the node.
- */
- toString(): string;
- /**
- * This method produces very useful error messages. If present, an input
- * source map will be used to get the original position of the source, even
- * from a previous compilation step (e.g., from Sass compilation).
- * @returns The original position of the node in the source, showing line
- * and column numbers and also a small excerpt to facilitate debugging.
- */
- error(
- /**
- * Error description.
- */
- message: string, options?: NodeErrorOptions): CssSyntaxError;
- /**
- * Creates an instance of Warning and adds it to messages. This method is
- * provided as a convenience wrapper for Result#warn.
- * Note that `opts.node` is automatically passed to Result#warn for you.
- * @param result The result that will receive the warning.
- * @param text Warning message. It will be used in the `text` property of
- * the message object.
- * @param opts Properties to assign to the message object.
- */
- warn(result: Result, text: string, opts?: WarningOptions): void;
- /**
- * @returns The next child of the node's parent; or, returns undefined if
- * the current node is the last child.
- */
- next(): ChildNode | void;
- /**
- * @returns The previous child of the node's parent; or, returns undefined
- * if the current node is the first child.
- */
- prev(): ChildNode | void;
- /**
- * Insert new node before current node to current node’s parent.
- *
- * Just an alias for `node.parent.insertBefore(node, newNode)`.
- *
- * @returns this node for method chaining.
- *
- * @example
- * decl.before('content: ""');
- */
- before(newNode: Node | object | string | Node[]): this;
- /**
- * Insert new node after current node to current node’s parent.
- *
- * Just an alias for `node.parent.insertAfter(node, newNode)`.
- *
- * @returns this node for method chaining.
- *
- * @example
- * decl.after('color: black');
- */
- after(newNode: Node | object | string | Node[]): this;
- /**
- * @returns The Root instance of the node's tree.
- */
- root(): Root;
- /**
- * Removes the node from its parent and cleans the parent property in the
- * node and its children.
- * @returns This node for chaining.
- */
- remove(): this;
- /**
- * Inserts node(s) before the current node and removes the current node.
- * @returns This node for chaining.
- */
- replaceWith(...nodes: (Node | object)[]): this;
- /**
- * @param overrides New properties to override in the clone.
- * @returns A clone of this node. The node and its (cloned) children will
- * have a clean parent and code style properties.
- */
- clone(overrides?: object): this;
- /**
- * Shortcut to clone the node and insert the resulting cloned node before
- * the current node.
- * @param overrides New Properties to override in the clone.
- * @returns The cloned node.
- */
- cloneBefore(overrides?: object): this;
- /**
- * Shortcut to clone the node and insert the resulting cloned node after
- * the current node.
- * @param overrides New Properties to override in the clone.
- * @returns The cloned node.
- */
- cloneAfter(overrides?: object): this;
- /**
- * @param prop Name or code style property.
- * @param defaultType Name of default value. It can be easily missed if the
- * value is the same as prop.
- * @returns A code style property value. If the node is missing the code
- * style property (because the node was manually built or cloned), PostCSS
- * will try to autodetect the code style property by looking at other nodes
- * in the tree.
- */
- raw(prop: string, defaultType?: string): any;
- }
- interface NodeNewProps {
- source?: NodeSource;
- raws?: NodeRaws;
- }
- interface NodeRaws {
- /**
- * 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 symbols between the property and value for declarations,
- * selector and "{" for rules, last parameter and "{" for at-rules.
- */
- between?: string;
- /**
- * True if last child has (optional) semicolon.
- */
- semicolon?: boolean;
- /**
- * The space between the at-rule's name and parameters.
- */
- afterName?: string;
- /**
- * The space symbols between "/*" and comment's text.
- */
- left?: string;
- /**
- * The space symbols between comment's text and "*\/".
- */
- right?: string;
- /**
- * The content of important statement, if it is not just "!important".
- */
- important?: string;
- }
- interface NodeSource {
- input: Input;
- /**
- * The starting position of the node's source.
- */
- start?: {
- column: number;
- line: number;
- };
- /**
- * The ending position of the node's source.
- */
- end?: {
- column: number;
- line: number;
- };
- }
- 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;
- }
- interface JsonNode {
- /**
- * Returns a string representing the node's type. Possible values are
- * root, atrule, rule, decl or comment.
- */
- type?: string;
- /**
- * Returns the node's parent node.
- */
- parent?: JsonContainer;
- /**
- * Returns the input source of the node. The property is used in source
- * map generation. If you create a node manually (e.g., with
- * postcss.decl() ), that node will not have a source property and
- * will be absent from the source map. For this reason, the plugin
- * developer should consider cloning nodes to create new ones (in which
- * case the new node's source will reference the original, cloned node)
- * or setting the source property manually.
- */
- source?: NodeSource;
- /**
- * Contains information to generate byte-to-byte equal node string as it
- * was in origin input.
- */
- raws?: NodeRaws;
- }
- type Container = Root | AtRule | Rule;
- /**
- * Containers can store any content. If you write a rule inside a rule,
- * PostCSS will parse it.
- */
- interface ContainerBase extends NodeBase {
- /**
- * Contains the container's children.
- */
- nodes?: ChildNode[];
- /**
- * @returns The container's first child.
- */
- first?: ChildNode;
- /**
- * @returns The container's last child.
- */
- last?: ChildNode;
- /**
- * @param overrides New properties to override in the clone.
- * @returns A clone of this node. The node and its (cloned) children will
- * have a clean parent and code style properties.
- */
- clone(overrides?: object): this;
- /**
- * @param child Child of the current container.
- * @returns The child's index within the container's "nodes" array.
- */
- index(child: ChildNode | number): number;
- /**
- * Determines whether all child nodes satisfy the specified test.
- * @param callback A function that accepts up to three arguments. The
- * every method calls the callback function for each node until the
- * callback returns false, or until the end of the array.
- * @returns True if the callback returns true for all of the container's
- * children.
- */
- every(callback: (node: ChildNode, index: number, nodes: ChildNode[]) => any, thisArg?: any): boolean;
- /**
- * Determines whether the specified callback returns true for any child node.
- * @param callback A function that accepts up to three arguments. The some
- * method calls the callback for each node until the callback returns true,
- * or until the end of the array.
- * @param thisArg An object to which the this keyword can refer in the
- * callback function. If thisArg is omitted, undefined is used as the
- * this value.
- * @returns True if callback returns true for (at least) one of the
- * container's children.
- */
- some(callback: (node: ChildNode, index: number, nodes: ChildNode[]) => boolean, thisArg?: any): boolean;
- /**
- * Iterates through the container's immediate children, calling the
- * callback function for each child. If you need to recursively iterate
- * through all the container's descendant nodes, use container.walk().
- * Unlike the for {} -cycle or Array#forEach() this iterator is safe if
- * you are mutating the array of child nodes during iteration.
- * @param callback Iterator. Returning false will break iteration. Safe
- * if you are mutating the array of child nodes during iteration. PostCSS
- * will adjust the current index to match the mutations.
- * @returns False if the callback returns false during iteration.
- */
- each(callback: (node: ChildNode, index: number) => any): boolean | void;
- /**
- * Traverses the container's descendant nodes, calling `callback` for each
- * node. Like container.each(), this method is safe to use if you are
- * mutating arrays during iteration. If you only need to iterate through
- * the container's immediate children, use container.each().
- * @param callback Iterator.
- */
- walk(callback: (node: ChildNode, index: number) => any): boolean | void;
- /**
- * Traverses the container's descendant nodes, calling `callback` for each
- * declaration. Like container.each(), this method is safe to use if you
- * are mutating arrays during iteration.
- * @param propFilter Filters declarations by property name. Only those
- * declarations whose property matches propFilter will be iterated over.
- * @param callback Called for each declaration node within the container.
- */
- walkDecls(propFilter: string | RegExp, callback?: (decl: Declaration, index: number) => any): boolean | void;
- walkDecls(callback: (decl: Declaration, index: number) => any): boolean | void;
- /**
- * Traverses the container's descendant nodes, calling `callback` for each
- * at-rule. Like container.each(), this method is safe to use if you are
- * mutating arrays during iteration.
- * @param nameFilter Filters at-rules by name. If provided, iteration
- * will only happen over at-rules that have matching names.
- * @param callback Iterator called for each at-rule node within the
- * container.
- */
- walkAtRules(nameFilter: string | RegExp, callback: (atRule: AtRule, index: number) => any): boolean | void;
- walkAtRules(callback: (atRule: AtRule, index: number) => any): boolean | void;
- /**
- * Traverses the container's descendant nodes, calling `callback` for each
- * rule. Like container.each(), this method is safe to use if you are
- * mutating arrays during iteration.
- * @param selectorFilter Filters rules by selector. If provided,
- * iteration will only happen over rules that have matching names.
- * @param callback Iterator called for each rule node within the
- * container.
- */
- walkRules(selectorFilter: string | RegExp, callback: (atRule: Rule, index: number) => any): boolean | void;
- walkRules(callback: (atRule: Rule, index: number) => any): boolean | void;
- walkRules(selectorFilter: any, callback?: (atRule: Rule, index: number) => any): boolean | void;
- /**
- * Traverses the container's descendant nodes, calling `callback` for each
- * comment. Like container.each(), this method is safe to use if you are
- * mutating arrays during iteration.
- * @param callback Iterator called for each comment node within the container.
- */
- walkComments(callback: (comment: Comment, indexed: number) => any): void | boolean;
- /**
- * Passes all declaration values within the container that match pattern
- * through the callback, replacing those values with the returned result of
- * callback. This method is useful if you are using a custom unit or
- * function and need to iterate through all values.
- * @param pattern Pattern that we need to replace.
- * @param options Options to speed up the search.
- * @param callbackOrReplaceValue String to replace pattern or callback
- * that will return a new value. The callback will receive the same
- * arguments as those passed to a function parameter of String#replace.
- */
- replaceValues(pattern: string | RegExp, options: {
- /**
- * Property names. The method will only search for values that match
- * regexp within declarations of listed properties.
- */
- props?: string[];
- /**
- * Used to narrow down values and speed up the regexp search. Searching
- * every single value with a regexp can be slow. If you pass a fast
- * string, PostCSS will first check whether the value contains the fast
- * string; and only if it does will PostCSS check that value against
- * regexp. For example, instead of just checking for /\d+rem/ on all
- * values, set fast: 'rem' to first check whether a value has the rem
- * unit, and only if it does perform the regexp check.
- */
- fast?: string;
- }, callbackOrReplaceValue: string | {
- (substring: string, ...args: any[]): string;
- }): this;
- replaceValues(pattern: string | RegExp, callbackOrReplaceValue: string | {
- (substring: string, ...args: any[]): string;
- }): this;
- /**
- * Inserts new nodes to the beginning of the container.
- * Because each node class is identifiable by unique properties, use the
- * following shortcuts to create nodes in insert methods:
- * root.prepend({ name: '@charset', params: '"UTF-8"' }); // at-rule
- * root.prepend({ selector: 'a' }); // rule
- * rule.prepend({ prop: 'color', value: 'black' }); // declaration
- * rule.prepend({ text: 'Comment' }) // comment
- * A string containing the CSS of the new element can also be used. This
- * approach is slower than the above shortcuts.
- * root.prepend('a {}');
- * root.first.prepend('color: black; z-index: 1');
- * @param nodes New nodes.
- * @returns This container for chaining.
- */
- prepend(...nodes: (Node | object | string)[]): this;
- /**
- * Inserts new nodes to the end of the container.
- * Because each node class is identifiable by unique properties, use the
- * following shortcuts to create nodes in insert methods:
- * root.append({ name: '@charset', params: '"UTF-8"' }); // at-rule
- * root.append({ selector: 'a' }); // rule
- * rule.append({ prop: 'color', value: 'black' }); // declaration
- * rule.append({ text: 'Comment' }) // comment
- * A string containing the CSS of the new element can also be used. This
- * approach is slower than the above shortcuts.
- * root.append('a {}');
- * root.first.append('color: black; z-index: 1');
- * @param nodes New nodes.
- * @returns This container for chaining.
- */
- append(...nodes: (Node | object | string)[]): this;
- /**
- * Insert newNode before oldNode within the container.
- * @param oldNode Child or child's index.
- * @returns This container for chaining.
- */
- insertBefore(oldNode: ChildNode | number, newNode: ChildNode | object | string): this;
- /**
- * Insert newNode after oldNode within the container.
- * @param oldNode Child or child's index.
- * @returns This container for chaining.
- */
- insertAfter(oldNode: ChildNode | number, newNode: ChildNode | object | string): this;
- /**
- * Removes the container from its parent and cleans the parent property in the
- * container and its children.
- * @returns This container for chaining.
- */
- remove(): this;
- /**
- * Removes child from the container and cleans the parent properties
- * from the node and its children.
- * @param child Child or child's index.
- * @returns This container for chaining.
- */
- removeChild(child: ChildNode | number): this;
- /**
- * Removes all children from the container and cleans their parent
- * properties.
- * @returns This container for chaining.
- */
- removeAll(): this;
- }
- interface ContainerNewProps extends NodeNewProps {
- /**
- * Contains the container's children.
- */
- nodes?: ChildNode[];
- raws?: ContainerRaws;
- }
- interface ContainerRaws extends NodeRaws {
- indent?: string;
- }
- interface JsonContainer extends JsonNode {
- /**
- * Contains the container's children.
- */
- nodes?: ChildNode[];
- /**
- * @returns The container's first child.
- */
- first?: ChildNode;
- /**
- * @returns The container's last child.
- */
- last?: ChildNode;
- }
- /**
- * Represents a CSS file and contains all its parsed nodes.
- */
- interface Root extends ContainerBase {
- type: 'root';
- /**
- * Inherited from Container. Should always be undefined for a Root node.
- */
- parent: void;
- /**
- * @param overrides New properties to override in the clone.
- * @returns A clone of this node. The node and its (cloned) children will
- * have a clean parent and code style properties.
- */
- clone(overrides?: object): this;
- /**
- * @returns A Result instance representing the root's CSS.
- */
- toResult(options?: {
- /**
- * The path where you'll put the output CSS file. You should always
- * set "to" to generate correct source maps.
- */
- to?: string;
- map?: SourceMapOptions;
- }): Result;
- /**
- * Removes child from the root node, and the parent properties of node and
- * its children.
- * @param child Child or child's index.
- * @returns This root node for chaining.
- */
- removeChild(child: ChildNode | number): this;
- }
- interface RootNewProps extends ContainerNewProps {
- }
- interface JsonRoot extends JsonContainer {
- }
- /**
- * Represents an at-rule. If it's followed in the CSS by a {} block, this
- * node will have a nodes property representing its children.
- */
- interface AtRule extends ContainerBase {
- type: 'atrule';
- /**
- * Returns the atrule's parent node.
- */
- parent: Container;
- /**
- * The identifier that immediately follows the @.
- */
- name: string;
- /**
- * These are the values that follow the at-rule's name, but precede any {}
- * block. The spec refers to this area as the at-rule's "prelude".
- */
- params: string;
- /**
- * @param overrides New properties to override in the clone.
- * @returns A clone of this node. The node and its (cloned) children will
- * have a clean parent and code style properties.
- */
- clone(overrides?: object): this;
- }
- interface AtRuleNewProps extends ContainerNewProps {
- /**
- * The identifier that immediately follows the @.
- */
- name?: string;
- /**
- * These are the values that follow the at-rule's name, but precede any {}
- * block. The spec refers to this area as the at-rule's "prelude".
- */
- params?: string | number;
- raws?: AtRuleRaws;
- }
- interface AtRuleRaws extends NodeRaws {
- params?: string;
- }
- interface JsonAtRule extends JsonContainer {
- /**
- * The identifier that immediately follows the @.
- */
- name?: string;
- /**
- * These are the values that follow the at-rule's name, but precede any {}
- * block. The spec refers to this area as the at-rule's "prelude".
- */
- params?: string;
- }
- /**
- * Represents a CSS rule: a selector followed by a declaration block.
- */
- interface Rule extends ContainerBase {
- type: 'rule';
- /**
- * Returns the rule's parent node.
- */
- parent: Container;
- /**
- * The rule's full selector. If there are multiple comma-separated selectors,
- * the entire group will be included.
- */
- selector: string;
- /**
- * An array containing the rule's individual selectors.
- * Groups of selectors are split at commas.
- */
- selectors?: string[];
- /**
- * @param overrides New properties to override in the clone.
- * @returns A clone of this node. The node and its (cloned) children will
- * have a clean parent and code style properties.
- */
- clone(overrides?: object): this;
- }
- interface RuleNewProps extends ContainerNewProps {
- /**
- * The rule's full selector. If there are multiple comma-separated selectors,
- * the entire group will be included.
- */
- selector?: string;
- /**
- * An array containing the rule's individual selectors. Groups of selectors
- * are split at commas.
- */
- selectors?: string[];
- raws?: RuleRaws;
- }
- interface RuleRaws extends ContainerRaws {
- /**
- * The rule's full selector. If there are multiple comma-separated selectors,
- * the entire group will be included.
- */
- selector?: string;
- }
- interface JsonRule extends JsonContainer {
- /**
- * The rule's full selector. If there are multiple comma-separated selectors,
- * the entire group will be included.
- */
- selector?: string;
- /**
- * An array containing the rule's individual selectors.
- * Groups of selectors are split at commas.
- */
- selectors?: string[];
- }
- /**
- * Represents a CSS declaration.
- */
- interface Declaration extends NodeBase {
- type: 'decl';
- /**
- * Returns the declaration's parent node.
- */
- parent: Container;
- /**
- * The declaration's property name.
- */
- prop: string;
- /**
- * The declaration's value. This value will be cleaned of comments. If the
- * source value contained comments, those comments will be available in the
- * _value.raws property. If you have not changed the value, the result of
- * decl.toString() will include the original raws value (comments and all).
- */
- value: string;
- /**
- * True if the declaration has an !important annotation.
- */
- important: boolean;
- /**
- * @param overrides New properties to override in the clone.
- * @returns A clone of this node. The node and its (cloned) children will
- * have a clean parent and code style properties.
- */
- clone(overrides?: object): this;
- }
- interface DeclarationNewProps {
- /**
- * The declaration's property name.
- */
- prop?: string;
- /**
- * The declaration's value. This value will be cleaned of comments. If the
- * source value contained comments, those comments will be available in the
- * _value.raws property. If you have not changed the value, the result of
- * decl.toString() will include the original raws value (comments and all).
- */
- value?: string;
- raws?: DeclarationRaws;
- }
- interface DeclarationRaws extends NodeRaws {
- /**
- * The declaration's value. This value will be cleaned of comments.
- * If the source value contained comments, those comments will be
- * available in the _value.raws property. If you have not changed the value, the result of
- * decl.toString() will include the original raws value (comments and all).
- */
- value?: string;
- }
- interface JsonDeclaration extends JsonNode {
- /**
- * True if the declaration has an !important annotation.
- */
- important?: boolean;
- }
- /**
- * Represents a comment between declarations or statements (rule and at-rules).
- * Comments inside selectors, at-rule parameters, or declaration values will
- * be stored in the Node#raws properties.
- */
- interface Comment extends NodeBase {
- type: 'comment';
- /**
- * Returns the comment's parent node.
- */
- parent: Container;
- /**
- * The comment's text.
- */
- text: string;
- /**
- * @param overrides New properties to override in the clone.
- * @returns A clone of this node. The node and its (cloned) children will
- * have a clean parent and code style properties.
- */
- clone(overrides?: object): this;
- }
- interface CommentNewProps {
- /**
- * The comment's text.
- */
- text?: string;
- }
- interface JsonComment extends JsonNode {
- }
- }
- export = postcss;
|