App crashes on startup on macOS Monterey (Intel) — "undefined is not an object (evaluating 'xtermModule.Terminal')"

[easyandi]

Describe the bug

The app crashes immediately on startup, before the editor UI loads. This began after updating from v5.0.5 (which has no Terminal feature and does not crash) to v5.1.24, and persists on 5.2.5 after a clean reinstall.

Reproduction

1. Install Phoenix Code 5.1.24 or later on macOS Monterey (Intel).
2. Launch the app.
3. App crashes immediately with the above error, before the main window appears.

Expected behavior

App should start normally. If Terminal (xterm.js) can't initialize on this OS/architecture combination, it would be ideal if this failed gracefully rather than blocking the whole app from starting.

OS, Browser and Phoenix versions

• Phoenix Code version: 5.2.5 (also reproduced on 5.1.24, a clean reinstall)
• OS: macOS 12 Monterey, Intel
• Install method: DMG from phcode.io

logs or debug stack trace if any

undefined is not an object (evaluating 'xtermModule.Terminal')
@phtauri://localhost/v5.2.5/brackets.js:1:1338124
execCb@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:23875
check@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:14639
@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:18029
@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:1825
@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:18613
each@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:1065
emit@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:18579
check@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:15437
enable@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:18454
init@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:13665
callGetModule@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:11953
completeLoad@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:22924
onScriptLoad@phtauri://localhost/v5.2.5/thirdparty/requirejs/require.js:1:24077
@phtauri://localhost/v5.2.5/thirdparty/bugsnag.min.js:1:31345

Additional context

Reverting to v5.0.5 (pre-Terminal feature) avoids the crash entirely.

[devvaannsh]

https://github.com/orgs/phcode-dev/discussions/2974 please refer to this discussion @easyandi. Apologies for the issue, will be fixed in the upcoming releases!

@abose keeping this open to track it as a must-fix for the next release.

[abose]

Apple has ended support for macOS Monterey, and it no longer receives newer OS APIs required by some Phoenix features.

This issue is caused by the newly integrated terminal relying on newer macOS APIs that are not available on Monterey. Unfortunately, reverting Phoenix to an older terminal version is not possible due to security concerns.

For now, Monterey users should either roll back to the last supported version of Phoenix Code using the steps below, or upgrade to macOS Sonoma or later. We apologize for the inconvenience.

Only Intel Macs on macOS Monterey are affected.

If you cannot upgrade macOS, use the older supported Phoenix Code version and disable automatic updates by going to File > Open Preferences File and adding this to phcode.json:

"autoUpdate": false

The next update may fix this when the planned mac platform migration goes though.