@girs/glib-2.0 2.77.0-3.2.2 → 2.78.0-3.2.4

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.77.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.2.2.
+GJS TypeScript type definitions for GLib-2.0, generated from library version 2.78.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.2.4.
 
 GLib provides the core application building blocks for libraries and applications written in C. It provides the core object system used in GNOME, the main loop implementation, and a large set of utility functions for strings and common data structures.
 

package/glib-2.0.d.cts

@@ -6432,6 +6432,11 @@ export function filename_display_name(filename: string): string | null
 /**
  * Converts an escaped ASCII-encoded URI to a local filename in the
  * encoding used for filenames.
+ * 
+ * Since GLib 2.78, the query string and fragment can be present in the URI,
+ * but are not part of the resulting filename.
+ * We take inspiration from https://url.spec.whatwg.org/#file-state,
+ * but we don't support the entire standard.
  * @param uri a uri describing a filename (escaped, encoded in ASCII).
  * @returns a newly-allocated string holding               the resulting filename, or %NULL on an error.
  */
@@ -9188,7 +9193,7 @@ export function spaced_primes_closest(num: number): number
  * @param argv      child's argument vector
  * @param envp      child's environment, or %NULL to inherit parent's
  * @param flags flags from #GSpawnFlags
- * @param child_setup function to run in the child just before exec()
+ * @param child_setup function to run     in the child just before `exec()`
  * @returns %TRUE on success, %FALSE if error is set
  */
 export function spawn_async(working_directory: string | null, argv: string[], envp: string[] | null, flags: SpawnFlags, child_setup: SpawnChildSetupFunc | null): [ /* returnType */ boolean, /* child_pid */ Pid ]
@@ -9201,7 +9206,7 @@ export function spawn_async(working_directory: string | null, argv: string[], en
  * @param argv child's argument vector, in the GLib file name encoding;   it must be non-empty and %NULL-terminated
  * @param envp child's environment, or %NULL to inherit parent's, in the GLib file name encoding
  * @param flags flags from #GSpawnFlags
- * @param child_setup function to run in the child just before exec()
+ * @param child_setup function to run   in the child just before `exec()`
  * @param stdin_fd file descriptor to use for child's stdin, or `-1`
  * @param stdout_fd file descriptor to use for child's stdout, or `-1`
  * @param stderr_fd file descriptor to use for child's stderr, or `-1`
@@ -9215,7 +9220,7 @@ export function spawn_async_with_fds(working_directory: string | null, argv: str
  * @param argv child's argument     vector, in the GLib file name encoding; it must be non-empty and %NULL-terminated
  * @param envp      child's environment, or %NULL to inherit parent's, in the GLib file     name encoding
  * @param flags flags from #GSpawnFlags
- * @param child_setup function to run in the child just before exec()
+ * @param child_setup function to run     in the child just before `exec()`
  * @returns %TRUE on success, %FALSE if an error was set
  */
 export function spawn_async_with_pipes(working_directory: string | null, argv: string[], envp: string[] | null, flags: SpawnFlags, child_setup: SpawnChildSetupFunc | null): [ /* returnType */ boolean, /* child_pid */ Pid, /* standard_input */ number, /* standard_output */ number, /* standard_error */ number ]
@@ -9418,7 +9423,7 @@ export function spawn_async_with_pipes(working_directory: string | null, argv: s
  * @param argv child's argument     vector, in the GLib file name encoding; it must be non-empty and %NULL-terminated
  * @param envp      child's environment, or %NULL to inherit parent's, in the GLib file     name encoding
  * @param flags flags from #GSpawnFlags
- * @param child_setup function to run in the child just before `exec()`
+ * @param child_setup function to run     in the child just before `exec()`
  * @param stdin_fd file descriptor to use for child's stdin, or `-1`
  * @param stdout_fd file descriptor to use for child's stdout, or `-1`
  * @param stderr_fd file descriptor to use for child's stderr, or `-1`
@@ -9571,7 +9576,7 @@ export function spawn_exit_error_quark(): Quark
  * @param argv      child's argument vector, which must be non-empty and %NULL-terminated
  * @param envp      child's environment, or %NULL to inherit parent's
  * @param flags flags from #GSpawnFlags
- * @param child_setup function to run in the child just before exec()
+ * @param child_setup function to run     in the child just before `exec()`
  * @returns %TRUE on success, %FALSE if an error was set
  */
 export function spawn_sync(working_directory: string | null, argv: string[], envp: string[] | null, flags: SpawnFlags, child_setup: SpawnChildSetupFunc | null): [ /* returnType */ boolean, /* standard_output */ Uint8Array, /* standard_error */ Uint8Array, /* wait_status */ number ]
@@ -10018,6 +10023,55 @@ export function strrstr_len(haystack: string | null, haystack_len: number, needl
  * @returns a UTF-8 string describing the signal. If the signal is unknown,     it returns "unknown signal (<signum>)".
  */
 export function strsignal(signum: number): string | null
+/**
+ * Splits a string into a maximum of `max_tokens` pieces, using the given
+ * `delimiter`. If `max_tokens` is reached, the remainder of `string` is
+ * appended to the last token.
+ * 
+ * As an example, the result of g_strsplit (":a:bc::d:", ":", -1) is a
+ * %NULL-terminated vector containing the six strings "", "a", "bc", "", "d"
+ * and "".
+ * 
+ * As a special case, the result of splitting the empty string "" is an empty
+ * vector, not a vector containing a single string. The reason for this
+ * special case is that being able to represent an empty vector is typically
+ * more useful than consistent handling of empty elements. If you do need
+ * to represent empty elements, you'll need to check for the empty string
+ * before calling g_strsplit().
+ * @param string a string to split
+ * @param delimiter a string which specifies the places at which to split     the string. The delimiter is not included in any of the resulting     strings, unless `max_tokens` is reached.
+ * @param max_tokens the maximum number of pieces to split `string` into.     If this is less than 1, the string is split completely.
+ * @returns a newly-allocated %NULL-terminated array of    strings. Use g_strfreev() to free it.
+ */
+export function strsplit(string: string | null, delimiter: string | null, max_tokens: number): string[]
+/**
+ * Splits `string` into a number of tokens not containing any of the characters
+ * in `delimiter`. A token is the (possibly empty) longest string that does not
+ * contain any of the characters in `delimiters`. If `max_tokens` is reached, the
+ * remainder is appended to the last token.
+ * 
+ * For example the result of g_strsplit_set ("abc:def/ghi", ":/", -1) is a
+ * %NULL-terminated vector containing the three strings "abc", "def",
+ * and "ghi".
+ * 
+ * The result of g_strsplit_set (":def/ghi:", ":/", -1) is a %NULL-terminated
+ * vector containing the four strings "", "def", "ghi", and "".
+ * 
+ * As a special case, the result of splitting the empty string "" is an empty
+ * vector, not a vector containing a single string. The reason for this
+ * special case is that being able to represent an empty vector is typically
+ * more useful than consistent handling of empty elements. If you do need
+ * to represent empty elements, you'll need to check for the empty string
+ * before calling g_strsplit_set().
+ * 
+ * Note that this function works on bytes not characters, so it can't be used
+ * to delimit UTF-8 strings for anything but ASCII characters.
+ * @param string The string to be tokenized
+ * @param delimiters A nul-terminated string containing bytes that are used     to split the string (it can accept an empty string, which will result     in no string splitting).
+ * @param max_tokens The maximum number of tokens to split `string` into.     If this is less than 1, the string is split completely
+ * @returns a newly-allocated %NULL-terminated array of    strings. Use g_strfreev() to free it.
+ */
+export function strsplit_set(string: string | null, delimiters: string | null, max_tokens: number): string[]
 /**
  * Searches the string `haystack` for the first occurrence
  * of the string `needle,` limiting the length of the search
@@ -10154,6 +10208,14 @@ export function test_bug(bug_uri_snippet: string | null): void
  * @param uri_pattern the base pattern for bug URIs
  */
 export function test_bug_base(uri_pattern: string | null): void
+/**
+ * Attempt to disable system crash reporting infrastructure.
+ * 
+ * This function should be called before exercising code paths that are
+ * expected or intended to crash, to avoid wasting resources in system-wide
+ * crash collection infrastructure such as systemd-coredump or abrt.
+ */
+export function test_disable_crash_reporting(): void
 /**
  * Indicates that a message with the given `log_domain` and `log_level,`
  * with text matching `pattern,` is expected to be logged. When this
@@ -10522,6 +10584,11 @@ export function test_trap_reached_timeout(): boolean
  * the subprocess, you can call g_test_subprocess() (after calling
  * g_test_init()) to see whether you are in a subprocess.
  * 
+ * Internally, this function tracks the child process using
+ * g_child_watch_source_new(), so your process must not ignore `SIGCHLD`, and
+ * must not attempt to watch or wait for the child process via another
+ * mechanism.
+ * 
  * The following example tests that calling
  * `my_object_new(1000000)` will abort with an error
  * message.
@@ -10978,10 +11045,9 @@ export function unichar_fully_decompose(ch: string, compat: boolean, result_len:
  * glyph and `mirrored_ch` is set, it puts that character in the address
  * pointed to by `mirrored_ch`.  Otherwise the original character is put.
  * @param ch a Unicode character
- * @param mirrored_ch location to store the mirrored character
  * @returns %TRUE if @ch has a mirrored character, %FALSE otherwise
  */
-export function unichar_get_mirror_char(ch: string, mirrored_ch: string): boolean
+export function unichar_get_mirror_char(ch: string): [ /* returnType */ boolean, /* mirrored_ch */ string ]
 /**
  * Looks up the #GUnicodeScript for a particular character (as defined
  * by Unicode Standard Annex \#24). No check is made for `ch` being a
@@ -11290,15 +11356,18 @@ export function unix_get_passwd_entry(user_name: string | null): any | null
  * uses the pipe2() system call, which atomically creates a pipe with
  * the configured flags.
  * 
- * As of GLib 2.78, the supported flags are `FD_CLOEXEC` and `O_NONBLOCK`. Prior
- * to GLib 2.78, only `FD_CLOEXEC` was supported — if you wanted to configure
- * `O_NONBLOCK` then that had to be done separately with `fcntl()`.
+ * As of GLib 2.78, the supported flags are `O_CLOEXEC`/`FD_CLOEXEC` (see below)
+ * and `O_NONBLOCK`. Prior to GLib 2.78, only `FD_CLOEXEC` was supported — if
+ * you wanted to configure `O_NONBLOCK` then that had to be done separately with
+ * `fcntl()`.
  * 
  * It is a programmer error to call this function with unsupported flags, and a
  * critical warning will be raised.
  * 
- * This function does not take `O_CLOEXEC`, it takes `FD_CLOEXEC` as if
- * for fcntl(); these are different on Linux/glibc.
+ * As of GLib 2.78, it is preferred to pass `O_CLOEXEC` in, rather than
+ * `FD_CLOEXEC`, as that matches the underlying `pipe()` API more closely. Prior
+ * to 2.78, only `FD_CLOEXEC` was supported. Support for `FD_CLOEXEC` may be
+ * deprecated and removed in future.
  * @param fds Array of two integers
  * @param flags Bitfield of file descriptor flags, as for fcntl()
  * @returns %TRUE on success, %FALSE if not (and errno will be set).
@@ -19133,13 +19202,13 @@ export interface OptionEntry {
      *     called to handle the extra argument. Otherwise, `arg_data` is a
      *     pointer to a location to store the value, the required type of
      *     the location depends on the `arg` type:
-     *     - %G_OPTION_ARG_NONE: %gboolean
-     *     - %G_OPTION_ARG_STRING: %gchar*
-     *     - %G_OPTION_ARG_INT: %gint
-     *     - %G_OPTION_ARG_FILENAME: %gchar*
-     *     - %G_OPTION_ARG_STRING_ARRAY: %gchar**
-     *     - %G_OPTION_ARG_FILENAME_ARRAY: %gchar**
-     *     - %G_OPTION_ARG_DOUBLE: %gdouble
+     *      - %G_OPTION_ARG_NONE: %gboolean
+     *      - %G_OPTION_ARG_STRING: %gchar*
+     *      - %G_OPTION_ARG_INT: %gint
+     *      - %G_OPTION_ARG_FILENAME: %gchar*
+     *      - %G_OPTION_ARG_STRING_ARRAY: %gchar**
+     *      - %G_OPTION_ARG_FILENAME_ARRAY: %gchar**
+     *      - %G_OPTION_ARG_DOUBLE: %gdouble
      *     If `arg` type is %G_OPTION_ARG_STRING or %G_OPTION_ARG_FILENAME,
      *     the location will contain a newly allocated string if the option
      *     was given. That string needs to be freed by the callee using g_free().
@@ -19241,6 +19310,11 @@ export class OptionGroup {
 
     /**
      * Creates a new #GOptionGroup.
+     * 
+     * `description` is typically used to provide a title for the group. If so, it
+     * is recommended that it’s written in title case, and has a trailing colon so
+     * that it matches the style of built-in GLib group titles such as
+     * ‘Application Options:’.
      * @constructor 
      * @param name the name for the option group, this is used to provide   help for the options in this group with `--help-``name`
      * @param description a description for this group to be shown in   `--help`. This string is translated using the translation   domain or translation function of the group
@@ -19252,6 +19326,11 @@ export class OptionGroup {
     constructor(name: string | null, description: string | null, help_description: string | null, user_data: any | null, destroy: DestroyNotify | null) 
     /**
      * Creates a new #GOptionGroup.
+     * 
+     * `description` is typically used to provide a title for the group. If so, it
+     * is recommended that it’s written in title case, and has a trailing colon so
+     * that it matches the style of built-in GLib group titles such as
+     * ‘Application Options:’.
      * @constructor 
      * @param name the name for the option group, this is used to provide   help for the options in this group with `--help-``name`
      * @param description a description for this group to be shown in   `--help`. This string is translated using the translation   domain or translation function of the group
@@ -23481,9 +23560,9 @@ export interface Tree {
      * are O(log(n)).
      * @param key the key to insert
      * @param value the value corresponding to the key
-     * @returns the inserted (or set) node.
+     * @returns the inserted (or set) node or %NULL if insertion would overflow the tree node counter.
      */
-    insert_node(key: any | null, value: any | null): TreeNode
+    insert_node(key: any | null, value: any | null): TreeNode | null
     /**
      * Gets the value corresponding to the given key. Since a #GTree is
      * automatically balanced as key/value pairs are added, key lookup
@@ -23522,7 +23601,7 @@ export interface Tree {
     lower_bound(key: any | null): TreeNode | null
     /**
      * Gets the number of nodes in a #GTree.
-     * @returns the number of nodes in @tree
+     * @returns the number of nodes in @tree The node counter value type is really a #guint, but it is returned as a #gint due to backward compatibility issues (can be cast back to #guint to support its full range of values).
      */
     nnodes(): number
     /**
@@ -23583,9 +23662,9 @@ export interface Tree {
      * so that the distance from the root to every leaf is as small as possible.
      * @param key the key to insert
      * @param value the value corresponding to the key
-     * @returns the inserted (or set) node.
+     * @returns the inserted (or set) node or %NULL if insertion would overflow the tree node counter.
      */
-    replace_node(key: any | null, value: any | null): TreeNode
+    replace_node(key: any | null, value: any | null): TreeNode | null
     /**
      * Removes a key and its associated value from a #GTree without calling
      * the key and value destroy functions.

package/glib-2.0.d.ts

@@ -6434,6 +6434,11 @@ function filename_display_name(filename: string): string | null
 /**
  * Converts an escaped ASCII-encoded URI to a local filename in the
  * encoding used for filenames.
+ * 
+ * Since GLib 2.78, the query string and fragment can be present in the URI,
+ * but are not part of the resulting filename.
+ * We take inspiration from https://url.spec.whatwg.org/#file-state,
+ * but we don't support the entire standard.
  * @param uri a uri describing a filename (escaped, encoded in ASCII).
  * @returns a newly-allocated string holding               the resulting filename, or %NULL on an error.
  */
@@ -9190,7 +9195,7 @@ function spaced_primes_closest(num: number): number
  * @param argv      child's argument vector
  * @param envp      child's environment, or %NULL to inherit parent's
  * @param flags flags from #GSpawnFlags
- * @param child_setup function to run in the child just before exec()
+ * @param child_setup function to run     in the child just before `exec()`
  * @returns %TRUE on success, %FALSE if error is set
  */
 function spawn_async(working_directory: string | null, argv: string[], envp: string[] | null, flags: SpawnFlags, child_setup: SpawnChildSetupFunc | null): [ /* returnType */ boolean, /* child_pid */ Pid ]
@@ -9203,7 +9208,7 @@ function spawn_async(working_directory: string | null, argv: string[], envp: str
  * @param argv child's argument vector, in the GLib file name encoding;   it must be non-empty and %NULL-terminated
  * @param envp child's environment, or %NULL to inherit parent's, in the GLib file name encoding
  * @param flags flags from #GSpawnFlags
- * @param child_setup function to run in the child just before exec()
+ * @param child_setup function to run   in the child just before `exec()`
  * @param stdin_fd file descriptor to use for child's stdin, or `-1`
  * @param stdout_fd file descriptor to use for child's stdout, or `-1`
  * @param stderr_fd file descriptor to use for child's stderr, or `-1`
@@ -9217,7 +9222,7 @@ function spawn_async_with_fds(working_directory: string | null, argv: string[],
  * @param argv child's argument     vector, in the GLib file name encoding; it must be non-empty and %NULL-terminated
  * @param envp      child's environment, or %NULL to inherit parent's, in the GLib file     name encoding
  * @param flags flags from #GSpawnFlags
- * @param child_setup function to run in the child just before exec()
+ * @param child_setup function to run     in the child just before `exec()`
  * @returns %TRUE on success, %FALSE if an error was set
  */
 function spawn_async_with_pipes(working_directory: string | null, argv: string[], envp: string[] | null, flags: SpawnFlags, child_setup: SpawnChildSetupFunc | null): [ /* returnType */ boolean, /* child_pid */ Pid, /* standard_input */ number, /* standard_output */ number, /* standard_error */ number ]
@@ -9420,7 +9425,7 @@ function spawn_async_with_pipes(working_directory: string | null, argv: string[]
  * @param argv child's argument     vector, in the GLib file name encoding; it must be non-empty and %NULL-terminated
  * @param envp      child's environment, or %NULL to inherit parent's, in the GLib file     name encoding
  * @param flags flags from #GSpawnFlags
- * @param child_setup function to run in the child just before `exec()`
+ * @param child_setup function to run     in the child just before `exec()`
  * @param stdin_fd file descriptor to use for child's stdin, or `-1`
  * @param stdout_fd file descriptor to use for child's stdout, or `-1`
  * @param stderr_fd file descriptor to use for child's stderr, or `-1`
@@ -9573,7 +9578,7 @@ function spawn_exit_error_quark(): Quark
  * @param argv      child's argument vector, which must be non-empty and %NULL-terminated
  * @param envp      child's environment, or %NULL to inherit parent's
  * @param flags flags from #GSpawnFlags
- * @param child_setup function to run in the child just before exec()
+ * @param child_setup function to run     in the child just before `exec()`
  * @returns %TRUE on success, %FALSE if an error was set
  */
 function spawn_sync(working_directory: string | null, argv: string[], envp: string[] | null, flags: SpawnFlags, child_setup: SpawnChildSetupFunc | null): [ /* returnType */ boolean, /* standard_output */ Uint8Array, /* standard_error */ Uint8Array, /* wait_status */ number ]
@@ -10020,6 +10025,55 @@ function strrstr_len(haystack: string | null, haystack_len: number, needle: stri
  * @returns a UTF-8 string describing the signal. If the signal is unknown,     it returns "unknown signal (<signum>)".
  */
 function strsignal(signum: number): string | null
+/**
+ * Splits a string into a maximum of `max_tokens` pieces, using the given
+ * `delimiter`. If `max_tokens` is reached, the remainder of `string` is
+ * appended to the last token.
+ * 
+ * As an example, the result of g_strsplit (":a:bc::d:", ":", -1) is a
+ * %NULL-terminated vector containing the six strings "", "a", "bc", "", "d"
+ * and "".
+ * 
+ * As a special case, the result of splitting the empty string "" is an empty
+ * vector, not a vector containing a single string. The reason for this
+ * special case is that being able to represent an empty vector is typically
+ * more useful than consistent handling of empty elements. If you do need
+ * to represent empty elements, you'll need to check for the empty string
+ * before calling g_strsplit().
+ * @param string a string to split
+ * @param delimiter a string which specifies the places at which to split     the string. The delimiter is not included in any of the resulting     strings, unless `max_tokens` is reached.
+ * @param max_tokens the maximum number of pieces to split `string` into.     If this is less than 1, the string is split completely.
+ * @returns a newly-allocated %NULL-terminated array of    strings. Use g_strfreev() to free it.
+ */
+function strsplit(string: string | null, delimiter: string | null, max_tokens: number): string[]
+/**
+ * Splits `string` into a number of tokens not containing any of the characters
+ * in `delimiter`. A token is the (possibly empty) longest string that does not
+ * contain any of the characters in `delimiters`. If `max_tokens` is reached, the
+ * remainder is appended to the last token.
+ * 
+ * For example the result of g_strsplit_set ("abc:def/ghi", ":/", -1) is a
+ * %NULL-terminated vector containing the three strings "abc", "def",
+ * and "ghi".
+ * 
+ * The result of g_strsplit_set (":def/ghi:", ":/", -1) is a %NULL-terminated
+ * vector containing the four strings "", "def", "ghi", and "".
+ * 
+ * As a special case, the result of splitting the empty string "" is an empty
+ * vector, not a vector containing a single string. The reason for this
+ * special case is that being able to represent an empty vector is typically
+ * more useful than consistent handling of empty elements. If you do need
+ * to represent empty elements, you'll need to check for the empty string
+ * before calling g_strsplit_set().
+ * 
+ * Note that this function works on bytes not characters, so it can't be used
+ * to delimit UTF-8 strings for anything but ASCII characters.
+ * @param string The string to be tokenized
+ * @param delimiters A nul-terminated string containing bytes that are used     to split the string (it can accept an empty string, which will result     in no string splitting).
+ * @param max_tokens The maximum number of tokens to split `string` into.     If this is less than 1, the string is split completely
+ * @returns a newly-allocated %NULL-terminated array of    strings. Use g_strfreev() to free it.
+ */
+function strsplit_set(string: string | null, delimiters: string | null, max_tokens: number): string[]
 /**
  * Searches the string `haystack` for the first occurrence
  * of the string `needle,` limiting the length of the search
@@ -10156,6 +10210,14 @@ function test_bug(bug_uri_snippet: string | null): void
  * @param uri_pattern the base pattern for bug URIs
  */
 function test_bug_base(uri_pattern: string | null): void
+/**
+ * Attempt to disable system crash reporting infrastructure.
+ * 
+ * This function should be called before exercising code paths that are
+ * expected or intended to crash, to avoid wasting resources in system-wide
+ * crash collection infrastructure such as systemd-coredump or abrt.
+ */
+function test_disable_crash_reporting(): void
 /**
  * Indicates that a message with the given `log_domain` and `log_level,`
  * with text matching `pattern,` is expected to be logged. When this
@@ -10524,6 +10586,11 @@ function test_trap_reached_timeout(): boolean
  * the subprocess, you can call g_test_subprocess() (after calling
  * g_test_init()) to see whether you are in a subprocess.
  * 
+ * Internally, this function tracks the child process using
+ * g_child_watch_source_new(), so your process must not ignore `SIGCHLD`, and
+ * must not attempt to watch or wait for the child process via another
+ * mechanism.
+ * 
  * The following example tests that calling
  * `my_object_new(1000000)` will abort with an error
  * message.
@@ -10980,10 +11047,9 @@ function unichar_fully_decompose(ch: string, compat: boolean, result_len: number
  * glyph and `mirrored_ch` is set, it puts that character in the address
  * pointed to by `mirrored_ch`.  Otherwise the original character is put.
  * @param ch a Unicode character
- * @param mirrored_ch location to store the mirrored character
  * @returns %TRUE if @ch has a mirrored character, %FALSE otherwise
  */
-function unichar_get_mirror_char(ch: string, mirrored_ch: string): boolean
+function unichar_get_mirror_char(ch: string): [ /* returnType */ boolean, /* mirrored_ch */ string ]
 /**
  * Looks up the #GUnicodeScript for a particular character (as defined
  * by Unicode Standard Annex \#24). No check is made for `ch` being a
@@ -11292,15 +11358,18 @@ function unix_get_passwd_entry(user_name: string | null): any | null
  * uses the pipe2() system call, which atomically creates a pipe with
  * the configured flags.
  * 
- * As of GLib 2.78, the supported flags are `FD_CLOEXEC` and `O_NONBLOCK`. Prior
- * to GLib 2.78, only `FD_CLOEXEC` was supported — if you wanted to configure
- * `O_NONBLOCK` then that had to be done separately with `fcntl()`.
+ * As of GLib 2.78, the supported flags are `O_CLOEXEC`/`FD_CLOEXEC` (see below)
+ * and `O_NONBLOCK`. Prior to GLib 2.78, only `FD_CLOEXEC` was supported — if
+ * you wanted to configure `O_NONBLOCK` then that had to be done separately with
+ * `fcntl()`.
  * 
  * It is a programmer error to call this function with unsupported flags, and a
  * critical warning will be raised.
  * 
- * This function does not take `O_CLOEXEC`, it takes `FD_CLOEXEC` as if
- * for fcntl(); these are different on Linux/glibc.
+ * As of GLib 2.78, it is preferred to pass `O_CLOEXEC` in, rather than
+ * `FD_CLOEXEC`, as that matches the underlying `pipe()` API more closely. Prior
+ * to 2.78, only `FD_CLOEXEC` was supported. Support for `FD_CLOEXEC` may be
+ * deprecated and removed in future.
  * @param fds Array of two integers
  * @param flags Bitfield of file descriptor flags, as for fcntl()
  * @returns %TRUE on success, %FALSE if not (and errno will be set).
@@ -19135,13 +19204,13 @@ interface OptionEntry {
      *     called to handle the extra argument. Otherwise, `arg_data` is a
      *     pointer to a location to store the value, the required type of
      *     the location depends on the `arg` type:
-     *     - %G_OPTION_ARG_NONE: %gboolean
-     *     - %G_OPTION_ARG_STRING: %gchar*
-     *     - %G_OPTION_ARG_INT: %gint
-     *     - %G_OPTION_ARG_FILENAME: %gchar*
-     *     - %G_OPTION_ARG_STRING_ARRAY: %gchar**
-     *     - %G_OPTION_ARG_FILENAME_ARRAY: %gchar**
-     *     - %G_OPTION_ARG_DOUBLE: %gdouble
+     *      - %G_OPTION_ARG_NONE: %gboolean
+     *      - %G_OPTION_ARG_STRING: %gchar*
+     *      - %G_OPTION_ARG_INT: %gint
+     *      - %G_OPTION_ARG_FILENAME: %gchar*
+     *      - %G_OPTION_ARG_STRING_ARRAY: %gchar**
+     *      - %G_OPTION_ARG_FILENAME_ARRAY: %gchar**
+     *      - %G_OPTION_ARG_DOUBLE: %gdouble
      *     If `arg` type is %G_OPTION_ARG_STRING or %G_OPTION_ARG_FILENAME,
      *     the location will contain a newly allocated string if the option
      *     was given. That string needs to be freed by the callee using g_free().
@@ -19243,6 +19312,11 @@ class OptionGroup {
 
     /**
      * Creates a new #GOptionGroup.
+     * 
+     * `description` is typically used to provide a title for the group. If so, it
+     * is recommended that it’s written in title case, and has a trailing colon so
+     * that it matches the style of built-in GLib group titles such as
+     * ‘Application Options:’.
      * @constructor 
      * @param name the name for the option group, this is used to provide   help for the options in this group with `--help-``name`
      * @param description a description for this group to be shown in   `--help`. This string is translated using the translation   domain or translation function of the group
@@ -19254,6 +19328,11 @@ class OptionGroup {
     constructor(name: string | null, description: string | null, help_description: string | null, user_data: any | null, destroy: DestroyNotify | null) 
     /**
      * Creates a new #GOptionGroup.
+     * 
+     * `description` is typically used to provide a title for the group. If so, it
+     * is recommended that it’s written in title case, and has a trailing colon so
+     * that it matches the style of built-in GLib group titles such as
+     * ‘Application Options:’.
      * @constructor 
      * @param name the name for the option group, this is used to provide   help for the options in this group with `--help-``name`
      * @param description a description for this group to be shown in   `--help`. This string is translated using the translation   domain or translation function of the group
@@ -23483,9 +23562,9 @@ interface Tree {
      * are O(log(n)).
      * @param key the key to insert
      * @param value the value corresponding to the key
-     * @returns the inserted (or set) node.
+     * @returns the inserted (or set) node or %NULL if insertion would overflow the tree node counter.
      */
-    insert_node(key: any | null, value: any | null): TreeNode
+    insert_node(key: any | null, value: any | null): TreeNode | null
     /**
      * Gets the value corresponding to the given key. Since a #GTree is
      * automatically balanced as key/value pairs are added, key lookup
@@ -23524,7 +23603,7 @@ interface Tree {
     lower_bound(key: any | null): TreeNode | null
     /**
      * Gets the number of nodes in a #GTree.
-     * @returns the number of nodes in @tree
+     * @returns the number of nodes in @tree The node counter value type is really a #guint, but it is returned as a #gint due to backward compatibility issues (can be cast back to #guint to support its full range of values).
      */
     nnodes(): number
     /**
@@ -23585,9 +23664,9 @@ interface Tree {
      * so that the distance from the root to every leaf is as small as possible.
      * @param key the key to insert
      * @param value the value corresponding to the key
-     * @returns the inserted (or set) node.
+     * @returns the inserted (or set) node or %NULL if insertion would overflow the tree node counter.
      */
-    replace_node(key: any | null, value: any | null): TreeNode
+    replace_node(key: any | null, value: any | null): TreeNode | null
     /**
      * Removes a key and its associated value from a #GTree without calling
      * the key and value destroy functions.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@girs/glib-2.0",
-  "version": "2.77.0-3.2.2",
-  "description": "GJS TypeScript type definitions for GLib-2.0, generated from library version 2.77.0",
+  "version": "2.78.0-3.2.4",
+  "description": "GJS TypeScript type definitions for GLib-2.0, generated from library version 2.78.0",
   "type": "module",
   "module": "glib-2.0.js",
   "main": "glib-2.0.js",
@@ -25,8 +25,8 @@
     "test:cjs": "NODE_OPTIONS=--max_old_space_size=9216 tsc --noEmit glib-2.0.d.cts"
   },
   "dependencies": {
-    "@girs/gjs": "^3.2.2",
-    "@girs/gobject-2.0": "^2.77.0-3.2.2"
+    "@girs/gjs": "^3.2.4",
+    "@girs/gobject-2.0": "^2.78.0-3.2.4"
   },
   "devDependencies": {
     "typescript": "*"