feat: add support for @DefaultValue TSDoc tag

src/__tests__/data/StatelessWithDefaultValueAndDescriptionJsDoc.tsx

@@ -0,0 +1,14 @@
+import * as React from 'react';
+
+export interface StatelessWithDefaultValueAndDescriptionJsDocProps {
+  /**
+   * The content
+   *
+   * @defaultValue hello
+   */
+  myProp: string;
+}
+/** StatelessWithDefaultValueAndDescriptionJsDoc description */
+export const StatelessWithDefaultValueAndDescriptionJsDoc: React.StatelessComponent<StatelessWithDefaultValueAndDescriptionJsDocProps> = props => (
+  <div>My Property = {props.myProp}</div>
+);

src/__tests__/data/StatelessWithDefaultValueOnlyJsDoc.tsx

@@ -0,0 +1,12 @@
+import * as React from 'react';
+
+export interface StatelessWithDefaultValueOnlyJsDocProps {
+  /**
+   * @defaultValue hello
+   */
+  myProp: string;
+}
+/** StatelessWithDefaultValueOnlyJsDoc description */
+export const StatelessWithDefaultValueOnlyJsDoc: React.StatelessComponent<StatelessWithDefaultValueOnlyJsDocProps> = props => (
+  <div>My Property = {props.myProp}</div>
+);

src/__tests__/parser.ts

@@ -747,6 +747,26 @@ describe('parser', () => {
     });
   });
 
+  it('should parse jsdocs with the @defaultValue tag and no description', () => {
+    check('StatelessWithDefaultValueOnlyJsDoc', {
+      StatelessWithDefaultValueOnlyJsDoc: {
+        myProp: { defaultValue: 'hello', description: '', type: 'string' }
+      }
+    });
+  });
+
+  it('should parse jsdocs with the @defaultValue tag and description', () => {
+    check('StatelessWithDefaultValueAndDescriptionJsDoc', {
+      StatelessWithDefaultValueAndDescriptionJsDoc: {
+        myProp: {
+          defaultValue: 'hello',
+          description: 'The content',
+          type: 'string'
+        }
+      }
+    });
+  });
+
   it('should parse functional component component defined as function', () => {
     check('FunctionDeclaration', {
       Jumbotron: {

src/parser.ts

@@ -704,6 +704,8 @@ export class Parser {
 
       if (hasCodeBasedDefault) {
         defaultValue = { value: defaultProps[propName] };
+      } else if (jsDocComment.tags.defaultValue) {
+        defaultValue = { value: jsDocComment.tags.defaultValue };
       } else if (jsDocComment.tags.default) {
         defaultValue = { value: jsDocComment.tags.default };
       }
@@ -751,7 +753,11 @@ export class Parser {
 
   public findDocComment(symbol: ts.Symbol): JSDoc {
     const comment = this.getFullJsDocComment(symbol);
-    if (comment.fullComment || comment.tags.default) {
+    if (
+      comment.fullComment ||
+      comment.tags.default ||
+      comment.tags.defaultValue
+    ) {
       return comment;
     }
 
@@ -799,7 +805,7 @@ export class Parser {
         ? currentValue + '\n' + trimmedText
         : trimmedText;
 
-      if (['default', 'type'].indexOf(tag.name) < 0) {
+      if (['default', 'type', 'defaultValue'].indexOf(tag.name) < 0) {
         tagComments.push(formatTag(tag));
       }
     });