@wailsio/runtime 3.0.0-alpha.7 → 3.0.0-alpha.72

package/dialogs.js

@@ -1,138 +0,0 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-
-/**
- * @typedef {import("./types").MessageDialogOptions} MessageDialogOptions
- * @typedef {import("./types").OpenDialogOptions} OpenDialogOptions
- * @typedef {import("./types").SaveDialogOptions} SaveDialogOptions
- */
-
-import {newRuntimeCallerWithID, objectNames} from "./runtime";
-
-import { nanoid } from 'nanoid/non-secure';
-
-// Define constants from the `methods` object in Title Case
-const DialogInfo = 0;
-const DialogWarning = 1;
-const DialogError = 2;
-const DialogQuestion = 3;
-const DialogOpenFile = 4;
-const DialogSaveFile = 5;
-
-const call = newRuntimeCallerWithID(objectNames.Dialog, '');
-const dialogResponses = new Map();
-
-/**
- * Generates a unique id that is not present in dialogResponses.
- * @returns {string} unique id
- */
-function generateID() {
-    let result;
-    do {
-        result = nanoid();
-    } while (dialogResponses.has(result));
-    return result;
-}
-
-/**
- * Shows a dialog of specified type with the given options.
- * @param {number} type - type of dialog
- * @param {object} options - options for the dialog
- * @returns {Promise} promise that resolves with result of dialog
- */
-function dialog(type, options = {}) {
-    const id = generateID();
-    options["dialog-id"] = id;
-    return new Promise((resolve, reject) => {
-        dialogResponses.set(id, {resolve, reject});
-        call(type, options).catch((error) => {
-            reject(error);
-            dialogResponses.delete(id);
-        });
-    });
-}
-
-/**
- * Handles the callback from a dialog.
- *
- * @param {string} id - The ID of the dialog response.
- * @param {string} data - The data received from the dialog.
- * @param {boolean} isJSON - Flag indicating whether the data is in JSON format.
- *
- * @return {undefined}
- */
-export function dialogCallback(id, data, isJSON) {
-    let p = dialogResponses.get(id);
-    if (p) {
-        if (isJSON) {
-            p.resolve(JSON.parse(data));
-        } else {
-            p.resolve(data);
-        }
-        dialogResponses.delete(id);
-    }
-}
-
-/**
- * Callback function for handling errors in dialog.
- *
- * @param {string} id - The id of the dialog response.
- * @param {string} message - The error message.
- *
- * @return {void}
- */
-export function dialogErrorCallback(id, message) {
-    let p = dialogResponses.get(id);
-    if (p) {
-        p.reject(message);
-        dialogResponses.delete(id);
-    }
-}
-
-
-// Replace `methods` with constants in Title Case
-
-/**
- * @param {MessageDialogOptions} options - Dialog options
- * @returns {Promise<string>} - The label of the button pressed
- */
-export const Info = (options) => dialog(DialogInfo, options);
-
-/**
- * @param {MessageDialogOptions} options - Dialog options
- * @returns {Promise<string>} - The label of the button pressed
- */
-export const Warning = (options) => dialog(DialogWarning, options);
-
-/**
- * @param {MessageDialogOptions} options - Dialog options
- * @returns {Promise<string>} - The label of the button pressed
- */
-export const Error = (options) => dialog(DialogError, options);
-
-/**
- * @param {MessageDialogOptions} options - Dialog options
- * @returns {Promise<string>} - The label of the button pressed
- */
-export const Question = (options) => dialog(DialogQuestion, options);
-
-/**
- * @param {OpenDialogOptions} 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
- * @returns {Promise<string>} Returns the selected file. Returns blank string if no file is selected.
- */
-export const SaveFile = (options) => dialog(DialogSaveFile, options);

package/drag.js

@@ -1,125 +0,0 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-
-import {invoke, IsWindows} from "./system";
-import {GetFlag} from "./flags";
-
-let shouldDrag = false;
-let resizeEdge = null;
-let resizable = false;
-let defaultCursor = "auto";
-window._wails = window._wails || {};
-window._wails.setResizable = setResizable;
-window._wails.endDrag = endDrag;
-
-export function dragTest(e) {
-    let val = window.getComputedStyle(e.target).getPropertyValue("--webkit-app-region");
-    if (val && val.trim() !== "drag" || e.buttons !== 1) {
-        return false;
-    }
-    return e.detail === 1;
-}
-
-export function setupDrag() {
-    window.addEventListener('mousedown', onMouseDown);
-    window.addEventListener('mousemove', onMouseMove);
-    window.addEventListener('mouseup', onMouseUp);
-}
-
-export function setResizable(value) {
-    resizable = value;
-}
-
-export function endDrag() {
-    document.body.style.cursor = 'default';
-    shouldDrag = false;
-}
-
-function testResize() {
-    if( resizeEdge ) {
-        invoke(`resize:${resizeEdge}`);
-        return true
-    }
-    return false;
-}
-
-function onMouseDown(e) {
-    if(IsWindows() && testResize() || dragTest(e)) {
-        shouldDrag = !!isValidDrag(e);
-    }
-}
-
-function isValidDrag(e) {
-    // Ignore drag on scrollbars
-    return !(e.offsetX > e.target.clientWidth || e.offsetY > e.target.clientHeight);
-}
-
-function onMouseUp(e) {
-    let mousePressed = e.buttons !== undefined ? e.buttons : e.which;
-    if (mousePressed > 0) {
-        endDrag();
-    }
-}
-
-function setResize(cursor = defaultCursor) {
-    document.documentElement.style.cursor = cursor;
-    resizeEdge = cursor;
-}
-
-function onMouseMove(e) {
-    shouldDrag = checkDrag(e);
-    if (IsWindows() && resizable) {
-        handleResize(e);
-    }
-}
-
-function checkDrag(e) {
-    let mousePressed = e.buttons !== undefined ? e.buttons : e.which;
-    if(shouldDrag && mousePressed > 0) {
-        invoke("drag");
-        return false;
-    }
-    return shouldDrag;
-}
-
-function handleResize(e) {
-    let resizeHandleHeight = GetFlag("system.resizeHandleHeight") || 5;
-    let resizeHandleWidth = GetFlag("system.resizeHandleWidth") || 5;
-
-    // Extra pixels for the corner areas
-    let cornerExtra = GetFlag("resizeCornerExtra") || 10;
-
-    let rightBorder = window.outerWidth - e.clientX < resizeHandleWidth;
-    let leftBorder = e.clientX < resizeHandleWidth;
-    let topBorder = e.clientY < resizeHandleHeight;
-    let bottomBorder = window.outerHeight - e.clientY < resizeHandleHeight;
-
-    // Adjust for corners
-    let rightCorner = window.outerWidth - e.clientX < (resizeHandleWidth + cornerExtra);
-    let leftCorner = e.clientX < (resizeHandleWidth + cornerExtra);
-    let topCorner = e.clientY < (resizeHandleHeight + cornerExtra);
-    let bottomCorner = window.outerHeight - e.clientY < (resizeHandleHeight + cornerExtra);
-
-    // If we aren't on an edge, but were, reset the cursor to default
-    if (!leftBorder && !rightBorder && !topBorder && !bottomBorder && resizeEdge !== undefined) {
-        setResize();
-    }
-    // Adjusted for corner areas
-    else if (rightCorner && bottomCorner) setResize("se-resize");
-    else if (leftCorner && bottomCorner) setResize("sw-resize");
-    else if (leftCorner && topCorner) setResize("nw-resize");
-    else if (topCorner && rightCorner) setResize("ne-resize");
-    else if (leftBorder) setResize("w-resize");
-    else if (topBorder) setResize("n-resize");
-    else if (bottomBorder) setResize("s-resize");
-    else if (rightBorder) setResize("e-resize");
-}

package/events.js

@@ -1,134 +0,0 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-
-/**
- * @typedef {import("./types").WailsEvent} WailsEvent
- */
-import {newRuntimeCallerWithID, objectNames} from "./runtime";
-
-const call = newRuntimeCallerWithID(objectNames.Events, '');
-const EmitMethod = 0;
-const eventListeners = new Map();
-
-class Listener {
-    constructor(eventName, callback, maxCallbacks) {
-        this.eventName = eventName;
-        this.maxCallbacks = maxCallbacks || -1;
-        this.Callback = (data) => {
-            callback(data);
-            if (this.maxCallbacks === -1) return false;
-            this.maxCallbacks -= 1;
-            return this.maxCallbacks === 0;
-        };
-    }
-}
-
-export class WailsEvent {
-    constructor(name, data = null) {
-        this.name = name;
-        this.data = data;
-    }
-}
-
-
-window._wails = window._wails || {};
-window._wails.dispatchWailsEvent = dispatchWailsEvent;
-
-export function dispatchWailsEvent(event) {
-    let listeners = eventListeners.get(event.name);
-    if (listeners) {
-        let toRemove = listeners.filter(listener => {
-            let remove = listener.Callback(event);
-            if (remove) return true;
-        });
-        if (toRemove.length > 0) {
-            listeners = listeners.filter(l => !toRemove.includes(l));
-            if (listeners.length === 0) eventListeners.delete(event.name);
-            else eventListeners.set(event.name, listeners);
-        }
-    }
-}
-
-/**
- * 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.
- */
-export function OnMultiple(eventName, callback, maxCallbacks) {
-    let listeners = eventListeners.get(eventName) || [];
-    const thisListener = new Listener(eventName, callback, maxCallbacks);
-    listeners.push(thisListener);
-    eventListeners.set(eventName, listeners);
-    return () => listenerOff(thisListener);
-}
-
-/**
- * Registers a callback function to be executed when the specified event occurs.
- *
- * @param {string} eventName - The name of the event.
- * @param {function} callback - The callback function to be executed. It takes no parameters.
- * @return {function} - A function that, when called, will unregister the callback from the event. */
-export function On(eventName, callback) { return OnMultiple(eventName, callback, -1); }
-
-/**
- * Registers a callback function to be executed only once for the specified event.
- *
- * @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.
- */
-export function Once(eventName, callback) { return OnMultiple(eventName, callback, 1); }
-
-/**
- * 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.
- */
-function listenerOff(listener) {
-    const eventName = listener.eventName;
-    let listeners = eventListeners.get(eventName).filter(l => l !== listener);
-    if (listeners.length === 0) eventListeners.delete(eventName);
-    else eventListeners.set(eventName, listeners);
-}
-
-
-/**
- * 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}
- */
-export function Off(eventName, ...additionalEventNames) {
-    let eventsToRemove = [eventName, ...additionalEventNames];
-    eventsToRemove.forEach(eventName => eventListeners.delete(eventName));
-}
-/**
- * Removes all event listeners.
- *
- * @function OffAll
- * @returns {void}
- */
-export function OffAll() { eventListeners.clear(); }
-
-/**
- * Emits an event using the given event name.
- *
- * @param {WailsEvent} event - The name of the event to emit.
- * @returns {any} - The result of the emitted event.
- */
-export function Emit(event) { return call(EmitMethod, event); }

package/flags.js

@@ -1,63 +0,0 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-
-let flags = new Map();
-
-function convertToMap(obj) {
-    const map = new Map();
-
-    for (const [key, value] of Object.entries(obj)) {
-        if (typeof value === 'object' && value !== null) {
-            map.set(key, convertToMap(value)); // Recursively convert nested object
-        } else {
-            map.set(key, value);
-        }
-    }
-
-    return map;
-}
-
-fetch("/wails/flags").then((response) => {
-    response.json().then((data) => {
-        flags = convertToMap(data);
-    });
-});
-
-
-function getValueFromMap(keyString) {
-    const keys = keyString.split('.');
-    let value = flags;
-
-    for (const key of keys) {
-        if (value instanceof Map) {
-            value = value.get(key);
-        } else {
-            value = value[key];
-        }
-
-        if (value === undefined) {
-            break;
-        }
-    }
-
-    return value;
-}
-
-/**
- * Retrieves the value associated with the specified key from the flag map.
- *
- * @param {string} keyString - The key to retrieve the value for.
- * @return {*} - The value associated with the specified key.
- */
-export function GetFlag(keyString) {
-    return getValueFromMap(keyString);
-}

package/index.js

@@ -1,56 +0,0 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-import {setupContextMenus} from "./contextmenu";
-import {setupDrag} from "./drag";
-import {reloadWML} from "./wml";
-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";
-
-export * as Application from "./application";
-export * as Browser from "./browser";
-export * as Clipboard from "./clipboard";
-export * as ContextMenu from "./contextmenu";
-export * as Flags from "./flags";
-export * as Runtime from "./runtime";
-export * as Screens from "./screens";
-export * as System from "./system";
-export * as Window from "./window";
-
-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
-}
-
-setupContextMenus();
-setupDrag();
-
-document.addEventListener("DOMContentLoaded", function () {
-    reloadWML();
-});

package/runtime.js

@@ -1,122 +0,0 @@
-/*
- _     __     _ __
-| |  / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-import { nanoid } from 'nanoid/non-secure';
-
-const runtimeURL = window.location.origin + "/wails/runtime";
-
-// Object Names
-export const objectNames = {
-    Call: 0,
-    Clipboard: 1,
-    Application: 2,
-    Events: 3,
-    ContextMenu: 4,
-    Dialog: 5,
-    Window: 6,
-    Screens: 7,
-    System: 8,
-    Browser: 9,
-}
-export let clientId = nanoid();
-
-/**
- * Creates a runtime caller function that invokes a specified method on a given object within a specified window context.
- *
- * @param {Object} object - The object on which the method is to be invoked.
- * @param {string} windowName - The name of the window context in which the method should be called.
- * @returns {Function} A runtime caller function that takes the method name and optionally arguments and invokes the method within the specified window context.
- */
-export function newRuntimeCaller(object, windowName) {
-    return function (method, args=null) {
-        return runtimeCall(object + "." + method, windowName, args);
-    };
-}
-
-/**
- * Creates a new runtime caller with specified ID.
- *
- * @param {object} object - The object to invoke the method on.
- * @param {string} windowName - The name of the window.
- * @return {Function} - The new runtime caller function.
- */
-export function newRuntimeCallerWithID(object, windowName) {
-    return function (method, args=null) {
-        return runtimeCallWithID(object, method, windowName, args);
-    };
-}
-
-
-function runtimeCall(method, windowName, args) {
-    let url = new URL(runtimeURL);
-    if( method ) {
-        url.searchParams.append("method", method);
-    }
-    let fetchOptions = {
-        headers: {},
-    };
-    if (windowName) {
-        fetchOptions.headers["x-wails-window-name"] = windowName;
-    }
-    if (args) {
-        url.searchParams.append("args", JSON.stringify(args));
-    }
-    fetchOptions.headers["x-wails-client-id"] = clientId;
-
-    return new Promise((resolve, reject) => {
-        fetch(url, fetchOptions)
-            .then(response => {
-                if (response.ok) {
-                    // check content type
-                    if (response.headers.get("Content-Type") && response.headers.get("Content-Type").indexOf("application/json") !== -1) {
-                        return response.json();
-                    } else {
-                        return response.text();
-                    }
-                }
-                reject(Error(response.statusText));
-            })
-            .then(data => resolve(data))
-            .catch(error => reject(error));
-    });
-}
-
-function runtimeCallWithID(objectID, method, windowName, args) {
-    let url = new URL(runtimeURL);
-    url.searchParams.append("object", objectID);
-    url.searchParams.append("method", method);
-    let fetchOptions = {
-        headers: {},
-    };
-    if (windowName) {
-        fetchOptions.headers["x-wails-window-name"] = windowName;
-    }
-    if (args) {
-        url.searchParams.append("args", JSON.stringify(args));
-    }
-    fetchOptions.headers["x-wails-client-id"] = clientId;
-    return new Promise((resolve, reject) => {
-        fetch(url, fetchOptions)
-            .then(response => {
-                if (response.ok) {
-                    // check content type
-                    if (response.headers.get("Content-Type") && response.headers.get("Content-Type").indexOf("application/json") !== -1) {
-                        return response.json();
-                    } else {
-                        return response.text();
-                    }
-                }
-                reject(Error(response.statusText));
-            })
-            .then(data => resolve(data))
-            .catch(error => reject(error));
-    });
-}