move to index.ts to keep texts as intact as possible

Author: saschanaz

package-lock.json

@@ -18,7 +18,7 @@
     "jsdom": "^11.11.0",
     "node-fetch": "^2.1.1",
     "print-diff": "^0.1.1",
-    "styleless-innertext": "^1.1.0",
+    "styleless-innertext": "^1.1.2",
     "typescript": "next",
     "webidl2": "^13.0.2"
   }

package.json

@@ -137,10 +137,7 @@ function getCommentText(text: string) {
         .replace(/’/g, "'")
         .split("\n")
         .filter(line => !!line)
-        .join("\n")
-        // Filters out phrases for nested comments as we retargets them:
-        // "This operation receives a dictionary, which has these members:"
-        .replace(/[,.][^,.]+:/g, ".");
+        .join("\n");
 }
 
 function* generateDescriptionPairs(domIntro: Element) {

src/idlfetcher.ts

@@ -32,7 +32,7 @@ function emitDom() {
 
     // ${name} will be substituted with the name of an interface
     const removeVerboseIntroductions: [RegExp, string][] = [
-        [/^(The|A) ${name} interface of (the\s*)*([a-z\s]+ API)(\\\'s)?/, 'An interface of the $3 '],
+        [/^(The|A) ${name} interface of (the\s*)*([a-z\d\s]+ API)(\\\'s)?/, 'An interface of the $3 '],
         [/^(The|A) ${name} (interface|event|object) (is|represents|describes|defines)?/, ''],
         [/^An object implementing the ${name} interface (is|represents|describes|defines)/, ''],
         [/^The ${name} is an interface representing/, ''],
@@ -62,6 +62,7 @@ function emitDom() {
         const idl: string = fs.readFileSync(path.join(inputFolder, "idl", filename), { encoding: "utf-8" });
         const commentsMapFilePath = path.join(inputFolder, "idl", title + ".commentmap.json");
         const commentsMap: Record<string, string> = fs.existsSync(commentsMapFilePath) ? require(commentsMapFilePath) : {};
+        commentCleanup(commentsMap)
         const result = convert(idl, commentsMap);
         if (deprecated) {
             mapToArray(result.browser.interfaces!.interface).forEach(markAsDeprecated);
@@ -70,6 +71,14 @@ function emitDom() {
         return result;
     }
 
+    function commentCleanup(commentsMap: Record<string, string>) {
+        for (const key in commentsMap) {
+            // Filters out phrases for nested comments as we retargets them:
+            // "This operation receives a dictionary, which has these members:"
+            commentsMap[key] = commentsMap[key].replace(/[,.][^,.]+:$/g, ".");
+        }
+    }
+
     function apiDescriptionsToIdl(descriptions: Record<string, string>) {
         const idl: Browser.WebIdl = {
             interfaces: {