Add async check of the page should be compiled. This is needed for th…

…e API pages in particular.

lib/api-page.js

@@ -306,4 +306,8 @@ export default class ApiPage extends Page {
       commentsSourcePath: this.#apiFilePath,
     });
   }
+
+  async shouldCompile() {
+    return Boolean(await this.#parseApiFile());
+  }
 }

lib/collector.js

@@ -96,6 +96,14 @@ export default class Collector {
       AsyncIterable.filter((filePath) => !shouldIgnore(filePath)),
       AsyncIterable.map((filePath) => this.#tryCreatingPage(filePath, ApiPage)),
       AsyncIterable.filter(Boolean),
+      AsyncIterable.chain((page) =>
+        AsyncIterable.from(async function* () {
+          // We should be sure that the page has at least one comment.
+          if (await page.shouldCompile()) {
+            yield page;
+          }
+        }),
+      ),
     );
   }
 
@@ -118,6 +126,14 @@ export default class Collector {
         this.#tryCreatingPage(filePath, RegularPage, markdownCompiler),
       ),
       AsyncIterable.filter(Boolean),
+      AsyncIterable.chain((page) =>
+        AsyncIterable.from(async function* () {
+          // We should be sure that the page has at least one comment.
+          if (await page.shouldCompile()) {
+            yield page;
+          }
+        }),
+      ),
     );
   }
 
@@ -135,6 +151,14 @@ export default class Collector {
         this.#tryCreatingPage(filePath, LayoutPage),
       ),
       AsyncIterable.filter(Boolean),
+      AsyncIterable.chain((page) =>
+        AsyncIterable.from(async function* () {
+          // We should be sure that the page has at least one comment.
+          if (await page.shouldCompile()) {
+            yield page;
+          }
+        }),
+      ),
     );
   }
 

lib/page.js

@@ -132,4 +132,10 @@ export default class Page {
 
     await writeFile(this.#outputFilePath, compiledPage, "utf8");
   }
+
+  // Override this method if a page has to perform some checks
+  // after creation to be sure that it is legit.
+  async shouldCompile() {
+    return true;
+  }
 }