@girs/foundryadw-1 4.2.0 → 4.4.0

package/foundryadw-1.d.ts

@@ -31,6 +31,7 @@ import type Json from '@girs/json-1.0';
 import type GtkSource from '@girs/gtksource-5';
 import type Foundry from '@girs/foundry-1';
 import type Dex from '@girs/dex-1';
+import type GioUnix from '@girs/giounix-2.0';
 import type Adw from '@girs/adw-1';
 
 export namespace FoundryAdw {
@@ -102,6 +103,7 @@ export namespace FoundryAdw {
         /**
          * Gets the documentation for this navigator.
          * @returns a {@link Foundry.Documentation}
+         * @since 1.1
          */
         dup_documentation(): Foundry.Documentation;
     }
@@ -167,6 +169,7 @@ export namespace FoundryAdw {
         /**
          * Gets the file for this navigator.
          * @returns a {@link Gio.File}
+         * @since 1.1
          */
         dup_file(): Gio.File;
     }
@@ -227,9 +230,11 @@ export namespace FoundryAdw {
             "notify::vexpand-set": (pspec: GObject.ParamSpec) => void;
             "notify::visible": (pspec: GObject.ParamSpec) => void;
             "notify::width-request": (pspec: GObject.ParamSpec) => void;
+            "notify::complete-text": (pspec: GObject.ParamSpec) => void;
             "notify::cursor-position": (pspec: GObject.ParamSpec) => void;
             "notify::editable": (pspec: GObject.ParamSpec) => void;
             "notify::enable-undo": (pspec: GObject.ParamSpec) => void;
+            "notify::input-interceptor": (pspec: GObject.ParamSpec) => void;
             "notify::max-width-chars": (pspec: GObject.ParamSpec) => void;
             "notify::selection-bound": (pspec: GObject.ParamSpec) => void;
             "notify::text": (pspec: GObject.ParamSpec) => void;
@@ -305,6 +310,7 @@ export namespace FoundryAdw {
 
         /**
          * @returns the type of file that should be selected
+         * @since 1.1
          */
         get_file_type(): Gio.FileType;
 
@@ -320,9 +326,28 @@ export namespace FoundryAdw {
          * Changing this property while the user is selecting a file is
          * undefined behavior.
          * @param file_type the type of file to select
+         * @since 1.1
          */
         set_file_type(file_type: Gio.FileType): void;
 
+        /**
+         * The contents of the entry, including uncommited content such as the
+         * preedit.
+         * @since 4.24
+         * @read-only
+          * @category Inherited from Gtk.Editable
+         */
+        get complete_text(): string;
+
+        /**
+         * The contents of the entry, including uncommited content such as the
+         * preedit.
+         * @since 4.24
+         * @read-only
+          * @category Inherited from Gtk.Editable
+         */
+        get completeText(): string;
+
         /**
          * The current position of the insertion cursor in chars.
          * @read-only
@@ -363,6 +388,22 @@ export namespace FoundryAdw {
         get enableUndo(): boolean;
         set enableUndo(val: boolean);
 
+        /**
+         * The widget used to intercept input for this editable
+         * @since 4.24
+          * @category Inherited from Gtk.Editable
+         */
+        get input_interceptor(): Gtk.Widget | null;
+        set input_interceptor(val: Gtk.Widget | null);
+
+        /**
+         * The widget used to intercept input for this editable
+         * @since 4.24
+          * @category Inherited from Gtk.Editable
+         */
+        get inputInterceptor(): Gtk.Widget | null;
+        set inputInterceptor(val: Gtk.Widget | null);
+
         /**
          * The desired maximum width of the entry, in characters.
          * @default -1
@@ -463,13 +504,14 @@ export namespace FoundryAdw {
          * change your tree to allow this function to work.
          * @param state what kind of accessible state to retrieve
          * @returns the accessible platform state of the delegate
+         * @since 4.10
          */
         delegate_get_accessible_platform_state(state: Gtk.AccessiblePlatformState): boolean;
 
         /**
          * Deletes the currently selected text of the editable.
          * 
-         * This call doesn’t do anything if there is no selected text.
+         * This call doesn’t do anything if there is no selected text.
          */
         delete_selection(): void;
 
@@ -516,6 +558,14 @@ export namespace FoundryAdw {
          */
         get_chars(start_pos: number, end_pos: number): string;
 
+        /**
+         * Retrieves the contents of `editable`, including *pseudo-content*
+         * such as the preedit buffer.
+         * @returns the complete contents of the editable
+         * @since 4.24
+         */
+        get_complete_text(): string;
+
         /**
          * Gets the {@link Gtk.Editable} that `editable` is delegating its
          * implementation to.
@@ -537,6 +587,14 @@ export namespace FoundryAdw {
          */
         get_enable_undo(): boolean;
 
+        /**
+         * Retrieves the widget that was previously set up as input interceptor
+         * for `editable`. See {@link Gtk.Editable.set_input_interceptor}.
+         * @returns The editable widget
+         * @since 4.24
+         */
+        get_input_interceptor(): Gtk.Widget | null;
+
         /**
          * Retrieves the desired maximum width of `editable`, in characters.
          * @returns the maximum width of the entry, in characters
@@ -643,6 +701,22 @@ export namespace FoundryAdw {
          */
         set_enable_undo(enable_undo: boolean): void;
 
+        /**
+         * Sets `interceptor` as the widget that `editable` will intercept key events from.
+         * 
+         * A typical usecase for this is implementing auto-showing search entries, so
+         * that textual input may be intercepted from another widget and handled first
+         * hand by the given editable. The events will be handled in the bubble phase
+         * of `interceptor`, which means that editable child widgets of `interceptor` will
+         * receive the text input before it can be captured.
+         * 
+         * Only those events that would be handled by an input method will be handled,
+         * this excludes combinations of Ctrl/Alt/Mod, and other shortcuts.
+         * @param interceptor the input interceptor widget
+         * @since 4.24
+         */
+        set_input_interceptor(interceptor: Gtk.Widget | null): void;
+
         /**
          * Sets the desired maximum width in characters of `editable`.
          * @param n_chars the new desired maximum width, in characters
@@ -729,6 +803,14 @@ export namespace FoundryAdw {
          */
         vfunc_do_insert_text(text: string, length: number, position: number): number;
 
+        /**
+         * Retrieves the contents of `editable`, including *pseudo-content*
+         * such as the preedit buffer.
+         * @since 4.24
+         * @virtual
+         */
+        vfunc_get_complete_text(): string;
+
         /**
          * Gets the {@link Gtk.Editable} that `editable` is delegating its
          * implementation to.
@@ -1038,6 +1120,7 @@ export namespace FoundryAdw {
         /**
          * Gets whether the page needs attention from the user.
          * @returns `true` if the page needs attention, `false` otherwise
+         * @since 1.1
          */
         get_needs_attention(): boolean;
 
@@ -1047,6 +1130,7 @@ export namespace FoundryAdw {
          * Requests that the page be closed as if the user clicked the close button
          * on an AdwTabBar. This will trigger the close-page signal handler which
          * performs the actual cleanup.
+         * @since 1.1
          */
         request_close(): void;
 
@@ -1080,6 +1164,7 @@ export namespace FoundryAdw {
          * something that requires user attention. The property is automatically
          * cleared when focus enters the page.
          * @param needs_attention whether the page needs attention
+         * @since 1.1
          */
         set_needs_attention(needs_attention: boolean): void;
 
@@ -1115,6 +1200,7 @@ export namespace FoundryAdw {
          * does not interrupts the user's current screen reader output.
          * @param message the string to announce
          * @param priority the priority of the announcement
+         * @since 4.14
          */
         announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
 
@@ -1127,6 +1213,7 @@ export namespace FoundryAdw {
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
          * @returns the accessible identifier
+         * @since 4.22
          */
         get_accessible_id(): string | null;
 
@@ -1135,6 +1222,7 @@ export namespace FoundryAdw {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -1147,6 +1235,7 @@ export namespace FoundryAdw {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -1157,18 +1246,21 @@ export namespace FoundryAdw {
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
          * @returns true if the bounds are valid, and false otherwise
+         * @since 4.10
          */
         get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
          * @returns the first accessible child
+         * @since 4.10
          */
         get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
          * @returns the next accessible sibling
+         * @since 4.10
          */
         get_next_accessible_sibling(): Gtk.Accessible | null;
 
@@ -1180,6 +1272,7 @@ export namespace FoundryAdw {
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
          * @returns the value of state for the accessible
+         * @since 4.10
          */
         get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
 
@@ -1213,6 +1306,7 @@ export namespace FoundryAdw {
          * object is the container widget.
          * @param parent the parent accessible object
          * @param next_sibling the sibling accessible object
+         * @since 4.10
          */
         set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
 
@@ -1222,6 +1316,7 @@ export namespace FoundryAdw {
          * That might be useful when a new child of a custom accessible
          * is created, and it needs to be linked to a previous child.
          * @param new_sibling the new next accessible sibling to set
+         * @since 4.10
          */
         update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
 
@@ -1232,6 +1327,7 @@ export namespace FoundryAdw {
          * have a platform state but are not widgets. Widgets handle platform
          * states automatically.
          * @param state the platform state to update
+         * @since 4.18
          */
         update_platform_state(state: Gtk.AccessiblePlatformState): void;
 
@@ -1279,6 +1375,7 @@ export namespace FoundryAdw {
          * 
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
+         * @since 4.22
          * @virtual
          */
         vfunc_get_accessible_id(): string | null;
@@ -1287,12 +1384,14 @@ export namespace FoundryAdw {
          * Retrieves the accessible parent for an accessible object.
          * 
          * This function returns `NULL` for top level widgets.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_accessible_parent(): Gtk.Accessible | null;
 
         /**
          * Retrieves the implementation for the given accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_at_context(): Gtk.ATContext | null;
@@ -1303,18 +1402,21 @@ export namespace FoundryAdw {
          * This functionality can be overridden by {@link Gtk.Accessible}
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
+         * @since 4.10
          * @virtual
          */
         vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -1326,6 +1428,7 @@ export namespace FoundryAdw {
          * implementations, e.g. to get platform state from an ignored
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
+         * @since 4.10
          * @virtual
          */
         vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -1421,7 +1524,7 @@ export namespace FoundryAdw {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of “ID” and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual
@@ -1594,6 +1697,7 @@ export namespace FoundryAdw {
         /**
          * Gets whether the panel needs attention from the user.
          * @returns `true` if the panel needs attention, `false` otherwise
+         * @since 1.1
          */
         get_needs_attention(): boolean;
 
@@ -1629,6 +1733,7 @@ export namespace FoundryAdw {
          * something that requires user attention. The property is automatically
          * cleared when focus enters the panel.
          * @param needs_attention whether the panel needs attention
+         * @since 1.1
          */
         set_needs_attention(needs_attention: boolean): void;
 
@@ -1669,6 +1774,7 @@ export namespace FoundryAdw {
          * does not interrupts the user's current screen reader output.
          * @param message the string to announce
          * @param priority the priority of the announcement
+         * @since 4.14
          */
         announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
 
@@ -1681,6 +1787,7 @@ export namespace FoundryAdw {
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
          * @returns the accessible identifier
+         * @since 4.22
          */
         get_accessible_id(): string | null;
 
@@ -1689,6 +1796,7 @@ export namespace FoundryAdw {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -1701,6 +1809,7 @@ export namespace FoundryAdw {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -1711,18 +1820,21 @@ export namespace FoundryAdw {
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
          * @returns true if the bounds are valid, and false otherwise
+         * @since 4.10
          */
         get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
          * @returns the first accessible child
+         * @since 4.10
          */
         get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
          * @returns the next accessible sibling
+         * @since 4.10
          */
         get_next_accessible_sibling(): Gtk.Accessible | null;
 
@@ -1734,6 +1846,7 @@ export namespace FoundryAdw {
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
          * @returns the value of state for the accessible
+         * @since 4.10
          */
         get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
 
@@ -1767,6 +1880,7 @@ export namespace FoundryAdw {
          * object is the container widget.
          * @param parent the parent accessible object
          * @param next_sibling the sibling accessible object
+         * @since 4.10
          */
         set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
 
@@ -1776,6 +1890,7 @@ export namespace FoundryAdw {
          * That might be useful when a new child of a custom accessible
          * is created, and it needs to be linked to a previous child.
          * @param new_sibling the new next accessible sibling to set
+         * @since 4.10
          */
         update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
 
@@ -1786,6 +1901,7 @@ export namespace FoundryAdw {
          * have a platform state but are not widgets. Widgets handle platform
          * states automatically.
          * @param state the platform state to update
+         * @since 4.18
          */
         update_platform_state(state: Gtk.AccessiblePlatformState): void;
 
@@ -1833,6 +1949,7 @@ export namespace FoundryAdw {
          * 
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
+         * @since 4.22
          * @virtual
          */
         vfunc_get_accessible_id(): string | null;
@@ -1841,12 +1958,14 @@ export namespace FoundryAdw {
          * Retrieves the accessible parent for an accessible object.
          * 
          * This function returns `NULL` for top level widgets.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_accessible_parent(): Gtk.Accessible | null;
 
         /**
          * Retrieves the implementation for the given accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_at_context(): Gtk.ATContext | null;
@@ -1857,18 +1976,21 @@ export namespace FoundryAdw {
          * This functionality can be overridden by {@link Gtk.Accessible}
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
+         * @since 4.10
          * @virtual
          */
         vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -1880,6 +2002,7 @@ export namespace FoundryAdw {
          * implementations, e.g. to get platform state from an ignored
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
+         * @since 4.10
          * @virtual
          */
         vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -1975,7 +2098,7 @@ export namespace FoundryAdw {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of “ID” and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual
@@ -2155,6 +2278,7 @@ export namespace FoundryAdw {
          * does not interrupts the user's current screen reader output.
          * @param message the string to announce
          * @param priority the priority of the announcement
+         * @since 4.14
          */
         announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
 
@@ -2167,6 +2291,7 @@ export namespace FoundryAdw {
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
          * @returns the accessible identifier
+         * @since 4.22
          */
         get_accessible_id(): string | null;
 
@@ -2175,6 +2300,7 @@ export namespace FoundryAdw {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -2187,6 +2313,7 @@ export namespace FoundryAdw {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -2197,18 +2324,21 @@ export namespace FoundryAdw {
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
          * @returns true if the bounds are valid, and false otherwise
+         * @since 4.10
          */
         get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
          * @returns the first accessible child
+         * @since 4.10
          */
         get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
          * @returns the next accessible sibling
+         * @since 4.10
          */
         get_next_accessible_sibling(): Gtk.Accessible | null;
 
@@ -2220,6 +2350,7 @@ export namespace FoundryAdw {
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
          * @returns the value of state for the accessible
+         * @since 4.10
          */
         get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
 
@@ -2253,6 +2384,7 @@ export namespace FoundryAdw {
          * object is the container widget.
          * @param parent the parent accessible object
          * @param next_sibling the sibling accessible object
+         * @since 4.10
          */
         set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
 
@@ -2262,6 +2394,7 @@ export namespace FoundryAdw {
          * That might be useful when a new child of a custom accessible
          * is created, and it needs to be linked to a previous child.
          * @param new_sibling the new next accessible sibling to set
+         * @since 4.10
          */
         update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
 
@@ -2272,6 +2405,7 @@ export namespace FoundryAdw {
          * have a platform state but are not widgets. Widgets handle platform
          * states automatically.
          * @param state the platform state to update
+         * @since 4.18
          */
         update_platform_state(state: Gtk.AccessiblePlatformState): void;
 
@@ -2319,6 +2453,7 @@ export namespace FoundryAdw {
          * 
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
+         * @since 4.22
          * @virtual
          */
         vfunc_get_accessible_id(): string | null;
@@ -2327,12 +2462,14 @@ export namespace FoundryAdw {
          * Retrieves the accessible parent for an accessible object.
          * 
          * This function returns `NULL` for top level widgets.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_accessible_parent(): Gtk.Accessible | null;
 
         /**
          * Retrieves the implementation for the given accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_at_context(): Gtk.ATContext | null;
@@ -2343,18 +2480,21 @@ export namespace FoundryAdw {
          * This functionality can be overridden by {@link Gtk.Accessible}
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
+         * @since 4.10
          * @virtual
          */
         vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -2366,6 +2506,7 @@ export namespace FoundryAdw {
          * implementations, e.g. to get platform state from an ignored
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
+         * @since 4.10
          * @virtual
          */
         vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -2461,7 +2602,7 @@ export namespace FoundryAdw {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of “ID” and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual
@@ -2568,8 +2709,14 @@ export namespace FoundryAdw {
         emit(signal: string, ...args: any[]): void;
 
         // Methods
+        /**
+         * @since 1.1
+         */
         dup_root(): PathNavigator | null;
 
+        /**
+         * @since 1.1
+         */
         get_selected_item(): PathNavigator | null;
 
         /**
@@ -2577,6 +2724,7 @@ export namespace FoundryAdw {
          * selected-item in the pathbar. This is useful for synthesized roots
          * that you always want to show.
          * @param root a root navigator
+         * @since 1.1
          */
         set_root(root: PathNavigator | null): void;
 
@@ -2617,6 +2765,7 @@ export namespace FoundryAdw {
          * does not interrupts the user's current screen reader output.
          * @param message the string to announce
          * @param priority the priority of the announcement
+         * @since 4.14
          */
         announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
 
@@ -2629,6 +2778,7 @@ export namespace FoundryAdw {
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
          * @returns the accessible identifier
+         * @since 4.22
          */
         get_accessible_id(): string | null;
 
@@ -2637,6 +2787,7 @@ export namespace FoundryAdw {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -2649,6 +2800,7 @@ export namespace FoundryAdw {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -2659,18 +2811,21 @@ export namespace FoundryAdw {
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
          * @returns true if the bounds are valid, and false otherwise
+         * @since 4.10
          */
         get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
          * @returns the first accessible child
+         * @since 4.10
          */
         get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
          * @returns the next accessible sibling
+         * @since 4.10
          */
         get_next_accessible_sibling(): Gtk.Accessible | null;
 
@@ -2682,6 +2837,7 @@ export namespace FoundryAdw {
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
          * @returns the value of state for the accessible
+         * @since 4.10
          */
         get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
 
@@ -2715,6 +2871,7 @@ export namespace FoundryAdw {
          * object is the container widget.
          * @param parent the parent accessible object
          * @param next_sibling the sibling accessible object
+         * @since 4.10
          */
         set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
 
@@ -2724,6 +2881,7 @@ export namespace FoundryAdw {
          * That might be useful when a new child of a custom accessible
          * is created, and it needs to be linked to a previous child.
          * @param new_sibling the new next accessible sibling to set
+         * @since 4.10
          */
         update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
 
@@ -2734,6 +2892,7 @@ export namespace FoundryAdw {
          * have a platform state but are not widgets. Widgets handle platform
          * states automatically.
          * @param state the platform state to update
+         * @since 4.18
          */
         update_platform_state(state: Gtk.AccessiblePlatformState): void;
 
@@ -2781,6 +2940,7 @@ export namespace FoundryAdw {
          * 
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
+         * @since 4.22
          * @virtual
          */
         vfunc_get_accessible_id(): string | null;
@@ -2789,12 +2949,14 @@ export namespace FoundryAdw {
          * Retrieves the accessible parent for an accessible object.
          * 
          * This function returns `NULL` for top level widgets.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_accessible_parent(): Gtk.Accessible | null;
 
         /**
          * Retrieves the implementation for the given accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_at_context(): Gtk.ATContext | null;
@@ -2805,18 +2967,21 @@ export namespace FoundryAdw {
          * This functionality can be overridden by {@link Gtk.Accessible}
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
+         * @since 4.10
          * @virtual
          */
         vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -2828,6 +2993,7 @@ export namespace FoundryAdw {
          * implementations, e.g. to get platform state from an ignored
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
+         * @since 4.10
          * @virtual
          */
         vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -2923,7 +3089,7 @@ export namespace FoundryAdw {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of “ID” and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual
@@ -3000,59 +3166,75 @@ export namespace FoundryAdw {
 
         // Virtual methods
         /**
+         * @since 1.1
          * @virtual
          */
         vfunc_dup_icon(): Gio.Icon | null;
 
         /**
          * Gets an intent that can be used to navigate to this path navigator.
+         * @since 1.1
          * @virtual
          */
         vfunc_dup_intent(): Foundry.Intent | null;
 
         /**
+         * @since 1.1
          * @virtual
          */
         vfunc_dup_title(): string | null;
 
         /**
+         * @since 1.1
          * @virtual
          */
         vfunc_find_parent(): Dex.Future;
 
         /**
+         * @since 1.1
          * @virtual
          */
         vfunc_list_children(): Dex.Future;
 
         /**
+         * @since 1.1
          * @virtual
          */
         vfunc_list_siblings(): Dex.Future;
 
         // Methods
+        /**
+         * @since 1.1
+         */
         dup_icon(): Gio.Icon | null;
 
         /**
          * Gets an intent that can be used to navigate to this path navigator.
          * @returns a {@link Foundry.Intent} or `null`
+         * @since 1.1
          */
         dup_intent(): Foundry.Intent | null;
 
+        /**
+         * @since 1.1
+         */
         dup_title(): string | null;
 
         /**
          * @returns a {@link Dex.Future} that resolves   to a {@link FoundryAdw.PathNavigator} or rejects with error.
+         * @since 1.1
          */
         find_parent(): Dex.Future;
 
         /**
          * @returns a {@link Dex.Future} that resolves   to a {@link FoundryAdw.PathNavigator} or rejects with error.
+         * @since 1.1
          */
         list_children(): Dex.Future;
 
         /**
          * @returns a {@link Dex.Future} that resolves   to a {@link FoundryAdw.PathNavigator} or rejects with error.
+         * @since 1.1
          */
         list_siblings(): Dex.Future;
 
@@ -3064,6 +3246,7 @@ export namespace FoundryAdw {
          * The root navigator is placed at position 0 and `self` is placed in the last
          * position.
          * @returns a {@link Dex.Future} that resolves to a   {@link Gio.ListModel} of {@link FoundryAdw.PathNavigator}.
+         * @since 1.1
          */
         list_to_root(): Dex.Future;
     }
@@ -3265,6 +3448,7 @@ export namespace FoundryAdw {
         /**
          * Gets the symbol for this navigator.
          * @returns a {@link Foundry.Symbol}
+         * @since 1.1
          */
         dup_symbol(): Foundry.Symbol;
     }
@@ -3526,6 +3710,7 @@ export namespace FoundryAdw {
          * Gets whether clicking on the expander activates the row instead of
          * expanding or collapsing it.
          * @returns `true` if clicks activate the row, `false` otherwise
+         * @since 1.1
          */
         get_activate_on_click(): boolean;
 
@@ -3538,6 +3723,7 @@ export namespace FoundryAdw {
         /**
          * Gets the paintable for the row when expanded.
          * @returns a {@link Gdk.Paintable} or `null`
+         * @since 1.1
          */
         get_expanded_paintable(): Gdk.Paintable | null;
 
@@ -3570,6 +3756,7 @@ export namespace FoundryAdw {
         /**
          * Gets the paintable for the row.
          * @returns a {@link Gdk.Paintable} or `null`
+         * @since 1.1
          */
         get_paintable(): Gdk.Paintable | null;
 
@@ -3591,6 +3778,7 @@ export namespace FoundryAdw {
          * where rows are automatically expanded and collapsed as needed, and
          * clicks should instead activate the row.
          * @param activate_on_click whether clicks should activate the row
+         * @since 1.1
          */
         set_activate_on_click(activate_on_click: boolean): void;
 
@@ -3610,6 +3798,7 @@ export namespace FoundryAdw {
          * If set, this paintable will be preferred over the expanded-icon/expanded-icon-name
          * properties.
          * @param expanded_paintable a {@link Gdk.Paintable} or `null`
+         * @since 1.1
          */
         set_expanded_paintable(expanded_paintable: Gdk.Paintable | null): void;
 
@@ -3644,6 +3833,7 @@ export namespace FoundryAdw {
          * If set, this paintable will be preferred over the icon/icon-name
          * properties.
          * @param paintable a {@link Gdk.Paintable} or `null`
+         * @since 1.1
          */
         set_paintable(paintable: Gdk.Paintable | null): void;
 
@@ -3699,6 +3889,7 @@ export namespace FoundryAdw {
          * does not interrupts the user's current screen reader output.
          * @param message the string to announce
          * @param priority the priority of the announcement
+         * @since 4.14
          */
         announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
 
@@ -3711,6 +3902,7 @@ export namespace FoundryAdw {
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
          * @returns the accessible identifier
+         * @since 4.22
          */
         get_accessible_id(): string | null;
 
@@ -3719,6 +3911,7 @@ export namespace FoundryAdw {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -3731,6 +3924,7 @@ export namespace FoundryAdw {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -3741,18 +3935,21 @@ export namespace FoundryAdw {
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
          * @returns true if the bounds are valid, and false otherwise
+         * @since 4.10
          */
         get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
          * @returns the first accessible child
+         * @since 4.10
          */
         get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
          * @returns the next accessible sibling
+         * @since 4.10
          */
         get_next_accessible_sibling(): Gtk.Accessible | null;
 
@@ -3764,6 +3961,7 @@ export namespace FoundryAdw {
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
          * @returns the value of state for the accessible
+         * @since 4.10
          */
         get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
 
@@ -3797,6 +3995,7 @@ export namespace FoundryAdw {
          * object is the container widget.
          * @param parent the parent accessible object
          * @param next_sibling the sibling accessible object
+         * @since 4.10
          */
         set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
 
@@ -3806,6 +4005,7 @@ export namespace FoundryAdw {
          * That might be useful when a new child of a custom accessible
          * is created, and it needs to be linked to a previous child.
          * @param new_sibling the new next accessible sibling to set
+         * @since 4.10
          */
         update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
 
@@ -3816,6 +4016,7 @@ export namespace FoundryAdw {
          * have a platform state but are not widgets. Widgets handle platform
          * states automatically.
          * @param state the platform state to update
+         * @since 4.18
          */
         update_platform_state(state: Gtk.AccessiblePlatformState): void;
 
@@ -3863,6 +4064,7 @@ export namespace FoundryAdw {
          * 
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
+         * @since 4.22
          * @virtual
          */
         vfunc_get_accessible_id(): string | null;
@@ -3871,12 +4073,14 @@ export namespace FoundryAdw {
          * Retrieves the accessible parent for an accessible object.
          * 
          * This function returns `NULL` for top level widgets.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_accessible_parent(): Gtk.Accessible | null;
 
         /**
          * Retrieves the implementation for the given accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_at_context(): Gtk.ATContext | null;
@@ -3887,18 +4091,21 @@ export namespace FoundryAdw {
          * This functionality can be overridden by {@link Gtk.Accessible}
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
+         * @since 4.10
          * @virtual
          */
         vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -3910,6 +4117,7 @@ export namespace FoundryAdw {
          * implementations, e.g. to get platform state from an ignored
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
+         * @since 4.10
          * @virtual
          */
         vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -4005,7 +4213,7 @@ export namespace FoundryAdw {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of “ID” and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual
@@ -4252,6 +4460,7 @@ export namespace FoundryAdw {
          * Find the first page matching `page_type`.
          * @param page_type 
          * @returns the first page that matches, or `null`
+         * @since 1.1
          */
         find_page_typed(page_type: GObject.GType): Page | null;
 
@@ -4259,6 +4468,7 @@ export namespace FoundryAdw {
          * Find the first panel matching `id`.
          * @param id the panel ID to search for
          * @returns the first panel that matches, or `null`
+         * @since 1.1
          */
         find_panel_by_id(id: string): Panel | null;
 
@@ -4279,6 +4489,7 @@ export namespace FoundryAdw {
         /**
          * Gets the auxiliary placeholder widget.
          * @returns the auxiliary placeholder widget
+         * @since 1.1
          */
         get_auxiliary_placeholder(): Gtk.Widget | null;
 
@@ -4297,6 +4508,7 @@ export namespace FoundryAdw {
         /**
          * Gets if the active page has an auxiliary widget.
          * @returns `true` if there is an auxiliary page to display.
+         * @since 1.1
          */
         get_has_auxiliary(): boolean;
 
@@ -4336,6 +4548,7 @@ export namespace FoundryAdw {
         /**
          * Sets the auxiliary placeholder widget.
          * @param placeholder the auxiliary placeholder widget
+         * @since 1.1
          */
         set_auxiliary_placeholder(placeholder: Gtk.Widget | null): void;
 
@@ -4419,6 +4632,7 @@ export namespace FoundryAdw {
          * does not interrupts the user's current screen reader output.
          * @param message the string to announce
          * @param priority the priority of the announcement
+         * @since 4.14
          */
         announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
 
@@ -4431,6 +4645,7 @@ export namespace FoundryAdw {
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
          * @returns the accessible identifier
+         * @since 4.22
          */
         get_accessible_id(): string | null;
 
@@ -4439,6 +4654,7 @@ export namespace FoundryAdw {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -4451,6 +4667,7 @@ export namespace FoundryAdw {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -4461,18 +4678,21 @@ export namespace FoundryAdw {
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
          * @returns true if the bounds are valid, and false otherwise
+         * @since 4.10
          */
         get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
          * @returns the first accessible child
+         * @since 4.10
          */
         get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
          * @returns the next accessible sibling
+         * @since 4.10
          */
         get_next_accessible_sibling(): Gtk.Accessible | null;
 
@@ -4484,6 +4704,7 @@ export namespace FoundryAdw {
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
          * @returns the value of state for the accessible
+         * @since 4.10
          */
         get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
 
@@ -4517,6 +4738,7 @@ export namespace FoundryAdw {
          * object is the container widget.
          * @param parent the parent accessible object
          * @param next_sibling the sibling accessible object
+         * @since 4.10
          */
         set_accessible_parent(parent: Gtk.Accessible | null, next_sibling: Gtk.Accessible | null): void;
 
@@ -4526,6 +4748,7 @@ export namespace FoundryAdw {
          * That might be useful when a new child of a custom accessible
          * is created, and it needs to be linked to a previous child.
          * @param new_sibling the new next accessible sibling to set
+         * @since 4.10
          */
         update_next_accessible_sibling(new_sibling: Gtk.Accessible | null): void;
 
@@ -4536,6 +4759,7 @@ export namespace FoundryAdw {
          * have a platform state but are not widgets. Widgets handle platform
          * states automatically.
          * @param state the platform state to update
+         * @since 4.18
          */
         update_platform_state(state: Gtk.AccessiblePlatformState): void;
 
@@ -4583,6 +4807,7 @@ export namespace FoundryAdw {
          * 
          * It is left to the accessible implementation to define the scope
          * and uniqueness of the identifier.
+         * @since 4.22
          * @virtual
          */
         vfunc_get_accessible_id(): string | null;
@@ -4591,12 +4816,14 @@ export namespace FoundryAdw {
          * Retrieves the accessible parent for an accessible object.
          * 
          * This function returns `NULL` for top level widgets.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_accessible_parent(): Gtk.Accessible | null;
 
         /**
          * Retrieves the implementation for the given accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_at_context(): Gtk.ATContext | null;
@@ -4607,18 +4834,21 @@ export namespace FoundryAdw {
          * This functionality can be overridden by {@link Gtk.Accessible}
          * implementations, e.g. to get the bounds from an ignored
          * child widget.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_bounds(): [boolean, number, number, number, number];
 
         /**
          * Retrieves the first accessible child of an accessible object.
+         * @since 4.10
          * @virtual
          */
         vfunc_get_first_accessible_child(): Gtk.Accessible | null;
 
         /**
          * Retrieves the next accessible sibling of an accessible object
+         * @since 4.10
          * @virtual
          */
         vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
@@ -4630,6 +4860,7 @@ export namespace FoundryAdw {
          * implementations, e.g. to get platform state from an ignored
          * child widget, as is the case for {@link Gtk.Text} wrappers.
          * @param state platform state to query
+         * @since 4.10
          * @virtual
          */
         vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
@@ -4725,7 +4956,7 @@ export namespace FoundryAdw {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of “ID” and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual