@wailsio/runtime 3.0.0-alpha.13 → 3.0.0-alpha.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wailsio/runtime",
-  "version": "3.0.0-alpha.13",
+  "version": "3.0.0-alpha.15",
   "description": "Wails Runtime",
   "main": "src/index.js",
   "types": "types/index.d.ts",
@@ -10,7 +10,10 @@
   },
   "scripts": {
     "prebuild:types": "rimraf ./types",
-    "build:types": "npx -p typescript tsc src/index.js --declaration --allowJs --emitDeclarationOnly --outDir types"
+    "build:types": "npx -p typescript tsc src/index.js --declaration --allowJs --emitDeclarationOnly --outDir types",
+    "postbuild:types": "wails3 task generate:events",
+    "build:docs": "npx typedoc ./src/index.js",
+    "build:docs:md": "npx typedoc --plugin typedoc-plugin-markdown --namedAnchors true --hideBreadcrumbs true --out ../../../../../../mkdocs-website/docs/en/api/js ./src/index.js"
   },
   "author": "The Wails Team",
   "license": "MIT",
@@ -21,6 +24,8 @@
   "private": false,
   "devDependencies": {
     "rimraf": "^5.0.5",
+    "typedoc": "^0.25.7",
+    "typedoc-plugin-markdown": "^3.17.1",
     "typescript": "^5.3.3"
   }
 }

package/src/calls.js

@@ -20,6 +20,11 @@ window._wails = window._wails || {};
 window._wails.callResultHandler = resultHandler;
 window._wails.callErrorHandler = errorHandler;
 
+/**
+ * Generates a unique ID using the nanoid library.
+ *
+ * @return {string} - A unique ID that does not exist in the callResponses set.
+ */
 function generateID() {
     let result;
     do {
@@ -28,26 +33,57 @@ function generateID() {
     return result;
 }
 
-export function resultHandler(id, data, isJSON) {
+/**
+ * Handles the result of a call request.
+ *
+ * @param {string} id - The id of the request to handle the result for.
+ * @param {string} data - The result data of the request.
+ * @param {boolean} isJSON - Indicates whether the data is JSON or not.
+ *
+ * @return {undefined} - This method does not return any value.
+ */
+function resultHandler(id, data, isJSON) {
     const promiseHandler = getAndDeleteResponse(id);
     if (promiseHandler) {
         promiseHandler.resolve(isJSON ? JSON.parse(data) : data);
     }
 }
 
-export function errorHandler(id, message) {
+/**
+ * Handles the error from a call request.
+ *
+ * @param {string} id - The id of the promise handler.
+ * @param {string} message - The error message to reject the promise handler with.
+ *
+ * @return {void}
+ */
+function errorHandler(id, message) {
     const promiseHandler = getAndDeleteResponse(id);
     if (promiseHandler) {
         promiseHandler.reject(message);
     }
 }
 
+/**
+ * Retrieves and removes the response associated with the given ID from the callResponses map.
+ *
+ * @param {any} id - The ID of the response to be retrieved and removed.
+ *
+ * @returns {any} The response object associated with the given ID.
+ */
 function getAndDeleteResponse(id) {
     const response = callResponses.get(id);
     callResponses.delete(id);
     return response;
 }
 
+/**
+ * Executes a call using the provided type and options.
+ *
+ * @param {string|number} type - The type of call to execute.
+ * @param {Object} [options={}] - Additional options for the call.
+ * @return {Promise} - A promise that will be resolved or rejected based on the result of the call.
+ */
 function callBinding(type, options = {}) {
     return new Promise((resolve, reject) => {
         const id = generateID();

package/src/dialogs.js

@@ -11,9 +11,66 @@ The electron alternative for Go
 /* jshint esversion: 9 */
 
 /**
- * @typedef {import("./types").MessageDialogOptions} MessageDialogOptions
- * @typedef {import("./types").OpenDialogOptions} OpenDialogOptions
- * @typedef {import("./types").SaveDialogOptions} SaveDialogOptions
+ * @typedef {Object} OpenFileDialogOptions
+ * @property {boolean} [CanChooseDirectories] - Indicates if directories can be chosen.
+ * @property {boolean} [CanChooseFiles] - Indicates if files can be chosen.
+ * @property {boolean} [CanCreateDirectories] - Indicates if directories can be created.
+ * @property {boolean} [ShowHiddenFiles] - Indicates if hidden files should be shown.
+ * @property {boolean} [ResolvesAliases] - Indicates if aliases should be resolved.
+ * @property {boolean} [AllowsMultipleSelection] - Indicates if multiple selection is allowed.
+ * @property {boolean} [HideExtension] - Indicates if the extension should be hidden.
+ * @property {boolean} [CanSelectHiddenExtension] - Indicates if hidden extensions can be selected.
+ * @property {boolean} [TreatsFilePackagesAsDirectories] - Indicates if file packages should be treated as directories.
+ * @property {boolean} [AllowsOtherFiletypes] - Indicates if other file types are allowed.
+ * @property {FileFilter[]} [Filters] - Array of file filters.
+ * @property {string} [Title] - Title of the dialog.
+ * @property {string} [Message] - Message to show in the dialog.
+ * @property {string} [ButtonText] - Text to display on the button.
+ * @property {string} [Directory] - Directory to open in the dialog.
+ * @property {boolean} [Detached] - Indicates if the dialog should appear detached from the main window.
+ */
+
+
+/**
+ * @typedef {Object} SaveFileDialogOptions
+ * @property {string} [Filename] - Default filename to use in the dialog.
+ * @property {boolean} [CanChooseDirectories] - Indicates if directories can be chosen.
+ * @property {boolean} [CanChooseFiles] - Indicates if files can be chosen.
+ * @property {boolean} [CanCreateDirectories] - Indicates if directories can be created.
+ * @property {boolean} [ShowHiddenFiles] - Indicates if hidden files should be shown.
+ * @property {boolean} [ResolvesAliases] - Indicates if aliases should be resolved.
+ * @property {boolean} [AllowsMultipleSelection] - Indicates if multiple selection is allowed.
+ * @property {boolean} [HideExtension] - Indicates if the extension should be hidden.
+ * @property {boolean} [CanSelectHiddenExtension] - Indicates if hidden extensions can be selected.
+ * @property {boolean} [TreatsFilePackagesAsDirectories] - Indicates if file packages should be treated as directories.
+ * @property {boolean} [AllowsOtherFiletypes] - Indicates if other file types are allowed.
+ * @property {FileFilter[]} [Filters] - Array of file filters.
+ * @property {string} [Title] - Title of the dialog.
+ * @property {string} [Message] - Message to show in the dialog.
+ * @property {string} [ButtonText] - Text to display on the button.
+ * @property {string} [Directory] - Directory to open in the dialog.
+ * @property {boolean} [Detached] - Indicates if the dialog should appear detached from the main window.
+ */
+
+/**
+ * @typedef {Object} MessageDialogOptions
+ * @property {string} [Title] - The title of the dialog window.
+ * @property {string} [Message] - The main message to show in the dialog.
+ * @property {Button[]} [Buttons] - Array of button options to show in the dialog.
+ * @property {boolean} [Detached] - True if the dialog should appear detached from the main window (if applicable).
+ */
+
+/**
+ * @typedef {Object} Button
+ * @property {string} [Label] - Text that appears within the button.
+ * @property {boolean} [IsCancel] - True if the button should cancel an operation when clicked.
+ * @property {boolean} [IsDefault] - True if the button should be the default action when the user presses enter.
+ */
+
+/**
+ * @typedef {Object} FileFilter
+ * @property {string} [DisplayName] - Display name for the filter, it could be "Text Files", "Images" etc.
+ * @property {string} [Pattern] - Pattern to match for the filter, e.g. "*.txt;*.md" for text markdown files.
  */
 
 import {newRuntimeCallerWithID, objectNames} from "./runtime";
@@ -46,7 +103,7 @@ function generateID() {
 /**
  * Shows a dialog of specified type with the given options.
  * @param {number} type - type of dialog
- * @param {object} options - options for the dialog
+ * @param {MessageDialogOptions|OpenFileDialogOptions|SaveFileDialogOptions} options - options for the dialog
  * @returns {Promise} promise that resolves with result of dialog
  */
 function dialog(type, options = {}) {
@@ -61,6 +118,10 @@ function dialog(type, options = {}) {
     });
 }
 
+window._wails = window._wails || {};
+window._wails.dialogErrorCallback = dialogErrorCallback;
+window._wails.dialogResultCallback = dialogResultCallback;
+
 /**
  * Handles the callback from a dialog.
  *
@@ -70,7 +131,7 @@ function dialog(type, options = {}) {
  *
  * @return {undefined}
  */
-export function dialogResultCallback(id, data, isJSON) {
+function dialogResultCallback(id, data, isJSON) {
     let p = dialogResponses.get(id);
     if (p) {
         if (isJSON) {
@@ -90,7 +151,7 @@ export function dialogResultCallback(id, data, isJSON) {
  *
  * @return {void}
  */
-export function dialogErrorCallback(id, message) {
+function dialogErrorCallback(id, message) {
     let p = dialogResponses.get(id);
     if (p) {
         p.reject(message);
@@ -126,13 +187,13 @@ export const Error = (options) => dialog(DialogError, options);
 export const Question = (options) => dialog(DialogQuestion, options);
 
 /**
- * @param {OpenDialogOptions} options - Dialog options
+ * @param {OpenFileDialogOptions} options - Dialog options
  * @returns {Promise<string[]|string>} Returns selected file or list of files. Returns blank string if no file is selected.
  */
 export const OpenFile = (options) => dialog(DialogOpenFile, options);
 
 /**
- * @param {SaveDialogOptions} options - Dialog options
+ * @param {SaveFileDialogOptions} options - Dialog options
  * @returns {Promise<string>} Returns the selected file. Returns blank string if no file is selected.
  */
 export const SaveFile = (options) => dialog(DialogSaveFile, options);

package/src/event_types.js

@@ -0,0 +1,181 @@
+
+export const EventTypes = {
+	Windows: {
+		SystemThemeChanged: "windows:SystemThemeChanged",
+		APMPowerStatusChange: "windows:APMPowerStatusChange",
+		APMSuspend: "windows:APMSuspend",
+		APMResumeAutomatic: "windows:APMResumeAutomatic",
+		APMResumeSuspend: "windows:APMResumeSuspend",
+		APMPowerSettingChange: "windows:APMPowerSettingChange",
+		ApplicationStarted: "windows:ApplicationStarted",
+		WebViewNavigationCompleted: "windows:WebViewNavigationCompleted",
+		WindowInactive: "windows:WindowInactive",
+		WindowActive: "windows:WindowActive",
+		WindowClickActive: "windows:WindowClickActive",
+		WindowMaximise: "windows:WindowMaximise",
+		WindowUnMaximise: "windows:WindowUnMaximise",
+		WindowFullscreen: "windows:WindowFullscreen",
+		WindowUnFullscreen: "windows:WindowUnFullscreen",
+		WindowRestore: "windows:WindowRestore",
+		WindowMinimise: "windows:WindowMinimise",
+		WindowUnMinimise: "windows:WindowUnMinimise",
+		WindowClose: "windows:WindowClose",
+		WindowSetFocus: "windows:WindowSetFocus",
+		WindowKillFocus: "windows:WindowKillFocus",
+		WindowDragDrop: "windows:WindowDragDrop",
+		WindowDragEnter: "windows:WindowDragEnter",
+		WindowDragLeave: "windows:WindowDragLeave",
+		WindowDragOver: "windows:WindowDragOver",
+	},
+	Mac: {
+		ApplicationDidBecomeActive: "mac:ApplicationDidBecomeActive",
+		ApplicationDidChangeBackingProperties: "mac:ApplicationDidChangeBackingProperties",
+		ApplicationDidChangeEffectiveAppearance: "mac:ApplicationDidChangeEffectiveAppearance",
+		ApplicationDidChangeIcon: "mac:ApplicationDidChangeIcon",
+		ApplicationDidChangeOcclusionState: "mac:ApplicationDidChangeOcclusionState",
+		ApplicationDidChangeScreenParameters: "mac:ApplicationDidChangeScreenParameters",
+		ApplicationDidChangeStatusBarFrame: "mac:ApplicationDidChangeStatusBarFrame",
+		ApplicationDidChangeStatusBarOrientation: "mac:ApplicationDidChangeStatusBarOrientation",
+		ApplicationDidFinishLaunching: "mac:ApplicationDidFinishLaunching",
+		ApplicationDidHide: "mac:ApplicationDidHide",
+		ApplicationDidResignActiveNotification: "mac:ApplicationDidResignActiveNotification",
+		ApplicationDidUnhide: "mac:ApplicationDidUnhide",
+		ApplicationDidUpdate: "mac:ApplicationDidUpdate",
+		ApplicationWillBecomeActive: "mac:ApplicationWillBecomeActive",
+		ApplicationWillFinishLaunching: "mac:ApplicationWillFinishLaunching",
+		ApplicationWillHide: "mac:ApplicationWillHide",
+		ApplicationWillResignActive: "mac:ApplicationWillResignActive",
+		ApplicationWillTerminate: "mac:ApplicationWillTerminate",
+		ApplicationWillUnhide: "mac:ApplicationWillUnhide",
+		ApplicationWillUpdate: "mac:ApplicationWillUpdate",
+		ApplicationDidChangeTheme: "mac:ApplicationDidChangeTheme!",
+		ApplicationShouldHandleReopen: "mac:ApplicationShouldHandleReopen!",
+		WindowDidBecomeKey: "mac:WindowDidBecomeKey",
+		WindowDidBecomeMain: "mac:WindowDidBecomeMain",
+		WindowDidBeginSheet: "mac:WindowDidBeginSheet",
+		WindowDidChangeAlpha: "mac:WindowDidChangeAlpha",
+		WindowDidChangeBackingLocation: "mac:WindowDidChangeBackingLocation",
+		WindowDidChangeBackingProperties: "mac:WindowDidChangeBackingProperties",
+		WindowDidChangeCollectionBehavior: "mac:WindowDidChangeCollectionBehavior",
+		WindowDidChangeEffectiveAppearance: "mac:WindowDidChangeEffectiveAppearance",
+		WindowDidChangeOcclusionState: "mac:WindowDidChangeOcclusionState",
+		WindowDidChangeOrderingMode: "mac:WindowDidChangeOrderingMode",
+		WindowDidChangeScreen: "mac:WindowDidChangeScreen",
+		WindowDidChangeScreenParameters: "mac:WindowDidChangeScreenParameters",
+		WindowDidChangeScreenProfile: "mac:WindowDidChangeScreenProfile",
+		WindowDidChangeScreenSpace: "mac:WindowDidChangeScreenSpace",
+		WindowDidChangeScreenSpaceProperties: "mac:WindowDidChangeScreenSpaceProperties",
+		WindowDidChangeSharingType: "mac:WindowDidChangeSharingType",
+		WindowDidChangeSpace: "mac:WindowDidChangeSpace",
+		WindowDidChangeSpaceOrderingMode: "mac:WindowDidChangeSpaceOrderingMode",
+		WindowDidChangeTitle: "mac:WindowDidChangeTitle",
+		WindowDidChangeToolbar: "mac:WindowDidChangeToolbar",
+		WindowDidChangeVisibility: "mac:WindowDidChangeVisibility",
+		WindowDidDeminiaturize: "mac:WindowDidDeminiaturize",
+		WindowDidEndSheet: "mac:WindowDidEndSheet",
+		WindowDidEnterFullScreen: "mac:WindowDidEnterFullScreen",
+		WindowDidEnterVersionBrowser: "mac:WindowDidEnterVersionBrowser",
+		WindowDidExitFullScreen: "mac:WindowDidExitFullScreen",
+		WindowDidExitVersionBrowser: "mac:WindowDidExitVersionBrowser",
+		WindowDidExpose: "mac:WindowDidExpose",
+		WindowDidFocus: "mac:WindowDidFocus",
+		WindowDidMiniaturize: "mac:WindowDidMiniaturize",
+		WindowDidMove: "mac:WindowDidMove",
+		WindowDidOrderOffScreen: "mac:WindowDidOrderOffScreen",
+		WindowDidOrderOnScreen: "mac:WindowDidOrderOnScreen",
+		WindowDidResignKey: "mac:WindowDidResignKey",
+		WindowDidResignMain: "mac:WindowDidResignMain",
+		WindowDidResize: "mac:WindowDidResize",
+		WindowDidUpdate: "mac:WindowDidUpdate",
+		WindowDidUpdateAlpha: "mac:WindowDidUpdateAlpha",
+		WindowDidUpdateCollectionBehavior: "mac:WindowDidUpdateCollectionBehavior",
+		WindowDidUpdateCollectionProperties: "mac:WindowDidUpdateCollectionProperties",
+		WindowDidUpdateShadow: "mac:WindowDidUpdateShadow",
+		WindowDidUpdateTitle: "mac:WindowDidUpdateTitle",
+		WindowDidUpdateToolbar: "mac:WindowDidUpdateToolbar",
+		WindowDidUpdateVisibility: "mac:WindowDidUpdateVisibility",
+		WindowShouldClose: "mac:WindowShouldClose!",
+		WindowWillBecomeKey: "mac:WindowWillBecomeKey",
+		WindowWillBecomeMain: "mac:WindowWillBecomeMain",
+		WindowWillBeginSheet: "mac:WindowWillBeginSheet",
+		WindowWillChangeOrderingMode: "mac:WindowWillChangeOrderingMode",
+		WindowWillClose: "mac:WindowWillClose",
+		WindowWillDeminiaturize: "mac:WindowWillDeminiaturize",
+		WindowWillEnterFullScreen: "mac:WindowWillEnterFullScreen",
+		WindowWillEnterVersionBrowser: "mac:WindowWillEnterVersionBrowser",
+		WindowWillExitFullScreen: "mac:WindowWillExitFullScreen",
+		WindowWillExitVersionBrowser: "mac:WindowWillExitVersionBrowser",
+		WindowWillFocus: "mac:WindowWillFocus",
+		WindowWillMiniaturize: "mac:WindowWillMiniaturize",
+		WindowWillMove: "mac:WindowWillMove",
+		WindowWillOrderOffScreen: "mac:WindowWillOrderOffScreen",
+		WindowWillOrderOnScreen: "mac:WindowWillOrderOnScreen",
+		WindowWillResignMain: "mac:WindowWillResignMain",
+		WindowWillResize: "mac:WindowWillResize",
+		WindowWillUnfocus: "mac:WindowWillUnfocus",
+		WindowWillUpdate: "mac:WindowWillUpdate",
+		WindowWillUpdateAlpha: "mac:WindowWillUpdateAlpha",
+		WindowWillUpdateCollectionBehavior: "mac:WindowWillUpdateCollectionBehavior",
+		WindowWillUpdateCollectionProperties: "mac:WindowWillUpdateCollectionProperties",
+		WindowWillUpdateShadow: "mac:WindowWillUpdateShadow",
+		WindowWillUpdateTitle: "mac:WindowWillUpdateTitle",
+		WindowWillUpdateToolbar: "mac:WindowWillUpdateToolbar",
+		WindowWillUpdateVisibility: "mac:WindowWillUpdateVisibility",
+		WindowWillUseStandardFrame: "mac:WindowWillUseStandardFrame",
+		MenuWillOpen: "mac:MenuWillOpen",
+		MenuDidOpen: "mac:MenuDidOpen",
+		MenuDidClose: "mac:MenuDidClose",
+		MenuWillSendAction: "mac:MenuWillSendAction",
+		MenuDidSendAction: "mac:MenuDidSendAction",
+		MenuWillHighlightItem: "mac:MenuWillHighlightItem",
+		MenuDidHighlightItem: "mac:MenuDidHighlightItem",
+		MenuWillDisplayItem: "mac:MenuWillDisplayItem",
+		MenuDidDisplayItem: "mac:MenuDidDisplayItem",
+		MenuWillAddItem: "mac:MenuWillAddItem",
+		MenuDidAddItem: "mac:MenuDidAddItem",
+		MenuWillRemoveItem: "mac:MenuWillRemoveItem",
+		MenuDidRemoveItem: "mac:MenuDidRemoveItem",
+		MenuWillBeginTracking: "mac:MenuWillBeginTracking",
+		MenuDidBeginTracking: "mac:MenuDidBeginTracking",
+		MenuWillEndTracking: "mac:MenuWillEndTracking",
+		MenuDidEndTracking: "mac:MenuDidEndTracking",
+		MenuWillUpdate: "mac:MenuWillUpdate",
+		MenuDidUpdate: "mac:MenuDidUpdate",
+		MenuWillPopUp: "mac:MenuWillPopUp",
+		MenuDidPopUp: "mac:MenuDidPopUp",
+		MenuWillSendActionToItem: "mac:MenuWillSendActionToItem",
+		MenuDidSendActionToItem: "mac:MenuDidSendActionToItem",
+		WebViewDidStartProvisionalNavigation: "mac:WebViewDidStartProvisionalNavigation",
+		WebViewDidReceiveServerRedirectForProvisionalNavigation: "mac:WebViewDidReceiveServerRedirectForProvisionalNavigation",
+		WebViewDidFinishNavigation: "mac:WebViewDidFinishNavigation",
+		WebViewDidCommitNavigation: "mac:WebViewDidCommitNavigation",
+		WindowFileDraggingEntered: "mac:WindowFileDraggingEntered",
+		WindowFileDraggingPerformed: "mac:WindowFileDraggingPerformed",
+		WindowFileDraggingExited: "mac:WindowFileDraggingExited",
+	},
+	Linux: {
+		SystemThemeChanged: "linux:SystemThemeChanged",
+	},
+	Common: {
+		ApplicationStarted: "common:ApplicationStarted",
+		WindowMaximise: "common:WindowMaximise",
+		WindowUnMaximise: "common:WindowUnMaximise",
+		WindowFullscreen: "common:WindowFullscreen",
+		WindowUnFullscreen: "common:WindowUnFullscreen",
+		WindowRestore: "common:WindowRestore",
+		WindowMinimise: "common:WindowMinimise",
+		WindowUnMinimise: "common:WindowUnMinimise",
+		WindowClosing: "common:WindowClosing",
+		WindowZoom: "common:WindowZoom",
+		WindowZoomIn: "common:WindowZoomIn",
+		WindowZoomOut: "common:WindowZoomOut",
+		WindowZoomReset: "common:WindowZoomReset",
+		WindowFocus: "common:WindowFocus",
+		WindowLostFocus: "common:WindowLostFocus",
+		WindowShow: "common:WindowShow",
+		WindowHide: "common:WindowHide",
+		WindowDPIChanged: "common:WindowDPIChanged",
+		WindowFilesDropped: "common:WindowFilesDropped",
+		ThemeChanged: "common:ThemeChanged",
+	},
+};

package/src/events.js

@@ -15,6 +15,9 @@ The electron alternative for Go
  */
 import {newRuntimeCallerWithID, objectNames} from "./runtime";
 
+import {EventTypes} from "./event_types";
+export const Types = EventTypes;
+
 const call = newRuntimeCallerWithID(objectNames.Events, '');
 const EmitMethod = 0;
 const eventListeners = new Map();
@@ -39,11 +42,22 @@ export class WailsEvent {
     }
 }
 
+/**
+ * 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;
+}
 
-window._wails = window._wails || {};
-window._wails.dispatchWailsEvent = dispatchWailsEvent;
-
-export function dispatchWailsEvent(event) {
+function dispatchWailsEvent(event) {
     let listeners = eventListeners.get(event.name);
     if (listeners) {
         let toRemove = listeners.filter(listener => {
@@ -88,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

@@ -10,45 +10,22 @@ The electron alternative for Go
 
 import {setupContextMenus} from "./contextmenu";
 import {setupDrag} from "./drag";
-import {Emit, Off, OffAll, On, Once, OnMultiple, WailsEvent} from './events';
 import {ByID, ByName, Plugin} from "./calls";
-import {Error, Info, OpenFile, Question, SaveFile, Warning} from "./dialogs";
 
 import * as Application from "./application";
 import * as Browser from "./browser";
 import * as Clipboard from "./clipboard";
-import * as ContextMenu from "./contextmenu";
 import * as Flags from "./flags";
-import * as Runtime from "./runtime";
 import * as Screens from "./screens";
 import * as System from "./system";
 import * as Window from "./window";
 import * as WML from './wml';
+import * as Events from "./events";
+import * as Dialogs from "./dialogs";
+import * as Call from "./calls";
 
-export { Application, Browser, Clipboard, ContextMenu, Flags, Runtime, Screens, System, Window, WML };
+export { Application, Browser, Call, Clipboard, Dialogs, Events, Flags, Screens, System, Window, WML};
 
-export const Events = {
-    On,
-    Off,
-    OnMultiple,
-    WailsEvent,
-    OffAll,
-    Emit,
-    Once
-
-}
-
-export const Call = {
-    Plugin,
-    ByID,
-    ByName
-}
-
-export const Dialogs = {
-    Info,
-    Error,
-    OpenFile, Question, Warning, SaveFile
-}
 
 /***
  This technique for proper load detection is taken from HTMX:
@@ -97,5 +74,6 @@ function whenReady(fn) {
 whenReady(() => {
     setupContextMenus();
     setupDrag();
+    setupEventCallbacks();
     WML.Reload();
 });

package/src/screens.js

@@ -10,10 +10,21 @@ The electron alternative for Go
 
 /* jshint esversion: 9 */
 
+
 /**
- * @typedef {import("./api/types").Screen} Screen
+ * @typedef {Object} Screen
+ * @property {string} Id - Unique identifier for the screen.
+ * @property {string} Name - Human readable name of the screen.
+ * @property {number} Scale - The resolution scale of the screen. 1 = standard resolution, 2 = high (Retina), etc.
+ * @property {Position} Position - Contains the X and Y coordinates of the screen's position.
+ * @property {Size} Size - Contains the width and height of the screen.
+ * @property {Rect} Bounds - Contains the bounds of the screen in terms of X, Y, Width, and Height.
+ * @property {Rect} WorkArea - Contains the area of the screen that is actually usable (excluding taskbar and other system UI).
+ * @property {boolean} IsPrimary - True if this is the primary monitor selected by the user in the operating system.
+ * @property {Rotation} Rotation - The rotation of the screen.
  */
 
+
 import {newRuntimeCallerWithID, objectNames} from "./runtime";
 const call = newRuntimeCallerWithID(objectNames.Screens, '');