@wailsio/runtime 3.0.0-alpha.14 → 3.0.0-alpha.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wailsio/runtime",
-  "version": "3.0.0-alpha.14",
+  "version": "3.0.0-alpha.16",
   "description": "Wails Runtime",
   "main": "src/index.js",
   "types": "types/index.d.ts",

package/src/event_types.js

@@ -48,7 +48,6 @@ export const EventTypes = {
 		ApplicationWillTerminate: "mac:ApplicationWillTerminate",
 		ApplicationWillUnhide: "mac:ApplicationWillUnhide",
 		ApplicationWillUpdate: "mac:ApplicationWillUpdate",
-		ApplicationTerminate: "mac:ApplicationTerminate",
 		ApplicationDidChangeTheme: "mac:ApplicationDidChangeTheme!",
 		ApplicationShouldHandleReopen: "mac:ApplicationShouldHandleReopen!",
 		WindowDidBecomeKey: "mac:WindowDidBecomeKey",
@@ -178,6 +177,5 @@ export const EventTypes = {
 		WindowDPIChanged: "common:WindowDPIChanged",
 		WindowFilesDropped: "common:WindowFilesDropped",
 		ThemeChanged: "common:ThemeChanged",
-		ApplicationTerminate: "common:ApplicationTerminate",
 	},
 };

package/src/events.js

@@ -42,9 +42,20 @@ export class WailsEvent {
     }
 }
 
-
-window._wails = window._wails || {};
-window._wails.dispatchWailsEvent = dispatchWailsEvent;
+/**
+ * Sets up event callbacks for Wails.
+ *
+ * @function setupEventCallbacks
+ *
+ * @description This method is responsible for setting up event callbacks for Wails. It checks if the global object `_wails` exists on the `window` object, and if not, initializes it
+ *. It then assigns the `dispatchWailsEvent` function as a property on the `_wails` object.
+ *
+ * @returns {undefined} Returns nothing.
+ */
+export function setupEventCallbacks() {
+    window._wails = window._wails || {};
+    window._wails.dispatchWailsEvent = dispatchWailsEvent;
+}
 
 function dispatchWailsEvent(event) {
     let listeners = eventListeners.get(event.name);
@@ -91,7 +102,7 @@ export function On(eventName, callback) { return OnMultiple(eventName, callback,
  *
  * @param {string} eventName - The name of the event.
  * @param {function} callback - The function to be executed when the event occurs.
- * @return {void@return {function} - A function that, when called, will unregister the callback from the event.
+ * @return {function} - A function that, when called, will unregister the callback from the event.
  */
 export function Once(eventName, callback) { return OnMultiple(eventName, callback, 1); }
 

package/src/index.js

@@ -74,5 +74,6 @@ function whenReady(fn) {
 whenReady(() => {
     setupContextMenus();
     setupDrag();
+    setupEventCallbacks();
     WML.Reload();
 });

package/src/screens.js

@@ -10,6 +10,33 @@ The electron alternative for Go
 
 /* jshint esversion: 9 */
 
+/**
+ * @typedef {Object} Position
+ * @property {number} X - The X coordinate.
+ * @property {number} Y - The Y coordinate.
+ */
+
+/**
+ * @typedef {Object} Size
+ * @property {number} X - The width.
+ * @property {number} Y - The height.
+ */
+
+
+/**
+ * @typedef {Object} Rect
+ * @property {number} X - The X coordinate of the top-left corner.
+ * @property {number} Y - The Y coordinate of the top-left corner.
+ * @property {number} Width - The width of the rectangle.
+ * @property {number} Height - The height of the rectangle.
+ */
+
+
+/**
+ * @typedef {('Zero'|'Ninety'|'OneEighty'|'TwoSeventy')} Rotation
+ * The rotation of the screen. Can be one of 'Zero', 'Ninety', 'OneEighty', 'TwoSeventy'.
+ */
+
 
 /**
  * @typedef {Object} Screen

package/src/window.js

@@ -15,33 +15,6 @@ The electron alternative for Go
  * @typedef {import("./screens").Screen} Screen
  */
 
-/**
- * @typedef {Object} Position
- * @property {number} X - The X coordinate.
- * @property {number} Y - The Y coordinate.
- */
-
-/**
- * @typedef {Object} Size
- * @property {number} X - The width.
- * @property {number} Y - The height.
- */
-
-
-/**
- * @typedef {Object} Rect
- * @property {number} X - The X coordinate of the top-left corner.
- * @property {number} Y - The Y coordinate of the top-left corner.
- * @property {number} Width - The width of the rectangle.
- * @property {number} Height - The height of the rectangle.
- */
-
-/**
- * @typedef {('Zero'|'Ninety'|'OneEighty'|'TwoSeventy')} Rotation
- * The rotation of the screen. Can be one of 'Zero', 'Ninety', 'OneEighty', 'TwoSeventy'.
- */
-
-
 import {newRuntimeCallerWithID, objectNames} from "./runtime";
 
 const center = 0;

package/tsconfig.json

@@ -1,20 +1,20 @@
-{
-  "include": ["./src/**/*"],
-  "compilerOptions": {
-    "lib": [
-      "dom",
-      "dom.iterable",
-      "esnext"
-    ],
-    "allowJs": true,
-    "declaration": true,
-    "declarationMap": true,
-    "emitDeclarationOnly": true,
-    "esModuleInterop": true,
-    "module": "esnext",
-    "moduleResolution": "node",
-    "outDir": "dist",
-    "strict": true,
-    "target": "es6"
-  }
+{
+  "include": ["./src/**/*"],
+  "compilerOptions": {
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "declaration": true,
+    "declarationMap": true,
+    "emitDeclarationOnly": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "node",
+    "outDir": "dist",
+    "strict": true,
+    "target": "es6"
+  }
 }

package/types/event_types.d.ts

@@ -48,7 +48,6 @@ export declare const EventTypes: {
 		ApplicationWillTerminate: string,
 		ApplicationWillUnhide: string,
 		ApplicationWillUpdate: string,
-		ApplicationTerminate: string,
 		ApplicationDidChangeTheme: string,
 		ApplicationShouldHandleReopen: string,
 		WindowDidBecomeKey: string,
@@ -178,6 +177,5 @@ export declare const EventTypes: {
 		WindowDPIChanged: string,
 		WindowFilesDropped: string,
 		ThemeChanged: string,
-		ApplicationTerminate: string,
 	},
 };

package/types/events.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Sets up event callbacks for Wails.
+ *
+ * @function setupEventCallbacks
+ *
+ * @description This method is responsible for setting up event callbacks for Wails. It checks if the global object `_wails` exists on the `window` object, and if not, initializes it
+ *. It then assigns the `dispatchWailsEvent` function as a property on the `_wails` object.
+ *
+ * @returns {undefined} Returns nothing.
+ */
+export function setupEventCallbacks(): undefined;
 /**
  * Register a callback function to be called multiple times for a specific event.
  *
@@ -20,9 +31,9 @@ export function On(eventName: string, callback: Function): Function;
  *
  * @param {string} eventName - The name of the event.
  * @param {function} callback - The function to be executed when the event occurs.
- * @return {void@return {function} - A function that, when called, will unregister the callback from the event.
+ * @return {function} - A function that, when called, will unregister the callback from the event.
  */
-export function Once(eventName: string, callback: Function): void;
+export function Once(eventName: string, callback: Function): Function;
 /**
  * Removes event listeners for the specified event names.
  *
@@ -80,15 +91,6 @@ export const Types: {
         ApplicationDidChangeIcon: string;
         ApplicationDidChangeOcclusionState: string;
         ApplicationDidChangeScreenParameters: string;
-        /**
-         * Register a callback function to be called multiple times for a specific event.
-         *
-         * @param {string} eventName - The name of the event to register the callback for.
-         * @param {function} callback - The callback function to be called when the event is triggered.
-         * @param {number} maxCallbacks - The maximum number of times the callback can be called for the event. Once the maximum number is reached, the callback will no longer be called.
-         *
-         @return {function} - A function that, when called, will unregister the callback from the event.
-         */
         ApplicationDidChangeStatusBarFrame: string;
         ApplicationDidChangeStatusBarOrientation: string;
         ApplicationDidFinishLaunching: string;
@@ -103,7 +105,6 @@ export const Types: {
         ApplicationWillTerminate: string;
         ApplicationWillUnhide: string;
         ApplicationWillUpdate: string;
-        ApplicationTerminate: string;
         ApplicationDidChangeTheme: string;
         ApplicationShouldHandleReopen: string;
         WindowDidBecomeKey: string;
@@ -124,6 +125,12 @@ export const Types: {
         WindowDidChangeSharingType: string;
         WindowDidChangeSpace: string;
         WindowDidChangeSpaceOrderingMode: string;
+        /**
+         * Removes the specified listener from the event listeners collection.
+         * If all listeners for the event are removed, the event key is deleted from the collection.
+         *
+         * @param {Object} listener - The listener to be removed.
+         */
         WindowDidChangeTitle: string;
         WindowDidChangeToolbar: string;
         WindowDidChangeVisibility: string;
@@ -133,6 +140,13 @@ export const Types: {
         WindowDidEnterVersionBrowser: string;
         WindowDidExitFullScreen: string;
         WindowDidExitVersionBrowser: string;
+        /**
+         * Removes event listeners for the specified event names.
+         *
+         * @param {string} eventName - The name of the event to remove listeners for.
+         * @param {...string} additionalEventNames - Additional event names to remove listeners for.
+         * @return {undefined}
+         */
         WindowDidExpose: string;
         WindowDidFocus: string;
         WindowDidMiniaturize: string;
@@ -233,7 +247,6 @@ export const Types: {
         WindowDPIChanged: string;
         WindowFilesDropped: string;
         ThemeChanged: string;
-        ApplicationTerminate: string;
     };
 };
 export class WailsEvent {

package/types/screens.d.ts

@@ -14,6 +14,48 @@ export function GetPrimary(): Promise<Screen>;
  * @returns {Promise<Screen>} A promise that resolves with the current active screen.
  */
 export function GetCurrent(): Promise<Screen>;
+export type Position = {
+    /**
+     * - The X coordinate.
+     */
+    X: number;
+    /**
+     * - The Y coordinate.
+     */
+    Y: number;
+};
+export type Size = {
+    /**
+     * - The width.
+     */
+    X: number;
+    /**
+     * - The height.
+     */
+    Y: number;
+};
+export type Rect = {
+    /**
+     * - The X coordinate of the top-left corner.
+     */
+    X: number;
+    /**
+     * - The Y coordinate of the top-left corner.
+     */
+    Y: number;
+    /**
+     * - The width of the rectangle.
+     */
+    Width: number;
+    /**
+     * - The height of the rectangle.
+     */
+    Height: number;
+};
+/**
+ * The rotation of the screen. Can be one of 'Zero', 'Ninety', 'OneEighty', 'TwoSeventy'.
+ */
+export type Rotation = ('Zero' | 'Ninety' | 'OneEighty' | 'TwoSeventy');
 export type Screen = {
     /**
      * - Unique identifier for the screen.

package/types/window.d.ts

@@ -5,48 +5,136 @@
  * @return {Object} - The specified window object.
  */
 export function Get(windowName: string): any;
-declare const _default: any;
-export default _default;
+/**
+ * Centers the window on the screen.
+ */
+export function Center(): void;
+/**
+ * Sets the title of the window.
+ * @param {string} title - The title to set.
+ */
+export function SetTitle(title: string): void;
+/**
+ * Sets the window to fullscreen.
+ */
+export function Fullscreen(): void;
+/**
+ * Sets the size of the window.
+ * @param {number} width - The width of the window.
+ * @param {number} height - The height of the window.
+ */
+export function SetSize(width: number, height: number): void;
+/**
+ * Gets the size of the window.
+ */
+export function Size(): any;
+/**
+ * Sets the maximum size of the window.
+ * @param {number} width - The maximum width of the window.
+ * @param {number} height - The maximum height of the window.
+ */
+export function SetMaxSize(width: number, height: number): void;
+/**
+ * Sets the minimum size of the window.
+ * @param {number} width - The minimum width of the window.
+ * @param {number} height - The minimum height of the window.
+ */
+export function SetMinSize(width: number, height: number): void;
+/**
+ * Sets the window to always be on top.
+ * @param {boolean} onTop - Whether the window should always be on top.
+ */
+export function SetAlwaysOnTop(onTop: boolean): void;
+/**
+ * Sets the relative position of the window.
+ * @param {number} x - The x-coordinate of the window's position.
+ * @param {number} y - The y-coordinate of the window's position.
+ */
+export function SetRelativePosition(x: number, y: number): void;
+/**
+ * Gets the relative position of the window.
+ */
+export function RelativePosition(): any;
+/**
+ * Gets the screen that the window is on.
+ */
+export function Screen(): any;
 export type Screen = import("./screens").Screen;
-export type Position = {
-    /**
-     * - The X coordinate.
-     */
-    X: number;
-    /**
-     * - The Y coordinate.
-     */
-    Y: number;
-};
-export type Size = {
-    /**
-     * - The width.
-     */
-    X: number;
-    /**
-     * - The height.
-     */
-    Y: number;
-};
-export type Rect = {
-    /**
-     * - The X coordinate of the top-left corner.
-     */
-    X: number;
-    /**
-     * - The Y coordinate of the top-left corner.
-     */
-    Y: number;
-    /**
-     * - The width of the rectangle.
-     */
-    Width: number;
-    /**
-     * - The height of the rectangle.
-     */
-    Height: number;
-};
-/**
- * The rotation of the screen. Can be one of 'Zero', 'Ninety', 'OneEighty', 'TwoSeventy'.
- */
-export type Rotation = ('Zero' | 'Ninety' | 'OneEighty' | 'TwoSeventy');
+/**
+ * Hides the window.
+ */
+export function Hide(): void;
+/**
+ * Maximises the window.
+ */
+export function Maximise(): void;
+/**
+ * Un-maximises the window.
+ */
+export function UnMaximise(): void;
+/**
+ * Toggles the maximisation of the window.
+ */
+export function ToggleMaximise(): void;
+/**
+ * Minimises the window.
+ */
+export function Minimise(): void;
+/**
+ * Un-minimises the window.
+ */
+export function UnMinimise(): void;
+/**
+ * Restores the window.
+ */
+export function Restore(): void;
+/**
+ * Shows the window.
+ */
+export function Show(): void;
+/**
+ * Closes the window.
+ */
+export function Close(): void;
+/**
+ * Sets the background colour of the window.
+ * @param {number} r - The red component of the colour.
+ * @param {number} g - The green component of the colour.
+ * @param {number} b - The blue component of the colour.
+ * @param {number} a - The alpha component of the colour.
+ */
+export function SetBackgroundColour(r: number, g: number, b: number, a: number): void;
+/**
+ * Sets whether the window is resizable.
+ * @param {boolean} resizable - Whether the window should be resizable.
+ */
+export function SetResizable(resizable: boolean): void;
+/**
+ * Gets the width of the window.
+ */
+export function Width(): any;
+/**
+ * Gets the height of the window.
+ */
+export function Height(): any;
+/**
+ * Zooms in the window.
+ */
+export function ZoomIn(): void;
+/**
+ * Zooms out the window.
+ */
+export function ZoomOut(): void;
+/**
+ * Resets the zoom of the window.
+ */
+export function ZoomReset(): void;
+/**
+ * Gets the zoom level of the window.
+ */
+export function GetZoomLevel(): any;
+/**
+ * Sets the zoom level of the window.
+ * @param {number} zoomLevel - The zoom level to set.
+ */
+export function SetZoomLevel(zoomLevel: number): void;