@gtkx/ffi 0.13.3 → 0.15.0

package/README.md

@@ -1,18 +1,18 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/eugeniodepalo/gtkx/main/logo.svg" alt="GTKX" width="60" height="60">
+ <img src="https://raw.githubusercontent.com/eugeniodepalo/gtkx/main/logo.svg" alt="GTKX" width="60" height="60">
 </p>
 
 <h1 align="center">GTKX</h1>
 
 <p align="center">
-  <strong>Build native GTK4 desktop applications with React and TypeScript.</strong>
+ <strong>Build native GTK4 desktop applications with React and TypeScript.</strong>
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@gtkx/react"><img src="https://img.shields.io/npm/v/@gtkx/react.svg" alt="npm version"></a>
-  <a href="https://github.com/eugeniodepalo/gtkx/actions"><img src="https://img.shields.io/github/actions/workflow/status/eugeniodepalo/gtkx/ci.yml" alt="CI"></a>
-  <a href="https://github.com/eugeniodepalo/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License"></a>
-  <a href="https://github.com/eugeniodepalo/gtkx/discussions"><img src="https://img.shields.io/badge/discussions-GitHub-blue" alt="GitHub Discussions"></a>
+ <a href="https://www.npmjs.com/package/@gtkx/react"><img src="https://img.shields.io/npm/v/@gtkx/react.svg" alt="npm version"></a>
+ <a href="https://github.com/eugeniodepalo/gtkx/actions"><img src="https://img.shields.io/github/actions/workflow/status/eugeniodepalo/gtkx/ci.yml" alt="CI"></a>
+ <a href="https://github.com/eugeniodepalo/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License"></a>
+ <a href="https://github.com/eugeniodepalo/gtkx/discussions"><img src="https://img.shields.io/badge/discussions-GitHub-blue" alt="GitHub Discussions"></a>
 </p>
 
 ---
@@ -83,7 +83,8 @@ Explore complete applications in the [`examples/`](./examples) directory:
 - **[gtk-demo](./examples/gtk-demo)** — Full replica of the official GTK demo app
 - **[hello-world](./examples/hello-world)** — Minimal application showing a counter
 - **[todo](./examples/todo)** — Full-featured todo application with Adwaita styling and testing
-- **[x-showcase](./examples/x-showcase)** — Showcase of all x.* virtual components
+- **[x-showcase](./examples/x-showcase)** — Showcase of all x.\* virtual components
+- **[browser](./examples/browser)** — Simple browser using WebKitWebView
 - **[deploying](./examples/deploying)** — Example of packaging and distributing a GTKX app
 
 ## Documentation

package/dist/batch.js

@@ -1,4 +1,5 @@
 import { batchCall, call as nativeCall } from "@gtkx/native";
+import { isStarted } from "./native/lifecycle.js";
 const batchStack = [];
 /**
  * Begins a new FFI call batch.
@@ -66,6 +67,12 @@ export const discardAllBatches = () => {
  * @returns The function return value, or undefined for void calls
  */
 export const call = (library, symbol, args, returnType) => {
+    if (!isStarted()) {
+        const err = new Error(`[gtkx] FFI call blocked in forked process: ${library}:${symbol}`);
+        console.error(err.message);
+        console.error("Stack trace:", err.stack);
+        throw err;
+    }
     const currentQueue = batchStack[batchStack.length - 1];
     if (currentQueue && returnType.type === "undefined") {
         currentQueue.push({ library, symbol, args });

package/dist/generated/adw/about-dialog.js

@@ -409,6 +409,8 @@ export class AboutDialog extends Dialog {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_license_get_type",
                 },
                 value: licenseType,
             },
@@ -742,6 +744,8 @@ export class AboutDialog extends Dialog {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_license_get_type",
         });
     }
     /** Gets the release notes for `self`. */
@@ -1301,6 +1305,8 @@ export class AboutDialog extends Dialog {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_license_get_type",
                 },
                 value: licenseType,
             },

package/dist/generated/adw/about-window.js

@@ -404,6 +404,8 @@ export class AboutWindow extends Window {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_license_get_type",
                 },
                 value: licenseType,
             },
@@ -684,6 +686,8 @@ export class AboutWindow extends Window {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_license_get_type",
         });
     }
     /** Gets the release notes for `self`. */
@@ -1243,6 +1247,8 @@ export class AboutWindow extends Window {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_license_get_type",
                 },
                 value: licenseType,
             },

package/dist/generated/adw/alert-dialog.js

@@ -371,6 +371,8 @@ export class AlertDialog extends Dialog {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libadwaita-1.so.0",
+            getTypeFn: "adw_response_appearance_get_type",
         });
     }
     /**
@@ -707,6 +709,8 @@ export class AlertDialog extends Dialog {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libadwaita-1.so.0",
+                    getTypeFn: "adw_response_appearance_get_type",
                 },
                 value: appearance,
             },

package/dist/generated/adw/animation.js

@@ -88,6 +88,8 @@ export class Animation extends GObject.GObject {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libadwaita-1.so.0",
+            getTypeFn: "adw_animation_state_get_type",
         });
     }
     /** Gets the target `self` animates. */

package/dist/generated/adw/application.d.ts

@@ -58,7 +58,7 @@ export declare class Application extends Gtk.Application {
      * If no application ID is given then some features (most notably application
      * uniqueness) will be disabled.
      */
-    constructor(flags: Gio.ApplicationFlags, applicationId?: string | null);
+    constructor(flags?: Gio.ApplicationFlags, applicationId?: string | null);
     /**
      * Gets the style manager for `self`.
      *

package/dist/generated/adw/application.js

@@ -2,6 +2,7 @@ import { call } from "../../batch.js";
 import { getNativeObject } from "../../native/object.js";
 import { isInstantiating, setInstantiating } from "../../native/base.js";
 import { registerNativeClass } from "../../registry.js";
+import * as Gio from "../gio/index.js";
 import * as Gtk from "../gtk/index.js";
 /**
  * A base class for Adwaita applications.
@@ -60,7 +61,7 @@ export class Application extends Gtk.Application {
      * If no application ID is given then some features (most notably application
      * uniqueness) will be disabled.
      */
-    constructor(flags, applicationId) {
+    constructor(flags = Gio.ApplicationFlags.FLAGS_NONE, applicationId = null) {
         if (!isInstantiating) {
             setInstantiating(true);
             // @ts-ignore
@@ -80,6 +81,8 @@ export class Application extends Gtk.Application {
                         type: "int",
                         size: 32,
                         unsigned: true,
+                        lib: "libgio-2.0.so.0",
+                        getTypeFn: "g_application_flags_get_type",
                     },
                     value: flags,
                     optional: false,

package/dist/generated/adw/avatar.d.ts

@@ -30,7 +30,7 @@ export declare class Avatar extends Gtk.Widget {
     static readonly glibTypeName: string;
     static readonly objectType: "gobject";
     /** Creates a new `AdwAvatar`. */
-    constructor(size: number, showInitials: boolean, text?: string | null);
+    constructor(size?: number, showInitials?: boolean, text?: string | null);
     /**
      * Renders `self` into a {@link Gdk.Texture} at `scale_factor`.
      *

package/dist/generated/adw/avatar.js

@@ -34,7 +34,7 @@ export class Avatar extends Gtk.Widget {
     static glibTypeName = "AdwAvatar";
     static objectType = "gobject";
     /** Creates a new `AdwAvatar`. */
-    constructor(size, showInitials, text) {
+    constructor(size = -1, showInitials = false, text) {
         if (!isInstantiating) {
             setInstantiating(true);
             // @ts-ignore

package/dist/generated/adw/banner.js

@@ -83,6 +83,8 @@ export class Banner extends Gtk.Widget {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libadwaita-1.so.0",
+            getTypeFn: "adw_banner_button_style_get_type",
         });
     }
     /** Gets if a banner is revealed */
@@ -179,6 +181,8 @@ export class Banner extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libadwaita-1.so.0",
+                    getTypeFn: "adw_banner_button_style_get_type",
                 },
                 value: style,
             },

package/dist/generated/adw/bottom-sheet.js

@@ -707,6 +707,8 @@ export class BottomSheet extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libadwaita-1.so.0",
+                    getTypeFn: "adw_navigation_direction_get_type",
                 },
                 value: navigationDirection,
             },

package/dist/generated/adw/breakpoint-condition.js

@@ -51,6 +51,8 @@ export class BreakpointCondition extends NativeObject {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libadwaita-1.so.0",
+                    getTypeFn: "adw_breakpoint_condition_length_type_get_type",
                 },
                 value: type,
                 optional: false,
@@ -68,6 +70,8 @@ export class BreakpointCondition extends NativeObject {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libadwaita-1.so.0",
+                    getTypeFn: "adw_length_unit_get_type",
                 },
                 value: unit,
                 optional: false,
@@ -130,6 +134,8 @@ export class BreakpointCondition extends NativeObject {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libadwaita-1.so.0",
+                    getTypeFn: "adw_breakpoint_condition_ratio_type_get_type",
                 },
                 value: type,
                 optional: false,

package/dist/generated/adw/breakpoint.js

@@ -194,7 +194,7 @@ export class Breakpoint extends GObject.GObject {
                     lengthParamIndex: 0,
                     ownership: "borrowed",
                 },
-                value: objects,
+                value: objects.map((item) => item.handle),
             },
             {
                 type: {
@@ -222,8 +222,9 @@ export class Breakpoint extends GObject.GObject {
                     listType: "sized",
                     lengthParamIndex: 0,
                     ownership: "borrowed",
+                    elementSize: 24,
                 },
-                value: values,
+                value: values.map((item) => item.handle),
             },
         ], {
             type: "undefined",

package/dist/generated/adw/callback-animation-target.d.ts

@@ -0,0 +1,14 @@
+import { AnimationTarget } from "./animation-target.js";
+/**
+ * An {@link AnimationTarget} that calls a given callback during the
+ * animation.
+ */
+export declare class CallbackAnimationTarget extends AnimationTarget {
+    static readonly glibTypeName: string;
+    static readonly objectType: "gobject";
+    /**
+     * Creates a new `AdwAnimationTarget` that calls the given `callback` during
+     * the animation.
+     */
+    constructor(callback: (value: number) => void);
+}

package/dist/generated/adw/callback-animation-target.js

@@ -0,0 +1,45 @@
+import { call } from "../../batch.js";
+import { isInstantiating, setInstantiating } from "../../native/base.js";
+import { registerNativeClass } from "../../registry.js";
+import { AnimationTarget } from "./animation-target.js";
+/**
+ * An {@link AnimationTarget} that calls a given callback during the
+ * animation.
+ */
+export class CallbackAnimationTarget extends AnimationTarget {
+    static glibTypeName = "AdwCallbackAnimationTarget";
+    static objectType = "gobject";
+    /**
+     * Creates a new `AdwAnimationTarget` that calls the given `callback` during
+     * the animation.
+     */
+    constructor(callback) {
+        if (!isInstantiating) {
+            setInstantiating(true);
+            // @ts-ignore
+            super();
+            setInstantiating(false);
+            this.handle = call("libadwaita-1.so.0", "adw_callback_animation_target_new", [
+                {
+                    type: {
+                        type: "callback",
+                        trampoline: "animationTargetFunc",
+                        argTypes: [
+                            {
+                                type: "float",
+                                size: 64,
+                            },
+                        ],
+                    },
+                    value: callback,
+                    optional: false,
+                },
+            ], { type: "gobject", ownership: "full" });
+        }
+        else {
+            // @ts-ignore
+            super();
+        }
+    }
+}
+registerNativeClass(CallbackAnimationTarget);

package/dist/generated/adw/carousel-indicator-dots.js

@@ -94,6 +94,8 @@ export class CarouselIndicatorDots extends Gtk.Widget {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_orientation_get_type",
         });
     }
     /** Sets the orientation of the `orientable`. */
@@ -111,6 +113,8 @@ export class CarouselIndicatorDots extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_orientation_get_type",
                 },
                 value: orientation,
             },

package/dist/generated/adw/carousel-indicator-lines.js

@@ -93,6 +93,8 @@ export class CarouselIndicatorLines extends Gtk.Widget {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_orientation_get_type",
         });
     }
     /** Sets the orientation of the `orientable`. */
@@ -110,6 +112,8 @@ export class CarouselIndicatorLines extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_orientation_get_type",
                 },
                 value: orientation,
             },

package/dist/generated/adw/carousel.js

@@ -656,6 +656,8 @@ export class Carousel extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libadwaita-1.so.0",
+                    getTypeFn: "adw_navigation_direction_get_type",
                 },
                 value: navigationDirection,
             },
@@ -693,6 +695,8 @@ export class Carousel extends Gtk.Widget {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_orientation_get_type",
         });
     }
     /** Sets the orientation of the `orientable`. */
@@ -710,6 +714,8 @@ export class Carousel extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_orientation_get_type",
                 },
                 value: orientation,
             },

package/dist/generated/adw/clamp-layout.js

@@ -87,6 +87,8 @@ export class ClampLayout extends Gtk.LayoutManager {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libadwaita-1.so.0",
+            getTypeFn: "adw_length_unit_get_type",
         });
     }
     /**
@@ -171,6 +173,8 @@ export class ClampLayout extends Gtk.LayoutManager {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libadwaita-1.so.0",
+                    getTypeFn: "adw_length_unit_get_type",
                 },
                 value: unit,
             },
@@ -192,6 +196,8 @@ export class ClampLayout extends Gtk.LayoutManager {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_orientation_get_type",
         });
     }
     /** Sets the orientation of the `orientable`. */
@@ -209,6 +215,8 @@ export class ClampLayout extends Gtk.LayoutManager {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_orientation_get_type",
                 },
                 value: orientation,
             },

package/dist/generated/adw/clamp-scrollable.js

@@ -98,6 +98,8 @@ export class ClampScrollable extends Gtk.Widget {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libadwaita-1.so.0",
+            getTypeFn: "adw_length_unit_get_type",
         });
     }
     /** Sets the child widget of `self`. */
@@ -204,6 +206,8 @@ export class ClampScrollable extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libadwaita-1.so.0",
+                    getTypeFn: "adw_length_unit_get_type",
                 },
                 value: unit,
             },
@@ -225,6 +229,8 @@ export class ClampScrollable extends Gtk.Widget {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_orientation_get_type",
         });
     }
     /** Sets the orientation of the `orientable`. */
@@ -242,6 +248,8 @@ export class ClampScrollable extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_orientation_get_type",
                 },
                 value: orientation,
             },
@@ -312,6 +320,8 @@ export class ClampScrollable extends Gtk.Widget {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_scrollable_policy_get_type",
         });
     }
     /** Retrieves the `GtkAdjustment` used for vertical scrolling. */
@@ -346,6 +356,8 @@ export class ClampScrollable extends Gtk.Widget {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_scrollable_policy_get_type",
         });
     }
     /** Sets the horizontal adjustment of the `GtkScrollable`. */
@@ -390,6 +402,8 @@ export class ClampScrollable extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_scrollable_policy_get_type",
                 },
                 value: policy,
             },
@@ -439,6 +453,8 @@ export class ClampScrollable extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_scrollable_policy_get_type",
                 },
                 value: policy,
             },

package/dist/generated/adw/clamp.js

@@ -110,6 +110,8 @@ export class Clamp extends Gtk.Widget {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libadwaita-1.so.0",
+            getTypeFn: "adw_length_unit_get_type",
         });
     }
     /** Sets the child widget of `self`. */
@@ -216,6 +218,8 @@ export class Clamp extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libadwaita-1.so.0",
+                    getTypeFn: "adw_length_unit_get_type",
                 },
                 value: unit,
             },
@@ -237,6 +241,8 @@ export class Clamp extends Gtk.Widget {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_orientation_get_type",
         });
     }
     /** Sets the orientation of the `orientable`. */
@@ -254,6 +260,8 @@ export class Clamp extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_orientation_get_type",
                 },
                 value: orientation,
             },

package/dist/generated/adw/combo-row.js

@@ -199,6 +199,8 @@ export class ComboRow extends ActionRow {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_string_filter_match_mode_get_type",
         });
     }
     /** Gets the position of the selected item. */
@@ -421,6 +423,8 @@ export class ComboRow extends ActionRow {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_string_filter_match_mode_get_type",
                 },
                 value: searchMatchMode,
             },

package/dist/generated/adw/dialog.js

@@ -283,6 +283,8 @@ export class Dialog extends Gtk.Widget {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libadwaita-1.so.0",
+            getTypeFn: "adw_dialog_presentation_mode_get_type",
         });
     }
     /** Gets the title of `self`. */
@@ -546,6 +548,8 @@ export class Dialog extends Gtk.Widget {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libadwaita-1.so.0",
+                    getTypeFn: "adw_dialog_presentation_mode_get_type",
                 },
                 value: presentationMode,
             },

package/dist/generated/adw/entry-row.js

@@ -163,6 +163,8 @@ export class EntryRow extends PreferencesRow {
             type: "int",
             size: 32,
             unsigned: true,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_input_hints_get_type",
         });
     }
     /** Gets the input purpose of `self`. */
@@ -179,6 +181,8 @@ export class EntryRow extends PreferencesRow {
             type: "int",
             size: 32,
             unsigned: false,
+            lib: "libgtk-4.so.1",
+            getTypeFn: "gtk_input_purpose_get_type",
         });
     }
     /** Retrieves the maximum length of the entry. */
@@ -361,6 +365,8 @@ export class EntryRow extends PreferencesRow {
                     type: "int",
                     size: 32,
                     unsigned: true,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_input_hints_get_type",
                 },
                 value: hints,
             },
@@ -387,6 +393,8 @@ export class EntryRow extends PreferencesRow {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_input_purpose_get_type",
                 },
                 value: purpose,
             },
@@ -494,6 +502,8 @@ export class EntryRow extends PreferencesRow {
                     type: "int",
                     size: 32,
                     unsigned: false,
+                    lib: "libgtk-4.so.1",
+                    getTypeFn: "gtk_accessible_platform_state_get_type",
                 },
                 value: state,
             },