.babelrc

@@ -1,6 +1,9 @@
 {
   "presets": ["airbnb"],
   "plugins": [
-    ["transform-replace-object-assign", "object.assign"],
+    ["transform-replace-object-assign", { "moduleSpecifier": "object.assign" }],
+  ],
+  ignore: [
+    "packages/enzyme-test-suite/test/_helpers/untranspiled*",
   ],
 }

.eslintrc

@@ -6,6 +6,7 @@
     "mocha": true
   },
   "rules": {
+    "react/jsx-one-expression-per-line": 0, // TODO: re-enable once fixed
     "id-length": 0,
     "new-cap": [2, { "capIsNewExceptions": ["AND"] }],
     "react/jsx-pascal-case": [2, { "allowAllCaps": true }],

.github/ISSUE_TEMPLATE.md

@@ -11,3 +11,34 @@ Before submitting, please read over our commonly reported issues to prevent dupl
 * [Cannot find module 'react-dom/lib/ReactTestUtils'](../blob/master/docs/common-issues.md#error-cannot-find-module-react-domlibreacttestutils)
 * [Query Selector fails](../blob/master/docs/common-issues.md#query-selector-fails)
 * [Testing third party libraries](../blob/master/docs/common-issues.md#testing-third-party-libraries)
+
+If you haven't found any duplicated issues, please report it with your environment!
+
+### Current behavior
+
+### Expected behavior
+
+### Your environment
+
+#### API
+
+- [ ] shallow
+- [ ] mount
+- [ ] render
+
+#### Version
+
+| library         | version
+| ---------------- | -------
+| Enzyme           | 
+| React            |  
+
+#### Adapter
+
+- [ ] enzyme-adapter-react-16
+- [ ] enzyme-adapter-react-15
+- [ ] enzyme-adapter-react-15.4
+- [ ] enzyme-adapter-react-14
+- [ ] enzyme-adapter-react-13
+- [ ] enzyme-adapter-react-helper
+- [ ] others ( ) 

.github/ISSUE_TEMPLATE/Bug_report.md

@@ -0,0 +1,35 @@
+---
+name: 🐛 Bug report
+about: Create a report to help us improve
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/Feature_request.md

@@ -0,0 +1,17 @@
+---
+name: 🙏 Feature request
+about: Suggest an idea for this project
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. e.g. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.gitignore

@@ -37,4 +37,13 @@ npm-shrinkwrap.json
 package-lock.json
 yarn.lock
 
+.DS_Store
+._.DS_Store
+
 packages/*/build/
+
+# Temporarily copied
+packages/*/LICENSE.md
+packages/enzyme/README.md
+packages/enzyme-adapter-react-*/README.md
+packages/enzyme-adapter-utils*/README.md

.travis.yml

@@ -1,5 +1,6 @@
 language: node_js
 node_js:
+  - "10"
   - "8"
   - "6"
   - "4"
@@ -45,8 +46,11 @@ matrix:
     - node_js: "6"
       env: KARMA=true REACT=16
 env:
-  - REACT=0.13
-  - REACT=0.14
-  - REACT=15.4
-  - REACT=15
   - REACT=16
+  - REACT=16.3
+  - REACT=16.2
+  - REACT=16.1
+  - REACT=15
+  - REACT=15.4
+  - REACT=0.14
+  - REACT=0.13

CHANGELOG.md

@@ -1,5 +1,65 @@
 # Change Log
 
+## 3.4.0
+
+### New Stuff
+
+- @madicap: `shallow`/`mount`: account for React.Fragment nodes ([#1733](https://github.com/airbnb/enzyme/pull/1733))
+- @jquense: Debug: `debugNode` now returns `[function]` for function children ([commit](https://github.com/airbnb/enzyme/commit/9745de0bf25e826186be07e7846f4ecd7c685592))
+- @ljharb: `mount`: add `hydrateIn` option ([#1707](https://github.com/airbnb/enzyme/pull/1707))
+- @ljharb: `shallow`: add “lifecycles” adapter option ([#1696](https://github.com/airbnb/enzyme/pull/1696))
+- @krawaller: `shallow`/`mount`: allow `.exists()` to take an optional selector ([#1695](https://github.com/airbnb/enzyme/pull/1695))
+- @koba04: `shallow`: Add getSnapshotBeforeUpdate support ([#1657](https://github.com/airbnb/enzyme/pull/1657))
+- @jquense: `shallow`/`mount`: Add support for some pseudo selectors ([#1537](https://github.com/airbnb/enzyme/pull/1537))
+- @blainekasten: `debug`: Implement verbose debug output ([#1547](https://github.com/airbnb/enzyme/pull/1547))
+- @jquense/@ljharb: `Debug`: `typeName` now calls the adapter’s `displayNameOfNode` if available ([#1701](https://github.com/airbnb/enzyme/pull/1701))
+- @jquense/@ljharb: `mount`/`shallow`: `.name()`: call into adapter’s `displayNameOfNode`, if present ([#1701](https://github.com/airbnb/enzyme/pull/1701))
+- @jquense/@ljharb: `Utils`: `nodeHasType`: call into adapter’s `displayNameOfNode`, if present ([#1701](https://github.com/airbnb/enzyme/pull/1701))
+- @jquense/@ljharb: `selectors`: `buildPredicate`: call into adapter’s `isValidElementType`, if present ([#1701](https://github.com/airbnb/enzyme/pull/1701))
+- @emuraton/@ljharb: `shallow`: `setProps()`: Add callback argument ([#1721](https://github.com/airbnb/enzyme/pull/1721))
+- @ljharb: `mount`: add `.equals()` ([commit](https://github.com/airbnb/enzyme/commit/dcc8ab10fde06a963364f6cc79b89aa967d9bef2))
+- @madicap: Extract `getAdapter` from `Utils` into its own file ([#1732](https://github.com/airbnb/enzyme/pull/1732))
+
+### Fixes
+
+- @ljharb: `shallow`/`mount`: `matchesElement`/`containsMatchingElement`: get adapter with options ([commit](https://github.com/airbnb/enzyme/commit/e954e4610d1ad89ae94b8f7c7baa8835cd331662))
+- @ljharb: `RSTTraversal`: remove `nodeHasProperty` export; broken since #1157 ([commit](https://github.com/airbnb/enzyme/commit/edabb1b6b4648fb6469da43feb1d15c1b55666f7))
+- @ljharb/@KordonDev: `shallow`: `.at()`: return an empty wrapper when an index does not exist ([#1478](https://github.com/airbnb/enzyme/pull/1478))
+- @ljharb: `shallow`: `.equals()`: flatten children when comparing ([commit](https://github.com/airbnb/enzyme/commit/18de4ed2e68c25f9fff9983d996b024704183801))
+- @ljharb: `mount`/`shallow`: do not dedupe in flatMap ([commit](https://github.com/airbnb/enzyme/commit/72341740e1e650b16ca2e377fa4e3e144b35a558))
+- @ljharb: `shallow`: `.closest()`: ensure an empty wrapper is returned for no match ([commit](https://github.com/airbnb/enzyme/commit/ce1e1132d080948265567e88417dface9c0c45e7))
+- @krawaller: `selectors`: make general sibling not throw on root ([#1698](https://github.com/airbnb/enzyme/pull/1698))
+- @ljharb/@angelikatyborska : `mount`: `text()`: null nodes return null ([#1582](https://github.com/airbnb/enzyme/pull/1582))
+- @ljharb: `shallow`: `simulate`: ensure it returns itself ([commit](https://github.com/airbnb/enzyme/commit/1c2c58b4e554f3b0c5f862f8de79f15a62bef5cf))
+- @koba04: `shallow`: ShallowWrapper calls update() automatically ([#1499](https://github.com/airbnb/enzyme/pull/1499))
+- @bdwain: `mount`/`shallow`: return null for missing keys ([#1536](https://github.com/airbnb/enzyme/pull/1536))
+- @vsiao: Fix ShallowWrapper for array-rendering components ([#1498](https://github.com/airbnb/enzyme/pull/1498))
+- @koba04: Call `setState` callback after finishing the render ([#1453](https://github.com/airbnb/enzyme/pull/1453))
+- @eddyerburgh: Convert nodes to RST nodes before comparing ([#1423](https://github.com/airbnb/enzyme/pull/1423))
+- @ljharb: improve "bad adapter" error message ([#1477](https://github.com/airbnb/enzyme/pull/1477))
+- @ljharb: `shallow`/`mount`: default iterator should be iterable ([commit](https://github.com/airbnb/enzyme/commit/cfc5a3e47efa812f7a2c4fa5ad2b0687daacd280))
+
+### Refactors
+
+- @ReactiveRaven: `selectors`: fix typos; avoid reusing variable unnecessarily ([#1681](https://github.com/airbnb/enzyme/pull/1681))
+- @koba04/@ljharb: `shallow`: Use `spyMethod` to inspect the result of `shouldComponentUpdate`/`getSnapshotBeforeUpdate` ([#1192](https://github.com/airbnb/enzyme/pull/1192))
+- @ljharb: `Utils`: `configuration`: change to named exports. ([commit](https://github.com/airbnb/enzyme/commit/d7f32617e6ea93b739f4e4c3f6228a8e382aeb06))
+- @ljharb: use `array.prototype.flat` ([commit](https://github.com/airbnb/enzyme/commit/e52a02ddac0fab0d1d93fd57d7f073f8bdc850bf))
+
+### Docs
+
+- @jack-lewin: Clarify dev workflow in CONTRIBUTING.md ([#1207](https://github.com/airbnb/enzyme/pull/1207))
+- @robrichard: Provide migration instructions for `ref(refName)` ([#1470](https://github.com/airbnb/enzyme/pull/1470))
+- @DannyDelott: `shallow`/`mount`: Add callback arg to setProps header ([#1361](https://github.com/airbnb/enzyme/pull/1361))
+- @conor-cafferkey-sociomantic: `mount`: Updated docs for ReactWrapper.instance(); remove docs for v2's `getNode()`/`getNodes()` ([#1714](https://github.com/airbnb/enzyme/pull/1714))
+- @koba04: Make clearer the docs for .mount() ([#1540](https://github.com/airbnb/enzyme/pull/1540))
+- @ialexryan: Update signature of .type() in shallow.md (#1492]([https://github.com/airbnb/enzyme/pull/1492))
+
+### Meta Stuff
+
+- @ljharb: ensure a license and readme is present in all packages when published
+- @ljharb: [meta] fix package.json scripts
+
 ## 3.3.0
 
 ### New Stuff

CONTRIBUTING.md

@@ -46,7 +46,12 @@ npm run react:16
 
 ### Running Tests
 
+The test suite runs on *built* Enzyme.
+
 ```bash
+# build Enzyme locally before testing
+npm run build
+
 # run tests on whatever version of React is currently installed
 npm test
 ```
@@ -56,7 +61,14 @@ npm test
 npm run test:all
 ```
 
+If you are actively developing, Enzyme will always need to be built with the latest changes.
+
+For this, the recommended workflow is to have the build and tests watching for changes in separate terminals. This should provide you with ~realtime feedback:
+
 ```bash
+# build Enzyme locally upon save
+npm run build:watch
+
 # faster feedback for TDD
 npm run test:watch
 ```
@@ -66,10 +78,15 @@ npm run test:watch
 This codebase adheres to the [Airbnb Styleguide](https://github.com/airbnb/javascript) and is
 enforced using [ESLint](http://eslint.org/).
 
-It is recommended that you install an eslint plugin for your editor of choice when working on this
+As with the test suite, the linter will not fully pass unless it is running on *built* Enzyme. This is because the ESLint `import/*` rules rely on finding the target files in the filesystem (which won't be there unless they've been built).
+
+It is recommended that you install an ESLint plugin for your editor of choice when working on this
 codebase, however you can always check to see if the source code is compliant by running:
 
 ```bash
+# build Enzyme locally before linting
+npm run build
+
 npm run lint
 ```
 

INTHEWILD.md

@@ -3,6 +3,7 @@ Please use [pull requests](https://github.com/airbnb/enzyme/pull/new/master) to
 Organizations
 ----------
  - [Airbnb](https://github.com/airbnb)
+ - [Cerner](https://github.com/cerner)
  - [OpenGov](https://github.com/opengov)
  - [Pinterest](https://github.com/pinterest)
  - [Product Hunt](https://github.com/producthunt)
@@ -24,6 +25,7 @@ Organizations
  - [Mavens](https://github.com/mavens)
  - [Cucumber](https://cucumber.io)
  - [Genoa Telepsychiatry](https://genoatelepsychiatry.com)
+ - [IBM X-Force Exchange](https://exchange.xforce.ibmcloud.com)
  - [Zendesk](https://zendesk.com/)
 
 Projects

README.md

@@ -30,7 +30,7 @@ npm i --save-dev enzyme enzyme-adapter-react-16
 ```
 
 Each adapter may have additional peer dependencies which you will need to install as well. For instance,
-`enzyme-adapter-react-16` has peer dependencies on `react`, `react-dom`, and `react-test-renderer`.
+`enzyme-adapter-react-16` has peer dependencies on `react` and `react-dom`.
 
 At the moment, Enzyme has adapters that provide compatibility with `React 16.x`, `React 15.x`,
 `React 0.14.x` and `React 0.13.x`.
@@ -40,7 +40,10 @@ React:
 
 | Enzyme Adapter Package | React semver compatibility |
 | --- | --- |
-| `enzyme-adapter-react-16` | `^16.0.0` |
+| `enzyme-adapter-react-16` | `^16.4.0-0` |
+| `enzyme-adapter-react-16.3` | `~16.3.0-0` |
+| `enzyme-adapter-react-16.2` | `~16.2` |
+| `enzyme-adapter-react-16.1` | `~16.0.0-0 || ~16.1` |
 | `enzyme-adapter-react-15` | `^15.5.0` |
 | `enzyme-adapter-react-15.4` | `15.0.0-0 - 15.4.x` |
 | `enzyme-adapter-react-14` | `^0.14.0` |
@@ -204,7 +207,7 @@ import Foo from './Foo';
 describe('<Foo />', () => {
   it('renders three `.foo-bar`s', () => {
     const wrapper = render(<Foo />);
-    expect(wrapper.find('.foo-bar').length).to.equal(3);
+    expect(wrapper.find('.foo-bar')).to.have.lengthOf(3);
   });
 
   it('renders the title', () => {

SUMMARY.md

@@ -42,6 +42,7 @@
     * [forEach(fn)](/docs/api/ShallowWrapper/forEach.md)
     * [get(index)](/docs/api/ShallowWrapper/get.md)
     * [hasClass(className)](/docs/api/ShallowWrapper/hasClass.md)
+    * [hostNodes()](/docs/api/ShallowWrapper/hostNodes.md)
     * [html()](/docs/api/ShallowWrapper/html.md)
     * [instance()](/docs/api/ShallowWrapper/instance.md)
     * [is(selector)](/docs/api/ShallowWrapper/is.md)
@@ -54,7 +55,7 @@
     * [not(selector)](/docs/api/ShallowWrapper/not.md)
     * [parent()](/docs/api/ShallowWrapper/parent.md)
     * [parents()](/docs/api/ShallowWrapper/parents.md)
-    * [prop([key])](/docs/api/ShallowWrapper/prop.md)
+    * [prop(key)](/docs/api/ShallowWrapper/prop.md)
     * [props()](/docs/api/ShallowWrapper/props.md)
     * [reduce(fn[, initialValue])](/docs/api/ShallowWrapper/reduce.md)
     * [reduceRight(fn[, initialValue])](/docs/api/ShallowWrapper/reduceRight.md)
@@ -96,6 +97,7 @@
     * [forEach(fn)](/docs/api/ReactWrapper/forEach.md)
     * [get(index)](/docs/api/ReactWrapper/get.md)
     * [hasClass(className)](/docs/api/ReactWrapper/hasClass.md)
+    * [hostNodes()](/docs/api/ReactWrapper/hostNodes.md)
     * [html()](/docs/api/ReactWrapper/html.md)
     * [instance()](/docs/api/ReactWrapper/instance.md)
     * [is(selector)](/docs/api/ReactWrapper/is.md)
@@ -109,7 +111,7 @@
     * [not(selector)](/docs/api/ReactWrapper/not.md)
     * [parent()](/docs/api/ReactWrapper/parent.md)
     * [parents()](/docs/api/ReactWrapper/parents.md)
-    * [prop([key])](/docs/api/ReactWrapper/prop.md)
+    * [prop(key)](/docs/api/ReactWrapper/prop.md)
     * [props()](/docs/api/ReactWrapper/props.md)
     * [reduce(fn[, initialValue])](/docs/api/ReactWrapper/reduce.md)
     * [reduceRight(fn[, initialValue])](/docs/api/ReactWrapper/reduceRight.md)

docs/api/ReactWrapper/contains.md

@@ -63,3 +63,4 @@ expect(wrapper.contains([
 when you are calling it you are calling it with a ReactElement or a JSX expression.
 - Keep in mind that this method determines equality based on the equality of the node's children as
 well.
+- Every attribute of the wrapped element must be matched by the element you're checking. To permit (and ignore) additional attributes on the wrapped element, use containsMatchingElement() instead.

docs/api/ReactWrapper/debug.md

@@ -1,9 +1,14 @@
-# `.debug() => String`
+# `.debug([options]) => String`
 
 Returns an HTML-like string of the wrapper for debugging purposes. Useful to print out to the
 console when tests are not passing when you expect them to.
 
 
+#### Arguments
+
+`options` (`Object` [optional]):
+- `options.ignoreProps`: (`Boolean` [optional]): Whether props should be omitted in the resulting string. Props are included by default.
+
 #### Returns
 
 `String`: The resulting string.
@@ -72,3 +77,18 @@ Would output the following to the console:
   </div>
 </Foo>
 ```
+and:
+```jsx
+console.log(mount(<Bar id="2" />).find(Foo).debug({ ignoreProps: true }));
+```
+Would output the following to the console:
+<!-- eslint-disable -->
+```jsx
+<Foo>
+  <div>
+    <span>
+      Foo
+    </span>
+  </div>
+</Foo>
+```