Improve update dialogs with clearer messaging and safer ESC key handling

[wojtekn]

Related issues

• Fixes STU-1136

Proposed Changes

• Improved update dialog UX by using message/detail pattern for clearer, more distinct notifications
• Added cancelId: 1 and defaultId: 0 to restart dialog to prevent accidental app restarts when pressing ESC
• Extended "no updates available" detail text to ensure consistent left-alignment across all dialogs

No updates	Downloading update	Ready to install

Testing Instructions

1. Start the app with npm start
2. Test each dialog by temporarily adding debug code to src/updates.ts in the manualCheckForUpdates() function

export async function manualCheckForUpdates() {
	await showUpdateAvailableNotice();
	//await showUpdateUnavailableNotice();
	//await showUpdateReadyToInstallNotice();
	return;
	// ... rest of function
}

3. After adding debug code, restart the app
4. Go to Studio menu → Check for Updates
5. Verify each dialog has clear text and behaves correctly

Pre-merge Checklist

• Have you checked for TypeScript, React or other console errors?

[github-actions]

📊 Performance Test Results

Comparing d3d3fb0 vs trunk

site-editor

Metric	trunk	d3d3fb0	Diff	Change
load	9875.00 ms	7924.00 ms	-1951.00 ms	🟢 -19.8%

site-startup

Metric	trunk	d3d3fb0	Diff	Change
siteCreation	14161.00 ms	14171.00 ms	+10.00 ms	🔴 0.1%
siteStartup	5939.00 ms	5988.00 ms	+49.00 ms	🔴 0.8%

---

Results are median values from multiple test runs.

Legend: 🟢 Improvement (faster) | 🔴 Regression (slower) | ⚪ No change

[epeicher]

Thanks @wojtekn for improving this! I have left a couple of suggestions, but they are non-blocking as they are a matter of preference. I have tested it, and it works as expected. When I click Restart, the application closes and remains minimised, but I see this is the current behaviour. Changes LGTM!

Downloading in background	No updates available	Updates ready

Click on Restart

CleanShot.2025-12-16.at.08.58.44.mp4

[epeicher]

Suggested change

	message: __( 'Update downloading in background' ),
	message: __( 'Update downloading in the background' ),

[wojtekn]

Thanks, I added the article.

[epeicher]

I would remove the quotes from Later and keep it capitalized as it is. But that is personal preference, happy to hear other views.

[wojtekn]

Makes sense, removed.

[katinthehatsite]

Suggested change

	message: __( 'Update downloading in background' ),
	message: __( 'Update is downloading in the background' ),

[katinthehatsite]

OR

Suggested change

	message: __( 'Update downloading in background' ),
	message: __( 'Downloading update in the background' ),

[wojtekn]

Thanks, I updated the wording.

[katinthehatsite]

this looks good, if we want to go more casual, we could do something like:

You're up to date! You're running the latest version of Studio.

[wojtekn]

I would leave the more extended version, as with the shorter one, macOS centers the texts.

[katinthehatsite]

Sounds good 👍

[katinthehatsite]

Functionality looks good, I just left some minor wording suggestions 👍