Add CJS, ESM, UMD builds (#2)

* Add .editorconfig

* Inline invariant

* Replace `console.error` with `error`

* Rename package

* Tweak build configuration

* Update dependencies

Author: NMinhNguyen

.editorconfig

@@ -0,0 +1,18 @@
+# http://editorconfig.org
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+insert_final_newline = true
+max_line_length = 80
+trim_trailing_whitespace = true
+
+[*.md]
+max_line_length = 0
+trim_trailing_whitespace = false
+
+[COMMIT_EDITMSG]
+max_line_length = 0

.gitignore

@@ -1 +1,2 @@
 node_modules
+build/

.prettierrc

@@ -0,0 +1,7 @@
+{
+  "bracketSpacing": false,
+  "singleQuote": true,
+  "jsxBracketSameLine": true,
+  "trailingComma": "all",
+  "printWidth": 80
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Facebook, Inc. and its affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,26 +1,63 @@
-# `react-test-renderer`
+# `react-shallow-renderer`
 
-This package provides an experimental React renderer that can be used to render React components to pure JavaScript objects, without depending on the DOM or a native mobile environment.
+When writing unit tests for React, shallow rendering can be helpful. Shallow rendering lets you render a component "one level deep" and assert facts about what its render method returns, without worrying about the behavior of child components, which are not instantiated or rendered. This does not require a DOM.
 
-Essentially, this package makes it easy to grab a snapshot of the "DOM tree" rendered by a React DOM or React Native component without using a browser or jsdom.
+## Installation
 
-Documentation:
+```sh
+# npm
+npm install react-shallow-renderer --save-dev
 
-[https://reactjs.org/docs/test-renderer.html](https://reactjs.org/docs/test-renderer.html)
+# Yarn
+yarn add react-shallow-renderer --dev
+```
+
+## Usage
 
-Usage:
+For example, if you have the following component:
 
 ```jsx
-const ReactTestRenderer = require('react-test-renderer');
+function MyComponent() {
+  return (
+    <div>
+      <span className="heading">Title</span>
+      <Subcomponent foo="bar" />
+    </div>
+  );
+}
+```
 
-const renderer = ReactTestRenderer.create(
-  <Link page="https://www.facebook.com/">Facebook</Link>
-);
+Then you can assert:
 
-console.log(renderer.toJSON());
-// { type: 'a',
-//   props: { href: 'https://www.facebook.com/' },
-//   children: [ 'Facebook' ] }
+```jsx
+import ShallowRenderer from 'react-shallow-renderer';
+// in your test:
+const renderer = new ShallowRenderer();
+renderer.render(<MyComponent />);
+const result = renderer.getRenderOutput();
+expect(result.type).toBe('div');
+expect(result.props.children).toEqual([
+  <span className="heading">Title</span>,
+  <Subcomponent foo="bar" />,
+]);
 ```
 
-You can also use Jest's snapshot testing feature to automatically save a copy of the JSON tree to a file and check in your tests that it hasn't changed: https://facebook.github.io/jest/blog/2016/07/27/jest-14.html.
+Shallow testing currently has some limitations, namely not supporting refs.
+
+> Note:
+>
+> We also recommend checking out Enzyme's [Shallow Rendering API](https://airbnb.io/enzyme/docs/api/shallow.html). It provides a nicer higher-level API over the same functionality.
+
+## Reference
+
+### `shallowRenderer.render()`
+
+You can think of the shallowRenderer as a "place" to render the component you're testing, and from which you can extract the component's output.
+
+`shallowRenderer.render()` is similar to [`ReactDOM.render()`](https://reactjs.org/docs/react-dom.html#render) but it doesn't require DOM and only renders a single level deep. This means you can test components isolated from how their children are implemented.
+
+### `shallowRenderer.getRenderOutput()`
+
+After `shallowRenderer.render()` has been called, you can use `shallowRenderer.getRenderOutput()` to get the shallowly rendered output.
+
+You can then begin to assert facts about the output.

babel.config.js

@@ -1,7 +1,30 @@
 module.exports = {
-  presets: ['@babel/preset-env', '@babel/preset-react'],
+  presets: [
+    [
+      '@babel/preset-env',
+      {
+        modules: process.env.NODE_ENV === 'test' ? 'auto' : false,
+        // Exclude transforms that make all code slower.
+        exclude: ['transform-typeof-symbol'],
+        targets: process.env.NODE_ENV === 'test' ? {node: 'current'} : {ie: 11},
+      },
+    ],
+    '@babel/preset-react',
+  ],
   plugins: [
-    '@babel/plugin-proposal-class-properties',
+    ['@babel/plugin-proposal-class-properties', {loose: true}],
+    ['@babel/plugin-transform-classes', {loose: true}],
+    ['@babel/plugin-transform-template-literals', {loose: true}],
+    // The following plugin is configured to use `Object.assign` directly.
+    // Note that we ponyfill `Object.assign` below.
+    // { ...todo, complete: true }
+    [
+      '@babel/plugin-proposal-object-rest-spread',
+      {loose: true, useBuiltIns: true},
+    ],
+    // Use 'object-assign' ponyfill.
+    require.resolve('./scripts/babel/transform-object-assign-require'),
+    // Keep stacks detailed in tests.
     process.env.NODE_ENV === 'test' &&
       '@babel/plugin-transform-react-jsx-source',
   ].filter(Boolean),

shallow.js renamed to index.js

@@ -1,3 +1,4 @@
 module.exports = {
+  modulePathIgnorePatterns: ['<rootDir>/build/'],
   setupFilesAfterEnv: ['./scripts/jest/setupTests.js'],
 };

jest.config.js

@@ -0,0 +1 @@
+export {default} from './react-shallow-renderer';

npm/esm/index.js

@@ -0,0 +1,3 @@
+'use strict';
+
+module.exports = require('./cjs/react-shallow-renderer.js');