@wailsio/runtime 3.0.0-alpha.9 → 3.0.0-alpha.94

package/src/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/src/index.d.ts

@@ -1,136 +0,0 @@
-declare module '@wailsio/runtime';
-
-/**
- * Describes the properties of a Button object.
- */
-export interface Button {
-    // Text that appears within the button.
-    Label?: string;
-    // True if the button should cancel an operation when clicked.
-    IsCancel?: boolean;
-    // True if the button should be the default action when the user presses enter.
-    IsDefault?: boolean;
-}
-
-/**
- * Describes the properties of a FileFilter object.
- */
-export interface FileFilter {
-    // Display name for the filter, it could be "Text Files", "Images" etc.
-    DisplayName?: string;
-    // Pattern to match for the filter, e.g. "*.txt;*.md" for text markdown files.
-    Pattern?: string;
-}
-
-/**
- * Describes the properties of a Position object.
- */
-export interface Position {
-    X: number;
-    Y: number;
-}
-
-/**
- * Describes the properties of a Size object.
- * Extends the properties of Position.
- */
-export type Size = Position;
-
-/**
- * Describes the properties of a Rect object.
- * Extends the properties of Size.
- */
-export type Rect = Size & Position;
-
-/**
- * Describes the possible rotations a Screen can have.
- */
-export enum Rotation {
-    Zero = 0,
-    Ninety = 90,
-    OneEighty = 180,
-    TwoSeventy = 270
-}
-
-/**
- * Describes the properties of a Screen object.
- */
-export interface Screen {
-    // Unique identifier for the screen.
-    Id: string;
-    // Human readable name of the screen.
-    Name: string;
-    // The resolution scale of the screen. 1 = standard resolution, 2 = high (Retina), etc.
-    Scale: number;
-    // Contains the X and Y coordinates of the screen's position.
-    Position: Position;
-    // Contains the width and height of the screen.
-    Size: Size;
-    // Contains the bounds of the screen in terms of X, Y, Width, and Height.
-    Bounds: Rect;
-    // Contains the area of the screen that is actually usable (excluding taskbar and other system UI).
-    WorkArea: Rect;
-    // True if this is the primary monitor selected by the user in the operating system.
-    IsPrimary: boolean;
-    // The rotation of the screen. Can be one of 0, 90, 180, 270 degrees.
-    Rotation: Rotation;
-}
-
-/**
- * Describes the properties of a MessageDialogOptions object.
- */
-export interface MessageDialogOptions {
-    // The title of the dialog window.
-    Title?: string;
-    // The main message to show in the dialog.
-    Message?: string;
-    // Array of button options to show in the dialog.
-    Buttons?: Button[];
-    // True if the dialog should appear detached from the main window (if applicable).
-    Detached?: boolean;
-}
-
-/**
- * Describes the properties common to OpenFileDialogOptions and SaveFileDialogOptions objects.
- */
-export interface DialogOptions {
-    CanChooseDirectories?: boolean;
-    CanChooseFiles?: boolean;
-    CanCreateDirectories?: boolean;
-    ShowHiddenFiles?: boolean;
-    ResolvesAliases?: boolean;
-    AllowsMultipleSelection?: boolean;
-    HideExtension?: boolean;
-    CanSelectHiddenExtension?: boolean;
-    TreatsFilePackagesAsDirectories?: boolean;
-    AllowsOtherFiletypes?: boolean;
-    Filters?: FileFilter[];
-    Title?: string;
-    Message?: string;
-    ButtonText?: string;
-    Directory?: string;
-    Detached?: boolean;
-}
-
-/**
- * Describes properties unique to OpenFileDialogOptions.
- */
-export type OpenFileDialogOptions = DialogOptions;
-
-/**
- * Describes properties unique to SaveFileDialogOptions.
- */
-export type SaveFileDialogOptions = DialogOptions & {
-    // Default filename to use for the save dialog.
-    Filename?: string;
-};
-
-/**
- * Describes the properties of a WailsEvent object.
- */
-export interface WailsEvent {
-    // The name of the event.
-    Name: string;
-    // Any data associated with the event.
-    Data?: unknown;
-}

package/src/index.js

@@ -1,58 +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";
-
-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";
-
-export { Application, Browser, Clipboard, ContextMenu, Flags, Runtime, Screens, System, 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/src/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));
-    });
-}

package/src/screens.js

@@ -1,45 +0,0 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-
-/**
- * @typedef {import("./api/types").Screen} Screen
- */
-
-import {newRuntimeCallerWithID, objectNames} from "./runtime";
-const call = newRuntimeCallerWithID(objectNames.Screens, '');
-
-const getAll = 0;
-const getPrimary = 1;
-const getCurrent = 2;
-
-/**
- * Gets all screens.
- * @returns {Promise<Screen[]>} A promise that resolves to an array of Screen objects.
- */
-export function GetAll() {
-    return call(getAll);
-}
-/**
- * Gets the primary screen.
- * @returns {Promise<Screen>} A promise that resolves to the primary screen.
- */
-export function GetPrimary() {
-    return call(getPrimary);
-}
-/**
- * Gets the current active screen.
- *
- * @returns {Promise<Screen>} A promise that resolves with the current active screen.
- */
-export function GetCurrent() {
-    return call(getCurrent);
-}

package/src/system.js

@@ -1,122 +0,0 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-
-import {newRuntimeCallerWithID, objectNames} from "./runtime";
-let call = newRuntimeCallerWithID(objectNames.System, '');
-const systemIsDarkMode = 0;
-const environment = 1;
-
-/**
- * @function
- * Retrieves the system dark mode status.
- * @returns {Promise<boolean>} - A promise that resolves to a boolean value indicating if the system is in dark mode.
- */
-export function IsDarkMode() {
-    return call(systemIsDarkMode);
-}
-
-
-/**
- * Fetches the capabilities of the application from the server.
- *
- * @async
- * @function Capabilities
- * @returns {Promise<Object>} A promise that resolves to an object containing the capabilities.
- */
-export async function Capabilities() {
-    let response = fetch("/wails/capabilities");
-    return response.json();
-}
-
-/**
- * @typedef {object} EnvironmentInfo
- * @property {string} OS - The operating system in use.
- * @property {string} Arch - The architecture of the system.
- */
-
-/**
- * @function
- * Retrieves environment details.
- * @returns {Promise<EnvironmentInfo>} - A promise that resolves to an object containing OS and system architecture.
- */
-export function Environment() {
-    return call(environment);
-}
-
-export let invoke = null;
-let environmentCache = null;
-
-Environment()
-    .then(result => {
-        environmentCache = result;
-        invoke = IsWindows() ? window.chrome.webview.postMessage : window.webkit.messageHandlers.external.postMessage;
-    })
-    .catch(error => {
-        console.error(`Error getting Environment: ${error}`);
-    });
-
-/**
- * Checks if the current operating system is Windows.
- *
- * @return {boolean} True if the operating system is Windows, otherwise false.
- */
-export function IsWindows() {
-    return environmentCache.OS === "windows";
-}
-
-/**
- * Checks if the current operating system is Linux.
- *
- * @returns {boolean} Returns true if the current operating system is Linux, false otherwise.
- */
-export function IsLinux() {
-    return environmentCache.OS === "linux";
-}
-
-/**
- * Checks if the current environment is a macOS operating system.
- *
- * @returns {boolean} True if the environment is macOS, false otherwise.
- */
-export function IsMac() {
-    return environmentCache.OS === "darwin";
-}
-
-/**
- * Checks if the current environment architecture is AMD64.
- * @returns {boolean} True if the current environment architecture is AMD64, false otherwise.
- */
-export function IsAMD64() {
-    return environmentCache.Arch === "amd64";
-}
-
-/**
- * Checks if the current architecture is ARM.
- *
- * @returns {boolean} True if the current architecture is ARM, false otherwise.
- */
-export function IsARM() {
-    return environmentCache.Arch === "arm";
-}
-
-/**
- * Checks if the current environment is ARM64 architecture.
- *
- * @returns {boolean} - Returns true if the environment is ARM64 architecture, otherwise returns false.
- */
-export function IsARM64() {
-    return environmentCache.Arch === "arm64";
-}
-
-export function IsDebug() {
-    return environmentCache.Debug === true;
-}

package/src/window.js

@@ -1,122 +0,0 @@
-/*
- _	   __	  _ __
-| |	 / /___ _(_) /____
-| | /| / / __ `/ / / ___/
-| |/ |/ / /_/ / / (__  )
-|__/|__/\__,_/_/_/____/
-The electron alternative for Go
-(c) Lea Anthony 2019-present
-*/
-
-/* jshint esversion: 9 */
-
-/**
- * @typedef {import("../api/types").Size} Size
- * @typedef {import("../api/types").Position} Position
- * @typedef {import("../api/types").Screen} Screen
- */
-
-import {newRuntimeCallerWithID, objectNames} from "./runtime";
-
-const center = 0;
-const setTitle = 1;
-const fullscreen = 2;
-const unFullscreen = 3;
-const setSize = 4;
-const size = 5;
-const setMaxSize = 6;
-const setMinSize = 7;
-const setAlwaysOnTop = 8;
-const setRelativePosition = 9;
-const relativePosition = 10;
-const screen = 11;
-const hide = 12;
-const maximise = 13;
-const unMaximise = 14;
-const toggleMaximise = 15;
-const minimise = 16;
-const unMinimise = 17;
-const restore = 18;
-const show = 19;
-const close = 20;
-const setBackgroundColour = 21;
-const setResizable = 22;
-const width = 23;
-const height = 24;
-const zoomIn = 25;
-const zoomOut = 26;
-const zoomReset = 27;
-const getZoomLevel = 28;
-const setZoomLevel = 29;
-
-const thisWindow = newRuntimeCallerWithID(objectNames.Window, '');
-
-function createWindow(call) {
-    return {
-        Get: (windowName) => createWindow(newRuntimeCallerWithID(objectNames.Window, windowName)),
-        Center: () => call(center),
-        SetTitle: (title) => call(setTitle, {title}),
-        Fullscreen: () => call(fullscreen),
-        UnFullscreen: () => call(unFullscreen),
-        SetSize: (width, height) => call(setSize, {width, height}),
-        Size: () => call(size),
-        SetMaxSize: (width, height) => call(setMaxSize, {width, height}),
-        SetMinSize: (width, height) => call(setMinSize, {width, height}),
-        SetAlwaysOnTop: (onTop) => call(setAlwaysOnTop, {alwaysOnTop: onTop}),
-        SetRelativePosition: (x, y) => call(setRelativePosition, {x, y}),
-        RelativePosition: () => call(relativePosition),
-        Screen: () => call(screen),
-        Hide: () => call(hide),
-        Maximise: () => call(maximise),
-        UnMaximise: () => call(unMaximise),
-        ToggleMaximise: () => call(toggleMaximise),
-        Minimise: () => call(minimise),
-        UnMinimise: () => call(unMinimise),
-        Restore: () => call(restore),
-        Show: () => call(show),
-        Close: () => call(close),
-        SetBackgroundColour: (r, g, b, a) => call(setBackgroundColour, {r, g, b, a}),
-        SetResizable: (resizable) => call(setResizable, {resizable}),
-        Width: () => call(width),
-        Height: () => call(height),
-        ZoomIn: () => call(zoomIn),
-        ZoomOut: () => call(zoomOut),
-        ZoomReset: () => call(zoomReset),
-        GetZoomLevel: () => call(getZoomLevel),
-        SetZoomLevel: (zoomLevel) => call(setZoomLevel, {zoomLevel}),
-    };
-}
-
-/**
- * Gets the specified window.
- *
- * @param {string} windowName - The name of the window to get.
- * @return {Object} - The specified window object.
- */
-export function Get(windowName) {
-    return createWindow(newRuntimeCallerWithID(objectNames.Window, windowName));
-}
-
-/**
- * Returns a map of all methods in the current window.
- * @returns {Map} - A map of window methods.
- */
-export function WindowMethods(targetWindow) {
-    // Create a new map to store methods
-    let result = new Map();
-
-    // Iterate over all properties of the window object
-    for (let method in targetWindow) {
-        // Check if the property is indeed a method (function)
-        if(typeof targetWindow[method] === 'function') {
-            // Add the method to the map
-            result.set(method, targetWindow[method]);
-        }
-
-    }
-    // Return the map of window methods
-    return result;
-}
-export default {
-    ...Get('')
-}