@umijs/bundler-webpack 4.0.0-beta.6 → 4.0.0-rc.1

package/compiled/autoprefixer/postcss/lib/container.d.ts

@@ -181,10 +181,10 @@ export default abstract class Container<
    */
   walkRules(
     selectorFilter: string | RegExp,
-    callback: (atRule: Rule, index: number) => false | void
+    callback: (rule: Rule, index: number) => false | void
   ): false | undefined
   walkRules(
-    callback: (atRule: Rule, index: number) => false | void
+    callback: (rule: Rule, index: number) => false | void
   ): false | undefined
 
   /**

package/compiled/autoprefixer/postcss/lib/css-syntax-error.d.ts

@@ -1,5 +1,20 @@
 import { FilePosition } from './input'
 
+/**
+ * A position that is part of a range.
+ */
+export interface RangePosition {
+  /**
+   * The line number in the input.
+   */
+  line: number
+
+  /**
+   * The column number in the input.
+   */
+  column: number
+}
+
 /**
  * The CSS parser throws this error for broken CSS.
  *
@@ -31,17 +46,21 @@ import { FilePosition } from './input'
  */
 export default class CssSyntaxError {
   /**
-   * @param message Error message.
-   * @param line    Source line of the error.
-   * @param column  Source column of the error.
-   * @param source  Source code of the broken file.
-   * @param file    Absolute path to the broken file.
-   * @param plugin  PostCSS plugin name, if error came from plugin.
+   * Instantiates a CSS syntax error. Can be instantiated for a single position
+   * or for a range.
+   * @param message        Error message.
+   * @param lineOrStartPos If for a single position, the line number, or if for
+   *                       a range, the inclusive start position of the error.
+   * @param columnOrEndPos If for a single position, the column number, or if for
+   *                       a range, the exclusive end position of the error.
+   * @param source         Source code of the broken file.
+   * @param file           Absolute path to the broken file.
+   * @param plugin         PostCSS plugin name, if error came from plugin.
    */
   constructor(
     message: string,
-    line?: number,
-    column?: number,
+    lineOrStartPos?: number | RangePosition,
+    columnOrEndPos?: number | RangePosition,
     source?: string,
     file?: string,
     plugin?: string
@@ -121,6 +140,34 @@ export default class CssSyntaxError {
    */
   column?: number
 
+  /**
+   * Source line of the error's end, exclusive. Provided if the error pertains
+   * to a range.
+   *
+   * ```js
+   * error.endLine       //=> 3
+   * error.input.endLine //=> 4
+   * ```
+   *
+   * PostCSS will use the input source map to detect the original location.
+   * If you need the position in the PostCSS input, use `error.input.endLine`.
+   */
+  endLine?: number
+
+  /**
+   * Source column of the error's end, exclusive. Provided if the error pertains
+   * to a range.
+   *
+   * ```js
+   * error.endColumn       //=> 1
+   * error.input.endColumn //=> 4
+   * ```
+   *
+   * PostCSS will use the input source map to detect the original location.
+   * If you need the position in the PostCSS input, use `error.input.endColumn`.
+   */
+  endColumn?: number
+
   /**
    * Source code of the broken file.
    *

package/compiled/autoprefixer/postcss/lib/input.d.ts

@@ -13,15 +13,25 @@ export interface FilePosition {
   file?: string
 
   /**
-   * Line in source file.
+   * Line of inclusive start position in source file.
    */
   line: number
 
   /**
-   * Column in source file.
+   * Column of inclusive start position in source file.
    */
   column: number
 
+  /**
+   * Line of exclusive end position in source file.
+   */
+  endLine?: number
+
+  /**
+   * Column of exclusive end position in source file.
+   */
+  endColumn?: number
+
   /**
    * Source code.
    */
@@ -108,18 +118,28 @@ export default class Input {
   /**
    * Reads the input source map and returns a symbol position
    * in the input source (e.g., in a Sass file that was compiled
-   * to CSS before being passed to PostCSS).
+   * to CSS before being passed to PostCSS). Optionally takes an
+   * end position, exclusive.
    *
    * ```js
    * root.source.input.origin(1, 1) //=> { file: 'a.css', line: 3, column: 1 }
+   * root.source.input.origin(1, 1, 1, 4)
+   * //=> { file: 'a.css', line: 3, column: 1, endLine: 3, endColumn: 4 }
    * ```
    *
-   * @param line   Line in input CSS.
-   * @param column Column in input CSS.
+   * @param line      Line for inclusive start position in input CSS.
+   * @param column    Column for inclusive start position in input CSS.
+   * @param endLine   Line for exclusive end position in input CSS.
+   * @param endColumn Column for exclusive end position in input CSS.
    *
    * @return Position in input source.
    */
-  origin(line: number, column: number): FilePosition | false
+  origin(
+    line: number,
+    column: number,
+    endLine?: number,
+    endColumn?: number
+  ): FilePosition | false
 
   /**
    * Converts source offset to line and column.

package/compiled/autoprefixer/postcss/lib/lazy-result.d.ts

@@ -89,8 +89,9 @@ export default class LazyResult implements PromiseLike<Result> {
    *
    * This property will only work with synchronous plugins.
    * If the processor contains any asynchronous plugins
-   * it will throw an error. This is why this method is only
-   * for debug purpose, you should always use `LazyResult#then`.
+   * it will throw an error.
+   *
+   * PostCSS runners should always use `LazyResult#then`.
    */
   get css(): string
 
@@ -100,8 +101,9 @@ export default class LazyResult implements PromiseLike<Result> {
    *
    * This property will only work with synchronous plugins.
    * If the processor contains any asynchronous plugins
-   * it will throw an error. This is why this method is only
-   * for debug purpose, you should always use `LazyResult#then`.
+   * it will throw an error.
+   *
+   * PostCSS runners should always use `LazyResult#then`.
    */
   get content(): string
 
@@ -111,8 +113,9 @@ export default class LazyResult implements PromiseLike<Result> {
    *
    * This property will only work with synchronous plugins.
    * If the processor contains any asynchronous plugins
-   * it will throw an error. This is why this method is only
-   * for debug purpose, you should always use `LazyResult#then`.
+   * it will throw an error.
+   *
+   * PostCSS runners should always use `LazyResult#then`.
    */
   get map(): SourceMap
 
@@ -123,8 +126,7 @@ export default class LazyResult implements PromiseLike<Result> {
    * This property will only work with synchronous plugins. If the processor
    * contains any asynchronous plugins it will throw an error.
    *
-   * This is why this method is only for debug purpose,
-   * you should always use `LazyResult#then`.
+   * PostCSS runners should always use `LazyResult#then`.
    */
   get root(): Root
 
@@ -135,8 +137,7 @@ export default class LazyResult implements PromiseLike<Result> {
    * This property will only work with synchronous plugins. If the processor
    * contains any asynchronous plugins it will throw an error.
    *
-   * This is why this method is only for debug purpose,
-   * you should always use `LazyResult#then`.
+   * PostCSS runners should always use `LazyResult#then`.
    */
   get messages(): Message[]
 

package/compiled/autoprefixer/postcss/lib/no-work-result.d.ts

@@ -0,0 +1,37 @@
+import Result, { Message, ResultOptions } from './result'
+import { SourceMap } from './postcss'
+import Processor from './processor'
+import Warning from './warning'
+import Root from './root'
+import LazyResult from './lazy-result'
+
+/**
+ * A Promise proxy for the result of PostCSS transformations.
+ * This lazy result instance doesn't parse css unless `NoWorkResult#root` or `Result#root`
+ * are accessed. See the example below for details.
+ * A `NoWork` instance is returned by `Processor#process` ONLY when no plugins defined.
+ *
+ * ```js
+ * const noWorkResult = postcss().process(css) // No plugins are defined.
+ *                                             // CSS is not parsed
+ * let root = noWorkResult.root // now css is parsed because we accessed the root
+ * ```
+ */
+export default class NoWorkResult implements LazyResult {
+  then: Promise<Result>['then']
+  catch: Promise<Result>['catch']
+  finally: Promise<Result>['finally']
+  constructor(processor: Processor, css: string, opts: ResultOptions)
+  get [Symbol.toStringTag](): string
+  get processor(): Processor
+  get opts(): ResultOptions
+  get css(): string
+  get content(): string
+  get map(): SourceMap
+  get root(): Root
+  get messages(): Message[]
+  warnings(): Warning[]
+  toString(): string
+  sync(): Result
+  async(): Promise<Result>
+}

package/compiled/autoprefixer/postcss/lib/node.d.ts

@@ -38,17 +38,29 @@ export interface Position {
   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 starting position of the node’s source.
+   * The inclusive starting position of the node’s source.
    */
   start?: Position
   /**
-   * The ending position of the node's source.
+   * The inclusive ending position of the node's source.
    */
   end?: Position
 }
@@ -72,6 +84,11 @@ interface NodeErrorOptions {
    * of error.
    */
   index?: number
+  /**
+   * An ending index inside a node's string that should be highlighted as
+   * source of error.
+   */
+  endIndex?: number
 }
 
 /**
@@ -441,4 +458,21 @@ export default abstract class Node {
    * @return Symbol position in file.
    */
   positionInside(index: number): Position
+
+  /**
+   * Get the position for a word or an index inside the node.
+   *
+   * @param opts Options.
+   * @return Position.
+   */
+  positionBy(opts?: Pick<WarningOptions, 'word' | 'index'>): Position
+
+  /**
+   * Get the range for a word or start and end index inside the node.
+   * The start index is inclusive; the end index is exclusive.
+   *
+   * @param opts Options.
+   * @return Range.
+   */
+  rangeBy(opts?: Pick<WarningOptions, 'word' | 'index' | 'endIndex'>): Range
 }

package/compiled/autoprefixer/postcss/lib/postcss.d.ts

@@ -10,52 +10,53 @@ import Node, {
   AnyNode
 } from './node.js'
 import Declaration, { DeclarationProps } from './declaration'
-import Root, { RootProps } from './root'
+import Container, { ContainerProps } from './container'
 import Document, { DocumentProps } from './document'
+import Warning, { WarningOptions } from './warning'
 import Comment, { CommentProps } from './comment'
 import AtRule, { AtRuleProps } from './at-rule'
+import Input, { FilePosition } from './input'
 import Result, { Message } from './result'
-import LazyResult from './lazy-result'
+import Root, { RootProps } from './root'
 import Rule, { RuleProps } from './rule'
-import Container, { ContainerProps } from './container'
-import Warning, { WarningOptions } from './warning'
-import Input, { FilePosition } from './input'
 import CssSyntaxError from './css-syntax-error'
 import list, { List } from './list'
+import LazyResult from './lazy-result'
 import Processor from './processor'
 
 export {
-  WarningOptions,
-  FilePosition,
-  Position,
-  Source,
-  ChildNode,
-  AnyNode,
-  Message,
   NodeErrorOptions,
-  NodeProps,
   DeclarationProps,
+  CssSyntaxError,
   ContainerProps,
+  WarningOptions,
+  DocumentProps,
+  FilePosition,
   CommentProps,
-  RuleProps,
-  ChildProps,
   AtRuleProps,
+  Declaration,
+  ChildProps,
+  LazyResult,
+  ChildNode,
+  NodeProps,
+  Processor,
+  RuleProps,
   RootProps,
-  DocumentProps,
-  Warning,
-  CssSyntaxError,
-  Node,
   Container,
-  list,
-  Declaration,
+  Position,
+  Document,
+  AnyNode,
+  Warning,
+  Message,
   Comment,
+  Source,
   AtRule,
-  Rule,
-  Root,
-  Document,
   Result,
-  LazyResult,
-  Input
+  Input,
+  Node,
+  list,
+  Rule,
+  Root
 }
 
 export type SourceMap = SourceMapGenerator & {
@@ -221,7 +222,7 @@ export type AcceptedPlugin =
     }
   | Processor
 
-export interface Parser<RootNode = Root> {
+export interface Parser<RootNode = Root | Document> {
   (
     css: string | { toString(): string },
     opts?: Pick<ProcessOptions, 'map' | 'from'>
@@ -245,7 +246,7 @@ export interface Syntax {
   /**
    * Function to generate AST by string.
    */
-  parse?: Parser<Root | Document>
+  parse?: Parser
 
   /**
    * Class to generate string by AST.
@@ -378,7 +379,7 @@ export interface Postcss {
    * root1.append(root2).toResult().css
    * ```
    */
-  parse: Parser
+  parse: Parser<Root>
 
   /**
    * Rehydrate a JSON AST (from `Node#toJSON`) back into the AST classes.
@@ -458,7 +459,7 @@ export interface Postcss {
 }
 
 export const stringify: Stringifier
-export const parse: Parser
+export const parse: Parser<Root>
 export const fromJSON: JSONHydrator
 
 export const comment: Postcss['comment']

package/compiled/autoprefixer/postcss/lib/processor.d.ts

@@ -8,13 +8,14 @@ import {
 import LazyResult from './lazy-result'
 import Result from './result'
 import Root from './root'
+import NoWorkResult from './no-work-result'
 
 /**
  * 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, precss])
+ * const processor = postcss([autoprefixer, postcssNested])
  * processor.process(css1).then(result => console.log(result.css))
  * processor.process(css2).then(result => console.log(result.css))
  * ```
@@ -35,7 +36,7 @@ export default class Processor {
    * Plugins added to this processor.
    *
    * ```js
-   * const processor = postcss([autoprefixer, precss])
+   * const processor = postcss([autoprefixer, postcssNested])
    * processor.plugins.length //=> 2
    * ```
    */
@@ -67,7 +68,7 @@ export default class Processor {
    * ```js
    * const processor = postcss()
    *   .use(autoprefixer)
-   *   .use(precss)
+   *   .use(postcssNested)
    * ```
    *
    * @param plugin PostCSS plugin or `Processor` with plugins.
@@ -97,5 +98,5 @@ export default class Processor {
   process(
     css: string | { toString(): string } | Result | LazyResult | Root,
     options?: ProcessOptions
-  ): LazyResult
+  ): LazyResult | NoWorkResult
 }

package/compiled/autoprefixer/postcss/lib/result.d.ts

@@ -4,6 +4,7 @@ import {
   SourceMap,
   TransformCallback,
   Root,
+  Document,
   Node,
   Warning,
   WarningOptions
@@ -94,7 +95,7 @@ export default class Result {
    * root.toResult().root === root
    * ```
    */
-  root: Root
+  root: Root | Document
 
   /**
    * Options from the `Processor#process` or `Root#toResult` call
@@ -141,7 +142,7 @@ export default class Result {
    * @param root      Root node after all transformations.
    * @param opts      Options from the `Processor#process` or `Root#toResult`.
    */
-  constructor(processor: Processor, root: Root, opts: ResultOptions)
+  constructor(processor: Processor, root: Root | Document, opts: ResultOptions)
 
   /**
    * An alias for the `Result#css` property.

package/compiled/autoprefixer/postcss/lib/warning.d.ts

@@ -1,3 +1,4 @@
+import { RangePosition } from './css-syntax-error'
 import Node from './node'
 
 export interface WarningOptions {
@@ -12,10 +13,25 @@ export interface WarningOptions {
   word?: string
 
   /**
-   * Index in CSS node string that caused the warning.
+   * Start index, inclusive, in CSS node string that caused the warning.
    */
   index?: number
 
+  /**
+   * End index, exclusive, in CSS node string that caused the warning.
+   */
+  endIndex?: number
+
+  /**
+   * Start position, inclusive, in CSS node string that caused the warning.
+   */
+  start?: RangePosition
+
+  /**
+   * End position, exclusive, in CSS node string that caused the warning.
+   */
+  end?: RangePosition
+
   /**
    * Name of the plugin that created this warning. `Result#warn` fills
    * this property automatically.
@@ -68,7 +84,7 @@ export default class Warning {
   node: Node
 
   /**
-   * Line in the input file with this warning’s source.
+   * Line for inclusive start position in the input file with this warning’s source.
    *
    * ```js
    * warning.line //=> 5
@@ -77,7 +93,7 @@ export default class Warning {
   line: number
 
   /**
-   * Column in the input file with this warning’s source.
+   * Column for inclusive start position in the input file with this warning’s source.
    *
    * ```js
    * warning.column //=> 6
@@ -85,6 +101,24 @@ export default class Warning {
    */
   column: number
 
+  /**
+   * Line for exclusive end position in the input file with this warning’s source.
+   *
+   * ```js
+   * warning.endLine //=> 6
+   * ```
+   */
+  endLine?: number
+
+  /**
+   * Column for exclusive end position in the input file with this warning’s source.
+   *
+   * ```js
+   * warning.endColumn //=> 4
+   * ```
+   */
+  endColumn?: number
+
   /**
    * @param text Warning message.
    * @param opts Warning options.