swing-ui 1.0.5 → 1.0.7

package/README.md

@@ -67,7 +67,7 @@ If you've shipped a desktop app in JS before, you've probably lived one of these
 npm install swing-ui
 ```
 
-> Install it locally in each project — not with `-g`.
+> Install it locally in each project — not with `-g` option.
 
 ```js
 import "swing-ui";
@@ -117,7 +117,7 @@ That's just a taste. Tables, trees, tabs, menus, system tray icons, custom drawi
 - Financial software with graphical graphs and charts
 - and much more...
 
-Anywhere you want a real desktop app without the weight of a browser runtime, and without leaving JavaScript to get it. With thousands or JavaScript modules now almost anything is possible in JavaScript.
+Anywhere you want a real desktop app without the weight of a browser runtime, and without leaving JavaScript to get it. With thousands of JavaScript modules now almost anything is possible in JavaScript.
 
 ---
 

package/SwingUI.js

@@ -892,7 +892,7 @@ export class SwingUI
 	 */
 	get os()
 	{
-		let os = "";
+		let os;
 
 		if(this.runtime === "deno")
 		{
@@ -1162,13 +1162,13 @@ export class SwingUI
 	 * data[DataType.HTML] = "<b>HTML Content</b>";
 	 * ui.clipboard(data);
 	 */
-	clipboard()
+	clipboard(...args)
 	{
-		if(arguments.length > 0)
+		if(args.length > 0)
 		{
 			this.sendToGUI({
 				system: "clipboard",
-				value: (typeof arguments[0] === "string") ? {Text: arguments[0]} : arguments[0]
+				value: (typeof args[0] === "string") ? {Text: args[0]} : args[0]
 			});
 			return this;
 		}
@@ -1250,6 +1250,7 @@ export class SwingUI
 	 *
 	 * @param {boolean} enabled - `true` to enable double-buffering (default), `false` to disable.
 	 * @return {SwingUI|boolean} When setting a value, an instance of this `ui` object is returned, otherwise a current value is returned.
+	 * @since 1.0.5
 	 */
 	doubleBuffer(...args)
 	{

package/classes/Arc.js

@@ -182,4 +182,4 @@ export class Arc extends Shape
 		
 		return obj;
 	}
-}
+}

package/classes/ComponentContainer.js

@@ -129,7 +129,7 @@ export class ComponentContainer extends UIComponent
 	 * In loops `for..in`, `for..of` or `component.children.forEach((c, i)=>{...})` it's accessed only once, so you are looping through the same array.
 	 *
 	 * @readonly
-	 * @type {Object[]}
+	 * @type {UIComponent[]}
 	 * @example <h2>Looping through Window's components</h2>
 	 * // method 1
 	 * for(child of window.children)
@@ -181,7 +181,7 @@ export class ComponentContainer extends UIComponent
 	/**
 	 * Gets or sets the index of a child component within this container. Setting new index changes z-order of the component.
 	 *
-	 * @param {Object} child - Child component
+	 * @param {UIComponent} child - Child component
 	 * @param {number} [new_index] - The new index to assign to the child. Moves the component in z-order.
 	 * @return {this|null|number} If `new_index` is provided, returns `this` component. If the child is not found in this container, returns `null`. Otherwise, returns the child's current z-index.
 	 */
@@ -213,7 +213,7 @@ export class ComponentContainer extends UIComponent
 	/**
 	 * Adds a child component to this container component.
 	 *
-	 * @param {object} component - UI Component that can be a child of this component.
+	 * @param {UIComponent} component - UI Component that can be a child of this component.
 	 * @param {number|object} [data_or_index] - Argument to pass some extra data (such as Tab Name to add Panel to Tabs), or index at which to insert the child. By default component is added to the end.
 	 * @returns {this} Returns an instance of `this` component for chaining.
 	 * @see UIComponent#addTo
@@ -319,7 +319,7 @@ export class ComponentContainer extends UIComponent
 	/**
 	 * Removes component's child by child object or child index.
 	 *
-	 * @param {object|number} child_or_index - Child component object or index of the child.
+	 * @param {UIComponent|number} child_or_index - Child component object or index of the child.
 	 * @param {boolean} [recursive=false] - Boolean indicates if all descendents of this child should also be removed.
 	 * @returns {UIComponent|null} The removed child component, or `null` if there is no child at specified index.
 	 */
@@ -366,11 +366,11 @@ export class ComponentContainer extends UIComponent
 	 * @param {boolean} [recursive=false] - Set to true to also destroy all of its descendants recursively
 	 * @returns {void}
 	 */
-	destroy(...args)
+	destroy(recursive=false)
 	{
 		if(this.destroyed) return;
 
-		const recursive = (args.length > 0 && args[0] === true);
+		recursive = (recursive === true);
 
 		// remove all child components, from last to first (IMPORTANT)
 		for(let i = this.#_children.length - 1; i >= 0; i--)
@@ -389,13 +389,13 @@ export class ComponentContainer extends UIComponent
 			{error(ex);}
 		}
 
-		super.destroy(...args);
+		super.destroy(recursive);
 	}
 
 	/**
 	 * Checks if passed component is a descendant of this container component.
 	 *
-	 * @param descendant - Child component to check.
+	 * @param {UIComponent} descendant - Child component to check.
 	 * @returns {boolean} If the descendant component is inside of this component.
 	 * @throws {TypeError} When passed argument is not an instance of UIComponent.
 	 * @see UIComponent#insideOf
@@ -821,7 +821,7 @@ export class ComponentContainer extends UIComponent
 		{
 			if(!(event in component))
 			{
-				error(`${class_name}.${event} is not valid event function for ${class_name} in your .ui.json file:\n\n${common.ui_file}`, false);
+				error(`${class_name}.${event} is not a valid event function for ${class_name} in your .ui.json file:\n\n${common.ui_file}`, false);
 				continue;
 			}
 

package/classes/ContextMenu.js

@@ -103,7 +103,7 @@ export class ContextMenu extends ComponentContainer
 	/**
 	 * Adds this ContextMenu to a specified parent component.
 	 *
-	 * @param {object} parent - A valid component that accepts ContextMenu. `parent` must be derived from UIComponent.
+	 * @param {ComponentContainer} parent - A valid component that accepts ContextMenu. `parent` must be derived from UIComponent.
 	 * @return {ContextMenu} Returns an instance of `this` object.
 	 */
 	addTo(parent, ...args)

package/classes/ScrollPane.js

@@ -38,7 +38,7 @@ class ScrollPane extends ComponentContainer
 	/**
 	 * Adds a child component to this container component.
 	 *
-	 * @param {Object} component - UI Component that can be a child of this component.
+	 * @param {UIComponent} component - UI Component that can be a child of this component.
 	 * @returns {this} Returns an instance of `this` component.
 	 */
 	addChild(component, ...data)

package/classes/Table.js

@@ -707,15 +707,16 @@ export class Table extends ScrollableComponent
 	/**
 	 * Sets or gets a row and a column of selected cell.
 	 *
-	 * @param {number} [row] - Row of a cell. (Original order is used, sorting is disregarded.)
+	 * @param {number|TableCell} [row_or_cell] - Row or a TableCell object. (Original order is used, sorting is disregarded.)
 	 * @param {number} [column] - Column of a cell (required if row is specified). (Original order is used, column reordering is disregarded.)
-	 * @return {number[]|Table} When both `row` and `cell` are passed, an instance of `this` Table is returned, otherwise a currently selected row and column is returned as an array of integers [row, column], or NULL if there is no selection.
+	 * @return {TableCell|Table} When both `row` and `cell` are passed, an instance of `this` Table is returned, otherwise a currently selected `TableCell` object is returned, or NULL if there is no selection.
 	 */
 	selectedCell(...args)
 	{
-		if(args.length > 1)
+		if(args.length > 0)
 		{
-			return this.property("selectedCell", [{row: parseInt(args[0]), col: parseInt(args[1])}]);
+			const cell = (typeof args[0] === "object") ? args[0] : {row: parseInt(args[0]), col: parseInt(args[1])};
+			return this.property("selectedCell", [cell]);
 		}
 		else
 		{
@@ -729,21 +730,20 @@ export class Table extends ScrollableComponent
 	 * Pass `null` as a first argument to stop editing currently edited cell. Do it before reading data from the Table to make sure the cell editor commits it's new value to the Table's data.
 	 * When called with no arguments, returns the cell currently being edited, or `null` if no cell is being edited.
 	 *
-	 * @param {number} [row] - Row index of the cell to edit, or `null` to stop editing currently edited cell (if any).
+	 * @param {number|TableCell} [row_or_cell] - Row index of the cell or a TableCell object to edit, or `null` to stop editing currently edited cell (if any).
 	 * @param {number} [column] - Column index of the cell to edit.
 	 * @param {boolean} [new_order=false] - Specified if row and column should be interpreted as new index as displayed (after row sorting and column reordering) or not.
-	 * @return {Cell|null|Table} When row and cell is specified, an instance of `this` Table is returned, otherwise a currently edited cell is retuned of `null` if no cell is being edited.
+	 * @return {TableCell|null|Table} When row and cell is specified, an instance of `this` Table is returned, otherwise a currently edited cell is retuned of `null` if no cell is being edited.
 	 * @example <h2>Stop editing before reading Table data</h2>
 	 * if(table.editingCell() != null) table.editingCell(null); // stop editing a cell to commit its changes
 	 * const _rows = table.rows(); // read new data
 	 */
 	editingCell(...args)
 	{
-		let msg = {control: this.id};
-
 		if(args.length > 0)
 		{
-			ui.sendToGUI({control:this.id, set: "editingCell", value: args[0] == null ? null : [parseInt(args[0]), parseInt(args[1])], data: {new_order: (args[2] === true)}});
+			const cell = args[0] == null ? null : (typeof args[0] === "object") ? args[0] : {row: parseInt(args[0]), col: parseInt(args[1])};
+			ui.sendToGUI({control:this.id, set: "editingCell", value: cell, data: {new_order: (args[2] === true)}});
 			return this;
 		}
 		else
@@ -873,11 +873,11 @@ export class Table extends ScrollableComponent
 	}
 	
 	/**
-	 * Gets a cell [row,column] located at specified X and Y coordinates relative to the Table's top-left corner.
+	 * Gets a TableCell {row,column} located at specified X and Y coordinates relative to the Table's top-left corner.
 	 *
 	 * @param {number} x - X
 	 * @param {number} y - Y
-	 * @return {Cell|null} Returns the cell, or `null` if the coordinates are outside any cell.
+	 * @return {TableCell|null} Returns the cell at specified location, or `null` if the coordinates are outside any cell.
 	 */
 	cellAt(x, y)
 	{

package/classes/UIComponent.js

@@ -267,7 +267,7 @@ class UIComponent
 	 * Gets a previous sibling component. If this component wasn't added to any container component, then `null` is returned.
 	 * @readonly
 	 * @type {UIComponent|null}
-	 * @since 1.0.3
+	 * @since 1.0.2
 	 */
 	get previousSibling()
 	{
@@ -281,7 +281,7 @@ class UIComponent
 	 * Gets a next sibling component. If this component wasn't added to any container component, then `null` is returned.
 	 * @readonly
 	 * @type {UIComponent|null}
-	 * @since 1.0.3
+	 * @since 1.0.2
 	 */
 	get nextSibling()
 	{
@@ -294,7 +294,7 @@ class UIComponent
 	 * Gets an array of sibling components.
 	 * @readonly
 	 * @type {UIComponent[]}
-	 * @since 1.0.3
+	 * @since 1.0.2
 	 */
 	get siblings()
 	{
@@ -399,7 +399,7 @@ class UIComponent
 	 * @param {boolean} [recursive=false] - Set to true to also destroy all of its descendants recursively
 	 * @returns {void}
 	 */
-	destroy(...args)
+	destroy(recursive=false)
 	{
 		if(this.destroyed) return;
 
@@ -445,7 +445,7 @@ class UIComponent
 
 	/**
 	 * Checks if this component is inside specified ancestor component (at any level, not just direct child).
-	 * @param {UIComponent} ancestor - Ancestor component to test against
+	 * @param {Object} ancestor - Ancestor component to test against
 	 * @return {boolean}
 	 * @see ComponentContainer#contains
 	 */
@@ -662,7 +662,6 @@ class UIComponent
 	/**
 	 * @internal
 	 * @ignore
-	 * @private
 	 * @param {string} property
 	 * @param {any} value
 	 * @return {any}
@@ -697,7 +696,6 @@ class UIComponent
 	 * @return {Function[]|this} If only the `name` argument is provided, returns an array of registered callback functions. Otherwise, returns `this` component.
 	 * @internal
 	 * @ignore
-	 * @private
 	 * @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);
@@ -1175,7 +1173,6 @@ class UIComponent
 			if(this === menu || typeof menu !== "object" || !(menu instanceof globalThis.ContextMenu)) // can't use !(menu instanceof ContextMenu) because ContextMenu imports this class, thus would create circular import.
 			{
 				throw new Error(ui._msg[10]);
-				return this;
 			}
 
 			if(this.#context_menu != null) this.contextMenu(null); // remove existing menu before setting a new one

package/functions.js

@@ -212,10 +212,10 @@ export function confirm(message, window = null)
  *
  * @param {string} message - String message to user. It can be plain text or HTML.
  * @param {string} [title=""] - Dialog window title shown in the title bar of the window
- * @param {string[]} [buttons=["OK","Cancel"]] - An Array of button names. Indicate a default button by surrounding the text with square brackets like so: "[Cancel]"
+ * @param {string[]} [buttons=["[OK]","Cancel"]] - An array of button names. Indicate a default button by surrounding the text with square brackets like so: "[OK]"
  * @param {MessageIcon|string} [icon=null] - One of MessageIcon icons, or an absolute path to an image from a file system.
  * @param {Window} [window=null] - Owner window that will be overlaid by this dialog window. If omitted, last created visible Window that's not PopUp will be used.
- * @return {number|undefined} Returns a zero-based number of a clicked button, or `null` if the dialog window was closed without clicking provided buttons.
+ * @return {number|null} Returns a zero-based number of a clicked button, or `null` if the dialog window was closed without clicking provided buttons.
  * @global
  * @example <h2>Usage example</h2>
  * let response = dialog("Are you ready?", "Confirm readiness", ["Yes", "No", "[Maybe]"], MessageIcon.Question, window);
@@ -229,7 +229,7 @@ export function confirm(message, window = null)
  * @example <h2>Using custom image</h2>
  * let response = dialog("Is this you?", "Question #5", ["Yes","[No]"], "C://User/John/profile_icon.jpg", window);
  */
-export function dialog(message, title = "", buttons = ["OK", "Cancel"], icon = null, window = null)
+export function dialog(message, title = "", buttons = ["[OK]", "Cancel"], icon = null, window = null)
 {
 	// find first visible window
 	if(window == null)

package/package.json

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

package/typedefs.js

@@ -695,13 +695,13 @@
 /**
  * Table cell coordinates containing column and row property.
  *
- * @typedef {Object} Cell
+ * @typedef {Object} TableCell
  * @property {number} column - a column index of the cell
  * @property {number} row - a row index of the cell
  *
  * @see Table#cellAt
- * @see Table#findCell
- * @see Table#findCells
+ * @see Table#selectedCell
+ * @see Table#editingCell
  *
  */
 

package/types/SwingUI.d.ts

@@ -295,6 +295,14 @@ export class SwingUI {
      * );
      */
     ui(...args: any[]): string | SwingUI;
+    /**
+     * Sets/get whether double-buffering should be used in rendering GUI in Java. Disabling may help to fix some graphical issues in Linux if flickering happens on component repaint.
+     *
+     * @param {boolean} enabled - `true` to enable double-buffering (default), `false` to disable.
+     * @return {SwingUI|boolean} When setting a value, an instance of this `ui` object is returned, otherwise a current value is returned.
+     * @since 1.0.5
+     */
+    doubleBuffer(...args: any[]): SwingUI | boolean;
     /**
      * Shows a message dialog window like alert() in web browser.
      *

package/types/classes/ComponentContainer.d.ts

@@ -38,7 +38,7 @@ export class ComponentContainer extends UIComponent {
      * In loops `for..in`, `for..of` or `component.children.forEach((c, i)=>{...})` it's accessed only once, so you are looping through the same array.
      *
      * @readonly
-     * @type {Object[]}
+     * @type {UIComponent[]}
      * @example <h2>Looping through Window's components</h2>
      * // method 1
      * for(child of window.children)
@@ -59,7 +59,7 @@ export class ComponentContainer extends UIComponent {
      *     ...
      * });
      */
-    readonly get children(): Object[];
+    readonly get children(): UIComponent[];
     /**
      * Gets the number of components added to this container.
      * @readonly
@@ -76,15 +76,15 @@ export class ComponentContainer extends UIComponent {
     /**
      * Gets or sets the index of a child component within this container. Setting new index changes z-order of the component.
      *
-     * @param {Object} child - Child component
+     * @param {UIComponent} child - Child component
      * @param {number} [new_index] - The new index to assign to the child. Moves the component in z-order.
      * @return {this|null|number} If `new_index` is provided, returns `this` component. If the child is not found in this container, returns `null`. Otherwise, returns the child's current z-index.
      */
-    childIndex(child: Object, new_index?: number): this | null | number;
+    childIndex(child: UIComponent, new_index?: number): this | null | number;
     /**
      * Adds a child component to this container component.
      *
-     * @param {object} component - UI Component that can be a child of this component.
+     * @param {UIComponent} component - UI Component that can be a child of this component.
      * @param {number|object} [data_or_index] - Argument to pass some extra data (such as Tab Name to add Panel to Tabs), or index at which to insert the child. By default component is added to the end.
      * @returns {this} Returns an instance of `this` component for chaining.
      * @see UIComponent#addTo
@@ -94,24 +94,24 @@ export class ComponentContainer extends UIComponent {
      * @example <h2>Adding a component at specified index</h2>
      * tabs.addChild(new Panel(), {text: "Registration", enabled: true, tooltip: "Create new account", icon: "images/user.png"});
      */
-    addChild(component: object, ...args: any[]): this;
+    addChild(component: UIComponent, ...args: any[]): this;
     /**
      * Removes component's child by child object or child index.
      *
-     * @param {object|number} child_or_index - Child component object or index of the child.
+     * @param {UIComponent|number} child_or_index - Child component object or index of the child.
      * @param {boolean} [recursive=false] - Boolean indicates if all descendents of this child should also be removed.
      * @returns {UIComponent|null} The removed child component, or `null` if there is no child at specified index.
      */
-    removeChild(child_or_index: object | number, recursive?: boolean): UIComponent | null;
+    removeChild(child_or_index: UIComponent | number, recursive?: boolean): UIComponent | null;
     /**
      * Checks if passed component is a descendant of this container component.
      *
-     * @param descendant - Child component to check.
+     * @param {UIComponent} descendant - Child component to check.
      * @returns {boolean} If the descendant component is inside of this component.
      * @throws {TypeError} When passed argument is not an instance of UIComponent.
      * @see UIComponent#insideOf
      */
-    contains(descendant: any): boolean;
+    contains(descendant: UIComponent): boolean;
     /**
      * Gets, registers or unregisters an event handler function for container-related events
      * triggered when a child component is added or removed.

package/types/classes/ContextMenu.d.ts

@@ -53,10 +53,10 @@ export class ContextMenu extends ComponentContainer {
     /**
      * Adds this ContextMenu to a specified parent component.
      *
-     * @param {object} parent - A valid component that accepts ContextMenu. `parent` must be derived from UIComponent.
+     * @param {ComponentContainer} parent - A valid component that accepts ContextMenu. `parent` must be derived from UIComponent.
      * @return {ContextMenu} Returns an instance of `this` object.
      */
-    addTo(parent: object, ...args: any[]): ContextMenu;
+    addTo(parent: ComponentContainer, ...args: any[]): ContextMenu;
     /**
      * Removes this ContextMenu from all parent components or removes a specified child component from this ContextMenu.
      *

package/types/classes/ScrollPane.d.ts

@@ -15,9 +15,9 @@ export class ScrollPane extends ComponentContainer {
     /**
      * Adds a child component to this container component.
      *
-     * @param {Object} component - UI Component that can be a child of this component.
+     * @param {UIComponent} component - UI Component that can be a child of this component.
      * @returns {this} Returns an instance of `this` component.
      */
-    addChild(component: Object, ...data: any[]): this;
+    addChild(component: UIComponent, ...data: any[]): this;
 }
 import { ComponentContainer } from "./ComponentContainer.js";

package/types/classes/Table.d.ts

@@ -466,26 +466,26 @@ export class Table extends ScrollableComponent {
     /**
      * Sets or gets a row and a column of selected cell.
      *
-     * @param {number} [row] - Row of a cell. (Original order is used, sorting is disregarded.)
+     * @param {number|TableCell} [row_or_cell] - Row or a TableCell object. (Original order is used, sorting is disregarded.)
      * @param {number} [column] - Column of a cell (required if row is specified). (Original order is used, column reordering is disregarded.)
-     * @return {number[]|Table} When both `row` and `cell` are passed, an instance of `this` Table is returned, otherwise a currently selected row and column is returned as an array of integers [row, column], or NULL if there is no selection.
+     * @return {TableCell|Table} When both `row` and `cell` are passed, an instance of `this` Table is returned, otherwise a currently selected `TableCell` object is returned, or NULL if there is no selection.
      */
-    selectedCell(...args: any[]): number[] | Table;
+    selectedCell(...args: any[]): TableCell | Table;
     /**
      * Gets or sets the cell currently being edited.
      * When `row` and `column` are provided and are valid, the specified cell enters edit mode.
      * Pass `null` as a first argument to stop editing currently edited cell. Do it before reading data from the Table to make sure the cell editor commits it's new value to the Table's data.
      * When called with no arguments, returns the cell currently being edited, or `null` if no cell is being edited.
      *
-     * @param {number} [row] - Row index of the cell to edit, or `null` to stop editing currently edited cell (if any).
+     * @param {number|TableCell} [row_or_cell] - Row index of the cell or a TableCell object to edit, or `null` to stop editing currently edited cell (if any).
      * @param {number} [column] - Column index of the cell to edit.
      * @param {boolean} [new_order=false] - Specified if row and column should be interpreted as new index as displayed (after row sorting and column reordering) or not.
-     * @return {Cell|null|Table} When row and cell is specified, an instance of `this` Table is returned, otherwise a currently edited cell is retuned of `null` if no cell is being edited.
+     * @return {TableCell|null|Table} When row and cell is specified, an instance of `this` Table is returned, otherwise a currently edited cell is retuned of `null` if no cell is being edited.
      * @example <h2>Stop editing before reading Table data</h2>
      * if(table.editingCell() != null) table.editingCell(null); // stop editing a cell to commit its changes
      * const _rows = table.rows(); // read new data
      */
-    editingCell(...args: any[]): Cell | null | Table;
+    editingCell(...args: any[]): TableCell | null | Table;
     /**
      * Sets or gets whether sorting can be toggled to unsorted state.
      *
@@ -573,13 +573,13 @@ export class Table extends ScrollableComponent {
         height: number;
     };
     /**
-     * Gets a cell [row,column] located at specified X and Y coordinates relative to the Table's top-left corner.
+     * Gets a TableCell {row,column} located at specified X and Y coordinates relative to the Table's top-left corner.
      *
      * @param {number} x - X
      * @param {number} y - Y
-     * @return {Cell|null} Returns the cell, or `null` if the coordinates are outside any cell.
+     * @return {TableCell|null} Returns the cell at specified location, or `null` if the coordinates are outside any cell.
      */
-    cellAt(x: number, y: number): Cell | null;
+    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.
      *

package/types/classes/UIComponent.d.ts

@@ -98,21 +98,21 @@ export class UIComponent {
      * Gets a previous sibling component. If this component wasn't added to any container component, then `null` is returned.
      * @readonly
      * @type {UIComponent|null}
-     * @since 1.0.3
+     * @since 1.0.2
      */
     readonly get previousSibling(): UIComponent | null;
     /**
      * Gets a next sibling component. If this component wasn't added to any container component, then `null` is returned.
      * @readonly
      * @type {UIComponent|null}
-     * @since 1.0.3
+     * @since 1.0.2
      */
     readonly get nextSibling(): UIComponent | null;
     /**
      * Gets an array of sibling components.
      * @readonly
      * @type {UIComponent[]}
-     * @since 1.0.3
+     * @since 1.0.2
      */
     readonly get siblings(): UIComponent[];
     /**
@@ -166,7 +166,7 @@ export class UIComponent {
      * @param {boolean} [recursive=false] - Set to true to also destroy all of its descendants recursively
      * @returns {void}
      */
-    destroy(...args: any[]): void;
+    destroy(recursive?: boolean): void;
     destroyed: boolean | undefined;
     /**
      * This function may be called to make sure the component wasn't destroyed yet before performing another operation with the component. If it's already destroyed, Exception is thrown.
@@ -176,11 +176,11 @@ export class UIComponent {
     verifyComponent(): this;
     /**
      * Checks if this component is inside specified ancestor component (at any level, not just direct child).
-     * @param {UIComponent} ancestor - Ancestor component to test against
+     * @param {Object} ancestor - Ancestor component to test against
      * @return {boolean}
      * @see ComponentContainer#contains
      */
-    insideOf(ancestor: UIComponent): boolean;
+    insideOf(ancestor: Object): boolean;
     /**
      * Sets or gets component's visibility.
      * NOTE: Window and InternalWindow components visibility is set to `false` by default. Use .visible(true) or .show() to make it visible.
@@ -257,12 +257,11 @@ export class UIComponent {
     /**
      * @internal
      * @ignore
-     * @private
      * @param {string} property
      * @param {any} value
      * @return {any}
      */
-    private property;
+    property(property: string, ...args: any[]): any;
     /**
      * Registers, unregisters, and gets an event handler callback function for a specified events.
      *
@@ -276,13 +275,12 @@ export class UIComponent {
      * @return {Function[]|this} If only the `name` argument is provided, returns an array of registered callback functions. Otherwise, returns `this` component.
      * @internal
      * @ignore
-     * @private
      * @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);});
      */
-    private event;
+    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/functions.d.ts

@@ -89,10 +89,10 @@ export function confirm(message: string, window?: Window): boolean;
  *
  * @param {string} message - String message to user. It can be plain text or HTML.
  * @param {string} [title=""] - Dialog window title shown in the title bar of the window
- * @param {string[]} [buttons=["OK","Cancel"]] - An Array of button names. Indicate a default button by surrounding the text with square brackets like so: "[Cancel]"
+ * @param {string[]} [buttons=["[OK]","Cancel"]] - An array of button names. Indicate a default button by surrounding the text with square brackets like so: "[OK]"
  * @param {MessageIcon|string} [icon=null] - One of MessageIcon icons, or an absolute path to an image from a file system.
  * @param {Window} [window=null] - Owner window that will be overlaid by this dialog window. If omitted, last created visible Window that's not PopUp will be used.
- * @return {number|undefined} Returns a zero-based number of a clicked button, or `null` if the dialog window was closed without clicking provided buttons.
+ * @return {number|null} Returns a zero-based number of a clicked button, or `null` if the dialog window was closed without clicking provided buttons.
  * @global
  * @example <h2>Usage example</h2>
  * let response = dialog("Are you ready?", "Confirm readiness", ["Yes", "No", "[Maybe]"], MessageIcon.Question, window);
@@ -106,4 +106,4 @@ export function confirm(message: string, window?: Window): boolean;
  * @example <h2>Using custom image</h2>
  * let response = dialog("Is this you?", "Question #5", ["Yes","[No]"], "C://User/John/profile_icon.jpg", window);
  */
-export function dialog(message: string, title?: string, buttons?: string[], icon?: MessageIcon | string, window?: Window): number | undefined;
+export function dialog(message: string, title?: string, buttons?: string[], icon?: MessageIcon | string, window?: Window): number | null;

package/ui-process-manager.js

@@ -58,7 +58,7 @@ async function startJar()
 	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
-	if(workerData.os === "linux") JAVA_OPTS.push("--add-opens=java.desktop/sun.awt.X11=ALL-UNNAMED"); // to be able to set WM_CLASS to project name in Java GUI
+	if(workerData.os === "linux")  JAVA_OPTS.push("--add-opens=java.desktop/sun.awt.X11=ALL-UNNAMED"); // to be able to set WM_CLASS to project name in Java GUI
 	
 	const _opts = [...JAVA_OPTS, "-jar", JAR_PATH, "--root-dir", workerData.rootDir, "--module-dir", workerData.moduleDir];
 
@@ -292,14 +292,6 @@ parentPort.on("message", (msg) => {
 		if(msg.respond) syncMode = true;
 		sendLineToJar(msg.data);
 	}
-	// Config override: { type: "__config", jarPath?, javaBin?, javaOpts? }
-	else if(msg.type === "__config")
-	{
-		if(msg.jarPath) JAR_PATH = msg.jarPath;
-		if(msg.javaBin) JAVA_BIN = msg.javaBin;
-		if(msg.javaOpts) JAVA_OPTS = msg.javaOpts;
-		console.log(`[jar-worker] Config updated — jar: ${JAR_PATH}`);
-	}
 	// Shutdown: { type: "__shutdown" }
 	else if(msg.type === "__shutdown")
 	{