@girs/glib-2.0 2.82.2-4.0.0-beta.18 → 2.82.4-4.0.0-beta.20

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.82.2 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.18.
+GJS TypeScript type definitions for GLib-2.0, generated from library version 2.82.4 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.20.
 
 
 ## Install

package/glib-2.0.d.ts

@@ -4609,6 +4609,11 @@ export namespace GLib {
      * If the reference was the last one, it will call `clear_func`
      * to clear the contents of `mem_block,` and then will free the
      * resources allocated for `mem_block`.
+     *
+     * Note that implementing weak references via `clear_func` is not thread-safe:
+     * clearing a pointer to the memory from the callback can race with another
+     * thread trying to access it as `mem_block` already has a reference count of 0
+     * when the callback is called and will be freed.
      * @param mem_block a pointer to reference counted data
      */
     function atomic_rc_box_release_full(mem_block: any): void;
@@ -5027,7 +5032,7 @@ export namespace GLib {
      * @param checksum_type a #GChecksumType
      * @returns the checksum length, or -1 if @checksum_type is not supported.
      */
-    function checksum_type_get_length(checksum_type: ChecksumType): number;
+    function checksum_type_get_length(checksum_type: ChecksumType | null): number;
     /**
      * Sets a function to be called when the child indicated by `pid`
      * exits, at the priority `priority`.
@@ -5184,7 +5189,7 @@ export namespace GLib {
      * @param data binary blob to compute the digest of
      * @returns the digest of the binary data as a   string in hexadecimal, or %NULL if g_checksum_new() fails for   @checksum_type. The returned string should be freed with g_free() when   done using it.
      */
-    function compute_checksum_for_bytes(checksum_type: ChecksumType, data: Bytes | Uint8Array): string | null;
+    function compute_checksum_for_bytes(checksum_type: ChecksumType | null, data: Bytes | Uint8Array): string | null;
     /**
      * Computes the checksum for a binary `data` of `length`. This is a
      * convenience wrapper for g_checksum_new(), g_checksum_get_string()
@@ -5195,7 +5200,7 @@ export namespace GLib {
      * @param data binary blob to compute the digest of
      * @returns the digest of the binary data as a   string in hexadecimal, or %NULL if g_checksum_new() fails for   @checksum_type. The returned string should be freed with g_free() when   done using it.
      */
-    function compute_checksum_for_data(checksum_type: ChecksumType, data: Uint8Array | string): string | null;
+    function compute_checksum_for_data(checksum_type: ChecksumType | null, data: Uint8Array | string): string | null;
     /**
      * Computes the checksum of a string.
      *
@@ -5205,7 +5210,11 @@ export namespace GLib {
      * @param length the length of the string, or -1 if the string is null-terminated.
      * @returns the checksum as a hexadecimal string,   or %NULL if g_checksum_new() fails for @checksum_type. The returned string   should be freed with g_free() when done using it.
      */
-    function compute_checksum_for_string(checksum_type: ChecksumType, str: string, length: number): string | null;
+    function compute_checksum_for_string(
+        checksum_type: ChecksumType | null,
+        str: string,
+        length: number,
+    ): string | null;
     /**
      * Computes the HMAC for a binary `data`. This is a
      * convenience wrapper for g_hmac_new(), g_hmac_get_string()
@@ -5218,7 +5227,7 @@ export namespace GLib {
      * @returns the HMAC of the binary data as a string in hexadecimal.   The returned string should be freed with g_free() when done using it.
      */
     function compute_hmac_for_bytes(
-        digest_type: ChecksumType,
+        digest_type: ChecksumType | null,
         key: Bytes | Uint8Array,
         data: Bytes | Uint8Array,
     ): string;
@@ -5234,7 +5243,7 @@ export namespace GLib {
      * @returns the HMAC of the binary data as a string in hexadecimal.   The returned string should be freed with g_free() when done using it.
      */
     function compute_hmac_for_data(
-        digest_type: ChecksumType,
+        digest_type: ChecksumType | null,
         key: Uint8Array | string,
         data: Uint8Array | string,
     ): string;
@@ -5249,7 +5258,7 @@ export namespace GLib {
      * @returns the HMAC as a hexadecimal string.     The returned string should be freed with g_free()     when done using it.
      */
     function compute_hmac_for_string(
-        digest_type: ChecksumType,
+        digest_type: ChecksumType | null,
         key: Uint8Array | string,
         str: string,
         length: number,
@@ -5431,7 +5440,7 @@ export namespace GLib {
      * @param year year
      * @returns number of days in @month during the @year
      */
-    function date_get_days_in_month(month: DateMonth, year: DateYear): number;
+    function date_get_days_in_month(month: DateMonth | null, year: DateYear): number;
     /**
      * Returns the number of weeks in the year, where weeks
      * are taken to start on Monday. Will be 52 or 53. The
@@ -5504,7 +5513,7 @@ export namespace GLib {
      * @param year year
      * @returns %TRUE if the date is a valid one
      */
-    function date_valid_dmy(day: DateDay, month: DateMonth, year: DateYear): boolean;
+    function date_valid_dmy(day: DateDay, month: DateMonth | null, year: DateYear): boolean;
     /**
      * Returns %TRUE if the Julian day is valid. Anything greater than zero
      * is basically a valid Julian, though there is a 32-bit limit.
@@ -5518,14 +5527,14 @@ export namespace GLib {
      * @param month month
      * @returns %TRUE if the month is valid
      */
-    function date_valid_month(month: DateMonth): boolean;
+    function date_valid_month(month: DateMonth | null): boolean;
     /**
      * Returns %TRUE if the weekday is valid. The seven #GDateWeekday enumeration
      * values are the only valid weekdays.
      * @param weekday weekday
      * @returns %TRUE if the weekday is valid
      */
-    function date_valid_weekday(weekday: DateWeekday): boolean;
+    function date_valid_weekday(weekday: DateWeekday | null): boolean;
     /**
      * Returns %TRUE if the year is valid. Any year greater than 0 is valid,
      * though there is a 16-bit limit to what #GDate will understand.
@@ -5944,7 +5953,7 @@ export namespace GLib {
     function file_set_contents_full(
         filename: string,
         contents: Uint8Array | string,
-        flags: FileSetContentsFlags,
+        flags: FileSetContentsFlags | null,
         mode: number,
     ): boolean;
     /**
@@ -6013,7 +6022,7 @@ export namespace GLib {
      * @param test bitfield of #GFileTest flags
      * @returns whether a test was %TRUE
      */
-    function file_test(filename: string, test: FileTest): boolean;
+    function file_test(filename: string, test: FileTest | null): boolean;
     /**
      * Returns the display basename for the particular filename, guaranteed
      * to be valid UTF-8. The display name might not be identical to the filename,
@@ -6194,7 +6203,7 @@ export namespace GLib {
      * @param flags #GFormatSizeFlags to modify the output
      * @returns a newly-allocated formatted string   containing a human readable file size
      */
-    function format_size_full(size: number, flags: FormatSizeFlags): string;
+    function format_size_full(size: number, flags: FormatSizeFlags | null): string;
     /**
      * Frees the memory pointed to by `mem`.
      *
@@ -6719,7 +6728,7 @@ export namespace GLib {
      * @param directory the logical id of special directory
      * @returns the path to the specified special   directory, or %NULL if the logical id was not found. The returned string is   owned by GLib and should not be modified or freed.
      */
-    function get_user_special_dir(directory: UserDirectory): string | null;
+    function get_user_special_dir(directory: UserDirectory | null): string | null;
     /**
      * Returns a base directory in which to store state files specific to
      * particular user.
@@ -7252,7 +7261,7 @@ export namespace GLib {
      * @param func the function to call when the condition is satisfied
      * @returns the event source id
      */
-    function io_add_watch(channel: IOChannel, priority: number, condition: IOCondition, func: IOFunc): number;
+    function io_add_watch(channel: IOChannel, priority: number, condition: IOCondition | null, func: IOFunc): number;
     /**
      * Converts an `errno` error number to a #GIOChannelError.
      * @param en an `errno` error number, e.g. `EINVAL`
@@ -7279,7 +7288,7 @@ export namespace GLib {
      * @param condition conditions to watch for
      * @returns a new #GSource
      */
-    function io_create_watch(channel: IOChannel, condition: IOCondition): Source;
+    function io_create_watch(channel: IOChannel, condition: IOCondition | null): Source;
     function key_file_error_quark(): Quark;
     function list_pop_allocator(): void;
     function list_push_allocator(allocator: Allocator): void;
@@ -7362,7 +7371,7 @@ export namespace GLib {
      */
     function log_default_handler(
         log_domain: string | null,
-        log_level: LogLevelFlags,
+        log_level: LogLevelFlags | null,
         message?: string | null,
         unused_data?: any | null,
     ): void;
@@ -7408,7 +7417,7 @@ export namespace GLib {
      * @param fatal_mask the mask containing bits set for each level of error which is   to be fatal
      * @returns the old fatal mask
      */
-    function log_set_always_fatal(fatal_mask: LogLevelFlags): LogLevelFlags;
+    function log_set_always_fatal(fatal_mask: LogLevelFlags | null): LogLevelFlags;
     /**
      * Enable or disable debug output from the GLib logging system for all domains.
      *
@@ -7440,7 +7449,7 @@ export namespace GLib {
      * @param fatal_mask the new fatal mask
      * @returns the old fatal mask for the log domain
      */
-    function log_set_fatal_mask(log_domain: string, fatal_mask: LogLevelFlags): LogLevelFlags;
+    function log_set_fatal_mask(log_domain: string, fatal_mask: LogLevelFlags | null): LogLevelFlags;
     /**
      * Like [func`GLib`.log_set_handler], but takes a destroy notify for the `user_data`.
      *
@@ -7451,7 +7460,7 @@ export namespace GLib {
      * @param log_func the log handler function
      * @returns the ID of the new handler
      */
-    function log_set_handler(log_domain: string | null, log_levels: LogLevelFlags, log_func: LogFunc): number;
+    function log_set_handler(log_domain: string | null, log_levels: LogLevelFlags | null, log_func: LogFunc): number;
     /**
      * Set a writer function which will be called to format and write out each log
      * message.
@@ -7482,7 +7491,7 @@ export namespace GLib {
      * @param log_level log level, either from [type@GLib.LogLevelFlags], or a user-defined    level
      * @param fields key–value pairs of structured data to add    to the log message
      */
-    function log_structured_array(log_level: LogLevelFlags, fields: LogField[]): void;
+    function log_structured_array(log_level: LogLevelFlags | null, fields: LogField[]): void;
     /**
      * Log a message with structured data, accepting the data within a [type`GLib`.Variant].
      *
@@ -7503,7 +7512,7 @@ export namespace GLib {
      * @param log_level log level, either from [type@GLib.LogLevelFlags], or a user-defined    level
      * @param fields a dictionary ([type@GLib.Variant] of the type `G_VARIANT_TYPE_VARDICT`) containing the key-value pairs of message data.
      */
-    function log_variant(log_domain: string | null, log_level: LogLevelFlags, fields: Variant): void;
+    function log_variant(log_domain: string | null, log_level: LogLevelFlags | null, fields: Variant): void;
     /**
      * Format a structured log message and output it to the default log destination
      * for the platform.
@@ -7531,7 +7540,11 @@ export namespace GLib {
      * @param user_data user data passed to [func@GLib.log_set_writer_func]
      * @returns [enum@GLib.LogWriterOutput.HANDLED] on success,   [enum@GLib.LogWriterOutput.UNHANDLED] otherwise
      */
-    function log_writer_default(log_level: LogLevelFlags, fields: LogField[], user_data?: any | null): LogWriterOutput;
+    function log_writer_default(
+        log_level: LogLevelFlags | null,
+        fields: LogField[],
+        user_data?: any | null,
+    ): LogWriterOutput;
     /**
      * Reset the list of domains to be logged, that might be initially set by the
      * `G_MESSAGES_DEBUG` environment variable.
@@ -7591,7 +7604,7 @@ export namespace GLib {
      * @param log_domain log domain
      * @returns `TRUE` if the log message would be dropped by GLib’s   default log handlers
      */
-    function log_writer_default_would_drop(log_level: LogLevelFlags, log_domain?: string | null): boolean;
+    function log_writer_default_would_drop(log_level: LogLevelFlags | null, log_domain?: string | null): boolean;
     /**
      * Format a structured log message as a string suitable for outputting to the
      * terminal (or elsewhere).
@@ -7609,7 +7622,7 @@ export namespace GLib {
      * @param use_color `TRUE` to use   [ANSI color escape sequences](https://en.wikipedia.org/wiki/ANSI_escape_code)   when formatting the message, `FALSE` to not
      * @returns string containing the formatted log message, in    the character set of the current locale
      */
-    function log_writer_format_fields(log_level: LogLevelFlags, fields: LogField[], use_color: boolean): string;
+    function log_writer_format_fields(log_level: LogLevelFlags | null, fields: LogField[], use_color: boolean): string;
     /**
      * Check whether the given `output_fd` file descriptor is a connection to the
      * systemd journal, or something else (like a log file or `stdout` or
@@ -7641,7 +7654,11 @@ export namespace GLib {
      * @param user_data user data passed to [func@GLib.log_set_writer_func]
      * @returns [enum@GLib.LogWriterOutput.HANDLED] on success, [enum@GLib.LogWriterOutput.UNHANDLED] otherwise
      */
-    function log_writer_journald(log_level: LogLevelFlags, fields: LogField[], user_data?: any | null): LogWriterOutput;
+    function log_writer_journald(
+        log_level: LogLevelFlags | null,
+        fields: LogField[],
+        user_data?: any | null,
+    ): LogWriterOutput;
     /**
      * Format a structured log message and print it to either `stdout` or `stderr`,
      * depending on its log level.
@@ -7666,7 +7683,7 @@ export namespace GLib {
      * @returns [enum@GLib.LogWriterOutput.HANDLED] on success,   [enum@GLib.LogWriterOutput.UNHANDLED] otherwise
      */
     function log_writer_standard_streams(
-        log_level: LogLevelFlags,
+        log_level: LogLevelFlags | null,
         fields: LogField[],
         user_data?: any | null,
     ): LogWriterOutput;
@@ -7697,7 +7714,11 @@ export namespace GLib {
      * @param user_data user data passed to [func@GLib.log_set_writer_func]
      * @returns [enum@GLib.LogWriterOutput.HANDLED] on success, [enum@GLib.LogWriterOutput.UNHANDLED] otherwise
      */
-    function log_writer_syslog(log_level: LogLevelFlags, fields: LogField[], user_data?: any | null): LogWriterOutput;
+    function log_writer_syslog(
+        log_level: LogLevelFlags | null,
+        fields: LogField[],
+        user_data?: any | null,
+    ): LogWriterOutput;
     /**
      * A wrapper for the POSIX lstat() function. The lstat() function is
      * like stat() except that in the case of symbolic links, it returns
@@ -8718,8 +8739,8 @@ export namespace GLib {
     function regex_match_simple(
         pattern: string,
         string: string,
-        compile_options: RegexCompileFlags,
-        match_options: RegexMatchFlags,
+        compile_options: RegexCompileFlags | null,
+        match_options: RegexMatchFlags | null,
     ): boolean;
     /**
      * Breaks the string on the pattern, and returns an array of
@@ -8758,8 +8779,8 @@ export namespace GLib {
     function regex_split_simple(
         pattern: string,
         string: string,
-        compile_options: RegexCompileFlags,
-        match_options: RegexMatchFlags,
+        compile_options: RegexCompileFlags | null,
+        match_options: RegexMatchFlags | null,
     ): string[];
     /**
      * Resets the cache used for g_get_user_special_dir(), so
@@ -8976,14 +8997,6 @@ export namespace GLib {
      * @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
@@ -9152,9 +9165,9 @@ export namespace GLib {
      * @param next_offset the offset of the @next field in the blocks
      */
     function slice_free_chain_with_offset(block_size: number, mem_chain: any | null, next_offset: number): void;
-    function slice_get_config(ckey: SliceConfig): number;
-    function slice_get_config_state(ckey: SliceConfig, address: number, n_values: number): number;
-    function slice_set_config(ckey: SliceConfig, value: number): void;
+    function slice_get_config(ckey: SliceConfig | null): number;
+    function slice_get_config_state(ckey: SliceConfig | null, address: number, n_values: number): number;
+    function slice_set_config(ckey: SliceConfig | null, value: number): void;
     function slist_pop_allocator(): void;
     function slist_push_allocator(allocator: Allocator): void;
     /**
@@ -9259,7 +9272,7 @@ export namespace GLib {
         working_directory: string | null,
         argv: string[],
         envp: string[] | null,
-        flags: SpawnFlags,
+        flags: SpawnFlags | null,
         child_setup?: SpawnChildSetupFunc | null,
     ): [boolean, Pid | null];
     /**
@@ -9281,7 +9294,7 @@ export namespace GLib {
         working_directory: string | null,
         argv: string[],
         envp: string[] | null,
-        flags: SpawnFlags,
+        flags: SpawnFlags | null,
         child_setup: SpawnChildSetupFunc | null,
         stdin_fd: number,
         stdout_fd: number,
@@ -9301,7 +9314,7 @@ export namespace GLib {
         working_directory: string | null,
         argv: string[],
         envp: string[] | null,
-        flags: SpawnFlags,
+        flags: SpawnFlags | null,
         child_setup: SpawnChildSetupFunc | null,
     ): [boolean, Pid | null, number, number, number];
     /**
@@ -9515,7 +9528,7 @@ export namespace GLib {
         working_directory: string | null,
         argv: string[],
         envp: string[] | null,
-        flags: SpawnFlags,
+        flags: SpawnFlags | null,
         child_setup: SpawnChildSetupFunc | null,
         stdin_fd: number,
         stdout_fd: number,
@@ -9674,7 +9687,7 @@ export namespace GLib {
         working_directory: string | null,
         argv: string[],
         envp: string[] | null,
-        flags: SpawnFlags,
+        flags: SpawnFlags | null,
         child_setup: SpawnChildSetupFunc | null,
     ): [boolean, Uint8Array | null, Uint8Array | null, number];
     /**
@@ -10413,7 +10426,7 @@ export namespace GLib {
      * @param log_level the log level of the message
      * @param pattern a glob-style pattern (see [type@GLib.PatternSpec])
      */
-    function test_expect_message(log_domain: string | null, log_level: LogLevelFlags, pattern: string): void;
+    function test_expect_message(log_domain: string | null, log_level: LogLevelFlags | null, pattern: string): void;
     /**
      * Indicates that a test failed. This function can be called
      * multiple times from the same test. You can use this function
@@ -10459,7 +10472,7 @@ export namespace GLib {
      * @param file_type the type of file (built vs. distributed)
      * @returns the path of the directory, owned by GLib
      */
-    function test_get_dir(file_type: TestFileType): string;
+    function test_get_dir(file_type: TestFileType | null): string;
     /**
      * Gets the test path for the test currently being run.
      *
@@ -10486,7 +10499,7 @@ export namespace GLib {
      * @param msg explanation
      */
     function test_incomplete(msg?: string | null): void;
-    function test_log_type_name(log_type: TestLogType): string;
+    function test_log_type_name(log_type: TestLogType | null): string;
     /**
      * Enqueues a callback `destroy_func` to be executed during the next test case
      * teardown phase.
@@ -10704,7 +10717,7 @@ export namespace GLib {
      * @param test_trap_flags Flags to modify forking behaviour.
      * @returns %TRUE for the forked child and %FALSE for the executing parent process.
      */
-    function test_trap_fork(usec_timeout: number, test_trap_flags: TestTrapFlags): boolean;
+    function test_trap_fork(usec_timeout: number, test_trap_flags: TestTrapFlags | null): boolean;
     /**
      * Check the result of the last g_test_trap_subprocess() call.
      * @returns %TRUE if the last test subprocess terminated successfully.
@@ -10727,7 +10740,7 @@ export namespace GLib {
     function test_trap_subprocess(
         test_path: string | null,
         usec_timeout: number,
-        test_flags: TestSubprocessFlags,
+        test_flags: TestSubprocessFlags | null,
     ): void;
     /**
      * Respawns the test program to run only `test_path` in a subprocess with the
@@ -10831,7 +10844,7 @@ export namespace GLib {
         test_path: string | null,
         envp: string[] | null,
         usec_timeout: number,
-        test_flags: TestSubprocessFlags,
+        test_flags: TestSubprocessFlags | null,
     ): void;
     function thread_error_quark(): Quark;
     /**
@@ -11527,7 +11540,7 @@ export namespace GLib {
      * @param script a Unicode script
      * @returns the ISO 15924 code for @script, encoded as an integer,   of zero if @script is %G_UNICODE_SCRIPT_INVALID_CODE or   ISO 15924 code 'Zzzz' (script code for UNKNOWN) if @script is not understood.
      */
-    function unicode_script_to_iso15924(script: UnicodeScript): number;
+    function unicode_script_to_iso15924(script: UnicodeScript | null): number;
     function unix_error_quark(): Quark;
     /**
      * Sets a function to be called when the IO condition, as specified by
@@ -11545,7 +11558,7 @@ export namespace GLib {
     function unix_fd_add_full(
         priority: number,
         fd: number,
-        condition: IOCondition,
+        condition: IOCondition | null,
         _function: UnixFDSourceFunc,
     ): number;
     /**
@@ -11560,7 +11573,7 @@ export namespace GLib {
      * @param condition I/O conditions to watch for on @fd
      * @returns the newly created #GSource
      */
-    function unix_fd_source_new(fd: number, condition: IOCondition): Source;
+    function unix_fd_source_new(fd: number, condition: IOCondition | null): Source;
     /**
      * Get the `passwd` file entry for the given `user_name` using `getpwnam_r()`.
      * This can fail if the given `user_name` doesn’t exist.
@@ -11699,7 +11712,7 @@ export namespace GLib {
      * @returns a new #GUri
      */
     function uri_build(
-        flags: UriFlags,
+        flags: UriFlags | null,
         scheme: string,
         userinfo: string | null,
         host: string | null,
@@ -11730,7 +11743,7 @@ export namespace GLib {
      * @returns a new #GUri
      */
     function uri_build_with_user(
-        flags: UriFlags,
+        flags: UriFlags | null,
         scheme: string,
         user: string | null,
         password: string | null,
@@ -11787,7 +11800,7 @@ export namespace GLib {
      * @param flags flags for parsing @uri_string
      * @returns %TRUE if @uri_string is a valid absolute URI, %FALSE on error.
      */
-    function uri_is_valid(uri_string: string, flags: UriFlags): boolean;
+    function uri_is_valid(uri_string: string, flags: UriFlags | null): boolean;
     /**
      * Joins the given components together according to `flags` to create
      * an absolute URI string. `path` may not be %NULL (though it may be the empty
@@ -11814,7 +11827,7 @@ export namespace GLib {
      * @returns an absolute URI string
      */
     function uri_join(
-        flags: UriFlags,
+        flags: UriFlags | null,
         scheme: string | null,
         userinfo: string | null,
         host: string | null,
@@ -11846,7 +11859,7 @@ export namespace GLib {
      * @returns an absolute URI string
      */
     function uri_join_with_user(
-        flags: UriFlags,
+        flags: UriFlags | null,
         scheme: string | null,
         user: string | null,
         password: string | null,
@@ -11873,7 +11886,7 @@ export namespace GLib {
      * @param flags flags describing how to parse @uri_string
      * @returns a new #GUri, or NULL on error.
      */
-    function uri_parse(uri_string: string, flags: UriFlags): Uri;
+    function uri_parse(uri_string: string, flags: UriFlags | null): Uri;
     /**
      * Many URI schemes include one or more attribute/value pairs as part of the URI
      * value. This method can be used to parse them into a hash table. When an
@@ -11909,7 +11922,7 @@ export namespace GLib {
         params: string,
         length: number,
         separators: string,
-        flags: UriParamsFlags,
+        flags: UriParamsFlags | null,
     ): HashTable<string, string>;
     /**
      * Gets the scheme portion of a URI string.
@@ -11955,7 +11968,7 @@ export namespace GLib {
      * @param flags flags describing how to parse @uri_ref
      * @returns the resolved URI string, or NULL on error.
      */
-    function uri_resolve_relative(base_uri_string: string | null, uri_ref: string, flags: UriFlags): string;
+    function uri_resolve_relative(base_uri_string: string | null, uri_ref: string, flags: UriFlags | null): string;
     /**
      * Parses `uri_ref` (which can be an
      * [absolute or relative URI](#relative-and-absolute-uris)) according to `flags,` and
@@ -11979,7 +11992,7 @@ export namespace GLib {
      */
     function uri_split(
         uri_ref: string,
-        flags: UriFlags,
+        flags: UriFlags | null,
     ): [boolean, string, string, string, number, string, string, string];
     /**
      * Parses `uri_string` (which must be an [absolute URI](#relative-and-absolute-uris))
@@ -11992,7 +12005,7 @@ export namespace GLib {
      * @param flags flags for parsing @uri_string
      * @returns %TRUE if @uri_string parsed successfully,   %FALSE on error.
      */
-    function uri_split_network(uri_string: string, flags: UriFlags): [boolean, string, string, number];
+    function uri_split_network(uri_string: string, flags: UriFlags | null): [boolean, string, string, number];
     /**
      * Parses `uri_ref` (which can be an
      * [absolute or relative URI](#relative-and-absolute-uris)) according to `flags,` and
@@ -12011,7 +12024,7 @@ export namespace GLib {
      */
     function uri_split_with_user(
         uri_ref: string,
-        flags: UriFlags,
+        flags: UriFlags | null,
     ): [boolean, string, string, string, string, string, number, string, string, string];
     /**
      * Unescapes a segment of an escaped string as binary data.
@@ -12264,7 +12277,7 @@ export namespace GLib {
      * @param mode the type of normalization to perform.
      * @returns a newly allocated string, that   is the normalized form of @str, or %NULL if @str   is not valid UTF-8.
      */
-    function utf8_normalize(str: string, len: number, mode: NormalizeMode): string | null;
+    function utf8_normalize(str: string, len: number, mode: NormalizeMode | null): string | null;
     /**
      * Converts from an integer character offset to a pointer to a position
      * within the string.
@@ -16010,7 +16023,7 @@ export namespace GLib {
          * @param month month
          * @param y year
          */
-        set_dmy(day: DateDay, month: DateMonth, y: DateYear): void;
+        set_dmy(day: DateDay, month: DateMonth | null, y: DateYear): void;
         /**
          * Sets the value of a #GDate from a Julian day number.
          * @param julian_date Julian day number (days since January 1, Year 1)
@@ -16021,7 +16034,7 @@ export namespace GLib {
          * day-month-year triplet is invalid, the date will be invalid.
          * @param month month to set
          */
-        set_month(month: DateMonth): void;
+        set_month(month: DateMonth | null): void;
         /**
          * Parses a user-inputted string `str,` and try to figure out what date it
          * represents, taking the [current locale][setlocale] into account. If the
@@ -17254,24 +17267,85 @@ 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: number, key_len: number);
+        constructor(digest_type: ChecksumType, key: Uint8Array | string);
         _init(...args: any[]): void;
 
-        static ['new'](digest_type: ChecksumType, key: number, key_len: number): Hmac;
+        static ['new'](digest_type: ChecksumType, key: Uint8Array | string): 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;
-        get_digest(buffer: number, digest_len: number): void;
+        /**
+         * 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_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;
-        update(data: number, length: number): 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;
     }
 
     /**
@@ -17589,14 +17663,14 @@ export namespace GLib {
          * @param type the position in the file, which can be %G_SEEK_CUR (the current        position), %G_SEEK_SET (the start of the file), or %G_SEEK_END        (the end of the file)
          * @returns %G_IO_ERROR_NONE if the operation was successful.
          */
-        seek(offset: number, type: SeekType): IOError;
+        seek(offset: number, type: SeekType | null): IOError;
         /**
          * Replacement for g_io_channel_seek() with the new API.
          * @param offset The offset in bytes from the position specified by @type
          * @param type a #GSeekType. The type %G_SEEK_CUR is only allowed in those                      cases where a call to g_io_channel_set_encoding ()                      is allowed. See the documentation for                      g_io_channel_set_encoding () for details.
          * @returns the status of the operation.
          */
-        seek_position(offset: number, type: SeekType): IOStatus;
+        seek_position(offset: number, type: SeekType | null): IOStatus;
         /**
          * Sets the buffer size.
          * @param size the size of the buffer, or 0 to let GLib pick a good size
@@ -17679,7 +17753,7 @@ export namespace GLib {
          * @param flags the flags to set on the IO channel
          * @returns the status of the operation.
          */
-        set_flags(flags: IOFlags): IOStatus;
+        set_flags(flags: IOFlags | null): IOStatus;
         /**
          * This sets the string that #GIOChannel uses to determine
          * where in the file a line break occurs.
@@ -18139,7 +18213,7 @@ export namespace GLib {
          * @param flags flags from #GKeyFileFlags
          * @returns %TRUE if a key file could be loaded, %FALSE otherwise
          */
-        load_from_bytes(bytes: Bytes | Uint8Array, flags: KeyFileFlags): boolean;
+        load_from_bytes(bytes: Bytes | Uint8Array, flags: KeyFileFlags | null): boolean;
         /**
          * Loads a key file from memory into an empty #GKeyFile structure.
          * If the object cannot be created then %error is set to a #GKeyFileError.
@@ -18148,7 +18222,7 @@ export namespace GLib {
          * @param flags flags from #GKeyFileFlags
          * @returns %TRUE if a key file could be loaded, %FALSE otherwise
          */
-        load_from_data(data: string, length: number, flags: KeyFileFlags): boolean;
+        load_from_data(data: string, length: number, flags: KeyFileFlags | null): boolean;
         /**
          * This function looks for a key file named `file` in the paths
          * returned from g_get_user_data_dir() and g_get_system_data_dirs(),
@@ -18159,7 +18233,7 @@ export namespace GLib {
          * @param flags flags from #GKeyFileFlags
          * @returns %TRUE if a key file could be loaded, %FALSE otherwise
          */
-        load_from_data_dirs(file: string, flags: KeyFileFlags): [boolean, string];
+        load_from_data_dirs(file: string, flags: KeyFileFlags | null): [boolean, string];
         /**
          * This function looks for a key file named `file` in the paths
          * specified in `search_dirs,` loads the file into `key_file` and
@@ -18175,7 +18249,7 @@ export namespace GLib {
          * @param flags flags from #GKeyFileFlags
          * @returns %TRUE if a key file could be loaded, %FALSE otherwise
          */
-        load_from_dirs(file: string, search_dirs: string[], flags: KeyFileFlags): [boolean, string];
+        load_from_dirs(file: string, search_dirs: string[], flags: KeyFileFlags | null): [boolean, string];
         /**
          * Loads a key file into an empty #GKeyFile structure.
          *
@@ -18189,7 +18263,7 @@ export namespace GLib {
          * @param flags flags from #GKeyFileFlags
          * @returns %TRUE if a key file could be loaded, %FALSE otherwise
          */
-        load_from_file(file: string, flags: KeyFileFlags): boolean;
+        load_from_file(file: string, flags: KeyFileFlags | null): boolean;
         /**
          * Removes a comment above `key` from `group_name`.
          * If `key` is %NULL then `comment` will be removed above `group_name`.
@@ -19438,7 +19512,7 @@ export namespace GLib {
          * @param flags which types of children are to be visited, one of     %G_TRAVERSE_ALL, %G_TRAVERSE_LEAVES and %G_TRAVERSE_NON_LEAVES
          * @param func the function to call for each visited node
          */
-        children_foreach(flags: TraverseFlags, func: NodeForeachFunc): void;
+        children_foreach(flags: TraverseFlags | null, func: NodeForeachFunc): void;
         /**
          * Gets the depth of a #GNode.
          *
@@ -19479,7 +19553,7 @@ export namespace GLib {
          * @param flags which types of children are to be counted, one of     %G_TRAVERSE_ALL, %G_TRAVERSE_LEAVES and %G_TRAVERSE_NON_LEAVES
          * @returns the number of nodes in the tree
          */
-        n_nodes(flags: TraverseFlags): number;
+        n_nodes(flags: TraverseFlags | null): number;
         /**
          * Reverses the order of the children of a #GNode.
          * (It doesn't change the order of the grandchildren.)
@@ -19495,7 +19569,12 @@ export namespace GLib {
          * @param max_depth the maximum depth of the traversal. Nodes below this     depth will not be visited. If max_depth is -1 all nodes in     the tree are visited. If depth is 1, only the root is visited.     If depth is 2, the root and its children are visited. And so on.
          * @param func the function to call for each visited #GNode
          */
-        traverse(order: TraverseType, flags: TraverseFlags, max_depth: number, func: NodeTraverseFunc): void;
+        traverse(
+            order: TraverseType | null,
+            flags: TraverseFlags | null,
+            max_depth: number,
+            func: NodeTraverseFunc,
+        ): void;
         /**
          * Unlinks a #GNode from a tree, resulting in two separate trees.
          */
@@ -21107,7 +21186,7 @@ export namespace GLib {
          * @param match_options match options
          * @returns %TRUE is the string matched, %FALSE otherwise
          */
-        match(string: string, match_options: RegexMatchFlags): [boolean, MatchInfo | null];
+        match(string: string, match_options: RegexMatchFlags | null): [boolean, MatchInfo | null];
         /**
          * Using the standard algorithm for regular expression matching only
          * the longest match in the string is retrieved. This function uses
@@ -21127,7 +21206,7 @@ export namespace GLib {
          * @param match_options match options
          * @returns %TRUE is the string matched, %FALSE otherwise
          */
-        match_all(string: string, match_options: RegexMatchFlags): [boolean, MatchInfo | null];
+        match_all(string: string, match_options: RegexMatchFlags | null): [boolean, MatchInfo | null];
         /**
          * Using the standard algorithm for regular expression matching only
          * the longest match in the `string` is retrieved, it is not possible
@@ -21175,7 +21254,7 @@ export namespace GLib {
         match_all_full(
             string: string[],
             start_position: number,
-            match_options: RegexMatchFlags,
+            match_options: RegexMatchFlags | null,
         ): [boolean, MatchInfo | null];
         /**
          * Scans for a match in `string` for the pattern in `regex`.
@@ -21239,7 +21318,7 @@ export namespace GLib {
         match_full(
             string: string[],
             start_position: number,
-            match_options: RegexMatchFlags,
+            match_options: RegexMatchFlags | null,
         ): [boolean, MatchInfo | null];
         /**
          * Increases reference count of `regex` by 1.
@@ -21279,7 +21358,12 @@ export namespace GLib {
          * @param match_options options for the match
          * @returns a newly allocated string containing the replacements
          */
-        replace(string: string[], start_position: number, replacement: string, match_options: RegexMatchFlags): string;
+        replace(
+            string: string[],
+            start_position: number,
+            replacement: string,
+            match_options: RegexMatchFlags | null,
+        ): string;
         /**
          * Replaces occurrences of the pattern in regex with the output of
          * `eval` for that occurrence.
@@ -21337,7 +21421,7 @@ export namespace GLib {
         replace_eval(
             string: string[],
             start_position: number,
-            match_options: RegexMatchFlags,
+            match_options: RegexMatchFlags | null,
             _eval: RegexEvalCallback,
         ): string;
         /**
@@ -21359,7 +21443,7 @@ export namespace GLib {
             string: string[],
             start_position: number,
             replacement: string,
-            match_options: RegexMatchFlags,
+            match_options: RegexMatchFlags | null,
         ): string;
         /**
          * Breaks the string on the pattern, and returns an array of the tokens.
@@ -21383,7 +21467,7 @@ export namespace GLib {
          * @param match_options match time option flags
          * @returns a %NULL-terminated gchar ** array. Free it using g_strfreev()
          */
-        split(string: string, match_options: RegexMatchFlags): string[];
+        split(string: string, match_options: RegexMatchFlags | null): string[];
         /**
          * Breaks the string on the pattern, and returns an array of the tokens.
          * If the pattern contains capturing parentheses, then the text for each
@@ -21415,7 +21499,7 @@ export namespace GLib {
         split_full(
             string: string[],
             start_position: number,
-            match_options: RegexMatchFlags,
+            match_options: RegexMatchFlags | null,
             max_tokens: number,
         ): string[];
         /**
@@ -21704,7 +21788,7 @@ export namespace GLib {
          * @param is_error if %TRUE it is output as an error. If %FALSE it is     output as a warning.
          */
         unexp_token(
-            expected_token: TokenType,
+            expected_token: TokenType | null,
             identifier_spec: string,
             symbol_spec: string,
             symbol_name: string,
@@ -22306,7 +22390,7 @@ export namespace GLib {
          * @param events an event mask
          * @returns an opaque tag
          */
-        add_unix_fd(fd: number, events: IOCondition): any;
+        add_unix_fd(fd: number, events: IOCondition | null): any;
         /**
          * Adds a [struct`GLib`.Source] to a `context` so that it will be executed within
          * that context. Remove it by calling [method`GLib`.Source.destroy].
@@ -22505,7 +22589,7 @@ export namespace GLib {
          * @param tag the tag from [method@GLib.Source.add_unix_fd]
          * @param new_events the new event mask to watch
          */
-        modify_unix_fd(tag: any, new_events: IOCondition): void;
+        modify_unix_fd(tag: any, new_events: IOCondition | null): void;
         /**
          * Queries the events reported for the fd corresponding to `tag` on
          * `source` during the last poll.
@@ -23815,7 +23899,7 @@ export namespace GLib {
          * @param time_ a pointer to a number of seconds since January 1, 1970
          * @returns the interval containing @time_, never -1
          */
-        adjust_time(type: TimeType, time_: number): [number, number];
+        adjust_time(type: TimeType | null, time_: number): [number, number];
         /**
          * Finds an interval within `tz` that corresponds to the given `time_`.
          * The meaning of `time_` depends on `type`.
@@ -23839,7 +23923,7 @@ export namespace GLib {
          * @param time_ a number of seconds since January 1, 1970
          * @returns the interval containing @time_, or -1 in case of failure
          */
-        find_interval(type: TimeType, time_: number): number;
+        find_interval(type: TimeType | null, time_: number): number;
         /**
          * Determines the time zone abbreviation to be used during a particular
          * `interval` of time in the time zone `tz`.
@@ -24236,7 +24320,7 @@ export namespace GLib {
          * @param traverse_func the function to call for each node visited. If this   function returns %TRUE, the traversal is stopped.
          * @param traverse_type the order in which nodes are visited, one of %G_IN_ORDER,   %G_PRE_ORDER and %G_POST_ORDER
          */
-        traverse(traverse_func: TraverseFunc, traverse_type: TraverseType): void;
+        traverse(traverse_func: TraverseFunc, traverse_type: TraverseType | null): void;
         /**
          * Decrements the reference count of `tree` by one.
          * If the reference count drops to 0, all keys and values will
@@ -24987,7 +25071,7 @@ export namespace GLib {
          * @param flags flags describing how to parse @uri_ref
          * @returns a new #GUri, or NULL on error.
          */
-        parse_relative(uri_ref: string, flags: UriFlags): Uri;
+        parse_relative(uri_ref: string, flags: UriFlags | null): Uri;
         /**
          * Returns a string representing `uri`.
          *
@@ -25010,7 +25094,7 @@ export namespace GLib {
          * @param flags flags describing what parts of @uri to hide
          * @returns a string representing     @uri, which the caller must free.
          */
-        to_string_partial(flags: UriHideFlags): string;
+        to_string_partial(flags: UriHideFlags | null): string;
     }
 
     /**
@@ -25075,7 +25159,7 @@ export namespace GLib {
          * @param separators the separator byte character set between parameters. (usually   `&`, but sometimes `;` or both `&;`). 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. You may pass an empty set, in which case   no splitting will occur.
          * @param flags flags to modify the way the parameters are handled.
          */
-        init(params: string, length: number, separators: string, flags: UriParamsFlags): void;
+        init(params: string, length: number, separators: string, flags: UriParamsFlags | null): void;
         /**
          * Advances `iter` and retrieves the next attribute/value. %FALSE is returned if
          * an error has occurred (in which case `error` is set), or if the end of the

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@girs/glib-2.0",
-  "version": "2.82.2-4.0.0-beta.18",
-  "description": "GJS TypeScript type definitions for GLib-2.0, generated from library version 2.82.2",
+  "version": "2.82.4-4.0.0-beta.20",
+  "description": "GJS TypeScript type definitions for GLib-2.0, generated from library version 2.82.4",
   "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.18",
-    "@girs/gobject-2.0": "^2.82.2-4.0.0-beta.18"
+    "@girs/gjs": "^4.0.0-beta.20",
+    "@girs/gobject-2.0": "^2.82.4-4.0.0-beta.20"
   },
   "devDependencies": {
     "typescript": "*"

package/tsconfig.json

@@ -15,7 +15,9 @@
     "removeComments": false,
     "inlineSourceMap": false,
     "inlineSources": false,
-    "newLine": "LF"
+    "newLine": "LF",
+    // Show diagnostics
+    "diagnostics": true
   },
   "include": ["./glib-2.0.d.ts"]
 }