react.forwardRef support (requires react >=16.8.3) (#6)

Author: natterstefan

CHANGES.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented here. The format is based
 on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) and this project
 adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## Unreleased
+
+### Added
+
+- *Breaking*: `ref` support, thanks to [`React.forwardRef`](https://reactjs.org/docs/forwarding-refs.html)
+
 ## 2019/03/28 0.6.1
 
 ### Changed

README.md

@@ -12,17 +12,30 @@ React components dynamically based on the requested client-package.
 
 ## Getting started
 
-```bash
+```sh
 npm i react-component-catalog --save
+
+# or
+yarn add react-component-catalog
 ```
 
-## Basic Usage
+Then install the correct versions of each peerDependency package, which are
+listed by the command:
+
+```sh
+npm info "react-component-catalog@latest" peerDependencies
+```
+
+If using npm 5+, use this shortcut:
+
+```sh
+npx install-peerdeps --dev react-component-catalog
 
-### Requirements
+# or
+yarn add react-component-catalog -D --peer
+```
 
-As this package depends on [`react-hooks`](https://reactjs.org/docs/hooks-overview.html),
-`"react": "^16.8.0"` and `"react-dom": "^16.8.0"` are required (see
-`peerDependencies` in [package.json](./package.json)).
+## Basic Usage
 
 ### First register the components
 
@@ -134,6 +147,39 @@ const App = () => {
 export default App
 ```
 
+### Use catalog with `ref`
+
+> Refs provide a way to access DOM nodes or React elements created in the render
+method. ([Source: reactjs.org](https://reactjs.org/docs/refs-and-the-dom.html))
+
+It is possible to use `react-component-catalog` with `ref` as well. It would
+look similar to (works also with `<CatalogComponent />`):
+
+```js
+const TestComponent = withCatalog(props => (
+  <button {...props} type="button">
+    Hello Button
+  </button>
+))
+
+/* eslint-disable react/no-multi-comp */
+class App extends React.Component {
+  constructor(props) {
+    super(props)
+    this.setRef = React.createRef()
+  }
+
+  render() {
+    // or <CatalogComponent component="TestComponent" ref={this.setRef} />
+    return (
+      <CatalogProvider catalog={new Catalog({ components: { TestComponent } })}>
+        <TestComponent ref={this.setRef} />
+      </CatalogProvider>
+    )
+  }
+}
+```
+
 ## How to build and test this package
 
 ```sh

jest.setup.js

@@ -1,3 +1,4 @@
+/* eslint-disable import/no-extraneous-dependencies */
 import { configure } from 'enzyme'
 import Adapter from 'enzyme-adapter-react-16'