{ "_args": [ [ { "raw": "react-transform-hmr@^1.0.4", "scope": null, "escapedName": "react-transform-hmr", "name": "react-transform-hmr", "rawSpec": "^1.0.4", "spec": ">=1.0.4 <2.0.0", "type": "range" }, "/home/jdaugherty/work/GT2/GT2-Android/node_modules/babel-preset-react-native" ] ], "_from": "react-transform-hmr@>=1.0.4 <2.0.0", "_id": "react-transform-hmr@1.0.4", "_inCache": true, "_location": "/react-transform-hmr", "_nodeVersion": "5.3.0", "_npmOperationalInternal": { "host": "packages-13-west.internal.npmjs.com", "tmp": "tmp/react-transform-hmr-1.0.4.tgz_1457287427851_0.17050196835771203" }, "_npmUser": { "name": "gaearon", "email": "dan.abramov@gmail.com" }, "_npmVersion": "3.3.12", "_phantomChildren": {}, "_requested": { "raw": "react-transform-hmr@^1.0.4", "scope": null, "escapedName": "react-transform-hmr", "name": "react-transform-hmr", "rawSpec": "^1.0.4", "spec": ">=1.0.4 <2.0.0", "type": "range" }, "_requiredBy": [ "/babel-preset-react-native" ], "_resolved": "https://registry.npmjs.org/react-transform-hmr/-/react-transform-hmr-1.0.4.tgz", "_shasum": "e1a40bd0aaefc72e8dfd7a7cda09af85066397bb", "_shrinkwrap": null, "_spec": "react-transform-hmr@^1.0.4", "_where": "/home/jdaugherty/work/GT2/GT2-Android/node_modules/babel-preset-react-native", "author": { "name": "Dan Abramov", "email": "dan.abramov@me.com" }, "bugs": { "url": "https://github.com/gaearon/react-transform-hmr/issues" }, "dependencies": { "global": "^4.3.0", "react-proxy": "^1.1.7" }, "description": "A React Transform that enables hot reloading React classes using Hot Module Replacement API", "devDependencies": { "babel": "^5.8.23", "rimraf": "^2.4.3" }, "directories": {}, "dist": { "shasum": "e1a40bd0aaefc72e8dfd7a7cda09af85066397bb", "tarball": "https://registry.npmjs.org/react-transform-hmr/-/react-transform-hmr-1.0.4.tgz" }, "files": [ "lib", "src" ], "gitHead": "1ab7759a0b0700e71895dabc6a94e2f819455bd3", "homepage": "https://github.com/gaearon/react-transform-hmr#readme", "keywords": [ "react-transform", "react", "reactjs", "webpack", "hmr", "live", "edit", "hot", "reload", "rhl", "dx" ], "license": "MIT", "main": "lib/index.js", "maintainers": [ { "name": "gaearon", "email": "dan.abramov@gmail.com" }, { "name": "thejameskyle", "email": "me@thejameskyle.com" } ], "name": "react-transform-hmr", "optionalDependencies": {}, "readme": "# react-transform-hmr\n\n[![react-transform channel on discord](https://img.shields.io/badge/discord-react--transform%40reactiflux-61DAFB.svg?style=flat-square)](http://www.reactiflux.com)\n\n\nA [React Transform](https://github.com/gaearon/babel-plugin-react-transform) that enables hot reloading React classes using Hot Module Replacement API. Hot module replacement is [supported natively by Webpack](http://webpack.github.io/docs/hot-module-replacement-with-webpack.html) and available in Browserify with [browserify-hmr](https://github.com/AgentME/browserify-hmr).\n\n## 🚧🚧🚧🚧🚧\n\nThis is **highly experimental tech**. If you’re enthusiastic about hot reloading, by all means, give it a try, but don’t bet your project on it. Either of the technologies it relies upon may change drastically or get deprecated any day. You’ve been warned 😉 .\n\n**This technology exists to prototype next-generation React developer experience**. Please don’t use it blindly if you don’t know the underlying technologies well. Otherwise you are likely to get disillusioned with JavaScript tooling.\n\n**No effort went into making this user-friendly yet. The goal is to eventually kill this technology** in favor of less hacky technologies baked into React. These projects are not long term.\n\n## Installation\n\nFirst, install the [Babel plugin](https://github.com/gaearon/babel-plugin-react-transform):\n\n```\nnpm install --save-dev babel-plugin-react-transform\n```\n\nThen, install the transform:\n\n```\nnpm install --save-dev react-transform-hmr\n```\n\n### React\n\nEdit your `.babelrc` to include a plugin configuration for `react-transform`. It contains array of the transforms you want to use:\n\n```js\n{\n \"presets\": [\"es2015\", \"stage-0\"],\n \"env\": {\n // only enable it when process.env.NODE_ENV is 'development' or undefined\n \"development\": {\n \"plugins\": [[\"react-transform\", {\n \"transforms\": [{\n \"transform\": \"react-transform-hmr\",\n // if you use React Native, pass \"react-native\" instead:\n \"imports\": [\"react\"],\n // this is important for Webpack HMR:\n \"locals\": [\"module\"]\n }]\n // note: you can put more transforms into array\n // this is just one of them!\n }]]\n }\n }\n}\n```\n\nMake sure you process files with `babel-loader`, and that you *don’t* use React Hot Loader (it’s not needed with this transform).\n\n**It is up to you to ensure that the transform is not enabled when you compile the app in production mode.** The easiest way to do this is to put React Transform configuration inside `env.development` in `.babelrc` and ensure you’re calling `babel` with `NODE_ENV=production`. See [babelrc documentation](https://babeljs.io/docs/usage/babelrc/#env-option) for more details about using `env` option.\n\n**Warning!** This doesn't currently work for stateless functional components that were introduced in [React 0.14](https://facebook.github.io/react/blog/2015/10/07/react-v0.14.html#stateless-functional-components)!\n\n### React Native\n\nThis transform enables hot reloading when used together with [React Native Webpack Server](https://github.com/mjohnston/react-native-webpack-server). **However note that you should not use `.babelrc` to configure it with React Native.** Otherwise you’ll get [`Uncaught SyntaxError: Unexpected reserved word` in `ActivityIndicatorIOS.ios.js`](https://github.com/mjohnston/react-native-webpack-server/issues/57#issuecomment-141487449).\n\nThere are two problems why `.babelrc` doesn’t work well in React Native:\n\n* Changes in it [aren’t picked up by packager’s aggressive caching](https://github.com/mjohnston/react-native-webpack-server/issues/63).\n* Another unknown problem causes `import` generated by `babel-plugin-react-transform` to not be compiled into a `require` call.\n\nUntil we have better `.babelrc` support in React Native, **you should configure React Transform together with `babel-loader`**:\n\n```js\nvar fs = require('fs');\nvar path = require('path');\nvar webpack = require('webpack');\n\nvar config = {\n debug: true,\n\n devtool: 'source-map',\n\n entry: {\n 'index.ios': ['./src/main.js'],\n },\n\n output: {\n path: path.resolve(__dirname, 'build'),\n filename: '[name].js',\n },\n\n module: {\n loaders: [{\n test: /\\.js$/,\n exclude: /node_modules/,\n loader: 'babel',\n query: {\n stage: 0,\n plugins: []\n }\n }]\n },\n\n plugins: []\n};\n\n// Hot mode\nif (process.env.HOT) {\n config.devtool = 'eval';\n config.entry['index.ios'].unshift('react-native-webpack-server/hot/entry');\n config.entry['index.ios'].unshift('webpack/hot/only-dev-server');\n config.entry['index.ios'].unshift('webpack-dev-server/client?http://localhost:8082');\n config.output.publicPath = 'http://localhost:8082/';\n config.plugins.unshift(new webpack.HotModuleReplacementPlugin());\n\n // Note: enabling React Transform and React Transform HMR:\n config.module.loaders[0].query.plugins.push([\n 'react-transform', {\n transforms: [{\n transform : 'react-transform-hmr',\n imports : ['react'],\n locals : ['module']\n }]\n }\n ]);\n}\n\nif (process.env.NODE_ENV === 'production') {\n config.plugins.push(new webpack.optimize.OccurrenceOrderPlugin());\n config.plugins.push(new webpack.optimize.UglifyJsPlugin());\n}\n\nmodule.exports = config;\n```\n\nSee [React Native Webpack Server examples](https://github.com/mjohnston/react-native-webpack-server/tree/master/Examples/) for details.\n\n\n## License\n\nMIT\n", "readmeFilename": "README.md", "repository": { "type": "git", "url": "git+https://github.com/gaearon/react-transform-hmr.git" }, "scripts": { "build": "babel src --out-dir lib", "clean": "rimraf lib", "prepublish": "npm run clean && npm run build" }, "version": "1.0.4" }