From 3263690d82105dec740c059dcb01f50fb9e84711 Mon Sep 17 00:00:00 2001
From: Jake Bailey <5341706+jakebailey@users.noreply.github.com>
Date: Mon, 16 Nov 2026 15:59:18 -0800
Subject: [PATCH 1/3] Offer compiler version fallbacks on startup errors
Match the v1 recovery path for links to removed TypeScript versions so users aren't left on a loading error with no way to continue. Keep fallback actions for version-specific unavailability and retain Retry for transient network failures.
---
packages/playground-v2/src/index.html | 2 ++
packages/playground-v2/src/main.ts | 27 ++++++++++++++++++++++++++-
2 files changed, 28 insertions(+), 1 deletion(-)
diff --git a/packages/playground-v2/src/index.html b/packages/playground-v2/src/index.html
index 3c93de346730..96de7ec4d9f6 100644
--- a/packages/playground-v2/src/index.html
+++ b/packages/playground-v2/src/index.html
@@ -314,6 +314,8 @@
Enter a value
+
+
Download TypeScript?
diff --git a/packages/playground-v2/src/main.ts b/packages/playground-v2/src/main.ts
index f7b31df12421..7818327de111 100644
--- a/packages/playground-v2/src/main.ts
+++ b/packages/playground-v2/src/main.ts
@@ -1,5 +1,10 @@
import type { Diagnostic as CompilerDiagnostic } from "@typescript/typescript/sync"
-import { downloadCompilerAsset, fetchCompilerResource, readResponseBytes } from "./compiler-assets"
+import {
+ CompilerDownloadError,
+ downloadCompilerAsset,
+ fetchCompilerResource,
+ readResponseBytes,
+} from "./compiler-assets"
import { ensureCrossOriginIsolation, retryStartup } from "./isolation"
import {
legacyCompilerBaseUrl,
@@ -253,10 +258,13 @@ const downloadSize = getElement("download-size")
const rememberDownloadConsent = getElement("remember-download-consent")
const confirmDownloadButton = getElement("confirm-download-button")
const retryStartupButton = getElement("retry-startup-button")
+const useLatestStartupButton = getElement("use-latest-startup-button")
+const useNightlyStartupButton = getElement("use-nightly-startup-button")
let compilerReady = false
let lspReady = false
let compilerFailure: string | undefined
+let versionFallbackAvailable = false
let lspFailure: string | undefined
let projectFailure: string | undefined
let languageServer: TsgoLspController | undefined
@@ -877,6 +885,8 @@ toggleRunOutputButton.addEventListener("click", () => {
navigateBackButton.addEventListener("click", navigateBack)
runButton.addEventListener("click", runProject)
retryStartupButton.addEventListener("click", retryStartup)
+useLatestStartupButton.addEventListener("click", () => void selectCompilerVersion("native"))
+useNightlyStartupButton.addEventListener("click", () => void selectCompilerVersion("next"))
settingsButton.addEventListener("click", openSettings)
settingsCancelButton.addEventListener("click", () => settingsDialog.close())
settingsResetButton.addEventListener("click", () => populateSettingsForm(defaultPlaygroundSettings()))
@@ -963,6 +973,7 @@ async function initializeNativeCompiler() {
} catch (error) {
const message = error instanceof Error ? error.message : String(error)
compilerFailure = message
+ versionFallbackAvailable = isUnavailableCompilerVersionError(error)
completeInitialTypeQueries()
renderStatus()
console.error(error)
@@ -1041,6 +1052,7 @@ async function initializeStradaCompiler(requestedVersion: string) {
if (!touchPrimary.matches && !lastInputWasTouch) inputEditor.focus()
} catch (error) {
compilerFailure = error instanceof Error ? error.message : String(error)
+ versionFallbackAvailable = isUnavailableCompilerVersionError(error)
completeInitialTypeQueries()
renderStatus()
console.error(error)
@@ -1250,6 +1262,14 @@ function normalizeRequestedVersion(version: string) {
return version === "Nightly" ? "next" : version
}
+function isUnavailableCompilerVersionError(error: unknown) {
+ if (error instanceof CompilerDownloadError) return error.status === 404 || error.status === 410
+ if (!(error instanceof Error)) return false
+ return /(?:not supported by this Playground|API and WASI artifact revisions do not match|Invalid package metadata|Missing package export|Compiler libraries are missing|Missing compiler file size)/i.test(
+ error.message
+ )
+}
+
async function resolveStradaVersion(requestedVersion: string) {
const normalized = normalizeRequestedVersion(requestedVersion)
if (normalized !== "next" && normalized !== "latest") return normalized
@@ -2606,8 +2626,13 @@ function renderStatus() {
loadingProgress.hidden = true
loadingDetail.textContent = ""
retryStartupButton.hidden = false
+ const requestedVersion = normalizeRequestedVersion(selectedCompiler ?? "")
+ useLatestStartupButton.hidden = !versionFallbackAvailable || isDefaultNativeCompilerVersion(selectedCompiler)
+ useNightlyStartupButton.hidden = !versionFallbackAvailable || requestedVersion === "next"
return
}
+ useLatestStartupButton.hidden = true
+ useNightlyStartupButton.hidden = true
if (!compilerReady) {
loadingMessage.textContent = "Loading TypeScript..."
return
From 876b4420dde808c07912cb09ffecfbbfbc3472d8 Mon Sep 17 00:00:00 2001
From: Jake Bailey <5341706+jakebailey@users.noreply.github.com>
Date: Mon, 16 Nov 2026 16:07:01 -0800
Subject: [PATCH 2/3] Resolve startup recovery to an exact stable release
"Use latest" previously reloaded the native default channel, which
falls back to Nightly whenever the npm latest release has no WASM
build. Users then had no way to reach a stable compiler, and the two
recovery choices collapsed into the same Nightly load.
Resolve "Use latest" to the npm latest release when the Playground
supports it, otherwise to the newest supported stable release below
it, so stale links land on a usable stable compiler. Offer both
recovery choices for any compiler startup failure, since the failure
causes are too varied to classify reliably, and hide a choice only
when it names the version that just failed to load.
---
.../playground-v2/src/compiler-versions.ts | 14 +++-
packages/playground-v2/src/main.ts | 72 +++++++++++++------
.../playground-v2/src/native-compiler.test.ts | 24 +++++++
3 files changed, 88 insertions(+), 22 deletions(-)
diff --git a/packages/playground-v2/src/compiler-versions.ts b/packages/playground-v2/src/compiler-versions.ts
index ccf46d407387..b8fb9684800e 100644
--- a/packages/playground-v2/src/compiler-versions.ts
+++ b/packages/playground-v2/src/compiler-versions.ts
@@ -1,4 +1,4 @@
-import { gte, prerelease, rcompare, valid } from "semver"
+import { gte, lte, prerelease, rcompare, valid } from "semver"
import { CompilerDownloadError, fetchCompilerResource } from "./compiler-assets"
export type PublishedCompilerVersions = {
@@ -106,6 +106,18 @@ export function publishedNativeCompilerSelection(published: PublishedCompilerVer
return { version, channel: useStable ? ("stable" as const) : ("nightly" as const) }
}
+export function latestStableCompilerVersion(legacyVersions: readonly string[], published: PublishedCompilerVersions) {
+ const latest = published.tags.latest
+ if (latest && valid(latest) !== null && !prerelease(latest)) {
+ if (!isUnsupportedNativeCompilerVersion(latest) && published.versions.includes(latest)) return latest
+ const supported = compilerVersionChoices(legacyVersions, published).find(
+ ({ version }) => valid(version) !== null && !prerelease(version) && lte(version, latest)
+ )
+ if (supported) return supported.version
+ }
+ throw new Error("No supported TypeScript release is published as latest")
+}
+
export function compilerVersionChoices(
legacyVersions: readonly string[],
published?: PublishedCompilerVersions,
diff --git a/packages/playground-v2/src/main.ts b/packages/playground-v2/src/main.ts
index 7818327de111..3a22dd4307c4 100644
--- a/packages/playground-v2/src/main.ts
+++ b/packages/playground-v2/src/main.ts
@@ -1,10 +1,5 @@
import type { Diagnostic as CompilerDiagnostic } from "@typescript/typescript/sync"
-import {
- CompilerDownloadError,
- downloadCompilerAsset,
- fetchCompilerResource,
- readResponseBytes,
-} from "./compiler-assets"
+import { downloadCompilerAsset, fetchCompilerResource, readResponseBytes } from "./compiler-assets"
import { ensureCrossOriginIsolation, retryStartup } from "./isolation"
import {
legacyCompilerBaseUrl,
@@ -18,6 +13,7 @@ import {
isUnsupportedNativeCompilerVersion,
loadPublishedCompilerVersions,
loadLegacyCompilerVersions,
+ latestStableCompilerVersion,
publishedNativeCompilerSelection,
} from "./compiler-versions"
import "monaco-editor/editor/contrib/links/browser/links.js"
@@ -264,7 +260,8 @@ const useNightlyStartupButton = getElement("use-nightly-start
let compilerReady = false
let lspReady = false
let compilerFailure: string | undefined
-let versionFallbackAvailable = false
+let attemptedCompilerVersion: string | undefined
+let versionRecovery: { latest: boolean; nightly: boolean } | undefined
let lspFailure: string | undefined
let projectFailure: string | undefined
let languageServer: TsgoLspController | undefined
@@ -885,7 +882,7 @@ toggleRunOutputButton.addEventListener("click", () => {
navigateBackButton.addEventListener("click", navigateBack)
runButton.addEventListener("click", runProject)
retryStartupButton.addEventListener("click", retryStartup)
-useLatestStartupButton.addEventListener("click", () => void selectCompilerVersion("native"))
+useLatestStartupButton.addEventListener("click", () => void useLatestCompilerVersion())
useNightlyStartupButton.addEventListener("click", () => void selectCompilerVersion("next"))
settingsButton.addEventListener("click", openSettings)
settingsCancelButton.addEventListener("click", () => settingsDialog.close())
@@ -973,9 +970,8 @@ async function initializeNativeCompiler() {
} catch (error) {
const message = error instanceof Error ? error.message : String(error)
compilerFailure = message
- versionFallbackAvailable = isUnavailableCompilerVersionError(error)
completeInitialTypeQueries()
- renderStatus()
+ offerVersionRecovery()
console.error(error)
}
}
@@ -984,6 +980,7 @@ async function initializeStradaCompiler(requestedVersion: string) {
try {
setLoadingIndeterminate("Loading TypeScript...", "")
const version = await resolveStradaVersion(requestedVersion)
+ attemptedCompilerVersion = version
let mirroredVersions: string[] = []
try {
mirroredVersions = await getLegacyCompilerVersions()
@@ -1052,9 +1049,8 @@ async function initializeStradaCompiler(requestedVersion: string) {
if (!touchPrimary.matches && !lastInputWasTouch) inputEditor.focus()
} catch (error) {
compilerFailure = error instanceof Error ? error.message : String(error)
- versionFallbackAvailable = isUnavailableCompilerVersionError(error)
completeInitialTypeQueries()
- renderStatus()
+ offerVersionRecovery()
console.error(error)
}
}
@@ -1262,14 +1258,46 @@ function normalizeRequestedVersion(version: string) {
return version === "Nightly" ? "next" : version
}
-function isUnavailableCompilerVersionError(error: unknown) {
- if (error instanceof CompilerDownloadError) return error.status === 404 || error.status === 410
- if (!(error instanceof Error)) return false
- return /(?:not supported by this Playground|API and WASI artifact revisions do not match|Invalid package metadata|Missing package export|Compiler libraries are missing|Missing compiler file size)/i.test(
- error.message
+function offerVersionRecovery() {
+ const recovery = { latest: true, nightly: normalizeRequestedVersion(selectedCompiler ?? "") !== "next" }
+ versionRecovery = recovery
+ renderStatus()
+ void getPublishedCompilerVersions().then(
+ async published => {
+ try {
+ const latest = latestStableCompilerVersion(await getLegacyCompilerVersions().catch(() => []), published)
+ if (latest === attemptedCompilerVersion) recovery.latest = false
+ } catch {
+ recovery.latest = false
+ }
+ if (published.tags.next === attemptedCompilerVersion) recovery.nightly = false
+ renderStatus()
+ },
+ () => {}
)
}
+async function useLatestCompilerVersion() {
+ useLatestStartupButton.disabled = true
+ try {
+ let published
+ try {
+ published = await getPublishedCompilerVersions()
+ } catch {
+ publishedCompilerVersionsPromise = undefined
+ published = await getPublishedCompilerVersions()
+ }
+ const legacyVersions = await getLegacyCompilerVersions().catch(() => {
+ legacyCompilerVersionsPromise = undefined
+ return getLegacyCompilerVersions().catch(() => [])
+ })
+ await selectCompilerVersion(latestStableCompilerVersion(legacyVersions, published))
+ } catch (error) {
+ loadingDetail.textContent = error instanceof Error ? error.message : String(error)
+ useLatestStartupButton.disabled = false
+ }
+}
+
async function resolveStradaVersion(requestedVersion: string) {
const normalized = normalizeRequestedVersion(requestedVersion)
if (normalized !== "next" && normalized !== "latest") return normalized
@@ -1889,7 +1917,10 @@ function applyEditorLocation(location: EditorLocation) {
}
function getCompilerDistribution() {
- compilerDistributionPromise ??= resolveNativeCompilerVersion().then(loadPublishedCompilerDistribution)
+ compilerDistributionPromise ??= resolveNativeCompilerVersion().then(version => {
+ attemptedCompilerVersion = version
+ return loadPublishedCompilerDistribution(version)
+ })
return compilerDistributionPromise
}
@@ -2626,9 +2657,8 @@ function renderStatus() {
loadingProgress.hidden = true
loadingDetail.textContent = ""
retryStartupButton.hidden = false
- const requestedVersion = normalizeRequestedVersion(selectedCompiler ?? "")
- useLatestStartupButton.hidden = !versionFallbackAvailable || isDefaultNativeCompilerVersion(selectedCompiler)
- useNightlyStartupButton.hidden = !versionFallbackAvailable || requestedVersion === "next"
+ useLatestStartupButton.hidden = !versionRecovery?.latest
+ useNightlyStartupButton.hidden = !versionRecovery?.nightly
return
}
useLatestStartupButton.hidden = true
diff --git a/packages/playground-v2/src/native-compiler.test.ts b/packages/playground-v2/src/native-compiler.test.ts
index ad6ba2999363..ffff96ed4a05 100644
--- a/packages/playground-v2/src/native-compiler.test.ts
+++ b/packages/playground-v2/src/native-compiler.test.ts
@@ -11,6 +11,7 @@ import {
compilerVersionChoices,
isUnsupportedNativeCompilerVersion,
isWasmCompilerVersion,
+ latestStableCompilerVersion,
publishedNativeCompilerSelection,
} from "./compiler-versions"
import { loadStradaLibraries, type StradaLibraryProgress } from "./strada-libraries"
@@ -661,6 +662,29 @@ test("native channel resolution rejects missing, incompatible and unlisted versi
)
})
+test("the latest release resolves to an exact supported stable version without falling back to Nightly", () => {
+ const next = "7.1.0-dev.20261031.1"
+ const legacy = ["5.9.3", "6.0.2", "6.0.3"]
+ assert.equal(
+ latestStableCompilerVersion(legacy, { versions: ["6.0.3", next], tags: { latest: "6.0.3", next } }),
+ "6.0.3"
+ )
+ assert.equal(
+ latestStableCompilerVersion(legacy, { versions: ["7.1.0", next], tags: { latest: "7.1.0", next } }),
+ "7.1.0"
+ )
+ assert.equal(
+ latestStableCompilerVersion(legacy, { versions: ["7.0.2", next], tags: { latest: "7.0.2", next } }),
+ "6.0.3"
+ )
+ for (const published of [
+ { versions: ["7.0.2", next], tags: { latest: "7.0.2", next } },
+ { versions: [next], tags: { next } },
+ ]) {
+ assert.throws(() => latestStableCompilerVersion([], published), /No supported TypeScript release/)
+ }
+})
+
test("version choices sort supported releases and the resolved Nightly by descending semver", () => {
const choices = compilerVersionChoices(["7.0.2", "5.9.2", "6.0.2", "3.1.6", "5.9.3", "6.0.3"], {
versions: ["7.0.2", "7.1.0-beta", "7.1.0-dev.20261030.1", "7.1.1", "7.1.2", "7.2.0-dev.20261101.1"],
From f781d955a204b2b318643b0dd92abb6b5462ccce Mon Sep 17 00:00:00 2001
From: Jake Bailey <5341706+jakebailey@users.noreply.github.com>
Date: Mon, 16 Nov 2026 16:08:49 -0800
Subject: [PATCH 3/3] Keep startup recovery errors visible and retryable
A failed "Use latest" lookup wrote its error straight into the loader,
where the next status update erased it, leaving users without an
explanation. A transient metadata failure while checking for the
already-failed version also hid "Use latest" for the rest of the
session, removing a recovery path that might succeed on another try.
Keep the lookup error in state so every status render shows it, and
hide a recovery action only when it is known to name the version that
just failed.
---
packages/playground-v2/src/main.ts | 33 ++++++++++++++++--------------
1 file changed, 18 insertions(+), 15 deletions(-)
diff --git a/packages/playground-v2/src/main.ts b/packages/playground-v2/src/main.ts
index 3a22dd4307c4..0e89c227935d 100644
--- a/packages/playground-v2/src/main.ts
+++ b/packages/playground-v2/src/main.ts
@@ -262,6 +262,7 @@ let lspReady = false
let compilerFailure: string | undefined
let attemptedCompilerVersion: string | undefined
let versionRecovery: { latest: boolean; nightly: boolean } | undefined
+let versionRecoveryFailure: string | undefined
let lspFailure: string | undefined
let projectFailure: string | undefined
let languageServer: TsgoLspController | undefined
@@ -1262,23 +1263,23 @@ function offerVersionRecovery() {
const recovery = { latest: true, nightly: normalizeRequestedVersion(selectedCompiler ?? "") !== "next" }
versionRecovery = recovery
renderStatus()
- void getPublishedCompilerVersions().then(
- async published => {
- try {
- const latest = latestStableCompilerVersion(await getLegacyCompilerVersions().catch(() => []), published)
- if (latest === attemptedCompilerVersion) recovery.latest = false
- } catch {
- recovery.latest = false
- }
- if (published.tags.next === attemptedCompilerVersion) recovery.nightly = false
- renderStatus()
- },
- () => {}
- )
+ const failedVersion = attemptedCompilerVersion
+ if (failedVersion === undefined) return
+ void (async () => {
+ const published = await getPublishedCompilerVersions()
+ if (published.tags.next === failedVersion) recovery.nightly = false
+ if (latestStableCompilerVersion(await getLegacyCompilerVersions(), published) === failedVersion) {
+ recovery.latest = false
+ }
+ })()
+ .catch(error => console.warn("Could not compare recovery versions with the failed compiler", error))
+ .finally(renderStatus)
}
async function useLatestCompilerVersion() {
useLatestStartupButton.disabled = true
+ versionRecoveryFailure = undefined
+ renderStatus()
try {
let published
try {
@@ -1293,8 +1294,10 @@ async function useLatestCompilerVersion() {
})
await selectCompilerVersion(latestStableCompilerVersion(legacyVersions, published))
} catch (error) {
- loadingDetail.textContent = error instanceof Error ? error.message : String(error)
+ versionRecoveryFailure = error instanceof Error ? error.message : String(error)
useLatestStartupButton.disabled = false
+ renderStatus()
+ console.error(error)
}
}
@@ -2655,7 +2658,7 @@ function renderStatus() {
loader.dataset.state = "error"
loadingMessage.textContent = failure
loadingProgress.hidden = true
- loadingDetail.textContent = ""
+ loadingDetail.textContent = versionRecoveryFailure ?? ""
retryStartupButton.hidden = false
useLatestStartupButton.hidden = !versionRecovery?.latest
useNightlyStartupButton.hidden = !versionRecovery?.nightly