feat: terminal frontend

package.json

@@ -36,6 +36,7 @@
       },
       "cordova-plugin-websocket": {},
       "cordova-plugin-buildinfo": {},
+      "com.foxdebug.acode.rk.exec.proot": {},
       "cordova-plugin-system": {},
       "com.foxdebug.acode.rk.exec.terminal": {}
     },
@@ -63,8 +64,9 @@
     "@types/url-parse": "^1.4.11",
     "autoprefixer": "^10.4.19",
     "babel-loader": "^9.1.3",
+    "com.foxdebug.acode.rk.exec.proot": "file:src/plugins/proot",
     "com.foxdebug.acode.rk.exec.terminal": "file:src/plugins/terminal",
-    "cordova-android": "13.0.0",
+    "cordova-android": "^13.0.0",
     "cordova-clipboard": "^1.3.0",
     "cordova-plugin-advanced-http": "^3.3.1",
     "cordova-plugin-browser": "file:src/plugins/browser",
@@ -95,6 +97,14 @@
   "dependencies": {
     "@deadlyjack/ajax": "^1.2.6",
     "@ungap/custom-elements": "^1.3.0",
+    "@xterm/addon-attach": "^0.11.0",
+    "@xterm/addon-fit": "^0.10.0",
+    "@xterm/addon-image": "^0.8.0",
+    "@xterm/addon-search": "^0.15.0",
+    "@xterm/addon-unicode11": "^0.8.0",
+    "@xterm/addon-web-links": "^0.11.0",
+    "@xterm/addon-webgl": "^0.18.0",
+    "@xterm/xterm": "^5.5.0",
     "autosize": "^6.0.1",
     "cordova": "12.0.0",
     "core-js": "^3.37.1",

src/ace/commands.js

@@ -341,6 +341,14 @@ const commands = [
 		},
 		readOnly: true,
 	},
+	{
+		name: "openTerminal",
+		description: "Open Terminal",
+		exec() {
+			acode.exec("new-terminal");
+		},
+		readOnly: true,
+	},
 ];
 
 export function setCommands(editor) {

src/components/terminal/index.js

@@ -0,0 +1,22 @@
+/**
+ * Terminal Components Export
+ */
+
+import TerminalComponent from "./terminal";
+import { DEFAULT_TERMINAL_SETTINGS } from "./terminalDefaults";
+import TerminalManager from "./terminalManager";
+import TerminalThemeManager from "./terminalThemeManager";
+
+export {
+	TerminalComponent,
+	TerminalManager,
+	TerminalThemeManager,
+	DEFAULT_TERMINAL_SETTINGS,
+};
+
+export default {
+	TerminalComponent,
+	TerminalManager,
+	TerminalThemeManager,
+	DEFAULT_TERMINAL_SETTINGS,
+};

src/components/terminal/ligatures.js

@@ -0,0 +1,102 @@
+// pretty basic ligature implementation for webview
+export default class LigaturesAddon {
+	constructor(options = {}) {
+		// fallback ligatures if a font does not support ligatures natively
+		this._fallbackLigatures =
+			options.fallbackLigatures ||
+			[
+				"<--",
+				"<---",
+				"<<-",
+				"<-",
+				"->",
+				"->>",
+				"-->",
+				"--->",
+				"<==",
+				"<===",
+				"<<=",
+				"<=",
+				"=>",
+				"=>>",
+				"==>",
+				"===>",
+				">=",
+				">>=",
+				"<->",
+				"<-->",
+				"<--->",
+				"<---->",
+				"<=>",
+				"<==>",
+				"<===>",
+				"<====>",
+				"<~~",
+				"<~",
+				"~>",
+				"~~>",
+				"::",
+				":::",
+				"==",
+				"!=",
+				"===",
+				"!==",
+				":=",
+				":-",
+				":+",
+				"<*",
+				"<*>",
+				"*>",
+				"<|",
+				"<|>",
+				"|>",
+				"+:",
+				"-:",
+				"=:",
+				":>",
+				"++",
+				"+++",
+				"<!--",
+				"<!---",
+				"<***>",
+			].sort((a, b) => b.length - a.length);
+		this._characterJoinerId = undefined;
+		this._terminal = undefined;
+	}
+
+	activate(terminal) {
+		this._terminal = terminal;
+		this._characterJoinerId = terminal.registerCharacterJoiner(
+			this._joinCharacters.bind(this),
+		);
+		terminal.element.style.fontFeatureSettings = `"liga" on, "calt" on`;
+	}
+
+	dispose() {
+		if (this._characterJoinerId !== undefined) {
+			this._terminal?.deregisterCharacterJoiner(this._characterJoinerId);
+			this._characterJoinerId = undefined;
+		}
+		if (this._terminal?.element) {
+			this._terminal.element.style.fontFeatureSettings = "";
+		}
+	}
+
+	_joinCharacters(text) {
+		return this._findLigatureRanges(text, this._fallbackLigatures);
+	}
+
+	_findLigatureRanges(text, ligatures) {
+		const ranges = [];
+		for (let i = 0; i < text.length; i++) {
+			for (const ligature of ligatures) {
+				if (text.startsWith(ligature, i)) {
+					ranges.push([i, i + ligature.length]);
+					i += ligature.length - 1;
+					break;
+				}
+			}
+		}
+		return ranges;
+	}
+}