[datlechin]

Summary

• Connection windows show a button at the trailing end of the title bar while an update is pending. It is a stock NSButton in a trailing NSTitlebarAccessoryViewController, with the glass capsule bezel on macOS 26 and the toolbar bezel before that. It is added only while something is pending, because a hidden accessory keeps its width.
• Update Available opens Sparkle's own update window.
• Relaunch to Update opens a popover with the version, release notes, the plugins that also update, and Later / Relaunch Now. It shows for an update Sparkle downloaded on its own, and for staged plugin updates.
• With the shipped default (download and install automatically), a found update now reaches the user: updater(_:willInstallUpdateOnQuit:immediateInstallationBlock:) keeps Sparkle's install handler. Before, nothing showed until the next quit.
• One model, UpdateCenter over a pure UpdateStatus, drives the app menu item, Welcome, Settings, the Sync notice and the Plugins pane, so their titles and actions agree.
• Gentle reminders use Sparkle's documented hooks. ShouldHandleShowingScheduledUpdate no longer records state; WillHandleShowingUpdate does.
• Relaunch goes through one path, AppRelauncher:
  • It reviews unsaved documents first.
  • It hands off to Sparkle when an update is waiting.
  • Otherwise it quits normally and reopens only after the process exits.
  • The last session reopens once after a relaunch, whatever When TablePro starts says.
• Settings > General > Software Update:
  • A status row with its version, last check and one action (Check Now, Install Update…, Relaunch).
  • An Update channel picker (Stable, Beta) replaces the Get beta updates switch.
• Welcome always shows the version and shows an update link only while one is pending. The Show version and updates on the Welcome window setting is removed. Older saved settings still decode and drop the key.
• Plugins pane:
  • Quit & Reopen becomes Relaunch on the shared path.
  • Staged rows read "Updates when TablePro relaunches".
  • The "needs a newer TablePro" button and the Sync notice use an app-only action, so staged plugins alone never turn them into a plain relaunch.
• No notification and no Dock badge, per Sparkle's gentle-reminders guidance for Dock apps and the HIG on badges.

Defect on main	Fixed by
Default users never see a found update; it installs silently at the next quit	willInstallUpdateOnQuit handler, Relaunch to Update
Reminder state is set in a Sparkle hook documented as side-effect free	Recorded in standardUserDriverWillHandleShowingUpdate
Sync and Plugins buttons always read Check for Updates… or Update TablePro, whatever the state	Titles from UpdateStatus
Quit & Reopen starts a second instance before the quit is approved. Cancelling leaves two running, and a pending Sparkle install replaces the bundle under the new one	AppRelauncher reopens after exit, or through Sparkle
Staged plugin updates can only be relaunched from Settings > Plugins	Title bar indicator, menu item, Settings row

WelcomeWindowUITests.testTheVersionSettingHidesTheVersionAndTheUpdateCheckOnTheOpenWindow pinned the removed setting. It is replaced by testTheVersionShowsAndAnUpdateLinkWaitsForAPendingUpdate. SparkleUpdatePreferencesTests.deferredUpdateRenamesTheControl moved into UpdateStatusTests.

Test plan

• New suites: AppUpdatePhaseTests, UpdateStatusTests, UpdateCenterTests, UpdateIndicatorAccessoryTests, AppRelauncherTests.
• verify.sh test on those plus the window chrome, menu, toolbar, launch and settings suites: 233 passed, 0 failed. After the review fixes, the update suites: 33 passed.
• verify.sh uitest WelcomeWindowUITests/testTheVersionShowsAndAnUpdateLinkWaitsForAPendingUpdate: passed.
• Codex adversarial review found three defects, all fixed here: a dead install handler after a Sparkle abort, a document-review cancel leaving a relaunch armed, and app-upgrade notices relaunching for staged plugins only. The second round found nothing.
• Probe on macOS 27:
  • AppKit sizes a trailing accessory to the toolbar row.
  • Toolbar items overflow into the chevron before the accessory is clipped.
  • isHidden keeps the accessory's width; add and remove reflow the toolbar.
  • The glass capsule at .large matches the toolbar's capsules.
• Not verified:
  • Sparkle's real download, install and relaunch: Debug builds disable updating.
  • Layout on macOS 13 to 15: no such OS on this machine.

Screenshots

The after shots of the indicator, the popover, Welcome and the Settings row seed a ready update (0.85.0, two staged plugins) through a temporary patch that is not in this PR.

	Light	Dark
Connection window, after
Relaunch popover, after
Welcome, before
Welcome, after
Settings, before
Settings, after