@wailsio/runtime 3.0.0-alpha.66 → 3.0.0-alpha.69

package/dist/event_types.js

@@ -203,6 +203,7 @@ export const Types = Object.freeze({
     Common: Object.freeze({
         ApplicationOpenedWithFile: "common:ApplicationOpenedWithFile",
         ApplicationStarted: "common:ApplicationStarted",
+        ApplicationLaunchedWithUrl: "common:ApplicationLaunchedWithUrl",
         ThemeChanged: "common:ThemeChanged",
         WindowClosing: "common:WindowClosing",
         WindowDidMove: "common:WindowDidMove",
@@ -215,6 +216,7 @@ export const Types = Object.freeze({
         WindowLostFocus: "common:WindowLostFocus",
         WindowMaximise: "common:WindowMaximise",
         WindowMinimise: "common:WindowMinimise",
+        WindowToggleFrameless: "common:WindowToggleFrameless",
         WindowRestore: "common:WindowRestore",
         WindowRuntimeReady: "common:WindowRuntimeReady",
         WindowShow: "common:WindowShow",
@@ -225,5 +227,6 @@ export const Types = Object.freeze({
         WindowZoomIn: "common:WindowZoomIn",
         WindowZoomOut: "common:WindowZoomOut",
         WindowZoomReset: "common:WindowZoomReset",
+        WindowDropZoneFilesDropped: "common:WindowDropZoneFilesDropped",
     }),
 });

package/dist/events.js

@@ -91,11 +91,24 @@ export function OffAll() {
     eventListeners.clear();
 }
 /**
- * Emits the given event.
+ * Emits an event using the name and data.
  *
- * @param event - The name of the event to emit.
  * @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 function Emit(event) {
-    return call(EmitMethod, event);
+export function Emit(name, data) {
+    let eventName;
+    let eventData;
+    if (typeof name === 'object' && name !== null && 'name' in name && 'data' in name) {
+        // If name is an object with a name property, use it directly
+        eventName = name['name'];
+        eventData = name['data'];
+    }
+    else {
+        // Otherwise use the standard parameters
+        eventName = name;
+        eventData = data;
+    }
+    return call(EmitMethod, { name: eventName, data: eventData });
 }

package/dist/system.js

@@ -11,6 +11,7 @@ import { newRuntimeCaller, objectNames } from "./runtime.js";
 const call = newRuntimeCaller(objectNames.System);
 const SystemIsDarkMode = 0;
 const SystemEnvironment = 1;
+const ApplicationFilesDroppedWithContext = 100; // New method ID for enriched drop event
 const _invoke = (function () {
     var _a, _b, _c, _d, _e;
     try {
@@ -114,3 +115,32 @@ export function IsARM64() {
 export function IsDebug() {
     return Boolean(window._wails.environment.Debug);
 }
+/**
+ * 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 function HandlePlatformFileDrop(filenames, x, y) {
+    const element = document.elementFromPoint(x, y);
+    const elementId = element ? element.id : '';
+    const classList = element ? Array.from(element.classList) : [];
+    const payload = {
+        filenames,
+        x,
+        y,
+        elementId,
+        classList,
+    };
+    call(ApplicationFilesDroppedWithContext, payload)
+        .then(() => {
+        // Optional: Log success or handle if needed
+        console.log("Platform file drop processed and sent to Go.");
+    })
+        .catch(err => {
+        // Optional: Log error
+        console.error("Error sending platform file drop to Go:", err);
+    });
+}

package/dist/window.js

@@ -8,6 +8,10 @@ The electron alternative for Go
 (c) Lea Anthony 2019-present
 */
 import { newRuntimeCaller, objectNames } from "./runtime.js";
+// NEW: Dropzone constants
+const DROPZONE_ATTRIBUTE = 'data-wails-dropzone';
+const DROPZONE_HOVER_CLASS = 'wails-dropzone-hover'; // User can style this class
+let currentHoveredDropzone = null;
 const PositionMethod = 0;
 const CenterMethod = 1;
 const CloseMethod = 2;
@@ -48,14 +52,24 @@ const ShowMethod = 36;
 const SizeMethod = 37;
 const ToggleFullscreenMethod = 38;
 const ToggleMaximiseMethod = 39;
-const UnFullscreenMethod = 40;
-const UnMaximiseMethod = 41;
-const UnMinimiseMethod = 42;
-const WidthMethod = 43;
-const ZoomMethod = 44;
-const ZoomInMethod = 45;
-const ZoomOutMethod = 46;
-const ZoomResetMethod = 47;
+const ToggleFramelessMethod = 40;
+const UnFullscreenMethod = 41;
+const UnMaximiseMethod = 42;
+const UnMinimiseMethod = 43;
+const WidthMethod = 44;
+const ZoomMethod = 45;
+const ZoomInMethod = 46;
+const ZoomOutMethod = 47;
+const ZoomResetMethod = 48;
+const SnapAssistMethod = 49;
+const WindowDropZoneDropped = 50;
+function getDropzoneElement(element) {
+    if (!element) {
+        return null;
+    }
+    // Allow dropzone attribute to be on the element itself or any parent
+    return element.closest(`[${DROPZONE_ATTRIBUTE}]`);
+}
 // Private field names.
 const callerSym = Symbol("caller");
 class Window {
@@ -380,6 +394,12 @@ class Window {
     ToggleMaximise() {
         return this[callerSym](ToggleMaximiseMethod);
     }
+    /**
+     * Toggles the window between frameless and normal.
+     */
+    ToggleFrameless() {
+        return this[callerSym](ToggleFramelessMethod);
+    }
     /**
      * Un-fullscreens the window.
      */
@@ -430,9 +450,121 @@ class Window {
     ZoomReset() {
         return this[callerSym](ZoomResetMethod);
     }
+    /**
+     * 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.
+     */
+    HandlePlatformFileDrop(filenames, x, y) {
+        const element = document.elementFromPoint(x, y);
+        // NEW: Check if the drop target is a valid dropzone
+        const dropzoneTarget = getDropzoneElement(element);
+        if (!dropzoneTarget) {
+            console.log(`Wails Runtime: Drop on element (or no element) at ${x},${y} which is not a designated dropzone. Ignoring. Element:`, element);
+            // No need to call backend if not a valid dropzone target
+            return;
+        }
+        console.log(`Wails Runtime: Drop on designated dropzone. Element at (${x}, ${y}):`, element, 'Effective dropzone:', dropzoneTarget);
+        const elementDetails = {
+            id: dropzoneTarget.id,
+            classList: Array.from(dropzoneTarget.classList),
+            attributes: {},
+        };
+        for (let i = 0; i < dropzoneTarget.attributes.length; i++) {
+            const attr = dropzoneTarget.attributes[i];
+            elementDetails.attributes[attr.name] = attr.value;
+        }
+        const payload = {
+            filenames,
+            x,
+            y,
+            elementDetails,
+        };
+        this[callerSym](WindowDropZoneDropped, payload);
+    }
+    /* Triggers Windows 11 Snap Assist feature (Windows only).
+     * This is equivalent to pressing Win+Z and shows snap layout options.
+     */
+    SnapAssist() {
+        return this[callerSym](SnapAssistMethod);
+    }
 }
 /**
  * The window within which the script is running.
  */
 const thisWindow = new Window('');
+// NEW: Global Drag Event Listeners
+function setupGlobalDropzoneListeners() {
+    const docElement = document.documentElement;
+    let dragEnterCounter = 0; // To handle dragenter/dragleave on child elements
+    docElement.addEventListener('dragenter', (event) => {
+        event.preventDefault();
+        if (event.dataTransfer && event.dataTransfer.types.includes('Files')) {
+            dragEnterCounter++;
+            const targetElement = document.elementFromPoint(event.clientX, event.clientY);
+            const dropzone = getDropzoneElement(targetElement);
+            // Clear previous hover regardless, then apply new if valid
+            if (currentHoveredDropzone && currentHoveredDropzone !== dropzone) {
+                currentHoveredDropzone.classList.remove(DROPZONE_HOVER_CLASS);
+            }
+            if (dropzone) {
+                dropzone.classList.add(DROPZONE_HOVER_CLASS);
+                event.dataTransfer.dropEffect = 'copy';
+                currentHoveredDropzone = dropzone;
+            }
+            else {
+                event.dataTransfer.dropEffect = 'none';
+                currentHoveredDropzone = null; // Ensure it's cleared if no dropzone found
+            }
+        }
+    }, false);
+    docElement.addEventListener('dragover', (event) => {
+        event.preventDefault(); // Necessary to allow drop
+        if (event.dataTransfer && event.dataTransfer.types.includes('Files')) {
+            // No need to query elementFromPoint again if already handled by dragenter correctly
+            // Just ensure dropEffect is continuously set based on currentHoveredDropzone
+            if (currentHoveredDropzone) {
+                // Re-apply class just in case it was removed by some other JS
+                if (!currentHoveredDropzone.classList.contains(DROPZONE_HOVER_CLASS)) {
+                    currentHoveredDropzone.classList.add(DROPZONE_HOVER_CLASS);
+                }
+                event.dataTransfer.dropEffect = 'copy';
+            }
+            else {
+                event.dataTransfer.dropEffect = 'none';
+            }
+        }
+    }, false);
+    docElement.addEventListener('dragleave', (event) => {
+        event.preventDefault();
+        if (event.dataTransfer && event.dataTransfer.types.includes('Files')) {
+            dragEnterCounter--;
+            // Only remove hover if drag truly left the window or the last dropzone
+            if (dragEnterCounter === 0 || event.relatedTarget === null || (currentHoveredDropzone && !currentHoveredDropzone.contains(event.relatedTarget))) {
+                if (currentHoveredDropzone) {
+                    currentHoveredDropzone.classList.remove(DROPZONE_HOVER_CLASS);
+                    currentHoveredDropzone = null;
+                }
+                dragEnterCounter = 0; // Reset counter if it went negative or left window
+            }
+        }
+    }, false);
+    docElement.addEventListener('drop', (event) => {
+        event.preventDefault(); // Prevent default browser file handling
+        dragEnterCounter = 0; // Reset counter
+        if (currentHoveredDropzone) {
+            currentHoveredDropzone.classList.remove(DROPZONE_HOVER_CLASS);
+            currentHoveredDropzone = null;
+        }
+        // The actual drop processing is initiated by the native side calling HandlePlatformFileDrop
+        // HandlePlatformFileDrop will then check if the drop was on a valid zone.
+    }, false);
+}
+// Initialize listeners when the script loads
+if (typeof window !== "undefined" && typeof document !== "undefined") {
+    setupGlobalDropzoneListeners();
+}
 export default thisWindow;

package/dist/wml.js

@@ -9,7 +9,7 @@ The electron alternative for Go
 */
 import { OpenURL } from "./browser.js";
 import { Question } from "./dialogs.js";
-import { Emit, WailsEvent } from "./events.js";
+import { Emit } from "./events.js";
 import { canAbortListeners, whenReady } from "./utils.js";
 import Window from "./window.js";
 /**
@@ -19,7 +19,7 @@ import Window from "./window.js";
  * @param [data=null] - - Optional data to send along with the event.
  */
 function sendEvent(eventName, data = null) {
-    Emit(new WailsEvent(eventName, data));
+    Emit(eventName, data);
 }
 /**
  * Calls a method on a specified window.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wailsio/runtime",
   "type": "module",
-  "version": "3.0.0-alpha.66",
+  "version": "3.0.0-alpha.69",
   "description": "Wails Runtime",
   "types": "types/index.d.ts",
   "exports": {
@@ -36,8 +36,8 @@
     "generate": "npm run generate:events",
     "prebuild": "npm run clean && npm run generate",
     "build:code": "npx tsc",
-    "build:docs": "npx typedoc --plugin typedoc-plugin-mdn-links --plugin typedoc-plugin-missing-exports ./src/index.ts",
-    "build:docs:md": "npx typedoc --plugin typedoc-plugin-markdown --plugin typedoc-plugin-mdn-links --plugin typedoc-plugin-missing-exports ./src/index.ts",
+    "build:docs": "npx typedoc --gitRevision v3-alpha --plugin typedoc-plugin-mdn-links --plugin typedoc-plugin-missing-exports ./src/index.ts",
+    "build:docs:md": "npx typedoc --gitRevision v3-alpha --plugin typedoc-plugin-markdown --plugin typedoc-plugin-mdn-links --plugin typedoc-plugin-missing-exports ./src/index.ts",
     "build": "npm run build:code & npm run build:docs & wait",
     "prepack": "npm run build"
   },

package/types/event_types.d.ts

@@ -192,6 +192,7 @@ export declare const Types: Readonly<{
     Common: Readonly<{
         ApplicationOpenedWithFile: "common:ApplicationOpenedWithFile";
         ApplicationStarted: "common:ApplicationStarted";
+        ApplicationLaunchedWithUrl: "common:ApplicationLaunchedWithUrl";
         ThemeChanged: "common:ThemeChanged";
         WindowClosing: "common:WindowClosing";
         WindowDidMove: "common:WindowDidMove";
@@ -204,6 +205,7 @@ export declare const Types: Readonly<{
         WindowLostFocus: "common:WindowLostFocus";
         WindowMaximise: "common:WindowMaximise";
         WindowMinimise: "common:WindowMinimise";
+        WindowToggleFrameless: "common:WindowToggleFrameless";
         WindowRestore: "common:WindowRestore";
         WindowRuntimeReady: "common:WindowRuntimeReady";
         WindowShow: "common:WindowShow";
@@ -214,5 +216,6 @@ export declare const Types: Readonly<{
         WindowZoomIn: "common:WindowZoomIn";
         WindowZoomOut: "common:WindowZoomOut";
         WindowZoomReset: "common:WindowZoomReset";
+        WindowDropZoneFilesDropped: "common:WindowDropZoneFilesDropped";
     }>;
 }>;

package/types/events.d.ts

@@ -58,9 +58,10 @@ export declare function Off(...eventNames: [string, ...string[]]): void;
  */
 export declare function OffAll(): void;
 /**
- * Emits the given event.
+ * Emits an event using the name and data.
  *
- * @param event - The name of the event to emit.
  * @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(event: WailsEvent): Promise<void>;
+export declare function Emit(name: string, data?: any): Promise<void>;

package/types/system.d.ts

@@ -81,3 +81,12 @@ export declare function IsARM64(): boolean;
  * @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/window.d.ts

@@ -250,6 +250,10 @@ declare class Window {
      * Toggles the window between maximised and normal.
      */
     ToggleMaximise(): Promise<void>;
+    /**
+     * Toggles the window between frameless and normal.
+     */
+    ToggleFrameless(): Promise<void>;
     /**
      * Un-fullscreens the window.
      */
@@ -284,6 +288,16 @@ declare class Window {
      * Resets the zoom level of the webview content.
      */
     ZoomReset(): Promise<void>;
+    /**
+     * 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.
+     */
+    HandlePlatformFileDrop(filenames: string[], x: number, y: number): void;
+    SnapAssist(): Promise<void>;
 }
 /**
  * The window within which the script is running.