@gtkx/ffi 0.1.44 → 0.1.46

package/dist/generated/gdk/color-state.js

@@ -1,6 +1,17 @@
 import { call } from "@gtkx/native";
 import { getObject } from "@gtkx/ffi";
 import { CicpParams } from "./cicp-params.js";
+/**
+ * Provides information to interpret colors and pixels in a variety of ways.
+ *
+ * They are also known as
+ * [*color spaces*](https://en.wikipedia.org/wiki/Color_space).
+ *
+ * Crucially, GTK knows how to convert colors from one color
+ * state to another.
+ *
+ * `GdkColorState` objects are immutable and therefore threadsafe.
+ */
 export class ColorState {
     ptr;
     constructor() {
@@ -9,6 +20,11 @@ export class ColorState {
     createPtr(_init) {
         return null;
     }
+    /**
+     * Returns the color state object representing the oklab color space.
+     *
+     * This is a perceptually uniform color state.
+     */
     static getOklab() {
         const ptr = call("libgtk-4.so.1", "gdk_color_state_get_oklab", [], {
             type: "boxed",
@@ -18,6 +34,12 @@ export class ColorState {
         });
         return getObject(ptr, ColorState);
     }
+    /**
+     * Returns the color state object representing the oklch color space.
+     *
+     * This is the polar variant of oklab, in which the hue is encoded as
+     * a polar coordinate.
+     */
     static getOklch() {
         const ptr = call("libgtk-4.so.1", "gdk_color_state_get_oklch", [], {
             type: "boxed",
@@ -27,6 +49,17 @@ export class ColorState {
         });
         return getObject(ptr, ColorState);
     }
+    /**
+     * Returns the color state object representing the linear rec2100 color space.
+     *
+     * This color state uses the primaries defined by BT.2020-2 and BT.2100-0 and a linear
+     * transfer function.
+     *
+     * It is equivalent to the Cicp tuple 9/8/0/1.
+     *
+     * See e.g. [the CSS HDR Module](https://drafts.csswg.org/css-color-hdr/#valdef-color-rec2100-linear)
+     * for details about this colorstate.
+     */
     static getRec2100Linear() {
         const ptr = call("libgtk-4.so.1", "gdk_color_state_get_rec2100_linear", [], {
             type: "boxed",
@@ -36,6 +69,17 @@ export class ColorState {
         });
         return getObject(ptr, ColorState);
     }
+    /**
+     * Returns the color state object representing the rec2100-pq color space.
+     *
+     * This color state uses the primaries defined by BT.2020-2 and BT.2100-0 and the transfer
+     * function defined by SMPTE ST 2084 and BT.2100-2.
+     *
+     * It is equivalent to the Cicp tuple 9/16/0/1.
+     *
+     * See e.g. [the CSS HDR Module](https://drafts.csswg.org/css-color-hdr/#valdef-color-rec2100-pq)
+     * for details about this colorstate.
+     */
     static getRec2100Pq() {
         const ptr = call("libgtk-4.so.1", "gdk_color_state_get_rec2100_pq", [], {
             type: "boxed",
@@ -45,6 +89,17 @@ export class ColorState {
         });
         return getObject(ptr, ColorState);
     }
+    /**
+     * Returns the color state object representing the sRGB color space.
+     *
+     * This color state uses the primaries defined by BT.709-6 and the transfer function
+     * defined by IEC 61966-2-1.
+     *
+     * It is equivalent to the Cicp tuple 1/13/0/1.
+     *
+     * See e.g. [the CSS Color Module](https://www.w3.org/TR/css-color-4/#predefined-sRGB)
+     * for details about this colorstate.
+     */
     static getSrgb() {
         const ptr = call("libgtk-4.so.1", "gdk_color_state_get_srgb", [], {
             type: "boxed",
@@ -54,6 +109,16 @@ export class ColorState {
         });
         return getObject(ptr, ColorState);
     }
+    /**
+     * Returns the color state object representing the linearized sRGB color space.
+     *
+     * This color state uses the primaries defined by BT.709-6 and a linear transfer function.
+     *
+     * It is equivalent to the Cicp tuple 1/8/0/1.
+     *
+     * See e.g. [the CSS Color Module](https://www.w3.org/TR/css-color-4/#predefined-sRGB-linear)
+     * for details about this colorstate.
+     */
     static getSrgbLinear() {
         const ptr = call("libgtk-4.so.1", "gdk_color_state_get_srgb_linear", [], {
             type: "boxed",
@@ -63,6 +128,13 @@ export class ColorState {
         });
         return getObject(ptr, ColorState);
     }
+    /**
+     * Create a [class@Gdk.CicpParams] representing the colorstate.
+     *
+     * It is not guaranteed that every `GdkColorState` can be
+     * represented with Cicp parameters. If that is the case,
+     * this function returns `NULL`.
+     */
     createCicpParams() {
         const ptr = call("libgtk-4.so.1", "gdk_color_state_create_cicp_params", [
             {
@@ -74,6 +146,14 @@ export class ColorState {
             return null;
         return getObject(ptr, CicpParams);
     }
+    /**
+     * Compares two `GdkColorStates` for equality.
+     *
+     * Note that this function is not guaranteed to be perfect and two objects
+     * describing the same color state may compare not equal. However, different
+     * color states will never compare equal.
+     * @param other - another `GdkColorStatee`
+     */
     equal(other) {
         return call("libgtk-4.so.1", "gdk_color_state_equal", [
             {
@@ -91,6 +171,13 @@ export class ColorState {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Compares two `GdkColorStates` for equivalence.
+     *
+     * Two objects that represent the same color state should be equivalent,
+     * even though they may not be equal in the sense of [method@Gdk.ColorState.equal].
+     * @param other - another `GdkColorStatee`
+     */
     equivalent(other) {
         return call("libgtk-4.so.1", "gdk_color_state_equivalent", [
             {
@@ -108,6 +195,9 @@ export class ColorState {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Increase the reference count of @self.
+     */
     ref() {
         const ptr = call("libgtk-4.so.1", "gdk_color_state_ref", [
             {
@@ -122,6 +212,12 @@ export class ColorState {
         });
         return getObject(ptr, ColorState);
     }
+    /**
+     * Decrease the reference count of @self.
+     *
+     * Unless `self` is static, it will be freed
+     * when the reference count reaches zero.
+     */
     unref() {
         call("libgtk-4.so.1", "gdk_color_state_unref", [
             {

package/dist/generated/gdk/content-deserializer.d.ts

@@ -1,19 +1,77 @@
 import * as GLib from "../glib/index.js";
 import * as GObject from "../gobject/index.js";
 import * as Gio from "../gio/index.js";
+/**
+ * Deserializes content received via inter-application data transfers.
+ *
+ * The `GdkContentDeserializer` transforms serialized content that is
+ * identified by a mime type into an object identified by a GType.
+ *
+ * GTK provides serializers and deserializers for common data types
+ * such as text, colors, images or file lists. To register your own
+ * deserialization functions, use [func@content_register_deserializer].
+ *
+ * Also see [class@Gdk.ContentSerializer].
+ */
 export declare class ContentDeserializer extends GObject.GObject {
     constructor(...args: unknown[]);
     protected createPtr(_args: unknown[]): unknown;
+    /**
+     * Gets the cancellable for the current operation.
+     *
+     * This is the `GCancellable` that was passed to [func@Gdk.content_deserialize_async].
+     */
     getCancellable(): Gio.Cancellable | null;
+    /**
+     * Gets the `GType` to create an instance of.
+     */
     getGtype(): number;
+    /**
+     * Gets the input stream for the current operation.
+     *
+     * This is the stream that was passed to [func@Gdk.content_deserialize_async].
+     */
     getInputStream(): Gio.InputStream;
+    /**
+     * Gets the mime type to deserialize from.
+     */
     getMimeType(): string;
+    /**
+     * Gets the I/O priority for the current operation.
+     *
+     * This is the priority that was passed to [func@Gdk.content_deserialize_async].
+     */
     getPriority(): number;
+    /**
+     * Gets the data that was associated with the current operation.
+     *
+     * See [method@Gdk.ContentDeserializer.set_task_data].
+     */
     getTaskData(): number | null;
+    /**
+     * Gets the user data that was passed when the deserializer was registered.
+     */
     getUserData(): number | null;
+    /**
+     * Gets the `GValue` to store the deserialized object in.
+     */
     getValue(): GObject.Value;
+    /**
+     * Indicate that the deserialization has ended with an error.
+     *
+     * This function consumes @error.
+     * @param error - a `GError`
+     */
     returnError(error: GLib.GError): void;
+    /**
+     * Indicate that the deserialization has been successfully completed.
+     */
     returnSuccess(): void;
+    /**
+     * Associate data with the current deserialization operation.
+     * @param data - data to associate with this operation
+     * @param notify - destroy notify for @data
+     */
     setTaskData(notify: () => void, data?: number | null): void;
     connect(signal: "notify", handler: (self: ContentDeserializer, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;

package/dist/generated/gdk/content-deserializer.js

@@ -2,6 +2,18 @@ import { call } from "@gtkx/native";
 import { getObject } from "@gtkx/ffi";
 import * as GObject from "../gobject/index.js";
 import * as Gio from "../gio/index.js";
+/**
+ * Deserializes content received via inter-application data transfers.
+ *
+ * The `GdkContentDeserializer` transforms serialized content that is
+ * identified by a mime type into an object identified by a GType.
+ *
+ * GTK provides serializers and deserializers for common data types
+ * such as text, colors, images or file lists. To register your own
+ * deserialization functions, use [func@content_register_deserializer].
+ *
+ * Also see [class@Gdk.ContentSerializer].
+ */
 export class ContentDeserializer extends GObject.GObject {
     constructor(...args) {
         super(...args);
@@ -13,6 +25,11 @@ export class ContentDeserializer extends GObject.GObject {
             { type: { type: "gobject" }, value: null },
         ], { type: "gobject", borrowed: true });
     }
+    /**
+     * Gets the cancellable for the current operation.
+     *
+     * This is the `GCancellable` that was passed to [func@Gdk.content_deserialize_async].
+     */
     getCancellable() {
         const ptr = call("libgtk-4.so.1", "gdk_content_deserializer_get_cancellable", [
             {
@@ -24,6 +41,9 @@ export class ContentDeserializer extends GObject.GObject {
             return null;
         return getObject(ptr, Gio.Cancellable);
     }
+    /**
+     * Gets the `GType` to create an instance of.
+     */
     getGtype() {
         return call("libgtk-4.so.1", "gdk_content_deserializer_get_gtype", [
             {
@@ -32,6 +52,11 @@ export class ContentDeserializer extends GObject.GObject {
             },
         ], { type: "int", size: 64, unsigned: true });
     }
+    /**
+     * Gets the input stream for the current operation.
+     *
+     * This is the stream that was passed to [func@Gdk.content_deserialize_async].
+     */
     getInputStream() {
         const ptr = call("libgtk-4.so.1", "gdk_content_deserializer_get_input_stream", [
             {
@@ -41,6 +66,9 @@ export class ContentDeserializer extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, Gio.InputStream);
     }
+    /**
+     * Gets the mime type to deserialize from.
+     */
     getMimeType() {
         return call("libgtk-4.so.1", "gdk_content_deserializer_get_mime_type", [
             {
@@ -49,6 +77,11 @@ export class ContentDeserializer extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the I/O priority for the current operation.
+     *
+     * This is the priority that was passed to [func@Gdk.content_deserialize_async].
+     */
     getPriority() {
         return call("libgtk-4.so.1", "gdk_content_deserializer_get_priority", [
             {
@@ -57,6 +90,11 @@ export class ContentDeserializer extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the data that was associated with the current operation.
+     *
+     * See [method@Gdk.ContentDeserializer.set_task_data].
+     */
     getTaskData() {
         return call("libgtk-4.so.1", "gdk_content_deserializer_get_task_data", [
             {
@@ -65,6 +103,9 @@ export class ContentDeserializer extends GObject.GObject {
             },
         ], { type: "int", size: 64, unsigned: true });
     }
+    /**
+     * Gets the user data that was passed when the deserializer was registered.
+     */
     getUserData() {
         return call("libgtk-4.so.1", "gdk_content_deserializer_get_user_data", [
             {
@@ -73,6 +114,9 @@ export class ContentDeserializer extends GObject.GObject {
             },
         ], { type: "int", size: 64, unsigned: true });
     }
+    /**
+     * Gets the `GValue` to store the deserialized object in.
+     */
     getValue() {
         const ptr = call("libgtk-4.so.1", "gdk_content_deserializer_get_value", [
             {
@@ -87,6 +131,12 @@ export class ContentDeserializer extends GObject.GObject {
         });
         return getObject(ptr, GObject.Value);
     }
+    /**
+     * Indicate that the deserialization has ended with an error.
+     *
+     * This function consumes @error.
+     * @param error - a `GError`
+     */
     returnError(error) {
         call("libgtk-4.so.1", "gdk_content_deserializer_return_error", [
             {
@@ -99,6 +149,9 @@ export class ContentDeserializer extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Indicate that the deserialization has been successfully completed.
+     */
     returnSuccess() {
         call("libgtk-4.so.1", "gdk_content_deserializer_return_success", [
             {
@@ -107,6 +160,11 @@ export class ContentDeserializer extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Associate data with the current deserialization operation.
+     * @param data - data to associate with this operation
+     * @param notify - destroy notify for @data
+     */
     setTaskData(notify, data) {
         call("libgtk-4.so.1", "gdk_content_deserializer_set_task_data", [
             {

package/dist/generated/gdk/content-formats-builder.d.ts

@@ -1,12 +1,50 @@
 import { ContentFormats } from "./content-formats.js";
+/** Creates `GdkContentFormats` objects. */
 export declare class ContentFormatsBuilder {
     ptr: unknown;
+    /**
+     * Create a new `GdkContentFormatsBuilder` object.
+     *
+     * The resulting builder would create an empty `GdkContentFormats`.
+     * Use addition functions to add types to it.
+     */
     constructor();
     protected createPtr(_args: unknown[]): unknown;
+    /**
+     * Appends all formats from `formats` to @builder, skipping those that
+     * already exist.
+     * @param formats - the formats to add
+     */
     addFormats(formats: ContentFormats): void;
+    /**
+     * Appends `type` to `builder` if it has not already been added.
+     * @param type - a `GType`
+     */
     addGtype(type: number): void;
+    /**
+     * Appends `mime_type` to `builder` if it has not already been added.
+     * @param mimeType - a mime type
+     */
     addMimeType(mimeType: string): void;
+    /**
+     * Acquires a reference on the given @builder.
+     *
+     * This function is intended primarily for bindings.
+     * `GdkContentFormatsBuilder` objects should not be kept around.
+     */
     ref(): ContentFormatsBuilder;
+    /**
+     * Creates a new `GdkContentFormats` from the given @builder.
+     *
+     * The given `GdkContentFormatsBuilder` is reset once this function returns;
+     * you cannot call this function multiple times on the same `builder` instance.
+     *
+     * This function is intended primarily for bindings. C code should use
+     * [method@Gdk.ContentFormatsBuilder.free_to_formats].
+     */
     toFormats(): ContentFormats;
+    /**
+     * Releases a reference on the given @builder.
+     */
     unref(): void;
 }

package/dist/generated/gdk/content-formats-builder.js

@@ -1,8 +1,15 @@
 import { call } from "@gtkx/native";
 import { getObject } from "@gtkx/ffi";
 import { ContentFormats } from "./content-formats.js";
+/** Creates `GdkContentFormats` objects. */
 export class ContentFormatsBuilder {
     ptr;
+    /**
+     * Create a new `GdkContentFormatsBuilder` object.
+     *
+     * The resulting builder would create an empty `GdkContentFormats`.
+     * Use addition functions to add types to it.
+     */
     constructor() {
         this.ptr = this.createPtr([]);
     }
@@ -13,6 +20,11 @@ export class ContentFormatsBuilder {
             innerType: "GdkContentFormatsBuilder",
         });
     }
+    /**
+     * Appends all formats from `formats` to @builder, skipping those that
+     * already exist.
+     * @param formats - the formats to add
+     */
     addFormats(formats) {
         call("libgtk-4.so.1", "gdk_content_formats_builder_add_formats", [
             {
@@ -30,6 +42,10 @@ export class ContentFormatsBuilder {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Appends `type` to `builder` if it has not already been added.
+     * @param type - a `GType`
+     */
     addGtype(type) {
         call("libgtk-4.so.1", "gdk_content_formats_builder_add_gtype", [
             {
@@ -42,6 +58,10 @@ export class ContentFormatsBuilder {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Appends `mime_type` to `builder` if it has not already been added.
+     * @param mimeType - a mime type
+     */
     addMimeType(mimeType) {
         call("libgtk-4.so.1", "gdk_content_formats_builder_add_mime_type", [
             {
@@ -54,6 +74,12 @@ export class ContentFormatsBuilder {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Acquires a reference on the given @builder.
+     *
+     * This function is intended primarily for bindings.
+     * `GdkContentFormatsBuilder` objects should not be kept around.
+     */
     ref() {
         const ptr = call("libgtk-4.so.1", "gdk_content_formats_builder_ref", [
             {
@@ -68,6 +94,15 @@ export class ContentFormatsBuilder {
         });
         return getObject(ptr, ContentFormatsBuilder);
     }
+    /**
+     * Creates a new `GdkContentFormats` from the given @builder.
+     *
+     * The given `GdkContentFormatsBuilder` is reset once this function returns;
+     * you cannot call this function multiple times on the same `builder` instance.
+     *
+     * This function is intended primarily for bindings. C code should use
+     * [method@Gdk.ContentFormatsBuilder.free_to_formats].
+     */
     toFormats() {
         const ptr = call("libgtk-4.so.1", "gdk_content_formats_builder_to_formats", [
             {
@@ -82,6 +117,9 @@ export class ContentFormatsBuilder {
         });
         return getObject(ptr, ContentFormats);
     }
+    /**
+     * Releases a reference on the given @builder.
+     */
     unref() {
         call("libgtk-4.so.1", "gdk_content_formats_builder_unref", [
             {

package/dist/generated/gdk/content-formats.d.ts

@@ -1,26 +1,170 @@
 import { Ref } from "@gtkx/native";
 import * as GLib from "../glib/index.js";
+/**
+ * Used to advertise and negotiate the format of content.
+ *
+ * You will encounter `GdkContentFormats` when interacting with objects
+ * controlling operations that pass data between different widgets, window
+ * or application, like [class@Gdk.Drag], [class@Gdk.Drop],
+ * [class@Gdk.Clipboard] or [class@Gdk.ContentProvider].
+ *
+ * GDK supports content in 2 forms: `GType` and mime type.
+ * Using `GTypes` is meant only for in-process content transfers. Mime types
+ * are meant to be used for data passing both in-process and out-of-process.
+ * The details of how data is passed is described in the documentation of
+ * the actual implementations. To transform between the two forms,
+ * [class@Gdk.ContentSerializer] and [class@Gdk.ContentDeserializer] are used.
+ *
+ * A `GdkContentFormats` describes a set of possible formats content can be
+ * exchanged in. It is assumed that this set is ordered. `GTypes` are more
+ * important than mime types. Order between different `GTypes` or mime types
+ * is the order they were added in, most important first. Functions that
+ * care about order, such as [method@Gdk.ContentFormats.union], will describe
+ * in their documentation how they interpret that order, though in general the
+ * order of the first argument is considered the primary order of the result,
+ * followed by the order of further arguments.
+ *
+ * For debugging purposes, the function [method@Gdk.ContentFormats.to_string]
+ * exists. It will print a comma-separated list of formats from most important
+ * to least important.
+ *
+ * `GdkContentFormats` is an immutable struct. After creation, you cannot change
+ * the types it represents. Instead, new `GdkContentFormats` have to be created.
+ * The [struct@Gdk.ContentFormatsBuilder] structure is meant to help in this
+ * endeavor.
+ */
 export declare class ContentFormats {
     ptr: unknown;
+    /**
+     * Creates a new `GdkContentFormats` from an array of mime types.
+     *
+     * The mime types must be valid and different from each other or the
+     * behavior of the return value is undefined. If you cannot guarantee
+     * this, use [struct@Gdk.ContentFormatsBuilder] instead.
+     * @param mimeTypes - Pointer to an
+     * @param nMimeTypes - number of entries in @mime_types.
+     */
     constructor(nMimeTypes: number, mimeTypes?: string[] | null);
+    /**
+     * Creates a new `GdkContentFormats` for a given `GType`.
+     * @param type - a `GType`
+     */
     static formatsNewForGtype(type: number): ContentFormats;
     protected createPtr(_args: unknown[]): unknown;
+    /**
+     * Parses the given `string` into `GdkContentFormats` and
+     * returns the formats.
+     *
+     * Strings printed via [method@Gdk.ContentFormats.to_string]
+     * can be read in again successfully using this function.
+     *
+     * If `string` does not describe valid content formats, %NULL
+     * is returned.
+     * @param string - the string to parse
+     */
     static parse(string: string): ContentFormats;
+    /**
+     * Checks if a given `GType` is part of the given @formats.
+     * @param type - the `GType` to search for
+     */
     containGtype(type: number): boolean;
+    /**
+     * Checks if a given mime type is part of the given @formats.
+     * @param mimeType - the mime type to search for
+     */
     containMimeType(mimeType: string): boolean;
+    /**
+     * Gets the `GType`s included in @formats.
+     *
+     * Note that `formats` may not contain any `GType`s, in particular when
+     * they are empty. In that case %NULL will be returned.
+     * @param nGtypes - optional pointer to take the
+     */
     getGtypes(nGtypes?: Ref<number> | null): number[] | null;
+    /**
+     * Gets the mime types included in @formats.
+     *
+     * Note that `formats` may not contain any mime types, in particular
+     * when they are empty. In that case %NULL will be returned.
+     * @param nMimeTypes - optional pointer to take the
+     */
     getMimeTypes(nMimeTypes?: Ref<number> | null): string[] | null;
+    /**
+     * Returns whether the content formats contain any formats.
+     */
     isEmpty(): boolean;
+    /**
+     * Checks if `first` and `second` have any matching formats.
+     * @param second - the `GdkContentFormats` to intersect with
+     */
     match(second: ContentFormats): boolean;
+    /**
+     * Finds the first `GType` from `first` that is also contained
+     * in @second.
+     *
+     * If no matching `GType` is found, %G_TYPE_INVALID is returned.
+     * @param second - the `GdkContentFormats` to intersect with
+     */
     matchGtype(second: ContentFormats): number;
+    /**
+     * Finds the first mime type from `first` that is also contained
+     * in @second.
+     *
+     * If no matching mime type is found, %NULL is returned.
+     * @param second - the `GdkContentFormats` to intersect with
+     */
     matchMimeType(second: ContentFormats): string | null;
+    /**
+     * Prints the given `formats` into a string for human consumption.
+     *
+     * The result of this function can later be parsed with
+     * [func@Gdk.ContentFormats.parse].
+     * @param string - a `GString` to print into
+     */
     print(string: GLib.String): void;
+    /**
+     * Increases the reference count of a `GdkContentFormats` by one.
+     */
     ref(): ContentFormats;
+    /**
+     * Prints the given `formats` into a human-readable string.
+     *
+     * The resulting string can be parsed with [func@Gdk.ContentFormats.parse].
+     *
+     * This is a small wrapper around [method@Gdk.ContentFormats.print]
+     * to help when debugging.
+     */
     toString(): string;
+    /**
+     * Append all missing types from `second` to @first, in the order
+     * they had in @second.
+     * @param second - the `GdkContentFormats` to merge from
+     */
     union(second: ContentFormats): ContentFormats;
+    /**
+     * Add GTypes for mime types in `formats` for which deserializers are
+     * registered.
+     */
     unionDeserializeGtypes(): ContentFormats;
+    /**
+     * Add mime types for GTypes in `formats` for which deserializers are
+     * registered.
+     */
     unionDeserializeMimeTypes(): ContentFormats;
+    /**
+     * Add GTypes for the mime types in `formats` for which serializers are
+     * registered.
+     */
     unionSerializeGtypes(): ContentFormats;
+    /**
+     * Add mime types for GTypes in `formats` for which serializers are
+     * registered.
+     */
     unionSerializeMimeTypes(): ContentFormats;
+    /**
+     * Decreases the reference count of a `GdkContentFormats` by one.
+     *
+     * If the resulting reference count is zero, frees the formats.
+     */
     unref(): void;
 }