@gtkx/ffi 0.9.1 → 0.9.3

package/dist/generated/gdk/surface.js

@@ -1,6 +1,6 @@
 import { call } from "../../batch.js";
 import { NativeError } from "../../native/error.js";
-import { getObject } from "../../native/object.js";
+import { getNativeObject } from "../../native/object.js";
 import { isInstantiating, setInstantiating } from "../../native/base.js";
 import { registerNativeClass, getNativeClass } from "../../registry.js";
 import * as GObject from "../gobject/index.js";
@@ -11,8 +11,8 @@ import * as cairo from "../cairo/index.js";
  * It’s a low-level object, used to implement high-level objects
  * such as GtkWindow.
  *
- * The surfaces you see in practice are either [iface@Gdk.Toplevel] or
- * [iface@Gdk.Popup], and those interfaces provide much of the required
+ * The surfaces you see in practice are either {@link Gdk.Toplevel} or
+ * {@link Gdk.Popup}, and those interfaces provide much of the required
  * API to interact with these surfaces. Other, more specialized surface
  * types exist, but you will rarely interact with them directly.
  */
@@ -37,7 +37,15 @@ const SIGNAL_META = {
         returnType: { type: "undefined" },
     },
     render: {
-        params: [{ type: "boxed", borrowed: true, innerType: "CairoRegion" }],
+        params: [
+            {
+                type: "boxed",
+                borrowed: true,
+                innerType: "CairoRegion",
+                lib: "libcairo-gobject.so.2",
+                getTypeFn: "cairo_gobject_region_get_type",
+            },
+        ],
         returnType: { type: "boolean" },
     },
 };
@@ -48,7 +56,7 @@ export class Surface extends GObject.GObject {
      * Create a new popup surface.
      *
      * The surface will be attached to `parent` and can be positioned
-     * relative to it using [method@Gdk.Popup.present].
+     * relative to it using {@link Gdk.Popup.present}.
      * @param parent - the parent surface to attach the surface to
      * @param autohide - whether to hide the surface on outside clicks
      */
@@ -85,13 +93,13 @@ export class Surface extends GObject.GObject {
                 value: display?.id ?? display,
             },
         ], { type: "gobject", borrowed: false });
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
-     * Emits a short beep associated to @surface.
+     * Emits a short beep associated to `surface`.
      *
      * If the display of `surface` does not support per-surface beeps,
-     * emits a short beep on the display just as [method@Gdk.Display.beep].
+     * emits a short beep on the display just as {@link Gdk.Display.beep}.
      */
     beep() {
         call("libgtk-4.so.1", "gdk_surface_beep", [
@@ -102,7 +110,7 @@ export class Surface extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Creates a new `GdkCairoContext` for rendering on @surface.
+     * Creates a new `GdkCairoContext` for rendering on `surface`.
      */
     createCairoContext() {
         const ptr = call("libgtk-4.so.1", "gdk_surface_create_cairo_context", [
@@ -119,7 +127,7 @@ export class Surface extends GObject.GObject {
      * The context is disconnected from any particular surface or surface.
      * If the creation of the `GdkGLContext` failed, `error` will be set.
      * Before using the returned `GdkGLContext`, you will need to
-     * call [method@Gdk.GLContext.make_current] or [method@Gdk.GLContext.realize].
+     * call {@link Gdk.GLContext.make_current} or {@link Gdk.GLContext.realize}.
      */
     createGlContext() {
         const error = { value: null };
@@ -147,11 +155,11 @@ export class Surface extends GObject.GObject {
     }
     /**
      * Create a new Cairo surface that is as compatible as possible with the
-     * given @surface.
+     * given `surface`.
      *
      * For example the new surface will have the same fallback resolution
-     * and font options as @surface. Generally, the new surface will also
-     * use the same backend as @surface, unless that is not possible for
+     * and font options as `surface`. Generally, the new surface will also
+     * use the same backend as `surface`, unless that is not possible for
      * some reason. The type of the returned surface may be examined with
      * cairo_surface_get_type().
      *
@@ -187,9 +195,10 @@ export class Surface extends GObject.GObject {
             type: "boxed",
             borrowed: true,
             innerType: "CairoSurface",
-            lib: "libgtk-4.so.1",
+            lib: "libcairo-gobject.so.2",
+            getTypeFn: "cairo_gobject_surface_get_type",
         });
-        return getObject(ptr, cairo.Surface);
+        return getNativeObject(ptr, cairo.Surface);
     }
     /**
      * Sets an error and returns %NULL.
@@ -220,7 +229,7 @@ export class Surface extends GObject.GObject {
     }
     /**
      * Destroys the window system resources associated with `surface` and
-     * decrements @surface's reference count.
+     * decrements `surface`'s reference count.
      *
      * The window system resources for all children of `surface` are also
      * destroyed, but the children’s reference counts are not decremented.
@@ -244,7 +253,7 @@ export class Surface extends GObject.GObject {
      * If the return value is %NULL then there is no custom cursor set on
      * the surface, and it is using the cursor for its parent surface.
      *
-     * Use [method@Gdk.Surface.set_cursor] to unset the cursor of the surface.
+     * Use {@link Gdk.Surface.set_cursor} to unset the cursor of the surface.
      */
     getCursor() {
         const ptr = call("libgtk-4.so.1", "gdk_surface_get_cursor", [
@@ -255,7 +264,7 @@ export class Surface extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         if (ptr === null)
             return null;
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Retrieves a `GdkCursor` pointer for the `device` currently set on the
@@ -264,7 +273,7 @@ export class Surface extends GObject.GObject {
      * If the return value is %NULL then there is no custom cursor set on the
      * specified surface, and it is using the cursor for its parent surface.
      *
-     * Use [method@Gdk.Surface.set_cursor] to unset the cursor of the surface.
+     * Use {@link Gdk.Surface.set_cursor} to unset the cursor of the surface.
      * @param device - a pointer `GdkDevice`
      */
     getDeviceCursor(device) {
@@ -280,16 +289,16 @@ export class Surface extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         if (ptr === null)
             return null;
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Obtains the current device position and modifier state.
      *
      * The position is given in coordinates relative to the upper
-     * left corner of @surface.
+     * left corner of `surface`.
      * @param device - pointer `GdkDevice` to query to
-     * @param x - return location for the X coordinate of @device
-     * @param y - return location for the Y coordinate of @device
+     * @param x - return location for the X coordinate of `device`
+     * @param y - return location for the Y coordinate of `device`
      * @param mask - return location for the modifier mask
      */
     getDevicePosition(device, x, y, mask) {
@@ -332,7 +341,7 @@ export class Surface extends GObject.GObject {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Gets the frame clock for the surface.
@@ -347,13 +356,13 @@ export class Surface extends GObject.GObject {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
-     * Returns the height of the given @surface.
+     * Returns the height of the given `surface`.
      *
      * Surface size is reported in ”application pixels”, not
-     * ”device pixels” (see [method@Gdk.Surface.get_scale_factor]).
+     * ”device pixels” (see {@link Gdk.Surface.get_scale_factor}).
      */
     getHeight() {
         return call("libgtk-4.so.1", "gdk_surface_get_height", [
@@ -366,8 +375,8 @@ export class Surface extends GObject.GObject {
     /**
      * Checks whether the surface has been mapped.
      *
-     * A surface is mapped with [method@Gdk.Toplevel.present]
-     * or [method@Gdk.Popup.present].
+     * A surface is mapped with {@link Gdk.Toplevel.present}
+     * or {@link Gdk.Popup.present}.
      */
     getMapped() {
         return call("libgtk-4.so.1", "gdk_surface_get_mapped", [
@@ -385,7 +394,7 @@ export class Surface extends GObject.GObject {
      * buffers with a resolution that is bigger than the surface size (e.g.
      * to show the surface on a high-resolution display, or in a magnifier).
      *
-     * Compare with [method@Gdk.Surface.get_scale_factor], which returns the
+     * Compare with {@link Gdk.Surface.get_scale_factor}, which returns the
      * next larger integer.
      *
      * The scale may change during the lifetime of the surface.
@@ -420,10 +429,10 @@ export class Surface extends GObject.GObject {
         ], { type: "int", size: 32, unsigned: false });
     }
     /**
-     * Returns the width of the given @surface.
+     * Returns the width of the given `surface`.
      *
      * Surface size is reported in ”application pixels”, not
-     * ”device pixels” (see [method@Gdk.Surface.get_scale_factor]).
+     * ”device pixels” (see {@link Gdk.Surface.get_scale_factor}).
      */
     getWidth() {
         return call("libgtk-4.so.1", "gdk_surface_get_width", [
@@ -461,7 +470,8 @@ export class Surface extends GObject.GObject {
         ], { type: "boolean" });
     }
     /**
-     * Forces a [signal@Gdk.Surface::render] signal emission for `surface` to be scheduled.
+     * Forces a {@link Gdk.Surface.:render} signal emission for `surface`
+     * to be scheduled.
      *
      * This function is useful for implementations that track invalid
      * regions on their own.
@@ -477,7 +487,7 @@ export class Surface extends GObject.GObject {
     /**
      * Request a layout phase from the surface's frame clock.
      *
-     * See [method@Gdk.FrameClock.request_phase].
+     * See {@link Gdk.FrameClock.request_phase}.
      */
     requestLayout() {
         call("libgtk-4.so.1", "gdk_surface_request_layout", [
@@ -492,9 +502,9 @@ export class Surface extends GObject.GObject {
      *
      * Passing %NULL for the `cursor` argument means that `surface` will use
      * the cursor of its parent surface. Most surfaces should use this default.
-     * Note that `cursor` must be for the same display as @surface.
+     * Note that `cursor` must be for the same display as `surface`.
      *
-     * Use [ctor@Gdk.Cursor.new_from_name] or [ctor@Gdk.Cursor.new_from_texture]
+     * Use {@link Gdk.Cursor.new_from_name} or {@link Gdk.Cursor.new_from_texture}
      * to create the cursor. To make the cursor invisible, use %GDK_BLANK_CURSOR.
      * @param cursor - a `GdkCursor`
      */
@@ -512,12 +522,12 @@ export class Surface extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets a specific `GdkCursor` for a given device when it gets inside @surface.
+     * Sets a specific `GdkCursor` for a given device when it gets inside `surface`.
      *
      * Passing %NULL for the `cursor` argument means that `surface` will use the
      * cursor of its parent surface. Most surfaces should use this default.
      *
-     * Use [ctor@Gdk.Cursor.new_from_name] or [ctor@Gdk.Cursor.new_from_texture]
+     * Use {@link Gdk.Cursor.new_from_name} or {@link Gdk.Cursor.new_from_texture}
      * to create the cursor. To make the cursor invisible, use %GDK_BLANK_CURSOR.
      * @param device - a pointer `GdkDevice`
      * @param cursor - a `GdkCursor`
@@ -544,14 +554,14 @@ export class Surface extends GObject.GObject {
      *
      * Mouse events which happen while the pointer position corresponds
      * to an unset bit in the mask will be passed on the surface below
-     * @surface.
+     * `surface`.
      *
      * An input region is typically used with RGBA surfaces. The alpha
      * channel of the surface defines which pixels are invisible and
      * allows for nicely antialiased borders, and the input region
      * controls where the surface is “clickable”.
      *
-     * Use [method@Gdk.Display.supports_input_shapes] to find out if
+     * Use {@link Gdk.Display.supports_input_shapes} to find out if
      * a particular backend supports input regions.
      * @param region - region of surface to be reactive,
      */
@@ -566,7 +576,8 @@ export class Surface extends GObject.GObject {
                     type: "boxed",
                     borrowed: true,
                     innerType: "CairoRegion",
-                    lib: "libgtk-4.so.1",
+                    lib: "libcairo-gobject.so.2",
+                    getTypeFn: "cairo_gobject_region_get_type",
                 },
                 value: region?.id ?? region,
                 optional: true,
@@ -602,7 +613,8 @@ export class Surface extends GObject.GObject {
                     type: "boxed",
                     borrowed: true,
                     innerType: "CairoRegion",
-                    lib: "libgtk-4.so.1",
+                    lib: "libcairo-gobject.so.2",
+                    getTypeFn: "cairo_gobject_region_get_type",
                 },
                 value: region?.id ?? region,
                 optional: true,
@@ -644,17 +656,17 @@ export class Surface extends GObject.GObject {
         const argTypes = meta ? [selfType, ...meta.params] : [selfType];
         const returnType = meta?.returnType;
         const wrappedHandler = (...args) => {
-            const self = getObject(args[0]);
+            const self = getNativeObject(args[0]);
             const signalArgs = args.slice(1);
             if (!meta)
                 return handler(self, ...signalArgs);
             const wrapped = meta.params.map((m, i) => {
                 if (m.type === "gobject" && signalArgs[i] != null) {
-                    return getObject(signalArgs[i]);
+                    return getNativeObject(signalArgs[i]);
                 }
                 if (m.type === "boxed" && signalArgs[i] != null) {
                     const cls = getNativeClass(m.innerType);
-                    return cls ? getObject(signalArgs[i], cls) : signalArgs[i];
+                    return cls ? getNativeObject(signalArgs[i], cls) : signalArgs[i];
                 }
                 return signalArgs[i];
             });

package/dist/generated/gdk/texture-downloader.d.ts

@@ -5,7 +5,7 @@ import { ColorState } from "./color-state.js";
 import { Texture } from "./texture.js";
 import * as GLib from "../glib/index.js";
 /**
- * Used to download the contents of a [class@Gdk.Texture].
+ * Used to download the contents of a {@link Gdk.Texture}.
  *
  * It is intended to be created as a short-term object for a single download,
  * but can be used for multiple downloads of different textures or with different
@@ -19,7 +19,7 @@ export declare class TextureDownloader extends NativeObject {
     static readonly glibTypeName: string;
     static readonly objectType: "boxed";
     /**
-     * Creates a new texture downloader for @texture.
+     * Creates a new texture downloader for `texture`.
      *
      * By default, the downloader will convert the data to
      * the default memory format, and to the sRGB color state.
@@ -41,11 +41,11 @@ export declare class TextureDownloader extends NativeObject {
      *
      * This function will abort if it tries to download a large texture and
      * fails to allocate memory. If you think that may happen, you should handle
-     * memory allocation yourself and use [method@Gdk.TextureDownloader.download_into]
+     * memory allocation yourself and use {@link Gdk.TextureDownloader.download_into}
      * once allocation succeeded.
      *
      * This function cannot be used with a multiplanar format. Use
-     * [method@Gdk.TextureDownloader.download_bytes_with_planes] for that purpose.
+     * {@link Gdk.TextureDownloader.download_bytes_with_planes} for that purpose.
      * @param outStride - The stride of the resulting data in bytes
      */
     downloadBytes(outStride: Ref<number>): GLib.Bytes;
@@ -86,7 +86,7 @@ export declare class TextureDownloader extends NativeObject {
     /**
      * Sets the color state the downloader will convert the data to.
      *
-     * By default, the sRGB colorstate returned by [func@ColorState.get_srgb]
+     * By default, the sRGB colorstate returned by {@link ColorState.get_srgb}
      * is used.
      * @param colorState - the color state to use
      */

package/dist/generated/gdk/texture-downloader.js

@@ -1,11 +1,11 @@
 import { call } from "../../batch.js";
-import { getObject } from "../../native/object.js";
+import { getNativeObject } from "../../native/object.js";
 import { NativeObject } from "../../native/base.js";
 import { registerNativeClass } from "../../registry.js";
 import { ColorState } from "./color-state.js";
 import * as GLib from "../glib/index.js";
 /**
- * Used to download the contents of a [class@Gdk.Texture].
+ * Used to download the contents of a {@link Gdk.Texture}.
  *
  * It is intended to be created as a short-term object for a single download,
  * but can be used for multiple downloads of different textures or with different
@@ -58,8 +58,9 @@ export class TextureDownloader extends NativeObject {
             borrowed: true,
             innerType: "GdkTextureDownloader",
             lib: "libgtk-4.so.1",
+            getTypeFn: "gdk_texture_downloader_get_type",
         });
-        return getObject(ptr, TextureDownloader);
+        return getNativeObject(ptr, TextureDownloader);
     }
     /**
      * Downloads the given texture pixels into a `GBytes`. The rowstride will
@@ -67,11 +68,11 @@ export class TextureDownloader extends NativeObject {
      *
      * This function will abort if it tries to download a large texture and
      * fails to allocate memory. If you think that may happen, you should handle
-     * memory allocation yourself and use [method@Gdk.TextureDownloader.download_into]
+     * memory allocation yourself and use {@link Gdk.TextureDownloader.download_into}
      * once allocation succeeded.
      *
      * This function cannot be used with a multiplanar format. Use
-     * [method@Gdk.TextureDownloader.download_bytes_with_planes] for that purpose.
+     * {@link Gdk.TextureDownloader.download_bytes_with_planes} for that purpose.
      * @param outStride - The stride of the resulting data in bytes
      */
     downloadBytes(outStride) {
@@ -96,9 +97,10 @@ export class TextureDownloader extends NativeObject {
             type: "boxed",
             borrowed: true,
             innerType: "GBytes",
-            lib: "libgtk-4.so.1",
+            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+            getTypeFn: "g_bytes_get_type",
         });
-        return getObject(ptr, GLib.Bytes);
+        return getNativeObject(ptr, GLib.Bytes);
     }
     /**
      * Downloads the given texture pixels into a `GBytes`. The offsets and
@@ -144,9 +146,10 @@ export class TextureDownloader extends NativeObject {
             type: "boxed",
             borrowed: true,
             innerType: "GBytes",
-            lib: "libgtk-4.so.1",
+            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+            getTypeFn: "g_bytes_get_type",
         });
-        return getObject(ptr, GLib.Bytes);
+        return getNativeObject(ptr, GLib.Bytes);
     }
     /**
      * Downloads the `texture` into local memory.
@@ -214,8 +217,9 @@ export class TextureDownloader extends NativeObject {
             borrowed: true,
             innerType: "GdkColorState",
             lib: "libgtk-4.so.1",
+            getTypeFn: "gdk_color_state_get_type",
         });
-        return getObject(ptr, ColorState);
+        return getNativeObject(ptr, ColorState);
     }
     /**
      * Gets the format that the data will be downloaded in.
@@ -248,12 +252,12 @@ export class TextureDownloader extends NativeObject {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Sets the color state the downloader will convert the data to.
      *
-     * By default, the sRGB colorstate returned by [func@ColorState.get_srgb]
+     * By default, the sRGB colorstate returned by {@link ColorState.get_srgb}
      * is used.
      * @param colorState - the color state to use
      */
@@ -274,6 +278,7 @@ export class TextureDownloader extends NativeObject {
                     borrowed: true,
                     innerType: "GdkColorState",
                     lib: "libgtk-4.so.1",
+                    getTypeFn: "gdk_color_state_get_type",
                 },
                 value: colorState?.id ?? colorState,
             },