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

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.5.
 
 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.
 
@@ -82,6 +82,19 @@ Now you have also type support for this, too:
 const GLib = imports.gi.GLib;
 ```
 
+
+### ESM vs. CommonJS
+
+GJS supports two different import syntaxes. The new modern ESM syntax and the old global imports syntax.
+
+In TypeScript projects for GJS and GNOME Shell extensions, you have the flexibility to use `ESM` syntax and then decide the import syntax for your bundled file. If your bundler is configured to use `CommonJS`, it will convert to the GJS-specific global imports syntax, like `const moduleName = imports.gi[moduleName]`. This is different from the traditional `require` syntax seen in Node.js. The global imports syntax is chosen because it aligns with the CommonJS format supported by NPM, which is used for the generated type definitions and this package.
+
+On the other hand, if you configure your bundler to use ESM, it will retain the ESM import syntax. It's crucial to ensure that your bundler is set up to correctly translate and bundle these imports into either CommonJS or ESM format, depending on your project's requirements.
+
+This approach is particularly important due to the `@girs` types, which include both `*.cjs `files, using the GJS global imports syntax, and `*.js` files, which utilize the ESM syntax. By appropriately setting up your bundler, you can control which syntax—CommonJS or ESM—is used in your project. The choice of CommonJS in this context is also due to the similarity between the GJS-specific global imports and CommonJS syntax, allowing for easier management and bundling in these specific types of projects.
+
+Since GNOME Shell 45, you should only use ESM, even for GNOME Shell extensions. Before that, extensions had to use the global import syntax, unlike normal GJS applications, where ESM has been available for some time.
+
 ### Bundle
 
 Depending on your project configuration, it is recommended to use a bundler like [esbuild](https://esbuild.github.io/). You can find examples using different bundlers [here](https://github.com/gjsify/ts-for-gir/tree/main/examples).

package/glib-2.0-ambient.d.ts

@@ -1,5 +1,4 @@
 
-
 declare module 'gi://GLib?version=2.0' {
     import GLib20 from '@girs/glib-2.0';
     export default GLib20;

package/glib-2.0-import.d.ts

@@ -1,5 +1,4 @@
 
-
 import GLib20 from '@girs/glib-2.0';
 
 declare global {

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.5",
+  "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.5",
+    "@girs/gobject-2.0": "^2.78.0-3.2.5"
   },
   "devDependencies": {
     "typescript": "*"