webpacker 5.4.4 → 6.0.0.beta

data/docs/webpack.md

@@ -1,364 +0,0 @@
-# webpack
-
-
-## Configuration
-
-Webpacker gives you a default set of configuration files for test, development and
-production environments in `config/webpack/*.js`. You can configure each individual
-environment in their respective files or configure them all in the base
-`config/webpack/environment.js` file.
-
-By default, you don't need to make any changes to `config/webpack/*.js`
-files since it's all standard production-ready configuration. However,
-if you do need to customize or add a new loader, this is where you would go.
-
-Here is how you can modify webpack configuration:
-
-```js
-// config/webpack/custom.js
-module.exports = {
-  resolve: {
-    alias: {
-      jquery: 'jquery/src/jquery',
-      vue: 'vue/dist/vue.js',
-      React: 'react',
-      ReactDOM: 'react-dom',
-      vue_resource: 'vue-resource/dist/vue-resource',
-    }
-  }
-}
-
-// config/webpack/environment.js
-const { environment } = require('@rails/webpacker')
-const customConfig = require('./custom')
-
-// Set nested object prop using path notation
-environment.config.set('resolve.extensions', ['.foo', '.bar'])
-environment.config.set('output.filename', '[name].js')
-
-// Merge custom config
-environment.config.merge(customConfig)
-environment.config.merge({ devtool: 'none' })
-
-// Delete a property
-environment.config.delete('output.chunkFilename')
-
-module.exports = environment
-```
-
-If you need access to configs within Webpacker's configuration,
-you can import them like so:
-
-```js
-const { config } = require('@rails/webpacker')
-
-console.log(config.output_path)
-console.log(config.source_path)
-```
-
-## Loaders
-
-You can add additional loaders beyond the base set that Webpacker provides by
-adding it to your environment. We'll use `json-loader` as an example:
-
-```
-yarn add json-loader
-```
-
-```js
-// config/webpack/environment.js
-const { environment } = require('@rails/webpacker')
-
-const jsonLoader = {
-  test: /\.json$/,
-  use: 'json-loader'
-}
-
-// Insert json loader at the end of list
-environment.loaders.append('json', jsonLoader)
-
-// Insert json loader at the top of list
-environment.loaders.prepend('json', jsonLoader)
-
-// Insert json loader after/before a given loader
-environment.loaders.insert('json', jsonLoader, { after: 'style'} )
-environment.loaders.insert('json', jsonLoader, { before: 'babel'} )
-
-module.exports = environment
-```
-
-Finally add `.json` to the list of extensions in `config/webpacker.yml`. Now if you `import()` any `.json` files inside your JavaScript
-they will be processed using `json-loader`. Voila!
-
-You can also modify the loaders that Webpacker pre-configures for you. We'll update
-the `babel` loader as an example:
-
-```js
-// config/webpack/environment.js
-const { environment } = require('@rails/webpacker')
-
-const babelLoader = environment.loaders.get('babel')
-babelLoader.options.cacheDirectory = false
-
-module.exports = environment
-```
-
-### Coffeescript 2
-
-Out of the box webpacker supports coffeescript 1,
-but here is how you can use Coffeescript 2:
-
-```
-yarn add coffeescript@2.0.1
-```
-
-```js
-// config/webpack/environment.js
-const { environment } = require('@rails/webpacker')
-
-const babelLoader = environment.loaders.get('babel')
-
-// Replace existing coffee loader with CS2 version
-environment.loaders.insert('coffee', {
-  test: /\.coffee(\.erb)?$/,
-  use:  babelLoader.use.concat(['coffee-loader'])
-})
-
-module.exports = environment
-```
-
-### React SVG loader
-
-To use react svg loader, you should append svg loader before file loader:
-
-```js
-const { environment } = require('@rails/webpacker')
-
-const babelLoader = environment.loaders.get('babel')
-
-environment.loaders.insert('svg', {
-  test: /\.svg$/,
-  use: babelLoader.use.concat([
-    {
-      loader: 'react-svg-loader',
-      options: {
-        jsx: true // true outputs JSX tags
-      }
-    }
-  ])
-}, { before: 'file' })
-
-const fileLoader = environment.loaders.get('file')
-fileLoader.exclude = /\.(svg)$/i
-```
-
-
-### Url Loader
-
-```js
-// config/webpack/loaders/url.js
-
-module.exports = {
-  test: [/\.bmp$/, /\.gif$/, /\.jpe?g$/, /\.png$/],
-  use: [{
-    loader: 'url-loader',
-    options: {
-      limit: 10000,
-      name: '[name]-[hash].[ext]'
-    }
-  }]
-}
-
-// config/webpack/environment.js
-
-const { environment } = require('@rails/webpacker')
-const url = require('./loaders/url')
-
-environment.loaders.prepend('url', url)
-
-// avoid using both file and url loaders
-environment.loaders.get('file').test = /\.(tiff|ico|svg|eot|otf|ttf|woff|woff2)$/i
-```
-
-### Overriding Loader Options in webpack 3+ (for CSS Modules etc.)
-
-In webpack 3+, if you'd like to specify additional or different options for a loader, edit `config/webpack/environment.js` and provide an options object to override. This is similar to the technique shown above, but the following example shows specifically how to apply CSS Modules, which is what you may be looking for:
-
-```javascript
-const { environment } = require('@rails/webpacker')
-const merge = require('webpack-merge')
-
-const myCssLoaderOptions = {
-  modules: {
-    localIdentName: '[name]__[local]___[hash:base64:5]'
-  },
-  sourceMap: true,
-}
-
-const CSSLoader = environment.loaders.get('sass').use.find(el => el.loader === 'css-loader')
-
-CSSLoader.options = merge(CSSLoader.options, myCssLoaderOptions)
-
-module.exports = environment
-```
-
-See [issue #756](https://github.com/rails/webpacker/issues/756#issuecomment-327148547) for additional discussion of this.
-
-For this to work, don't forget to use the `stylesheet_pack_tag`, for example:
-
-```
-<%= stylesheet_pack_tag 'YOUR_PACK_NAME_HERE' %>
-```
-
-## Plugins
-
-The process for adding or modifying webpack plugins is the same as the process
-for loaders above:
-
-```js
-// config/webpack/environment.js
-const { environment } = require('@rails/webpacker')
-const webpack = require('webpack')
-
-// Get a pre-configured plugin
-const manifestPlugin = environment.plugins.get('Manifest')
-manifestPlugin.options.writeToFileEmit = false
-
-// Add an additional plugin of your choosing : ProvidePlugin
-environment.plugins.prepend(
-  'Provide',
-  new webpack.ProvidePlugin({
-    $: 'jquery',
-    jQuery: 'jquery',
-    jquery: 'jquery',
-    'window.Tether': 'tether',
-    Popper: ['popper.js', 'default'],
-    ActionCable: 'actioncable',
-    Vue: 'vue',
-    VueResource: 'vue-resource',
-  })
-)
-
-// Insert before a given plugin
-environment.plugins.insert('CommonChunkVendor',
-  new webpack.optimize.CommonsChunkPlugin({
-    name: 'vendor', // Vendor code
-    minChunks: (module) => module.context && module.context.indexOf('node_modules') !== -1
-  })
-, { before: 'manifest' })
-
-module.exports = environment
-```
-
-## Resolved modules
-
-To add new paths to `resolve.modules`, the API is same as loaders and plugins:
-
-```js
-const { environment } = require('@rails/webpacker')
-
-// Resolved modules list API - prepend, append, insert
-environment.resolvedModules.append('vendor', 'vendor')
-```
-
-### Add SplitChunks (Webpack V4)
-Originally, chunks (and modules imported inside them) were connected by a parent-child relationship in the internal webpack graph. The CommonsChunkPlugin was used to avoid duplicated dependencies across them, but further optimizations were not possible.
-
-Since webpack v4, the CommonsChunkPlugin was removed in favor of optimization.splitChunks.
-
-For the full configuration options of SplitChunks, see the [Webpack documentation](https://webpack.js.org/plugins/split-chunks-plugin/).
-
-```js
-// config/webpack/environment.js
-
-// Enable the default config
-environment.splitChunks()
-
-// or using custom config
-environment.splitChunks((config) => Object.assign({}, config, { optimization: { splitChunks: false }}))
-```
-
-Then use the `javascript_packs_with_chunks_tag` and `stylesheet_packs_with_chunks_tag` helpers to include all the transpiled
-packs with the chunks in your view, which creates html tags for all the chunks.
-
-```erb
-<%= javascript_packs_with_chunks_tag 'calendar', 'map', 'data-turbolinks-track': 'reload' %>
-
-<script src="/packs/vendor-16838bab065ae1e314.js" data-turbolinks-track="reload"></script>
-<script src="/packs/calendar~runtime-16838bab065ae1e314.js" data-turbolinks-track="reload"></script>
-<script src="/packs/calendar-1016838bab065ae1e314.js" data-turbolinks-track="reload"></script>
-<script src="/packs/map~runtime-16838bab065ae1e314.js" data-turbolinks-track="reload"></script>
-<script src="/packs/map-16838bab065ae1e314.js" data-turbolinks-track="reload"></script>
-```
-
-**Important:** Pass all your pack names when using this helper otherwise you will
-get duplicated chunks on the page.
-
-```erb
-<%# DO %>
-<%= javascript_packs_with_chunks_tag 'calendar', 'map' %>
-
-<%# DON'T %>
-<%= javascript_packs_with_chunks_tag 'calendar' %>
-<%= javascript_packs_with_chunks_tag 'map' %>
-```
-
-For the old configuration with the CommonsChunkPlugin see below. **Note** that this functionality is deprecated in Webpack V4.
-
-#### Preloading
-
-Before preload or prefetch your assets, please read [https://developer.mozilla.org/en-US/docs/Web/HTML/Preloading_content](https://developer.mozilla.org/en-US/docs/Web/HTML/Preloading_content).
-
-Webpack also provide it's own methods for preload or prefetch [https://medium.com/webpack/link-rel-prefetch-preload-in-webpack-51a52358f84c](https://medium.com/webpack/link-rel-prefetch-preload-in-webpack-51a52358f84c).
-
-You can preload your assets with the `preload_pack_asset` helper if you have Rails >= 5.2.x.
-
-```erb
-<%= preload_pack_asset 'fonts/fa-regular-400.woff2' %>
-```
-
-**Warning:** You don't want to preload the css, you want to preload the fonts and images inside the css so that fonts, css, and images can all be downloaded in parallel instead of waiting for the browser to parse the css.
-
-### Add common chunks (deprecated in Webpack V4)
-
-The CommonsChunkPlugin is an opt-in feature that creates a separate file (known as a chunk), consisting of common modules shared between multiple entry points. By separating common modules from bundles, the resulting chunked file can be loaded once initially, and stored in the cache for later use. This results in page speed optimizations as the browser can quickly serve the shared code from the cache, rather than being forced to load a larger bundle whenever a new page is visited.
-
-Add the plugins in `config/webpack/environment.js`:
-
-```js
-const webpack = require('webpack')
-
-environment.plugins.append(
-  'CommonsChunkVendor',
-  new webpack.optimize.CommonsChunkPlugin({
-    name: 'vendor',
-    minChunks: (module) => {
-      // this assumes your vendor imports exist in the node_modules directory
-      return module.context && module.context.indexOf('node_modules') !== -1
-    }
-  })
-)
-
-environment.plugins.append(
-  'CommonsChunkManifest',
-  new webpack.optimize.CommonsChunkPlugin({
-    name: 'manifest',
-    minChunks: Infinity
-  })
-)
-```
-
-Now, add these files to your `layouts/application.html.erb`:
-
-```erb
-<%# Head %>
-
-<%= javascript_pack_tag "manifest" %>
-<%= javascript_pack_tag "vendor" %>
-
-<%# If importing any styles from node_modules in your JS app %>
-
-<%= stylesheet_pack_tag "vendor" %>
-```
-
-More detailed guides available here: [webpack guides](https://webpack.js.org/guides/)

data/docs/yarn.md

@@ -1,23 +0,0 @@
-# Yarn
-
-Webpacker by default uses `yarn` as a package manager for `node_modules`
-
-
-## Add a new npm module
-
-To add any new JS module you can use `yarn`:
-
-```bash
-yarn add bootstrap material-ui
-```
-
-## Add an npm module to `devDependencies`
-To add a new JS module that will only be available to local development:
-
-```bash
-yarn add --dev browser-sync
-```
-
-Be careful not to add any build or app related JS modules in this fashion. Adding JS modules to `devDependencies` [will block them from being installed in **any** production environment](https://yarnpkg.com/lang/en/docs/cli/install/#toc-yarn-install-production-true-false).
-
-Docs from JS modules may instruct you to use `--dev` or `devDependencies`, but this is generally under the assumption that you are using a `node.js` workflow.

data/lib/install/angular.rb

@@ -1,23 +0,0 @@
-require "webpacker/configuration"
-
-say "Copying angular example entry file to #{Webpacker.config.source_entry_path}"
-copy_file "#{__dir__}/examples/angular/hello_angular.js", "#{Webpacker.config.source_entry_path}/hello_angular.js"
-
-say "Copying hello_angular app to #{Webpacker.config.source_path}"
-directory "#{__dir__}/examples/angular/hello_angular", "#{Webpacker.config.source_path}/hello_angular"
-
-say "Installing all angular dependencies"
-run "yarn add core-js zone.js rxjs @angular/core @angular/common @angular/compiler @angular/platform-browser @angular/platform-browser-dynamic"
-
-if Rails::VERSION::MAJOR == 5 && Rails::VERSION::MINOR > 1
-  say "You need to enable unsafe-eval rule.", :yellow
-  say "This can be done in Rails 5.2+ for development environment in the CSP initializer", :yellow
-  say "config/initializers/content_security_policy.rb with a snippet like this:", :yellow
-  say "if Rails.env.development?", :yellow
-  say "  policy.script_src :self, :https, :unsafe_eval", :yellow
-  say "else", :yellow
-  say "  policy.script_src :self, :https", :yellow
-  say "end", :yellow
-end
-
-say "Webpacker now supports angular 🎉", :green

data/lib/install/coffee.rb

@@ -1,25 +0,0 @@
-require "webpacker/configuration"
-
-say "Copying coffee loader to config/webpack/loaders"
-copy_file "#{__dir__}/loaders/coffee.js", Rails.root.join("config/webpack/loaders/coffee.js").to_s
-
-say "Adding coffee loader to config/webpack/environment.js"
-insert_into_file Rails.root.join("config/webpack/environment.js").to_s,
-  "const coffee =  require('./loaders/coffee')\n",
-  after: /require\(('|")@rails\/webpacker\1\);?\n/
-
-insert_into_file Rails.root.join("config/webpack/environment.js").to_s,
-  "environment.loaders.prepend('coffee', coffee)\n",
-  before: "module.exports"
-
-say "Updating webpack paths to include .coffee file extension"
-insert_into_file Webpacker.config.config_path, "- .coffee\n".indent(4), after: /\s+extensions:\n/
-
-say "Copying the example entry file to #{Webpacker.config.source_entry_path}"
-copy_file "#{__dir__}/examples/coffee/hello_coffee.coffee",
-  "#{Webpacker.config.source_entry_path}/hello_coffee.coffee"
-
-say "Installing all Coffeescript dependencies"
-run "yarn add coffeescript@1.12.7 coffee-loader"
-
-say "Webpacker now supports Coffeescript 🎉", :green

data/lib/install/config/.browserslistrc

@@ -1 +0,0 @@
-defaults

data/lib/install/config/babel.config.js

@@ -1,82 +0,0 @@
-module.exports = function(api) {
-  var validEnv = ['development', 'test', 'production']
-  var currentEnv = api.env()
-  var isDevelopmentEnv = api.env('development')
-  var isProductionEnv = api.env('production')
-  var isTestEnv = api.env('test')
-
-  if (!validEnv.includes(currentEnv)) {
-    throw new Error(
-      'Please specify a valid `NODE_ENV` or ' +
-        '`BABEL_ENV` environment variables. Valid values are "development", ' +
-        '"test", and "production". Instead, received: ' +
-        JSON.stringify(currentEnv) +
-        '.'
-    )
-  }
-
-  return {
-    presets: [
-      isTestEnv && [
-        '@babel/preset-env',
-        {
-          targets: {
-            node: 'current'
-          }
-        }
-      ],
-      (isProductionEnv || isDevelopmentEnv) && [
-        '@babel/preset-env',
-        {
-          forceAllTransforms: true,
-          useBuiltIns: 'entry',
-          corejs: 3,
-          modules: false,
-          exclude: ['transform-typeof-symbol']
-        }
-      ]
-    ].filter(Boolean),
-    plugins: [
-      'babel-plugin-macros',
-      '@babel/plugin-syntax-dynamic-import',
-      isTestEnv && 'babel-plugin-dynamic-import-node',
-      '@babel/plugin-transform-destructuring',
-      [
-        '@babel/plugin-proposal-class-properties',
-        {
-          loose: true
-        }
-      ],
-      [
-        '@babel/plugin-proposal-object-rest-spread',
-        {
-          useBuiltIns: true
-        }
-      ],
-      [
-        '@babel/plugin-proposal-private-methods',
-        {
-          loose: true
-        }
-      ],
-      [
-        '@babel/plugin-proposal-private-property-in-object',
-        {
-          loose: true
-        }
-      ],
-      [
-        '@babel/plugin-transform-runtime',
-        {
-          helpers: false
-        }
-      ],
-      [
-        '@babel/plugin-transform-regenerator',
-        {
-          async: false
-        }
-      ]
-    ].filter(Boolean)
-  }
-}

data/lib/install/config/postcss.config.js

@@ -1,12 +0,0 @@
-module.exports = {
-  plugins: [
-    require('postcss-import'),
-    require('postcss-flexbugs-fixes'),
-    require('postcss-preset-env')({
-      autoprefixer: {
-        flexbox: 'no-2009'
-      },
-      stage: 3
-    })
-  ]
-}

data/lib/install/config/webpack/environment.js

@@ -1,3 +0,0 @@
-const { environment } = require('@rails/webpacker')
-
-module.exports = environment

data/lib/install/elm.rb

@@ -1,39 +0,0 @@
-require "webpacker/configuration"
-
-say "Copying elm loader to config/webpack/loaders"
-copy_file "#{__dir__}/loaders/elm.js", Rails.root.join("config/webpack/loaders/elm.js").to_s
-
-say "Adding elm loader to config/webpack/environment.js"
-insert_into_file Rails.root.join("config/webpack/environment.js").to_s,
-  "const elm =  require('./loaders/elm')\n",
-  after: /require\(('|")@rails\/webpacker\1\);?\n/
-
-insert_into_file Rails.root.join("config/webpack/environment.js").to_s,
-  "environment.loaders.prepend('elm', elm)\n",
-  before: "module.exports"
-
-say "Copying Elm example entry file to #{Webpacker.config.source_entry_path}"
-copy_file "#{__dir__}/examples/elm/hello_elm.js",
-  "#{Webpacker.config.source_entry_path}/hello_elm.js"
-
-say "Copying Elm app file to #{Webpacker.config.source_path}"
-copy_file "#{__dir__}/examples/elm/Main.elm",
-  "#{Webpacker.config.source_path}/Main.elm"
-
-say "Installing all Elm dependencies"
-run "yarn add elm elm-webpack-loader"
-run "yarn add --dev elm-hot-webpack-loader"
-run "yarn run elm init"
-run "yarn run elm make #{Webpacker.config.source_path}/Main.elm"
-
-say "Updating webpack paths to include .elm file extension"
-insert_into_file Webpacker.config.config_path, "- .elm\n".indent(4), after: /\s+extensions:\n/
-
-say "Updating Elm source location"
-gsub_file "elm.json", /\"src\"\n/,
-  %("#{Webpacker.config.source_path.relative_path_from(Rails.root)}"\n)
-
-say "Updating .gitignore to include elm-stuff folder"
-insert_into_file ".gitignore", "/elm-stuff\n", before: "/node_modules\n"
-
-say "Webpacker now supports Elm 🎉", :green

data/lib/install/erb.rb

@@ -1,25 +0,0 @@
-require "webpacker/configuration"
-
-say "Copying erb loader to config/webpack/loaders"
-copy_file "#{__dir__}/loaders/erb.js", Rails.root.join("config/webpack/loaders/erb.js").to_s
-
-say "Adding erb loader to config/webpack/environment.js"
-insert_into_file Rails.root.join("config/webpack/environment.js").to_s,
-  "const erb = require('./loaders/erb')\n",
-  after: /require\(('|")@rails\/webpacker\1\);?\n/
-
-insert_into_file Rails.root.join("config/webpack/environment.js").to_s,
-  "environment.loaders.prepend('erb', erb)\n",
-  before: "module.exports"
-
-say "Updating webpack paths to include .erb file extension"
-insert_into_file Webpacker.config.config_path, "- .erb\n".indent(4), after: /\s+extensions:\n/
-
-say "Copying the example entry file to #{Webpacker.config.source_entry_path}"
-copy_file "#{__dir__}/examples/erb/hello_erb.js.erb",
-  "#{Webpacker.config.source_entry_path}/hello_erb.js.erb"
-
-say "Installing all Erb dependencies"
-run "yarn add rails-erb-loader"
-
-say "Webpacker now supports Erb in JS 🎉", :green

data/lib/install/examples/angular/hello_angular/app/app.component.ts

@@ -1,9 +0,0 @@
-import { Component } from '@angular/core';
-
-@Component({
-  selector: 'hello-angular',
-  template: `<h1>Hello {{name}}</h1>`
-})
-export class AppComponent {
-  name = 'Angular!';
-}

data/lib/install/examples/angular/hello_angular/app/app.module.ts

@@ -1,16 +0,0 @@
-import { BrowserModule } from '@angular/platform-browser';
-import { NgModule } from '@angular/core';
-
-import { AppComponent } from './app.component';
-
-@NgModule({
-  declarations: [
-    AppComponent
-  ],
-  imports: [
-    BrowserModule
-  ],
-  providers: [],
-  bootstrap: [AppComponent]
-})
-export class AppModule { }

data/lib/install/examples/angular/hello_angular/index.ts

@@ -1,8 +0,0 @@
-import './polyfills.ts';
-
-import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
-import { AppModule } from './app/app.module';
-
-document.addEventListener('DOMContentLoaded', () => {
-  platformBrowserDynamic().bootstrapModule(AppModule);
-});