@gtkx/ffi 0.1.45 → 0.1.46

package/dist/generated/gtk/tree-expander.d.ts

@@ -1,19 +1,144 @@
 import { TreeListRow } from "./tree-list-row.js";
 import * as GObject from "../gobject/index.js";
 import { Widget } from "./widget.js";
+/**
+ * Provides an expander for a tree-like list.
+ *
+ * It is typically placed as a bottommost child into a `GtkListView`
+ * to allow users to expand and collapse children in a list with a
+ * [class@Gtk.TreeListModel]. `GtkTreeExpander` provides the common UI
+ * elements, gestures and keybindings for this purpose.
+ *
+ * On top of this, the "listitem.expand", "listitem.collapse" and
+ * "listitem.toggle-expand" actions are provided to allow adding custom
+ * UI for managing expanded state.
+ *
+ * It is important to mention that you want to set the
+ * [property@Gtk.ListItem:focusable] property to FALSE when using this
+ * widget, as you want the keyboard focus to be in the treexpander, and not
+ * inside the list to make use of the keybindings.
+ *
+ * The `GtkTreeListModel` must be set to not be passthrough. Then it
+ * will provide [class@Gtk.TreeListRow] items which can be set via
+ * [method@Gtk.TreeExpander.set_list_row] on the expander.
+ * The expander will then watch that row item automatically.
+ * [method@Gtk.TreeExpander.set_child] sets the widget that displays
+ * the actual row contents.
+ *
+ * `GtkTreeExpander` can be modified with properties such as
+ * [property@Gtk.TreeExpander:indent-for-icon],
+ * [property@Gtk.TreeExpander:indent-for-depth], and
+ * [property@Gtk.TreeExpander:hide-expander] to achieve a different appearance.
+ * This can even be done to influence individual rows, for example by binding
+ * the [property@Gtk.TreeExpander:hide-expander] property to the item count of
+ * the model of the treelistrow, to hide the expander for rows without children,
+ * even if the row is expandable.
+ *
+ * ## Shortcuts and Gestures
+ *
+ * `GtkTreeExpander` supports the following keyboard shortcuts:
+ *
+ * - `+` or `*` expands the expander.
+ * - `-` or `/` collapses the expander.
+ * - Left and right arrow keys, when combined with `Shift` or
+ * `Ctrl`+`Shift`, will expand or collapse, depending on
+ * the locale's text direction.
+ * - `Ctrl`+`␣` toggles the expander state.
+ *
+ * The row can also expand on drag gestures.
+ *
+ * ## Actions
+ *
+ * `GtkTreeExpander` defines a set of built-in actions:
+ *
+ * - `listitem.expand` expands the expander if it can be expanded.
+ * - `listitem.collapse` collapses the expander.
+ * - `listitem.toggle-expand` tries to expand the expander if it was collapsed
+ * or collapses it if it was expanded.
+ *
+ * ## CSS nodes
+ *
+ * ```
+ * treeexpander
+ * ├── [indent]*
+ * ├── [expander]
+ * ╰── <child>
+ * ```
+ *
+ * `GtkTreeExpander` has zero or one CSS nodes with the name "expander" that
+ * should display the expander icon. The node will be `:checked` when it
+ * is expanded. If the node is not expandable, an "indent" node will be
+ * displayed instead.
+ *
+ * For every level of depth, another "indent" node is prepended.
+ *
+ * ## Accessibility
+ *
+ * Until GTK 4.10, `GtkTreeExpander` used the [enum@Gtk.AccessibleRole.group] role.
+ *
+ * Since GTK 4.12, `GtkTreeExpander` uses the [enum@Gtk.AccessibleRole.button] role.
+ * Toggling it will change the `GTK_ACCESSIBLE_STATE_EXPANDED` state.
+ */
 export declare class TreeExpander extends Widget {
+    /**
+     * Creates a new `GtkTreeExpander`
+     */
     constructor(...args: unknown[]);
     protected createPtr(_args: unknown[]): unknown;
+    /**
+     * Gets the child widget displayed by @self.
+     */
     getChild(): Widget | null;
+    /**
+     * Gets whether the TreeExpander should be hidden in a GtkTreeListRow.
+     */
     getHideExpander(): boolean;
+    /**
+     * TreeExpander indents each level of depth with an additional indent.
+     */
     getIndentForDepth(): boolean;
+    /**
+     * TreeExpander indents the child by the width of an expander-icon if it is not expandable.
+     */
     getIndentForIcon(): boolean;
+    /**
+     * Forwards the item set on the `GtkTreeListRow` that `self` is managing.
+     *
+     * This call is essentially equivalent to calling:
+     *
+     * ```c
+     * gtk_tree_list_row_get_item (gtk_tree_expander_get_list_row (@self));
+     * ```
+     */
     getItem(): GObject.GObject | null;
+    /**
+     * Gets the list row managed by @self.
+     */
     getListRow(): TreeListRow | null;
+    /**
+     * Sets the content widget to display.
+     * @param child - a `GtkWidget`
+     */
     setChild(child?: Widget | null): void;
+    /**
+     * Sets whether the expander icon should be visible in a GtkTreeListRow.
+     * @param hideExpander - TRUE if the expander should be hidden. Otherwise FALSE.
+     */
     setHideExpander(hideExpander: boolean): void;
+    /**
+     * Sets if the TreeExpander should indent the child according to its depth.
+     * @param indentForDepth - TRUE if the child should be indented. Otherwise FALSE.
+     */
     setIndentForDepth(indentForDepth: boolean): void;
+    /**
+     * Sets if the TreeExpander should indent the child by the width of an expander-icon when it is not expandable.
+     * @param indentForIcon - TRUE if the child should be indented without expander. Otherwise FALSE.
+     */
     setIndentForIcon(indentForIcon: boolean): void;
+    /**
+     * Sets the tree list row that this expander should manage.
+     * @param listRow - a `GtkTreeListRow`
+     */
     setListRow(listRow?: TreeListRow | null): void;
     connect(signal: "notify", handler: (self: TreeExpander, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;

package/dist/generated/gtk/tree-expander.js

@@ -3,7 +3,88 @@ import { getObject } from "@gtkx/ffi";
 import { TreeListRow } from "./tree-list-row.js";
 import * as GObject from "../gobject/index.js";
 import { Widget } from "./widget.js";
+/**
+ * Provides an expander for a tree-like list.
+ *
+ * It is typically placed as a bottommost child into a `GtkListView`
+ * to allow users to expand and collapse children in a list with a
+ * [class@Gtk.TreeListModel]. `GtkTreeExpander` provides the common UI
+ * elements, gestures and keybindings for this purpose.
+ *
+ * On top of this, the "listitem.expand", "listitem.collapse" and
+ * "listitem.toggle-expand" actions are provided to allow adding custom
+ * UI for managing expanded state.
+ *
+ * It is important to mention that you want to set the
+ * [property@Gtk.ListItem:focusable] property to FALSE when using this
+ * widget, as you want the keyboard focus to be in the treexpander, and not
+ * inside the list to make use of the keybindings.
+ *
+ * The `GtkTreeListModel` must be set to not be passthrough. Then it
+ * will provide [class@Gtk.TreeListRow] items which can be set via
+ * [method@Gtk.TreeExpander.set_list_row] on the expander.
+ * The expander will then watch that row item automatically.
+ * [method@Gtk.TreeExpander.set_child] sets the widget that displays
+ * the actual row contents.
+ *
+ * `GtkTreeExpander` can be modified with properties such as
+ * [property@Gtk.TreeExpander:indent-for-icon],
+ * [property@Gtk.TreeExpander:indent-for-depth], and
+ * [property@Gtk.TreeExpander:hide-expander] to achieve a different appearance.
+ * This can even be done to influence individual rows, for example by binding
+ * the [property@Gtk.TreeExpander:hide-expander] property to the item count of
+ * the model of the treelistrow, to hide the expander for rows without children,
+ * even if the row is expandable.
+ *
+ * ## Shortcuts and Gestures
+ *
+ * `GtkTreeExpander` supports the following keyboard shortcuts:
+ *
+ * - `+` or `*` expands the expander.
+ * - `-` or `/` collapses the expander.
+ * - Left and right arrow keys, when combined with `Shift` or
+ * `Ctrl`+`Shift`, will expand or collapse, depending on
+ * the locale's text direction.
+ * - `Ctrl`+`␣` toggles the expander state.
+ *
+ * The row can also expand on drag gestures.
+ *
+ * ## Actions
+ *
+ * `GtkTreeExpander` defines a set of built-in actions:
+ *
+ * - `listitem.expand` expands the expander if it can be expanded.
+ * - `listitem.collapse` collapses the expander.
+ * - `listitem.toggle-expand` tries to expand the expander if it was collapsed
+ * or collapses it if it was expanded.
+ *
+ * ## CSS nodes
+ *
+ * ```
+ * treeexpander
+ * ├── [indent]*
+ * ├── [expander]
+ * ╰── <child>
+ * ```
+ *
+ * `GtkTreeExpander` has zero or one CSS nodes with the name "expander" that
+ * should display the expander icon. The node will be `:checked` when it
+ * is expanded. If the node is not expandable, an "indent" node will be
+ * displayed instead.
+ *
+ * For every level of depth, another "indent" node is prepended.
+ *
+ * ## Accessibility
+ *
+ * Until GTK 4.10, `GtkTreeExpander` used the [enum@Gtk.AccessibleRole.group] role.
+ *
+ * Since GTK 4.12, `GtkTreeExpander` uses the [enum@Gtk.AccessibleRole.button] role.
+ * Toggling it will change the `GTK_ACCESSIBLE_STATE_EXPANDED` state.
+ */
 export class TreeExpander extends Widget {
+    /**
+     * Creates a new `GtkTreeExpander`
+     */
     constructor(...args) {
         super(...args);
     }
@@ -13,6 +94,9 @@ export class TreeExpander extends Widget {
             borrowed: true,
         });
     }
+    /**
+     * Gets the child widget displayed by @self.
+     */
     getChild() {
         const ptr = call("libgtk-4.so.1", "gtk_tree_expander_get_child", [
             {
@@ -24,6 +108,9 @@ export class TreeExpander extends Widget {
             return null;
         return getObject(ptr, Widget);
     }
+    /**
+     * Gets whether the TreeExpander should be hidden in a GtkTreeListRow.
+     */
     getHideExpander() {
         return call("libgtk-4.so.1", "gtk_tree_expander_get_hide_expander", [
             {
@@ -32,6 +119,9 @@ export class TreeExpander extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * TreeExpander indents each level of depth with an additional indent.
+     */
     getIndentForDepth() {
         return call("libgtk-4.so.1", "gtk_tree_expander_get_indent_for_depth", [
             {
@@ -40,6 +130,9 @@ export class TreeExpander extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * TreeExpander indents the child by the width of an expander-icon if it is not expandable.
+     */
     getIndentForIcon() {
         return call("libgtk-4.so.1", "gtk_tree_expander_get_indent_for_icon", [
             {
@@ -48,6 +141,15 @@ export class TreeExpander extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Forwards the item set on the `GtkTreeListRow` that `self` is managing.
+     *
+     * This call is essentially equivalent to calling:
+     *
+     * ```c
+     * gtk_tree_list_row_get_item (gtk_tree_expander_get_list_row (@self));
+     * ```
+     */
     getItem() {
         const ptr = call("libgtk-4.so.1", "gtk_tree_expander_get_item", [
             {
@@ -59,6 +161,9 @@ export class TreeExpander extends Widget {
             return null;
         return getObject(ptr, GObject.GObject);
     }
+    /**
+     * Gets the list row managed by @self.
+     */
     getListRow() {
         const ptr = call("libgtk-4.so.1", "gtk_tree_expander_get_list_row", [
             {
@@ -70,6 +175,10 @@ export class TreeExpander extends Widget {
             return null;
         return getObject(ptr, TreeListRow);
     }
+    /**
+     * Sets the content widget to display.
+     * @param child - a `GtkWidget`
+     */
     setChild(child) {
         call("libgtk-4.so.1", "gtk_tree_expander_set_child", [
             {
@@ -83,6 +192,10 @@ export class TreeExpander extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets whether the expander icon should be visible in a GtkTreeListRow.
+     * @param hideExpander - TRUE if the expander should be hidden. Otherwise FALSE.
+     */
     setHideExpander(hideExpander) {
         call("libgtk-4.so.1", "gtk_tree_expander_set_hide_expander", [
             {
@@ -95,6 +208,10 @@ export class TreeExpander extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets if the TreeExpander should indent the child according to its depth.
+     * @param indentForDepth - TRUE if the child should be indented. Otherwise FALSE.
+     */
     setIndentForDepth(indentForDepth) {
         call("libgtk-4.so.1", "gtk_tree_expander_set_indent_for_depth", [
             {
@@ -107,6 +224,10 @@ export class TreeExpander extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets if the TreeExpander should indent the child by the width of an expander-icon when it is not expandable.
+     * @param indentForIcon - TRUE if the child should be indented without expander. Otherwise FALSE.
+     */
     setIndentForIcon(indentForIcon) {
         call("libgtk-4.so.1", "gtk_tree_expander_set_indent_for_icon", [
             {
@@ -119,6 +240,10 @@ export class TreeExpander extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the tree list row that this expander should manage.
+     * @param listRow - a `GtkTreeListRow`
+     */
     setListRow(listRow) {
         call("libgtk-4.so.1", "gtk_tree_expander_set_list_row", [
             {

package/dist/generated/gtk/tree-iter.d.ts

@@ -1,15 +1,38 @@
 export interface TreeIterInit {
     stamp?: number;
 }
+/**
+ * The `GtkTreeIter` is the primary structure
+ * for accessing a `GtkTreeModel`. Models are expected to put a unique
+ * integer in the `stamp` member, and put
+ * model-specific data in the three `user_data` members.
+ */
 export declare class TreeIter {
     ptr: unknown;
     constructor(init?: TreeIterInit);
     protected createPtr(init: TreeIterInit): unknown;
+    /**
+     * Creates a dynamically allocated tree iterator as a copy of @iter.
+     *
+     * This function is not intended for use in applications,
+     * because you can just copy the structs by value
+     * (`GtkTreeIter new_iter = iter;`).
+     * You must free this iter with gtk_tree_iter_free().
+     */
     copy(): TreeIter;
+    /**
+     * Frees an iterator that has been allocated by gtk_tree_iter_copy().
+     *
+     * This function is mainly used for language bindings.
+     */
     free(): void;
+    /** a unique stamp to catch invalid iterators */
     get stamp(): number;
     set stamp(value: number);
+    /** model-specific data */
     get userData(): number;
+    /** model-specific data */
     get userData2(): number;
+    /** model-specific data */
     get userData3(): number;
 }

package/dist/generated/gtk/tree-iter.js

@@ -1,5 +1,11 @@
 import { alloc, call, read, write } from "@gtkx/native";
 import { getObject } from "@gtkx/ffi";
+/**
+ * The `GtkTreeIter` is the primary structure
+ * for accessing a `GtkTreeModel`. Models are expected to put a unique
+ * integer in the `stamp` member, and put
+ * model-specific data in the three `user_data` members.
+ */
 export class TreeIter {
     ptr;
     constructor(init = {}) {
@@ -11,6 +17,14 @@ export class TreeIter {
             write(ptr, { type: "int", size: 32, unsigned: false }, 0, init.stamp);
         return ptr;
     }
+    /**
+     * Creates a dynamically allocated tree iterator as a copy of @iter.
+     *
+     * This function is not intended for use in applications,
+     * because you can just copy the structs by value
+     * (`GtkTreeIter new_iter = iter;`).
+     * You must free this iter with gtk_tree_iter_free().
+     */
     copy() {
         const ptr = call("libgtk-4.so.1", "gtk_tree_iter_copy", [
             {
@@ -25,6 +39,11 @@ export class TreeIter {
         });
         return getObject(ptr, TreeIter);
     }
+    /**
+     * Frees an iterator that has been allocated by gtk_tree_iter_copy().
+     *
+     * This function is mainly used for language bindings.
+     */
     free() {
         call("libgtk-4.so.1", "gtk_tree_iter_free", [
             {
@@ -33,18 +52,22 @@ export class TreeIter {
             },
         ], { type: "undefined" });
     }
+    /** a unique stamp to catch invalid iterators */
     get stamp() {
         return read(this.ptr, { type: "int", size: 32, unsigned: false }, 0);
     }
     set stamp(value) {
         write(this.ptr, { type: "int", size: 32, unsigned: false }, 0, value);
     }
+    /** model-specific data */
     get userData() {
         return read(this.ptr, { type: "int", size: 64, unsigned: true }, 8);
     }
+    /** model-specific data */
     get userData2() {
         return read(this.ptr, { type: "int", size: 64, unsigned: true }, 16);
     }
+    /** model-specific data */
     get userData3() {
         return read(this.ptr, { type: "int", size: 64, unsigned: true }, 24);
     }

package/dist/generated/gtk/tree-list-model.d.ts

@@ -1,15 +1,84 @@
 import { TreeListRow } from "./tree-list-row.js";
 import * as GObject from "../gobject/index.js";
 import * as Gio from "../gio/index.js";
+/** A list model that can create child models on demand. */
 export declare class TreeListModel extends GObject.GObject {
+    /**
+     * Creates a new empty `GtkTreeListModel` displaying `root` with all rows collapsed.
+     * @param root - The `GListModel` to use as root
+     * @param passthrough - %TRUE to pass through items from the models
+     * @param autoexpand - %TRUE to set the autoexpand property and expand the `root` model
+     * @param createFunc - function to
+     * @param userData - Data to pass to @create_func
+     * @param userDestroy - Function to call to free @user_data
+     */
     constructor(root: Gio.ListModel, passthrough: boolean, autoexpand: boolean, createFunc: (...args: unknown[]) => unknown, userDestroy: () => void, userData?: number | null);
     constructor(...args: unknown[]);
     protected createPtr(args: unknown[]): unknown;
+    /**
+     * Gets whether the model is set to automatically expand new rows
+     * that get added.
+     *
+     * This can be either rows added by changes to the underlying
+     * models or via [method@Gtk.TreeListRow.set_expanded].
+     */
     getAutoexpand(): boolean;
+    /**
+     * Gets the row item corresponding to the child at index `position` for
+     * @self's root model.
+     *
+     * If `position` is greater than the number of children in the root model,
+     * %NULL is returned.
+     *
+     * Do not confuse this function with [method@Gtk.TreeListModel.get_row].
+     * @param position - position of the child to get
+     */
     getChildRow(position: number): TreeListRow | null;
+    /**
+     * Gets the root model that `self` was created with.
+     */
     getModel(): Gio.ListModel;
+    /**
+     * Gets whether the model is passing through original row items.
+     *
+     * If this function returns %FALSE, the `GListModel` functions for `self` return custom `GtkTreeListRow` objects. You need to call
+     * [method@Gtk.TreeListRow.get_item] on these objects to get the original
+     * item.
+     *
+     * If %TRUE, the values of the child models are passed through in their
+     * original state. You then need to call [method@Gtk.TreeListModel.get_row]
+     * to get the custom `GtkTreeListRow`s.
+     */
     getPassthrough(): boolean;
+    /**
+     * Gets the row object for the given row.
+     *
+     * If `position` is greater than the number of items in @self,
+     * %NULL is returned.
+     *
+     * The row object can be used to expand and collapse rows as
+     * well as to inspect its position in the tree. See its
+     * documentation for details.
+     *
+     * This row object is persistent and will refer to the current
+     * item as long as the row is present in @self, independent of
+     * other rows being added or removed.
+     *
+     * If `self` is set to not be passthrough, this function is
+     * equivalent to calling g_list_model_get_item().
+     *
+     * Do not confuse this function with [method@Gtk.TreeListModel.get_child_row].
+     * @param position - the position of the row to fetch
+     */
     getRow(position: number): TreeListRow | null;
+    /**
+     * Sets whether the model should autoexpand.
+     *
+     * If set to %TRUE, the model will recursively expand all rows that
+     * get added to the model. This can be either rows added by changes
+     * to the underlying models or via [method@Gtk.TreeListRow.set_expanded].
+     * @param autoexpand - %TRUE to make the model autoexpand its rows
+     */
     setAutoexpand(autoexpand: boolean): void;
     connect(signal: "notify", handler: (self: TreeListModel, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;

package/dist/generated/gtk/tree-list-model.js

@@ -3,6 +3,7 @@ import { getObject } from "@gtkx/ffi";
 import { TreeListRow } from "./tree-list-row.js";
 import * as GObject from "../gobject/index.js";
 import * as Gio from "../gio/index.js";
+/** A list model that can create child models on demand. */
 export class TreeListModel extends GObject.GObject {
     constructor(...args) {
         super(...args);
@@ -37,6 +38,13 @@ export class TreeListModel extends GObject.GObject {
             },
         ], { type: "gobject", borrowed: false });
     }
+    /**
+     * Gets whether the model is set to automatically expand new rows
+     * that get added.
+     *
+     * This can be either rows added by changes to the underlying
+     * models or via [method@Gtk.TreeListRow.set_expanded].
+     */
     getAutoexpand() {
         return call("libgtk-4.so.1", "gtk_tree_list_model_get_autoexpand", [
             {
@@ -45,6 +53,16 @@ export class TreeListModel extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Gets the row item corresponding to the child at index `position` for
+     * @self's root model.
+     *
+     * If `position` is greater than the number of children in the root model,
+     * %NULL is returned.
+     *
+     * Do not confuse this function with [method@Gtk.TreeListModel.get_row].
+     * @param position - position of the child to get
+     */
     getChildRow(position) {
         const ptr = call("libgtk-4.so.1", "gtk_tree_list_model_get_child_row", [
             {
@@ -60,6 +78,9 @@ export class TreeListModel extends GObject.GObject {
             return null;
         return getObject(ptr, TreeListRow);
     }
+    /**
+     * Gets the root model that `self` was created with.
+     */
     getModel() {
         const ptr = call("libgtk-4.so.1", "gtk_tree_list_model_get_model", [
             {
@@ -69,6 +90,17 @@ export class TreeListModel extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, Gio.ListModel);
     }
+    /**
+     * Gets whether the model is passing through original row items.
+     *
+     * If this function returns %FALSE, the `GListModel` functions for `self` return custom `GtkTreeListRow` objects. You need to call
+     * [method@Gtk.TreeListRow.get_item] on these objects to get the original
+     * item.
+     *
+     * If %TRUE, the values of the child models are passed through in their
+     * original state. You then need to call [method@Gtk.TreeListModel.get_row]
+     * to get the custom `GtkTreeListRow`s.
+     */
     getPassthrough() {
         return call("libgtk-4.so.1", "gtk_tree_list_model_get_passthrough", [
             {
@@ -77,6 +109,26 @@ export class TreeListModel extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Gets the row object for the given row.
+     *
+     * If `position` is greater than the number of items in @self,
+     * %NULL is returned.
+     *
+     * The row object can be used to expand and collapse rows as
+     * well as to inspect its position in the tree. See its
+     * documentation for details.
+     *
+     * This row object is persistent and will refer to the current
+     * item as long as the row is present in @self, independent of
+     * other rows being added or removed.
+     *
+     * If `self` is set to not be passthrough, this function is
+     * equivalent to calling g_list_model_get_item().
+     *
+     * Do not confuse this function with [method@Gtk.TreeListModel.get_child_row].
+     * @param position - the position of the row to fetch
+     */
     getRow(position) {
         const ptr = call("libgtk-4.so.1", "gtk_tree_list_model_get_row", [
             {
@@ -92,6 +144,14 @@ export class TreeListModel extends GObject.GObject {
             return null;
         return getObject(ptr, TreeListRow);
     }
+    /**
+     * Sets whether the model should autoexpand.
+     *
+     * If set to %TRUE, the model will recursively expand all rows that
+     * get added to the model. This can be either rows added by changes
+     * to the underlying models or via [method@Gtk.TreeListRow.set_expanded].
+     * @param autoexpand - %TRUE to make the model autoexpand its rows
+     */
     setAutoexpand(autoexpand) {
         call("libgtk-4.so.1", "gtk_tree_list_model_set_autoexpand", [
             {

package/dist/generated/gtk/tree-list-row-sorter.d.ts

@@ -1,10 +1,42 @@
 import * as GObject from "../gobject/index.js";
 import { Sorter } from "./sorter.js";
+/**
+ * Applies a gives sorter to the levels in a tree.
+ *
+ * Here is an example for setting up a column view with a tree model and
+ * a `GtkTreeListSorter`:
+ *
+ * ```c
+ * column_sorter = gtk_column_view_get_sorter (view);
+ * sorter = gtk_tree_list_row_sorter_new (g_object_ref (column_sorter));
+ * sort_model = gtk_sort_list_model_new (tree_model, sorter);
+ * selection = gtk_single_selection_new (sort_model);
+ * gtk_column_view_set_model (view, G_LIST_MODEL (selection));
+ * ```
+ */
 export declare class TreeListRowSorter extends Sorter {
+    /**
+     * Create a special-purpose sorter that applies the sorting
+     * of `sorter` to the levels of a `GtkTreeListModel`.
+     *
+     * Note that this sorter relies on [property@Gtk.TreeListModel:passthrough]
+     * being %FALSE as it can only sort [class@Gtk.TreeListRow]s.
+     * @param sorter - a `GtkSorter`
+     */
     constructor(sorter?: Sorter | null);
     constructor(...args: unknown[]);
     protected createPtr(args: unknown[]): unknown;
+    /**
+     * Returns the sorter used by @self.
+     */
     getSorter(): Sorter | null;
+    /**
+     * Sets the sorter to use for items with the same parent.
+     *
+     * This sorter will be passed the [property@Gtk.TreeListRow:item] of
+     * the tree list rows passed to @self.
+     * @param sorter - The sorter to use
+     */
     setSorter(sorter?: Sorter | null): void;
     connect(signal: "notify", handler: (self: TreeListRowSorter, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;