Merge pull request #283 from handsontable/fix/e2e-docs-bucket-suggestion-not-hardcoded

fix(runner): stop hard-coding the suggested docs bucket in the e2e spec

Author: demtario

runner/e2e/docs-examples.spec.ts

@@ -1,4 +1,6 @@
 import { test, expect } from "@playwright/test";
+import { highestReleaseBucket } from "../packages/runtime/src/docs-bucket.js";
+import { readFileSync } from "node:fs";
 
 // End-to-end tests for the docs-example playground UI. Deterministic tests do
 // not depend on the external Sandpack bundler; the live-render test does and is
@@ -7,6 +9,16 @@ import { test, expect } from "@playwright/test";
 const REACT_EXAMPLE = "/?docs=guides/columns/column-adding/react/example2.tsx";
 const DOCS_PATH = "guides/columns/column-adding/react/example2.tsx";
 const NEXT_VERSION = "19.0.0-next.1";
+// The bucket DEMOS-1C suggests to a visitor on an absent version: whatever the
+// generated index holds, resolved with the app's own helper rather than restated
+// here. `docs-buckets.json` is regenerated by every docs import, so a hard-coded
+// minor goes stale the next time one lands (18.0 -> 18.1 is what broke it).
+const DOCS_BUCKETS: string[] = JSON.parse(
+  readFileSync(new URL("../docs-buckets.json", import.meta.url), "utf8"),
+).buckets;
+const SUGGESTED_BUCKET = highestReleaseBucket(DOCS_BUCKETS);
+if (!SUGGESTED_BUCKET) throw new Error("docs-buckets.json holds no release bucket to suggest");
+const SUGGESTION = new RegExp(`available for Handsontable ${SUGGESTED_BUCKET.replace(".", "\\.")}`);
 
 const FRAMEWORKS = [
   ["react", "React", "tsx"],
@@ -472,9 +484,13 @@ test("an open docs example with no target bucket stops preview and remains recov
 
   // DEMOS-1C: the visitor is told which version has docs examples, not left
   // at a dead end that names none. Discriminating against pre-fix code, whose
-  // literal message named only the selected version and never "18.0".
+  // literal message named only the selected version and never the suggestion.
   await expect(
-    page.getByText(/No documentation examples are available for Handsontable 17\.1\.0.*available for Handsontable 18\.0/).first(),
+    page
+      .getByText(
+        new RegExp(`No documentation examples are available for Handsontable 17\\.1\\.0.*${SUGGESTION.source}`),
+      )
+      .first(),
   ).toBeVisible();
   await expect(page.locator("section[aria-label='Preview'] iframe")).toHaveAttribute("src", "about:blank");
   await page.getByRole("button", { name: /React/ }).first().click();
@@ -541,7 +557,7 @@ test("a deep link into a bucket-less version shows not-found, not a retry prompt
   // DEMOS-1C: the deep-link dead end (§2.5's genuinely user-visible harm) used
   // to name no version at all ("This example may not be imported yet.").
   // Discriminating: this text never appears against pre-fix code.
-  await expect(page.getByText(/available for Handsontable 18\.0/)).toBeVisible();
+  await expect(page.getByText(SUGGESTION)).toBeVisible();
 });
 
 test("a deep link whose manifest row has no artifact shows not-found", async ({ page }) => {