swing-ui 1.2.0 → 1.2.1

package/SwingUI.js

@@ -41,14 +41,12 @@ export class SwingUI
 	#_msg_queue = [];
 	#queue_limit = 100; // send queued messages after queue size reaches this limit (0 = no message queue)
 	#msgCompressThreshold = 1000; // compress messages longer than this
-	#textDecoder = new TextDecoder("utf8");
 
 	#jvm = {
 		stdio: {}, JBridge: null, process: null, eventListener: e =>
 		{
 		}
 	};
-	#guiManagerWorker = null; // for GUI Process manager worker
 	#exiting = false;
 
 	/**
@@ -88,9 +86,9 @@ export class SwingUI
 		11: "Failed to set menu menu. Passed parameter must be of type MenuBar()"
 	};
 
-	//region For Worker IPC only
+	//region For Worker IPC
 
-	#useWorkerThread = false;
+	#guiManagerWorker = null;
 	#worker_port1 = null;
 	#worker_port2 = null;
 
@@ -156,21 +154,15 @@ export class SwingUI
 		}
 	}();
 
-	/**
-	 * Detects best compatible base64 decoder
-	 */
-	#decodeBase64 = typeof Uint8Array.fromBase64 === 'function' ? b64 => Uint8Array.fromBase64(b64) : typeof Buffer !== 'undefined' ? b64 => Buffer.from(b64, 'base64') : b64 => Uint8Array.from(atob(b64), c => c.charCodeAt(0));
-
 	//region Internal
 
 	/**
 	 * <b>NOTE:</b> Do not instantiate this class. It's already instantiated and assigned to a global variable `ui`.
 	 * @internal
 	 */
-	constructor(module_dir, JBridge)
+	constructor(module_dir)
 	{
 		this.#module_dir = module_dir;
-		this.#jvm.JBridge = JBridge;
 		this.rootDirectory; // detect project dir now
 
 		// ensure cleanup
@@ -189,192 +181,102 @@ export class SwingUI
 	 */
 	async InitGUIProcess()
 	{
-		if(this.runtime === "bun" || this.os === "darwin") this.#useWorkerThread = true;
-
 		const env = this.env;
 
 		if(process.argv.some(arg => arg.startsWith("--java-dir="))) env.JAVA_HOME = process.argv.find(arg => arg.startsWith("--java-dir=")).split("=")[1];
 
-		if(this.#useWorkerThread)
-		{
-			this.#msgCompressThreshold = 500; // reduce the threshold
-
-			const {port1, port2} = new MessageChannel();
-			this.#worker_port1 = port1;
-			this.#worker_port2 = port2;
-
-			// start IPC Worker
-			const workerPath = path.join(this.#module_dir, "ui-process-manager.js");
-
-			// set a value for the thread to wait for the worker to start
-			Atomics.store(this.#sharedBuffSignal, SwingUI.WorkerSignalIndex.ExecutionControl, SwingUI.WorkerSignal.Block);
-
-			const options = {
-				type: "module",
-				workerData: {
-					signalBuffer: this.#sharedBuffSignal,
-					responsePort: this.#worker_port2,
-					moduleDir: this.#module_dir,
-					rootDir: this.rootDirectory,
-					debugJava: process.argv.some(arg => arg === "--debug-java"),
-					verbose: process.argv.some(arg => arg === "--v"),
-					os: this.os,
-					runtime: this.runtime
-				},
-				transferList: [this.#worker_port2],
-				stdout: true,
-				stderr: true,
-				env: env
-			};
+		this.#msgCompressThreshold = 500; // reduce the threshold
+
+		const {port1, port2} = new MessageChannel();
+		this.#worker_port1 = port1;
+		this.#worker_port2 = port2;
+
+		// start IPC Worker
+		const workerPath = path.join(this.#module_dir, "ui-process-manager.js");
+
+		// set a value for the thread to wait for the worker to start
+		Atomics.store(this.#sharedBuffSignal, SwingUI.WorkerSignalIndex.ExecutionControl, SwingUI.WorkerSignal.Block);
+
+		const options = {
+			type: "module",
+			workerData: {
+				signalBuffer: this.#sharedBuffSignal,
+				responsePort: this.#worker_port2,
+				moduleDir: this.#module_dir,
+				rootDir: this.rootDirectory,
+				debugJava: process.argv.some(arg => arg === "--debug-java"),
+				verbose: process.argv.some(arg => arg === "--v"),
+				os: this.os,
+				runtime: this.runtime
+			},
+			transferList: [this.#worker_port2],
+			stdout: true,
+			stderr: true,
+			env: env
+		};
 
-			this.#guiManagerWorker = new Worker(workerPath, options);
+		this.#guiManagerWorker = new Worker(workerPath, options);
 
-			// forward worker logs to the main process
-			if(this.#guiManagerWorker.stdout != null) // e.g.. bun, and deno on macOS don't have stdout
-			{
-				this.#guiManagerWorker.stdout.on("data", chunk => console.log(chunk.toString()));
-				this.#guiManagerWorker.stderr.on("data", chunk => console.error(chunk.toString()));
-			}
+		// forward worker logs to the main process
+		if(this.#guiManagerWorker.stdout != null) // e.g.. bun, and deno on macOS don't have stdout
+		{
+			this.#guiManagerWorker.stdout.on("data", chunk => console.log(chunk.toString()));
+			this.#guiManagerWorker.stderr.on("data", chunk => console.error(chunk.toString()));
+		}
 
-			this.#guiManagerWorker.on("message", (msg) =>
+		this.#guiManagerWorker.on("message", (msg) =>
+		{
+			switch(msg.type)
 			{
-				switch(msg.type)
+				case "data":
 				{
-					case "data":
-					{
-						this.#inputLinesBuffer.push(msg.data);
-						if(this.#inputLinesBuffer.length < 2) queueMicrotask(() => {this.#processInputData();});
-						break;
-					}
-					case "exit":
-					{
-						this.exit(0);
-						break;
-					}
-					case "worker_log":
-					{
-						console.log(`WORKER THREAD: ${msg.data}`);
-						break;
-					}
-					case "worker_debug":
-					{
-						console.debug(`WORKER THREAD: ${msg.data}`);
-						break;
-					}
-					case "worker_warn":
-					{
-						console.warn(`WORKER THREAD: ${msg.data}`);
-						break;
-					}
-					case "worker_info":
-					{
-						console.info(`WORKER THREAD: ${msg.data}`);
-						break;
-					}
-					case "worker_error":
-					{
-						console.error(`WORKER THREAD ERROR: ${msg.data}`);
-						break;
-					}
+					this.#inputLinesBuffer.push(msg.data);
+					if(this.#inputLinesBuffer.length < 2) queueMicrotask(() => {this.#processInputData();});
+					break;
 				}
-			});
-			this.#guiManagerWorker.on("online", () => {});
-			this.#guiManagerWorker.on("error", (err) => console.error("[SwingUI] GUI Worker error:", err));
-			this.#guiManagerWorker.on("exit", (code) =>
-			{
-				if(!this.#exiting && code !== 0) console.error(`[SwingUI] GUI Worker stopped unexpectedly (exit code ${code})`);
-				this.exit(code);
-			});
-
-			// wait for the worker to start
-			const r = Atomics.wait(this.#sharedBuffSignal, SwingUI.WorkerSignalIndex.ExecutionControl, SwingUI.WorkerSignal.Block, 10000);
-			if(r === "timed-out") throw new Error("Failed to start GUI Worker: timeout.");
-		}
-		else
-		{
-			const jvmOpts = {opts: [], env: env};
-			if(process.argv.some(arg => arg === "--debug-java")) jvmOpts.opts.push("-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=*:5005");
-			if(this.os === "linux") jvmOpts.opts.push("--add-opens=java.desktop/sun.awt.X11=ALL-UNNAMED"); // to be able to set WM_CLASS in Java GUI
-			if(this.os === "darwin")
-			{
-				jvmOpts.opts.push("-Dapple.awt.UIElement=true");
-				jvmOpts.opts.push("-Dapple.awt.headless=false"); // was supposed to help JVM on macOS, but didn't. macOS doesn't allow GUI on non-main thread.
-			}
-
-			this.#jvm.JBridge.ensureJvm(jvmOpts);
-			this.#jvm.JBridge.appendClasspath(path.join(this.#module_dir, "jar/gui-11.jar"));
-			const JBridgeProcessHandle = this.#jvm.JBridge.importClass("java.lang.ProcessHandle");
-			this.#jvm.process = await JBridgeProcessHandle.current();
-			this.gui_process_id = Number(await this.#jvm.process.pid());
-
-			// receive events from GUI
-			this.#jvm.stdio.stdout = (_, line) =>
-			{
-				line = line.trim();
-				if(!line) return;
-
-				if(line.startsWith("GUI-EVENT->"))
+				case "exit":
 				{
-					try
-					{
-						const message = this.#textDecoder.decode(this.#decodeBase64(line.substring(11)));
-						this.#inputLinesBuffer.push(message);
-					}catch(ex)
-					{
-						console.error("Failed to parse IPC event:", ex);
-					}
+					this.exit(0);
+					break;
 				}
-				else
+				case "worker_log":
 				{
-					console.log(line);
+					console.log(`WORKER THREAD: ${msg.data}`);
+					break;
 				}
-
-				this.#processInputData();
-			};
-
-			this.#jvm.stdio.stderr = (_, data) =>
-			{
-				console.error(data);
-			};
-
-			// enable STDIO redirect to our handlers
-			this.#jvm.stdio.guard = this.#jvm.JBridge.stdout.enableRedirect(this.#jvm.stdio.stdout, this.#jvm.stdio.stderr);
-
-/*
-			this.#jvm.eventListener = this.#jvm.JBridge.newProxy("SwingUI$Callback", {
-				eventCall: data =>
+				case "worker_debug":
 				{
-					if(this.#inputLinesBuffer.length === 0) queueMicrotask(() => {this.#processInputData();});
-
-					data = this.#textDecoder.decode(this.#decodeBase64(data));
-
-					this.#inputLinesBuffer.push(data);
+					console.debug(`WORKER THREAD: ${msg.data}`);
+					break;
 				}
-			});
-*/
-
-			const ui_class = this.#jvm.JBridge.importClass("SwingUI");
-			const ops = JSON.stringify({
-				module_dir: this.#module_dir,
-				root_dir: this.rootDirectory,
-				verbose: process.argv.some(arg => arg === "--v")
-			});
-			this.#jvm.gui = new ui_class(ops);
-			//await this.#jvm.gui.setEventCallback(this.#jvm.eventListener);
-
-			// Watchdog
-			this.#watchdog_timer = setInterval(() =>
-			{
-				try
+				case "worker_warn":
 				{
-					process.kill(this.gui_process_id, 0);
-				}catch(ex)
+					console.warn(`WORKER THREAD: ${msg.data}`);
+					break;
+				}
+				case "worker_info":
 				{
-					console.log("Watchdog timer says the GUI process exited, so JS can exit too.");
-					if(ex.code === "ESRCH") this.exit(1);
+					console.info(`WORKER THREAD: ${msg.data}`);
+					break;
 				}
-			}, 5000);
-		}
+				case "worker_error":
+				{
+					console.error(`WORKER THREAD ERROR: ${msg.data}`);
+					break;
+				}
+			}
+		});
+		this.#guiManagerWorker.on("online", () => {});
+		this.#guiManagerWorker.on("error", (err) => console.error("[SwingUI] GUI Worker error:", err));
+		this.#guiManagerWorker.on("exit", (code) =>
+		{
+			if(!this.#exiting && code !== 0) console.error(`[SwingUI] GUI Worker stopped unexpectedly (exit code ${code})`);
+			this.exit(code);
+		});
+
+		// wait for the worker to start
+		const r = Atomics.wait(this.#sharedBuffSignal, SwingUI.WorkerSignalIndex.ExecutionControl, SwingUI.WorkerSignal.Block, 10000);
+		if(r === "timed-out") throw new Error("Failed to start GUI Worker: timeout.");
 
 		// report current version of this module to UI
 		this.sendToGUI({system: "version", value: this.#gui_version, pid: this.pid}, async r =>
@@ -417,16 +319,6 @@ export class SwingUI
 	{
 		if(typeof msg !== "string" || msg.length === 0) return null;
 
-		/*try
-		 {
-		 msg = decodeURIComponent(msg).trim();
-		 }catch(ex)
-		 {
-		 console.error(this._msg[9] + msg + "\n\n" + ex.stack);
-		 console.error(ex);
-		 return null;
-		 }*/
-
 		if(msg.startsWith("{") && msg.endsWith("}"))
 		{
 			try
@@ -707,13 +599,7 @@ export class SwingUI
 	sendToGUI(msg, callback = null)
 	{
 		// create default callback for "get" messages
-		if(callback === null && msg.get !== undefined)
-		{
-			callback = r =>
-			{
-				return r.value;
-			};
-		}
+		if(callback === null && msg.get !== undefined) callback = r => r.value;
 
 		// If no callback is needed, then we can stack up messages and send them together
 		if(callback != null)
@@ -721,20 +607,10 @@ export class SwingUI
 			// Send accumulated messages first
 			this.sendMessageQueue();
 
-			let msgs = JSON.stringify([msg]);
+			let msgs = '[' + JSON.stringify(msg) + ']';
 			this.stats.out += msgs.length;
 
-			let response;
-
-			if(this.#useWorkerThread)
-			{
-				response = this.#sendMessagesViaWorker("b64:" + Buffer.from(msgs, "utf-8").toString("base64"), true);
-			}
-			else
-			{
-				response = this.#jvm.gui.receiveDirectMessagesSync("b64:" + Buffer.from(msgs, "utf-8").toString("base64"));
-				if(response != null) response = this.#textDecoder.decode(this.#decodeBase64(response));
-			}
+			let response = this.#sendMessagesViaWorker("b64:" + Buffer.from(msgs, "utf-8").toString("base64"), true);
 
 			if(response != null && typeof response === "string") response = JSON.parse(response);
 
@@ -748,7 +624,7 @@ export class SwingUI
 		}
 		else
 		{
-			this.#_msg_queue.push(structuredClone(msg)); // clone original object to preserve values in case they change before we send the message to GUI
+			this.#_msg_queue.push(JSON.stringify(msg)); // stringify already to preserve values in case they change before we send the message to GUI
 
 			if(this.#_msg_queue.length >= this.#queue_limit)
 			{
@@ -782,7 +658,8 @@ export class SwingUI
 	{
 		if(this.#_msg_queue.length < 1) return this;
 
-		let msgs = JSON.stringify(this.#_msg_queue);
+		//let msgs = JSON.stringify(this.#_msg_queue);
+		let msgs = '[' + this.#_msg_queue.join(",") + ']';
 
 		// compress messages if more than one message and long enough
 		if(compress && this.#_msg_queue.length > 1 && msgs.length > this.#msgCompressThreshold)
@@ -800,18 +677,7 @@ export class SwingUI
 		this.stats.out += msgs.length;
 		this.#_msg_queue = []; // clear queue
 
-		if(this.#guiManagerWorker != null)
-		{
-			this.#sendMessagesViaWorker(msgs, false);
-		}
-		else if(this.#exiting) // when exiting, don't wait for response
-		{
-			this.#jvm.gui.receiveDirectMessages(msgs);
-		}
-		else
-		{
-			this.#jvm.gui.receiveDirectMessagesSync(msgs);
-		}
+		this.#sendMessagesViaWorker(msgs, false);
 
 		return this;
 	}
@@ -832,6 +698,48 @@ export class SwingUI
 		}
 	}
 
+	/**
+	 * Detect java-bridge compatibility with the current environment.
+	 */
+	#JavaBridgeSupported()
+	{
+		const support = {
+			windows: {
+				node: true,
+				deno: true
+			},
+			linux: {
+				node: true,
+				deno: false // on Linux java-bridge 2.8.1 has error: "TypeError: java.linux-x64-gnu.node: undefined symbol: uv_run"
+			}
+		};
+
+		const os = this.os;
+
+		if(support[os] === undefined) return false;
+		if(support[os][this.runtime] !== true) return false;
+
+		const arch = this.runtime === "deno" ? Deno.build.arch : globalThis.process?.arch;
+
+		// Normalize architecture
+		const archMap = {
+			x86_64: "x64",
+			aarch64: "arm64",
+			ia32: "x86"
+		};
+
+		const normalizedArch = archMap[arch] || arch;
+
+		// Platform and architecture support
+		const supported = {
+			windows: ["x86", "x64"],
+			linux: ["x64", "arm64"],
+			//darwin: ["x64", "arm64"] // macOS doesn't support UI on not main thread
+		};
+
+		return supported[os]?.includes(normalizedArch) || false;
+	}
+
 	//endregion
 
 	//region read-only Getters
@@ -1530,19 +1438,6 @@ export class SwingUI
 	{
 		this.sendToGUI({java: "exit", code: exitCode});
 
-		try
-		{
-			//this.#jvm.eventListener.reset();
-		}catch(_)
-		{
-		}
-		try
-		{
-			this.#jvm.stdio.guard.release();
-		}catch(_)
-		{
-		}
-
 		setTimeout(() =>
 		{
 			if(this.#guiManagerWorker != null)

package/classes/PasswordField.js

@@ -37,7 +37,7 @@ export class PasswordField extends TextComponent
 	 * const myChar = '\u25CF';
 	 * const myChar = '\u2B24';
 	 *
-	 * @param {string} [character] - A one character string character. If the string has more than one character, only first one will be used.
+	 * @param {string} [character] - A one character string. If the string has more than one character, only first one will be used.
 	 * @returns {PasswordField|string} Returns an instance of `this` object when setting a value, otherwise current value is returned.
 	 */
 	echoChar(...args)

package/index.js

@@ -1,12 +1,10 @@
 /**
- * Swing-UI GUI for JavaScript Runtime, such as Node.js, Bun, Deno 2.
+ * swing-ui GUI for JavaScript, such as Node.js, Bun, Deno 2.
  */
 
 import fs from "fs";
 import path from "path";
 
-import JBridge from "java-bridge";
-
 // show if debugger options were set
 if(process.execArgv.some(arg => arg.startsWith("--inspect"))) console.log("JavaScript Debugger option is set.");
 
@@ -17,11 +15,6 @@ const __dirname = import.meta.dirname ?? import.meta.dir ?? path.dirname((await
 
 // Dynamically assign each function to globalThis
 import * as functions from "./functions.js"; // Import all functions from functions.js
-if(typeof structuredClone !== "function") // add structuredClone() function in case it doesn't exist (node <17)
-{
-	const v8 = await import("v8");
-	functions.structuredClone = ((obj) => {return v8.deserialize(v8.serialize(obj));});
-}
 Object.entries(functions).forEach(([name, func]) => {Object.defineProperty(globalThis, name, {writable: false, configurable: false, value: func});});
 
 // Dynamically assign each enum to globalThis
@@ -93,7 +86,7 @@ for(const file of fs.readdirSync(classesDir))
 
 try
 {
-	let ui = new (await import("./SwingUI.js")).SwingUI(__dirname, JBridge);
+	let ui = new (await import("./SwingUI.js")).SwingUI(__dirname);
 	await ui.InitGUIProcess();
 	Object.defineProperty(globalThis, "ui", {writable: false, configurable: false, value: ui});
 }catch(ex)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "swing-ui",
-	"version": "1.2.0",
+	"version": "1.2.1",
 	"description": "Cross-platform Graphic User Interface for Node.js, Bun and Deno 2+",
 	"main": "index.js",
 	"scripts": {
@@ -54,7 +54,5 @@
 		"bun": ">= 1.1.0",
 		"deno": ">= 2.6.0"
 	},
-	"dependencies": {
-		"java-bridge": "^2.8.1"
-	}
+	"dependencies": {}
 }

package/types/classes/Ellipse.d.ts

@@ -23,6 +23,15 @@ export class Ellipse extends Shape {
         width: number;
         height: number;
     };
+    /**
+     * Sets or gets the size of the `Ellipse` (horizontal and vertical diameter).
+     *
+     * @param {number|Size} width - Width of the ellipse (horizontal diameter), or a `Size` object (e.g., {width:300,height:300}).
+     * @param {number} [height] - Height of the ellipse (vertical diameter).
+     * @returns {Size|Ellipse} If called without parameters, current size is returned; otherwise this Ellipse object is returned.
+     * @see Size
+     */
+    size(...args: any[]): Size | Ellipse;
     /**
      * Returns a JSON object that contains this shape properties. It may be converted back to this shape.
      *

package/types/classes/PasswordField.d.ts

@@ -14,7 +14,7 @@ export class PasswordField extends TextComponent {
      * const myChar = '\u25CF';
      * const myChar = '\u2B24';
      *
-     * @param {string} [character] - A one character string character. If the string has more than one character, only first one will be used.
+     * @param {string} [character] - A one character string. If the string has more than one character, only first one will be used.
      * @returns {PasswordField|string} Returns an instance of `this` object when setting a value, otherwise current value is returned.
      */
     echoChar(...args: any[]): PasswordField | string;

package/types/classes/Rectangle.d.ts

@@ -27,6 +27,15 @@ export class Rectangle extends Shape {
         width: number;
         height: number;
     };
+    /**
+     * Sets or gets the size of the `Rectangle`.
+     *
+     * @param {number|Size} width - Width of the Rectangle, or a `Size` object (e.g., {width:300,height:300}).
+     * @param {number} [height] - Height of the Rectangle.
+     * @returns {Size|Rectangle} If called without parameters, current size is returned; otherwise this Rectangle object is returned.
+     * @see Size
+     */
+    size(...args: any[]): Size | Rectangle;
     /**
      * Sets corner radius if only one argument passed, or arc width and height if two arguments or size object supplied. The arc size is applied to all corners.
      *

package/types/classes/Window.d.ts

@@ -330,14 +330,14 @@ export class Window extends ShapeContainer {
      */
     opacity(...args: any[]): number | this;
     /**
-     * Sets a ToolBar to one of locations: `top`, `right`, `bottom` and `left`, or gets a ToolBar at a specified location.
+     * Sets a ToolBar to one of locations: `top`, `right`, `bottom` and `left`.
      *
      * @param {string} dockLocation - One of: `top`, `right`, `bottom` and `left`.
      * @param {ToolBar} [toolbar] - ToolBar to set to specified location. Set `null` to remove the toolbar from that location. Omit to get the toolbar already in that location.
-     * @returns {ToolBar|null|Window} If only location is specified, a {@link ToolBar} or `null` is returned. When `toolbar` argument is passed, an instance of `this` Window is returned.
+     * @returns {null|any|Window}
      * @since 1.0.8
      */
-    toolBar(dockLocation: string, toolbar?: ToolBar): ToolBar | null | Window;
+    toolBar(dockLocation: string, toolbar?: ToolBar): null | any | Window;
     #private;
 }
 import { ShapeContainer } from "./ShapeContainer.js";

package/types/typedefs.d.ts

@@ -79,7 +79,7 @@ type DragEvent = {
      */
     target: object;
     /**
-     * - One of `dragstart`, `dragend`, `cancel`.
+     * - One of `dragstart`, `dragend`, `drag`, `cancel`.
      */
     type: string;
     /**
@@ -158,9 +158,21 @@ type ChangeEvent = {
      */
     position?: number | undefined;
     /**
-     * - The number of characters inserted or removed. Present when `action` is present.
+     * - The number of characters inserted or removed. Present when `action` is present. Applies to text editing components only.
      */
     length?: number | undefined;
+    /**
+     * - Value of a currently selected {@link RadioButton}, {@link RadioButtonMenuItem} or {@link ToggleButton} within a group.
+     */
+    value?: string | number | undefined;
+    /**
+     * - Index of a currently selected {@link RadioButton}, {@link RadioButtonMenuItem} or {@link ToggleButton} within a group.
+     */
+    index?: number | undefined;
+    /**
+     * - Indicates if the target {@link RadioButton}, {@link RadioButtonMenuItem} or {@link ToggleButton} component's new state is selected.
+     */
+    selected?: boolean | undefined;
 };
 /**
  * Ancestor event received by the {@link UIComponent#onAncestorEvents |onAncestorEvents()} handler callback.
@@ -933,7 +945,7 @@ type ShapeEvent = {
      */
     target: object;
     /**
-     * - One of `add`, `remove`, `click`, `mousedown`, `mouseup`, `mouseenter`, `mouseleave`.
+     * - One of: `add`, `remove`, `click`, `mousedown`, `mouseup`, `mouseenter`, `mouseleave`, `mousemove`.
      */
     type: string;
     /**
@@ -994,11 +1006,11 @@ type ListItem = {
      */
     icon?: string | null | undefined;
     /**
-     * - Item text color as a 6-character hex string (e.g. `#665500`).
+     * - Item text color as a hex string (e.g. `#665500`).
      */
     color?: string | undefined;
     /**
-     * - Item background color as a 6-character hex string (e.g. `#665500`).
+     * - Item background color as a hex string (e.g. `#665500`).
      */
     background?: string | undefined;
     /**
@@ -1009,6 +1021,10 @@ type ListItem = {
      * - {@link Font} formatted object.
      */
     font?: Font | undefined;
+    /**
+     * - Specifies if the Tree node Item text can be edited by the user. (only in Tree components)
+     */
+    editable?: boolean | undefined;
     /**
      * - In some cases items are returned with `index` property to indicate their position within component.
      */
@@ -1072,9 +1088,9 @@ type Border = {
      */
     style: BorderStyle;
     /**
-     * - Border size in pixels. Must be >= 1.
+     * - Border width in pixels. Must be >= 1.
      */
-    size?: number | undefined;
+    width?: number | undefined;
     /**
      * - Inner padding as a space-separated string of four integer values: `"top right bottom left"`. Example: `"5 10 5 10"`. Can be set even when `style` is `"none"`.
      */
@@ -1179,7 +1195,7 @@ type TableColumn = {
     /**
      * - The character used to mask input for the `password` type.
      */
-    character?: string | undefined;
+    echoChar?: string | undefined;
     /**
      * - Icon shown in the column header. Value can be a local file path, URI, or base64 encoded image string.
      */
@@ -1244,7 +1260,7 @@ type TableColumn = {
 /**
  * Table cell coordinates containing column and row property.
  */
-type Cell = {
+type TableCell = {
     /**
      * - a column index of the cell
      */

package/ui-process-manager.js

@@ -54,7 +54,7 @@ else
 async function startJar()
 {
 	let JAR_PATH = path.join(workerData.moduleDir, "jar/gui-11.jar");
-	let JAVA_BIN = env.JAVA_HOME ? path.join(env.JAVA_HOME, workerData.os === "windows" ? "java.exe" : "java") : "java"; // build custom path from specified dir for each OS, or just use default command.
+	let JAVA_BIN = env.JAVA_HOME ? path.join(env.JAVA_HOME, "bin", workerData.os === "windows" ? "java.exe" : "java") : "java"; // build custom path from specified dir for each OS, or just use default command.
 	let JAVA_OPTS = (env.JAVA_OPTS ?? "").split(" ").filter(Boolean);
 	if(JAVA_OPTS.indexOf("-Dfile.encoding=UTF-8") === -1) JAVA_OPTS.push("-Dfile.encoding=UTF-8"); // important
 	if(workerData.debugJava) JAVA_OPTS.push("-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=*:5005"); // for debugging JAR