@girs/gly-2 2.0.0-4.0.0-beta.39 → 2.0.0-4.0.0-beta.41

package/README.md

@@ -5,7 +5,7 @@
 ![downloads/week](https://img.shields.io/npm/dw/@girs/gly-2)
 
 
-GJS TypeScript type definitions for Gly-2, generated from library version 2.0.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.39.
+GJS TypeScript type definitions for Gly-2, generated from library version 2.0.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.41.
 
 ## Install
 

package/gly-2.d.ts

@@ -22,20 +22,28 @@ export namespace Gly {
 
     /**
      * Errors that can appear while loading images.
+     * @gir-type Struct
      */
     class LoaderError extends GLib.Error {
-        static $gtype: GObject.GType<LoaderError>;
+        static $gtype: GObject.GType<GLib.Error>;
 
         // Static fields
 
         /**
          * Generic type for all other errors.
+         * @since 2.0
          */
         static FAILED: number;
         /**
          * Unknown image format.
+         * @since 2.0
          */
         static UNKNOWN_IMAGE_FORMAT: number;
+        /**
+         * Reached last frame in an animation with {@link FrameRequest.set_loop_animation} to `FALSE`.
+         * @since 2.0.1
+         */
+        static NO_MORE_FRAMES: number;
 
         // Constructors
 
@@ -44,22 +52,23 @@ export namespace Gly {
         // Static methods
 
         /**
-         * Error quark for [error`GlyLoaderError]`
+         * Error quark for {@link GlyLoaderError}
          */
         static quark(): GLib.Quark;
     }
 
     /**
-     * Memory format
-     */
-
-    /**
-     * Memory format
+     * @gir-type Enum
      */
     export namespace MemoryFormat {
         export const $gtype: GObject.GType<MemoryFormat>;
     }
 
+    /**
+     * Memory format
+     * @gir-type Enum
+     * @since 2.0
+     */
     enum MemoryFormat {
         /**
          * 8-bit RGRA premultiplied
@@ -154,23 +163,22 @@ export namespace Gly {
          */
         G16,
     }
+
     /**
-     * Sandbox mechanisms
-     *
-     * ::: warning
-     *     Using `GLY_SANDBOX_SELECTOR_NOT_SANDBOXED` will disable an important security layer that sandboxes loaders. It is only intended for testing and development purposes.
+     * @gir-type Enum
      */
+    export namespace SandboxSelector {
+        export const $gtype: GObject.GType<SandboxSelector>;
+    }
 
     /**
      * Sandbox mechanisms
      *
      * ::: warning
      *     Using `GLY_SANDBOX_SELECTOR_NOT_SANDBOXED` will disable an important security layer that sandboxes loaders. It is only intended for testing and development purposes.
+     * @gir-type Enum
+     * @since 2.0
      */
-    export namespace SandboxSelector {
-        export const $gtype: GObject.GType<SandboxSelector>;
-    }
-
     enum SandboxSelector {
         /**
          * This mode selects `bwrap` outside of Flatpaks and usually
@@ -197,8 +205,9 @@ export namespace Gly {
          */
         NOT_SANDBOXED,
     }
+
     /**
-     * Error quark for [error`GlyLoaderError]`
+     * Error quark for {@link GlyLoaderError}
      * @returns The error domain
      */
     function loader_error_quark(): GLib.Quark;
@@ -206,6 +215,7 @@ export namespace Gly {
      * Whether a memory format has an alpha channel
      * @param memory_format
      * @returns Returns `TRUE` if the memory format has an alpha channel
+     * @since 2.0
      */
     function memory_format_has_alpha(memory_format: MemoryFormat | null): boolean;
     /**
@@ -213,25 +223,30 @@ export namespace Gly {
      * premultiplied with the alpha value
      * @param memory_format
      * @returns Returns `TRUE` if color channels are premultiplied
+     * @since 2.0
      */
     function memory_format_is_premultiplied(memory_format: MemoryFormat | null): boolean;
+    /**
+     * @gir-type Callback
+     */
     interface LoaderGetMimeTypesDoneFunc {
         (mime_types: string[], data?: any | null): void;
     }
     /**
-     * Memory format selection
-     */
-
-    /**
-     * Memory format selection
+     * @gir-type Flags
      */
     export namespace MemoryFormatSelection {
         export const $gtype: GObject.GType<MemoryFormatSelection>;
     }
 
+    /**
+     * Memory format selection
+     * @gir-type Flags
+     * @since 2.0
+     */
     enum MemoryFormatSelection {
         /**
-         * 8-bit RGRA premultiplied
+         * 8-bit BGRA premultiplied
          */
         B8G8R8A8_PREMULTIPLIED,
         /**
@@ -243,11 +258,11 @@ export namespace Gly {
          */
         R8G8B8A8_PREMULTIPLIED,
         /**
-         * 8-bit RGBA
+         * 8-bit BGRA
          */
         B8G8R8A8,
         /**
-         * 8-bit AGBR
+         * 8-bit ARGB
          */
         A8R8G8B8,
         /**
@@ -323,6 +338,7 @@ export namespace Gly {
          */
         G16,
     }
+
     namespace Creator {
         // Signal signatures
         interface SignalSignatures extends GObject.Object.SignalSignatures {
@@ -380,13 +396,21 @@ export namespace Gly {
      *   }
      * }
      * ```
+     * @gir-type Class
+     * @since 2.0
      */
     class Creator extends GObject.Object {
         static $gtype: GObject.GType<Creator>;
 
         // Properties
 
+        /**
+         * @construct-only
+         */
         get mime_type(): string;
+        /**
+         * @construct-only
+         */
         get mimeType(): string;
         get sandbox_selector(): SandboxSelector;
         set sandbox_selector(val: SandboxSelector);
@@ -412,16 +436,19 @@ export namespace Gly {
 
         // Signals
 
+        /** @signal */
         connect<K extends keyof Creator.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, Creator.SignalSignatures[K]>,
         ): number;
         connect(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         connect_after<K extends keyof Creator.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, Creator.SignalSignatures[K]>,
         ): number;
         connect_after(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         emit<K extends keyof Creator.SignalSignatures>(
             signal: K,
             ...args: GObject.GjsParameters<Creator.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
@@ -430,12 +457,27 @@ export namespace Gly {
 
         // Methods
 
+        /**
+         * @param width
+         * @param height
+         * @param memory_format
+         * @param texture Texture data
+         * @returns a new {@link NewFrame}
+         */
         add_frame(
             width: number,
             height: number,
             memory_format: MemoryFormat | null,
             texture: GLib.Bytes | Uint8Array,
         ): NewFrame;
+        /**
+         * @param width
+         * @param height `stride`
+         * @param stride
+         * @param memory_format
+         * @param texture Texture data
+         * @returns a new {@link NewFrame}
+         */
         add_frame_with_stride(
             width: number,
             height: number,
@@ -453,21 +495,24 @@ export namespace Gly {
          * @returns `TRUE` if format supports key-value storage.
          */
         add_metadata_key_value(key: string, value: string): boolean;
+        /**
+         * @returns The encoded image.
+         */
         create(): EncodedImage | null;
         /**
-         * Asynchronous version of [method`Creator`.create].
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * Asynchronous version of {@link Creator.create}.
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          */
         create_async(cancellable?: Gio.Cancellable | null): globalThis.Promise<EncodedImage>;
         /**
-         * Asynchronous version of [method`Creator`.create].
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * Asynchronous version of {@link Creator.create}.
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          * @param callback A callback to call when the operation is complete
          */
         create_async(cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
         /**
-         * Asynchronous version of [method`Creator`.create].
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * Asynchronous version of {@link Creator.create}.
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          * @param callback A callback to call when the operation is complete
          */
         create_async(
@@ -475,15 +520,23 @@ export namespace Gly {
             callback?: Gio.AsyncReadyCallback<this> | null,
         ): globalThis.Promise<EncodedImage> | void;
         /**
-         * Finishes the [method`Creator`.create_async] call.
-         * @param result A `GAsyncResult`
+         * Finishes the {@link Creator.create_async} call.
+         * @param result A {@link Gio.AsyncResult}
          * @returns Encoded image.
          */
         create_finish(result: Gio.AsyncResult): EncodedImage;
+        /**
+         * @param compression Value between 0 and 100
+         * @returns `TRUE` if the format supports compression setting.
+         */
         set_encoding_compression(compression: number): boolean;
+        /**
+         * @param quality Value between 0 and 100
+         * @returns `TRUE` if format supports a quality setting.
+         */
         set_encoding_quality(quality: number): boolean;
         /**
-         * Selects which sandbox mechanism should be used. The default without calling this function is [enum`SandboxSelector]``.AUTO`.
+         * Selects which sandbox mechanism should be used. The default without calling this function is {@link SandboxSelector}`.AUTO`.
          * @param sandbox_selector Method by which the sandbox mechanism is selected
          */
         set_sandbox_selector(sandbox_selector: SandboxSelector | null): boolean;
@@ -504,12 +557,17 @@ export namespace Gly {
 
     /**
      * Encoded image
+     * @gir-type Class
+     * @since 2.0
      */
     class EncodedImage extends GObject.Object {
         static $gtype: GObject.GType<EncodedImage>;
 
         // Properties
 
+        /**
+         * @read-only
+         */
         get data(): GLib.Bytes;
 
         /**
@@ -529,16 +587,19 @@ export namespace Gly {
 
         // Signals
 
+        /** @signal */
         connect<K extends keyof EncodedImage.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, EncodedImage.SignalSignatures[K]>,
         ): number;
         connect(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         connect_after<K extends keyof EncodedImage.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, EncodedImage.SignalSignatures[K]>,
         ): number;
         connect_after(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         emit<K extends keyof EncodedImage.SignalSignatures>(
             signal: K,
             ...args: GObject.GjsParameters<EncodedImage.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
@@ -547,7 +608,13 @@ export namespace Gly {
 
         // Methods
 
+        /**
+         * @returns The encoded image data
+         */
         get_data(): GLib.Bytes;
+        /**
+         * @param args
+         */
         // Conflicted with GObject.Object.get_data
         get_data(...args: never[]): any;
     }
@@ -563,6 +630,8 @@ export namespace Gly {
 
     /**
      * A frame of an image often being the complete image.
+     * @gir-type Class
+     * @since 2.0
      */
     class Frame extends GObject.Object {
         static $gtype: GObject.GType<Frame>;
@@ -584,16 +653,19 @@ export namespace Gly {
 
         // Signals
 
+        /** @signal */
         connect<K extends keyof Frame.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, Frame.SignalSignatures[K]>,
         ): number;
         connect(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         connect_after<K extends keyof Frame.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, Frame.SignalSignatures[K]>,
         ): number;
         connect_after(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         emit<K extends keyof Frame.SignalSignatures>(
             signal: K,
             ...args: GObject.GjsParameters<Frame.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
@@ -603,7 +675,7 @@ export namespace Gly {
         // Methods
 
         /**
-         * Image data arranged according to [method`Frame`.get_memory_format]
+         * Image data arranged according to {@link Frame.get_memory_format}
          * @returns Image data
          */
         get_buf_bytes(): GLib.Bytes;
@@ -626,7 +698,7 @@ export namespace Gly {
          */
         get_height(): number;
         /**
-         * Format of the image data in [method`Gly`.Frame.get_buf_bytes]
+         * Format of the image data in {@link Gly.Frame.get_buf_bytes}
          * @returns Format of image data
          */
         get_memory_format(): MemoryFormat;
@@ -645,6 +717,7 @@ export namespace Gly {
     namespace FrameRequest {
         // Signal signatures
         interface SignalSignatures extends GObject.Object.SignalSignatures {
+            'notify::loop-animation': (pspec: GObject.ParamSpec) => void;
             'notify::scale-height': (pspec: GObject.ParamSpec) => void;
             'notify::scale-width': (pspec: GObject.ParamSpec) => void;
         }
@@ -652,6 +725,8 @@ export namespace Gly {
         // Constructor properties interface
 
         interface ConstructorProps extends GObject.Object.ConstructorProps {
+            loop_animation: boolean;
+            loopAnimation: boolean;
             scale_height: number;
             scaleHeight: number;
             scale_width: number;
@@ -664,17 +739,35 @@ export namespace Gly {
      *
      * ::: warning
      *     Loaders can and frequently will ignore instructions set in
-     *     `GlyFrameRequest`. The reason is that for most loaders
+     *     {@link Gly.FrameRequest}. The reason is that for most loaders
      *     many instructions don't have a meaningful interpretation.
+     * @gir-type Class
+     * @since 2.0
      */
     class FrameRequest extends GObject.Object {
         static $gtype: GObject.GType<FrameRequest>;
 
         // Properties
 
+        get loop_animation(): boolean;
+        set loop_animation(val: boolean);
+        get loopAnimation(): boolean;
+        set loopAnimation(val: boolean);
+        /**
+         * @read-only
+         */
         get scale_height(): number;
+        /**
+         * @read-only
+         */
         get scaleHeight(): number;
+        /**
+         * @read-only
+         */
         get scale_width(): number;
+        /**
+         * @read-only
+         */
         get scaleWidth(): number;
 
         /**
@@ -696,16 +789,19 @@ export namespace Gly {
 
         // Signals
 
+        /** @signal */
         connect<K extends keyof FrameRequest.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, FrameRequest.SignalSignatures[K]>,
         ): number;
         connect(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         connect_after<K extends keyof FrameRequest.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, FrameRequest.SignalSignatures[K]>,
         ): number;
         connect_after(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         emit<K extends keyof FrameRequest.SignalSignatures>(
             signal: K,
             ...args: GObject.GjsParameters<FrameRequest.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
@@ -714,6 +810,14 @@ export namespace Gly {
 
         // Methods
 
+        /**
+         * Controls if first frame is returned after last frame
+         *
+         * By default, this option is set to `TRUE`, returning the first frame, if
+         * the previously requested frame was the last frame.
+         * @param loop_animation
+         */
+        set_loop_animation(loop_animation: boolean): void;
         /**
          * Set maximum dimensions for the frame. The texture will be scaled
          * to be within the maximum dimensions while keeping its aspect ratio.
@@ -740,6 +844,8 @@ export namespace Gly {
 
     /**
      * Image handle containing metadata and allowing frame requests.
+     * @gir-type Class
+     * @since 2.0
      */
     class Image extends GObject.Object {
         static $gtype: GObject.GType<Image>;
@@ -761,16 +867,19 @@ export namespace Gly {
 
         // Signals
 
+        /** @signal */
         connect<K extends keyof Image.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, Image.SignalSignatures[K]>,
         ): number;
         connect(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         connect_after<K extends keyof Image.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, Image.SignalSignatures[K]>,
         ): number;
         connect_after(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         emit<K extends keyof Image.SignalSignatures>(
             signal: K,
             ...args: GObject.GjsParameters<Image.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
@@ -780,7 +889,7 @@ export namespace Gly {
         // Methods
 
         /**
-         * See [method`Image`.get_width]
+         * See {@link Image.get_width}
          * @returns height
          */
         get_height(): number;
@@ -796,7 +905,7 @@ export namespace Gly {
          */
         get_metadata_key_value(key: string): string | null;
         /**
-         * Get the list of available keys for [method`Image`.get_metadata_key_value].
+         * Get the list of available keys for {@link Image.get_metadata_key_value}.
          * @returns List of existing keys.
          */
         get_metadata_keys(): string[];
@@ -805,20 +914,24 @@ export namespace Gly {
          * @returns MIME type
          */
         get_mime_type(): string;
+        /**
+         * @param frame_request
+         * @returns Loaded frame.
+         */
         get_specific_frame(frame_request: FrameRequest): Frame;
         /**
-         * Asynchronous version of [method`Image`.get_specific_frame].
+         * Asynchronous version of {@link Image.get_specific_frame}.
          * @param frame_request
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          */
         get_specific_frame_async(
             frame_request: FrameRequest,
             cancellable?: Gio.Cancellable | null,
         ): globalThis.Promise<Frame>;
         /**
-         * Asynchronous version of [method`Image`.get_specific_frame].
+         * Asynchronous version of {@link Image.get_specific_frame}.
          * @param frame_request
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          * @param callback A callback to call when the operation is complete
          */
         get_specific_frame_async(
@@ -827,9 +940,9 @@ export namespace Gly {
             callback: Gio.AsyncReadyCallback<this> | null,
         ): void;
         /**
-         * Asynchronous version of [method`Image`.get_specific_frame].
+         * Asynchronous version of {@link Image.get_specific_frame}.
          * @param frame_request
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          * @param callback A callback to call when the operation is complete
          */
         get_specific_frame_async(
@@ -838,8 +951,8 @@ export namespace Gly {
             callback?: Gio.AsyncReadyCallback<this> | null,
         ): globalThis.Promise<Frame> | void;
         /**
-         * Finishes the [method`Image`.get_specific_frame_async] call.
-         * @param result a `GAsyncResult`
+         * Finishes the {@link Image.get_specific_frame_async} call.
+         * @param result a {@link Gio.AsyncResult}
          * @returns Loaded frame.
          */
         get_specific_frame_finish(result: Gio.AsyncResult): Frame;
@@ -849,7 +962,7 @@ export namespace Gly {
          * The image orientation is given in Exif format. The function is
          * guaranteed to only return values from 1 to 8.
          *
-         * If [method`Loader`.set_apply_transformations] is set to `FALSE`,
+         * If {@link Loader.set_apply_transformations} is set to `FALSE`,
          * the orientation has to be corrected manually to dispaly the image
          * correctly.
          */
@@ -859,7 +972,7 @@ export namespace Gly {
          *
          * This information is often correct. However, it should only be used for
          * an early rendering estimates. For everything else, the specific frame
-         * information should be used. See [method`Frame`.get_width].
+         * information should be used. See {@link Frame.get_width}.
          * @returns Width
          */
         get_width(): number;
@@ -868,23 +981,23 @@ export namespace Gly {
          *
          * For single still images, this can only be called once.
          * For animated images, this function will loop to the first frame, when the last frame is reached.
-         * @returns a new [class@Frame] on success, or `NULL` with @error filled in
+         * @returns a new {@link Frame} on success, or `NULL` with `error` filled in
          */
         next_frame(): Frame;
         /**
-         * Asynchronous version of [method`Image`.next_frame].
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * Asynchronous version of {@link Image.next_frame}.
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          */
         next_frame_async(cancellable?: Gio.Cancellable | null): globalThis.Promise<Frame>;
         /**
-         * Asynchronous version of [method`Image`.next_frame].
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * Asynchronous version of {@link Image.next_frame}.
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          * @param callback A callback to call when the operation is complete
          */
         next_frame_async(cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
         /**
-         * Asynchronous version of [method`Image`.next_frame].
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * Asynchronous version of {@link Image.next_frame}.
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          * @param callback A callback to call when the operation is complete
          */
         next_frame_async(
@@ -892,8 +1005,8 @@ export namespace Gly {
             callback?: Gio.AsyncReadyCallback<this> | null,
         ): globalThis.Promise<Frame> | void;
         /**
-         * Finishes the [method`Image`.next_frame_async] call.
-         * @param result a `GAsyncResult`
+         * Finishes the {@link Image.next_frame_async} call.
+         * @param result a {@link Gio.AsyncResult}
          * @returns Loaded frame.
          */
         next_frame_finish(result: Gio.AsyncResult): Frame;
@@ -928,7 +1041,7 @@ export namespace Gly {
     }
 
     /**
-     * [class`Loader]` prepares loading an image.
+     * {@link Loader} prepares loading an image.
      *
      * The following example shows how to obtain a `Gdk.Texture`. It uses
      * [GlyGtk4](https://gnome.pages.gitlab.gnome.org/glycin/libglycin-gtk4)
@@ -941,15 +1054,18 @@ export namespace Gly {
      * loader = gly_loader_new (file);
      * image = gly_loader_load (loader, NULL);
      * if (image)
-     * {
-     *   frame = gly_image_next_frame (image, NULL);
-     *   if (frame) {
-     *     texture = gly_gtk_frame_get_texture (frame);
-     *     printf ("Image height: %d\n", gdk_texture_get_height (texture));
-     *     image_widget = gtk_image_new_from_paintable (GDK_PAINTABLE (texture));
+     *   {
+     *     frame = gly_image_next_frame (image, NULL);
+     *     if (frame)
+     *       {
+     *         texture = gly_gtk_frame_get_texture (frame);
+     *         g_print ("Image height: %d\n", gdk_texture_get_height (texture));
+     *         image_widget = gtk_image_new_from_paintable (GDK_PAINTABLE (texture));
+     *       }
      *   }
-     * }
      * ```
+     * @gir-type Class
+     * @since 2.0
      */
     class Loader extends GObject.Object {
         static $gtype: GObject.GType<Loader>;
@@ -960,9 +1076,15 @@ export namespace Gly {
         set apply_transformation(val: boolean);
         get applyTransformation(): boolean;
         set applyTransformation(val: boolean);
+        /**
+         * @construct-only
+         */
         get bytes(): GLib.Bytes;
         get cancellable(): Gio.Cancellable;
         set cancellable(val: Gio.Cancellable);
+        /**
+         * @construct-only
+         */
         get file(): Gio.File;
         get memory_format_selection(): MemoryFormatSelection;
         set memory_format_selection(val: MemoryFormatSelection);
@@ -972,6 +1094,9 @@ export namespace Gly {
         set sandbox_selector(val: SandboxSelector);
         get sandboxSelector(): SandboxSelector;
         set sandboxSelector(val: SandboxSelector);
+        /**
+         * @construct-only
+         */
         get stream(): Gio.InputStream;
 
         /**
@@ -997,16 +1122,19 @@ export namespace Gly {
 
         // Signals
 
+        /** @signal */
         connect<K extends keyof Loader.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, Loader.SignalSignatures[K]>,
         ): number;
         connect(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         connect_after<K extends keyof Loader.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, Loader.SignalSignatures[K]>,
         ): number;
         connect_after(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         emit<K extends keyof Loader.SignalSignatures>(
             signal: K,
             ...args: GObject.GjsParameters<Loader.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
@@ -1024,7 +1152,7 @@ export namespace Gly {
          */
         static get_mime_types(): string[];
         /**
-         * Async variant of [func`Loader`.get_mime_types]
+         * Async variant of {@link Loader.get_mime_types}
          * @param cancellable
          * @param callback
          */
@@ -1033,32 +1161,32 @@ export namespace Gly {
             callback?: Gio.AsyncReadyCallback<Loader> | null,
         ): void;
         /**
-         * Finishes the [func`Loader`.get_mime_types_async] call.
-         * @param result A `GAsyncResult`
+         * Finishes the {@link Loader.get_mime_types_async} call.
+         * @param result A {@link Gio.AsyncResult}
          */
         static get_mime_types_finish(result: Gio.AsyncResult): string[];
 
         // Methods
 
         /**
-         * Synchronously loads an image and returns an [class`Image]` when successful.
-         * @returns a new [class@Image] on success, or `NULL` with @error filled in
+         * Synchronously loads an image and returns an {@link Image} when successful.
+         * @returns a new {@link Image} on success, or `NULL` with `error` filled in
          */
         load(): Image;
         /**
-         * Asynchronous version of [method`Loader`.load].
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * Asynchronous version of {@link Loader.load}.
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          */
         load_async(cancellable?: Gio.Cancellable | null): globalThis.Promise<Image>;
         /**
-         * Asynchronous version of [method`Loader`.load].
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * Asynchronous version of {@link Loader.load}.
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          * @param callback A callback to call when the operation is complete
          */
         load_async(cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
         /**
-         * Asynchronous version of [method`Loader`.load].
-         * @param cancellable A [class@Gio.Cancellable] to cancel the operation
+         * Asynchronous version of {@link Loader.load}.
+         * @param cancellable A {@link Gio.Cancellable} to cancel the operation
          * @param callback A callback to call when the operation is complete
          */
         load_async(
@@ -1066,8 +1194,8 @@ export namespace Gly {
             callback?: Gio.AsyncReadyCallback<this> | null,
         ): globalThis.Promise<Image> | void;
         /**
-         * Finishes the [method`Loader`.load_async] call.
-         * @param result A `GAsyncResult`
+         * Finishes the {@link Loader.load_async} call.
+         * @param result A {@link Gio.AsyncResult}
          * @returns Loaded image.
          */
         load_finish(result: Gio.AsyncResult): Image;
@@ -1090,7 +1218,7 @@ export namespace Gly {
          */
         set_apply_transformations(apply_transformations: boolean): void;
         /**
-         * Selects which sandbox mechanism should be used. The default without calling this function is [enum`SandboxSelector]``.AUTO`.
+         * Selects which sandbox mechanism should be used. The default without calling this function is {@link SandboxSelector}`.AUTO`.
          * @param sandbox_selector Method by which the sandbox mechanism is selected
          */
         set_sandbox_selector(sandbox_selector: SandboxSelector | null): void;
@@ -1107,6 +1235,8 @@ export namespace Gly {
 
     /**
      * New frame
+     * @gir-type Class
+     * @since 2.0
      */
     class NewFrame extends GObject.Object {
         static $gtype: GObject.GType<NewFrame>;
@@ -1128,16 +1258,19 @@ export namespace Gly {
 
         // Signals
 
+        /** @signal */
         connect<K extends keyof NewFrame.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, NewFrame.SignalSignatures[K]>,
         ): number;
         connect(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         connect_after<K extends keyof NewFrame.SignalSignatures>(
             signal: K,
             callback: GObject.SignalCallback<this, NewFrame.SignalSignatures[K]>,
         ): number;
         connect_after(signal: string, callback: (...args: any[]) => any): number;
+        /** @signal */
         emit<K extends keyof NewFrame.SignalSignatures>(
             signal: K,
             ...args: GObject.GjsParameters<NewFrame.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
@@ -1146,11 +1279,17 @@ export namespace Gly {
 
         // Methods
 
+        /**
+         * @param icc_profile ICC profile
+         * @returns `TRUE` if format supports ICC color profiles.
+         */
         set_color_icc_profile(icc_profile: GLib.Bytes | Uint8Array): boolean;
     }
 
     /**
      * See ITU-T H.273
+     * @gir-type Struct
+     * @since 2.0
      */
     class Cicp {
         static $gtype: GObject.GType<Cicp>;
@@ -1179,12 +1318,33 @@ export namespace Gly {
         free(): void;
     }
 
+    /**
+     * @gir-type Alias
+     */
     type CreatorClass = typeof Creator;
+    /**
+     * @gir-type Alias
+     */
     type EncodedImageClass = typeof EncodedImage;
+    /**
+     * @gir-type Alias
+     */
     type FrameClass = typeof Frame;
+    /**
+     * @gir-type Alias
+     */
     type FrameRequestClass = typeof FrameRequest;
+    /**
+     * @gir-type Alias
+     */
     type ImageClass = typeof Image;
+    /**
+     * @gir-type Alias
+     */
     type LoaderClass = typeof Loader;
+    /**
+     * @gir-type Alias
+     */
     type NewFrameClass = typeof NewFrame;
     /**
      * Name of the imported GIR library

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@girs/gly-2",
-    "version": "2.0.0-4.0.0-beta.39",
+    "version": "2.0.0-4.0.0-beta.41",
     "description": "GJS TypeScript type definitions for Gly-2, generated from library version 2.0.0",
     "type": "module",
     "module": "gly-2.js",
@@ -31,11 +31,11 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "4.0.0-beta.39",
-      "@girs/gio-2.0": "2.86.4-4.0.0-beta.39",
-      "@girs/gobject-2.0": "2.86.4-4.0.0-beta.39",
-      "@girs/glib-2.0": "2.86.4-4.0.0-beta.39",
-      "@girs/gmodule-2.0": "2.0.0-4.0.0-beta.39"    },
+      "@girs/gjs": "4.0.0-beta.41",
+      "@girs/gio-2.0": "2.88.0-4.0.0-beta.41",
+      "@girs/gobject-2.0": "2.88.0-4.0.0-beta.41",
+      "@girs/glib-2.0": "2.88.0-4.0.0-beta.41",
+      "@girs/gmodule-2.0": "2.0.0-4.0.0-beta.41"    },
     "devDependencies": {
       "typescript": "*"
     },

package/tsconfig.json

@@ -17,7 +17,24 @@
     "inlineSources": false,
     "newLine": "LF",
     // Show diagnostics
-    "diagnostics": true
+    "diagnostics": true,
+    "paths": {
+      "@girs/gio-2.0": [
+            "../gio-2.0/index.d.ts"
+      ],
+      "@girs/gobject-2.0": [
+            "../gobject-2.0/index.d.ts"
+      ],
+      "@girs/glib-2.0": [
+            "../glib-2.0/index.d.ts"
+      ],
+      "@girs/gmodule-2.0": [
+            "../gmodule-2.0/index.d.ts"
+      ],
+      "@girs/gjs": [
+            "../gjs/index.d.ts"
+      ]
+}
   },
   "include": ["./gly-2.d.ts"]
 }

package/typedoc.json

@@ -2,6 +2,8 @@
     "entryPoints": ["./gly-2.d.ts"],
     "readme": "./README.md",
     "name": "Gly-2",
-    "tsconfig": "./tsconfig.json"
+    "tsconfig": "./tsconfig.json",
+    "skipErrorChecking": true,
+    "highlightLanguages": ["typescript", "javascript", "c", "cpp", "xml", "bash", "json", "css"]
 }