fix: tag group

issue: #191

.gitignore

@@ -102,3 +102,5 @@ dist/
 
 # TernJS port file
 .tern-port
+
+.DS_STORE

src/parser.ts

@@ -8,7 +8,14 @@ import {
   findPluginByParser,
   isDefaultTag,
 } from "./utils";
-import { DESCRIPTION, PARAM, RETURNS, DEFAULT, DEFAULT_VALUE } from "./tags";
+import {
+  DESCRIPTION,
+  PARAM,
+  RETURNS,
+  DEFAULT,
+  DEFAULT_VALUE,
+  EXAMPLE,
+} from "./tags";
 import {
   TAGS_DESCRIPTION_NEEDED,
   TAGS_GROUP_HEAD,
@@ -28,7 +35,7 @@ const {
   name: nameTokenizer,
   tag: tagTokenizer,
   type: typeTokenizer,
-  description: descriptionTokenizer
+  description: descriptionTokenizer,
 } = tokenizers;
 
 /** @link https://prettier.io/docs/en/api.html#custom-parser-api} */
@@ -86,11 +93,11 @@ export const getParser = (originalParse: Parser["parse"], parserName: string) =>
               return spec;
             }
 
-            return typeTokenizer('preserve')(spec);
+            return typeTokenizer("preserve")(spec);
           },
           nameTokenizer(),
-          descriptionTokenizer('preserve')
-        ]
+          descriptionTokenizer("preserve"),
+        ],
       })[0];
 
       comment.value = "";
@@ -191,8 +198,8 @@ export const getParser = (originalParse: Parser["parse"], parserName: string) =>
           const prevTag = tags[index - 1];
           if (
             prevTag &&
-            !prevTag.description?.includes("\n") &&
             prevTag.tag !== DESCRIPTION &&
+            prevTag.tag !== EXAMPLE &&
             prevTag.tag !== SPACE_TAG_DATA.tag &&
             tag.tag !== SPACE_TAG_DATA.tag &&
             prevTag.tag !== tag.tag
@@ -562,18 +569,20 @@ function assignOptionalAndDefaultToName({
   description,
   ...rest
 }: Spec): Spec {
-
   if (isDefaultTag(tag)) {
-    const usefulSourceLine = source.find(x => x.source.includes(`@${tag}`))?.source || ''
+    const usefulSourceLine =
+      source.find((x) => x.source.includes(`@${tag}`))?.source || "";
 
-    const tagMatch = usefulSourceLine.match(/@default(Value)? (\[.*]|{.*}|\(.*\)|'.*'|".*"|`.*`|[A-z0-9_]+)( (.+))?/)
-    const tagValue = tagMatch?.[2] || ''
-    const tagDescription = tagMatch?.[4] || ''
+    const tagMatch = usefulSourceLine.match(
+      /@default(Value)? (\[.*]|{.*}|\(.*\)|'.*'|".*"|`.*`|[A-z0-9_]+)( (.+))?/,
+    );
+    const tagValue = tagMatch?.[2] || "";
+    const tagDescription = tagMatch?.[4] || "";
 
     if (tagMatch) {
-      type = tagValue
-      name = ''
-      description = tagDescription
+      type = tagValue;
+      name = "";
+      description = tagDescription;
     }
   } else if (optional) {
     if (name) {

tests/__snapshots__/files/prism-dependencies.js.shot

@@ -367,6 +367,7 @@ var getLoader = (function () {
 	 *
 	 *   If a component is in this list, then all of its requirements will also be assumed to be in the list. Default is
 	 *   \`[]\`
+	 *
 	 * @returns {Loader}
 	 *
 	 *

tests/__snapshots__/tagGroup.test.ts.snap

@@ -0,0 +1,25 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`Tag group 1`] = `
+"/**
+ * Aliquip ex proident tempor eiusmod aliquip amet. Labore commodo nulla
+ * tempor consequat exercitation incididunt non. Duis laboris reprehenderit
+ * proident proident.
+ *
+ * @example
+ *   const foo = 0;
+ *   const a = \\"\\";
+ *   const b = \\"\\";
+ *
+ * @param id A test id.
+ *
+ * @returns Minim sit a.
+ *
+ * @throws Minim sit ad commodo ut dolore magna magna minim consequat. Ex
+ *   consequat esse incididunt qui voluptate id voluptate quis ex et. Ullamco
+ *   cillum nisi amet fugiat.
+ *
+ * @see {@link http://acme.com}
+ */
+"
+`;

tests/tagGroup.test.ts

@@ -0,0 +1,38 @@
+import prettier from "prettier";
+import { AllOptions } from "../src/types";
+
+function subject(code: string, options: Partial<AllOptions> = {}) {
+  return prettier.format(code, {
+    plugins: ["."],
+    ...options,
+  } as AllOptions);
+}
+
+test("Tag group", () => {
+  const result = subject(
+    `
+  /**
+   * Aliquip ex proident tempor eiusmod aliquip amet. Labore commodo nulla tempor
+   * consequat exercitation incididunt non. Duis laboris reprehenderit proident
+   * proident.
+   * @see {@link http://acme.com}
+   * @example
+   *   const foo = 0;
+   *   const a = "";
+   *   const b = "";
+   *
+   * @param id A test id.
+   * @throws Minim sit ad commodo ut dolore magna magna minim consequat. Ex
+   *   consequat esse incididunt qui voluptate id voluptate quis ex et. Ullamco
+   *   cillum nisi amet fugiat.
+   * @return Minim sit a.
+   */
+  
+`,
+    {
+      jsdocSeparateTagGroups: true,
+    },
+  );
+
+  expect(result).toMatchSnapshot();
+});