TODO

• update CHANGELOG

listRef prop of List component has lead to the problem described in #453 (and is a blocker for this PR to be merged).

Reasons to remove listRef

Proposed changes eliminate this prop from List API for the following reasons:

• ref cannot be applied in cases when ElementType is evaluated into React.SFC component (this is, actually, what tests were warn about)
• the assumption that it will be always a DOM node provided as a value to listRef expressed in these lines is wrong, as React ref may reference component instance (and will reference DOM element only for string components like ul, which luckily was the common case for List):

 /** Ref callback with the list DOM node. */	
listRef?: (node: HTMLElement) => void

How to cover cases where listRef was supposed to be used?

Cases that this listRef prop was aimed to cover now can be safely and easily covered with Ref component being exported from Stardust:

// client component code
render() {
  return (
    <Ref innerRef=(capturedListDomNode => this.listNode = capturedListDomNode)>
      <List ...>
    </Ref>
  )
}

No changes to the List API are necessary for that.