@girs/glib-2.0 2.80.0-4.0.0-beta.4 → 2.80.2-4.0.0-beta.7

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

package/glib-2.0-ambient.d.ts

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

package/glib-2.0-import.d.ts

@@ -1,4 +1,3 @@
-
 import GLib20 from '@girs/glib-2.0';
 
 declare global {
@@ -8,5 +7,3 @@ declare global {
 }
 
 export default GjsGiImports;
-
-

package/glib-2.0.d.ts

@@ -1,19 +1,20 @@
-/*
+/**
  * Type Definitions for Gjs (https://gjs.guide/)
  *
  * These type definitions are automatically generated, do not edit them by hand.
  * If you found a bug fix it in `ts-for-gir` or create a bug report on https://github.com/gjsify/ts-for-gir
+ *
+ * The based EJS template file is used for the generated .d.ts file of each GIR module like Gtk-4.0, GObject-2.0, ...
  */
 
-import './glib-2.0-ambient.d.ts';
-
-/**
- * GLib-2.0
- */
-
+// Module dependencies
 import type GObject from '@girs/gobject-2.0';
 
 export namespace GLib {
+    /**
+     * GLib-2.0
+     */
+
     /**
      * Error codes returned by bookmark file parsing.
      */
@@ -8564,14 +8565,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
@@ -13782,7 +13775,7 @@ export namespace GLib {
          * @param uri a valid URI
          * @returns a timestamp
          */
-        get_added(uri: string): number;
+        get_added(uri: string): never;
         /**
          * Gets the time the bookmark for `uri` was added to `bookmark`
          *
@@ -13810,7 +13803,7 @@ export namespace GLib {
          * @param name an application's name
          * @returns %TRUE on success.
          */
-        get_app_info(uri: string, name: string): [boolean, string, number, number];
+        get_app_info(uri: string, name: string): [boolean, string, number, never | null];
         /**
          * Gets the registration information of `app_name` for the bookmark for
          * `uri`.  See g_bookmark_file_set_application_info() for more information about
@@ -13900,7 +13893,7 @@ export namespace GLib {
          * @param uri a valid URI
          * @returns a timestamp
          */
-        get_modified(uri: string): number;
+        get_modified(uri: string): never;
         /**
          * Gets the time when the bookmark for `uri` was last modified.
          *
@@ -13941,7 +13934,7 @@ export namespace GLib {
          * @param uri a valid URI
          * @returns a timestamp.
          */
-        get_visited(uri: string): number;
+        get_visited(uri: string): never;
         /**
          * Gets the time the bookmark for `uri` was last visited.
          *
@@ -14057,7 +14050,7 @@ export namespace GLib {
          * @param uri a valid URI
          * @param added a timestamp or -1 to use the current time
          */
-        set_added(uri: string, added: number): void;
+        set_added(uri: string, added: never): void;
         /**
          * Sets the time the bookmark for `uri` was added into `bookmark`.
          *
@@ -14102,7 +14095,7 @@ export namespace GLib {
          * @param stamp the time of the last registration for this application
          * @returns %TRUE if the application's meta-data was successfully   changed.
          */
-        set_app_info(uri: string, name: string, exec: string, count: number, stamp: number): boolean;
+        set_app_info(uri: string, name: string, exec: string, count: number, stamp: never): boolean;
         /**
          * Sets the meta-data of application `name` inside the list of
          * applications that have registered a bookmark for `uri` inside
@@ -14197,7 +14190,7 @@ export namespace GLib {
          * @param uri a valid URI
          * @param modified a timestamp or -1 to use the current time
          */
-        set_modified(uri: string, modified: number): void;
+        set_modified(uri: string, modified: never): void;
         /**
          * Sets the last time the bookmark for `uri` was last modified.
          *
@@ -14235,7 +14228,7 @@ export namespace GLib {
          * @param uri a valid URI
          * @param visited a timestamp or -1 to use the current time
          */
-        set_visited(uri: string, visited: number): void;
+        set_visited(uri: string, visited: never): void;
         /**
          * Sets the time the bookmark for `uri` was last visited.
          *
@@ -15384,7 +15377,7 @@ export namespace GLib {
          *
          * @param timet time_t value to set
          */
-        set_time_t(timet: number): void;
+        set_time_t(timet: never): void;
         /**
          * Sets the value of a date from a #GTimeVal value.  Note that the
          * `tv_usec` member is ignored, because #GDate can't make use of the
@@ -16577,24 +16570,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 of GLib.Hmac
 
-        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;
 
         // Own methods of GLib.Hmac
 
+        /**
+         * 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;
     }
 
     /**
@@ -26427,4 +26481,5 @@ export namespace GLib {
 }
 
 export default GLib;
+
 // END

package/glib-2.0.js

@@ -1,6 +1,5 @@
 
-  // @ts-expect-error
-  import GLib from 'gi://GLib?version=2.0';
-  export { GLib };
-  export default GLib;
+// @ts-expect-error
+import GLib from 'gi://GLib?version=2.0';
+export default GLib;
 

package/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Type Definitions for Gjs (https://gjs.guide/)
+ *
+ * These type definitions are automatically generated, do not edit them by hand.
+ * If you found a bug fix it in `ts-for-gir` or create a bug report on https://github.com/gjsify/ts-for-gir
+ *
+ * This template is used to generate the index.d.ts file of each GIR module like Gtk-4.0, GObject-2.0, ...
+ */
+
+import './glib-2.0-ambient.d.ts';
+
+import './glib-2.0-import.d.ts';
+
+import GLib from './glib-2.0.js';
+export default GLib;

package/index.js

@@ -0,0 +1,5 @@
+
+// @ts-expect-error
+import GLib from './glib-2.0.js';
+export default GLib;
+

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@girs/glib-2.0",
-  "version": "2.80.0-4.0.0-beta.4",
-  "description": "GJS TypeScript type definitions for GLib-2.0, generated from library version 2.80.0",
+  "version": "2.80.2-4.0.0-beta.7",
+  "description": "GJS TypeScript type definitions for GLib-2.0, generated from library version 2.80.2",
   "type": "module",
   "module": "glib-2.0.js",
   "main": "glib-2.0.js",
@@ -16,18 +16,23 @@
       "import": "./glib-2.0-import.js",
       "default": "./glib-2.0-import.js"
     },
-    ".": {
+    "./glib-2.0": {
       "types": "./glib-2.0.d.ts",
       "import": "./glib-2.0.js",
       "default": "./glib-2.0.js"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
     }
   },
   "scripts": {
-    "test": "NODE_OPTIONS=--max_old_space_size=9216 tsc --noEmit glib-2.0.d.ts"
+    "test": "tsc --project tsconfig.json"
   },
   "dependencies": {
-    "@girs/gjs": "^4.0.0-beta.4",
-    "@girs/gobject-2.0": "^2.80.0-4.0.0-beta.4"
+    "@girs/gjs": "^4.0.0-beta.7",
+    "@girs/gobject-2.0": "^2.80.2-4.0.0-beta.7"
   },
   "devDependencies": {
     "typescript": "*"

package/tsconfig.json

@@ -2,11 +2,11 @@
   "compilerOptions": {
     // General settings for code interpretation
     "target": "ESNext",
-    "module": "ESNext",
+    "module": "NodeNext",
     "lib": ["ESNext"],
     "types": [],
     "experimentalDecorators": true,
-    "moduleResolution": "node",
+    "moduleResolution": "NodeNext",
     "noEmit": true,
     "noEmitOnError": false,
     "baseUrl": "./",