web: cells name the newest supported version when the newest one is not usable

Author: rigor789

shared/compute.ts

@@ -291,6 +291,8 @@ export interface CellSummary {
 	latest?: { version: string; cell: Cell };
 	/** A prerelease toolchain newer than `latest`, when one is known. */
 	prerelease?: { version: string; cell: Cell };
+	/** When `latest` is not usable: the newest stable version that is verified or declared. */
+	latestSupported?: { version: string; cell: Cell };
 }
 
 /**
@@ -322,6 +324,11 @@ export function summarizeCell(
 	const prerelease = breakdown.find(
 		(item) => item.prerelease && (!latest || breakdown.indexOf(item) < breakdown.indexOf(latest)),
 	);
+	const usable = (state: CellState) => state === "verified" || state === "declared";
+	const latestSupported =
+		latest && !usable(latest.cell.state)
+			? breakdown.find((item) => !item.prerelease && item !== latest && usable(item.cell.state))
+			: undefined;
 
 	return {
 		state: verified.length ? "verified" : rawRange ? "declared" : "unverified",
@@ -333,6 +340,7 @@ export function summarizeCell(
 		breakdown,
 		...(latest ? { latest: { version: latest.version, cell: latest.cell } } : {}),
 		...(prerelease ? { prerelease: { version: prerelease.version, cell: prerelease.cell } } : {}),
+		...(latestSupported ? { latestSupported: { version: latestSupported.version, cell: latestSupported.cell } } : {}),
 	};
 }
 

test/compute.test.ts

@@ -195,3 +195,28 @@ describe("failed builds", () => {
 		expect(doc().packages["@nativescript/android"].versions["9.1.1"].suspect).toEqual({ jdk: ["21", "17"] });
 	});
 });
+
+describe("latest supported", () => {
+	it("names the newest usable version when the newest stable one is not", () => {
+		const doc = buildDocument({
+			generatedAt: "2026-09-09T00:00:00.000Z",
+			toolchains: { xcode: [], cocoapods: [], compileSdk: [], buildTools: [], jdk: [{ version: "26", prerelease: true }, { version: "25" }, { version: "21" }, { version: "17" }], node: [] },
+			packages: [
+				{
+					spec: { name: "@nativescript/android", toolchains: ["jdk"], keep: 5 },
+					document: { distTags: {}, manifests: [{ version: "9.1.1", requirements: { jdk: ">=17" } }] },
+				},
+			],
+			overrides: { requirements: [], advisories: [] },
+			verified: [
+				{ package: "@nativescript/android", version: "9.1.1", toolchains: { jdk: "25" }, with: { nativescript: "9.1.1", node: "24" }, outcome: "failure", attempts: 2, recordedAt: "2026-09-09T00:00:00Z" },
+				{ package: "@nativescript/android", version: "9.1.1", toolchains: { jdk: "21" }, with: { nativescript: "9.1.1", node: "24" }, recordedAt: "2026-09-09T00:00:00Z" },
+			],
+		});
+		const cell = summarizeCell(doc, "@nativescript/android", "9.1.1", "jdk");
+		expect(cell.latest).toMatchObject({ version: "25", cell: { state: "unsupported" } });
+		expect(cell.latestSupported).toMatchObject({ version: "21", cell: { state: "verified" } });
+		expect(cell.prerelease).toMatchObject({ version: "26" });
+		expect(summarizeCell(doc, "@nativescript/android", "9.1.1", "jdk").latestSupported?.version).not.toBe("17");
+	});
+});

web/src/components/CompatCell.vue

@@ -47,6 +47,15 @@ const background = computed(() => {
 	>
 		<StateIcon :state="state" :size="22" class="mx-auto" />
 		<span class="mt-1 block tabular-nums" :class="TEXT[state]">{{ summary.latest?.version ?? "No data" }}</span>
+		<span
+			v-if="summary.latestSupported"
+			class="mt-0.5 flex items-center justify-center gap-1 text-[11px] tabular-nums"
+			:title="`${summary.latestSupported.version}: ${summary.latestSupported.cell.reason}`"
+		>
+			<StateIcon :state="summary.latestSupported.cell.state" :size="12" />
+			<span class="font-medium text-ok">{{ summary.latestSupported.version }}</span>
+			<span class="text-neutral-500 dark:text-neutral-400">supported</span>
+		</span>
 		<span
 			v-if="summary.prerelease"
 			class="mt-0.5 flex items-center justify-center gap-1 text-[11px] tabular-nums text-neutral-500 dark:text-neutral-400"