feat(Ref): add component

index.d.ts

@@ -7,6 +7,7 @@ export {
 export { default as Confirm, ConfirmProps } from './dist/commonjs/addons/Confirm';
 export { default as Portal, PortalProps } from './dist/commonjs/addons/Portal';
 export { default as Radio, RadioProps } from './dist/commonjs/addons/Radio';
+export { default as Ref, RefProps } from './dist/commonjs/addons/Ref';
 export { default as Select, SelectProps } from './dist/commonjs/addons/Select';
 export { default as TextArea, TextAreaProps } from './dist/commonjs/addons/TextArea';
 

src/addons/Ref/Ref.d.ts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+
+export interface RefProps {
+  [key: string]: any;
+
+  /** Primary content. */
+  children?: React.ReactNode;
+
+  /**
+   * Called when componentDidMount.
+   *
+   * @param {HTMLElement} node - Referred node.
+   */
+  innerRef?: (node: HTMLElement) => void;
+}
+
+declare class Ref extends React.Component<RefProps, {}> {
+}
+
+export default Ref;

src/addons/Ref/Ref.js

@@ -0,0 +1,43 @@
+import PropTypes from 'prop-types'
+import { Children, Component } from 'react'
+import { findDOMNode } from 'react-dom'
+
+import { TYPES } from '../../lib/META'
+
+/**
+ * This component exposes a callback prop that always returns the DOM node of both functional and class component
+ * children.
+ */
+export default class Ref extends Component {
+  static propTypes = {
+    /** Primary content. */
+    children: PropTypes.element,
+
+    /**
+     * Called when componentDidMount.
+     *
+     * @param {HTMLElement} node - Referred node.
+     */
+    innerRef: PropTypes.func,
+  }
+
+  static _meta = {
+    name: 'Ref',
+    type: TYPES.ADDON,
+  }
+
+  componentDidMount() {
+    const { innerRef } = this.props
+
+    // Heads up! Don't move this condition, it's a short circle that avoids run of `findDOMNode`
+    // if `innerRef` isn't passed
+    // eslint-disable-next-line react/no-find-dom-node
+    if (innerRef) innerRef(findDOMNode(this))
+  }
+
+  render() {
+    const { children } = this.props
+
+    return Children.only(children)
+  }
+}

src/addons/Ref/index.d.ts

@@ -0,0 +1 @@
+export { default, RefProps } from './Ref';

src/addons/Ref/index.js

@@ -0,0 +1 @@
+export default from './Ref'

src/index.js

@@ -3,6 +3,7 @@ export { default as Responsive } from './addons/Responsive'
 export { default as Confirm } from './addons/Confirm'
 export { default as Portal } from './addons/Portal'
 export { default as Radio } from './addons/Radio'
+export { default as Ref } from './addons/Ref'
 export { default as Select } from './addons/Select'
 export { default as TextArea } from './addons/TextArea'
 

test/specs/addons/Ref/Ref-test.js

@@ -0,0 +1,64 @@
+import faker from 'faker'
+import React from 'react'
+
+import Ref from 'src/addons/Ref/Ref'
+import * as common from 'test/specs/commonTests'
+import { sandbox } from 'test/utils'
+import { CompositeClass, CompositeFunction, DOMClass, DOMFunction } from './fixtures'
+
+const mountNode = (Component, innerRef) => (
+  mount(
+    <Ref innerRef={innerRef}>
+      <Component />
+    </Ref>,
+  )
+    .find('#node')
+    .getDOMNode()
+)
+
+describe('Ref', () => {
+  common.hasValidTypings(Ref)
+
+  describe('children', () => {
+    it('renders single child', () => {
+      const child = <div data-child={faker.hacker.noun()} />
+
+      shallow(<Ref>{child}</Ref>)
+        .should.contain(child)
+    })
+  })
+
+  describe('innerRef', () => {
+    it('returns node from a functional component with DOM node', () => {
+      const innerRef = sandbox.spy()
+      const node = mountNode(DOMFunction, innerRef)
+
+      innerRef.should.have.been.calledOnce()
+      innerRef.should.have.been.calledWithMatch(node)
+    })
+
+    it('returns node from a functional component', () => {
+      const innerRef = sandbox.spy()
+      const node = mountNode(CompositeFunction, innerRef)
+
+      innerRef.should.have.been.calledOnce()
+      innerRef.should.have.been.calledWithMatch(node)
+    })
+
+    it('returns node from a class component with DOM node', () => {
+      const innerRef = sandbox.spy()
+      const node = mountNode(DOMClass, innerRef)
+
+      innerRef.should.have.been.calledOnce()
+      innerRef.should.have.been.calledWithMatch(node)
+    })
+
+    it('returns node from a class component', () => {
+      const innerRef = sandbox.spy()
+      const node = mountNode(CompositeClass, innerRef)
+
+      innerRef.should.have.been.calledOnce()
+      innerRef.should.have.been.calledWithMatch(node)
+    })
+  })
+})

test/specs/addons/Ref/fixtures.js

@@ -0,0 +1,19 @@
+/* eslint-disable react/no-multi-comp */
+/* eslint-disable react/prefer-stateless-function */
+import React, { Component } from 'react'
+
+export const DOMFunction = props => <div {...props} id='node' />
+
+export const CompositeFunction = props => <DOMFunction {...props} />
+
+export class DOMClass extends Component {
+  render() {
+    return <div {...this.props} id='node' />
+  }
+}
+
+export class CompositeClass extends Component {
+  render() {
+    return <DOMClass {...this.props} />
+  }
+}