I have a component with types and jsdocs:

export type ButtonProps = {
  /**
   * explicitly toggle loader on and off
   */
  loading?: boolean;
} & React.ButtonHTMLAttributes<HTMLButtonElement>;

/**
 * Base button, with very basic styles. Accepts all parameters of native html button.
 * If onClick returns a promise, BaseButton will show a loader automatically, until the promise is resolved or rejected.
 */
export default class Button extends Component<ButtonProps> {
  render() {
    const { loading, ...rest } = this.props;

    const content = loading ? loader : children;

    return <button {...rest}>{content}</button>;
  }
}

I get these docs:

┌────────────────────┬──────────────────────────────────────────────────┐
  │ Name               │ Button                                           │
  ├────────────────────┼──────────────────────────────────────────────────┤
  │ Description        │ Base button, with very basic styles. Accepts all │
  │                    │ parameters of native html button.                │
  │                    │ If onClick returns a promise, BaseButton will    │
  │                    │ show a loader automatically, until the promise   │
  │                    │ is resolved or rejected.                         │
  ├────────────────────┼──────────────────────────────────────────────────┤
  │ Properties         │ (loader: ReactNode, loading: boolean)            │
  └────────────────────┴──────────────────────────────────────────────────┘

When I change the type to be an interface, Bit no longer identifies the props as a type:

export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
	/**
	 * explicitly toggle loader on and off
	 */
	loading?: boolean;
};

┌────────────────────┬──────────────────────────────────────────────────┐
  │ Name               │                                                  │
  ├────────────────────┼──────────────────────────────────────────────────┤
  │ Description        │ explicitly toggle loader on and off              │
  └────────────────────┴──────────────────────────────────────────────────┘
  ┌────────────────────┬──────────────────────────────────────────────────┐
  │ Name               │                                                  │
  ├────────────────────┼──────────────────────────────────────────────────┤
  │ Description        │ Base button, with very basic styles. Accepts all │
  │                    │ parameters of native html button.                │
  │                    │ If onClick returns a promise, BaseButton will    │
  │                    │ show a loader automatically, until the promise   │
  │                    │ is resolved or rejected.                         │
  └────────────────────┴──────────────────────────────────────────────────┘

Please support interface syntax in automatic docs. 😃

Specifications

bit version: 14.7.6