@gtkx/ffi 0.9.4 → 0.10.0

package/dist/generated/gtk/section-model.js

@@ -1,4 +1,5 @@
 import { call } from "../../batch.js";
+import { getNativeObject } from "../../native/object.js";
 import { NativeObject } from "../../native/base.js";
 /**
  * An interface that adds support for sections to list models.
@@ -91,4 +92,112 @@ export class SectionModel extends NativeObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Gets the type of the items in `list`.
+     *
+     * All items returned from g_list_model_get_item() are of the type
+     * returned by this function, or a subtype, or if the type is an
+     * interface, they are an implementation of that interface.
+     *
+     * The item type of a #GListModel can not change during the life of the
+     * model.
+     */
+    getItemType() {
+        return call("libgtk-4.so.1", "g_list_model_get_item_type", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "int", size: 64, unsigned: true });
+    }
+    /**
+     * Gets the number of items in `list`.
+     *
+     * Depending on the model implementation, calling this function may be
+     * less efficient than iterating the list with increasing values for
+     * `position` until g_list_model_get_item() returns %NULL.
+     */
+    getNItems() {
+        return call("libgtk-4.so.1", "g_list_model_get_n_items", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "int", size: 32, unsigned: true });
+    }
+    /**
+     * Get the item at `position`.
+     *
+     * If `position` is greater than the number of items in `list`, %NULL is
+     * returned.
+     *
+     * %NULL is never returned for an index that is smaller than the length
+     * of the list.
+     *
+     * This function is meant to be used by language bindings in place
+     * of g_list_model_get_item().
+     *
+     * See also: g_list_model_get_n_items()
+     * @param position - the position of the item to fetch
+     */
+    getObject(position) {
+        const ptr = call("libgtk-4.so.1", "g_list_model_get_object", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: position,
+            },
+        ], { type: "gobject", borrowed: true });
+        if (ptr === null)
+            return null;
+        return getNativeObject(ptr);
+    }
+    /**
+     * Emits the #GListModel::items-changed signal on `list`.
+     *
+     * This function should only be called by classes implementing
+     * #GListModel. It has to be called after the internal representation
+     * of `list` has been updated, because handlers connected to this signal
+     * might query the new state of the list.
+     *
+     * Implementations must only make changes to the model (as visible to
+     * its consumer) in places that will not cause problems for that
+     * consumer.  For models that are driven directly by a write API (such
+     * as #GListStore), changes can be reported in response to uses of that
+     * API.  For models that represent remote data, changes should only be
+     * made from a fresh mainloop dispatch.  It is particularly not
+     * permitted to make changes in response to a call to the #GListModel
+     * consumer API.
+     *
+     * Stated another way: in general, it is assumed that code making a
+     * series of accesses to the model via the API, without returning to the
+     * mainloop, and without calling other code, will continue to view the
+     * same contents of the model.
+     * @param position - the position at which `list` changed
+     * @param removed - the number of items removed
+     * @param added - the number of items added
+     */
+    itemsChanged(position, removed, added) {
+        call("libgtk-4.so.1", "g_list_model_items_changed", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: position,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: removed,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: added,
+            },
+        ], { type: "undefined" });
+    }
 }

package/dist/generated/gtk/selection-filter-model.d.ts

@@ -1,6 +1,5 @@
 import { SelectionModel } from "./selection-model.js";
 import * as GObject from "../gobject/index.js";
-/** A list model that presents the selection from a `GtkSelectionModel`. */
 export declare class SelectionFilterModel extends GObject.GObject {
     static readonly glibTypeName: string;
     static readonly objectType: "gobject";
@@ -85,6 +84,7 @@ export declare class SelectionFilterModel extends GObject.GObject {
      * @param added - the number of items added
      */
     itemsChanged(position: number, removed: number, added: number): void;
+    connect(signal: "items-changed", handler: (self: SelectionFilterModel, position: number, removed: number, added: number) => void, after?: boolean): number;
     connect(signal: "notify", handler: (self: SelectionFilterModel, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }

package/dist/generated/gtk/selection-filter-model.js

@@ -5,6 +5,16 @@ import { registerNativeClass } from "../../registry.js";
 import { SelectionModel } from "./selection-model.js";
 import * as GObject from "../gobject/index.js";
 /** A list model that presents the selection from a `GtkSelectionModel`. */
+const SIGNAL_META = {
+    "items-changed": {
+        params: [
+            { type: "int", size: 32, unsigned: true },
+            { type: "int", size: 32, unsigned: true },
+            { type: "int", size: 32, unsigned: true },
+        ],
+        returnType: { type: "undefined" },
+    },
+};
 export class SelectionFilterModel extends GObject.GObject {
     static glibTypeName = "GtkSelectionFilterModel";
     static objectType = "gobject";
@@ -25,7 +35,7 @@ export class SelectionFilterModel extends GObject.GObject {
                     value: model?.id ?? model,
                     optional: true,
                 },
-            ], { type: "gobject", borrowed: true });
+            ], { type: "gobject", borrowed: false });
         }
         else {
             // @ts-ignore
@@ -177,12 +187,23 @@ export class SelectionFilterModel extends GObject.GObject {
         ], { type: "undefined" });
     }
     connect(signal, handler, after = false) {
+        const meta = SIGNAL_META[signal];
         const selfType = { type: "gobject", borrowed: true };
-        const argTypes = [selfType];
-        const returnType = undefined;
+        const argTypes = meta ? [selfType, ...meta.params] : [selfType];
+        const returnType = meta?.returnType;
         const wrappedHandler = (...args) => {
             const self = getNativeObject(args[0]);
-            return handler(self, ...args.slice(1));
+            const callbackArgs = args.slice(1);
+            if (!meta)
+                return handler(self, ...callbackArgs);
+            const wrapped = meta.params.map((t, i) => {
+                if (t?.type === "gobject" && callbackArgs[i] != null) {
+                    return getNativeObject(callbackArgs[i]);
+                }
+                return callbackArgs[i];
+            });
+            const result = handler(self, ...wrapped);
+            return result;
         };
         return call("libgtk-4.so.1", "g_signal_connect_closure", [
             { type: { type: "gobject" }, value: this.id },

package/dist/generated/gtk/selection-model.d.ts

@@ -1,5 +1,6 @@
 import { NativeObject } from "../../native/base.js";
 import { Bitset } from "./bitset.js";
+import * as GObject from "../gobject/index.js";
 /**
  * An interface that adds support for selection to list models.
  *
@@ -146,4 +147,65 @@ export declare class SelectionModel extends NativeObject {
      * @param nItems - the number of items to unselect
      */
     unselectRange(position: number, nItems: number): boolean;
+    /**
+     * Gets the type of the items in `list`.
+     *
+     * All items returned from g_list_model_get_item() are of the type
+     * returned by this function, or a subtype, or if the type is an
+     * interface, they are an implementation of that interface.
+     *
+     * The item type of a #GListModel can not change during the life of the
+     * model.
+     */
+    getItemType(): number;
+    /**
+     * Gets the number of items in `list`.
+     *
+     * Depending on the model implementation, calling this function may be
+     * less efficient than iterating the list with increasing values for
+     * `position` until g_list_model_get_item() returns %NULL.
+     */
+    getNItems(): number;
+    /**
+     * Get the item at `position`.
+     *
+     * If `position` is greater than the number of items in `list`, %NULL is
+     * returned.
+     *
+     * %NULL is never returned for an index that is smaller than the length
+     * of the list.
+     *
+     * This function is meant to be used by language bindings in place
+     * of g_list_model_get_item().
+     *
+     * See also: g_list_model_get_n_items()
+     * @param position - the position of the item to fetch
+     */
+    getObject(position: number): GObject.GObject | null;
+    /**
+     * Emits the #GListModel::items-changed signal on `list`.
+     *
+     * This function should only be called by classes implementing
+     * #GListModel. It has to be called after the internal representation
+     * of `list` has been updated, because handlers connected to this signal
+     * might query the new state of the list.
+     *
+     * Implementations must only make changes to the model (as visible to
+     * its consumer) in places that will not cause problems for that
+     * consumer.  For models that are driven directly by a write API (such
+     * as #GListStore), changes can be reported in response to uses of that
+     * API.  For models that represent remote data, changes should only be
+     * made from a fresh mainloop dispatch.  It is particularly not
+     * permitted to make changes in response to a call to the #GListModel
+     * consumer API.
+     *
+     * Stated another way: in general, it is assumed that code making a
+     * series of accesses to the model via the API, without returning to the
+     * mainloop, and without calling other code, will continue to view the
+     * same contents of the model.
+     * @param position - the position at which `list` changed
+     * @param removed - the number of items removed
+     * @param added - the number of items added
+     */
+    itemsChanged(position: number, removed: number, added: number): void;
 }

package/dist/generated/gtk/selection-model.js

@@ -311,4 +311,112 @@ export class SelectionModel extends NativeObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Gets the type of the items in `list`.
+     *
+     * All items returned from g_list_model_get_item() are of the type
+     * returned by this function, or a subtype, or if the type is an
+     * interface, they are an implementation of that interface.
+     *
+     * The item type of a #GListModel can not change during the life of the
+     * model.
+     */
+    getItemType() {
+        return call("libgtk-4.so.1", "g_list_model_get_item_type", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "int", size: 64, unsigned: true });
+    }
+    /**
+     * Gets the number of items in `list`.
+     *
+     * Depending on the model implementation, calling this function may be
+     * less efficient than iterating the list with increasing values for
+     * `position` until g_list_model_get_item() returns %NULL.
+     */
+    getNItems() {
+        return call("libgtk-4.so.1", "g_list_model_get_n_items", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "int", size: 32, unsigned: true });
+    }
+    /**
+     * Get the item at `position`.
+     *
+     * If `position` is greater than the number of items in `list`, %NULL is
+     * returned.
+     *
+     * %NULL is never returned for an index that is smaller than the length
+     * of the list.
+     *
+     * This function is meant to be used by language bindings in place
+     * of g_list_model_get_item().
+     *
+     * See also: g_list_model_get_n_items()
+     * @param position - the position of the item to fetch
+     */
+    getObject(position) {
+        const ptr = call("libgtk-4.so.1", "g_list_model_get_object", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: position,
+            },
+        ], { type: "gobject", borrowed: true });
+        if (ptr === null)
+            return null;
+        return getNativeObject(ptr);
+    }
+    /**
+     * Emits the #GListModel::items-changed signal on `list`.
+     *
+     * This function should only be called by classes implementing
+     * #GListModel. It has to be called after the internal representation
+     * of `list` has been updated, because handlers connected to this signal
+     * might query the new state of the list.
+     *
+     * Implementations must only make changes to the model (as visible to
+     * its consumer) in places that will not cause problems for that
+     * consumer.  For models that are driven directly by a write API (such
+     * as #GListStore), changes can be reported in response to uses of that
+     * API.  For models that represent remote data, changes should only be
+     * made from a fresh mainloop dispatch.  It is particularly not
+     * permitted to make changes in response to a call to the #GListModel
+     * consumer API.
+     *
+     * Stated another way: in general, it is assumed that code making a
+     * series of accesses to the model via the API, without returning to the
+     * mainloop, and without calling other code, will continue to view the
+     * same contents of the model.
+     * @param position - the position at which `list` changed
+     * @param removed - the number of items removed
+     * @param added - the number of items added
+     */
+    itemsChanged(position, removed, added) {
+        call("libgtk-4.so.1", "g_list_model_items_changed", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: position,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: removed,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: added,
+            },
+        ], { type: "undefined" });
+    }
 }

package/dist/generated/gtk/separator.js

@@ -118,16 +118,17 @@ export class Separator extends Widget {
         const returnType = meta?.returnType;
         const wrappedHandler = (...args) => {
             const self = getNativeObject(args[0]);
-            const signalArgs = args.slice(1);
+            const callbackArgs = args.slice(1);
             if (!meta)
-                return handler(self, ...signalArgs);
-            const wrapped = meta.params.map((m, i) => {
-                if (m.type === "gobject" && signalArgs[i] != null) {
-                    return getNativeObject(signalArgs[i]);
+                return handler(self, ...callbackArgs);
+            const wrapped = meta.params.map((t, i) => {
+                if (t?.type === "gobject" && callbackArgs[i] != null) {
+                    return getNativeObject(callbackArgs[i]);
                 }
-                return signalArgs[i];
+                return callbackArgs[i];
             });
-            return handler(self, ...wrapped);
+            const result = handler(self, ...wrapped);
+            return result;
         };
         return call("libgtk-4.so.1", "g_signal_connect_closure", [
             { type: { type: "gobject" }, value: this.id },

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

@@ -1,34 +1,5 @@
 import * as GObject from "../gobject/index.js";
 import * as Gdk from "../gdk/index.js";
-/**
- * Provides a mechanism to share global settings between applications.
- *
- * On the X window system, this sharing is realized by an
- * [XSettings](http://www.freedesktop.org/wiki/Specifications/xsettings-spec)
- * manager that is usually part of the desktop environment, along with
- * utilities that let the user change these settings.
- *
- * On Wayland, the settings are obtained either via a settings portal,
- * or by reading desktop settings from {@link Gio.Settings}.
- *
- * On macOS, the settings are obtained from `NSUserDefaults`.
- *
- * In the absence of these sharing mechanisms, GTK reads default values for
- * settings from `settings.ini` files in `/etc/gtk-4.0`, `$XDG_CONFIG_DIRS/gtk-4.0`
- * and `$XDG_CONFIG_HOME/gtk-4.0`. These files must be valid key files (see
- * `GKeyFile`), and have a section called Settings. Themes can also provide
- * default values for settings by installing a `settings.ini` file
- * next to their `gtk.css` file.
- *
- * Applications can override system-wide settings by setting the property
- * of the `GtkSettings` object with g_object_set(). This should be restricted
- * to special cases though; `GtkSettings` are not meant as an application
- * configuration facility.
- *
- * There is one `GtkSettings` instance per display. It can be obtained with
- * {@link Gtk.Settings.get_for_display}, but in many cases, it is more
- * convenient to use {@link Gtk.Widget.get_settings}.
- */
 export declare class Settings extends GObject.GObject {
     static readonly glibTypeName: string;
     static readonly objectType: "gobject";
@@ -54,6 +25,7 @@ export declare class Settings extends GObject.GObject {
      * @param name - the name of the setting to reset
      */
     resetProperty(name: string): void;
+    connect(signal: "gtk-private-changed", handler: (self: Settings) => void, after?: boolean): number;
     connect(signal: "notify", handler: (self: Settings, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }

package/dist/generated/gtk/settings.js

@@ -32,6 +32,9 @@ import * as GObject from "../gobject/index.js";
  * {@link Gtk.Settings.get_for_display}, but in many cases, it is more
  * convenient to use {@link Gtk.Widget.get_settings}.
  */
+const SIGNAL_META = {
+    "gtk-private-changed": { params: [], returnType: { type: "undefined" } },
+};
 export class Settings extends GObject.GObject {
     static glibTypeName = "GtkSettings";
     static objectType = "gobject";
@@ -49,7 +52,7 @@ export class Settings extends GObject.GObject {
             this.id = call("libgobject-2.0.so.0", "g_object_new", [
                 { type: { type: "int", size: 64, unsigned: true }, value: gtype },
                 { type: { type: "null" }, value: null },
-            ], { type: "gobject", borrowed: true });
+            ], { type: "gobject", borrowed: false });
         }
         else {
             // @ts-ignore
@@ -67,7 +70,7 @@ export class Settings extends GObject.GObject {
             type: "gobject",
             borrowed: true,
         });
-        return getNativeObject(ptr);
+        return getNativeObject(ptr, Settings);
     }
     /**
      * Gets the `GtkSettings` object for `display`, creating it if necessary.
@@ -80,7 +83,7 @@ export class Settings extends GObject.GObject {
                 value: display?.id ?? display,
             },
         ], { type: "gobject", borrowed: true });
-        return getNativeObject(ptr);
+        return getNativeObject(ptr, Settings);
     }
     /**
      * Undoes the effect of calling g_object_set() to install an
@@ -103,12 +106,23 @@ export class Settings extends GObject.GObject {
         ], { type: "undefined" });
     }
     connect(signal, handler, after = false) {
+        const meta = SIGNAL_META[signal];
         const selfType = { type: "gobject", borrowed: true };
-        const argTypes = [selfType];
-        const returnType = undefined;
+        const argTypes = meta ? [selfType, ...meta.params] : [selfType];
+        const returnType = meta?.returnType;
         const wrappedHandler = (...args) => {
             const self = getNativeObject(args[0]);
-            return handler(self, ...args.slice(1));
+            const callbackArgs = args.slice(1);
+            if (!meta)
+                return handler(self, ...callbackArgs);
+            const wrapped = meta.params.map((t, i) => {
+                if (t?.type === "gobject" && callbackArgs[i] != null) {
+                    return getNativeObject(callbackArgs[i]);
+                }
+                return callbackArgs[i];
+            });
+            const result = handler(self, ...wrapped);
+            return result;
         };
         return call("libgtk-4.so.1", "g_signal_connect_closure", [
             { type: { type: "gobject" }, value: this.id },

package/dist/generated/gtk/shortcut-action.js

@@ -60,7 +60,7 @@ export class ShortcutAction extends GObject.GObject {
                     type: { type: "string" },
                     value: string,
                 },
-            ], { type: "gobject", borrowed: true });
+            ], { type: "gobject", borrowed: false });
         }
         else {
             // @ts-ignore
@@ -94,14 +94,8 @@ export class ShortcutAction extends GObject.GObject {
                 value: widget?.id ?? widget,
             },
             {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GVariant",
-                    lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
-                    getTypeFn: "intern",
-                },
-                value: args?.id ?? args,
+                type: { type: "gvariant" },
+                value: args,
                 optional: true,
             },
         ], { type: "boolean" });
@@ -153,7 +147,9 @@ export class ShortcutAction extends GObject.GObject {
         const returnType = undefined;
         const wrappedHandler = (...args) => {
             const self = getNativeObject(args[0]);
-            return handler(self, ...args.slice(1));
+            const callbackArgs = args.slice(1);
+            const result = handler(self, ...callbackArgs);
+            return result;
         };
         return call("libgtk-4.so.1", "g_signal_connect_closure", [
             { type: { type: "gobject" }, value: this.id },

package/dist/generated/gtk/shortcut-controller.d.ts

@@ -4,48 +4,6 @@ import * as GObject from "../gobject/index.js";
 import * as Gdk from "../gdk/index.js";
 import * as Gio from "../gio/index.js";
 import { EventController } from "./event-controller.js";
-/**
- * Manages keyboard shortcuts and their activation.
- *
- * Most common shortcuts are using this controller implicitly, e.g. by
- * adding a mnemonic underline to a {@link Gtk.Label}, or by installing a key
- * binding using {@link Gtk.WidgetClass.add_binding}, or by adding accelerators
- * to global actions using {@link Gtk.Application.set_accels_for_action}.
- *
- * But it is possible to create your own shortcut controller, and add
- * shortcuts to it.
- *
- * `GtkShortcutController` implements {@link Gio.ListModel} for querying the
- * shortcuts that have been added to it.
- *
- * # GtkShortcutController as GtkBuildable
- *
- * `GtkShortcutController`s can be created in {@link Gtk.Builder} ui files, to set up
- * shortcuts in the same place as the widgets.
- *
- * An example of a UI definition fragment with `GtkShortcutController`:
- * ```xml
- *   <object class='GtkButton'>
- *     <child>
- *       <object class='GtkShortcutController'>
- *         <property name='scope'>managed</property>
- *         <child>
- *           <object class='GtkShortcut'>
- *             <property name='trigger'>&lt;Control&gt;k</property>
- *             <property name='action'>activate</property>
- *           </object>
- *         </child>
- *       </object>
- *     </child>
- *   </object>
- * ```
- *
- * This example creates a {@link Gtk.ActivateAction} for triggering the
- * `activate` signal of the {@link Gtk.Button}. See {@link Gtk.ShortcutAction.parse_string}
- * for the syntax for other kinds of {@link Gtk.ShortcutAction}. See
- * {@link Gtk.ShortcutTrigger.parse_string} to learn more about the syntax
- * for triggers.
- */
 export declare class ShortcutController extends EventController {
     static readonly glibTypeName: string;
     static readonly objectType: "gobject";
@@ -187,6 +145,7 @@ export declare class ShortcutController extends EventController {
      * of the `<object>` tag used to construct the `buildable`.
      */
     getBuildableId(): string | null;
+    connect(signal: "items-changed", handler: (self: ShortcutController, position: number, removed: number, added: number) => void, after?: boolean): number;
     connect(signal: "notify", handler: (self: ShortcutController, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }

package/dist/generated/gtk/shortcut-controller.js

@@ -45,6 +45,16 @@ import { EventController } from "./event-controller.js";
  * {@link Gtk.ShortcutTrigger.parse_string} to learn more about the syntax
  * for triggers.
  */
+const SIGNAL_META = {
+    "items-changed": {
+        params: [
+            { type: "int", size: 32, unsigned: true },
+            { type: "int", size: 32, unsigned: true },
+            { type: "int", size: 32, unsigned: true },
+        ],
+        returnType: { type: "undefined" },
+    },
+};
 export class ShortcutController extends EventController {
     static glibTypeName = "GtkShortcutController";
     static objectType = "gobject";
@@ -59,7 +69,7 @@ export class ShortcutController extends EventController {
             setInstantiating(false);
             this.id = call("libgtk-4.so.1", "gtk_shortcut_controller_new", [], {
                 type: "gobject",
-                borrowed: true,
+                borrowed: false,
             });
         }
         else {
@@ -322,12 +332,23 @@ export class ShortcutController extends EventController {
         ], { type: "string", borrowed: true });
     }
     connect(signal, handler, after = false) {
+        const meta = SIGNAL_META[signal];
         const selfType = { type: "gobject", borrowed: true };
-        const argTypes = [selfType];
-        const returnType = undefined;
+        const argTypes = meta ? [selfType, ...meta.params] : [selfType];
+        const returnType = meta?.returnType;
         const wrappedHandler = (...args) => {
             const self = getNativeObject(args[0]);
-            return handler(self, ...args.slice(1));
+            const callbackArgs = args.slice(1);
+            if (!meta)
+                return handler(self, ...callbackArgs);
+            const wrapped = meta.params.map((t, i) => {
+                if (t?.type === "gobject" && callbackArgs[i] != null) {
+                    return getNativeObject(callbackArgs[i]);
+                }
+                return callbackArgs[i];
+            });
+            const result = handler(self, ...wrapped);
+            return result;
         };
         return call("libgtk-4.so.1", "g_signal_connect_closure", [
             { type: { type: "gobject" }, value: this.id },