fix(require-description-complete-sentence); avoid treating line breaks preceding colon/semi-colon as new paragraph; fixes #390

Author: brettz9

.README/rules/require-description-complete-sentence.md

@@ -8,6 +8,8 @@ tag descriptions are written in complete sentences, i.e.,
 * Sentences must end with a period.
 * Every line in a paragraph (except the first) which starts with an uppercase
   character must be preceded by a line ending with a period.
+* A colon or semi-colon followed by two line breaks is still part of the
+  containing paragraph (unlike normal dual line breaks).
 
 #### Options
 

README.md

@@ -3834,6 +3834,8 @@ tag descriptions are written in complete sentences, i.e.,
 * Sentences must end with a period.
 * Every line in a paragraph (except the first) which starts with an uppercase
   character must be preceded by a line ending with a period.
+* A colon or semi-colon followed by two line breaks is still part of the
+  containing paragraph (unlike normal dual line breaks).
 
 <a name="eslint-plugin-jsdoc-rules-require-description-complete-sentence-options-7"></a>
 #### Options
@@ -4280,6 +4282,13 @@ function quux (foo) {
 
 }
 // Settings: {"jsdoc":{"tagNamePreference":{"description":false}}}
+
+/**
+* We stop loading Items when we have loaded:
+*
+* 1) The main Item;
+* 2) All its variants.
+*/
 ````
 
 

src/rules/requireDescriptionCompleteSentence.js

@@ -3,7 +3,11 @@ import {RegExtras} from 'regextras/dist/main-umd';
 import iterateJsdoc from '../iterateJsdoc';
 
 const extractParagraphs = (text) => {
-  return text.split(/\n\n/);
+  // Todo [engine:node@>8.11.0]: Uncomment following line with neg. lookbehind instead
+  // return text.split(/(?<![;:])\n\n/);
+  return [...text].reverse().join('').split(/\n\n(?![;:])/).map((par) => {
+    return [...par].reverse().join('');
+  }).reverse();
 };
 
 const extractSentences = (text) => {

test/rules/assertions/requireDescriptionCompleteSentence.js

@@ -887,5 +887,15 @@ export default {
         },
       },
     },
+    {
+      code: `
+      /**
+      * We stop loading Items when we have loaded:
+      *
+      * 1) The main Item;
+      * 2) All its variants.
+      */
+`,
+    },
   ],
 };