@wailsio/runtime 3.0.0-alpha.4 → 3.0.0-alpha.40

package/{application.js → src/application.js}

@@ -1,46 +1,46 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-
-import { newRuntimeCallerWithID, objectNames } from "./runtime";
-const call = newRuntimeCallerWithID(objectNames.Application);
-
-const HideMethod = 0;
-const ShowMethod = 1;
-const QuitMethod = 2;
-
-/**
- * Hides a certain method by calling the HideMethod function.
- *
- * @return {Promise<void>}
- *
- */
-export function Hide() {
-    return call(HideMethod);
-}
-
-/**
- * Calls the ShowMethod and returns the result.
- *
- * @return {Promise<void>}
- */
-export function Show() {
-    return call(ShowMethod);
-}
-
-/**
- * Calls the QuitMethod to terminate the program.
- *
- * @return {Promise<void>}
- */
-export function Quit() {
-    return call(QuitMethod);
-}
+/*
+ _	   __	  _ __
+| |	 / /___ _(_) /____
+| | /| / / __ `/ / / ___/
+| |/ |/ / /_/ / / (__  )
+|__/|__/\__,_/_/_/____/
+The electron alternative for Go
+(c) Lea Anthony 2019-present
+*/
+
+/* jshint esversion: 9 */
+
+import { newRuntimeCallerWithID, objectNames } from "./runtime";
+const call = newRuntimeCallerWithID(objectNames.Application, '');
+
+const HideMethod = 0;
+const ShowMethod = 1;
+const QuitMethod = 2;
+
+/**
+ * Hides a certain method by calling the HideMethod function.
+ *
+ * @return {Promise<void>}
+ *
+ */
+export function Hide() {
+    return call(HideMethod);
+}
+
+/**
+ * Calls the ShowMethod and returns the result.
+ *
+ * @return {Promise<void>}
+ */
+export function Show() {
+    return call(ShowMethod);
+}
+
+/**
+ * Calls the QuitMethod to terminate the program.
+ *
+ * @return {Promise<void>}
+ */
+export function Quit() {
+    return call(QuitMethod);
+}

package/{browser.js → src/browser.js}

@@ -1,24 +1,24 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-import {newRuntimeCallerWithID, objectNames} from "./runtime";
-
-const call = newRuntimeCallerWithID(objectNames.Browser, '');
-const BrowserOpenURL = 0;
-
-/**
- * Open a browser window to the given URL
- * @param {string} url - The URL to open
- * @returns {Promise<string>}
- */
-export function OpenURL(url) {
-    return call(BrowserOpenURL, {url});
-}
+/*
+ _	   __	  _ __
+| |	 / /___ _(_) /____
+| | /| / / __ `/ / / ___/
+| |/ |/ / /_/ / / (__  )
+|__/|__/\__,_/_/_/____/
+The electron alternative for Go
+(c) Lea Anthony 2019-present
+*/
+
+/* jshint esversion: 9 */
+import {newRuntimeCallerWithID, objectNames} from "./runtime";
+
+const call = newRuntimeCallerWithID(objectNames.Browser, '');
+const BrowserOpenURL = 0;
+
+/**
+ * Open a browser window to the given URL
+ * @param {string} url - The URL to open
+ * @returns {Promise<string>}
+ */
+export function OpenURL(url) {
+    return call(BrowserOpenURL, {url});
+}

package/src/calls.js

@@ -0,0 +1,174 @@
+/*
+ _	   __	  _ __
+| |	 / /___ _(_) /____
+| | /| / / __ `/ / / ___/
+| |/ |/ / /_/ / / (__  )
+|__/|__/\__,_/_/_/____/
+The electron alternative for Go
+(c) Lea Anthony 2019-present
+*/
+
+/* jshint esversion: 9 */
+import { newRuntimeCallerWithID, objectNames } from "./runtime";
+import { nanoid } from './nanoid.js';
+
+// Setup
+window._wails = window._wails || {};
+window._wails.callResultHandler = resultHandler;
+window._wails.callErrorHandler = errorHandler;
+
+
+const CallBinding = 0;
+const call = newRuntimeCallerWithID(objectNames.Call, '');
+const cancelCall = newRuntimeCallerWithID(objectNames.CancelCall, '');
+let callResponses = new Map();
+
+/**
+ * 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 {
+        result = nanoid();
+    } while (callResponses.has(result));
+    return result;
+}
+
+/**
+ * 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);
+    }
+}
+
+/**
+ * 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. It also has a cancel method to cancel a long running request.
+ */
+function callBinding(type, options = {}) {
+    const id = generateID();
+    const doCancel = () => { return cancelCall(type, {"call-id": id}) };
+    let queuedCancel = false, callRunning = false;
+    let p = new Promise((resolve, reject) => {
+        options["call-id"] = id;
+        callResponses.set(id, { resolve, reject });
+        call(type, options).
+            then((_) => {
+                callRunning = true;
+                if (queuedCancel) {
+                    return doCancel();
+                }
+            }).
+            catch((error) => {
+                reject(error);
+                callResponses.delete(id);
+            });
+    });
+    p.cancel = () => {
+        if (callRunning) {
+            return doCancel();
+        } else {
+            queuedCancel = true;
+        }
+    };
+
+    return p;
+}
+
+/**
+ * Call method.
+ *
+ * @param {Object} options - The options for the method.
+ * @returns {Object} - The result of the call.
+ */
+export function Call(options) {
+    return callBinding(CallBinding, options);
+}
+
+/**
+ * Executes a method by name.
+ *
+ * @param {string} methodName - The name of the method in the format 'package.struct.method'.
+ * @param {...*} args - The arguments to pass to the method.
+ * @throws {Error} If the name is not a string or is not in the correct format.
+ * @returns {*} The result of the method execution.
+ */
+export function ByName(methodName, ...args) {
+    return callBinding(CallBinding, {
+        methodName,
+        args
+    });
+}
+
+/**
+ * Calls a method by its ID with the specified arguments.
+ *
+ * @param {number} methodID - The ID of the method to call.
+ * @param {...*} args - The arguments to pass to the method.
+ * @return {*} - The result of the method call.
+ */
+export function ByID(methodID, ...args) {
+    return callBinding(CallBinding, {
+        methodID,
+        args
+    });
+}
+
+/**
+ * Calls a method on a plugin.
+ *
+ * @param {string} pluginName - The name of the plugin.
+ * @param {string} methodName - The name of the method to call.
+ * @param {...*} args - The arguments to pass to the method.
+ * @returns {*} - The result of the method call.
+ */
+export function Plugin(pluginName, methodName, ...args) {
+    return callBinding(CallBinding, {
+        packageName: "wails-plugins",
+        structName: pluginName,
+        methodName,
+        args
+    });
+}

package/{clipboard.js → src/clipboard.js}

@@ -1,35 +1,35 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-
-import {newRuntimeCallerWithID, objectNames} from "./runtime";
-
-const call = newRuntimeCallerWithID(objectNames.Clipboard, '');
-const ClipboardSetText = 0;
-const ClipboardText = 1;
-
-/**
- * Sets the text to the Clipboard.
- *
- * @param {string} text - The text to be set to the Clipboard.
- * @return {Promise} - A Promise that resolves when the operation is successful.
- */
-export function SetText(text) {
-    return call(ClipboardSetText, {text});
-}
-
-/**
- * Get the Clipboard text
- * @returns {Promise<string>} A promise that resolves with the text from the Clipboard.
- */
-export function Text() {
-    return call(ClipboardText);
-}
+/*
+ _	   __	  _ __
+| |	 / /___ _(_) /____
+| | /| / / __ `/ / / ___/
+| |/ |/ / /_/ / / (__  )
+|__/|__/\__,_/_/_/____/
+The electron alternative for Go
+(c) Lea Anthony 2019-present
+*/
+
+/* jshint esversion: 9 */
+
+import {newRuntimeCallerWithID, objectNames} from "./runtime";
+
+const call = newRuntimeCallerWithID(objectNames.Clipboard, '');
+const ClipboardSetText = 0;
+const ClipboardText = 1;
+
+/**
+ * Sets the text to the Clipboard.
+ *
+ * @param {string} text - The text to be set to the Clipboard.
+ * @return {Promise} - A Promise that resolves when the operation is successful.
+ */
+export function SetText(text) {
+    return call(ClipboardSetText, {text});
+}
+
+/**
+ * Get the Clipboard text
+ * @returns {Promise<string>} A promise that resolves with the text from the Clipboard.
+ */
+export function Text() {
+    return call(ClipboardText);
+}

package/{contextmenu.js → src/contextmenu.js}

@@ -1,96 +1,97 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-
-import {newRuntimeCallerWithID, objectNames} from "./runtime";
-
-const call = newRuntimeCallerWithID(objectNames.ContextMenu, '');
-const ContextMenuOpen = 0;
-
-function openContextMenu(id, x, y, data) {
-    void call(ContextMenuOpen, {id, x, y, data});
-}
-
-export function setupContextMenus() {
-    window.addEventListener('contextmenu', contextMenuHandler);
-}
-
-function contextMenuHandler(event) {
-    // Check for custom context menu
-    let element = event.target;
-    let customContextMenu = window.getComputedStyle(element).getPropertyValue("--custom-contextmenu");
-    customContextMenu = customContextMenu ? customContextMenu.trim() : "";
-    if (customContextMenu) {
-        event.preventDefault();
-        let customContextMenuData = window.getComputedStyle(element).getPropertyValue("--custom-contextmenu-data");
-        openContextMenu(customContextMenu, event.clientX, event.clientY, customContextMenuData);
-        return
-    }
-
-    processDefaultContextMenu(event);
-}
-
-
-/*
---default-contextmenu: auto; (default) will show the default context menu if contentEditable is true OR text has been selected OR element is input or textarea
---default-contextmenu: show; will always show the default context menu
---default-contextmenu: hide; will always hide the default context menu
-
-This rule is inherited like normal CSS rules, so nesting works as expected
-*/
-function processDefaultContextMenu(event) {
-    // Debug builds always show the menu
-    if (DEBUG) {
-        return;
-    }
-
-    // Process default context menu
-    const element = event.target;
-    const computedStyle = window.getComputedStyle(element);
-    const defaultContextMenuAction = computedStyle.getPropertyValue("--default-contextmenu").trim();
-    switch (defaultContextMenuAction) {
-        case "show":
-            return;
-        case "hide":
-            event.preventDefault();
-            return;
-        default:
-            // Check if contentEditable is true
-            if (element.isContentEditable) {
-                return;
-            }
-
-            // Check if text has been selected
-            const selection = window.getSelection();
-            const hasSelection = (selection.toString().length > 0)
-            if (hasSelection) {
-                for (let i = 0; i < selection.rangeCount; i++) {
-                    const range = selection.getRangeAt(i);
-                    const rects = range.getClientRects();
-                    for (let j = 0; j < rects.length; j++) {
-                        const rect = rects[j];
-                        if (document.elementFromPoint(rect.left, rect.top) === element) {
-                            return;
-                        }
-                    }
-                }
-            }
-            // Check if tagname is input or textarea
-            if (element.tagName === "INPUT" || element.tagName === "TEXTAREA") {
-                if (hasSelection || (!element.readOnly && !element.disabled)) {
-                    return;
-                }
-            }
-
-            // hide default context menu
-            event.preventDefault();
-    }
-}
+/*
+ _	   __	  _ __
+| |	 / /___ _(_) /____
+| | /| / / __ `/ / / ___/
+| |/ |/ / /_/ / / (__  )
+|__/|__/\__,_/_/_/____/
+The electron alternative for Go
+(c) Lea Anthony 2019-present
+*/
+
+/* jshint esversion: 9 */
+
+import {newRuntimeCallerWithID, objectNames} from "./runtime";
+import {IsDebug} from "./system";
+
+// setup
+window.addEventListener('contextmenu', contextMenuHandler);
+
+const call = newRuntimeCallerWithID(objectNames.ContextMenu, '');
+const ContextMenuOpen = 0;
+
+function openContextMenu(id, x, y, data) {
+    void call(ContextMenuOpen, {id, x, y, data});
+}
+
+function contextMenuHandler(event) {
+    // Check for custom context menu
+    let element = event.target;
+    let customContextMenu = window.getComputedStyle(element).getPropertyValue("--custom-contextmenu");
+    customContextMenu = customContextMenu ? customContextMenu.trim() : "";
+    if (customContextMenu) {
+        event.preventDefault();
+        let customContextMenuData = window.getComputedStyle(element).getPropertyValue("--custom-contextmenu-data");
+        openContextMenu(customContextMenu, event.clientX, event.clientY, customContextMenuData);
+        return
+    }
+
+    processDefaultContextMenu(event);
+}
+
+
+/*
+--default-contextmenu: auto; (default) will show the default context menu if contentEditable is true OR text has been selected OR element is input or textarea
+--default-contextmenu: show; will always show the default context menu
+--default-contextmenu: hide; will always hide the default context menu
+
+This rule is inherited like normal CSS rules, so nesting works as expected
+*/
+function processDefaultContextMenu(event) {
+
+    // Debug builds always show the menu
+    if (IsDebug()) {
+        return;
+    }
+
+    // Process default context menu
+    const element = event.target;
+    const computedStyle = window.getComputedStyle(element);
+    const defaultContextMenuAction = computedStyle.getPropertyValue("--default-contextmenu").trim();
+    switch (defaultContextMenuAction) {
+        case "show":
+            return;
+        case "hide":
+            event.preventDefault();
+            return;
+        default:
+            // Check if contentEditable is true
+            if (element.isContentEditable) {
+                return;
+            }
+
+            // Check if text has been selected
+            const selection = window.getSelection();
+            const hasSelection = (selection.toString().length > 0)
+            if (hasSelection) {
+                for (let i = 0; i < selection.rangeCount; i++) {
+                    const range = selection.getRangeAt(i);
+                    const rects = range.getClientRects();
+                    for (let j = 0; j < rects.length; j++) {
+                        const rect = rects[j];
+                        if (document.elementFromPoint(rect.left, rect.top) === element) {
+                            return;
+                        }
+                    }
+                }
+            }
+            // Check if tagname is input or textarea
+            if (element.tagName === "INPUT" || element.tagName === "TEXTAREA") {
+                if (hasSelection || (!element.readOnly && !element.disabled)) {
+                    return;
+                }
+            }
+
+            // hide default context menu
+            event.preventDefault();
+    }
+}