@gtkx/ffi 0.9.4 → 0.10.0

package/dist/generated/glib/test-config.js

@@ -0,0 +1,66 @@
+import { alloc, read, write } from "@gtkx/native";
+import { NativeObject } from "../../native/base.js";
+export class TestConfig extends NativeObject {
+    static objectType = "struct";
+    constructor(init = {}) {
+        super();
+        this.id = this.createPtr(init);
+    }
+    createPtr(init) {
+        const ptr = alloc(6);
+        if (init.testInitialized !== undefined)
+            write(ptr, { type: "boolean" }, 0, init.testInitialized);
+        if (init.testQuick !== undefined)
+            write(ptr, { type: "boolean" }, 1, init.testQuick);
+        if (init.testPerf !== undefined)
+            write(ptr, { type: "boolean" }, 2, init.testPerf);
+        if (init.testVerbose !== undefined)
+            write(ptr, { type: "boolean" }, 3, init.testVerbose);
+        if (init.testQuiet !== undefined)
+            write(ptr, { type: "boolean" }, 4, init.testQuiet);
+        if (init.testUndefined !== undefined)
+            write(ptr, { type: "boolean" }, 5, init.testUndefined);
+        return ptr;
+    }
+    static fromPtr(ptr) {
+        const instance = Object.create(TestConfig.prototype);
+        instance.id = ptr;
+        return instance;
+    }
+    get testInitialized() {
+        return read(this.id, { type: "boolean" }, 0);
+    }
+    set testInitialized(value) {
+        write(this.id, { type: "boolean" }, 0, value);
+    }
+    get testQuick() {
+        return read(this.id, { type: "boolean" }, 1);
+    }
+    set testQuick(value) {
+        write(this.id, { type: "boolean" }, 1, value);
+    }
+    get testPerf() {
+        return read(this.id, { type: "boolean" }, 2);
+    }
+    set testPerf(value) {
+        write(this.id, { type: "boolean" }, 2, value);
+    }
+    get testVerbose() {
+        return read(this.id, { type: "boolean" }, 3);
+    }
+    set testVerbose(value) {
+        write(this.id, { type: "boolean" }, 3, value);
+    }
+    get testQuiet() {
+        return read(this.id, { type: "boolean" }, 4);
+    }
+    set testQuiet(value) {
+        write(this.id, { type: "boolean" }, 4, value);
+    }
+    get testUndefined() {
+        return read(this.id, { type: "boolean" }, 5);
+    }
+    set testUndefined(value) {
+        write(this.id, { type: "boolean" }, 5, value);
+    }
+}

package/dist/generated/glib/thread.js

@@ -80,7 +80,7 @@ export class Thread extends NativeObject {
             lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
             getTypeFn: "g_thread_get_type",
         });
-        return getNativeObject(ptr);
+        return getNativeObject(ptr, Thread);
     }
     /**
      * Causes the calling thread to voluntarily relinquish the CPU, so

package/dist/generated/glib/time-val.d.ts

@@ -0,0 +1,94 @@
+import { NativeObject } from "../../native/base.js";
+export interface TimeValInit {
+    tvSec?: number;
+    tvUsec?: number;
+}
+/**
+ * Represents a precise time, with seconds and microseconds.
+ *
+ * Similar to the struct timeval returned by the `gettimeofday()`
+ * UNIX system call.
+ *
+ * GLib is attempting to unify around the use of 64-bit integers to
+ * represent microsecond-precision time. As such, this type will be
+ * removed from a future version of GLib. A consequence of using `glong` for
+ * `tv_sec` is that on 32-bit systems `GTimeVal` is subject to the year 2038
+ * problem.
+ */
+export declare class TimeVal extends NativeObject {
+    static readonly objectType: "struct";
+    constructor(init?: TimeValInit);
+    protected createPtr(init: TimeValInit): unknown;
+    static fromPtr(ptr: unknown): TimeVal;
+    /**
+     * Converts a string containing an ISO 8601 encoded date and time
+     * to a #GTimeVal and puts it into `time_`.
+     *
+     * `iso_date` must include year, month, day, hours, minutes, and
+     * seconds. It can optionally include fractions of a second and a time
+     * zone indicator. (In the absence of any time zone indication, the
+     * timestamp is assumed to be in local time.)
+     *
+     * Any leading or trailing space in `iso_date` is ignored.
+     *
+     * This function was deprecated, along with #GTimeVal itself, in GLib 2.62.
+     * Equivalent functionality is available using code like:
+     * |[
+     * GDateTime *dt = g_date_time_new_from_iso8601 (iso8601_string, NULL);
+     * gint64 time_val = g_date_time_to_unix (dt);
+     * g_date_time_unref (dt);
+     * ]|
+     * @param isoDate - an ISO 8601 encoded date string
+     * @param time_ - a #GTimeVal
+     */
+    static fromIso8601(isoDate: string, time_: TimeVal): boolean;
+    /**
+     * Adds the given number of microseconds to `time_`. `microseconds` can
+     * also be negative to decrease the value of `time_`.
+     * @param microseconds - number of microseconds to add to `time`
+     */
+    add(microseconds: number): void;
+    /**
+     * Converts `time_` into an RFC 3339 encoded string, relative to the
+     * Coordinated Universal Time (UTC). This is one of the many formats
+     * allowed by ISO 8601.
+     *
+     * ISO 8601 allows a large number of date/time formats, with or without
+     * punctuation and optional elements. The format returned by this function
+     * is a complete date and time, with optional punctuation included, the
+     * UTC time zone represented as "Z", and the `tv_usec` part included if
+     * and only if it is nonzero, i.e. either
+     * "YYYY-MM-DDTHH:MM:SSZ" or "YYYY-MM-DDTHH:MM:SS.fffffZ".
+     *
+     * This corresponds to the Internet date/time format defined by
+     * [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt),
+     * and to either of the two most-precise formats defined by
+     * the W3C Note
+     * [Date and Time Formats](http://www.w3.org/TR/NOTE-datetime-19980827).
+     * Both of these documents are profiles of ISO 8601.
+     *
+     * Use g_date_time_format() or g_strdup_printf() if a different
+     * variation of ISO 8601 format is required.
+     *
+     * If `time_` represents a date which is too large to fit into a `struct tm`,
+     * %NULL will be returned. This is platform dependent. Note also that since
+     * `GTimeVal` stores the number of seconds as a `glong`, on 32-bit systems it
+     * is subject to the year 2038 problem. Accordingly, since GLib 2.62, this
+     * function has been deprecated. Equivalent functionality is available using:
+     * |[
+     * GDateTime *dt = g_date_time_new_from_unix_utc (time_val);
+     * iso8601_string = g_date_time_format_iso8601 (dt);
+     * g_date_time_unref (dt);
+     * ]|
+     *
+     * The return value of g_time_val_to_iso8601() has been nullable since GLib
+     * 2.54; before then, GLib would crash under the same conditions.
+     */
+    toIso8601(): string | null;
+    /** seconds */
+    get tvSec(): number;
+    set tvSec(value: number);
+    /** microseconds */
+    get tvUsec(): number;
+    set tvUsec(value: number);
+}

package/dist/generated/glib/time-val.js

@@ -0,0 +1,153 @@
+import { alloc, read, write } from "@gtkx/native";
+import { call } from "../../batch.js";
+import { NativeObject } from "../../native/base.js";
+/**
+ * Represents a precise time, with seconds and microseconds.
+ *
+ * Similar to the struct timeval returned by the `gettimeofday()`
+ * UNIX system call.
+ *
+ * GLib is attempting to unify around the use of 64-bit integers to
+ * represent microsecond-precision time. As such, this type will be
+ * removed from a future version of GLib. A consequence of using `glong` for
+ * `tv_sec` is that on 32-bit systems `GTimeVal` is subject to the year 2038
+ * problem.
+ */
+export class TimeVal extends NativeObject {
+    static objectType = "struct";
+    constructor(init = {}) {
+        super();
+        this.id = this.createPtr(init);
+    }
+    createPtr(init) {
+        const ptr = alloc(16);
+        if (init.tvSec !== undefined)
+            write(ptr, { type: "int", size: 64, unsigned: false }, 0, init.tvSec);
+        if (init.tvUsec !== undefined)
+            write(ptr, { type: "int", size: 64, unsigned: false }, 8, init.tvUsec);
+        return ptr;
+    }
+    static fromPtr(ptr) {
+        const instance = Object.create(TimeVal.prototype);
+        instance.id = ptr;
+        return instance;
+    }
+    /**
+     * Converts a string containing an ISO 8601 encoded date and time
+     * to a #GTimeVal and puts it into `time_`.
+     *
+     * `iso_date` must include year, month, day, hours, minutes, and
+     * seconds. It can optionally include fractions of a second and a time
+     * zone indicator. (In the absence of any time zone indication, the
+     * timestamp is assumed to be in local time.)
+     *
+     * Any leading or trailing space in `iso_date` is ignored.
+     *
+     * This function was deprecated, along with #GTimeVal itself, in GLib 2.62.
+     * Equivalent functionality is available using code like:
+     * |[
+     * GDateTime *dt = g_date_time_new_from_iso8601 (iso8601_string, NULL);
+     * gint64 time_val = g_date_time_to_unix (dt);
+     * g_date_time_unref (dt);
+     * ]|
+     * @param isoDate - an ISO 8601 encoded date string
+     * @param time_ - a #GTimeVal
+     */
+    static fromIso8601(isoDate, time_) {
+        return call("libgobject-2.0.so.0,libglib-2.0.so.0", "g_time_val_from_iso8601", [
+            {
+                type: { type: "string" },
+                value: isoDate,
+            },
+            {
+                type: { type: "struct", borrowed: true, innerType: "TimeVal" },
+                value: time_?.id ?? time_,
+            },
+        ], { type: "boolean" });
+    }
+    /**
+     * Adds the given number of microseconds to `time_`. `microseconds` can
+     * also be negative to decrease the value of `time_`.
+     * @param microseconds - number of microseconds to add to `time`
+     */
+    add(microseconds) {
+        call("libgobject-2.0.so.0,libglib-2.0.so.0", "g_time_val_add", [
+            {
+                type: {
+                    type: "boxed",
+                    borrowed: true,
+                    innerType: "TimeVal",
+                    lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+                },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 64, unsigned: false },
+                value: microseconds,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Converts `time_` into an RFC 3339 encoded string, relative to the
+     * Coordinated Universal Time (UTC). This is one of the many formats
+     * allowed by ISO 8601.
+     *
+     * ISO 8601 allows a large number of date/time formats, with or without
+     * punctuation and optional elements. The format returned by this function
+     * is a complete date and time, with optional punctuation included, the
+     * UTC time zone represented as "Z", and the `tv_usec` part included if
+     * and only if it is nonzero, i.e. either
+     * "YYYY-MM-DDTHH:MM:SSZ" or "YYYY-MM-DDTHH:MM:SS.fffffZ".
+     *
+     * This corresponds to the Internet date/time format defined by
+     * [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt),
+     * and to either of the two most-precise formats defined by
+     * the W3C Note
+     * [Date and Time Formats](http://www.w3.org/TR/NOTE-datetime-19980827).
+     * Both of these documents are profiles of ISO 8601.
+     *
+     * Use g_date_time_format() or g_strdup_printf() if a different
+     * variation of ISO 8601 format is required.
+     *
+     * If `time_` represents a date which is too large to fit into a `struct tm`,
+     * %NULL will be returned. This is platform dependent. Note also that since
+     * `GTimeVal` stores the number of seconds as a `glong`, on 32-bit systems it
+     * is subject to the year 2038 problem. Accordingly, since GLib 2.62, this
+     * function has been deprecated. Equivalent functionality is available using:
+     * |[
+     * GDateTime *dt = g_date_time_new_from_unix_utc (time_val);
+     * iso8601_string = g_date_time_format_iso8601 (dt);
+     * g_date_time_unref (dt);
+     * ]|
+     *
+     * The return value of g_time_val_to_iso8601() has been nullable since GLib
+     * 2.54; before then, GLib would crash under the same conditions.
+     */
+    toIso8601() {
+        return call("libgobject-2.0.so.0,libglib-2.0.so.0", "g_time_val_to_iso8601", [
+            {
+                type: {
+                    type: "boxed",
+                    borrowed: true,
+                    innerType: "TimeVal",
+                    lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+                },
+                value: this.id,
+            },
+        ], { type: "string" });
+    }
+    /** seconds */
+    get tvSec() {
+        return read(this.id, { type: "int", size: 64, unsigned: false }, 0);
+    }
+    set tvSec(value) {
+        write(this.id, { type: "int", size: 64, unsigned: false }, 0, value);
+    }
+    /** microseconds */
+    get tvUsec() {
+        return read(this.id, { type: "int", size: 64, unsigned: false }, 8);
+    }
+    set tvUsec(value) {
+        write(this.id, { type: "int", size: 64, unsigned: false }, 8, value);
+    }
+}

package/dist/generated/glib/time-zone.js

@@ -113,8 +113,14 @@ export class TimeZone extends NativeObject {
                 value: identifier,
                 optional: true,
             },
-        ], { type: "boxed", borrowed: true, innerType: "TimeZone" });
-        return getNativeObject(ptr);
+        ], {
+            type: "boxed",
+            borrowed: true,
+            innerType: "GTimeZone",
+            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+            getTypeFn: "g_time_zone_get_type",
+        });
+        return getNativeObject(ptr, TimeZone);
     }
     /**
      * Creates a #GTimeZone corresponding to local time.  The local time
@@ -128,8 +134,14 @@ export class TimeZone extends NativeObject {
      * when you are done with it.
      */
     static zoneNewLocal() {
-        const ptr = call("libgobject-2.0.so.0,libglib-2.0.so.0", "g_time_zone_new_local", [], { type: "boxed", borrowed: true, innerType: "TimeZone" });
-        return getNativeObject(ptr);
+        const ptr = call("libgobject-2.0.so.0,libglib-2.0.so.0", "g_time_zone_new_local", [], {
+            type: "boxed",
+            borrowed: true,
+            innerType: "GTimeZone",
+            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+            getTypeFn: "g_time_zone_get_type",
+        });
+        return getNativeObject(ptr, TimeZone);
     }
     /**
      * Creates a #GTimeZone corresponding to the given constant offset from UTC,
@@ -150,8 +162,14 @@ export class TimeZone extends NativeObject {
                 type: { type: "int", size: 32, unsigned: false },
                 value: seconds,
             },
-        ], { type: "boxed", borrowed: true, innerType: "TimeZone" });
-        return getNativeObject(ptr);
+        ], {
+            type: "boxed",
+            borrowed: true,
+            innerType: "GTimeZone",
+            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+            getTypeFn: "g_time_zone_get_type",
+        });
+        return getNativeObject(ptr, TimeZone);
     }
     /**
      * Creates a #GTimeZone corresponding to UTC.
@@ -163,8 +181,14 @@ export class TimeZone extends NativeObject {
      * when you are done with it.
      */
     static zoneNewUtc() {
-        const ptr = call("libgobject-2.0.so.0,libglib-2.0.so.0", "g_time_zone_new_utc", [], { type: "boxed", borrowed: true, innerType: "TimeZone" });
-        return getNativeObject(ptr);
+        const ptr = call("libgobject-2.0.so.0,libglib-2.0.so.0", "g_time_zone_new_utc", [], {
+            type: "boxed",
+            borrowed: true,
+            innerType: "GTimeZone",
+            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+            getTypeFn: "g_time_zone_get_type",
+        });
+        return getNativeObject(ptr, TimeZone);
     }
     createPtr(_args) {
         const [identifier] = _args;

package/dist/generated/glib/tuples.d.ts

@@ -0,0 +1,34 @@
+import { NativeObject } from "../../native/base.js";
+export interface TuplesInit {
+    len?: number;
+}
+/**
+ * The #GTuples struct is used to return records (or tuples) from the
+ * #GRelation by g_relation_select(). It only contains one public
+ * member - the number of records that matched. To access the matched
+ * records, you must use g_tuples_index().
+ */
+export declare class Tuples extends NativeObject {
+    static readonly objectType: "struct";
+    constructor(init?: TuplesInit);
+    protected createPtr(init: TuplesInit): unknown;
+    static fromPtr(ptr: unknown): Tuples;
+    /**
+     * Frees the records which were returned by g_relation_select(). This
+     * should always be called after g_relation_select() when you are
+     * finished with the records. The records are not removed from the
+     * #GRelation.
+     */
+    destroy(): void;
+    /**
+     * Gets a field from the records returned by g_relation_select(). It
+     * returns the given field of the record at the given index. The
+     * returned value should not be changed.
+     * @param index_ - the index of the record.
+     * @param field - the field to return.
+     */
+    index(index_: number, field: number): number | null;
+    /** the number of records that matched. */
+    get len(): number;
+    set len(value: number);
+}

package/dist/generated/glib/tuples.js

@@ -0,0 +1,81 @@
+import { alloc, read, write } from "@gtkx/native";
+import { call } from "../../batch.js";
+import { NativeObject } from "../../native/base.js";
+/**
+ * The #GTuples struct is used to return records (or tuples) from the
+ * #GRelation by g_relation_select(). It only contains one public
+ * member - the number of records that matched. To access the matched
+ * records, you must use g_tuples_index().
+ */
+export class Tuples extends NativeObject {
+    static objectType = "struct";
+    constructor(init = {}) {
+        super();
+        this.id = this.createPtr(init);
+    }
+    createPtr(init) {
+        const ptr = alloc(4);
+        if (init.len !== undefined)
+            write(ptr, { type: "int", size: 32, unsigned: true }, 0, init.len);
+        return ptr;
+    }
+    static fromPtr(ptr) {
+        const instance = Object.create(Tuples.prototype);
+        instance.id = ptr;
+        return instance;
+    }
+    /**
+     * Frees the records which were returned by g_relation_select(). This
+     * should always be called after g_relation_select() when you are
+     * finished with the records. The records are not removed from the
+     * #GRelation.
+     */
+    destroy() {
+        call("libgobject-2.0.so.0,libglib-2.0.so.0", "g_tuples_destroy", [
+            {
+                type: {
+                    type: "boxed",
+                    borrowed: true,
+                    innerType: "Tuples",
+                    lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+                },
+                value: this.id,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Gets a field from the records returned by g_relation_select(). It
+     * returns the given field of the record at the given index. The
+     * returned value should not be changed.
+     * @param index_ - the index of the record.
+     * @param field - the field to return.
+     */
+    index(index_, field) {
+        return call("libgobject-2.0.so.0,libglib-2.0.so.0", "g_tuples_index", [
+            {
+                type: {
+                    type: "boxed",
+                    borrowed: true,
+                    innerType: "Tuples",
+                    lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+                },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: false },
+                value: index_,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: false },
+                value: field,
+            },
+        ], { type: "int", size: 64, unsigned: true });
+    }
+    /** the number of records that matched. */
+    get len() {
+        return read(this.id, { type: "int", size: 32, unsigned: true }, 0);
+    }
+    set len(value) {
+        write(this.id, { type: "int", size: 32, unsigned: true }, 0, value);
+    }
+}

package/dist/generated/glib/uri.js

@@ -240,7 +240,7 @@ export class Uri extends NativeObject {
             lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
             getTypeFn: "g_uri_get_type",
         });
-        return getNativeObject(ptr);
+        return getNativeObject(ptr, Uri);
     }
     /**
      * Creates a new #GUri from the given components according to `flags`
@@ -317,7 +317,7 @@ export class Uri extends NativeObject {
             lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
             getTypeFn: "g_uri_get_type",
         });
-        return getNativeObject(ptr);
+        return getNativeObject(ptr, Uri);
     }
     static errorQuark() {
         return call("libgobject-2.0.so.0,libglib-2.0.so.0", "g_uri_error_quark", [], { type: "int", size: 32, unsigned: true });
@@ -618,7 +618,7 @@ export class Uri extends NativeObject {
         if (error.value !== null) {
             throw new NativeError(error.value);
         }
-        return getNativeObject(ptr);
+        return getNativeObject(ptr, Uri);
     }
     /**
      * Many URI schemes include one or more attribute/value pairs as part of the URI

package/dist/generated/glib/variant-builder.js

@@ -65,14 +65,8 @@ export class VariantBuilder extends NativeObject {
                 value: this.id,
             },
             {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GVariant",
-                    lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
-                    getTypeFn: "intern",
-                },
-                value: value?.id ?? value,
+                type: { type: "gvariant" },
+                value: value,
             },
         ], { type: "undefined" });
     }
@@ -127,13 +121,7 @@ export class VariantBuilder extends NativeObject {
                 },
                 value: this.id,
             },
-        ], {
-            type: "boxed",
-            borrowed: true,
-            innerType: "GVariant",
-            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
-            getTypeFn: "intern",
-        });
+        ], { type: "gvariant" });
         return getNativeObject(ptr, Variant);
     }
     /**

package/dist/generated/glib/variant-dict.js

@@ -106,14 +106,8 @@ export class VariantDict extends NativeObject {
         const [fromAsv] = _args;
         return call("libgobject-2.0.so.0,libglib-2.0.so.0", "g_variant_dict_new", [
             {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GVariant",
-                    lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
-                    getTypeFn: "intern",
-                },
-                value: fromAsv?.id ?? fromAsv,
+                type: { type: "gvariant" },
+                value: fromAsv,
                 optional: true,
             },
         ], { type: "boxed", borrowed: true, innerType: "GVariantDict" });
@@ -193,13 +187,7 @@ export class VariantDict extends NativeObject {
                 },
                 value: this.id,
             },
-        ], {
-            type: "boxed",
-            borrowed: true,
-            innerType: "GVariant",
-            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
-            getTypeFn: "intern",
-        });
+        ], { type: "gvariant" });
         return getNativeObject(ptr, Variant);
     }
     /**
@@ -225,14 +213,8 @@ export class VariantDict extends NativeObject {
                 value: key,
             },
             {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GVariant",
-                    lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
-                    getTypeFn: "intern",
-                },
-                value: value?.id ?? value,
+                type: { type: "gvariant" },
+                value: value,
             },
         ], { type: "undefined" });
     }
@@ -277,13 +259,7 @@ export class VariantDict extends NativeObject {
                 value: expectedType?.id ?? expectedType,
                 optional: true,
             },
-        ], {
-            type: "boxed",
-            borrowed: true,
-            innerType: "GVariant",
-            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
-            getTypeFn: "intern",
-        });
+        ], { type: "gvariant" });
         if (ptr === null)
             return null;
         return getNativeObject(ptr, Variant);