feat: terminal integration first draft

Author: abose

.gitignore

@@ -68,6 +68,7 @@ test/thirdparty/jasmine-reporters
 /src/thirdparty/bugsnag-performance.min.js
 /src/thirdparty/bugsnag-performance.min.js.map
 /src/thirdparty/no-minify/
+/src/thirdparty/xterm
 
 # ignore files copied from node_modules to src/thirdparty
 # https://github.com/phcode-dev/phoenix/issues/10

docs/API-Reference/project/ProjectManager.md

@@ -206,6 +206,12 @@ If the provided path is to an old welcome project, returns the current one inste
 Initial project path is stored in prefs, which defaults to the welcome project on
 first launch.
 
+**Kind**: global function  
+<a name="_continueLoadProject"></a>
+
+## \_continueLoadProject()
+Internal: continue loading a project after beforeProjectClose handlers have resolved.
+
 **Kind**: global function  
 <a name="refreshFileTree"></a>
 

gulpfile.js/thirdparty-lib-copy.js

@@ -244,7 +244,32 @@ let copyThirdPartyLibs = series(
         'test/thirdparty/jasmine-reporters/'),
     copyLicence.bind(copyLicence, 'node_modules/jasmine-reporters/LICENSE', 'jasmine-reporters'),
     // lmdb
-    copyLicence.bind(copyLicence, 'node_modules/lmdb/LICENSE', 'lmdb')
+    copyLicence.bind(copyLicence, 'node_modules/lmdb/LICENSE', 'lmdb'),
+    // xterm.js terminal emulator
+    copyFiles.bind(copyFiles, ['node_modules/xterm/lib/xterm.js',
+        'node_modules/xterm/lib/xterm.js.map'], 'src/thirdparty/xterm'),
+    copyFiles.bind(copyFiles, ['node_modules/xterm/css/xterm.css'], 'src/thirdparty/xterm'),
+    renameFile.bind(renameFile, 'node_modules/xterm-addon-fit/lib/xterm-addon-fit.js',
+        'addon-fit.js', 'src/thirdparty/xterm'),
+    renameFile.bind(renameFile, 'node_modules/xterm-addon-fit/lib/xterm-addon-fit.js.map',
+        'addon-fit.js.map', 'src/thirdparty/xterm'),
+    renameFile.bind(renameFile, 'node_modules/xterm-addon-canvas/lib/xterm-addon-canvas.js',
+        'addon-canvas.js', 'src/thirdparty/xterm'),
+    renameFile.bind(renameFile, 'node_modules/xterm-addon-canvas/lib/xterm-addon-canvas.js.map',
+        'addon-canvas.js.map', 'src/thirdparty/xterm'),
+    renameFile.bind(renameFile, 'node_modules/xterm-addon-search/lib/xterm-addon-search.js',
+        'addon-search.js', 'src/thirdparty/xterm'),
+    renameFile.bind(renameFile, 'node_modules/xterm-addon-search/lib/xterm-addon-search.js.map',
+        'addon-search.js.map', 'src/thirdparty/xterm'),
+    renameFile.bind(renameFile, 'node_modules/xterm-addon-web-links/lib/xterm-addon-web-links.js',
+        'addon-web-links.js', 'src/thirdparty/xterm'),
+    renameFile.bind(renameFile, 'node_modules/xterm-addon-web-links/lib/xterm-addon-web-links.js.map',
+        'addon-web-links.js.map', 'src/thirdparty/xterm'),
+    renameFile.bind(renameFile, 'node_modules/xterm-addon-webgl/lib/xterm-addon-webgl.js',
+        'addon-webgl.js', 'src/thirdparty/xterm'),
+    renameFile.bind(renameFile, 'node_modules/xterm-addon-webgl/lib/xterm-addon-webgl.js.map',
+        'addon-webgl.js.map', 'src/thirdparty/xterm'),
+    copyLicence.bind(copyLicence, 'node_modules/xterm/LICENSE', 'xterm')
 
 );
 

package-lock.json

@@ -37,9 +37,9 @@
         "jasmine-core": "^4.2.0",
         "jasmine-reporters": "^2.5.0",
         "jsdoc-to-markdown": "^9.1.1",
+        "lmdb": "^3.5.1",
         "readable-stream": "^3.6.0",
-        "through2": "^4.0.2",
-        "lmdb": "^3.5.1"
+        "through2": "^4.0.2"
     },
     "scripts": {
         "postinstall": "npm install --prefix phoenix-builder-mcp",
@@ -121,6 +121,12 @@
         "requirejs": "^2.3.7",
         "tern": "^0.24.3",
         "tinycolor2": "^1.4.2",
-        "underscore": "^1.13.4"
+        "underscore": "^1.13.4",
+        "xterm": "^5.3.0",
+        "xterm-addon-canvas": "^0.5.0",
+        "xterm-addon-fit": "^0.8.0",
+        "xterm-addon-search": "^0.13.0",
+        "xterm-addon-web-links": "^0.9.0",
+        "xterm-addon-webgl": "^0.16.0"
     }
-}
+}

package.json

@@ -68,6 +68,7 @@ const NodeConnector = require("./node-connector");
 const LivePreview = require("./live-preview");
 require("./test-connection");
 require("./utils");
+require("./terminal");
 require("./git/cli");
 require("./claude-code-agent");
 function randomNonce(byteLength) {

src-node/index.js

@@ -25,10 +25,11 @@
         "cross-spawn": "^7.0.6",
         "lmdb": "^3.5.1",
         "mime-types": "^2.1.35",
+        "node-pty": "^1.1.0",
         "npm": "11.8.0",
         "open": "^10.1.0",
         "which": "^2.0.1",
         "ws": "^8.17.1",
         "zod": "^3.25.76"
     }
-}
+}