Preserve tokens for errors in DocParamBlock

Author: rbuckton

common/changes/@microsoft/tsdoc/flexibleParamParsing_2019-12-20-01-20.json

@@ -3,7 +3,7 @@
     {
       "packageName": "@microsoft/tsdoc",
       "comment": "Improve parse for param/typeParam",
-      "type": "patch"
+      "type": "minor"
     }
   ],
   "packageName": "@microsoft/tsdoc",

tsdoc/.npmrc

@@ -1,2 +1,3 @@
 registry=https://registry.npmjs.org/
 always-auth=false
+package-lock=false

tsdoc/.vscode/launch.json

@@ -18,7 +18,11 @@
       "request": "launch",
       "name": "Jest Current File",
       "program": "${workspaceFolder}/node_modules/jest/bin/jest",
-      "args": ["${relativeFile}"],
+      "args": [
+        "--runInBand",
+        "--testPathPattern",
+        "${fileBasename}"
+      ],
       "console": "integratedTerminal",
       "internalConsoleOptions": "neverOpen"
     }

tsdoc/src/__tests__/ParsingBasics.test.ts

@@ -134,3 +134,27 @@ test('05 Invalid JSDoc syntax in @param blocks', () => {
   ].join('\n'));
 });
 
+test('06 Invalid JSDoc optional name', () => {
+  TestHelpers.parseAndMatchDocCommentSnapshot([
+    '/**',
+    ' * Example 1',
+    ' *',
+    ' * @param [n - this is',
+    ' * the description',
+    ' *',
+    ' * @public',
+    ' */'
+  ].join('\n'));
+});
+
+test('07 Invalid JSDoc type', () => {
+  TestHelpers.parseAndMatchDocCommentSnapshot([
+    '/**',
+    ' * Example 1',
+    ' *',
+    ' * @param { test',
+    ' *',
+    ' * @public',
+    ' */'
+  ].join('\n'));
+});