upgrade to 2.x

Author: lcxfs1991

.gitignore

@@ -1,5 +1,8 @@
 /node_modules
+
 /example/assets
-/test/js
 
+/test/js
 /coverage
+
+/.idea

.travis.yml

@@ -1,7 +1,7 @@
 sudo: false
 language: node_js
 node_js:
-  - "0.12"
+  - "4"
   - node
 script: npm run travis
 

README.md

@@ -1,4 +1,18 @@
-# extract text plugin for webpack
+# extract text plugin for webpack 2
+
+The API has changed since version 1. For the webpack 1 version, see [the README in the webpack-1 branch](https://github.com/webpack/extract-text-webpack-plugin/blob/webpack-1/README.md).
+
+## Install
+
+> You can either install it with [npm](https://nodejs.org/en/) or [yarn](https://yarnpkg.com/)
+
+```sh
+npm install --save-dev extract-text-webpack-plugin
+```
+or
+```sh
+yarn add --dev extract-text-webpack-plugin
+```
 
 ## Usage example with css
 
@@ -7,7 +21,10 @@ var ExtractTextPlugin = require("extract-text-webpack-plugin");
 module.exports = {
 	module: {
 		loaders: [
-			{ test: /\.css$/, loader: ExtractTextPlugin.extract("style-loader", "css-loader") }
+			{ test: /\.css$/, loader: ExtractTextPlugin.extract({
+				fallbackLoader: "style-loader",
+				loader: "css-loader"
+			}) }
 		]
 	},
 	plugins: [
@@ -37,42 +54,39 @@ Caveats:
 ## API
 
 ``` javascript
-new ExtractTextPlugin([id: string], filename: string, [options])
+new ExtractTextPlugin(options: filename | object)
 ```
 
-* `id` Unique ident for this plugin instance. (For advanced usage only; by default, automatically generated)
-* `filename` the filename of the result file. May contain `[name]`, `[id]` and `[contenthash]`.
+* `options.filename: string` _(required)_ the filename of the result file. May contain `[name]`, `[id]` and `[contenthash]`
   * `[name]` the name of the chunk
   * `[id]` the number of the chunk
   * `[contenthash]` a hash of the content of the extracted file
-* `options`
-  * `allChunks` extract from all additional chunks too (by default it extracts only from the initial chunk(s))
-  * `disable` disables the plugin
-  * `filenamefilter` function to modify path and filename before files are emitted
-    
-    ```
-    {
-      filenamefilter: function(filename) {
-        // modify filename
-        return filename;
-      }
-    }
-    ```
+* `options.allChunks: boolean` extract from all additional chunks too (by default it extracts only from the initial chunk(s))
+* `options.disable: boolean` disables the plugin
+* `options.id: string` Unique ident for this plugin instance. (For advanced usage only, by default automatically generated)
+* `filenamefilter` function to modify path and filename before files are emitted
+```
+{
+  filenamefilter: function(filename) {
+    // modify filename
+    return filename;
+  }
+}
+```
 
 The `ExtractTextPlugin` generates an output file per entry, so you must use `[name]`, `[id]` or `[contenthash]` when using multiple entries.
 
 ``` javascript
-ExtractTextPlugin.extract([notExtractLoader], loader, [options])
+ExtractTextPlugin.extract(options: loader | object)
 ```
 
-Creates an extracting loader from an existing loader.
+Creates an extracting loader from an existing loader. Supports loaders of type `{ loader: string; query: object }`.
 
-* `notExtractLoader` (optional) the loader(s) that should be used when the css is not extracted (i.e. in an additional chunk when `allChunks: false`)
-* `loader` the loader(s) that should be used for converting the resource to a css exporting module.
-* `options`
-  * `publicPath` override the `publicPath` setting for this loader.
+* `options.loader: string | object | loader[]` _(required)_ the loader(s) that should be used for converting the resource to a css exporting module
+* `options.fallbackLoader: string | object | loader[]` the loader(s) that should be used when the css is not extracted (i.e. in an additional chunk when `allChunks: false`)
+* `options.publicPath: string` override the `publicPath` setting for this loader
 
-There is also an `extract` function on the instance. You should use this if you have more than one ExtractTextPlugin.
+There is also an `extract` function on the instance. You should use this if you have more than one `ExtractTextPlugin`.
 
 ```javascript
 let ExtractTextPlugin = require('extract-text-webpack-plugin');
@@ -85,8 +99,8 @@ module.exports = {
   ...
   module: {
     loaders: [
-      {test: /\.scss$/i, loader: extractCSS.extract(['css','sass'])},
-      {test: /\.less$/i, loader: extractLESS.extract(['css','less'])},
+      { test: /\.scss$/i, loader: extractCSS.extract(['css-loader','sass-loader']) },
+      { test: /\.less$/i, loader: extractLESS.extract(['css-loader','less-loader']) },
       ...
     ]
   },

example/webpack.config.js

@@ -13,22 +13,21 @@ module.exports = {
 	},
 	module: {
 		loaders: [
-			{ test: /\.css$/, loader: ExtractTextPlugin.extract(
-				"style-loader",
-				"css-loader?sourceMap",
-				{
-					publicPath: "../"
-				}
-			)},
+			{ test: /\.css$/, loader: ExtractTextPlugin.extract({
+				notExtractLoader: "style-loader",
+				loader: "css-loader?sourceMap",
+				publicPath: "../"
+			}) },
 			{ test: /\.png$/, loader: "file-loader" }
 		]
 	},
 	devtool: "source-map",
 	plugins: [
-		new ExtractTextPlugin("css/[name].css?[hash]-[chunkhash]-[contenthash]-[name]", {
+		new ExtractTextPlugin({
+			filename: "css/[name].css?[hash]-[chunkhash]-[contenthash]-[name]",
 			disable: false,
 			allChunks: true
 		}),
-		new webpack.optimize.CommonsChunkPlugin("c", "c.js")
+		new webpack.optimize.CommonsChunkPlugin({ name: "c", filename: "c.js" })
 	]
 };