@girs/gtksource-5 4.3.0 → 4.4.0

package/README.md

@@ -5,7 +5,7 @@
 ![downloads/week](https://img.shields.io/npm/dw/@girs/gtksource-5)
 
 
-GJS TypeScript type definitions for GtkSource-5, generated from library version 5.21.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.3.0.
+GJS TypeScript type definitions for GtkSource-5, generated from library version 5.21.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.4.0.
 
 ## Install
 

package/gtksource-5-surface.d.ts

@@ -288,6 +288,23 @@ export interface Widgets {
 /** Every GType this namespace can create. A consumer derives its own tag map. */
 export type WidgetGType = keyof Widgets;
 
+// ---------------------------------------------------------------------------
+// Child holders — the same shape, for objects that CARRY a widget without being one.
+//
+// `GtkListItem`, `GtkListHeader`, `GtkColumnViewCell` and `AdwToggle` descend from
+// `GObject.Object` and hold a widget through `set_child`/`get_child`. A renderer places
+// them exactly like a container, so they belong in the vocabulary; a check asking "is
+// this a widget" must still be able to say no. Hence a sibling table rather than four
+// more rows in `Widgets`: concatenate them when you mean both.
+// ---------------------------------------------------------------------------
+
+export interface ChildHolders {
+
+}
+
+/** Every GType this namespace holds a child in without it being a widget. */
+export type ChildHolderGType = keyof ChildHolders;
+
 /** The writable, optional, GObject-keyed property surface of one GType. */
 export type PropsOf<G extends WidgetGType> = Widgets[G]['props'];
 
@@ -323,6 +340,9 @@ export const OWN_SIGNALS: Readonly<Record<string, readonly string[]>>;
 /** Widget GType -> every declaration its members come from, self first. */
 export const DECLS: Readonly<Record<string, readonly string[]>>;
 
+/** The GTypes in `DECLS` that hold a widget without being one — see `ChildHolders`. */
+export const CHILD_HOLDERS: readonly string[];
+
 /** Enum GType -> the nicks this surface offers. */
 export const ENUM_NICKS: Readonly<Record<string, readonly string[]>>;
 

package/gtksource-5-surface.js

@@ -38,6 +38,12 @@ export const DECLS = {
     GtkSourceView: ['GtkSourceView', 'GtkTextView', 'GtkWidget', 'GtkAccessible', 'GtkAccessibleText', 'GtkBuildable', 'GtkConstraintTarget', 'GtkScrollable'],
 };
 
+// The GTypes above that are NOT widgets: they hold one through `set_child`/`get_child`
+// and descend from `GObject.Object`. A renderer places them like a container; a check
+// asking "is this a widget" must not count them. Derived from the accessor pair, never
+// from a list — the count is in the provenance line above.
+export const CHILD_HOLDERS = [];
+
 export const ENUM_NICKS = {
     GtkSourceAnnotationStyle: ['none', 'warning', 'error', 'accent'],
     GtkSourceBackgroundPatternType: ['none', 'grid'],

package/gtksource-5.d.ts

@@ -909,6 +909,7 @@ export namespace GtkSource {
          * @param display a {@link GtkSource.HoverDisplay} to populate
          * @param cancellable 
          * @param callback 
+         * @since 5.18
          * @virtual
          */
         vfunc_populate_hover_async(annotation: Annotation, display: HoverDisplay, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
@@ -916,6 +917,7 @@ export namespace GtkSource {
         /**
          * Finishes populating the {@link HoverDisplay} asynchronously.
          * @param result 
+         * @since 5.18
          * @virtual
          */
         vfunc_populate_hover_finish(result: Gio.AsyncResult): boolean;
@@ -924,6 +926,7 @@ export namespace GtkSource {
         /**
          * Add an annotation to the provider.
          * @param annotation 
+         * @since 5.18
          */
         add_annotation(annotation: Annotation): void;
 
@@ -933,6 +936,7 @@ export namespace GtkSource {
          * @param annotation a {@link GtkSource.Annotation}
          * @param display a {@link GtkSource.HoverDisplay} to populate
          * @param cancellable 
+         * @since 5.18
          */
         populate_hover_async(annotation: Annotation, display: HoverDisplay, cancellable: Gio.Cancellable | null): globalThis.Promise<boolean>;
 
@@ -943,6 +947,7 @@ export namespace GtkSource {
          * @param display a {@link GtkSource.HoverDisplay} to populate
          * @param cancellable 
          * @param callback 
+         * @since 5.18
          */
         populate_hover_async(annotation: Annotation, display: HoverDisplay, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
 
@@ -953,6 +958,7 @@ export namespace GtkSource {
          * @param display a {@link GtkSource.HoverDisplay} to populate
          * @param cancellable 
          * @param callback 
+         * @since 5.18
          */
         populate_hover_async(annotation: Annotation, display: HoverDisplay, cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<boolean> | void;
 
@@ -960,11 +966,13 @@ export namespace GtkSource {
          * Finishes populating the {@link HoverDisplay} asynchronously.
          * @param result 
          * @returns `true` if successful; otherwise `false` and `error` is set.
+         * @since 5.18
          */
         populate_hover_finish(result: Gio.AsyncResult): boolean;
 
         /**
          * Removes all annotations from the provider.
+         * @since 5.18
          */
         remove_all(): void;
 
@@ -972,6 +980,7 @@ export namespace GtkSource {
          * Remove an annotation from the provider.
          * @param annotation 
          * @returns `true` if the annotation was found and removed
+         * @since 5.18
          */
         remove_annotation(annotation: Annotation): boolean;
     }
@@ -1426,6 +1435,7 @@ export namespace GtkSource {
          * @param start start of range as a {@link Gtk.TextIter}
          * @param end end of range as a {@link Gtk.TextIter}
          * @returns a newly-allocated string containing the text   with Pango markup, or `null` if `start` and `end` are invalid.
+         * @since 5.18
          */
         get_markup(start: Gtk.TextIter, end: Gtk.TextIter): string;
 
@@ -2080,6 +2090,7 @@ export namespace GtkSource {
          * 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;
 
@@ -2092,6 +2103,7 @@ export namespace GtkSource {
          * 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;
 
@@ -2100,6 +2112,7 @@ export namespace GtkSource {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -2112,6 +2125,7 @@ export namespace GtkSource {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -2122,18 +2136,21 @@ export namespace GtkSource {
          * 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;
 
@@ -2145,6 +2162,7 @@ export namespace GtkSource {
          * 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;
 
@@ -2178,6 +2196,7 @@ export namespace GtkSource {
          * 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;
 
@@ -2187,6 +2206,7 @@ export namespace GtkSource {
          * 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;
 
@@ -2197,6 +2217,7 @@ export namespace GtkSource {
          * 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;
 
@@ -2244,6 +2265,7 @@ export namespace GtkSource {
          * 
          * 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;
@@ -2252,12 +2274,14 @@ export namespace GtkSource {
          * 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;
@@ -2268,18 +2292,21 @@ export namespace GtkSource {
          * 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;
@@ -2291,6 +2318,7 @@ export namespace GtkSource {
          * 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;
@@ -2560,6 +2588,7 @@ export namespace GtkSource {
          * notifications about when the model has been replaced by a new model.
          * @param provider a {@link GtkSource.CompletionProvider}
          * @returns a {@link Gio.ListModel} or `null`
+         * @since 5.6
          */
         get_proposals_for_provider(provider: CompletionProvider): Gio.ListModel | null;
 
@@ -2578,6 +2607,7 @@ export namespace GtkSource {
         /**
          * Gets the providers that are associated with the context.
          * @returns a {@link Gio.ListModel} of {@link GtkSource.CompletionProvider}
+         * @since 5.6
          */
         list_providers(): Gio.ListModel;
 
@@ -2603,6 +2633,7 @@ export namespace GtkSource {
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
          * @returns the {@link GObject.GType} of the items contained in `list`.
+         * @since 2.44
          */
         get_item_type(): GObject.GType;
 
@@ -2613,6 +2644,7 @@ export namespace GtkSource {
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
          * @returns the number of items in `list`.
+         * @since 2.44
          */
         get_n_items(): number;
 
@@ -2631,6 +2663,7 @@ export namespace GtkSource {
          * See also: `g_list_model_get_n_items()`
          * @param position the position of the item to fetch
          * @returns the object at `position`.
+         * @since 2.44
          */
         get_item(position: number): A | null;
 
@@ -2658,6 +2691,7 @@ export namespace GtkSource {
          * @param position the position at which `list` changed
          * @param removed the number of items removed
          * @param added the number of items added
+         * @since 2.44
          */
         items_changed(position: number, removed: number, added: number): void;
 
@@ -2670,6 +2704,7 @@ export namespace GtkSource {
          * 
          * The same {@link GObject.Object} instance may not appear more than once in a {@link Gio.ListModel}.
          * @param position the position of the item to fetch
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item(position: number): A | null;
@@ -2683,6 +2718,7 @@ export namespace GtkSource {
          * 
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item_type(): GObject.GType;
@@ -2693,6 +2729,7 @@ export namespace GtkSource {
          * 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`.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_n_items(): number;
@@ -3831,6 +3868,7 @@ export namespace GtkSource {
         /**
          * Gets the maximum expanded size that `loader` will insert into the buffer.
          * @returns the maximum expanded size in bytes, or 0 if the limit is disabled.
+         * @since 5.22
          */
         get_max_size(): number;
 
@@ -3907,6 +3945,7 @@ export namespace GtkSource {
          * The limit is checked after decompression, so compressed files are limited by
          * the size of their uncompressed contents rather than their on-disk size.
          * @param max_size maximum expanded size in bytes, or 0 to disable the limit.
+         * @since 5.22
          */
         set_max_size(max_size: bigint | number): void;
     }
@@ -4339,6 +4378,7 @@ export namespace GtkSource {
          * 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;
 
@@ -4351,6 +4391,7 @@ export namespace GtkSource {
          * 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;
 
@@ -4359,6 +4400,7 @@ export namespace GtkSource {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -4371,6 +4413,7 @@ export namespace GtkSource {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -4381,18 +4424,21 @@ export namespace GtkSource {
          * 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;
 
@@ -4404,6 +4450,7 @@ export namespace GtkSource {
          * 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;
 
@@ -4437,6 +4484,7 @@ export namespace GtkSource {
          * 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;
 
@@ -4446,6 +4494,7 @@ export namespace GtkSource {
          * 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;
 
@@ -4456,6 +4505,7 @@ export namespace GtkSource {
          * 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;
 
@@ -4503,6 +4553,7 @@ export namespace GtkSource {
          * 
          * 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;
@@ -4511,12 +4562,14 @@ export namespace GtkSource {
          * 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;
@@ -4527,18 +4580,21 @@ export namespace GtkSource {
          * 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;
@@ -4550,6 +4606,7 @@ export namespace GtkSource {
          * 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;
@@ -4762,6 +4819,7 @@ export namespace GtkSource {
          * The value for `y` is relative to the renderers widget coordinates.
          * @param line a line number starting from zero
          * @param mode a {@link GtkSource.GutterRendererAlignmentMode}
+         * @since 5.18
          */
         get_line_extent(line: number, mode: GutterRendererAlignmentMode): [number, number];
 
@@ -4786,6 +4844,7 @@ export namespace GtkSource {
          * been set on the class.
          * @param line a line contained within `lines`
          * @returns `true` if any quark was set for the line
+         * @since 5.6
          */
         has_any_class(line: number): boolean;
 
@@ -5295,6 +5354,7 @@ export namespace GtkSource {
          * 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;
 
@@ -5307,6 +5367,7 @@ export namespace GtkSource {
          * 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;
 
@@ -5315,6 +5376,7 @@ export namespace GtkSource {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -5327,6 +5389,7 @@ export namespace GtkSource {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -5337,18 +5400,21 @@ export namespace GtkSource {
          * 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;
 
@@ -5360,6 +5426,7 @@ export namespace GtkSource {
          * 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;
 
@@ -5393,6 +5460,7 @@ export namespace GtkSource {
          * 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;
 
@@ -5402,6 +5470,7 @@ export namespace GtkSource {
          * 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;
 
@@ -5412,6 +5481,7 @@ export namespace GtkSource {
          * 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;
 
@@ -5459,6 +5529,7 @@ export namespace GtkSource {
          * 
          * 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;
@@ -5467,12 +5538,14 @@ export namespace GtkSource {
          * 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;
@@ -5483,18 +5556,21 @@ export namespace GtkSource {
          * 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;
@@ -5506,6 +5582,7 @@ export namespace GtkSource {
          * 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;
@@ -6244,6 +6321,7 @@ export namespace GtkSource {
          * 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;
 
@@ -6256,6 +6334,7 @@ export namespace GtkSource {
          * 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;
 
@@ -6264,6 +6343,7 @@ export namespace GtkSource {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -6276,6 +6356,7 @@ export namespace GtkSource {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -6286,18 +6367,21 @@ export namespace GtkSource {
          * 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;
 
@@ -6309,6 +6393,7 @@ export namespace GtkSource {
          * 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;
 
@@ -6342,6 +6427,7 @@ export namespace GtkSource {
          * 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;
 
@@ -6351,6 +6437,7 @@ export namespace GtkSource {
          * 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;
 
@@ -6361,6 +6448,7 @@ export namespace GtkSource {
          * 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;
 
@@ -6408,6 +6496,7 @@ export namespace GtkSource {
          * 
          * 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;
@@ -6416,12 +6505,14 @@ export namespace GtkSource {
          * 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;
@@ -6432,18 +6523,21 @@ export namespace GtkSource {
          * 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;
@@ -6455,6 +6549,7 @@ export namespace GtkSource {
          * 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;
@@ -6817,6 +6912,7 @@ export namespace GtkSource {
          * 
          * See {@link LanguageManager.set_search_path} for details.
          * @param path a directory or a filename.
+         * @since 5.4
          */
         append_search_path(path: string): void;
 
@@ -6904,6 +7000,7 @@ export namespace GtkSource {
          * 
          * See {@link LanguageManager.set_search_path} for details.
          * @param path a directory or a filename.
+         * @since 5.4
          */
         prepend_search_path(path: string): void;
 
@@ -7986,6 +8083,7 @@ export namespace GtkSource {
          * Specifies a tag whose style should be ignored when compositing the
          * document to the printable page.
          * @param tag a {@link Gtk.TextTag}
+         * @since 5.2
          */
         ignore_tag(tag: Gtk.TextTag): void;
 
@@ -9113,6 +9211,7 @@ export namespace GtkSource {
 
         /**
          * @returns whether to exclude invisible text from the search.
+         * @since 5.12
          */
         get_visible_only(): boolean;
 
@@ -9168,6 +9267,7 @@ export namespace GtkSource {
          * If enabled, only visible text will be searched.
          * A search match may have invisible text interspersed.
          * @param visible_only the setting.
+         * @since 5.12
          */
         set_visible_only(visible_only: boolean): void;
 
@@ -9854,6 +9954,7 @@ export namespace GtkSource {
          * This can be used to get an unfiltered list of all of the snippets
          * known to the snippet manager.
          * @returns a {@link Gio.ListModel} of {@link GtkSource.Snippet}
+         * @since 5.6
          */
         list_all(): Gio.ListModel;
 
@@ -10560,6 +10661,7 @@ export namespace GtkSource {
          * Gets a metadata property from the style scheme.
          * @param name metadata property name.
          * @returns value of property `name` stored in   the metadata of `scheme` or `null` if `scheme` does not contain the   specified metadata property.
+         * @since 5.4
          */
         get_metadata(name: string): string | null;
 
@@ -11007,6 +11109,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11019,6 +11122,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11027,6 +11131,7 @@ export namespace GtkSource {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -11039,6 +11144,7 @@ export namespace GtkSource {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -11049,18 +11155,21 @@ export namespace GtkSource {
          * 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;
 
@@ -11072,6 +11181,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11105,6 +11215,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11114,6 +11225,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11124,6 +11236,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11171,6 +11284,7 @@ export namespace GtkSource {
          * 
          * 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;
@@ -11179,12 +11293,14 @@ export namespace GtkSource {
          * 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;
@@ -11195,18 +11311,21 @@ export namespace GtkSource {
          * 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;
@@ -11218,6 +11337,7 @@ export namespace GtkSource {
          * 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;
@@ -11600,6 +11720,7 @@ export namespace GtkSource {
         /**
          * Gets the {@link GtkSource.StyleScheme} previewed by the widget.
          * @returns a {@link GtkSource.StyleScheme}
+         * @since 5.4
          */
         get_scheme(): StyleScheme;
 
@@ -11672,6 +11793,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11684,6 +11806,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11692,6 +11815,7 @@ export namespace GtkSource {
          * 
          * This function returns `NULL` for top level widgets.
          * @returns the accessible parent
+         * @since 4.10
          */
         get_accessible_parent(): Gtk.Accessible | null;
 
@@ -11704,6 +11828,7 @@ export namespace GtkSource {
         /**
          * Retrieves the implementation for the given accessible object.
          * @returns the accessible implementation object
+         * @since 4.10
          */
         get_at_context(): Gtk.ATContext;
 
@@ -11714,18 +11839,21 @@ export namespace GtkSource {
          * 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;
 
@@ -11737,6 +11865,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11770,6 +11899,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11779,6 +11909,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11789,6 +11920,7 @@ export namespace GtkSource {
          * 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;
 
@@ -11836,6 +11968,7 @@ export namespace GtkSource {
          * 
          * 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;
@@ -11844,12 +11977,14 @@ export namespace GtkSource {
          * 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;
@@ -11860,18 +11995,21 @@ export namespace GtkSource {
          * 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;
@@ -11883,6 +12021,7 @@ export namespace GtkSource {
          * 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;
@@ -12890,6 +13029,7 @@ export namespace GtkSource {
          * The returned object is guaranteed to be the same for the lifetime of `view`.
          * Each {@link View} object has a different {@link Annotations}.
          * @returns the {@link GtkSource.Annotations} associated with `view`.
+         * @since 5.18
          */
         get_annotations(): Annotations;
 
@@ -13277,6 +13417,7 @@ export namespace GtkSource {
          * Implementations of the {@link Gtk.AccessibleText} interface should call this
          * function every time the caret has moved, in order to notify assistive
          * technologies.
+         * @since 4.14
          */
         update_caret_position(): void;
 
@@ -13293,6 +13434,7 @@ export namespace GtkSource {
          * @param change the type of change in the contents
          * @param start the starting offset of the change, in characters
          * @param end the end offset of the change, in characters
+         * @since 4.14
          */
         update_contents(change: Gtk.AccessibleTextContentChange, start: number, end: number): void;
 
@@ -13302,6 +13444,7 @@ export namespace GtkSource {
          * Implementations of the {@link Gtk.AccessibleText} interface should call this
          * function every time the selection has moved, in order to notify assistive
          * technologies.
+         * @since 4.14
          */
         update_selection_bound(): void;
 
@@ -13324,12 +13467,14 @@ export namespace GtkSource {
          * greater than or equal to one, `ranges` will be set to a newly
          * allocated array of [struct#Gtk.AccessibleTextRange].
          * @param offset the offset, in characters
+         * @since 4.14
          * @virtual
          */
         vfunc_get_attributes(offset: number): [boolean, Gtk.AccessibleTextRange[] | null, string[] | null, string[] | null];
 
         /**
          * Retrieves the position of the caret inside the accessible object.
+         * @since 4.14
          * @virtual
          */
         vfunc_get_caret_position(): number;
@@ -13342,6 +13487,7 @@ export namespace GtkSource {
          * of the accessible object.
          * @param start the beginning of the range, in characters
          * @param end the end of the range, in characters
+         * @since 4.14
          * @virtual
          */
         vfunc_get_contents(start: number, end: number): GLib.Bytes | Uint8Array;
@@ -13353,6 +13499,7 @@ export namespace GtkSource {
          * The `start` and `end` values contain the boundaries of the text.
          * @param offset the offset, in characters
          * @param granularity the granularity of the query
+         * @since 4.14
          * @virtual
          */
         vfunc_get_contents_at(offset: number, granularity: Gtk.AccessibleTextGranularity): [GLib.Bytes | Uint8Array, number, number];
@@ -13370,6 +13517,7 @@ export namespace GtkSource {
          * 
          * GTK provides support for various text attribute names and values, but
          * implementations of this interface are free to add their own attributes.
+         * @since 4.14
          * @virtual
          */
         vfunc_get_default_attributes(): [string[] | null, string[] | null];
@@ -13379,6 +13527,7 @@ export namespace GtkSource {
          * @param start the start offset, in characters
          * @param end the end offset, in characters, `extents` (out caller-allocates): return location for the extents
          * @param extents 
+         * @since 4.16
          * @virtual
          */
         vfunc_get_extents(start: number, end: number, extents: Graphene.Rect): boolean;
@@ -13386,6 +13535,7 @@ export namespace GtkSource {
         /**
          * Gets the text offset at a given point.
          * @param point a point in widget coordinates of `self`
+         * @since 4.16
          * @virtual
          */
         vfunc_get_offset(point: Graphene.Point): [boolean, number];
@@ -13396,6 +13546,7 @@ export namespace GtkSource {
          * If this function returns true, `n_ranges` will be set to a value
          * greater than or equal to one, and `ranges` will be set to a newly
          * allocated array of [struct#Gtk.AccessibleTextRange].
+         * @since 4.14
          * @virtual
          */
         vfunc_get_selection(): [boolean, Gtk.AccessibleTextRange[] | null];
@@ -13403,6 +13554,7 @@ export namespace GtkSource {
         /**
          * Sets the caret position.
          * @param offset the text offset in characters
+         * @since 4.22
          * @virtual
          */
         vfunc_set_caret_position(offset: number): boolean;
@@ -13411,6 +13563,7 @@ export namespace GtkSource {
          * Sets the caret position.
          * @param i the selection to set
          * @param range the range to set the selection to
+         * @since 4.22
          * @virtual
          */
         vfunc_set_selection(i: number, range: Gtk.AccessibleTextRange): boolean;
@@ -13690,18 +13843,21 @@ export namespace GtkSource {
          * user except that this does not emit the
          * `GtkSource.VimIMContext::execute-command` signal.
          * @param command the command text
+         * @since 5.4
          */
         execute_command(command: string): void;
 
         /**
          * Gets the current command-bar text as it is entered by the user.
          * @returns A string containing the command-bar text
+         * @since 5.4
          */
         get_command_bar_text(): string;
 
         /**
          * Gets the current command text as it is entered by the user.
          * @returns A string containing the command text
+         * @since 5.4
          */
         get_command_text(): string;
     }
@@ -14068,6 +14224,7 @@ export namespace GtkSource {
              * 
              * Implementing this virtual-function is optional, but can be useful to allow
              * external tooling to compare results.
+             * @since 5.6
              * @virtual
              */
             vfunc_get_typed_text(): string | null;
@@ -14103,6 +14260,7 @@ export namespace GtkSource {
          * Implementing this virtual-function is optional, but can be useful to allow
          * external tooling to compare results.
          * @returns a newly allocated string, or `null`
+         * @since 5.6
          */
         get_typed_text(): string | null;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@girs/gtksource-5",
-    "version": "4.3.0",
+    "version": "4.4.0",
     "libraryVersion": "5.21.0",
     "description": "GJS TypeScript type definitions for GtkSource-5, generated from library version 5.21.0",
     "type": "module",
@@ -37,21 +37,21 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "^4.3.0",
-      "@girs/gtk-4.0": "^4.3.0",
-      "@girs/gsk-4.0": "^4.3.0",
-      "@girs/graphene-1.0": "^4.3.0",
-      "@girs/gobject-2.0": "^4.3.0",
-      "@girs/glib-2.0": "^4.3.0",
-      "@girs/gdk-4.0": "^4.3.0",
-      "@girs/cairo-1.0": "^4.3.0",
-      "@girs/pangocairo-1.0": "^4.3.0",
-      "@girs/pango-1.0": "^4.3.0",
-      "@girs/harfbuzz-0.0": "^4.3.0",
-      "@girs/freetype2-2.0": "^4.3.0",
-      "@girs/gio-2.0": "^4.3.0",
-      "@girs/gmodule-2.0": "^4.3.0",
-      "@girs/gdkpixbuf-2.0": "^4.3.0"    },
+      "@girs/gjs": "^4.4.0",
+      "@girs/gtk-4.0": "^4.4.0",
+      "@girs/gsk-4.0": "^4.4.0",
+      "@girs/graphene-1.0": "^4.4.0",
+      "@girs/gobject-2.0": "^4.4.0",
+      "@girs/glib-2.0": "^4.4.0",
+      "@girs/gdk-4.0": "^4.4.0",
+      "@girs/cairo-1.0": "^4.4.0",
+      "@girs/pangocairo-1.0": "^4.4.0",
+      "@girs/pango-1.0": "^4.4.0",
+      "@girs/harfbuzz-0.0": "^4.4.0",
+      "@girs/freetype2-2.0": "^4.4.0",
+      "@girs/gio-2.0": "^4.4.0",
+      "@girs/gmodule-2.0": "^4.4.0",
+      "@girs/gdkpixbuf-2.0": "^4.4.0"    },
     "devDependencies": {
       "typescript": "*"
     },