webpacker 5.4.4 → 6.0.0.beta

data/docs/props.md

@@ -1,223 +0,0 @@
-# Props
-
-
-## React
-
-If you need more advanced React-integration, like server rendering, redux, or react-router, see [shakacode/react_on_rails](https://github.com/shakacode/react_on_rails), [react-rails](https://github.com/reactjs/react-rails), and [webpacker-react](https://github.com/renchap/webpacker-react).
-
-If you're not concerned with view helpers to pass props or server rendering, can do it yourself:
-
-```erb
-<%# views/layouts/application.html.erb %>
-
-<%= content_tag :div,
-  id: "hello-react",
-  data: {
-    message: 'Hello!',
-    name: 'David'
-}.to_json do %>
-<% end %>
-```
-
-```js
-// app/javascript/packs/hello_react.js
-
-const Hello = props => (
-  <div className='react-app-wrapper'>
-    <img src={clockIcon} alt="clock" />
-    <h5 className='hello-react'>
-      {props.message} {props.name}!
-    </h5>
-  </div>
-)
-
-// Render component with data
-document.addEventListener('DOMContentLoaded', () => {
-  const node = document.getElementById('hello-react')
-  const data = JSON.parse(node.getAttribute('data'))
-
-  ReactDOM.render(<Hello {...data} />, node)
-})
-```
-
-
-## Vue
-
-Add the data as attributes in the element you are going to use (or any other element for that matter).
-
-```erb
-<%= content_tag :div,
-  id: "hello-vue",
-  data: {
-    message: "Hello!",
-    name: "David"
-  }.to_json do %>
-<% end %>
-```
-
-This should produce the following HTML:
-
-```html
-<div id="hello-vue" data="{&quot;message&quot;:&quot;Hello!&quot;,&quot;name&quot;:&quot;David&quot;}"></div>
-```
-
-Now, modify your Vue app to expect the properties.
-
-```html
-<template>
-  <div id="app">
-    <p>{{test}}{{message}}{{name}}</p>
-  </div>
-</template>
-
-<script>
-  export default {
-    // A child component needs to explicitly declare
-    // the props it expects to receive using the props option
-    // See https://vuejs.org/v2/guide/components.html#Props
-    props: ["message","name"],
-    data: function () {
-      return {
-        test: 'This will display: '
-      }
-    }
-  }
-</script>
-
-<style>
-</style>
-
-```
-
-```js
-document.addEventListener('DOMContentLoaded', () => {
-  // Get the properties BEFORE the app is instantiated
-  const node = document.getElementById('hello-vue')
-  const props = JSON.parse(node.getAttribute('data'))
-
-  // Render component with props
-  new Vue({
-    render: h => h(App, { props })
-  }).$mount('#hello-vue');
-})
-```
-
-You can follow same steps for Angular too.
-
-
-## Elm
-
-Just like with other implementations, we'll render our data inside a `data`
-attribute:
-
-```erb
-<%= content_tag :div,
-  id: "hello-elm",
-  data: {
-    message: "Hello",
-    name: "David"
-  }.to_json do %>
-<% end %>
-```
-
-We parse the JSON data and pass it to Elm as flags:
-
-```js
-import Elm from '../Main'
-
-document.addEventListener('DOMContentLoaded', () => {
-  const node = document.getElementById('hello-elm')
-  const data = JSON.parse(node.getAttribute('data'))
-  Elm.Main.embed(node, data)
-})
-```
-
-Defining `Flags` as a `type alias`, we instruct Elm to demand flags `message`
-and `name` of type `String` on initialization.
-
-Using `programWithFlags` we bring all the pieces together:
-
-
-```elm
-module Main exposing (..)
-
-import Html exposing (Html, programWithFlags, h1, text)
-import Html.Attributes exposing (style)
-
-
--- MODEL
-
-
-type alias Flags =
-    { message : String
-    , name : String
-    }
-
-
-type alias Model =
-    { message : String
-    , name : String
-    }
-
-
-type Msg
-    = NoOp
-
-
-
--- INIT
-
-
-init : Flags -> ( Model, Cmd Msg )
-init flags =
-    let
-        { message, name } =
-            flags
-    in
-        ( Model message name, Cmd.none )
-
-
-
--- UPDATE
-
-
-update : Msg -> Model -> ( Model, Cmd Msg )
-update msg model =
-    case msg of
-        NoOp ->
-            ( model, Cmd.none )
-
-
-
--- SUBSCRIPTIONS
-
-
-subscriptions : Model -> Sub Msg
-subscriptions model =
-    Sub.none
-
-
-
--- VIEW
-
-
-view : Model -> Html Msg
-view model =
-    h1 [ style [ ( "display", "flex" ), ( "justify-content", "center" ) ] ]
-        [ text (model.message ++ ", " ++ model.name ++ "!") ]
-
-
-
--- MAIN
-
-
-main : Program Flags Model Msg
-main =
-    programWithFlags
-        { view = view
-        , init = init
-        , update = update
-        , subscriptions = subscriptions
-        }
-
-```

data/docs/target.md

@@ -1,22 +0,0 @@
-# Target browsers
-
-By default webpacker provides these front-end tools:
-- [@babel/preset-env](https://github.com/babel/babel/tree/master/packages/babel-preset-env)
-- [Autoprefixer](https://github.com/postcss/autoprefixer)
-- [postcss-preset-env](https://github.com/csstools/postcss-preset-env)
-
-All these tools use [Browserslist](https://github.com/browserslist/browserslist) to detect which environment your users have
-
-Webpacker browserslist default target:
-```
-defaults
-```
-
-`defaults`: `(> 0.5%, last 2 versions, Firefox ESR, not dead)`, [browserl.ist](https://browserl.ist/) is an online tool to check what browsers will be selected by some query.
-
-To keep browsers data up to date, you need to run:
-```bash
-yarn upgrade caniuse-lite
-```
-
-at least once every few months, to prevent such [problems](https://github.com/browserslist/browserslist/issues/492)

data/docs/testing.md

@@ -1,136 +0,0 @@
-# Testing
-
-## Karma setup for Typescript
-
-Webpacker does not setup `Karma` by default, so you've to manually install it along with its dependencies as per your need. Following things marked as optional can be used to fancify the test results (Recommended).
-
-```js
-// package.json
-"scripts": {
-  "test": "NODE_ENV=test karma start"
-},
-"dependencies": {
-  "typescript": "^2.5.2"
-},
-"devDependencies": {
-  "karma": "^1.7.1",
-  "karma-webpack": "^2.0.4",
-  "karma-chrome-launcher": "^2.2.0",
-  "karma-jquery": "^0.2.2",
-  "karma-jasmine": "^1.1.0",
-  "karma-jasmine-jquery": "^0.1.1",
-  "jasmine-core": "^2.8.0",
-  [optional] "karma-coverage": "^1.1.1",
-  [optional] "karma-coverage-istanbul-reporter": "^1.3.0",
-  [optional] "karma-spec-reporter": "0.0.31",
-  [optional] "istanbul-instrumenter-loader": "^3.0.0",
-}
-```
-
-It is beneficial to use the same webpack configuration file (generated by webpacker) in Karma configuration to avoid redundancy. Following line tells Karma not to write transpiled source files onto filesystem while testing to avoid `Error: EACCES: permission denied, mkdir '/_karma_webpack_' ` error. Then inject a new rule a.k.a. loader in the existing ones (needed only if you have installed `istanbul-instrumenter-loader`) to generate a coverage report under `/coverage` directory.
-
-```js
-// config/webpack/test.js
-const environment = require('./environment')
-environment.plugins.get('Manifest').options.writeToFileEmit = process.env.NODE_ENV !== 'test'
-environment.loaders.append('istanbul-instrumenter', {
-  test: /\.ts$/,
-  enforce: "post",
-  loader: "istanbul-instrumenter-loader",
-  query: {
-    esModules: true
-  },
-  exclude: ["node_modules", /\.test\.ts$/]
-}) /* optional */
-module.exports = environment.toWebpackConfig()
-```
-
-Finally, update `karma.conf.js` to read the same `test.js` file mentioned above. Rest of the things are mandatory (few marked as optional wherever appropriate).
-
-```js
-// karma.conf.js
-const webpackConfig = require('./config/webpack/test.js')
-module.exports = function(config) {
-  config.set({
-    basePath: "",
-    frameworks: ["jquery-3.2.1", "jasmine-jquery", "jasmine"],
-    plugins: [
-      "karma-jquery",
-      "karma-jasmine-jquery",
-      "karma-jasmine",
-      "karma-webpack",
-      "karma-chrome-launcher",
-      "karma-coverage-istanbul-reporter" /* optional */,
-      "karma-spec-reporter" /* optional */
-    ],
-    files: [ "/* add spec files */" ],
-    exclude: [],
-    webpack: webpackConfig,
-    preprocessors: {"/* add spec files */" : ["webpack"]},
-    mime: { "text/x-typescript": ["ts"] },
-    reporters: ["progress", "coverage-istanbul" /* optional */],
-    coverageIstanbulReporter: {
-      reports: [ 'html', 'lcovonly', 'text-summary' ],
-      fixWebpackSourcePaths: true
-    } /* optional */,
-    port: 9876,
-    colors: true,
-    logLevel: config.LOG_INFO,
-    autoWatch: true,
-    browsers: ["Chrome"],
-    singleRun: true
-  });
-};
-```
-
-## Lazy compilation
-
-Webpacker lazily compiles assets in test env so you can write your tests without any extra
-setup and everything will just work out of the box.
-
-Here is a sample system test case with hello_react example component:
-
-```js
-// Example React component
-
-import React from 'react'
-import ReactDOM from 'react-dom'
-import PropTypes from 'prop-types'
-
-const Hello = props => (
-  <div>Hello David</div>
-)
-
-document.addEventListener('DOMContentLoaded', () => {
-  ReactDOM.render(
-    <Hello />,
-    document.body.appendChild(document.createElement('div')),
-  )
-})
-```
-
-```erb
-<%# views/pages/home.html.erb %>
-
-<%= javascript_pack_tag "hello_react" %>
-```
-
-```rb
-# Tests example React component
-require "application_system_test_case"
-class HomesTest < ApplicationSystemTestCase
-  test "can see the hello message" do
-    visit root_url
-    assert_selector "h5", text: "Hello! David"
-  end
-end
-```
-
-## Capybara setup for Rails
-Make sure you configure Rails to serve static files from the public directory in the test environment.
-
-```rb
-# config/environments/test.rb
-# Configure public file server for tests with Cache-Control for performance.
-config.public_file_server.enabled = true
-```

data/docs/troubleshooting.md

@@ -1,158 +0,0 @@
-# Troubleshooting
-
-## Debugging your webpack config
-
-1. Read the error message carefully. The error message will tell you the precise key value
-   that is not matching what Webpack expects.
-2. Put a `debugger` statement in your Webpack configuration and run `bin/webpack --debug-webpacker`.
-   If you have a node debugger installed, you'll see the Chrome debugger for your webpack
-   config. For example, install the Chrome extension [NiM](https://chrome.google.com/webstore/detail/nodejs-v8-inspector-manag/gnhhdgbaldcilmgcpfddgdbkhjohddkj) and
-   set the option for the dev tools to open automatically. For more details on debugging,
-   see the official [Webpack docs on debugging](https://webpack.js.org/contribute/debugging/#devtools)
-3. Any arguments that you add to bin/webpack get sent to webpack. For example, you can pass `--debug` to switch loaders to debug mode. See [webpack CLI debug options](https://webpack.js.org/api/cli/#debug-options) for more information on the available options.
-4. You can also pass additional options to the command to run the webpack-dev-server and start the webpack-dev-server with the option `--debug-webpacker`
-
-## ENOENT: no such file or directory - node-sass
-
-If you get the error `ENOENT: no such file or directory - node-sass` on deploy with
-`assets:precompile` or `bundle exec rails webpacker:compile` you may need to
-move Sass to production `dependencies`.
-
-Move any packages that related to Sass (e.g. `node-sass` or `sass-loader`) from
-`devDependencies` to `dependencies` in `package.json`. This is because
-webpacker is running on a production system with the Rails workflow to build
-the assets. Particularly on hosting providers that try to detect and do the right
-thing, like Heroku.
-
-However, if you get this on local development, or not during a deploy then you
-may need to rebuild `node-sass`. It's a bit of a weird error; basically, it
-can't find the `node-sass` binary.  An easy solution is to create a postinstall
-hook to ensure `node-sass` is rebuilt whenever new modules are installed.
-
-In `package.json`:
-
-```json
-"scripts": {
-  "postinstall": "npm rebuild node-sass"
-}
-```
-
-## Can't find hello_react.js in manifest.json
-
-* If you get this error `Can't find hello_react.js in manifest.json`
-when loading a view in the browser it's because webpack is still compiling packs.
-Webpacker uses a `manifest.json` file to keep track of packs in all environments,
-however since this file is generated after packs are compiled by webpack. So,
-if you load a view in browser whilst webpack is compiling you will get this error.
-Therefore, make sure webpack
-(i.e `./bin/webpack-dev-server`) is running and has
-completed the compilation successfully before loading a view.
-
-
-## throw er; // Unhandled 'error' event
-
-* If you get this error while trying to use Elm, try rebuilding Elm. You can do
-  so with a postinstall hook in your `package.json`:
-
-```
-"scripts": {
-  "postinstall": "npm rebuild elm"
-}
-```
-
-
-## webpack or webpack-dev-server not found
-
-* This could happen if  `webpacker:install` step is skipped. Please run `bundle exec rails webpacker:install` to fix the issue.
-
-* If you encounter the above error on heroku after upgrading from Rails 4.x to 5.1.x, then the problem might be related to missing `yarn` binstub. Please run following commands to update/add binstubs:
-
-```bash
-bundle config --delete bin
-./bin/rails app:update:bin # or rails app:update:bin
-```
-
-
-## Running webpack on Windows
-
-If you are running webpack on Windows, your command shell may not be able to interpret the preferred interpreter
-for the scripts generated in `bin/webpack` and `bin/webpack-dev-server`. Instead you'll want to run the scripts
-manually with Ruby:
-
-```
-C:\path>ruby bin\webpack
-C:\path>ruby bin\webpack-dev-server
-```
-
-
-## Invalid configuration object. webpack has been initialised using a configuration object that does not match the API schema.
-
-If you receive this error when running `$ ./bin/webpack-dev-server` ensure your configuration is correct; most likely the path to your "packs" folder is incorrect if you modified from the original "source_path" defined in `config/webpacker.yml`.
-
-## Running Elm on Continuous Integration (CI) services such as CircleCI, CodeShip, Travis CI
-
-If your tests are timing out or erroring on CI it is likely that you are experiencing the slow Elm compilation issue described here: [elm-compiler issue #1473](https://github.com/elm-lang/elm-compiler/issues/1473)
-
-The issue is related to CPU count exposed by the underlying service. The basic solution involves using [libsysconfcpus](https://github.com/obmarg/libsysconfcpus) to change the reported CPU count.
-
-Basic fix involves:
-
-```bash
-# install sysconfcpus on CI
-git clone https://github.com/obmarg/libsysconfcpus.git $HOME/dependencies/libsysconfcpus
-cd libsysconfcpus
-.configure --prefix=$HOME/dependencies/sysconfcpus
-make && make install
-
-# use sysconfcpus with elm-make
-mv $HOME/your_rails_app/node_modules/.bin/elm-make $HOME/your_rails_app/node_modules/.bin/elm-make-old
-printf "#\041/bin/bash\n\necho \"Running elm-make with sysconfcpus -n 2\"\n\n$HOME/dependencies/sysconfcpus/bin/sysconfcpus -n 2 $HOME/your_rails_app/node_modules/.bin/elm-make-old \"\$@\"" > $HOME/your_rails_app/node_modules/.bin/elm-make
-chmod +x $HOME/your_rails_app/node_modules/.bin/elm-make
-```
-
-## Rake assets:precompile fails. ExecJS::RuntimeError
-This error occurs because you are trying to minify by terser a pack that's already been minified by Webpacker. To avoid this conflict and prevent appearing of ExecJS::RuntimeError error, you will need to disable uglifier from Rails config:
-
-```ruby
-// production.rb
-# From
-
-Rails.application.config.assets.js_compressor = :uglifier
-
-# To
-
-Rails.application.config.assets.js_compressor = Uglifier.new(harmony: true)
-
-```
-
-### Angular: WARNING in ./node_modules/@angular/core/esm5/core.js, Critical dependency: the request of a dependency is an expression
-
-To silent these warnings, please update `config/webpack/environment.js`
-
-```js
-// environment.js
-const webpack = require('webpack')
-const { resolve } = require('path')
-const { environment, config } = require('@rails/webpacker')
-
-environment.plugins.append('ContextReplacement',
-  new webpack.ContextReplacementPlugin(
-    /angular(\\|\/)core(\\|\/)(@angular|esm5)/,
-    resolve(config.source_path)
-  )
-)
-```
-
-### Compilation Fails Silently
-
-If compiling is not producing output files and there are no error messages to help troubleshoot. Setting the webpack_compile_output configuration variable to 'true' in webpacker.yml may add some helpful error information to your log file (Rails log/development.log or log/production.log)
-
-```yml
-# webpacker.yml
-default: &default
-  source_path: app/javascript
-  source_entry_path: packs
-  public_root_path: public
-  public_output_path: complaints_packs
-  webpack_compile_output: true
-```