fix(ngdoc): replace logic of custom parse tags by signature with ts t…

…ag infos array #469 (#471)

packages/a-lib/dialog/index.ts

@@ -1,2 +1,3 @@
 export * from './dialog.module';
 export * from './dialog.service';
+export * from './my-http-interceptor';

packages/a-lib/dialog/my-http-interceptor.ts

@@ -0,0 +1,10 @@
+import { HttpEvent, HttpHandler, HttpInterceptor, HttpRequest } from '@angular/common/http';
+import { Injectable } from '@angular/core';
+import { Observable, of } from 'rxjs';
+
+@Injectable()
+export class MyHttpInterceptor implements HttpInterceptor {
+    intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {
+        return of(null);
+    }
+}

packages/ngdoc/src/ng-parser.spec.ts

@@ -493,6 +493,56 @@ describe('ng-parser', () => {
                 }
             ] as NgMethodDoc[]);
         });
+
+        it('should generate service api when implements interface and param contains newline', () => {
+            const sourceText = `
+
+            interface HttpInterceptor {
+                /**
+                 * Identifies and handles a given HTTP request.
+                 * @param req The outgoing request object to handle.
+                 * @param next The next interceptor in the chain, or the backend
+                 * if no interceptors remain in the chain.
+                 * @returns An observable of the event stream.
+                 */
+                intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>>;
+            }
+
+            @Injectable()
+            export class MyHttpInterceptor implements HttpInterceptor {
+                intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {
+                    return of(null);
+                }
+            }
+            `;
+            const { ngDocParser } = createTestNgDocParser('dialog', {
+                '/dialog/dialog.service.ts': sourceText
+            });
+            const docs = ngDocParser.parse('/dialog/*');
+
+            expect(docs[0].methods).toEqual([
+                {
+                    name: 'intercept',
+                    parameters: [
+                        {
+                            name: 'req',
+                            description: '',
+                            type: 'HttpRequest<any>'
+                        },
+                        {
+                            name: 'next',
+                            description: '',
+                            type: 'HttpHandler'
+                        }
+                    ],
+                    returnValue: {
+                        type: 'Observable<HttpEvent<any>>',
+                        description: ''
+                    },
+                    description: 'Identifies and handles a given HTTP request.'
+                }
+            ]);
+        });
     });
 
     describe('interface', () => {

packages/ngdoc/src/parser/utils.ts

@@ -249,17 +249,18 @@ export function getDocTagsBySignature(symbol: ts.Signature): MethodDocTagResult
         if (item.name !== 'param') {
             result[item.name] = item;
         } else {
-            let paramName: string;
-            let paramText: string;
-            const regexpResult = (ts.displayPartsToString(item.text) || '').match(/(^\S+)\s?(.*)$/);
-            if (regexpResult) {
-                paramText = regexpResult[2] || '';
-                paramName = regexpResult[1];
+            result[item.name] = result[item.name] || {};
+            if (item.text && item.text?.length > 0) {
+                const paramName = item.text[0].kind === 'parameterName' ? item.text[0].text : '';
+                const paramText = item.text.length > 2 ? item.text[2].text : '';
+
+                result[item.name][paramName] = {
+                    name: paramName,
+                    text: paramText
+                };
             } else {
-                throw new Error(`[${item.name}-${item.text}]param comment format error`);
+                throw new Error(`[${item.name}] param comment format error`);
             }
-            result[item.name] = result[item.name] || {};
-            result[item.name][paramName] = { ...item, text: paramText };
         }
         return result;
     }, {});