swing-ui 1.1.4 → 1.1.7

package/SwingUI.js

@@ -1293,7 +1293,7 @@ export class SwingUI
 				value: {id: args[0], options: args[1] ?? undefined}
 			}, r => {return r.value;});
 			if(e === false) throw new Error(`Failed to set UI '${args[0]}'.`);
-			queueMicrotask(() => {this.#processEvent(e);});
+			else if(typeof e === "object") queueMicrotask(() => {this.#processEvent(e);});
 			return this;
 		}
 		else
@@ -1881,7 +1881,7 @@ export class SwingUI
 	 *
 	 * @param {string|URL} file_path - Local destination file path.
 	 * @param {string|ArrayBuffer|Uint8Array|Buffer} data - Data to write to a file.
-	 * @param {string} [mode="write"] - "write" or "append"
+	 * @param {string} [flag="w"] - `w` - write new data, or `a` - append to existing data.
 	 * @param {boolean} [overwrite=true] - `true` to overwrite existing file with the same path. `false` to fail and return `false` if a file with the same path already exists.
 	 * @param {boolean} [create_dir=false] - `true` to create directory if it doesn't exist. `false` is default. If `false` and directory doesn't exist, an Errow will be thrown.
 	 * @returns {boolean} Returns `true` on success, or throws an Error on failure.
@@ -1892,7 +1892,7 @@ export class SwingUI
 	 * @throws {Error} When the directory of the file path doesn't exist and `create_dir` argument is not true.
 	 * @throws {Error} When failed to write the file.
 	 */
-	writeFile(file_path, data, mode = "write", overwrite = true, create_dir = false)
+	writeFile(file_path, data, flag = "w", overwrite = true, create_dir = false)
 	{
 		// validate path type
 		if(!(typeof file_path === "string")) throw new Error(`Invalid "file_path" argument: ${typeof file_path}`);
@@ -1902,7 +1902,7 @@ export class SwingUI
 
 		if(overwrite !== true && this.fileExists(file_path)) throw new Error(`File already exists. To overwrite the file set "overwrite" argument to true.`);
 
-		if(mode === "append" && this.fileExists(file_path) && !this.canWriteFile(file_path)) throw new Error(`Failed to write file: Access Denied`);
+		if(flag === "a" && this.fileExists(file_path) && !this.canWriteFile(file_path)) throw new Error(`Failed to write file: Access Denied`);
 
 		if(typeof data === "string") data = new TextEncoder().encode(data); // convert string to Uint8Array
 
@@ -1928,11 +1928,10 @@ export class SwingUI
 
 			if(this.runtime === "deno")
 			{
-				Deno.writeFileSync(file_path, (data instanceof Uint8Array) ? data : new Uint8Array(data), {append: mode === "append"});
+				Deno.writeFileSync(file_path, (data instanceof Uint8Array) ? data : new Uint8Array(data), {append: flag === "a"});
 			}
 			else
 			{
-				const flag = mode === "append" ? "a" : "w";
 				fs.writeFileSync(file_path, (data instanceof ArrayBuffer) ? Buffer.from(data) : data, {flag: flag});
 			}
 

package/classes/Table.js

@@ -74,7 +74,7 @@ export class Table extends ScrollableComponent
 	 * @property {number} None - No grid lines.
 	 * @property {number} Horizontal - Show only horizontal lines.
 	 * @property {number} Vertical - Show only vertical lines.
-	 * @property {number} Both - Show both horizontal and vertical lines.
+	 * @property {number} Both - Show both horizontal and vertical lines. (default)
 	 * @see Table#gridLines
 	 * @example <h2>Setting to show only horizontal grid lines:</h2>
 	 * table.gridLines(Table.GridLines.Horizontal);

package/package.json

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

package/types/SwingUI.d.ts

@@ -509,7 +509,7 @@ export class SwingUI {
      *
      * @param {string|URL} file_path - Local destination file path.
      * @param {string|ArrayBuffer|Uint8Array|Buffer} data - Data to write to a file.
-     * @param {string} [mode="write"] - "write" or "append"
+     * @param {string} [flag="w"] - `w` - write new data, or `a` - append to existing data.
      * @param {boolean} [overwrite=true] - `true` to overwrite existing file with the same path. `false` to fail and return `false` if a file with the same path already exists.
      * @param {boolean} [create_dir=false] - `true` to create directory if it doesn't exist. `false` is default. If `false` and directory doesn't exist, an Errow will be thrown.
      * @returns {boolean} Returns `true` on success, or throws an Error on failure.
@@ -520,7 +520,7 @@ export class SwingUI {
      * @throws {Error} When the directory of the file path doesn't exist and `create_dir` argument is not true.
      * @throws {Error} When failed to write the file.
      */
-    writeFile(file_path: string | URL, data: string | ArrayBuffer | Uint8Array | Buffer, mode?: string, overwrite?: boolean, create_dir?: boolean): boolean;
+    writeFile(file_path: string | URL, data: string | ArrayBuffer | Uint8Array | Buffer, flag?: string, overwrite?: boolean, create_dir?: boolean): boolean;
     /**
      * Gets information about a file or directory, like times, size, if it's a file or directory, etc.
      *

package/types/classes/Table.d.ts

@@ -83,7 +83,7 @@ export class Table extends ScrollableComponent {
      * @property {number} None - No grid lines.
      * @property {number} Horizontal - Show only horizontal lines.
      * @property {number} Vertical - Show only vertical lines.
-     * @property {number} Both - Show both horizontal and vertical lines.
+     * @property {number} Both - Show both horizontal and vertical lines. (default)
      * @see Table#gridLines
      * @example <h2>Setting to show only horizontal grid lines:</h2>
      * table.gridLines(Table.GridLines.Horizontal);