@girs/glib-2.0 2.84.0-4.0.0-beta.23 → 2.84.2-4.0.0-beta.25

package/README.md

@@ -5,7 +5,7 @@
 ![downloads/week](https://img.shields.io/npm/dw/@girs/glib-2.0)
 
 
-GJS TypeScript type definitions for GLib-2.0, generated from library version 2.84.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.23.
+GJS TypeScript type definitions for GLib-2.0, generated from library version 2.84.2 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.25.
 
 
 ## Install

package/glib-2.0.d.ts

@@ -9075,15 +9075,26 @@ export namespace GLib {
      * If you are using #GApplication the program name is set in
      * g_application_run(). In case of GDK or GTK it is set in
      * gdk_init(), which is called by gtk_init() and the
-     * #GtkApplication::startup handler. The program name is found by
-     * taking the last component of `argv[`0].
+     * #GtkApplication::startup handler. By default, the program name is
+     * found by taking the last component of `argv[`0].
      *
      * Since GLib 2.72, this function can be called multiple times
      * and is fully thread safe. Prior to GLib 2.72, this function
      * could only be called once per process.
+     *
+     * See the [GTK documentation](https://docs.gtk.org/gtk4/migrating-3to4.html#set-a-proper-application-id)
+     * for requirements on integrating g_set_prgname() with GTK applications.
      * @param prgname the name of the program.
      */
     function set_prgname(prgname: string): void;
+    /**
+     * If g_get_prgname() is not set, this is the same as setting
+     * the name via g_set_prgname() and %TRUE is returned. Otherwise,
+     * does nothing and returns %FALSE. This is thread-safe.
+     * @param prgname the name of the program.
+     * @returns whether g_prgname was initialized by the call.
+     */
+    function set_prgname_once(prgname: string): boolean;
     /**
      * Sets an environment variable. On UNIX, both the variable's name and
      * value can be arbitrary byte strings, except that the variable's name
@@ -11269,7 +11280,7 @@ export namespace GLib {
      * @param str a UCS-4 encoded string
      * @returns a pointer to a newly allocated UTF-16 string.   This value must be freed with [func@GLib.free].
      */
-    function ucs4_to_utf16(str: number[]): [number, number, number];
+    function ucs4_to_utf16(str: string): [number, number, number];
     /**
      * Convert a string from a 32-bit fixed width representation as UCS-4.
      * to UTF-8.
@@ -11278,7 +11289,7 @@ export namespace GLib {
      * @param str a UCS-4 encoded string
      * @returns a pointer to a newly allocated UTF-8 string.   This value must be freed with [func@GLib.free]. If an error occurs,   @items_read will be set to the position of the first invalid input   character.
      */
-    function ucs4_to_utf8(str: number[]): [string, number, number];
+    function ucs4_to_utf8(str: string): [string, number, number];
     /**
      * Determines the break type of `c`. `c` should be a Unicode character
      * (to derive a character from UTF-8 encoded text, use
@@ -11289,13 +11300,13 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns the break type of @c
      */
-    function unichar_break_type(c: number): UnicodeBreakType;
+    function unichar_break_type(c: string): UnicodeBreakType;
     /**
      * Determines the canonical combining class of a Unicode character.
      * @param uc a Unicode character
      * @returns the combining class of the character
      */
-    function unichar_combining_class(uc: number): number;
+    function unichar_combining_class(uc: string): number;
     /**
      * Performs a single composition step of the
      * Unicode canonical composition algorithm.
@@ -11317,7 +11328,7 @@ export namespace GLib {
      * @param b a Unicode character
      * @returns %TRUE if the characters could be composed
      */
-    function unichar_compose(a: number, b: number): [boolean, number];
+    function unichar_compose(a: string, b: string): [boolean, string];
     /**
      * Performs a single decomposition step of the
      * Unicode canonical decomposition algorithm.
@@ -11345,14 +11356,14 @@ export namespace GLib {
      * @param ch a Unicode character
      * @returns %TRUE if the character could be decomposed
      */
-    function unichar_decompose(ch: number): [boolean, number, number];
+    function unichar_decompose(ch: string): [boolean, string, string];
     /**
      * Determines the numeric value of a character as a decimal
      * digit.
      * @param c a Unicode character
      * @returns If @c is a decimal digit (according to g_unichar_isdigit()), its numeric value. Otherwise, -1.
      */
-    function unichar_digit_value(c: number): number;
+    function unichar_digit_value(c: string): number;
     /**
      * Computes the canonical or compatibility decomposition of a
      * Unicode character.  For compatibility decomposition,
@@ -11378,7 +11389,7 @@ export namespace GLib {
      * @param result_len length of @result
      * @returns the length of the full decomposition.
      */
-    function unichar_fully_decompose(ch: number, compat: boolean, result_len: number): [number, number];
+    function unichar_fully_decompose(ch: string, compat: boolean, result_len: number): [number, string];
     /**
      * In Unicode, some characters are "mirrored". This means that their
      * images are mirrored horizontally in text that is laid out from right
@@ -11392,7 +11403,7 @@ export namespace GLib {
      * @param ch a Unicode character
      * @returns %TRUE if @ch has a mirrored character, %FALSE otherwise
      */
-    function unichar_get_mirror_char(ch: number): [boolean, number];
+    function unichar_get_mirror_char(ch: string): [boolean, string];
     /**
      * Looks up the #GUnicodeScript for a particular character (as defined
      * by Unicode Standard Annex \#24). No check is made for `ch` being a
@@ -11404,7 +11415,7 @@ export namespace GLib {
      * @param ch a Unicode character
      * @returns the #GUnicodeScript for the character.
      */
-    function unichar_get_script(ch: number): UnicodeScript;
+    function unichar_get_script(ch: string): UnicodeScript;
     /**
      * Determines whether a character is alphanumeric.
      * Given some UTF-8 text, obtain a character value
@@ -11412,7 +11423,7 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if @c is an alphanumeric character
      */
-    function unichar_isalnum(c: number): boolean;
+    function unichar_isalnum(c: string): boolean;
     /**
      * Determines whether a character is alphabetic (i.e. a letter).
      * Given some UTF-8 text, obtain a character value with
@@ -11420,7 +11431,7 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if @c is an alphabetic character
      */
-    function unichar_isalpha(c: number): boolean;
+    function unichar_isalpha(c: string): boolean;
     /**
      * Determines whether a character is a control character.
      * Given some UTF-8 text, obtain a character value with
@@ -11428,14 +11439,14 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if @c is a control character
      */
-    function unichar_iscntrl(c: number): boolean;
+    function unichar_iscntrl(c: string): boolean;
     /**
      * Determines if a given character is assigned in the Unicode
      * standard.
      * @param c a Unicode character
      * @returns %TRUE if the character has an assigned value
      */
-    function unichar_isdefined(c: number): boolean;
+    function unichar_isdefined(c: string): boolean;
     /**
      * Determines whether a character is numeric (i.e. a digit).  This
      * covers ASCII 0-9 and also digits in other languages/scripts.  Given
@@ -11443,7 +11454,7 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if @c is a digit
      */
-    function unichar_isdigit(c: number): boolean;
+    function unichar_isdigit(c: string): boolean;
     /**
      * Determines whether a character is printable and not a space
      * (returns %FALSE for control characters, format characters, and
@@ -11453,7 +11464,7 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if @c is printable unless it's a space
      */
-    function unichar_isgraph(c: number): boolean;
+    function unichar_isgraph(c: string): boolean;
     /**
      * Determines whether a character is a lowercase letter.
      * Given some UTF-8 text, obtain a character value with
@@ -11461,7 +11472,7 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if @c is a lowercase letter
      */
-    function unichar_islower(c: number): boolean;
+    function unichar_islower(c: string): boolean;
     /**
      * Determines whether a character is a mark (non-spacing mark,
      * combining mark, or enclosing mark in Unicode speak).
@@ -11475,7 +11486,7 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if @c is a mark character
      */
-    function unichar_ismark(c: number): boolean;
+    function unichar_ismark(c: string): boolean;
     /**
      * Determines whether a character is printable.
      * Unlike g_unichar_isgraph(), returns %TRUE for spaces.
@@ -11484,7 +11495,7 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if @c is printable
      */
-    function unichar_isprint(c: number): boolean;
+    function unichar_isprint(c: string): boolean;
     /**
      * Determines whether a character is punctuation or a symbol.
      * Given some UTF-8 text, obtain a character value with
@@ -11492,7 +11503,7 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if @c is a punctuation or symbol character
      */
-    function unichar_ispunct(c: number): boolean;
+    function unichar_ispunct(c: string): boolean;
     /**
      * Determines whether a character is a space, tab, or line separator
      * (newline, carriage return, etc.).  Given some UTF-8 text, obtain a
@@ -11504,7 +11515,7 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if @c is a space character
      */
-    function unichar_isspace(c: number): boolean;
+    function unichar_isspace(c: string): boolean;
     /**
      * Determines if a character is titlecase. Some characters in
      * Unicode which are composites, such as the DZ digraph
@@ -11515,20 +11526,20 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if the character is titlecase
      */
-    function unichar_istitle(c: number): boolean;
+    function unichar_istitle(c: string): boolean;
     /**
      * Determines if a character is uppercase.
      * @param c a Unicode character
      * @returns %TRUE if @c is an uppercase character
      */
-    function unichar_isupper(c: number): boolean;
+    function unichar_isupper(c: string): boolean;
     /**
      * Determines if a character is typically rendered in a double-width
      * cell.
      * @param c a Unicode character
      * @returns %TRUE if the character is wide
      */
-    function unichar_iswide(c: number): boolean;
+    function unichar_iswide(c: string): boolean;
     /**
      * Determines if a character is typically rendered in a double-width
      * cell under legacy East Asian locales.  If a character is wide according to
@@ -11543,13 +11554,13 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if the character is wide in legacy East Asian locales
      */
-    function unichar_iswide_cjk(c: number): boolean;
+    function unichar_iswide_cjk(c: string): boolean;
     /**
      * Determines if a character is a hexadecimal digit.
      * @param c a Unicode character.
      * @returns %TRUE if the character is a hexadecimal digit
      */
-    function unichar_isxdigit(c: number): boolean;
+    function unichar_isxdigit(c: string): boolean;
     /**
      * Determines if a given character typically takes zero width when rendered.
      * The return value is %TRUE for all non-spacing and enclosing marks
@@ -11563,37 +11574,37 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns %TRUE if the character has zero width
      */
-    function unichar_iszerowidth(c: number): boolean;
+    function unichar_iszerowidth(c: string): boolean;
     /**
      * Converts a single character to UTF-8.
      * @param c a Unicode character code
      * @returns number of bytes written
      */
-    function unichar_to_utf8(c: number): [number, string];
+    function unichar_to_utf8(c: string): [number, string];
     /**
      * Converts a character to lower case.
      * @param c a Unicode character.
      * @returns the result of converting @c to lower case.               If @c is not an upperlower or titlecase character,               or has no lowercase equivalent @c is returned unchanged.
      */
-    function unichar_tolower(c: number): number;
+    function unichar_tolower(c: string): string;
     /**
      * Converts a character to the titlecase.
      * @param c a Unicode character
      * @returns the result of converting @c to titlecase.               If @c is not an uppercase or lowercase character,               @c is returned unchanged.
      */
-    function unichar_totitle(c: number): number;
+    function unichar_totitle(c: string): string;
     /**
      * Converts a character to uppercase.
      * @param c a Unicode character
      * @returns the result of converting @c to uppercase.               If @c is not a lowercase or titlecase character,               or has no upper case equivalent @c is returned unchanged.
      */
-    function unichar_toupper(c: number): number;
+    function unichar_toupper(c: string): string;
     /**
      * Classifies a Unicode character by type.
      * @param c a Unicode character
      * @returns the type of the character.
      */
-    function unichar_type(c: number): UnicodeType;
+    function unichar_type(c: string): UnicodeType;
     /**
      * Checks whether `ch` is a valid Unicode character.
      *
@@ -11602,21 +11613,21 @@ export namespace GLib {
      * @param ch a Unicode character
      * @returns `TRUE` if @ch is a valid Unicode character
      */
-    function unichar_validate(ch: number): boolean;
+    function unichar_validate(ch: string): boolean;
     /**
      * Determines the numeric value of a character as a hexadecimal
      * digit.
      * @param c a Unicode character
      * @returns If @c is a hex digit (according to g_unichar_isxdigit()), its numeric value. Otherwise, -1.
      */
-    function unichar_xdigit_value(c: number): number;
+    function unichar_xdigit_value(c: string): number;
     /**
      * Computes the canonical decomposition of a Unicode character.
      * @param ch a Unicode character.
      * @param result_len location to store the length of the return value.
      * @returns a newly allocated string of Unicode characters.   @result_len is set to the resulting length of the string.
      */
-    function unicode_canonical_decomposition(ch: number, result_len: number): number;
+    function unicode_canonical_decomposition(ch: string, result_len: number): string;
     /**
      * Computes the canonical ordering of a string in-place.
      * This rearranges decomposed characters in the string
@@ -11624,7 +11635,7 @@ export namespace GLib {
      * manual for more information.
      * @param string a UCS-4 encoded string.
      */
-    function unicode_canonical_ordering(string: number[]): void;
+    function unicode_canonical_ordering(string: string): void;
     /**
      * Looks up the Unicode script for `iso1`5924.  ISO 15924 assigns four-letter
      * codes to scripts.  For example, the code for Arabic is 'Arab'.
@@ -12206,7 +12217,7 @@ export namespace GLib {
      * @param str a UTF-16 encoded string
      * @returns a pointer to a newly allocated UCS-4 string.   This value must be freed with [func@GLib.free].
      */
-    function utf16_to_ucs4(str: number[]): [number, number, number];
+    function utf16_to_ucs4(str: number[]): [string, number, number];
     /**
      * Convert a string from UTF-16 to UTF-8.
      *
@@ -12338,7 +12349,7 @@ export namespace GLib {
      * @param p a pointer to Unicode character encoded as UTF-8
      * @returns the resulting character
      */
-    function utf8_get_char(p: string): number;
+    function utf8_get_char(p: string): string;
     /**
      * Convert a sequence of bytes encoded as UTF-8 to a Unicode character.
      *
@@ -12353,7 +12364,7 @@ export namespace GLib {
      * @param max_len the maximum number of bytes to read, or `-1` if @p is nul-terminated
      * @returns the resulting character. If @p points to a partial   sequence at the end of a string that could begin a valid   character (or if @max_len is zero), returns `(gunichar)-2`;   otherwise, if @p does not point to a valid UTF-8 encoded   Unicode character, returns `(gunichar)-1`.
      */
-    function utf8_get_char_validated(p: string, max_len: number): number;
+    function utf8_get_char_validated(p: string, max_len: number): string;
     /**
      * If the provided string is valid UTF-8, return a copy of it. If not,
      * return a copy in which bytes that could not be interpreted as valid Unicode
@@ -12453,7 +12464,7 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns `NULL` if the string does not contain   the character, otherwise, a pointer to the start of the leftmost occurrence   of the character in the string.
      */
-    function utf8_strchr(p: string, len: number, c: number): string | null;
+    function utf8_strchr(p: string, len: number, c: string): string | null;
     /**
      * Converts all Unicode characters in the string that have a case
      * to lowercase. The exact manner that this is done depends
@@ -12499,7 +12510,7 @@ export namespace GLib {
      * @param c a Unicode character
      * @returns `NULL` if the string does not contain   the character, otherwise, a pointer to the start of the rightmost   occurrence of the character in the string.
      */
-    function utf8_strrchr(p: string, len: number, c: number): string | null;
+    function utf8_strrchr(p: string, len: number, c: string): string | null;
     /**
      * Reverses a UTF-8 string.
      *
@@ -12552,7 +12563,7 @@ export namespace GLib {
      * @param len the maximum length of @str to use, in bytes. If @len is negative,   then the string is nul-terminated.
      * @returns a pointer to a newly allocated UCS-4 string.   This value must be freed with [func@GLib.free].
      */
-    function utf8_to_ucs4(str: string, len: number): [number, number, number];
+    function utf8_to_ucs4(str: string, len: number): [string, number, number];
     /**
      * Convert a string from UTF-8 to a 32-bit fixed width
      * representation as UCS-4, assuming valid UTF-8 input.
@@ -12564,7 +12575,7 @@ export namespace GLib {
      * @param len the maximum length of @str to use, in bytes. If @len is negative,   then the string is nul-terminated.
      * @returns a pointer to a newly allocated UCS-4 string.   This value must be freed with [func@GLib.free].
      */
-    function utf8_to_ucs4_fast(str: string, len: number): [number, number];
+    function utf8_to_ucs4_fast(str: string, len: number): [string, number];
     /**
      * Convert a string from UTF-8 to UTF-16.
      *
@@ -17431,85 +17442,24 @@ export namespace GLib {
         steal(): void;
     }
 
-    /**
-     * HMACs should be used when producing a cookie or hash based on data
-     * and a key. Simple mechanisms for using SHA1 and other algorithms to
-     * digest a key and data together are vulnerable to various security
-     * issues.
-     * [HMAC](http://en.wikipedia.org/wiki/HMAC)
-     * uses algorithms like SHA1 in a secure way to produce a digest of a
-     * key and data.
-     *
-     * Both the key and data are arbitrary byte arrays of bytes or characters.
-     *
-     * Support for HMAC Digests has been added in GLib 2.30, and support for SHA-512
-     * in GLib 2.42. Support for SHA-384 was added in GLib 2.52.
-     *
-     * To create a new `GHmac`, use [ctor`GLib`.Hmac.new]. To free a `GHmac`, use
-     * [method`GLib`.Hmac.unref].
-     */
     class Hmac {
         static $gtype: GObject.GType<Hmac>;
 
         // Constructors
 
-        constructor(digest_type: ChecksumType, key: Uint8Array | string);
+        constructor(digest_type: ChecksumType, key: number, key_len: number);
         _init(...args: any[]): void;
 
-        static ['new'](digest_type: ChecksumType, key: Uint8Array | string): Hmac;
+        static ['new'](digest_type: ChecksumType, key: number, key_len: number): Hmac;
 
         // Methods
 
-        /**
-         * Copies a #GHmac. If `hmac` has been closed, by calling
-         * g_hmac_get_string() or g_hmac_get_digest(), the copied
-         * HMAC will be closed as well.
-         * @returns the copy of the passed #GHmac. Use g_hmac_unref()   when finished using it.
-         */
         copy(): Hmac;
-        /**
-         * Gets the digest from `checksum` as a raw binary array and places it
-         * into `buffer`. The size of the digest depends on the type of checksum.
-         *
-         * Once this function has been called, the #GHmac is closed and can
-         * no longer be updated with g_checksum_update().
-         * @param buffer output buffer
-         */
-        get_digest(buffer: Uint8Array | string): void;
-        /**
-         * Gets the HMAC as a hexadecimal string.
-         *
-         * Once this function has been called the #GHmac can no longer be
-         * updated with g_hmac_update().
-         *
-         * The hexadecimal characters will be lower case.
-         * @returns the hexadecimal representation of the HMAC. The   returned string is owned by the HMAC and should not be modified   or freed.
-         */
+        get_digest(buffer: number, digest_len: number): void;
         get_string(): string;
-        /**
-         * Atomically increments the reference count of `hmac` by one.
-         *
-         * This function is MT-safe and may be called from any thread.
-         * @returns the passed in #GHmac.
-         */
         ref(): Hmac;
-        /**
-         * Atomically decrements the reference count of `hmac` by one.
-         *
-         * If the reference count drops to 0, all keys and values will be
-         * destroyed, and all memory allocated by the hash table is released.
-         * This function is MT-safe and may be called from any thread.
-         * Frees the memory allocated for `hmac`.
-         */
         unref(): void;
-        /**
-         * Feeds `data` into an existing #GHmac.
-         *
-         * The HMAC must still be open, that is g_hmac_get_string() or
-         * g_hmac_get_digest() must not have been called on `hmac`.
-         * @param data buffer used to compute the checksum
-         */
-        update(data: Uint8Array | string): void;
+        update(data: number, length: number): void;
     }
 
     /**
@@ -17815,7 +17765,7 @@ export namespace GLib {
          * This function cannot be called on a channel with %NULL encoding.
          * @returns a #GIOStatus
          */
-        read_unichar(): [IOStatus, number];
+        read_unichar(): [IOStatus, string];
         /**
          * Increments the reference count of a #GIOChannel.
          * @returns the @channel that was passed in (since 2.6)
@@ -17972,7 +17922,7 @@ export namespace GLib {
          * @param thechar a character
          * @returns a #GIOStatus
          */
-        write_unichar(thechar: number): IOStatus;
+        write_unichar(thechar: string): IOStatus;
     }
 
     /**
@@ -18401,8 +18351,10 @@ export namespace GLib {
         load_from_data(data: string, length: number, flags: KeyFileFlags | null): boolean;
         /**
          * Looks for a key file named `file` in the paths returned from
-         * [func`GLib`.get_user_data_dir] and [func`GLib`.get_system_data_dirs],
-         * loads the file into `key_file` and returns the file’s full path in
+         * [func`GLib`.get_user_data_dir] and [func`GLib`.get_system_data_dirs].
+         *
+         * The search algorithm from [method`GLib`.KeyFile.load_from_dirs] is used. If
+         * `file` is found, it’s loaded into `key_file` and its full path is returned in
          * `full_path`.
          *
          * If the file could not be loaded then either a [error`GLib`.FileError] or
@@ -18416,6 +18368,13 @@ export namespace GLib {
          * Looks for a key file named `file` in the paths specified in `search_dirs,`
          * loads the file into `key_file` and returns the file’s full path in `full_path`.
          *
+         * `search_dirs` are checked in the order listed in the array, with the highest
+         * priority directory listed first. Within each directory, `file` is looked for.
+         * If it’s not found, `-` characters in `file` are progressively replaced with
+         * directory separators to search subdirectories of the search directory. If the
+         * file has not been found after all `-` characters have been replaced, the next
+         * search directory in `search_dirs` is checked.
+         *
          * If the file could not be found in any of the `search_dirs,`
          * [error`GLib`.KeyFileError.NOT_FOUND] is returned. If
          * the file is found but the OS returns an error when opening or reading the
@@ -23172,7 +23131,7 @@ export namespace GLib {
          * @param wc a Unicode character
          * @returns @string
          */
-        append_unichar(wc: number): String;
+        append_unichar(wc: string): String;
         /**
          * Appends `unescaped` to `string,` escaping any characters that
          * are reserved in URIs using URI-style escape sequences.
@@ -23297,7 +23256,7 @@ export namespace GLib {
          * @param wc a Unicode character
          * @returns @string
          */
-        insert_unichar(pos: number, wc: number): String;
+        insert_unichar(pos: number, wc: string): String;
         /**
          * Overwrites part of a string, lengthening it if necessary.
          * @param pos the position at which to start overwriting
@@ -23349,7 +23308,7 @@ export namespace GLib {
          * @param wc a Unicode character
          * @returns @string
          */
-        prepend_unichar(wc: number): String;
+        prepend_unichar(wc: string): String;
         /**
          * Replaces the string `find` with the string `replace` in a #GString up to
          * `limit` times. If the number of instances of `find` in the #GString is
@@ -26837,6 +26796,19 @@ export namespace GLib {
     /**
      * A type in the [type`GLib`.Variant] type system.
      *
+     * [type`GLib`.Variant] types are represented as strings, but have a strict
+     * syntax described below. All [type`GLib`.VariantType]s passed to GLib must be
+     * valid, and they are typically expected to be static (i.e. not provided by
+     * user input) as they determine how binary [type`GLib`.Variant] data is
+     * interpreted.
+     *
+     * To convert a static string to a [type`GLib`.VariantType] in C, use the
+     * [func`GLib`.VARIANT_TYPE] casting macro. When GLib is compiled with checks
+     * enabled, it will validate the type. To check if an arbitrary string is a
+     * valid [type`GLib`.VariantType], use [func`GLib`.VariantType.string_is_valid].
+     *
+     * ## GVariant Type System
+     *
      * This section introduces the [type`GLib`.Variant] type system. It is based, in
      * large part, on the D-Bus type system, with two major changes and
      * some minor lifting of restrictions. The

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@girs/glib-2.0",
-  "version": "2.84.0-4.0.0-beta.23",
-  "description": "GJS TypeScript type definitions for GLib-2.0, generated from library version 2.84.0",
+  "version": "2.84.2-4.0.0-beta.25",
+  "description": "GJS TypeScript type definitions for GLib-2.0, generated from library version 2.84.2",
   "type": "module",
   "module": "glib-2.0.js",
   "main": "glib-2.0.js",
@@ -31,8 +31,8 @@
     "test": "tsc --project tsconfig.json"
   },
   "dependencies": {
-    "@girs/gjs": "^4.0.0-beta.23",
-    "@girs/gobject-2.0": "^2.84.0-4.0.0-beta.23"
+    "@girs/gjs": "^4.0.0-beta.25",
+    "@girs/gobject-2.0": "^2.84.2-4.0.0-beta.25"
   },
   "devDependencies": {
     "typescript": "*"