Better support for custom types

This is more of a “would you be willing to accept a pull request which does this?” question than an issue of sorts. 😃

I would really like to extend the functionality of “custom” types so that:

1. We support destructured imports (Eg. PropTypes.array - note the lack of React.)
2. We allow common react-esque prop type function patterns to be picked up with custom props in the same way that arrayOf is currently handled. (Eg. PropTypes.iterableOf(PropTypes.record(User)))

Basically I feel the library should be able to support custom user prop types in such a way we don’t have to reparse the raw value which would mean anyone can easily implement simple custom prop types and create documentation from that.

Custom prop types are super useful in building a real-world app with React and so I would like to see how we can help developers document these too.

We, at Lystable, want to build an open living component docs solution and are hoping react-docgen can feature at the core!

[chrisui]

To clarify here are a few examples:

Ex 1. Firstly the destructuring pattern should be supported.

static propTypes = {
  prop: PropTypes.string
}

// yields {type: {name: 'string'}}

Ex 2. With the above the [x].isRequired would be a common pattern we can extract.

static propTypes = {
  prop: PropTypes.string.isRequired
}

// yields {type: {name: 'string'}, required: true}

Ex 3. Custom function prop-types should be supported.

static propTypes = {
  prop: PropTypes.record(User)
}

// yields {type: {name: 'record', value: 'User'}}

Ex 4. Again, .isRequired pattern should be honoured.

static propTypes = {
  prop: PropTypes.record(User).isRequired
}

// yields {type: {name: 'record', value: 'User'}, isRequired: true}

Ex 5. Function pattern will support nested types.

static propTypes = {
  prop: PropTypes.iterableOf(PropTypes.record(User))
}

// yields {type: {name: 'iterableOf', value: {name: 'record', value: 'User'}}}

Ex 6. To confirm, these custom props can be used deeply.

static propTypes = {
  prop: PropTypes.iterableOf(PropTypes.oneOf([PropTypes.record(User), PropTypes.bool])
}

// yields {type: {name: 'iterableOf', value: {name: 'enum', values: [{name: 'record', value: 'User'}, ...]}}}

Notes/thoughts:

• Custom enum syntax is not needed as standard oneOf covers any possible usage of this.
• .raw should still be present on the type object
• This output implements a breaking change now that name: 'custom' has gone.
  • Can’t see this as being an issue as .raw still exists and consumers can still do the same stuff
  • If this is an issue we could just have a new .customName property.

[levithomason]

Ditto. I’m also wondering if this may actually become a plugin in light of #115.