swing-ui 1.0.7 → 1.1.1

package/README.md

@@ -9,7 +9,7 @@ Build once, run it on Windows, Linux and macOS in your favorite JavaScript runti
 ![Windows | macOS | Linux](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue)
 [![npm license](https://img.shields.io/npm/l/swing-ui.svg)](https://www.npmjs.com/package/swing-ui)
 
-`swing-ui` wraps and upgrades the full Java Swing library so you can write native-looking, cross-platform desktop applications entirely in JavaScript using the JS runtime you already know: Node.js, Bun or Deno 2+.
+`swing-ui` brings a new experience to Java Swing with enhanced components and a simple JavaScript API, allowing you to build native-looking, cross-platform desktop applications entirely in JavaScript using the JS runtime you already know: Node.js, Bun, or Deno 2+.
 
 You only write JavaScript and the GUI gets built, or better yet, use our [Visual GUI Designer](https://swing-ui.com/visual-gui-designer/) to skip coding at all.
 

package/SwingUI.js

@@ -72,7 +72,6 @@ export class SwingUI
 
 	/**
 	 * @internal
-	 * @private
 	 */
 	_msg = {
 		0: "Calling a function of a destroyed UI component",
@@ -167,7 +166,6 @@ export class SwingUI
 	/**
 	 * <b>NOTE:</b> Do not instantiate this class. It's already instantiated and assigned to a global variable `ui`.
 	 * @internal
-	 * @private
 	 */
 	constructor(module_dir, JBridge)
 	{
@@ -186,6 +184,9 @@ export class SwingUI
 		process.on("SIGHUP", this.exit.bind(this, 0, "SIGHUP"));
 	}
 
+	/**
+	 * @internal
+	 */
 	async InitGUIProcess()
 	{
 		if(this.runtime === "bun" || this.os === "darwin") this.#useWorkerThread = true;
@@ -775,6 +776,7 @@ export class SwingUI
 	 *
 	 * @example <h2>Sending queued messages without compressing:</h2>
 	 * ui.sendMessageQueue(false);
+	 * @internal
 	 */
 	sendMessageQueue(compress = true)
 	{
@@ -912,8 +914,64 @@ export class SwingUI
 	 * Getter property that returns an array of available UI look and feel IDs on your system. For example Windows OS can have a Windows look and feel that linux doesn't have. Use them to set the desired look and feel using ui.ui(id) method.
 	 *
 	 * @readonly
-	 * @see {@link SwingUI#ui|ui.ui(id)}
-	 * @type {string[]}
+	 * @see SwingUI#ui
+	 * @type {object[]}
+	 * @example <h2>Example of a returned array</h2>
+	 * [
+	 *   {
+	 *     "name": "Default",
+	 *     "id": "MetalLookAndFeel"
+	 *   },
+	 *   {
+	 *     "name": "OS",
+	 *     "id": "WindowsLookAndFeel"
+	 *   },
+	 *   {
+	 *     "name": "Metal",
+	 *     "dark": false,
+	 *     "id": "MetalLookAndFeel"
+	 *   },
+	 *   {
+	 *     "name": "Nimbus",
+	 *     "dark": false,
+	 *     "id": "NimbusLookAndFeel"
+	 *   },
+	 *   {
+	 *     "name": "CDE/Motif",
+	 *     "dark": false,
+	 *     "id": "MotifLookAndFeel"
+	 *   },
+	 *   {
+	 *     "name": "Windows",
+	 *     "dark": false,
+	 *     "id": "WindowsLookAndFeel"
+	 *   },
+	 *   {
+	 *     "name": "Windows Classic",
+	 *     "dark": false,
+	 *     "id": "WindowsClassicLookAndFeel"
+	 *   },
+	 *   {
+	 *     "name": "FlatLaf Light",
+	 *     "dark": false,
+	 *     "id": "FlatLightLaf"
+	 *   },
+	 *   {
+	 *     "name": "FlatLaf Dark",
+	 *     "dark": true,
+	 *     "id": "FlatDarkLaf"
+	 *   },
+	 *   {
+	 *     "name": "FlatLaf IntelliJ",
+	 *     "dark": false,
+	 *     "id": "FlatIntelliJLaf"
+	 *   },
+	 *   {
+	 *     "name": "FlatLaf Darcula",
+	 *     "dark": true,
+	 *     "id": "FlatDarculaLaf"
+	 *   }
+	 * ]
 	 */
 	get list()
 	{
@@ -982,7 +1040,7 @@ export class SwingUI
 	}
 
 	/**
-	 * Gets a GUI software license information stored in the package.json file of your project.
+	 * Gets a swing-ui software license information including the path on your file system where the license is stored.
 	 *
 	 * @readonly
 	 * @type {Object}
@@ -1211,7 +1269,9 @@ export class SwingUI
 	 * @return {string|SwingUI} When setting arguments, `this` instance of SwingUI is returned, otherwise current value is returned.
 	 * @throws Error When argument is invalid.
 	 * @see SwingUI#list
-	 * @example <h2>Setting FlatDarkLaf UI with all options</h2>
+	 * @example <h2>Setting System's UI Theme</h2>
+	 * ui.ui(ui.list.find(t => t.name === "OS").id);
+	 * @example <h2>Setting FlatDarkLaf UI theme with all options</h2>
 	 * ui.ui(
 	 *   "FlatDarkLaf",
 	 *   {
@@ -2630,5 +2690,59 @@ export class SwingUI
 		return this;
 	}
 
+	/**
+	 * Registers, unregisters and retrieves event handler for event emitted by changes to screens on the computer, such as connecting a screen, disconnecting a screen, or changes to screen resolution.
+	 *
+	 * @param {function(Object):any|null|undefined} [callback] - Function to handle the event, `null` to remove all handlers, or omit to retrieve an array of handlers.
+	 * @param {boolean} remove - Removed the callback from this event
+	 * @return {SwingUI|function[]} If called without parameters, an array of registered callbacks is returned; otherwise `this` instance of SwingUI class is returned.
+	 * @example <h2>Registering screens change event handler:</h2>
+	 * ui.onScreensChange(e => {console.log(e.screens});
+	 * @see ui#screens
+	 */
+	onScreensChange(callback = undefined, remove = false)
+	{
+		const name = "onScreensChange";
+
+		// return callbacks
+		if(callback === undefined) return Array.isArray(this.callback[name]) ? [...this.callback[name]] : [];
+
+		// remove callback
+		if(remove === true || callback === null)
+		{
+			if(!Array.isArray(this.callback[name])) return this;
+
+			if(callback === null)
+			{
+				this.callback[name].length = 0;
+			}
+			else
+			{
+				this.callback[name] = this.callback[name].filter(l => l !== callback);
+			}
+
+			if(this.callback[name].length === 0)
+			{
+				delete this.callback[name]; // delete array
+				this.sendToGUI({system: name, remove: true}); // notify GUI
+			}
+		}
+		// add callback
+		else
+		{
+			if(typeof callback !== "function") throw new Error(`Invalid argument for callback function. Must be a "function" type.`);
+
+			if(!Array.isArray(this.callback[name]))
+			{
+				this.callback[name] = []; // create array
+				this.sendToGUI({system: name, remove: false}); // notify GUI
+			}
+
+			this.callback[name].push(callback); // add callback (don't bind to this here, do it at call)
+		}
+
+		return this;
+	}
+
 	//endregion
 }

package/classes/ComboBox.js

@@ -31,20 +31,20 @@ export class ComboBox extends TextComponent
 	 * @see ListItem
 	 * @example
 	 * // Creating combo box, then adding each item separately.
-	 * const combo1 = new ComboBox().add("Item 1").add(45).add({text: "Item 2", font:{bolt:true}});
+	 * const combo1 = new ComboBox().add("Item 1").add(45).add({text: "Item 2", font:{bold:true}});
 	 *
 	 * // Creating combo box, then adding items as an array.
 	 * const combo2 = new ComboBox().items([
 	 *     "Item 1",
 	 *     45,
-	 *     {text: "Item 3", font:{bolt:true}}
+	 *     {text: "Item 3", font:{bold:true}}
 	 * ]);
 	 *
 	 * // Creating combo box with items as a string and object. Items can be a mix of strings and objects.
 	 * const combo3 = new ComboBox([
 	 *      "Item 1",
 	 *      45,
-	 *      {text: "Item 3", font:{bolt:true}}
+	 *      {text: "Item 3", font:{bold:true}}
 	 * ]);
 	 */
 	constructor(...args) // accepts an optional parameter, array of string for list items

package/classes/ComponentContainer.js

@@ -13,7 +13,13 @@ export class ComponentContainer extends UIComponent
 	#_children = []; // child components of this component
 	#descriptorObject = null;
 
+	/**
+	 * @internal
+	 */
 	static preInitProperties = ["position", "size", "innerSize"];
+	/**
+	 * @internal
+	 */
 	static postInitProperties = ["defaultButton", "state", "visible"]; // state must be applied after all children apply anchor property
 
 	/**

package/classes/List.js

@@ -46,20 +46,20 @@ export class List extends ScrollableComponent
 	 * @param {Array<string|number|ListItem>} [items] - Items as an Array of ListItem formatted objects, strings or numbers. Can be a mix of these types.
 	 * @example
 	 * // Creating combo box, then adding each item separately.
-	 * const combo1 = new ComboBox().add("Item 1").add(45).add({text: "Item 2", font:{bolt:true}});
+	 * const combo1 = new ComboBox().add("Item 1").add(45).add({text: "Item 2", font:{bold:true}});
 	 *
 	 * // Creating combo box, then adding items as an array.
 	 * const combo2 = new ComboBox().items([
 	 *     "Item 1",
 	 *     45,
-	 *     {text: "Item 2", font:{bolt:true}}
+	 *     {text: "Item 2", font:{bold:true}}
 	 * ]);
 	 *
 	 * // Creating combo box with items as a string and object. Items can be a mix of strings and objects.
 	 * const combo3 = new ComboBox([
 	 *      "Item 1",
 	 *      45,
-	 *      {text: "Item 2", font:{bolt:true}}
+	 *      {text: "Item 2", font:{bold:true}}
 	 * ]);
 	 */
 	constructor(...args)

package/classes/RadioButton.js

@@ -2,9 +2,10 @@
 import {UIComponent} from "./UIComponent.js";
 
 /**
- * RadioButton is a component used to select of multiple option by clicking on it.
- * Multiple RadioButton components must be grouped for selection to work.
- * To group them pick one main RadioButton and group other RadioButton components with it.
+ * RadioButton is a component used to select one of multiple option by clicking on it.
+ *
+ * Multiple RadioButton components must be grouped for selection to work. To group them pick one main RadioButton and group other RadioButton components with it.
+ *
  * For example if you have three RadioButton components, you must group second component with first one, then third component with any component that is already grouped (first or second).
  * Then to detect selection changes add onChange(e => {console.log(e.value);}) to only one of the grouped RadioButton components, and e.value will be the value of currently selected RadioButton.
  * @class

package/classes/RadioButtonMenuItem.js

@@ -2,13 +2,13 @@
 import {MenuItem} from "./MenuItem.js";
 
 /**
- * Radio button menu item UI component that extends MenuItem class.
+ * Radio button menu item UI component.
+ *
+ * RadioButtonMenuItem is a component used to select one of multiple option by clicking on it. Multiple RadioButtonMenuItem components must be grouped for selection to work as expected. To group them pick one main RadioButtonMenuItem and group other RadioButtonMenuItem with it.
  *
- * RadioButton is a component used to select of multiple option by clicking on it.
- * Multiple RadioButton components must be grouped for selection to work as expected.
- * To group them pick one main RadioButtonMenuItem and group other RadioButtonMenuItem with it.
  * For example if you have three RadioButtonMenuItem components that you want to group, you must group second component with first one, then third component with any component that is already grouped (first or second).
- * Then to detect selection changes add onChange(e => {console.log(e.value);}) to only one of the grouped RadioButton components, and e.value will be the value of currently selected RadioButton.
+ *
+ * Then to detect selection changes add onChange(e => {console.log(e.value);}) to only one of the grouped RadioButton components, and e.value will be the value of currently selected RadioButton in the group.
  * See example below.
  *
  * @class

package/classes/Shape.js

@@ -57,6 +57,14 @@ export class Shape
 		this.#prop.y = Number.isFinite(y) ? y : 0;
 	}
 
+	/**
+	 * @internal
+	 */
+	setParent(p)
+	{
+		this.#prop.parent = p;
+	}
+
 	/**
 	 * Add this shape to a container.
 	 *

package/classes/ShapeContainer.js

@@ -52,15 +52,16 @@ export class ShapeContainer extends ComponentContainer
 				if(!(args[0][i] instanceof Shape)) throw new TypeError(`Invalid "shape" at index ${i} in the array argument passed to Panel.shapes(shapes).`);
 			});
 
-			const update = this.prop.update !== false;
-			if(update) this.update(false);
+			if(Array.isArray(this._shapes)) this._shapes.forEach(shape => shape.setParent(null) );
+			this._shapes = [...args[0]];
 
-			// remove existing shapes
-			for(let i = this._shapes.length - 1; i >= 0; i--) this._shapes[i].remove();
-
-			args[0].forEach(shape => shape.addTo(this));
+			const _objects = [];
+			this._shapes.forEach(shape => {
+				shape.setParent(this);
+				_objects.push(shape.toObject("all"));
+			});
 
-			if(update) this.update(true);
+			this.property('set_shapes', [_objects])
 		}
 
 		return this;
@@ -144,7 +145,7 @@ export class ShapeContainer extends ComponentContainer
 	 * Removes a specified Shape, then the removed Shape is returned.
 	 *
 	 * @param {number|Shape} index_or_shape - Shape or index of the Shape to be removed.
-	 * @return {Shape|boolean} Returns removed Shape, or `false` in case when index is invalid or out of bounds.
+	 * @return {Shape|null} Returns removed Shape, or `null` in case when index is invalid or out of bounds.
 	 * @see Shape#remove
 	 */
 	removeShape(index)
@@ -156,12 +157,12 @@ export class ShapeContainer extends ComponentContainer
 		{
 			shape = index;
 			index = this._shapes.indexOf(index);
-			if(index < 0) return false;
+			if(index < 0) return null;
 		}
 		else
 		{
 			shape = this._shapes[index];
-			if(shape === undefined) return false;
+			if(shape === undefined) return null;
 		}
 
 		if(shape.parent === this) // remove shape parent first, then come back

package/classes/Table.js

@@ -751,6 +751,36 @@ export class Table extends ScrollableComponent
 			return this.property("editingCell", [])
 		}
 	}
+
+	/**
+	 * Sets or gets how many quick mouse clicks on editable cells are required to change the cell to editing mode.
+	 *
+	 * @param {number} [clicks] - Amount of clicks: 1, 2, or 3. Default is 2 (double-click).
+	 * @return {number|Table} Returns the current value if no parameters are provided; otherwise, and instance of `this` Table is returned.
+	 */
+	clicksToEdit(...args)
+	{
+		if(args.length > 0)
+		{
+			// enforce int
+			args[0] = Math.max(1, Number.parseInt(args[0]));
+			if(!Number.isSafeInteger(args[0])) throw new TypeError(`Invalid Table.clickToEdit() argument. A positive integer is required.`);
+		}
+		return this.property("clicksToEdit", args);
+	}
+
+	/**
+	 * Sets or gets whether to allow row selection with a click of a right mouse button.
+	 *
+	 * @param {boolean} [enable] - Boolean value that enables or disables right-click row selection.
+	 * @return {boolean|List} Returns `this` component instance if at least one argument is provided, otherwise returns current value.
+	 * @since 1.1.0
+	 */
+	rightClickSelect(...args)
+	{
+		if(args.length > 0) args[0] = (args[0] === true); // ensure boolean
+		return this.property("rightClickSelect", arguments);
+	}
 	
 	/**
 	 * Sets or gets whether sorting can be toggled to unsorted state.
@@ -884,23 +914,6 @@ export class Table extends ScrollableComponent
 		return ui.sendToGUI({control: this.id, get: "cellAt", data: {x: x, y: y}});
 	}
 	
-	/**
-	 * Sets or gets how many quick mouse clicks on editable cells are required to change the cell to editing mode.
-	 *
-	 * @param {number} [clicks] - Amount of clicks: 1, 2, or 3. Default is 2 (double-click).
-	 * @return {number|Table} Returns the current value if no parameters are provided; otherwise, and instance of `this` Table is returned.
-	 */
-	clicksToEdit(...args)
-	{
-		if(args.length > 0)
-		{
-			// enforce int
-			args[0] = Math.max(1, Number.parseInt(args[0]));
-			if(!Number.isSafeInteger(args[0])) throw new TypeError(`Invalid Table.clickToEdit() argument. A positive integer is required.`);
-		}
-		return this.property("clicksToEdit", args);
-	}
-	
 	//endregion
 	
 	//region Events

package/classes/ToolBar.js

@@ -2,7 +2,7 @@
 import {ComponentContainer} from "./ComponentContainer.js";
 
 /**
- * A toolbar component that is usually used at the top of window and can hold {@link Label}, {@link Button}, {@link TextField}, {@link ComboBox}, and a {@link Separator} to display useful tools for a user.
+ * A toolbar component that is usually used at the top of window and can hold {@link Label}, {@link Button}, {@link TextField}, {@link PasswordField}, {@link Spinner}, {@link ComboBox}, {@link CheckBox}, {@link RadioButton} and a {@link Separator} to display useful tools for a user.
  *
  * Toolbar can be draggable and can be detached and displayed in a separate dedicated window. It can also be in horizontal (default) and vertical orientation.
  *
@@ -57,7 +57,7 @@ export class ToolBar extends ComponentContainer
 	{
 		return this.property("orientation", args);
 	}
-	
+
 	/**
 	 * Sets or gets a padding size between edge of the component and items inside it, and spacing between items.
 	 *

package/classes/Tree.js

@@ -491,6 +491,18 @@ export class Tree extends ScrollableComponent
 		return this.property("clicksToEdit", args.length > 0 ? [parseInt(args[0])] : args);
 	}
 
+	/**
+	 * Sets or gets whether to allow selecting list items with a click of a right mouse button.
+	 * @param {boolean} [enable] - Boolean value that enables or disables right-click item selection.
+	 * @return {boolean|List} Returns `this` component instance if at least one argument is provided, otherwise returns current value.
+	 * @since 1.1.0
+	 */
+	rightClickSelect(...args)
+	{
+		if(args.length > 0) args[0] = (args[0] === true); // ensure boolean
+		return this.property("rightClickSelect", arguments);
+	}
+
 	/**
 	 * Sets or gets whether Tree nodes' text can be edited by user.
 	 *

package/classes/Window.js

@@ -26,7 +26,8 @@ class Window extends ShapeContainer
 	#owner = null; // used only for modal window
 	#prop = {
 		closeOperation: Window.CloseOperation.Exit,
-		innerOffset: null
+		innerOffset: null,
+		toolBar:{}
 	};
 
 	/**
@@ -604,6 +605,46 @@ class Window extends ShapeContainer
 		return this.property("opacity", args);
 	}
 
+	/**
+	 * Sets a ToolBar to one of locations: `top`, `right`, `bottom` and `left`, or gets a ToolBar at a specified location.
+	 *
+	 * @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.
+	 * @since 1.0.8
+	 */
+	toolBar(dockLocation, toolbar = undefined)
+	{
+		if(typeof dockLocation !== "string")
+		{
+			return null;
+		}
+		else if(toolbar === undefined) // gets toolbar
+		{
+			const id = ui.sendToGUI({control: this.id, get: "toolBar", data: dockLocation});
+
+			return id === -1 ? null : UIComponent.get(id) ?? null; // in case it was destroyed already
+		}
+		else if(toolbar === null)
+		{
+			if(this.#prop.toolBar[dockLocation] instanceof ToolBar)
+			{
+				this.property("toolBar", [{id: null, location: dockLocation}])
+				delete this.#prop.toolBar[dockLocation];
+			}
+		}
+		if(toolbar instanceof ToolBar) // sets toolbar
+		{
+			if("top right bottom left".includes(dockLocation))
+			{
+				if(this.#prop.toolBar[dockLocation] instanceof ToolBar) this.property("toolBar", [{id: null, location: dockLocation}])
+				this.#prop.toolBar[dockLocation] = toolbar;
+
+				this.property("toolBar", [{id: toolbar.id, location: dockLocation}])
+			}
+		}
+		return this;
+	}
 }
 
 export {Window};

package/functions.js

@@ -119,7 +119,7 @@ export function stringify(variable)
 }
 
 /**
- * Displays a dialog window with a specified error message and an error icon.
+ * Displays a dialog window with a specified message and optional icon.
  *
  * @param {string} message - A message to be displayed in the dialog window
  * @param {string} [title="Message"] - Dialog window title bar text

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "swing-ui",
-	"version": "1.0.7",
+	"version": "1.1.1",
 	"description": "Cross-platform Graphic User Interface for Node.js, Bun and Deno 2+",
 	"main": "index.js",
 	"scripts": {

package/types/SwingUI.d.ts

@@ -13,66 +13,6 @@
  * ui.openURL("http://swing-ui.com/");
  */
 export class SwingUI {
-    /**
-     * @internal
-     * @private
-     */
-    private static WorkerSignalIndex;
-    /**
-     * @internal
-     * @private
-     */
-    private static WorkerSignal;
-    /**
-     * <b>NOTE:</b> Do not instantiate this class. It's already instantiated and assigned to a global variable `ui`.
-     * @internal
-     * @private
-     */
-    private constructor();
-    /**
-     * @internal
-     * @private
-     */
-    private stats;
-    /**
-     * @internal
-     * @private
-     */
-    private gui_process_id;
-    /**
-     * @internal
-     * @private
-     */
-    private callback;
-    /**
-     * @internal
-     * @private
-     */
-    private _msg;
-    InitGUIProcess(): Promise<void>;
-    /**
-     * Send a messages to GUI process via STD out. Use internally for communication only.
-     * @param {Object} msg - JSON Object message to send to GUI.
-     * @param {function(any):any} [callback] - Only pass callback to block event loop and wait for response
-     * @return {any|void} Returns response from GUI or undefined.
-     * @internal
-     * @ignore
-     */
-    sendToGUI(msg: Object, callback?: (arg0: any) => any): any | void;
-    /**
-     * Immediately sends all queued messages to GUI without waiting for queue threshold or execution end. It's similar to flush() function in data streams.
-     * It can be used to force messages to be sent imedietly instead of waiting for message queue to be full, if it's important to update some UI component or content right away.
-     * It may improve performance to set `compress` to `false` to skip compression for already compressed data, such as UI component's background image or large icon.
-     *
-     * @param {boolean} [compress=true] - Whether to compress messages before sending.
-     * @return {this} Returns `this` instance for chaining.
-     * @example <h2>Sending queued messages before proceeding:</h2>
-     * ui.sendMessageQueue();
-     *
-     * @example <h2>Sending queued messages without compressing:</h2>
-     * ui.sendMessageQueue(false);
-     */
-    sendMessageQueue(compress?: boolean): this;
     /**
      * Returns a detected or specified application root directory.
      *
@@ -101,10 +41,66 @@ export class SwingUI {
      * Getter property that returns an array of available UI look and feel IDs on your system. For example Windows OS can have a Windows look and feel that linux doesn't have. Use them to set the desired look and feel using ui.ui(id) method.
      *
      * @readonly
-     * @see {@link SwingUI#ui|ui.ui(id)}
-     * @type {string[]}
+     * @see SwingUI#ui
+     * @type {object[]}
+     * @example <h2>Example of a returned array</h2>
+     * [
+     *   {
+     *     "name": "Default",
+     *     "id": "MetalLookAndFeel"
+     *   },
+     *   {
+     *     "name": "OS",
+     *     "id": "WindowsLookAndFeel"
+     *   },
+     *   {
+     *     "name": "Metal",
+     *     "dark": false,
+     *     "id": "MetalLookAndFeel"
+     *   },
+     *   {
+     *     "name": "Nimbus",
+     *     "dark": false,
+     *     "id": "NimbusLookAndFeel"
+     *   },
+     *   {
+     *     "name": "CDE/Motif",
+     *     "dark": false,
+     *     "id": "MotifLookAndFeel"
+     *   },
+     *   {
+     *     "name": "Windows",
+     *     "dark": false,
+     *     "id": "WindowsLookAndFeel"
+     *   },
+     *   {
+     *     "name": "Windows Classic",
+     *     "dark": false,
+     *     "id": "WindowsClassicLookAndFeel"
+     *   },
+     *   {
+     *     "name": "FlatLaf Light",
+     *     "dark": false,
+     *     "id": "FlatLightLaf"
+     *   },
+     *   {
+     *     "name": "FlatLaf Dark",
+     *     "dark": true,
+     *     "id": "FlatDarkLaf"
+     *   },
+     *   {
+     *     "name": "FlatLaf IntelliJ",
+     *     "dark": false,
+     *     "id": "FlatIntelliJLaf"
+     *   },
+     *   {
+     *     "name": "FlatLaf Darcula",
+     *     "dark": true,
+     *     "id": "FlatDarculaLaf"
+     *   }
+     * ]
      */
-    readonly get list(): string[];
+    readonly get list(): object[];
     /**
      * Returns an array of screen objects [{x,y,width,height}] that are configured on this computer. X and Y is the position of screens relative to one virtual screen. It's useful when you have multiple screens.
      *
@@ -150,7 +146,7 @@ export class SwingUI {
      */
     readonly get systemTraySupported(): boolean;
     /**
-     * Gets a GUI software license information stored in the package.json file of your project.
+     * Gets a swing-ui software license information including the path on your file system where the license is stored.
      *
      * @readonly
      * @type {Object}
@@ -281,7 +277,9 @@ export class SwingUI {
      * @return {string|SwingUI} When setting arguments, `this` instance of SwingUI is returned, otherwise current value is returned.
      * @throws Error When argument is invalid.
      * @see SwingUI#list
-     * @example <h2>Setting FlatDarkLaf UI with all options</h2>
+     * @example <h2>Setting System's UI Theme</h2>
+     * ui.ui(ui.list.find(t => t.name === "OS").id);
+     * @example <h2>Setting FlatDarkLaf UI theme with all options</h2>
      * ui.ui(
      *   "FlatDarkLaf",
      *   {
@@ -731,5 +729,16 @@ export class SwingUI {
      * @see SwingUI#exit
      */
     onExit(callback?: (arg0: Object) => any | null | undefined, remove?: boolean): SwingUI | Function[];
+    /**
+     * Registers, unregisters and retrieves event handler for event emitted by changes to screens on the computer, such as connecting a screen, disconnecting a screen, or changes to screen resolution.
+     *
+     * @param {function(Object):any|null|undefined} [callback] - Function to handle the event, `null` to remove all handlers, or omit to retrieve an array of handlers.
+     * @param {boolean} remove - Removed the callback from this event
+     * @return {SwingUI|function[]} If called without parameters, an array of registered callbacks is returned; otherwise `this` instance of SwingUI class is returned.
+     * @example <h2>Registering screens change event handler:</h2>
+     * ui.onScreensChange(e => {console.log(e.screens});
+     * @see ui#screens
+     */
+    onScreensChange(callback?: (arg0: Object) => any | null | undefined, remove?: boolean): SwingUI | Function[];
     #private;
 }

package/types/classes/ComponentContainer.d.ts

@@ -6,30 +6,6 @@
  * @global
  */
 export class ComponentContainer extends UIComponent {
-    static preInitProperties: string[];
-    static postInitProperties: string[];
-    /**
-     * ComponentContainer constructor.
-     * @internal
-     * @ignore
-     */
-    constructor(...args: any[]);
-    /**
-     * Loads UI Components and properties from UI designer file FILE_NAME.ui.json where FILE_NAME is the name of JavaScript file of the component.
-     *
-     * @param {string} class_name - Class name for which to load UI
-     * @private
-     * @ignore
-     */
-    private _applyUIDefinition;
-    /**
-     * @private
-     */
-    private _applyComponentPropertiesV1_0;
-    /**
-     * @private
-     */
-    private _buildComponentResources;
     /**
      * Gets an array of child components.
      *

package/types/classes/RadioButton.d.ts

@@ -1,7 +1,8 @@
 /**
- * RadioButton is a component used to select of multiple option by clicking on it.
- * Multiple RadioButton components must be grouped for selection to work.
- * To group them pick one main RadioButton and group other RadioButton components with it.
+ * RadioButton is a component used to select one of multiple option by clicking on it.
+ *
+ * Multiple RadioButton components must be grouped for selection to work. To group them pick one main RadioButton and group other RadioButton components with it.
+ *
  * For example if you have three RadioButton components, you must group second component with first one, then third component with any component that is already grouped (first or second).
  * Then to detect selection changes add onChange(e => {console.log(e.value);}) to only one of the grouped RadioButton components, and e.value will be the value of currently selected RadioButton.
  * @class

package/types/classes/RadioButtonMenuItem.d.ts

@@ -1,11 +1,11 @@
 /**
- * Radio button menu item UI component that extends MenuItem class.
+ * Radio button menu item UI component.
+ *
+ * RadioButtonMenuItem is a component used to select one of multiple option by clicking on it. Multiple RadioButtonMenuItem components must be grouped for selection to work as expected. To group them pick one main RadioButtonMenuItem and group other RadioButtonMenuItem with it.
  *
- * RadioButton is a component used to select of multiple option by clicking on it.
- * Multiple RadioButton components must be grouped for selection to work as expected.
- * To group them pick one main RadioButtonMenuItem and group other RadioButtonMenuItem with it.
  * For example if you have three RadioButtonMenuItem components that you want to group, you must group second component with first one, then third component with any component that is already grouped (first or second).
- * Then to detect selection changes add onChange(e => {console.log(e.value);}) to only one of the grouped RadioButton components, and e.value will be the value of currently selected RadioButton.
+ *
+ * Then to detect selection changes add onChange(e => {console.log(e.value);}) to only one of the grouped RadioButton components, and e.value will be the value of currently selected RadioButton in the group.
  * See example below.
  *
  * @class

package/types/classes/ScrollableComponent.d.ts

@@ -6,12 +6,6 @@
  * @global
  */
 export class ScrollableComponent extends UIComponent {
-    /**
-     * ScrollableComponent constructor.
-     * @internal
-     * @ignore
-     */
-    constructor(...args: any[]);
     /**
      * Sets or gets scroll bars visibility for horizontal and vertical scroll bars.
      *

package/types/classes/Shape.d.ts

@@ -70,15 +70,6 @@ export class Shape {
      * @return {Shape} Returns this `Shape` for method chaining.
      */
     toObject(include?: string): Shape;
-    /**
-     * Updates properties of this Shape. It's called by other methods of Shape object when shape properties change.
-     *
-     * @param {string|boolean} [what="all"] - What to update: "all", "min", "stroke", "background", "points". Shapes that derive from this class may also have their own values. Pass a `boolean` to enable and disable this shape redraw. Before making multiple changes to the Shape it helps to disable redraw, make the changes, then enable redraw.
-     * @returns {void}
-     * @internal
-     * @ignore
-     */
-    update(what?: string | boolean): void;
     /**
      * Sets or gets location of the shape relative to top-left corner of its parent component.
      *

package/types/classes/ShapeContainer.d.ts

@@ -20,7 +20,8 @@ export class ShapeContainer extends ComponentContainer {
      * @throws {TypeError} When one of passed array elements is not of Shape type.
      * @see Shape
      */
-    shapes(...args: any[]): this | any[];
+    shapes(...args: any[]): any[] | this;
+    _shapes: any[] | undefined;
     /**
      * Gets a Shape at a specified index.
      *
@@ -51,15 +52,10 @@ export class ShapeContainer extends ComponentContainer {
      * Removes a specified Shape, then the removed Shape is returned.
      *
      * @param {number|Shape} index_or_shape - Shape or index of the Shape to be removed.
-     * @return {Shape|boolean} Returns removed Shape, or `false` in case when index is invalid or out of bounds.
+     * @return {Shape|null} Returns removed Shape, or `null` in case when index is invalid or out of bounds.
      * @see Shape#remove
      */
-    removeShape(index: any): Shape | boolean;
-    /**
-     * @internal
-     * @ignore
-     */
-    verifyToken(token: any): boolean;
+    removeShape(index: any): Shape | null;
     /**
      * Registers, unregisters and gets a list of handler functions for Shape events (such as when mouse enters, leaves, mouse button clicks, etc.).
      *

package/types/classes/Table.d.ts

@@ -486,6 +486,21 @@ export class Table extends ScrollableComponent {
      * const _rows = table.rows(); // read new data
      */
     editingCell(...args: any[]): TableCell | null | Table;
+    /**
+     * Sets or gets how many quick mouse clicks on editable cells are required to change the cell to editing mode.
+     *
+     * @param {number} [clicks] - Amount of clicks: 1, 2, or 3. Default is 2 (double-click).
+     * @return {number|Table} Returns the current value if no parameters are provided; otherwise, and instance of `this` Table is returned.
+     */
+    clicksToEdit(...args: any[]): number | Table;
+    /**
+     * Sets or gets whether to allow row selection with a click of a right mouse button.
+     *
+     * @param {boolean} [enable] - Boolean value that enables or disables right-click row selection.
+     * @return {boolean|List} Returns `this` component instance if at least one argument is provided, otherwise returns current value.
+     * @since 1.1.0
+     */
+    rightClickSelect(...args: any[]): boolean | List;
     /**
      * Sets or gets whether sorting can be toggled to unsorted state.
      *
@@ -580,13 +595,6 @@ export class Table extends ScrollableComponent {
      * @return {TableCell|null} Returns the cell at specified location, or `null` if the coordinates are outside any cell.
      */
     cellAt(x: number, y: number): TableCell | null;
-    /**
-     * Sets or gets how many quick mouse clicks on editable cells are required to change the cell to editing mode.
-     *
-     * @param {number} [clicks] - Amount of clicks: 1, 2, or 3. Default is 2 (double-click).
-     * @return {number|Table} Returns the current value if no parameters are provided; otherwise, and instance of `this` Table is returned.
-     */
-    clicksToEdit(...args: any[]): number | Table;
     /**
      * Gets, registers or unregisters a column event handler function. This event handler is called when a column is inserted, removed, resized, or moved (reordered).
      *

package/types/classes/TextArea.d.ts

@@ -23,16 +23,6 @@ export class TextArea extends TextComponent {
      * textarea.text("New Text", TextAction.ReplaceSelection); // Replaces selected text or inserts at current cursor position if no text is selected
      */
     text(text?: string, action?: TextAction, i?: undefined, ...args: any[]): string | TextArea;
-    /**
-     * @internal
-     * @ignore
-     */
-    rows(...args: any[]): any;
-    /**
-     * @internal
-     * @ignore
-     */
-    columns(...args: any[]): any;
     /**
      * Sets or gets line wrapping mode. Line wrapping helps to display long lines without having to scroll horizontally.
      *

package/types/classes/TextComponent.d.ts

@@ -6,12 +6,6 @@
  * @global
  */
 export class TextComponent extends UIComponent {
-    /**
-     * TextComponent constructor.
-     * @internal
-     * @ignore
-     */
-    constructor(...args: any[]);
     /**
      * Sets or gets whether component's text can be edited by user typing. Applies to components such as TextField, TextArea, DocumentEditor, ComboBox, Password, Spinner, Tree (to edit list item).
      *

package/types/classes/ToolBar.d.ts

@@ -1,5 +1,5 @@
 /**
- * A toolbar component that is usually used at the top of window and can hold {@link Label}, {@link Button}, {@link TextField}, {@link ComboBox}, and a {@link Separator} to display useful tools for a user.
+ * A toolbar component that is usually used at the top of window and can hold {@link Label}, {@link Button}, {@link TextField}, {@link PasswordField}, {@link Spinner}, {@link ComboBox}, {@link CheckBox}, {@link RadioButton} and a {@link Separator} to display useful tools for a user.
  *
  * Toolbar can be draggable and can be detached and displayed in a separate dedicated window. It can also be in horizontal (default) and vertical orientation.
  *

package/types/classes/Tree.d.ts

@@ -296,6 +296,13 @@ export class Tree extends ScrollableComponent {
      * @see Tree#editable
      */
     clicksToEdit(...args: any[]): number | Tree;
+    /**
+     * Sets or gets whether to allow selecting list items with a click of a right mouse button.
+     * @param {boolean} [enable] - Boolean value that enables or disables right-click item selection.
+     * @return {boolean|List} Returns `this` component instance if at least one argument is provided, otherwise returns current value.
+     * @since 1.1.0
+     */
+    rightClickSelect(...args: any[]): boolean | List;
     /**
      * Sets or gets whether Tree nodes' text can be edited by user.
      *

package/types/classes/UIComponent.d.ts

@@ -8,30 +8,6 @@ export class UIComponent {
     static "__#1@#controls_id": number;
     static "__#1@#_freed_ids": any[];
     static "__#1@#_components": any[];
-    /**
-     * This is used to be notified when the component loses all references to it, to notify SwingUI to destroy the component for garbage collection
-     * @private
-     */
-    private static "__#1@#refRegistry";
-    /**
-     * Makes one class implements methods, setters, and getters of another class.
-     * @param toClass
-     * @param fromClass
-     * @throws {Error} When one or more parameters are `null`.
-     * @internal
-     * @ignore
-     */
-    static implementClass(toClass: any, fromClass: any): void;
-    /**
-     * Removes references to UI component with provided ID. Make sure to destroy  all other references to the component to truly destroy it to free RAM.
-     *
-     * @internal
-     * @ignore
-     * @private
-     * @param {number} id - ID of a component to be destroyed
-     * @return {void} Doesn't return a value
-     */
-    private static destroy;
     /**
      * Get UI component by ID.
      *
@@ -39,49 +15,11 @@ export class UIComponent {
      * @return {any|undefined} Returns UI component or `undefined` if there is no valid component with specified ID.
      */
     static get(id: number): any | undefined;
-    /**
-     * Returns last visible non-PopUp Window or null if no Window component is not found.
-     *
-     * @internal
-     * @static
-     * @readonly
-     * @returns {Window|null} Returns Window component or null.
-     */
-    static readonly getVisibleWindow(): Window | null;
-    /**
-     * Not to be instantiated by itself. This call is extended dby other UI components.
-     *
-     * @param {string} type - Component type.
-     * @param {boolean} leaf - `true` if the UI component was not extended by a custom class.
-     * @param {...any} [data] - Additional component init data (used by some UI components).
-     * @internal
-     * @ignore
-     */
-    constructor(type: string, leaf: boolean, ...data?: any[]);
     parent_id: null;
     callback: {
         onError: ((e: any) => any)[];
         onRectangleUpdate: ((e: any) => void)[];
     };
-    /**
-     * Locks methods from being overwritten or deleted.
-     * @param {Function} prototype_class
-     * @ignore
-     * @internal
-     */
-    finalize(..._classes: any[]): void;
-    /**
-     * @internal
-     * @ignore
-     */
-    isFinalized(methodName: any): boolean;
-    /**
-     * @internal
-     * @readonly
-     * @ignore
-     * @type {object}
-     */
-    readonly get prop(): object;
     /**
      * Returns a unique ID of the component. ID is reusable, so one component may have an ID of a previously destroyed component.
      * @readonly
@@ -254,33 +192,6 @@ export class UIComponent {
      * textfield.text("New Text", TextAction.ReplaceSelection); // Replaces selected text or inserts at current cursor position if no text is selected (applies only to text editing components, like TextField, TextArea, ...).
      */
     text(...args: any[]): string | this;
-    /**
-     * @internal
-     * @ignore
-     * @param {string} property
-     * @param {any} value
-     * @return {any}
-     */
-    property(property: string, ...args: any[]): any;
-    /**
-     * Registers, unregisters, and gets an event handler callback function for a specified events.
-     *
-     *  - component.event(name, function, true); // unregisters one callback function (even if the same callback was registered multiple times)
-     *  - component.event(name, function); // registers callback to be called when the event is emitted
-     *  - component.event(name); // returns all callback functions for specified event
-     *
-     * @param {string} name - Name of event
-     * @param {function(Object):any|null} [callback=undefined] - Callback function. Pass `null` to unregister all handler functions.
-     * @param {boolean} [remove=false] - Set to true to unregister the callback function.
-     * @return {Function[]|this} If only the `name` argument is provided, returns an array of registered callback functions. Otherwise, returns `this` component.
-     * @internal
-     * @ignore
-     * @example
-     * const _callbacks_array = button.event("onAction"); // gets an array of previously registered handler functions
-     * button.event("onAction", _callbacks_array[0], true); // unregisters callback function, same as button.onAction(_callbacks_array[0], true);
-     * button.event("onAction", e => {console.debug(e);}); // registers new event handler function, same as button.onAction(e => {console.debug(e);});
-     */
-    event(name: string, callback?: (arg0: Object) => any | null, remove?: boolean): Function[] | this;
     /**
      * Sets or gets the background color of the component. <br />
      * <br />

package/types/classes/Window.d.ts

@@ -329,6 +329,15 @@ export class Window extends ShapeContainer {
      * @return {number|this} If `opacity` argument is provided, `this` component is returned, otherwise opacity `number` is returned.
      */
     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.
+     *
+     * @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.
+     * @since 1.0.8
+     */
+    toolBar(dockLocation: string, toolbar?: ToolBar): ToolBar | null | Window;
     #private;
 }
 import { ShapeContainer } from "./ShapeContainer.js";

package/types/functions.d.ts

@@ -24,17 +24,7 @@
  */
 export function error(message: string | Error, show_stack_trace?: boolean | Error): void;
 /**
- * Returns a text representation of passed variable. Similar to JSON.stringify().
- *
- * @internal
- * @ignore
- * @global
- * @param {any} variable - Any variable to be converted to a string representation
- * @return {string} Serialized object as a String
- */
-export function stringify(variable: any): string;
-/**
- * Displays a dialog window with a specified error message and an error icon.
+ * Displays a dialog window with a specified message and optional icon.
  *
  * @param {string} message - A message to be displayed in the dialog window
  * @param {string} [title="Message"] - Dialog window title bar text