@gtkx/ffi 0.4.3 → 0.5.1

package/dist/generated/gio/simple-async-result.js

@@ -170,18 +170,25 @@ import * as GObject from "../gobject/index.js";
  */
 export class SimpleAsyncResult extends GObject.GObject {
     static glibTypeName = "GSimpleAsyncResult";
-    constructor(...args) {
-        super(...args);
-    }
     /**
-     * Creates a #GSimpleAsyncResult from an error condition.
+     * Creates a #GSimpleAsyncResult.
+     *
+     * The common convention is to create the #GSimpleAsyncResult in the
+     * function that starts the asynchronous operation and use that same
+     * function as the @source_tag.
+     *
+     * If your operation supports cancellation with #GCancellable (which it
+     * probably should) then you should provide the user's cancellable to
+     * g_simple_async_result_set_check_cancellable() immediately after
+     * this function returns.
      * @param sourceObject - a #GObject, or %NULL.
      * @param callback - a #GAsyncReadyCallback.
      * @param userData - user data passed to @callback.
-     * @param error - a #GError
+     * @param sourceTag - the asynchronous function.
      */
-    static asyncResultNewFromError(error, sourceObject, callback, userData) {
-        const ptr = call("libgio-2.0.so.0", "g_simple_async_result_new_from_error", [
+    constructor(sourceObject, callback, userData, sourceTag) {
+        super();
+        this.id = call("libgio-2.0.so.0", "g_simple_async_result_new", [
             {
                 type: { type: "gobject", borrowed: true },
                 value: sourceObject?.id ?? sourceObject,
@@ -198,20 +205,21 @@ export class SimpleAsyncResult extends GObject.GObject {
                 optional: true,
             },
             {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GError",
-                    lib: "libgio-2.0.so.0",
-                },
-                value: error?.id ?? error,
+                type: { type: "int", size: 64, unsigned: true },
+                value: sourceTag,
+                optional: true,
             },
         ], { type: "gobject", borrowed: false });
-        return getObject(ptr);
     }
-    createPtr(args) {
-        const [sourceObject, callback, userData, sourceTag] = args;
-        return call("libgio-2.0.so.0", "g_simple_async_result_new", [
+    /**
+     * Creates a #GSimpleAsyncResult from an error condition.
+     * @param sourceObject - a #GObject, or %NULL.
+     * @param callback - a #GAsyncReadyCallback.
+     * @param userData - user data passed to @callback.
+     * @param error - a #GError
+     */
+    static asyncResultNewFromError(error, sourceObject, callback, userData) {
+        const ptr = call("libgio-2.0.so.0", "g_simple_async_result_new_from_error", [
             {
                 type: { type: "gobject", borrowed: true },
                 value: sourceObject?.id ?? sourceObject,
@@ -228,11 +236,16 @@ export class SimpleAsyncResult extends GObject.GObject {
                 optional: true,
             },
             {
-                type: { type: "int", size: 64, unsigned: true },
-                value: sourceTag,
-                optional: true,
+                type: {
+                    type: "boxed",
+                    borrowed: true,
+                    innerType: "GError",
+                    lib: "libgio-2.0.so.0",
+                },
+                value: error?.id ?? error,
             },
         ], { type: "gobject", borrowed: false });
+        return getObject(ptr);
     }
     /**
      * Ensures that the data passed to the _finish function of an async

package/dist/generated/gio/simple-iostream.d.ts

@@ -22,9 +22,7 @@ export declare class SimpleIOStream extends IOStream {
      * @param inputStream - a #GInputStream.
      * @param outputStream - a #GOutputStream.
      */
-    constructor(inputStream: InputStream, outputStream: OutputStream);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(inputStream?: InputStream | null, outputStream?: OutputStream | null);
     connect(signal: "notify", handler: (self: SimpleIOStream, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }

package/dist/generated/gio/simple-iostream.js

@@ -14,21 +14,26 @@ import { IOStream } from "./iostream.js";
  */
 export class SimpleIOStream extends IOStream {
     static glibTypeName = "GSimpleIOStream";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [inputStream, outputStream] = args;
-        return call("libgio-2.0.so.0", "g_simple_io_stream_new", [
-            {
-                type: { type: "gobject", borrowed: true },
-                value: inputStream?.id ?? inputStream,
-            },
-            {
-                type: { type: "gobject", borrowed: true },
-                value: outputStream?.id ?? outputStream,
-            },
-        ], { type: "gobject", borrowed: false });
+    /**
+     * Creates a new #GSimpleIOStream wrapping `input_stream` and @output_stream.
+     * See also #GIOStream.
+     * @param inputStream - a #GInputStream.
+     * @param outputStream - a #GOutputStream.
+     */
+    constructor(inputStream, outputStream) {
+        super();
+        if (inputStream !== undefined) {
+            this.id = call("libgio-2.0.so.0", "g_simple_io_stream_new", [
+                {
+                    type: { type: "gobject", borrowed: true },
+                    value: inputStream?.id ?? inputStream,
+                },
+                {
+                    type: { type: "gobject", borrowed: true },
+                    value: outputStream?.id ?? outputStream,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     connect(signal, handler, after = false) {
         const selfType = { type: "gobject", borrowed: true };

package/dist/generated/gio/simple-permission.d.ts

@@ -15,9 +15,7 @@ export declare class SimplePermission extends Permission {
      * either always or never allowed.
      * @param allowed - %TRUE if the action is allowed
      */
-    constructor(allowed: boolean);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(allowed?: boolean | null);
     connect(signal: "notify", handler: (self: SimplePermission, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }

package/dist/generated/gio/simple-permission.js

@@ -10,17 +10,21 @@ import { Permission } from "./permission.js";
  */
 export class SimplePermission extends Permission {
     static glibTypeName = "GSimplePermission";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [allowed] = args;
-        return call("libgio-2.0.so.0", "g_simple_permission_new", [
-            {
-                type: { type: "boolean" },
-                value: allowed,
-            },
-        ], { type: "gobject", borrowed: false });
+    /**
+     * Creates a new #GPermission instance that represents an action that is
+     * either always or never allowed.
+     * @param allowed - %TRUE if the action is allowed
+     */
+    constructor(allowed) {
+        super();
+        if (allowed !== undefined) {
+            this.id = call("libgio-2.0.so.0", "g_simple_permission_new", [
+                {
+                    type: { type: "boolean" },
+                    value: allowed,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     connect(signal, handler, after = false) {
         const selfType = { type: "gobject", borrowed: true };

package/dist/generated/gio/simple-proxy-resolver.d.ts

@@ -14,8 +14,7 @@ import * as GObject from "../gobject/index.js";
  */
 export declare class SimpleProxyResolver extends GObject.GObject {
     static readonly glibTypeName: string;
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     /**
      * Creates a new #GSimpleProxyResolver. See
      * #GSimpleProxyResolver:default-proxy and

package/dist/generated/gio/simple-proxy-resolver.js

@@ -12,14 +12,12 @@ import * as GObject from "../gobject/index.js";
  */
 export class SimpleProxyResolver extends GObject.GObject {
     static glibTypeName = "GSimpleProxyResolver";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        const gtype = call("libgio-2.0.so.0", "gsimple_proxy_resolver_get_type", [], { type: "int", size: 64, unsigned: true });
-        return call("libgobject-2.0.so.0", "g_object_new", [
+    constructor() {
+        super();
+        const gtype = call("libgio-2.0.so.0", "g_simple_proxy_resolver_get_type", [], { type: "int", size: 64, unsigned: true });
+        this.id = call("libgobject-2.0.so.0", "g_object_new", [
             { type: { type: "int", size: 64, unsigned: true }, value: gtype },
-            { type: { type: "gobject" }, value: null },
+            { type: { type: "null" }, value: null },
         ], { type: "gobject", borrowed: true });
     }
     /**

package/dist/generated/gio/socket-address-enumerator.d.ts

@@ -21,8 +21,7 @@ import * as GObject from "../gobject/index.js";
  */
 export declare class SocketAddressEnumerator extends GObject.GObject {
     static readonly glibTypeName: string;
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     /**
      * Retrieves the next #GSocketAddress from @enumerator. Note that this
      * may block for some amount of time. (Eg, a #GNetworkAddress may need

package/dist/generated/gio/socket-address-enumerator.js

@@ -19,15 +19,8 @@ import * as GObject from "../gobject/index.js";
  */
 export class SocketAddressEnumerator extends GObject.GObject {
     static glibTypeName = "GSocketAddressEnumerator";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        const gtype = call("libgio-2.0.so.0", "gsocket_address_enumerator_get_type", [], { type: "int", size: 64, unsigned: true });
-        return call("libgobject-2.0.so.0", "g_object_new", [
-            { type: { type: "int", size: 64, unsigned: true }, value: gtype },
-            { type: { type: "gobject" }, value: null },
-        ], { type: "gobject", borrowed: true });
+    constructor() {
+        super();
     }
     /**
      * Retrieves the next #GSocketAddress from @enumerator. Note that this

package/dist/generated/gio/socket-address.d.ts

@@ -15,9 +15,7 @@ export declare class SocketAddress extends GObject.GObject {
      * @param native - a pointer to a struct sockaddr
      * @param len - the size of the memory location pointed to by @native
      */
-    constructor(native: number, len: number);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(native?: number | null, len?: number | null);
     /**
      * Gets the socket family type of @address.
      */

package/dist/generated/gio/socket-address.js

@@ -8,21 +8,26 @@ import * as GObject from "../gobject/index.js";
  */
 export class SocketAddress extends GObject.GObject {
     static glibTypeName = "GSocketAddress";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [native, len] = args;
-        return call("libgio-2.0.so.0", "g_socket_address_new_from_native", [
-            {
-                type: { type: "int", size: 64, unsigned: true },
-                value: native,
-            },
-            {
-                type: { type: "int", size: 64, unsigned: true },
-                value: len,
-            },
-        ], { type: "gobject", borrowed: false });
+    /**
+     * Creates a #GSocketAddress subclass corresponding to the native
+     * struct sockaddr @native.
+     * @param native - a pointer to a struct sockaddr
+     * @param len - the size of the memory location pointed to by @native
+     */
+    constructor(native, len) {
+        super();
+        if (native !== undefined) {
+            this.id = call("libgio-2.0.so.0", "g_socket_address_new_from_native", [
+                {
+                    type: { type: "int", size: 64, unsigned: true },
+                    value: native,
+                },
+                {
+                    type: { type: "int", size: 64, unsigned: true },
+                    value: len,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Gets the socket family type of @address.

package/dist/generated/gio/socket-client.d.ts

@@ -12,8 +12,7 @@ export declare class SocketClient extends GObject.GObject {
     /**
      * Creates a new #GSocketClient with the default options.
      */
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     /**
      * Enable proxy protocols to be handled by the application. When the
      * indicated proxy protocol is returned by the #GProxyResolver,

package/dist/generated/gio/socket-client.js

@@ -31,11 +31,9 @@ export class SocketClient extends GObject.GObject {
     /**
      * Creates a new #GSocketClient with the default options.
      */
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        return call("libgio-2.0.so.0", "g_socket_client_new", [], {
+    constructor() {
+        super();
+        this.id = call("libgio-2.0.so.0", "g_socket_client_new", [], {
             type: "gobject",
             borrowed: false,
         });

package/dist/generated/gio/socket-connection.d.ts

@@ -25,8 +25,7 @@ import { IOStream } from "./iostream.js";
  */
 export declare class SocketConnection extends IOStream {
     static readonly glibTypeName: string;
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     /**
      * Looks up the #GType to be used when creating socket connections on
      * sockets with the specified @family, `type` and @protocol_id.

package/dist/generated/gio/socket-connection.js

@@ -20,18 +20,16 @@ import { IOStream } from "./iostream.js";
  */
 export class SocketConnection extends IOStream {
     static glibTypeName = "GSocketConnection";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        const gtype = call("libgio-2.0.so.0", "gsocket_connection_get_type", [], {
+    constructor() {
+        super();
+        const gtype = call("libgio-2.0.so.0", "g_socket_connection_get_type", [], {
             type: "int",
             size: 64,
             unsigned: true,
         });
-        return call("libgobject-2.0.so.0", "g_object_new", [
+        this.id = call("libgobject-2.0.so.0", "g_object_new", [
             { type: { type: "int", size: 64, unsigned: true }, value: gtype },
-            { type: { type: "gobject" }, value: null },
+            { type: { type: "null" }, value: null },
         ], { type: "gobject", borrowed: true });
     }
     /**

package/dist/generated/gio/socket-control-message.d.ts

@@ -23,8 +23,7 @@ import * as GObject from "../gobject/index.js";
  */
 export declare class SocketControlMessage extends GObject.GObject {
     static readonly glibTypeName: string;
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     /**
      * Tries to deserialize a socket control message of a given
      * `level` and @type. This will ask all known (to GType) subclasses

package/dist/generated/gio/socket-control-message.js

@@ -24,15 +24,8 @@ import * as GObject from "../gobject/index.js";
  */
 export class SocketControlMessage extends GObject.GObject {
     static glibTypeName = "GSocketControlMessage";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        const gtype = call("libgio-2.0.so.0", "gsocket_control_message_get_type", [], { type: "int", size: 64, unsigned: true });
-        return call("libgobject-2.0.so.0", "g_object_new", [
-            { type: { type: "int", size: 64, unsigned: true }, value: gtype },
-            { type: { type: "gobject" }, value: null },
-        ], { type: "gobject", borrowed: true });
+    constructor() {
+        super();
     }
     /**
      * Tries to deserialize a socket control message of a given

package/dist/generated/gio/socket-listener.d.ts

@@ -13,8 +13,7 @@ export declare class SocketListener extends GObject.GObject {
      * New listeners can be added with e.g. g_socket_listener_add_address()
      * or g_socket_listener_add_inet_port().
      */
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     /**
      * Blocks waiting for a client to connect to any of the sockets added
      * to the listener. Returns a #GSocketConnection for the socket that was

package/dist/generated/gio/socket-listener.js

@@ -34,11 +34,9 @@ export class SocketListener extends GObject.GObject {
      * New listeners can be added with e.g. g_socket_listener_add_address()
      * or g_socket_listener_add_inet_port().
      */
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        return call("libgio-2.0.so.0", "g_socket_listener_new", [], {
+    constructor() {
+        super();
+        this.id = call("libgio-2.0.so.0", "g_socket_listener_new", [], {
             type: "gobject",
             borrowed: false,
         });

package/dist/generated/gio/socket-service.d.ts

@@ -14,8 +14,7 @@ export declare class SocketService extends SocketListener {
      * g_socket_service_start(), unless g_socket_service_stop() has been
      * called before.
      */
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     /**
      * Check whether the service is active or not. An active
      * service will accept new clients that connect, while

package/dist/generated/gio/socket-service.js

@@ -64,11 +64,9 @@ export class SocketService extends SocketListener {
      * g_socket_service_start(), unless g_socket_service_stop() has been
      * called before.
      */
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        return call("libgio-2.0.so.0", "g_socket_service_new", [], {
+    constructor() {
+        super();
+        this.id = call("libgio-2.0.so.0", "g_socket_service_new", [], {
             type: "gobject",
             borrowed: false,
         });

package/dist/generated/gio/socket.d.ts

@@ -100,8 +100,7 @@ export declare class Socket extends GObject.GObject {
      * @param type - the socket type to use.
      * @param protocol - the id of the protocol to use, or 0 for default.
      */
-    constructor(family: SocketFamily, type: SocketType, protocol: SocketProtocol);
-    constructor(...args: unknown[]);
+    constructor(family?: SocketFamily | null, type?: SocketType | null, protocol?: SocketProtocol | null);
     /**
      * Creates a new #GSocket from a native file descriptor
      * or winsock SOCKET handle.
@@ -119,7 +118,6 @@ export declare class Socket extends GObject.GObject {
      * @param fd - a native socket file descriptor.
      */
     static newFromFd(fd: number): Socket;
-    protected createPtr(args: unknown[]): unknown;
     /**
      * Accept incoming connections on a connection-based socket. This removes
      * the first outstanding connection request from the listening socket and

package/dist/generated/gio/socket.js

@@ -74,8 +74,42 @@ import * as GObject from "../gobject/index.js";
  */
 export class Socket extends GObject.GObject {
     static glibTypeName = "GSocket";
-    constructor(...args) {
-        super(...args);
+    /**
+     * Creates a new #GSocket with the defined family, type and protocol.
+     * If `protocol` is 0 (%G_SOCKET_PROTOCOL_DEFAULT) the default protocol type
+     * for the family and type is used.
+     *
+     * The `protocol` is a family and type specific int that specifies what
+     * kind of protocol to use. #GSocketProtocol lists several common ones.
+     * Many families only support one protocol, and use 0 for this, others
+     * support several and using 0 means to use the default protocol for
+     * the family and type.
+     *
+     * The protocol id is passed directly to the operating
+     * system, so you can use protocols not listed in #GSocketProtocol if you
+     * know the protocol number used for it.
+     * @param family - the socket family to use, e.g. %G_SOCKET_FAMILY_IPV4.
+     * @param type - the socket type to use.
+     * @param protocol - the id of the protocol to use, or 0 for default.
+     */
+    constructor(family, type, protocol) {
+        super();
+        if (family !== undefined) {
+            this.id = call("libgio-2.0.so.0", "g_socket_new", [
+                {
+                    type: { type: "int", size: 32, unsigned: false },
+                    value: family,
+                },
+                {
+                    type: { type: "int", size: 32, unsigned: false },
+                    value: type,
+                },
+                {
+                    type: { type: "int", size: 32, unsigned: false },
+                    value: protocol,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Creates a new #GSocket from a native file descriptor
@@ -102,23 +136,6 @@ export class Socket extends GObject.GObject {
         ], { type: "gobject", borrowed: false });
         return getObject(ptr);
     }
-    createPtr(args) {
-        const [family, type, protocol] = args;
-        return call("libgio-2.0.so.0", "g_socket_new", [
-            {
-                type: { type: "int", size: 32, unsigned: false },
-                value: family,
-            },
-            {
-                type: { type: "int", size: 32, unsigned: false },
-                value: type,
-            },
-            {
-                type: { type: "int", size: 32, unsigned: false },
-                value: protocol,
-            },
-        ], { type: "gobject", borrowed: false });
-    }
     /**
      * Accept incoming connections on a connection-based socket. This removes
      * the first outstanding connection request from the listening socket and

package/dist/generated/gio/subprocess-launcher.d.ts

@@ -21,9 +21,7 @@ export declare class SubprocessLauncher extends GObject.GObject {
      * and will be used as the environment that the process is launched in.
      * @param flags - #GSubprocessFlags
      */
-    constructor(flags: SubprocessFlags);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(flags?: SubprocessFlags | null);
     /**
      * Closes all the file descriptors previously passed to the object with
      * g_subprocess_launcher_take_fd(), g_subprocess_launcher_take_stderr_fd(), etc.

package/dist/generated/gio/subprocess-launcher.js

@@ -12,17 +12,24 @@ import * as GObject from "../gobject/index.js";
  */
 export class SubprocessLauncher extends GObject.GObject {
     static glibTypeName = "GSubprocessLauncher";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [flags] = args;
-        return call("libgio-2.0.so.0", "g_subprocess_launcher_new", [
-            {
-                type: { type: "int", size: 32, unsigned: false },
-                value: flags,
-            },
-        ], { type: "gobject", borrowed: false });
+    /**
+     * Creates a new #GSubprocessLauncher.
+     *
+     * The launcher is created with the default options.  A copy of the
+     * environment of the calling process is made at the time of this call
+     * and will be used as the environment that the process is launched in.
+     * @param flags - #GSubprocessFlags
+     */
+    constructor(flags) {
+        super();
+        if (flags !== undefined) {
+            this.id = call("libgio-2.0.so.0", "g_subprocess_launcher_new", [
+                {
+                    type: { type: "int", size: 32, unsigned: false },
+                    value: flags,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Closes all the file descriptors previously passed to the object with

package/dist/generated/gio/subprocess.d.ts

@@ -80,9 +80,7 @@ export declare class Subprocess extends GObject.GObject {
      * @param argv - commandline arguments for the subprocess
      * @param flags - flags that define the behaviour of the subprocess
      */
-    constructor(argv: string[], flags: SubprocessFlags);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(argv?: string[] | null, flags?: SubprocessFlags | null);
     /**
      * Communicate with the subprocess until it terminates, and all input
      * and output has been completed.

package/dist/generated/gio/subprocess.js

@@ -67,21 +67,27 @@ import * as GObject from "../gobject/index.js";
  */
 export class Subprocess extends GObject.GObject {
     static glibTypeName = "GSubprocess";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [argv, flags] = args;
-        return call("libgio-2.0.so.0", "g_subprocess_newv", [
-            {
-                type: { type: "array", itemType: { type: "string" } },
-                value: argv,
-            },
-            {
-                type: { type: "int", size: 32, unsigned: false },
-                value: flags,
-            },
-        ], { type: "gobject", borrowed: false });
+    /**
+     * Create a new process with the given flags and argument list.
+     *
+     * The argument list is expected to be %NULL-terminated.
+     * @param argv - commandline arguments for the subprocess
+     * @param flags - flags that define the behaviour of the subprocess
+     */
+    constructor(argv, flags) {
+        super();
+        if (argv !== undefined) {
+            this.id = call("libgio-2.0.so.0", "g_subprocess_newv", [
+                {
+                    type: { type: "array", itemType: { type: "string" } },
+                    value: argv,
+                },
+                {
+                    type: { type: "int", size: 32, unsigned: false },
+                    value: flags,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Communicate with the subprocess until it terminates, and all input