@gtkx/ffi 0.6.0 → 0.7.0

package/dist/generated/gdk/memory-texture-builder.js

@@ -1,4 +1,4 @@
-import { call, getObject, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { call, getObject, getBoxed, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
 import * as GObject from "../gobject/index.js";
 /**
  * Constructs [class@Gdk.Texture] objects from system memory provided
@@ -70,7 +70,7 @@ export class MemoryTextureBuilder extends GObject.GObject {
         });
         if (ptr === null)
             return null;
-        return getObject(ptr);
+        return getBoxed(ptr, "GBytes");
     }
     /**
      * Gets the colorstate previously set via gdk_memory_texture_builder_set_color_state().
@@ -87,7 +87,7 @@ export class MemoryTextureBuilder extends GObject.GObject {
             innerType: "GdkColorState",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GdkColorState");
     }
     /**
      * Gets the format previously set via gdk_memory_texture_builder_set_format().
@@ -173,7 +173,7 @@ export class MemoryTextureBuilder extends GObject.GObject {
         });
         if (ptr === null)
             return null;
-        return getObject(ptr);
+        return getBoxed(ptr, "CairoRegion");
     }
     /**
      * Gets the texture previously set via gdk_memory_texture_builder_set_update_texture()

package/dist/generated/gdk/paintable.js

@@ -1,4 +1,4 @@
-import { call, getObject } from "@gtkx/ffi";
+import { call, getInterface } from "@gtkx/ffi";
 /**
  * An interface for content that can be painted.
  *
@@ -118,7 +118,7 @@ export class Paintable {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr);
+        return getInterface(ptr, Paintable);
     }
     /**
      * Get flags for the paintable.

package/dist/generated/gdk/popup-layout.js

@@ -1,4 +1,4 @@
-import { call, getObject, registerType } from "@gtkx/ffi";
+import { call, getBoxed, registerType } from "@gtkx/ffi";
 /**
  * Contains information that is necessary position a [iface@Gdk.Popup]
  * relative to its parent.
@@ -83,7 +83,7 @@ export class PopupLayout {
             innerType: "GdkPopupLayout",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GdkPopupLayout");
     }
     /**
      * Check whether `layout` and `other` has identical layout properties.
@@ -147,7 +147,7 @@ export class PopupLayout {
             innerType: "GdkRectangle",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GdkRectangle");
     }
     /**
      * Retrieves the offset for the anchor rectangle.
@@ -281,7 +281,7 @@ export class PopupLayout {
             innerType: "GdkPopupLayout",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GdkPopupLayout");
     }
     /**
      * Set new anchor hints.

package/dist/generated/gdk/rgba.js

@@ -1,5 +1,5 @@
 import { alloc, read, write } from "@gtkx/native";
-import { call, getObject, registerType } from "@gtkx/ffi";
+import { call, getBoxed, registerType } from "@gtkx/ffi";
 /**
  * Represents a color, in a way that is compatible with cairo’s notion of color.
  *
@@ -50,7 +50,7 @@ export class RGBA {
             innerType: "GdkRGBA",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GdkRGBA");
     }
     /**
      * Compares two `GdkRGBA` colors.

package/dist/generated/gdk/surface.js

@@ -1,4 +1,4 @@
-import { call, NativeError, getObject, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { call, NativeError, getObject, getBoxed, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
 import { Event } from "./event.js";
 import { Monitor } from "./monitor.js";
 import * as GObject from "../gobject/index.js";
@@ -193,7 +193,7 @@ export class Surface extends GObject.GObject {
             innerType: "CairoSurface",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "CairoSurface");
     }
     /**
      * Sets an error and returns %NULL.

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

@@ -1,4 +1,4 @@
-import { call, getObject, registerType } from "@gtkx/ffi";
+import { call, getObject, getBoxed, registerType } from "@gtkx/ffi";
 /**
  * Used to download the contents of a [class@Gdk.Texture].
  *
@@ -48,7 +48,7 @@ export class TextureDownloader {
             innerType: "GdkTextureDownloader",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GdkTextureDownloader");
     }
     /**
      * Downloads the given texture pixels into a `GBytes`. The rowstride will
@@ -87,7 +87,7 @@ export class TextureDownloader {
             innerType: "GBytes",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GBytes");
     }
     /**
      * Downloads the given texture pixels into a `GBytes`. The offsets and
@@ -135,7 +135,7 @@ export class TextureDownloader {
             innerType: "GBytes",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GBytes");
     }
     /**
      * Downloads the `texture` into local memory.
@@ -204,7 +204,7 @@ export class TextureDownloader {
             innerType: "GdkColorState",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GdkColorState");
     }
     /**
      * Gets the format that the data will be downloaded in.

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

@@ -3,6 +3,7 @@ import { MemoryFormat, PaintableFlags } from "./enums.js";
 import { ColorState } from "./color-state.js";
 import { Paintable } from "./paintable.js";
 import { Snapshot } from "./snapshot.js";
+import * as AppStream from "../appstream/index.js";
 import * as GLib from "../glib/index.js";
 import * as GObject from "../gobject/index.js";
 import * as GdkPixbuf from "../gdkpixbuf/index.js";
@@ -339,6 +340,66 @@ export declare class Texture extends GObject.GObject {
      * @param height - height to snapshot in
      */
     snapshot(snapshot: Snapshot, width: number, height: number): void;
+    /**
+     * Checks if two icons are equal.
+     * @param icon2 - pointer to the second #GIcon.
+     */
+    equal(icon2?: AppStream.Icon | null): boolean;
+    /**
+     * Gets a hash for an icon.
+     */
+    hash(): number;
+    /**
+     * Serializes a #GIcon into a #GVariant. An equivalent #GIcon can be retrieved
+     * back by calling g_icon_deserialize() on the returned value.
+     * As serialization will avoid using raw icon data when possible, it only
+     * makes sense to transfer the #GVariant between processes on the same machine,
+     * (as opposed to over the network), and within the same file system namespace.
+     */
+    serialize(): GLib.Variant | null;
+    /**
+     * Generates a textual representation of `icon` that can be used for
+     * serialization such as when passing `icon` to a different process or
+     * saving it to persistent storage. Use g_icon_new_for_string() to
+     * get `icon` back from the returned string.
+     *
+     * The encoding of the returned string is proprietary to #GIcon except
+     * in the following two cases
+     *
+     * - If `icon` is a #GFileIcon, the returned string is a native path
+     * (such as `/path/to/my icon.png`) without escaping
+     * if the #GFile for `icon` is a native file.  If the file is not
+     * native, the returned string is the result of g_file_get_uri()
+     * (such as `sftp://path/to/my%20icon.png`).
+     *
+     * - If `icon` is a #GThemedIcon with exactly one name and no fallbacks,
+     * the encoding is simply the name (such as `network-server`).
+     */
+    toString(): string | null;
+    /**
+     * Loads a loadable icon. For the asynchronous version of this function,
+     * see g_loadable_icon_load_async().
+     * @param size - an integer.
+     * @param type - a location to store the type of the loaded
+     * @param cancellable - optional #GCancellable object, %NULL to
+     */
+    load(size: number, type?: Ref<string> | null, cancellable?: Gio.Cancellable | null): Gio.InputStream;
+    /**
+     * Loads an icon asynchronously. To finish this function, see
+     * g_loadable_icon_load_finish(). For the synchronous, blocking
+     * version of this function, see g_loadable_icon_load().
+     * @param size - an integer.
+     * @param cancellable - optional #GCancellable object, %NULL to ignore.
+     * @param callback - a #GAsyncReadyCallback
+     * @param userData - the data to pass to callback function
+     */
+    loadAsync(size: number, cancellable?: Gio.Cancellable | null, callback?: (...args: unknown[]) => unknown | null, userData?: number | null): void;
+    /**
+     * Finishes an asynchronous icon load started in g_loadable_icon_load_async().
+     * @param res - a #GAsyncResult.
+     * @param type - a location to store the type of the loaded
+     */
+    loadFinish(res: Gio.AsyncResult, type?: Ref<string> | null): Gio.InputStream;
     connect(signal: "notify", handler: (self: Texture, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }

package/dist/generated/gdk/texture.js

@@ -1,4 +1,5 @@
-import { call, getObject, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { call, NativeError, getObject, getBoxed, getInterface, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { Paintable } from "./paintable.js";
 import * as GObject from "../gobject/index.js";
 /**
  * Refers to pixel data in various forms.
@@ -75,6 +76,7 @@ export class Texture extends GObject.GObject {
      * @param bytes - a `GBytes` containing the data to load
      */
     static newFromBytes(bytes) {
+        const error = { value: null };
         const ptr = call("libgtk-4.so.1", "gdk_texture_new_from_bytes", [
             {
                 type: {
@@ -85,7 +87,21 @@ export class Texture extends GObject.GObject {
                 },
                 value: bytes?.id ?? bytes,
             },
+            {
+                type: {
+                    type: "ref",
+                    innerType: {
+                        type: "boxed",
+                        innerType: "GError",
+                        lib: "libglib-2.0.so.0",
+                    },
+                },
+                value: error,
+            },
         ], { type: "gobject", borrowed: false });
+        if (error.value !== null) {
+            throw new NativeError(error.value);
+        }
         return getObject(ptr);
     }
     /**
@@ -107,12 +123,27 @@ export class Texture extends GObject.GObject {
      * @param file - `GFile` to load
      */
     static newFromFile(file) {
+        const error = { value: null };
         const ptr = call("libgtk-4.so.1", "gdk_texture_new_from_file", [
             {
                 type: { type: "gobject", borrowed: true },
                 value: file?.id ?? file,
             },
+            {
+                type: {
+                    type: "ref",
+                    innerType: {
+                        type: "boxed",
+                        innerType: "GError",
+                        lib: "libglib-2.0.so.0",
+                    },
+                },
+                value: error,
+            },
         ], { type: "gobject", borrowed: false });
+        if (error.value !== null) {
+            throw new NativeError(error.value);
+        }
         return getObject(ptr);
     }
     /**
@@ -134,12 +165,27 @@ export class Texture extends GObject.GObject {
      * @param path - the filename to load
      */
     static newFromFilename(path) {
+        const error = { value: null };
         const ptr = call("libgtk-4.so.1", "gdk_texture_new_from_filename", [
             {
                 type: { type: "string" },
                 value: path,
             },
+            {
+                type: {
+                    type: "ref",
+                    innerType: {
+                        type: "boxed",
+                        innerType: "GError",
+                        lib: "libglib-2.0.so.0",
+                    },
+                },
+                value: error,
+            },
         ], { type: "gobject", borrowed: false });
+        if (error.value !== null) {
+            throw new NativeError(error.value);
+        }
         return getObject(ptr);
     }
     /**
@@ -227,7 +273,7 @@ export class Texture extends GObject.GObject {
             innerType: "GdkColorState",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GdkColorState");
     }
     /**
      * Gets the memory format most closely associated with the data of
@@ -320,7 +366,7 @@ export class Texture extends GObject.GObject {
             innerType: "GBytes",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GBytes");
     }
     /**
      * Store the given `texture` to the `filename` as a TIFF file.
@@ -366,7 +412,7 @@ export class Texture extends GObject.GObject {
             innerType: "GBytes",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GBytes");
     }
     /**
      * Compute a concrete size for the `GdkPaintable`.
@@ -432,7 +478,7 @@ export class Texture extends GObject.GObject {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr);
+        return getInterface(ptr, Paintable);
     }
     /**
      * Get flags for the paintable.
@@ -586,6 +632,202 @@ export class Texture extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Checks if two icons are equal.
+     * @param icon2 - pointer to the second #GIcon.
+     */
+    equal(icon2) {
+        return call("libgtk-4.so.1", "g_icon_equal", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "gobject", borrowed: true },
+                value: icon2?.id ?? icon2,
+                optional: true,
+            },
+        ], { type: "boolean" });
+    }
+    /**
+     * Gets a hash for an icon.
+     */
+    hash() {
+        return call("libgtk-4.so.1", "g_icon_hash", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "int", size: 32, unsigned: true });
+    }
+    /**
+     * Serializes a #GIcon into a #GVariant. An equivalent #GIcon can be retrieved
+     * back by calling g_icon_deserialize() on the returned value.
+     * As serialization will avoid using raw icon data when possible, it only
+     * makes sense to transfer the #GVariant between processes on the same machine,
+     * (as opposed to over the network), and within the same file system namespace.
+     */
+    serialize() {
+        const ptr = call("libgtk-4.so.1", "g_icon_serialize", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], {
+            type: "boxed",
+            borrowed: true,
+            innerType: "GVariant",
+            lib: "libgtk-4.so.1",
+        });
+        if (ptr === null)
+            return null;
+        return getBoxed(ptr, "GVariant");
+    }
+    /**
+     * Generates a textual representation of `icon` that can be used for
+     * serialization such as when passing `icon` to a different process or
+     * saving it to persistent storage. Use g_icon_new_for_string() to
+     * get `icon` back from the returned string.
+     *
+     * The encoding of the returned string is proprietary to #GIcon except
+     * in the following two cases
+     *
+     * - If `icon` is a #GFileIcon, the returned string is a native path
+     * (such as `/path/to/my icon.png`) without escaping
+     * if the #GFile for `icon` is a native file.  If the file is not
+     * native, the returned string is the result of g_file_get_uri()
+     * (such as `sftp://path/to/my%20icon.png`).
+     *
+     * - If `icon` is a #GThemedIcon with exactly one name and no fallbacks,
+     * the encoding is simply the name (such as `network-server`).
+     */
+    toString() {
+        return call("libgtk-4.so.1", "g_icon_to_string", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string" });
+    }
+    /**
+     * Loads a loadable icon. For the asynchronous version of this function,
+     * see g_loadable_icon_load_async().
+     * @param size - an integer.
+     * @param type - a location to store the type of the loaded
+     * @param cancellable - optional #GCancellable object, %NULL to
+     */
+    load(size, type, cancellable) {
+        const error = { value: null };
+        const ptr = call("libgtk-4.so.1", "g_loadable_icon_load", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: false },
+                value: size,
+            },
+            {
+                type: { type: "ref", innerType: { type: "string" } },
+                value: type,
+                optional: true,
+            },
+            {
+                type: { type: "gobject", borrowed: true },
+                value: cancellable?.id ?? cancellable,
+                optional: true,
+            },
+            {
+                type: {
+                    type: "ref",
+                    innerType: {
+                        type: "boxed",
+                        innerType: "GError",
+                        lib: "libglib-2.0.so.0",
+                    },
+                },
+                value: error,
+            },
+        ], { type: "gobject", borrowed: true });
+        if (error.value !== null) {
+            throw new NativeError(error.value);
+        }
+        return getObject(ptr);
+    }
+    /**
+     * Loads an icon asynchronously. To finish this function, see
+     * g_loadable_icon_load_finish(). For the synchronous, blocking
+     * version of this function, see g_loadable_icon_load().
+     * @param size - an integer.
+     * @param cancellable - optional #GCancellable object, %NULL to ignore.
+     * @param callback - a #GAsyncReadyCallback
+     * @param userData - the data to pass to callback function
+     */
+    loadAsync(size, cancellable, callback, userData) {
+        call("libgtk-4.so.1", "g_loadable_icon_load_async", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: false },
+                value: size,
+            },
+            {
+                type: { type: "gobject", borrowed: true },
+                value: cancellable?.id ?? cancellable,
+                optional: true,
+            },
+            {
+                type: { type: "callback" },
+                value: callback,
+                optional: true,
+            },
+            {
+                type: { type: "int", size: 64, unsigned: true },
+                value: userData,
+                optional: true,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Finishes an asynchronous icon load started in g_loadable_icon_load_async().
+     * @param res - a #GAsyncResult.
+     * @param type - a location to store the type of the loaded
+     */
+    loadFinish(res, type) {
+        const error = { value: null };
+        const ptr = call("libgtk-4.so.1", "g_loadable_icon_load_finish", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "gobject", borrowed: true },
+                value: res?.id ?? res,
+            },
+            {
+                type: { type: "ref", innerType: { type: "string" } },
+                value: type,
+                optional: true,
+            },
+            {
+                type: {
+                    type: "ref",
+                    innerType: {
+                        type: "boxed",
+                        innerType: "GError",
+                        lib: "libglib-2.0.so.0",
+                    },
+                },
+                value: error,
+            },
+        ], { type: "gobject", borrowed: true });
+        if (error.value !== null) {
+            throw new NativeError(error.value);
+        }
+        return getObject(ptr);
+    }
     connect(signal, handler, after = false) {
         const selfType = { type: "gobject", borrowed: true };
         const argTypes = [selfType];

package/dist/generated/gdk/toplevel-layout.js

@@ -1,4 +1,4 @@
-import { call, getObject, registerType } from "@gtkx/ffi";
+import { call, getObject, getBoxed, registerType } from "@gtkx/ffi";
 /**
  * Contains information that is necessary to present a sovereign
  * window on screen.
@@ -52,7 +52,7 @@ export class ToplevelLayout {
             innerType: "GdkToplevelLayout",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GdkToplevelLayout");
     }
     /**
      * Check whether `layout` and `other` has identical layout properties.
@@ -183,7 +183,7 @@ export class ToplevelLayout {
             innerType: "GdkToplevelLayout",
             lib: "libgtk-4.so.1",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GdkToplevelLayout");
     }
     /**
      * Sets whether the layout should cause the surface

package/dist/generated/gdkpixbuf/constants.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Major version of gdk-pixbuf library, that is the "0" in
+ * "0.8.2" for example.
+ */
+export declare const PIXBUF_MAJOR = 2;
+/**
+ * Micro version of gdk-pixbuf library, that is the "2" in
+ * "0.8.2" for example.
+ */
+export declare const PIXBUF_MICRO = 4;
+/**
+ * Minor version of gdk-pixbuf library, that is the "8" in
+ * "0.8.2" for example.
+ */
+export declare const PIXBUF_MINOR = 44;
+/**
+ * Contains the full version of GdkPixbuf as a string.
+ *
+ * This is the version being compiled against; contrast with
+ * `gdk_pixbuf_version`.
+ */
+export declare const PIXBUF_VERSION = "2.44.4";

package/dist/generated/gdkpixbuf/constants.js

@@ -0,0 +1,22 @@
+/**
+ * Major version of gdk-pixbuf library, that is the "0" in
+ * "0.8.2" for example.
+ */
+export const PIXBUF_MAJOR = 2;
+/**
+ * Micro version of gdk-pixbuf library, that is the "2" in
+ * "0.8.2" for example.
+ */
+export const PIXBUF_MICRO = 4;
+/**
+ * Minor version of gdk-pixbuf library, that is the "8" in
+ * "0.8.2" for example.
+ */
+export const PIXBUF_MINOR = 44;
+/**
+ * Contains the full version of GdkPixbuf as a string.
+ *
+ * This is the version being compiled against; contrast with
+ * `gdk_pixbuf_version`.
+ */
+export const PIXBUF_VERSION = "2.44.4";

package/dist/generated/gdkpixbuf/index.d.ts

@@ -8,3 +8,4 @@ export * from "./pixbuf-non-anim.js";
 export * from "./pixbuf-simple-anim.js";
 export * from "./pixbuf-simple-anim-iter.js";
 export * from "./functions.js";
+export * from "./constants.js";

package/dist/generated/gdkpixbuf/index.js

@@ -8,3 +8,4 @@ export * from "./pixbuf-non-anim.js";
 export * from "./pixbuf-simple-anim.js";
 export * from "./pixbuf-simple-anim-iter.js";
 export * from "./functions.js";
+export * from "./constants.js";