Generalize TocGrouping.test.ts for future Qiskit versions (Qiskit#1383)

Closes Qiskit#1341.

scripts/lib/api/TocGrouping.test.ts

@@ -10,9 +10,9 @@
 // copyright notice, and modified files need to carry a notice indicating
 // that they have been altered from the originals.
 
-import { readFile } from "fs/promises";
+import { readFile, readdir } from "fs/promises";
 
-import { expect, test } from "@jest/globals";
+import { expect, describe, test } from "@jest/globals";
 
 import { QISKIT_TOC_GROUPING } from "./TocGrouping";
 import type { TocEntry } from "./generateToc";
@@ -121,13 +121,38 @@ async function getTocModuleGroups(fp: string): Promise<ModuleGroup[]> {
   return result;
 }
 
-test("Qiskit ToC mirrors index page sections", async () => {
-  validateTopLevelModuleAssumptions();
+async function checkFolder(dirName: string): Promise<void> {
   const indexModuleGroups = await getIndexModuleGroups(
-    "docs/api/qiskit/dev/index.mdx",
+    `docs/api/qiskit${dirName}/index.mdx`,
   );
   const tocModuleGroups = await getTocModuleGroups(
-    "docs/api/qiskit/dev/_toc.json",
+    `docs/api/qiskit${dirName}/_toc.json`,
   );
   expect(indexModuleGroups).toEqual(tocModuleGroups);
+}
+
+describe("Qiskit ToC mirrors index page sections", () => {
+  test("validate assumptions", () => {
+    validateTopLevelModuleAssumptions();
+  });
+
+  test("dev", async () => {
+    await checkFolder("/dev");
+  });
+
+  test.failing("latest", async () => {
+    await checkFolder("");
+  });
+
+  test("historical releases (1.1+)", async () => {
+    const folders = (
+      await readdir("docs/api/qiskit", { withFileTypes: true })
+    ).filter(
+      (file) =>
+        file.isDirectory() && file.name.match(/[0-9].*/) && +file.name >= 1.1,
+    );
+    for (const folder of folders) {
+      await checkFolder(`/${folder.name}`);
+    }
+  });
 });