@gtkx/ffi 0.6.0 → 0.7.0

package/dist/generated/adw/view-stack-pages.js

@@ -1,4 +1,4 @@
-import { call, getObject, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { call, getObject, getBoxed, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
 import * as GObject from "../gobject/index.js";
 /**
  * An auxiliary class used by [class@ViewStack].
@@ -60,6 +60,376 @@ export class ViewStackPages extends GObject.GObject {
             },
         ], { 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("libadwaita-1.so.0", "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("libadwaita-1.so.0", "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("libadwaita-1.so.0", "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 getObject(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("libadwaita-1.so.0", "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" });
+    }
+    /**
+     * Gets the set containing all currently selected items in the model.
+     *
+     * This function may be slow, so if you are only interested in single item,
+     * consider using [method@Gtk.SelectionModel.is_selected] or if you are only
+     * interested in a few, consider [method@Gtk.SelectionModel.get_selection_in_range].
+     */
+    getSelection() {
+        const ptr = call("libadwaita-1.so.0", "gtk_selection_model_get_selection", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], {
+            type: "boxed",
+            borrowed: true,
+            innerType: "GtkBitset",
+            lib: "libadwaita-1.so.0",
+        });
+        return getBoxed(ptr, "GtkBitset");
+    }
+    /**
+     * Gets the set of selected items in a range.
+     *
+     * This function is an optimization for
+     * [method@Gtk.SelectionModel.get_selection] when you are only
+     * interested in part of the model's selected state. A common use
+     * case is in response to the [signal@Gtk.SelectionModel::selection-changed]
+     * signal.
+     * @param position - start of the queried range
+     * @param nItems - number of items in the queried range
+     */
+    getSelectionInRange(position, nItems) {
+        const ptr = call("libadwaita-1.so.0", "gtk_selection_model_get_selection_in_range", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: position,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: nItems,
+            },
+        ], {
+            type: "boxed",
+            borrowed: true,
+            innerType: "GtkBitset",
+            lib: "libadwaita-1.so.0",
+        });
+        return getBoxed(ptr, "GtkBitset");
+    }
+    /**
+     * Checks if the given item is selected.
+     * @param position - the position of the item to query
+     */
+    isSelected(position) {
+        return call("libadwaita-1.so.0", "gtk_selection_model_is_selected", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: position,
+            },
+        ], { type: "boolean" });
+    }
+    /**
+     * Requests to select all items in the model.
+     */
+    selectAll() {
+        return call("libadwaita-1.so.0", "gtk_selection_model_select_all", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "boolean" });
+    }
+    /**
+     * Requests to select an item in the model.
+     * @param position - the position of the item to select
+     * @param unselectRest - whether previously selected items should be unselected
+     */
+    selectItem(position, unselectRest) {
+        return call("libadwaita-1.so.0", "gtk_selection_model_select_item", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: position,
+            },
+            {
+                type: { type: "boolean" },
+                value: unselectRest,
+            },
+        ], { type: "boolean" });
+    }
+    /**
+     * Requests to select a range of items in the model.
+     * @param position - the first item to select
+     * @param nItems - the number of items to select
+     * @param unselectRest - whether previously selected items should be unselected
+     */
+    selectRange(position, nItems, unselectRest) {
+        return call("libadwaita-1.so.0", "gtk_selection_model_select_range", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: position,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: nItems,
+            },
+            {
+                type: { type: "boolean" },
+                value: unselectRest,
+            },
+        ], { type: "boolean" });
+    }
+    /**
+     * Helper function for implementations of `GtkSelectionModel`.
+     *
+     * Call this when the selection changes to emit the
+     * [signal@Gtk.SelectionModel::selection-changed] signal.
+     * @param position - the first changed item
+     * @param nItems - the number of changed items
+     */
+    selectionChanged(position, nItems) {
+        call("libadwaita-1.so.0", "gtk_selection_model_selection_changed", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: position,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: nItems,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Make selection changes.
+     *
+     * This is the most advanced selection updating method that allows
+     * the most fine-grained control over selection changes. If you can,
+     * you should try the simpler versions, as implementations are more
+     * likely to implement support for those.
+     *
+     * Requests that the selection state of all positions set in `mask` be updated to the respective value in the `selected` bitmask.
+     *
+     * In pseudocode, it would look something like this:
+     *
+     * ```c
+     * for (i = 0; i < n_items; i++)
+     * {
+     * // don't change values not in the mask
+     * if (!gtk_bitset_contains (mask, i))
+     * continue;
+     *
+     * if (gtk_bitset_contains (selected, i))
+     * select_item (i);
+     * else
+     * unselect_item (i);
+     * }
+     *
+     * gtk_selection_model_selection_changed (model,
+     * first_changed_item,
+     * n_changed_items);
+     * ```
+     *
+     * `mask` and `selected` must not be modified. They may refer to the
+     * same bitset, which would mean that every item in the set should
+     * be selected.
+     * @param selected - bitmask specifying if items should be selected or unselected
+     * @param mask - bitmask specifying which items should be updated
+     */
+    setSelection(selected, mask) {
+        return call("libadwaita-1.so.0", "gtk_selection_model_set_selection", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: {
+                    type: "boxed",
+                    borrowed: true,
+                    innerType: "GtkBitset",
+                    lib: "libadwaita-1.so.0",
+                },
+                value: selected?.id ?? selected,
+            },
+            {
+                type: {
+                    type: "boxed",
+                    borrowed: true,
+                    innerType: "GtkBitset",
+                    lib: "libadwaita-1.so.0",
+                },
+                value: mask?.id ?? mask,
+            },
+        ], { type: "boolean" });
+    }
+    /**
+     * Requests to unselect all items in the model.
+     */
+    unselectAll() {
+        return call("libadwaita-1.so.0", "gtk_selection_model_unselect_all", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "boolean" });
+    }
+    /**
+     * Requests to unselect an item in the model.
+     * @param position - the position of the item to unselect
+     */
+    unselectItem(position) {
+        return call("libadwaita-1.so.0", "gtk_selection_model_unselect_item", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: position,
+            },
+        ], { type: "boolean" });
+    }
+    /**
+     * Requests to unselect a range of items in the model.
+     * @param position - the first item to unselect
+     * @param nItems - the number of items to unselect
+     */
+    unselectRange(position, nItems) {
+        return call("libadwaita-1.so.0", "gtk_selection_model_unselect_range", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: position,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: true },
+                value: nItems,
+            },
+        ], { type: "boolean" });
+    }
     connect(signal, handler, after = false) {
         const selfType = { type: "gobject", borrowed: true };
         const argTypes = [selfType];

package/dist/generated/adw/view-stack.js

@@ -1,4 +1,4 @@
-import { call, getObject, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { call, getObject, getInterface, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
 import * as Gtk from "../gtk/index.js";
 /**
  * A view container for [class@ViewSwitcher].
@@ -264,7 +264,7 @@ export class ViewStack extends Gtk.Widget {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr);
+        return getInterface(ptr, Gtk.SelectionModel);
     }
     /**
      * Gets the transition animation duration for @self.

package/dist/generated/adw/window.js

@@ -1,4 +1,5 @@
-import { call, getObject, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { call, getObject, getInterface, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import * as Gio from "../gio/index.js";
 import * as Gtk from "../gtk/index.js";
 /**
  * A freeform window.
@@ -168,7 +169,7 @@ export class Window extends Gtk.Window {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr);
+        return getInterface(ptr, Gio.ListModel);
     }
     /**
      * Returns the currently visible dialog in @self, if there's one.

package/dist/generated/adw/wrap-box.d.ts

@@ -277,6 +277,15 @@ export declare class WrapBox extends Gtk.Widget {
      * @param wrapReverse - whether to reverse wrap direction
      */
     setWrapReverse(wrapReverse: boolean): void;
+    /**
+     * Retrieves the orientation of the @orientable.
+     */
+    getOrientation(): Gtk.Orientation;
+    /**
+     * Sets the orientation of the @orientable.
+     * @param orientation - the orientable’s new orientation
+     */
+    setOrientation(orientation: Gtk.Orientation): void;
     connect(signal: "notify", handler: (self: WrapBox, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }

package/dist/generated/adw/wrap-box.js

@@ -597,6 +597,33 @@ export class WrapBox extends Gtk.Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Retrieves the orientation of the @orientable.
+     */
+    getOrientation() {
+        return call("libadwaita-1.so.0", "gtk_orientable_get_orientation", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "int", size: 32, unsigned: false });
+    }
+    /**
+     * Sets the orientation of the @orientable.
+     * @param orientation - the orientable’s new orientation
+     */
+    setOrientation(orientation) {
+        call("libadwaita-1.so.0", "gtk_orientable_set_orientation", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: false },
+                value: orientation,
+            },
+        ], { type: "undefined" });
+    }
     connect(signal, handler, after = false) {
         const selfType = { type: "gobject", borrowed: true };
         const argTypes = [selfType];

package/dist/generated/adw/wrap-layout.d.ts

@@ -232,6 +232,15 @@ export declare class WrapLayout extends Gtk.LayoutManager {
      * @param wrapReverse - whether to reverse wrap direction
      */
     setWrapReverse(wrapReverse: boolean): void;
+    /**
+     * Retrieves the orientation of the @orientable.
+     */
+    getOrientation(): Gtk.Orientation;
+    /**
+     * Sets the orientation of the @orientable.
+     * @param orientation - the orientable’s new orientation
+     */
+    setOrientation(orientation: Gtk.Orientation): void;
     connect(signal: "notify", handler: (self: WrapLayout, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }

package/dist/generated/adw/wrap-layout.js

@@ -480,6 +480,33 @@ export class WrapLayout extends Gtk.LayoutManager {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Retrieves the orientation of the @orientable.
+     */
+    getOrientation() {
+        return call("libadwaita-1.so.0", "gtk_orientable_get_orientation", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "int", size: 32, unsigned: false });
+    }
+    /**
+     * Sets the orientation of the @orientable.
+     * @param orientation - the orientable’s new orientation
+     */
+    setOrientation(orientation) {
+        call("libadwaita-1.so.0", "gtk_orientable_set_orientation", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: false },
+                value: orientation,
+            },
+        ], { type: "undefined" });
+    }
     connect(signal, handler, after = false) {
         const selfType = { type: "gobject", borrowed: true };
         const argTypes = [selfType];

package/dist/generated/appstream/agreement.js

@@ -1,4 +1,4 @@
-import { call, getObject, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { call, getObject, getBoxed, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
 import * as GObject from "../gobject/index.js";
 export class Agreement extends GObject.GObject {
     static glibTypeName = "AsAgreement";
@@ -73,7 +73,7 @@ export class Agreement extends GObject.GObject {
             innerType: "GPtrArray",
             lib: "libappstream.so.5",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GPtrArray");
     }
     /**
      * Gets the agreement version_id.

package/dist/generated/appstream/artifact.js

@@ -1,4 +1,4 @@
-import { call, getObject, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { call, getObject, getBoxed, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
 import * as GObject from "../gobject/index.js";
 export class Artifact extends GObject.GObject {
     static glibTypeName = "AsArtifact";
@@ -97,7 +97,7 @@ export class Artifact extends GObject.GObject {
             innerType: "GPtrArray",
             lib: "libappstream.so.5",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GPtrArray");
     }
     /**
      * Gets a suggested filename for the downloaded artifact,
@@ -137,7 +137,7 @@ export class Artifact extends GObject.GObject {
             innerType: "GPtrArray",
             lib: "libappstream.so.5",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GPtrArray");
     }
     /**
      * Gets the artifact platform string (e.g. a triplet like "x86_64-linux-gnu").

package/dist/generated/appstream/category.js

@@ -1,4 +1,4 @@
-import { call, getObject, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { call, getObject, getBoxed, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
 import * as GObject from "../gobject/index.js";
 export class Category extends GObject.GObject {
     static glibTypeName = "AsCategory";
@@ -81,7 +81,7 @@ export class Category extends GObject.GObject {
             innerType: "GPtrArray",
             lib: "libappstream.so.5",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GPtrArray");
     }
     /**
      * Get list of components which have been sorted into this category.
@@ -98,7 +98,7 @@ export class Category extends GObject.GObject {
             innerType: "GPtrArray",
             lib: "libappstream.so.5",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GPtrArray");
     }
     getDesktopGroups() {
         const ptr = call("libappstream.so.5", "as_category_get_desktop_groups", [
@@ -112,7 +112,7 @@ export class Category extends GObject.GObject {
             innerType: "GPtrArray",
             lib: "libappstream.so.5",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GPtrArray");
     }
     /**
      * Get the stock icon name for this category.

package/dist/generated/appstream/component-box.js

@@ -1,4 +1,4 @@
-import { call, NativeError, getObject, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { call, NativeError, getObject, getBoxed, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
 import * as GObject from "../gobject/index.js";
 export class ComponentBox extends GObject.GObject {
     static glibTypeName = "AsComponentBox";
@@ -85,7 +85,7 @@ export class ComponentBox extends GObject.GObject {
             innerType: "GPtrArray",
             lib: "libappstream.so.5",
         });
-        return getObject(ptr);
+        return getBoxed(ptr, "GPtrArray");
     }
     /**
      * Remove all contents of this component box.