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

package/types/event_types.d.ts

@@ -0,0 +1,221 @@
+export declare const Types: Readonly<{
+    Windows: Readonly<{
+        APMPowerSettingChange: "windows:APMPowerSettingChange";
+        APMPowerStatusChange: "windows:APMPowerStatusChange";
+        APMResumeAutomatic: "windows:APMResumeAutomatic";
+        APMResumeSuspend: "windows:APMResumeSuspend";
+        APMSuspend: "windows:APMSuspend";
+        ApplicationStarted: "windows:ApplicationStarted";
+        SystemThemeChanged: "windows:SystemThemeChanged";
+        WebViewNavigationCompleted: "windows:WebViewNavigationCompleted";
+        WindowActive: "windows:WindowActive";
+        WindowBackgroundErase: "windows:WindowBackgroundErase";
+        WindowClickActive: "windows:WindowClickActive";
+        WindowClosing: "windows:WindowClosing";
+        WindowDidMove: "windows:WindowDidMove";
+        WindowDidResize: "windows:WindowDidResize";
+        WindowDPIChanged: "windows:WindowDPIChanged";
+        WindowDragDrop: "windows:WindowDragDrop";
+        WindowDragEnter: "windows:WindowDragEnter";
+        WindowDragLeave: "windows:WindowDragLeave";
+        WindowDragOver: "windows:WindowDragOver";
+        WindowEndMove: "windows:WindowEndMove";
+        WindowEndResize: "windows:WindowEndResize";
+        WindowFullscreen: "windows:WindowFullscreen";
+        WindowHide: "windows:WindowHide";
+        WindowInactive: "windows:WindowInactive";
+        WindowKeyDown: "windows:WindowKeyDown";
+        WindowKeyUp: "windows:WindowKeyUp";
+        WindowKillFocus: "windows:WindowKillFocus";
+        WindowNonClientHit: "windows:WindowNonClientHit";
+        WindowNonClientMouseDown: "windows:WindowNonClientMouseDown";
+        WindowNonClientMouseLeave: "windows:WindowNonClientMouseLeave";
+        WindowNonClientMouseMove: "windows:WindowNonClientMouseMove";
+        WindowNonClientMouseUp: "windows:WindowNonClientMouseUp";
+        WindowPaint: "windows:WindowPaint";
+        WindowRestore: "windows:WindowRestore";
+        WindowSetFocus: "windows:WindowSetFocus";
+        WindowShow: "windows:WindowShow";
+        WindowStartMove: "windows:WindowStartMove";
+        WindowStartResize: "windows:WindowStartResize";
+        WindowUnFullscreen: "windows:WindowUnFullscreen";
+        WindowZOrderChanged: "windows:WindowZOrderChanged";
+        WindowMinimise: "windows:WindowMinimise";
+        WindowUnMinimise: "windows:WindowUnMinimise";
+        WindowMaximise: "windows:WindowMaximise";
+        WindowUnMaximise: "windows:WindowUnMaximise";
+    }>;
+    Mac: Readonly<{
+        ApplicationDidBecomeActive: "mac:ApplicationDidBecomeActive";
+        ApplicationDidChangeBackingProperties: "mac:ApplicationDidChangeBackingProperties";
+        ApplicationDidChangeEffectiveAppearance: "mac:ApplicationDidChangeEffectiveAppearance";
+        ApplicationDidChangeIcon: "mac:ApplicationDidChangeIcon";
+        ApplicationDidChangeOcclusionState: "mac:ApplicationDidChangeOcclusionState";
+        ApplicationDidChangeScreenParameters: "mac:ApplicationDidChangeScreenParameters";
+        ApplicationDidChangeStatusBarFrame: "mac:ApplicationDidChangeStatusBarFrame";
+        ApplicationDidChangeStatusBarOrientation: "mac:ApplicationDidChangeStatusBarOrientation";
+        ApplicationDidChangeTheme: "mac:ApplicationDidChangeTheme";
+        ApplicationDidFinishLaunching: "mac:ApplicationDidFinishLaunching";
+        ApplicationDidHide: "mac:ApplicationDidHide";
+        ApplicationDidResignActive: "mac:ApplicationDidResignActive";
+        ApplicationDidUnhide: "mac:ApplicationDidUnhide";
+        ApplicationDidUpdate: "mac:ApplicationDidUpdate";
+        ApplicationShouldHandleReopen: "mac:ApplicationShouldHandleReopen";
+        ApplicationWillBecomeActive: "mac:ApplicationWillBecomeActive";
+        ApplicationWillFinishLaunching: "mac:ApplicationWillFinishLaunching";
+        ApplicationWillHide: "mac:ApplicationWillHide";
+        ApplicationWillResignActive: "mac:ApplicationWillResignActive";
+        ApplicationWillTerminate: "mac:ApplicationWillTerminate";
+        ApplicationWillUnhide: "mac:ApplicationWillUnhide";
+        ApplicationWillUpdate: "mac:ApplicationWillUpdate";
+        MenuDidAddItem: "mac:MenuDidAddItem";
+        MenuDidBeginTracking: "mac:MenuDidBeginTracking";
+        MenuDidClose: "mac:MenuDidClose";
+        MenuDidDisplayItem: "mac:MenuDidDisplayItem";
+        MenuDidEndTracking: "mac:MenuDidEndTracking";
+        MenuDidHighlightItem: "mac:MenuDidHighlightItem";
+        MenuDidOpen: "mac:MenuDidOpen";
+        MenuDidPopUp: "mac:MenuDidPopUp";
+        MenuDidRemoveItem: "mac:MenuDidRemoveItem";
+        MenuDidSendAction: "mac:MenuDidSendAction";
+        MenuDidSendActionToItem: "mac:MenuDidSendActionToItem";
+        MenuDidUpdate: "mac:MenuDidUpdate";
+        MenuWillAddItem: "mac:MenuWillAddItem";
+        MenuWillBeginTracking: "mac:MenuWillBeginTracking";
+        MenuWillDisplayItem: "mac:MenuWillDisplayItem";
+        MenuWillEndTracking: "mac:MenuWillEndTracking";
+        MenuWillHighlightItem: "mac:MenuWillHighlightItem";
+        MenuWillOpen: "mac:MenuWillOpen";
+        MenuWillPopUp: "mac:MenuWillPopUp";
+        MenuWillRemoveItem: "mac:MenuWillRemoveItem";
+        MenuWillSendAction: "mac:MenuWillSendAction";
+        MenuWillSendActionToItem: "mac:MenuWillSendActionToItem";
+        MenuWillUpdate: "mac:MenuWillUpdate";
+        WebViewDidCommitNavigation: "mac:WebViewDidCommitNavigation";
+        WebViewDidFinishNavigation: "mac:WebViewDidFinishNavigation";
+        WebViewDidReceiveServerRedirectForProvisionalNavigation: "mac:WebViewDidReceiveServerRedirectForProvisionalNavigation";
+        WebViewDidStartProvisionalNavigation: "mac:WebViewDidStartProvisionalNavigation";
+        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";
+        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";
+        WindowDidZoom: "mac:WindowDidZoom";
+        WindowFileDraggingEntered: "mac:WindowFileDraggingEntered";
+        WindowFileDraggingExited: "mac:WindowFileDraggingExited";
+        WindowFileDraggingPerformed: "mac:WindowFileDraggingPerformed";
+        WindowHide: "mac:WindowHide";
+        WindowMaximise: "mac:WindowMaximise";
+        WindowUnMaximise: "mac:WindowUnMaximise";
+        WindowMinimise: "mac:WindowMinimise";
+        WindowUnMinimise: "mac:WindowUnMinimise";
+        WindowShouldClose: "mac:WindowShouldClose";
+        WindowShow: "mac:WindowShow";
+        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";
+        WindowZoomIn: "mac:WindowZoomIn";
+        WindowZoomOut: "mac:WindowZoomOut";
+        WindowZoomReset: "mac:WindowZoomReset";
+    }>;
+    Linux: Readonly<{
+        ApplicationStartup: "linux:ApplicationStartup";
+        SystemThemeChanged: "linux:SystemThemeChanged";
+        WindowDeleteEvent: "linux:WindowDeleteEvent";
+        WindowDidMove: "linux:WindowDidMove";
+        WindowDidResize: "linux:WindowDidResize";
+        WindowFocusIn: "linux:WindowFocusIn";
+        WindowFocusOut: "linux:WindowFocusOut";
+        WindowLoadChanged: "linux:WindowLoadChanged";
+    }>;
+    Common: Readonly<{
+        ApplicationOpenedWithFile: "common:ApplicationOpenedWithFile";
+        ApplicationStarted: "common:ApplicationStarted";
+        ApplicationLaunchedWithUrl: "common:ApplicationLaunchedWithUrl";
+        ThemeChanged: "common:ThemeChanged";
+        WindowClosing: "common:WindowClosing";
+        WindowDidMove: "common:WindowDidMove";
+        WindowDidResize: "common:WindowDidResize";
+        WindowDPIChanged: "common:WindowDPIChanged";
+        WindowFilesDropped: "common:WindowFilesDropped";
+        WindowFocus: "common:WindowFocus";
+        WindowFullscreen: "common:WindowFullscreen";
+        WindowHide: "common:WindowHide";
+        WindowLostFocus: "common:WindowLostFocus";
+        WindowMaximise: "common:WindowMaximise";
+        WindowMinimise: "common:WindowMinimise";
+        WindowToggleFrameless: "common:WindowToggleFrameless";
+        WindowRestore: "common:WindowRestore";
+        WindowRuntimeReady: "common:WindowRuntimeReady";
+        WindowShow: "common:WindowShow";
+        WindowUnFullscreen: "common:WindowUnFullscreen";
+        WindowUnMaximise: "common:WindowUnMaximise";
+        WindowUnMinimise: "common:WindowUnMinimise";
+        WindowZoom: "common:WindowZoom";
+        WindowZoomIn: "common:WindowZoomIn";
+        WindowZoomOut: "common:WindowZoomOut";
+        WindowZoomReset: "common:WindowZoomReset";
+        WindowDropZoneFilesDropped: "common:WindowDropZoneFilesDropped";
+    }>;
+}>;

package/types/events.d.ts

@@ -0,0 +1,67 @@
+export { Types } from "./event_types.js";
+/**
+ * The type of handlers for a given event.
+ */
+export type Callback = (ev: WailsEvent) => void;
+/**
+ * Represents a system event or a custom event emitted through wails-provided facilities.
+ */
+export declare class WailsEvent {
+    /**
+     * The name of the event.
+     */
+    name: string;
+    /**
+     * Optional data associated with the emitted event.
+     */
+    data: any;
+    /**
+     * Name of the originating window. Omitted for application events.
+     * Will be overridden if set manually.
+     */
+    sender?: string;
+    constructor(name: string, data?: any);
+}
+/**
+ * Register a callback function to be called multiple times for a specific event.
+ *
+ * @param eventName - The name of the event to register the callback for.
+ * @param callback - The callback function to be called when the event is triggered.
+ * @param 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.
+ * @returns A function that, when called, will unregister the callback from the event.
+ */
+export declare function OnMultiple(eventName: string, callback: Callback, maxCallbacks: number): () => void;
+/**
+ * Registers a callback function to be executed when the specified event occurs.
+ *
+ * @param eventName - The name of the event to register the callback for.
+ * @param callback - The callback function to be called when the event is triggered.
+ * @returns A function that, when called, will unregister the callback from the event.
+ */
+export declare function On(eventName: string, callback: Callback): () => void;
+/**
+ * Registers a callback function to be executed only once for the specified event.
+ *
+ * @param eventName - The name of the event to register the callback for.
+ * @param callback - The callback function to be called when the event is triggered.
+ * @returns A function that, when called, will unregister the callback from the event.
+ */
+export declare function Once(eventName: string, callback: Callback): () => void;
+/**
+ * Removes event listeners for the specified event names.
+ *
+ * @param eventNames - The name of the events to remove listeners for.
+ */
+export declare function Off(...eventNames: [string, ...string[]]): void;
+/**
+ * Removes all event listeners.
+ */
+export declare function OffAll(): void;
+/**
+ * Emits an event using the name and data.
+ *
+ * @returns A promise that will be fulfilled once the event has been emitted.
+ * @param name - the name of the event to emit.
+ * @param data - the data to be sent with the event.
+ */
+export declare function Emit(name: string, data?: any): Promise<void>;

package/types/flags.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Retrieves the value associated with the specified key from the flag map.
+ *
+ * @param key - The key to retrieve the value for.
+ * @return The value associated with the specified key.
+ */
+export declare function GetFlag(key: string): any;

package/types/index.d.ts

@@ -0,0 +1,16 @@
+import "./contextmenu.js";
+import "./drag.js";
+import * as Application from "./application.js";
+import * as Browser from "./browser.js";
+import * as Call from "./calls.js";
+import * as Clipboard from "./clipboard.js";
+import * as Create from "./create.js";
+import * as Dialogs from "./dialogs.js";
+import * as Events from "./events.js";
+import * as Flags from "./flags.js";
+import * as Screens from "./screens.js";
+import * as System from "./system.js";
+import Window from "./window.js";
+import * as WML from "./wml.js";
+export { Application, Browser, Call, Clipboard, Dialogs, Events, Flags, Screens, System, Window, WML };
+export * from "./cancellable.js";

package/types/listener.d.ts

@@ -0,0 +1,9 @@
+export declare const eventListeners: Map<string, Listener[]>;
+export declare class Listener {
+    eventName: string;
+    callback: (data: any) => void;
+    maxCallbacks: number;
+    constructor(eventName: string, callback: (data: any) => void, maxCallbacks: number);
+    dispatch(data: any): boolean;
+}
+export declare function listenerOff(listener: Listener): void;

package/types/nanoid.d.ts

@@ -0,0 +1 @@
+export declare function nanoid(size?: number): string;

package/types/runtime.d.ts

@@ -0,0 +1,22 @@
+export declare const objectNames: Readonly<{
+    Call: 0;
+    Clipboard: 1;
+    Application: 2;
+    Events: 3;
+    ContextMenu: 4;
+    Dialog: 5;
+    Window: 6;
+    Screens: 7;
+    System: 8;
+    Browser: 9;
+    CancelCall: 10;
+}>;
+export declare let clientId: string;
+/**
+ * Creates a new runtime caller with specified ID.
+ *
+ * @param object - The object to invoke the method on.
+ * @param windowName - The name of the window.
+ * @return The new runtime caller function.
+ */
+export declare function newRuntimeCaller(object: number, windowName?: string): (method: number, args?: any) => Promise<any>;

package/types/screens.d.ts

@@ -0,0 +1,60 @@
+export interface Size {
+    /** The width of a rectangular area. */
+    Width: number;
+    /** The height of a rectangular area. */
+    Height: number;
+}
+export interface Rect {
+    /** The X coordinate of the origin. */
+    X: number;
+    /** The Y coordinate of the origin. */
+    Y: number;
+    /** The width of the rectangle. */
+    Width: number;
+    /** The height of the rectangle. */
+    Height: number;
+}
+export interface Screen {
+    /** Unique identifier for the screen. */
+    ID: string;
+    /** Human-readable name of the screen. */
+    Name: string;
+    /** The scale factor of the screen (DPI/96). 1 = standard DPI, 2 = HiDPI (Retina), etc. */
+    ScaleFactor: number;
+    /** The X coordinate of the screen. */
+    X: number;
+    /** The Y coordinate of the screen. */
+    Y: number;
+    /** 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 physical bounds of the screen in terms of X, Y, Width, and Height (before scaling). */
+    PhysicalBounds: Rect;
+    /** Contains the area of the screen that is actually usable (excluding taskbar and other system UI). */
+    WorkArea: Rect;
+    /** Contains the physical WorkArea of the screen (before scaling). */
+    PhysicalWorkArea: Rect;
+    /** True if this is the primary monitor selected by the user in the operating system. */
+    IsPrimary: boolean;
+    /** The rotation of the screen. */
+    Rotation: number;
+}
+/**
+ * Gets all screens.
+ *
+ * @returns A promise that resolves to an array of Screen objects.
+ */
+export declare function GetAll(): Promise<Screen[]>;
+/**
+ * Gets the primary screen.
+ *
+ * @returns A promise that resolves to the primary screen.
+ */
+export declare function GetPrimary(): Promise<Screen>;
+/**
+ * Gets the current active screen.
+ *
+ * @returns A promise that resolves with the current active screen.
+ */
+export declare function GetCurrent(): Promise<Screen>;

package/types/system.d.ts

@@ -0,0 +1,92 @@
+export declare function invoke(msg: any): void;
+/**
+ * Retrieves the system dark mode status.
+ *
+ * @returns A promise that resolves to a boolean value indicating if the system is in dark mode.
+ */
+export declare function IsDarkMode(): Promise<boolean>;
+/**
+ * Fetches the capabilities of the application from the server.
+ *
+ * @returns A promise that resolves to an object containing the capabilities.
+ */
+export declare function Capabilities(): Promise<Record<string, any>>;
+export interface OSInfo {
+    /** The branding of the OS. */
+    Branding: string;
+    /** The ID of the OS. */
+    ID: string;
+    /** The name of the OS. */
+    Name: string;
+    /** The version of the OS. */
+    Version: string;
+}
+export interface EnvironmentInfo {
+    /** The architecture of the system. */
+    Arch: string;
+    /** True if the application is running in debug mode, otherwise false. */
+    Debug: boolean;
+    /** The operating system in use. */
+    OS: string;
+    /** Details of the operating system. */
+    OSInfo: OSInfo;
+    /** Additional platform information. */
+    PlatformInfo: Record<string, any>;
+}
+/**
+ * Retrieves environment details.
+ *
+ * @returns A promise that resolves to an object containing OS and system architecture.
+ */
+export declare function Environment(): Promise<EnvironmentInfo>;
+/**
+ * Checks if the current operating system is Windows.
+ *
+ * @return True if the operating system is Windows, otherwise false.
+ */
+export declare function IsWindows(): boolean;
+/**
+ * Checks if the current operating system is Linux.
+ *
+ * @returns Returns true if the current operating system is Linux, false otherwise.
+ */
+export declare function IsLinux(): boolean;
+/**
+ * Checks if the current environment is a macOS operating system.
+ *
+ * @returns True if the environment is macOS, false otherwise.
+ */
+export declare function IsMac(): boolean;
+/**
+ * Checks if the current environment architecture is AMD64.
+ *
+ * @returns True if the current environment architecture is AMD64, false otherwise.
+ */
+export declare function IsAMD64(): boolean;
+/**
+ * Checks if the current architecture is ARM.
+ *
+ * @returns True if the current architecture is ARM, false otherwise.
+ */
+export declare function IsARM(): boolean;
+/**
+ * Checks if the current environment is ARM64 architecture.
+ *
+ * @returns Returns true if the environment is ARM64 architecture, otherwise returns false.
+ */
+export declare function IsARM64(): boolean;
+/**
+ * Reports whether the app is being run in debug mode.
+ *
+ * @returns True if the app is being run in debug mode.
+ */
+export declare function IsDebug(): boolean;
+/**
+ * Handles file drops originating from platform-specific code (e.g., macOS native drag-and-drop).
+ * Gathers information about the drop target element and sends it back to the Go backend.
+ *
+ * @param filenames - An array of file paths (strings) that were dropped.
+ * @param x - The x-coordinate of the drop event.
+ * @param y - The y-coordinate of the drop event.
+ */
+export declare function HandlePlatformFileDrop(filenames: string[], x: number, y: number): void;

package/types/utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Logs a message to the console with custom formatting.
+ *
+ * @param message - The message to be logged.
+ */
+export declare function debugLog(message: any): void;
+/**
+ * Checks whether the webview supports the {@link MouseEvent#buttons} property.
+ * Looking at you macOS High Sierra!
+ */
+export declare function canTrackButtons(): boolean;
+/**
+ * Checks whether the browser supports removing listeners by triggering an AbortSignal
+ * (see https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener#signal).
+ */
+export declare function canAbortListeners(): boolean;
+/**
+ * Resolves the closest HTMLElement ancestor of an event's target.
+ */
+export declare function eventTarget(event: Event): HTMLElement;
+export declare function whenReady(callback: () => void): void;