@gtkx/ffi 0.4.3 → 0.5.1

package/dist/generated/gtk/any-filter.d.ts

@@ -12,8 +12,7 @@ export declare class AnyFilter extends MultiFilter {
      * matches the item. In particular, this means that if no filter
      * has been added to it, the filter matches no item.
      */
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     connect(signal: "changed", handler: (self: AnyFilter, change: FilterChange) => void, after?: boolean): number;
     connect(signal: "notify", handler: (self: AnyFilter, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;

package/dist/generated/gtk/any-filter.js

@@ -22,11 +22,9 @@ export class AnyFilter extends MultiFilter {
      * matches the item. In particular, this means that if no filter
      * has been added to it, the filter matches no item.
      */
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        return call("libgtk-4.so.1", "gtk_any_filter_new", [], {
+    constructor() {
+        super();
+        this.id = call("libgtk-4.so.1", "gtk_any_filter_new", [], {
             type: "gobject",
             borrowed: false,
         });

package/dist/generated/gtk/app-chooser-button.d.ts

@@ -10,9 +10,7 @@ export declare class AppChooserButton extends Widget {
      * that can handle content of the given type.
      * @param contentType - the content type to show applications for
      */
-    constructor(contentType: string);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(contentType?: string | null);
     /**
      * Appends a custom item to the list of applications that is shown
      * in the popup.

package/dist/generated/gtk/app-chooser-button.js

@@ -76,17 +76,21 @@ const SIGNAL_META = {
 };
 export class AppChooserButton extends Widget {
     static glibTypeName = "GtkAppChooserButton";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [contentType] = args;
-        return call("libgtk-4.so.1", "gtk_app_chooser_button_new", [
-            {
-                type: { type: "string" },
-                value: contentType,
-            },
-        ], { type: "gobject", borrowed: true });
+    /**
+     * Creates a new `GtkAppChooserButton` for applications
+     * that can handle content of the given type.
+     * @param contentType - the content type to show applications for
+     */
+    constructor(contentType) {
+        super();
+        if (contentType !== undefined) {
+            this.id = call("libgtk-4.so.1", "gtk_app_chooser_button_new", [
+                {
+                    type: { type: "string" },
+                    value: contentType,
+                },
+            ], { type: "gobject", borrowed: true });
+        }
     }
     /**
      * Appends a custom item to the list of applications that is shown

package/dist/generated/gtk/app-chooser-dialog.d.ts

@@ -15,8 +15,7 @@ export declare class AppChooserDialog extends Dialog {
      * @param flags - flags for this dialog
      * @param file - a `GFile`
      */
-    constructor(flags: DialogFlags, file: Gio.File, parent?: Window | null);
-    constructor(...args: unknown[]);
+    constructor(parent?: Window | null, flags?: DialogFlags | null, file?: Gio.File | null);
     /**
      * Creates a new `GtkAppChooserDialog` for the provided content type.
      *
@@ -26,7 +25,6 @@ export declare class AppChooserDialog extends Dialog {
      * @param contentType - a content type string
      */
     static chooserDialogNewForContentType(flags: DialogFlags, contentType: string, parent?: Window | null): AppChooserDialog;
-    protected createPtr(args: unknown[]): unknown;
     /**
      * Returns the text to display at the top of the dialog.
      */

package/dist/generated/gtk/app-chooser-dialog.js

@@ -73,19 +73,17 @@ const SIGNAL_META = {
 };
 export class AppChooserDialog extends Dialog {
     static glibTypeName = "GtkAppChooserDialog";
-    constructor(...args) {
-        super(...args);
-    }
     /**
-     * Creates a new `GtkAppChooserDialog` for the provided content type.
+     * Creates a new `GtkAppChooserDialog` for the provided `GFile`.
      *
-     * The dialog will show applications that can open the content type.
+     * The dialog will show applications that can open the file.
      * @param parent - a `GtkWindow`
      * @param flags - flags for this dialog
-     * @param contentType - a content type string
+     * @param file - a `GFile`
      */
-    static chooserDialogNewForContentType(flags, contentType, parent) {
-        const ptr = call("libgtk-4.so.1", "gtk_app_chooser_dialog_new_for_content_type", [
+    constructor(parent, flags, file) {
+        super();
+        this.id = call("libgtk-4.so.1", "gtk_app_chooser_dialog_new", [
             {
                 type: { type: "gobject", borrowed: true },
                 value: parent?.id ?? parent,
@@ -96,15 +94,21 @@ export class AppChooserDialog extends Dialog {
                 value: flags,
             },
             {
-                type: { type: "string" },
-                value: contentType,
+                type: { type: "gobject", borrowed: true },
+                value: file?.id ?? file,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr);
     }
-    createPtr(args) {
-        const [parent, flags, file] = args;
-        return call("libgtk-4.so.1", "gtk_app_chooser_dialog_new", [
+    /**
+     * Creates a new `GtkAppChooserDialog` for the provided content type.
+     *
+     * The dialog will show applications that can open the content type.
+     * @param parent - a `GtkWindow`
+     * @param flags - flags for this dialog
+     * @param contentType - a content type string
+     */
+    static chooserDialogNewForContentType(flags, contentType, parent) {
+        const ptr = call("libgtk-4.so.1", "gtk_app_chooser_dialog_new_for_content_type", [
             {
                 type: { type: "gobject", borrowed: true },
                 value: parent?.id ?? parent,
@@ -115,10 +119,11 @@ export class AppChooserDialog extends Dialog {
                 value: flags,
             },
             {
-                type: { type: "gobject", borrowed: true },
-                value: file?.id ?? file,
+                type: { type: "string" },
+                value: contentType,
             },
         ], { type: "gobject", borrowed: true });
+        return getObject(ptr);
     }
     /**
      * Returns the text to display at the top of the dialog.

package/dist/generated/gtk/app-chooser-widget.d.ts

@@ -10,9 +10,7 @@ export declare class AppChooserWidget extends Widget {
      * that can handle content of the given type.
      * @param contentType - the content type to show applications for
      */
-    constructor(contentType: string);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(contentType?: string | null);
     /**
      * Returns the text that is shown if there are not applications
      * that can handle the content type.

package/dist/generated/gtk/app-chooser-widget.js

@@ -79,17 +79,21 @@ const SIGNAL_META = {
 };
 export class AppChooserWidget extends Widget {
     static glibTypeName = "GtkAppChooserWidget";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [contentType] = args;
-        return call("libgtk-4.so.1", "gtk_app_chooser_widget_new", [
-            {
-                type: { type: "string" },
-                value: contentType,
-            },
-        ], { type: "gobject", borrowed: true });
+    /**
+     * Creates a new `GtkAppChooserWidget` for applications
+     * that can handle content of the given type.
+     * @param contentType - the content type to show applications for
+     */
+    constructor(contentType) {
+        super();
+        if (contentType !== undefined) {
+            this.id = call("libgtk-4.so.1", "gtk_app_chooser_widget_new", [
+                {
+                    type: { type: "string" },
+                    value: contentType,
+                },
+            ], { type: "gobject", borrowed: true });
+        }
     }
     /**
      * Returns the text that is shown if there are not applications

package/dist/generated/gtk/application-window.d.ts

@@ -10,9 +10,7 @@ export declare class ApplicationWindow extends Window {
      * Creates a new `GtkApplicationWindow`.
      * @param application - an application
      */
-    constructor(application: Application);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(application?: Application | null);
     /**
      * Gets the `GtkShortcutsWindow` that is associated with @window.
      *

package/dist/generated/gtk/application-window.js

@@ -120,17 +120,20 @@ const SIGNAL_META = {
 };
 export class ApplicationWindow extends Window {
     static glibTypeName = "GtkApplicationWindow";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [application] = args;
-        return call("libgtk-4.so.1", "gtk_application_window_new", [
-            {
-                type: { type: "gobject", borrowed: true },
-                value: application?.id ?? application,
-            },
-        ], { type: "gobject", borrowed: true });
+    /**
+     * Creates a new `GtkApplicationWindow`.
+     * @param application - an application
+     */
+    constructor(application) {
+        super();
+        if (application !== undefined) {
+            this.id = call("libgtk-4.so.1", "gtk_application_window_new", [
+                {
+                    type: { type: "gobject", borrowed: true },
+                    value: application?.id ?? application,
+                },
+            ], { type: "gobject", borrowed: true });
+        }
     }
     /**
      * Gets the `GtkShortcutsWindow` that is associated with @window.

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

@@ -26,9 +26,7 @@ export declare class Application extends Gio.Application {
      * @param applicationId - The application ID
      * @param flags - the application flags
      */
-    constructor(flags: Gio.ApplicationFlags, applicationId?: string | null);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(applicationId?: string | null, flags?: Gio.ApplicationFlags | null);
     /**
      * Adds a window to the application.
      *

package/dist/generated/gtk/application.js

@@ -88,12 +88,31 @@ const SIGNAL_META = {
 };
 export class Application extends Gio.Application {
     static glibTypeName = "GtkApplication";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [applicationId, flags] = args;
-        return call("libgtk-4.so.1", "gtk_application_new", [
+    /**
+     * Creates a new application instance.
+     *
+     * When using `GtkApplication`, it is not necessary to call [func@Gtk.init]
+     * manually. It is called as soon as the application gets registered as
+     * the primary instance.
+     *
+     * Concretely, [func@Gtk.init] is called in the default handler for the
+     * `GApplication::startup` signal. Therefore, `GtkApplication` subclasses
+     * should always chain up in their [vfunc@GIO.Application.startup] handler
+     * before using any GTK API.
+     *
+     * Note that commandline arguments are not passed to [func@Gtk.init].
+     *
+     * If `application_id` is not `NULL`, then it must be valid. See
+     * [func@Gio.Application.id_is_valid].
+     *
+     * If no application ID is given then some features (most notably application
+     * uniqueness) will be disabled.
+     * @param applicationId - The application ID
+     * @param flags - the application flags
+     */
+    constructor(applicationId, flags) {
+        super();
+        this.id = call("libgtk-4.so.1", "gtk_application_new", [
             {
                 type: { type: "string" },
                 value: applicationId,

package/dist/generated/gtk/aspect-frame.d.ts

@@ -11,9 +11,7 @@ export declare class AspectFrame extends Widget {
      * @param ratio - The desired aspect ratio.
      * @param obeyChild - If %TRUE, `ratio` is ignored, and the aspect
      */
-    constructor(xalign: number, yalign: number, ratio: number, obeyChild: boolean);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(xalign?: number | null, yalign?: number | null, ratio?: number | null, obeyChild?: boolean | null);
     /**
      * Gets the child widget of @self.
      */

package/dist/generated/gtk/aspect-frame.js

@@ -57,29 +57,35 @@ const SIGNAL_META = {
 };
 export class AspectFrame extends Widget {
     static glibTypeName = "GtkAspectFrame";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [xalign, yalign, ratio, obeyChild] = args;
-        return call("libgtk-4.so.1", "gtk_aspect_frame_new", [
-            {
-                type: { type: "float", size: 32 },
-                value: xalign,
-            },
-            {
-                type: { type: "float", size: 32 },
-                value: yalign,
-            },
-            {
-                type: { type: "float", size: 32 },
-                value: ratio,
-            },
-            {
-                type: { type: "boolean" },
-                value: obeyChild,
-            },
-        ], { type: "gobject", borrowed: true });
+    /**
+     * Create a new `GtkAspectFrame`.
+     * @param xalign - Horizontal alignment of the child within the parent.
+     * @param yalign - Vertical alignment of the child within the parent.
+     * @param ratio - The desired aspect ratio.
+     * @param obeyChild - If %TRUE, `ratio` is ignored, and the aspect
+     */
+    constructor(xalign, yalign, ratio, obeyChild) {
+        super();
+        if (xalign !== undefined) {
+            this.id = call("libgtk-4.so.1", "gtk_aspect_frame_new", [
+                {
+                    type: { type: "float", size: 32 },
+                    value: xalign,
+                },
+                {
+                    type: { type: "float", size: 32 },
+                    value: yalign,
+                },
+                {
+                    type: { type: "float", size: 32 },
+                    value: ratio,
+                },
+                {
+                    type: { type: "boolean" },
+                    value: obeyChild,
+                },
+            ], { type: "gobject", borrowed: true });
+        }
     }
     /**
      * Gets the child widget of @self.

package/dist/generated/gtk/assistant-page.d.ts

@@ -3,8 +3,7 @@ import * as GObject from "../gobject/index.js";
 /** `GtkAssistantPage` is an auxiliary object used by `GtkAssistant`. */
 export declare class AssistantPage extends GObject.GObject {
     static readonly glibTypeName: string;
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     /**
      * Returns the child to which `page` belongs.
      */

package/dist/generated/gtk/assistant-page.js

@@ -3,18 +3,16 @@ import * as GObject from "../gobject/index.js";
 /** `GtkAssistantPage` is an auxiliary object used by `GtkAssistant`. */
 export class AssistantPage extends GObject.GObject {
     static glibTypeName = "GtkAssistantPage";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
+    constructor() {
+        super();
         const gtype = call("libgtk-4.so.1", "gtk_assistant_page_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/gtk/assistant.d.ts

@@ -10,8 +10,7 @@ export declare class Assistant extends Window {
     /**
      * Creates a new `GtkAssistant`.
      */
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     /**
      * Adds a widget to the action area of a `GtkAssistant`.
      * @param child - a `GtkWidget`

package/dist/generated/gtk/assistant.js

@@ -101,11 +101,9 @@ export class Assistant extends Window {
     /**
      * Creates a new `GtkAssistant`.
      */
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        return call("libgtk-4.so.1", "gtk_assistant_new", [], {
+    constructor() {
+        super();
+        this.id = call("libgtk-4.so.1", "gtk_assistant_new", [], {
             type: "gobject",
             borrowed: true,
         });

package/dist/generated/gtk/atcontext.d.ts

@@ -14,9 +14,7 @@ export declare class ATContext extends GObject.GObject {
      * @param accessible - the `GtkAccessible` implementation using the `GtkATContext`
      * @param display - the `GdkDisplay` used by the `GtkATContext`
      */
-    constructor(accessibleRole: AccessibleRole, accessible: Accessible, display: Gdk.Display);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(accessibleRole?: AccessibleRole | null, accessible?: Accessible | null, display?: Gdk.Display | null);
     /**
      * Retrieves the `GtkAccessible` using this context.
      */

package/dist/generated/gtk/atcontext.js

@@ -12,25 +12,34 @@ const SIGNAL_META = {
 };
 export class ATContext extends GObject.GObject {
     static glibTypeName = "GtkATContext";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [accessibleRole, accessible, display] = args;
-        return call("libgtk-4.so.1", "gtk_at_context_create", [
-            {
-                type: { type: "int", size: 32, unsigned: false },
-                value: accessibleRole,
-            },
-            {
-                type: { type: "gobject", borrowed: true },
-                value: accessible?.id ?? accessible,
-            },
-            {
-                type: { type: "gobject", borrowed: true },
-                value: display?.id ?? display,
-            },
-        ], { type: "gobject", borrowed: false });
+    /**
+     * Creates a new `GtkATContext` instance for the given accessible role,
+     * accessible instance, and display connection.
+     *
+     * The `GtkATContext` implementation being instantiated will depend on the
+     * platform.
+     * @param accessibleRole - the accessible role used by the `GtkATContext`
+     * @param accessible - the `GtkAccessible` implementation using the `GtkATContext`
+     * @param display - the `GdkDisplay` used by the `GtkATContext`
+     */
+    constructor(accessibleRole, accessible, display) {
+        super();
+        if (accessibleRole !== undefined) {
+            this.id = call("libgtk-4.so.1", "gtk_at_context_create", [
+                {
+                    type: { type: "int", size: 32, unsigned: false },
+                    value: accessibleRole,
+                },
+                {
+                    type: { type: "gobject", borrowed: true },
+                    value: accessible?.id ?? accessible,
+                },
+                {
+                    type: { type: "gobject", borrowed: true },
+                    value: display?.id ?? display,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Retrieves the `GtkAccessible` using this context.

package/dist/generated/gtk/bin-layout.d.ts

@@ -13,8 +13,7 @@ export declare class BinLayout extends LayoutManager {
     /**
      * Creates a new `GtkBinLayout` instance.
      */
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     connect(signal: "notify", handler: (self: BinLayout, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }

package/dist/generated/gtk/bin-layout.js

@@ -13,11 +13,9 @@ export class BinLayout extends LayoutManager {
     /**
      * Creates a new `GtkBinLayout` instance.
      */
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        return call("libgtk-4.so.1", "gtk_bin_layout_new", [], {
+    constructor() {
+        super();
+        this.id = call("libgtk-4.so.1", "gtk_bin_layout_new", [], {
             type: "gobject",
             borrowed: false,
         });

package/dist/generated/gtk/bookmark-list.d.ts

@@ -17,8 +17,6 @@ export declare class BookmarkList extends GObject.GObject {
      * @param attributes - The attributes to query
      */
     constructor(filename?: string | null, attributes?: string | null);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
     /**
      * Gets the attributes queried on the children.
      */

package/dist/generated/gtk/bookmark-list.js

@@ -12,12 +12,14 @@ import * as GObject from "../gobject/index.js";
  */
 export class BookmarkList extends GObject.GObject {
     static glibTypeName = "GtkBookmarkList";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [filename, attributes] = args;
-        return call("libgtk-4.so.1", "gtk_bookmark_list_new", [
+    /**
+     * Creates a new `GtkBookmarkList` with the given @attributes.
+     * @param filename - The bookmark file to load
+     * @param attributes - The attributes to query
+     */
+    constructor(filename, attributes) {
+        super();
+        this.id = call("libgtk-4.so.1", "gtk_bookmark_list_new", [
             {
                 type: { type: "string" },
                 value: filename,

package/dist/generated/gtk/bool-filter.d.ts

@@ -9,8 +9,6 @@ export declare class BoolFilter extends Filter {
      * @param expression - the expression to evaluate
      */
     constructor(expression?: Expression | null);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
     /**
      * Gets the expression that the filter evaluates for
      * each item.

package/dist/generated/gtk/bool-filter.js

@@ -9,12 +9,13 @@ const SIGNAL_META = {
 };
 export class BoolFilter extends Filter {
     static glibTypeName = "GtkBoolFilter";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [expression] = args;
-        return call("libgtk-4.so.1", "gtk_bool_filter_new", [
+    /**
+     * Creates a new bool filter.
+     * @param expression - the expression to evaluate
+     */
+    constructor(expression) {
+        super();
+        this.id = call("libgtk-4.so.1", "gtk_bool_filter_new", [
             {
                 type: { type: "gobject" },
                 value: expression?.id ?? expression,

package/dist/generated/gtk/box-layout.d.ts

@@ -22,9 +22,7 @@ export declare class BoxLayout extends LayoutManager {
      * Creates a new `GtkBoxLayout`.
      * @param orientation - the orientation for the new layout
      */
-    constructor(orientation: Orientation);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(orientation?: Orientation | null);
     /**
      * Gets the value set by gtk_box_layout_set_baseline_child().
      */

package/dist/generated/gtk/box-layout.js

@@ -17,17 +17,20 @@ import { LayoutManager } from "./layout-manager.js";
  */
 export class BoxLayout extends LayoutManager {
     static glibTypeName = "GtkBoxLayout";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [orientation] = args;
-        return call("libgtk-4.so.1", "gtk_box_layout_new", [
-            {
-                type: { type: "int", size: 32, unsigned: false },
-                value: orientation,
-            },
-        ], { type: "gobject", borrowed: false });
+    /**
+     * Creates a new `GtkBoxLayout`.
+     * @param orientation - the orientation for the new layout
+     */
+    constructor(orientation) {
+        super();
+        if (orientation !== undefined) {
+            this.id = call("libgtk-4.so.1", "gtk_box_layout_new", [
+                {
+                    type: { type: "int", size: 32, unsigned: false },
+                    value: orientation,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Gets the value set by gtk_box_layout_set_baseline_child().