@gtkx/ffi 0.5.2 → 0.6.0

package/dist/generated/adw/about-dialog.js

@@ -0,0 +1,1218 @@
+import { call, getObject, isInstantiating, setInstantiating, registerType, } from "@gtkx/ffi";
+import { Dialog } from "./dialog.js";
+/**
+ * A dialog showing information about the application.
+ *
+ *
+ *
+ * an about dialog is typically opened when the user activates the `About …`
+ * item in the application's primary menu. All parts of the dialog are optional.
+ *
+ * ## Main page
+ *
+ * `AdwAboutDialog` prominently displays the application's icon, name, developer
+ * name and version. They can be set with the [property@AboutDialog:application-icon],
+ * [property@AboutDialog:application-name],
+ * [property@AboutDialog:developer-name] and [property@AboutDialog:version]
+ * respectively.
+ *
+ * ## What's New
+ *
+ * `AdwAboutDialog` provides a way for applications to display their release
+ * notes, set with the [property@AboutDialog:release-notes] property.
+ *
+ * Release notes are formatted the same way as
+ * AppStream descriptions.
+ *
+ * The supported formatting options are:
+ *
+ * * Paragraph (`<p>`)
+ * * Ordered list (`<ol>`), with list items (`<li>`)
+ * * Unordered list (`<ul>`), with list items (`<li>`)
+ *
+ * Within paragraphs and list items, emphasis (`<em>`) and inline code
+ * (`<code>`) text styles are supported. The emphasis is rendered in italic,
+ * while inline code is shown in a monospaced font.
+ *
+ * Any text outside paragraphs or list items is ignored.
+ *
+ * Nested lists are not supported.
+ *
+ * Only one version can be shown at a time. By default, the displayed version
+ * number matches [property@AboutDialog:version]. Use
+ * [property@AboutDialog:release-notes-version] to override it.
+ *
+ * ## Details
+ *
+ * The Details page displays the application comments and links.
+ *
+ * The comments can be set with the [property@AboutDialog:comments] property.
+ * Unlike [property@Gtk.AboutDialog:comments], this string can be long and
+ * detailed. It can also contain links and Pango markup.
+ *
+ * To set the application website, use [property@AboutDialog:website].
+ * To add extra links below the website, use [method@AboutDialog.add_link].
+ *
+ * If the Details page doesn't have any other content besides website, the
+ * website will be displayed on the main page instead.
+ *
+ * ## Troubleshooting
+ *
+ * `AdwAboutDialog` displays the following two links on the main page:
+ *
+ * * Support Questions, set with the [property@AboutDialog:support-url] property,
+ * * Report an Issue, set with the [property@AboutDialog:issue-url] property.
+ *
+ * Additionally, applications can provide debugging information. It will be
+ * shown separately on the Troubleshooting page. Use the
+ * [property@AboutDialog:debug-info] property to specify it.
+ *
+ * It's intended to be attached to issue reports when reporting issues against
+ * the application. As such, it cannot contain markup or links.
+ *
+ * `AdwAboutDialog` provides a quick way to save debug information to a file.
+ * When saving, [property@AboutDialog:debug-info-filename] would be used as
+ * the suggested filename.
+ *
+ * ## Credits and Acknowledgements
+ *
+ * The Credits page has the following default sections:
+ *
+ * * Developers, set with the [property@AboutDialog:developers] property,
+ * * Designers, set with the [property@AboutDialog:designers] property,
+ * * Artists, set with the [property@AboutDialog:artists] property,
+ * * Documenters, set with the [property@AboutDialog:documenters] property,
+ * * Translators, set with the [property@AboutDialog:translator-credits] property.
+ *
+ * When setting translator credits, use the strings `"translator-credits"` or
+ * `"translator_credits"` and mark them as translatable.
+ *
+ * The default sections that don't contain any names won't be displayed.
+ *
+ * The Credits page can also contain an arbitrary number of extra sections below
+ * the default ones. Use [method@AboutDialog.add_credit_section] to add them.
+ *
+ * The Acknowledgements page can be used to acknowledge additional people and
+ * organizations for their non-development contributions. Use
+ * [method@AboutDialog.add_acknowledgement_section] to add sections to it. For
+ * example, it can be used to list backers in a crowdfunded project or to give
+ * special thanks.
+ *
+ * Each of the people or organizations can have an email address or a website
+ * specified. To add a email address, use a string like
+ * `Edgar Allan Poe <edgar@poe.com>`. To specify a website with a title, use a
+ * string like `The GNOME Project https://www.gnome.org`:
+ *
+ *
+ *
+ * ## Legal
+ *
+ * The Legal page displays the copyright and licensing information for the
+ * application and other modules.
+ *
+ * The copyright string is set with the [property@AboutDialog:copyright]
+ * property and should be a short string of one or two lines, for example:
+ * `© 2022 Example`.
+ *
+ * Licensing information can be quickly set from a list of known licenses with
+ * the [property@AboutDialog:license-type] property. If the application's
+ * license is not in the list, [property@AboutDialog:license] can be used
+ * instead.
+ *
+ * To add information about other modules, such as application dependencies or
+ * data, use [method@AboutDialog.add_legal_section].
+ *
+ * ## Other applications
+ *
+ * `AdwAboutDialog` can show links to your other apps at the end of the main
+ * page. To add them, use [method@AboutDialog.add_other_app].
+ *
+ * ## Constructing
+ *
+ * To make constructing an `AdwAboutDialog` as convenient as possible, you can
+ * use the function [func@show_about_dialog] which constructs and shows a
+ * dialog.
+ *
+ * ```c
+ * static void
+ * show_about (GtkApplication *app)
+ * {
+ * const char *developers[] = {
+ * "Angela Avery",
+ * NULL
+ * };
+ *
+ * const char *designers[] = {
+ * "GNOME Design Team",
+ * NULL
+ * };
+ *
+ * adw_show_about_dialog (GTK_WIDGET (gtk_application_get_active_window (app)),
+ * "application-name", _("Example"),
+ * "application-icon", "org.example.App",
+ * "version", "1.2.3",
+ * "copyright", "© 2022 Angela Avery",
+ * "issue-url", "https://gitlab.gnome.org/example/example/-/issues/",
+ * "license-type", GTK_LICENSE_GPL_3_0,
+ * "developers", developers,
+ * "designers", designers,
+ * "translator-credits", _("translator-credits"),
+ * NULL);
+ * }
+ * ```
+ *
+ * ## CSS nodes
+ *
+ * `AdwAboutDialog` has a main CSS node with the name `dialog` and the
+ * style class `.about`.
+ */
+const SIGNAL_META = {
+    "activate-link": {
+        params: [{ type: { type: "string", borrowed: false } }],
+        returnType: { type: "boolean" },
+    },
+    "close-attempt": { params: [], returnType: { type: "undefined" } },
+    closed: { params: [], returnType: { type: "undefined" } },
+};
+export class AboutDialog extends Dialog {
+    static glibTypeName = "AdwAboutDialog";
+    /**
+     * Creates a new `AdwAboutDialog`.
+     */
+    constructor() {
+        if (!isInstantiating) {
+            setInstantiating(true);
+            // @ts-ignore
+            super();
+            setInstantiating(false);
+            this.id = call("libadwaita-1.so.0", "adw_about_dialog_new", [], {
+                type: "gobject",
+                borrowed: true,
+            });
+        }
+        else {
+            // @ts-ignore
+            super();
+        }
+    }
+    /**
+     * Creates a new `AdwAboutDialog` using AppStream metadata.
+     *
+     * This automatically sets the following properties with the following AppStream
+     * values:
+     *
+     * * [property@AboutDialog:application-icon] is set from the `<id>`
+     * * [property@AboutDialog:application-name] is set from the `<name>`
+     * * [property@AboutDialog:developer-name] is set from the `<name>` within
+     * `<developer>`
+     * * [property@AboutDialog:version] is set from the version of the latest release
+     * * [property@AboutDialog:website] is set from the `<url type="homepage">`
+     * * [property@AboutDialog:support-url] is set from the `<url type="help">`
+     * * [property@AboutDialog:issue-url] is set from the `<url type="bugtracker">`
+     * * [property@AboutDialog:license-type] is set from the `<project_license>`.
+     * If the license type retrieved from AppStream is not listed in
+     * [enum@Gtk.License], it will be set to `GTK_LICENCE_CUSTOM`.
+     *
+     * If `release_notes_version` is not `NULL`,
+     * [property@AboutDialog:release-notes-version] is set to match it, while
+     * [property@AboutDialog:release-notes] is set from the AppStream release
+     * description for that version.
+     * @param resourcePath - The resource to use
+     * @param releaseNotesVersion - The version to retrieve release notes for
+     */
+    static dialogNewFromAppdata(resourcePath, releaseNotesVersion) {
+        const ptr = call("libadwaita-1.so.0", "adw_about_dialog_new_from_appdata", [
+            {
+                type: { type: "string" },
+                value: resourcePath,
+            },
+            {
+                type: { type: "string" },
+                value: releaseNotesVersion,
+                optional: true,
+            },
+        ], { type: "gobject", borrowed: true });
+        return getObject(ptr);
+    }
+    /**
+     * Adds a section to the Acknowledgements page.
+     *
+     * This can be used to acknowledge additional people and organizations for their
+     * non-development contributions - for example, backers in a crowdfunded
+     * project.
+     *
+     * Each name may contain email addresses and URLs, see the introduction for more
+     * details.
+     *
+     * See also:
+     *
+     * * [property@AboutDialog:developers]
+     * * [property@AboutDialog:designers]
+     * * [property@AboutDialog:artists]
+     * * [property@AboutDialog:documenters]
+     * * [property@AboutDialog:translator-credits]
+     * * [method@AboutDialog.add_credit_section]
+     * @param name - the section name
+     * @param people - the list of names
+     */
+    addAcknowledgementSection(people, name) {
+        call("libadwaita-1.so.0", "adw_about_dialog_add_acknowledgement_section", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: name,
+                optional: true,
+            },
+            {
+                type: { type: "array", itemType: { type: "string" } },
+                value: people,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Adds an extra section to the Credits page.
+     *
+     * Extra sections are displayed below the standard categories.
+     *
+     * Each name may contain email addresses and URLs, see the introduction for more
+     * details.
+     *
+     * See also:
+     *
+     * * [property@AboutDialog:developers]
+     * * [property@AboutDialog:designers]
+     * * [property@AboutDialog:artists]
+     * * [property@AboutDialog:documenters]
+     * * [property@AboutDialog:translator-credits]
+     * * [method@AboutDialog.add_acknowledgement_section]
+     * @param name - the section name
+     * @param people - the list of names
+     */
+    addCreditSection(people, name) {
+        call("libadwaita-1.so.0", "adw_about_dialog_add_credit_section", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: name,
+                optional: true,
+            },
+            {
+                type: { type: "array", itemType: { type: "string" } },
+                value: people,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Adds an extra section to the Legal page.
+     *
+     * Extra sections will be displayed below the application's own information.
+     *
+     * The parameters @copyright, `license_type` and `license` will be used to present
+     * the it the same way as [property@AboutDialog:copyright],
+     * [property@AboutDialog:license-type] and [property@AboutDialog:license] are
+     * for the application's own information.
+     *
+     * See those properties for more details.
+     *
+     * This can be useful to attribute the application dependencies or data.
+     *
+     * Examples:
+     *
+     * ```c
+     * adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
+     * _("Copyright and a known license"),
+     * "© 2022 Example",
+     * GTK_LICENSE_LGPL_2_1,
+     * NULL);
+     *
+     * adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
+     * _("Copyright and custom license"),
+     * "© 2022 Example",
+     * GTK_LICENSE_CUSTOM,
+     * "Custom license text");
+     *
+     * adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
+     * _("Copyright only"),
+     * "© 2022 Example",
+     * GTK_LICENSE_UNKNOWN,
+     * NULL);
+     *
+     * adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
+     * _("Custom license only"),
+     * NULL,
+     * GTK_LICENSE_CUSTOM,
+     * "Something completely custom here.");
+     * ```
+     * @param title - the name of the section
+     * @param copyright - a copyright string
+     * @param licenseType - the type of license
+     * @param license - custom license information
+     */
+    addLegalSection(title, licenseType, copyright, license) {
+        call("libadwaita-1.so.0", "adw_about_dialog_add_legal_section", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: title,
+            },
+            {
+                type: { type: "string" },
+                value: copyright,
+                optional: true,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: false },
+                value: licenseType,
+            },
+            {
+                type: { type: "string" },
+                value: license,
+                optional: true,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Adds an extra link to the Details page.
+     *
+     * Extra links are displayed under the comment and website.
+     *
+     * Underlines in `title` will be interpreted as indicating a mnemonic.
+     *
+     * See [property@AboutDialog:website].
+     * @param title - the link title
+     * @param url - the link URL
+     */
+    addLink(title, url) {
+        call("libadwaita-1.so.0", "adw_about_dialog_add_link", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: title,
+            },
+            {
+                type: { type: "string" },
+                value: url,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Adds another application to @self.
+     *
+     * The application will be displayed at the bottom of the main page, in a
+     * separate section. Each added application will be presented as a row with
+     * `title` and @summary, as well as an icon with the name @appid. Clicking the
+     * row will show `appid` in the software center app.
+     *
+     * This can be used to link to your other applications if you have multiple.
+     *
+     * Example:
+     *
+     * ```c
+     * adw_about_dialog_add_other_app (ADW_ABOUT_DIALOG (about),
+     * "org.gnome.Boxes",
+     * _("Boxes"),
+     * _("Virtualization made simple"));
+     * ```
+     * @param appid - the application ID
+     * @param name - the application name
+     * @param summary - the application summary
+     */
+    addOtherApp(appid, name, summary) {
+        call("libadwaita-1.so.0", "adw_about_dialog_add_other_app", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: appid,
+            },
+            {
+                type: { type: "string" },
+                value: name,
+            },
+            {
+                type: { type: "string" },
+                value: summary,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Gets the name of the application icon for @self.
+     */
+    getApplicationIcon() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_application_icon", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the application name for @self.
+     */
+    getApplicationName() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_application_name", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the list of artists of the application.
+     */
+    getArtists() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_artists", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "array", itemType: { type: "string" } });
+    }
+    /**
+     * Gets the comments about the application.
+     */
+    getComments() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_comments", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the copyright information for @self.
+     */
+    getCopyright() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_copyright", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the debug information for @self.
+     */
+    getDebugInfo() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_debug_info", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the debug information filename for @self.
+     */
+    getDebugInfoFilename() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_debug_info_filename", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the list of designers of the application.
+     */
+    getDesigners() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_designers", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "array", itemType: { type: "string" } });
+    }
+    /**
+     * Gets the developer name for @self.
+     */
+    getDeveloperName() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_developer_name", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the list of developers of the application.
+     */
+    getDevelopers() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_developers", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "array", itemType: { type: "string" } });
+    }
+    /**
+     * Gets the list of documenters of the application.
+     */
+    getDocumenters() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_documenters", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "array", itemType: { type: "string" } });
+    }
+    /**
+     * Gets the issue tracker URL for @self.
+     */
+    getIssueUrl() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_issue_url", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the license for @self.
+     */
+    getLicense() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_license", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the license type for @self.
+     */
+    getLicenseType() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_license_type", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "int", size: 32, unsigned: false });
+    }
+    /**
+     * Gets the release notes for @self.
+     */
+    getReleaseNotes() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_release_notes", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the version described by the application's release notes.
+     */
+    getReleaseNotesVersion() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_release_notes_version", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the URL of the support page for @self.
+     */
+    getSupportUrl() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_support_url", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the translator credits string.
+     */
+    getTranslatorCredits() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_translator_credits", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the version for @self.
+     */
+    getVersion() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_version", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Gets the application website URL for @self.
+     */
+    getWebsite() {
+        return call("libadwaita-1.so.0", "adw_about_dialog_get_website", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+        ], { type: "string", borrowed: true });
+    }
+    /**
+     * Sets the name of the application icon for @self.
+     *
+     * The icon is displayed at the top of the main page.
+     * @param applicationIcon - the application icon name
+     */
+    setApplicationIcon(applicationIcon) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_application_icon", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: applicationIcon,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the application name for @self.
+     *
+     * The name is displayed at the top of the main page.
+     * @param applicationName - the application name
+     */
+    setApplicationName(applicationName) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_application_name", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: applicationName,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the list of artists of the application.
+     *
+     * It will be displayed on the Credits page.
+     *
+     * Each name may contain email addresses and URLs, see the introduction for more
+     * details.
+     *
+     * See also:
+     *
+     * * [property@AboutDialog:developers]
+     * * [property@AboutDialog:designers]
+     * * [property@AboutDialog:documenters]
+     * * [property@AboutDialog:translator-credits]
+     * * [method@AboutDialog.add_credit_section]
+     * * [method@AboutDialog.add_acknowledgement_section]
+     * @param artists - the list of artists
+     */
+    setArtists(artists) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_artists", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "array", itemType: { type: "string" } },
+                value: artists,
+                optional: true,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the comments about the application.
+     *
+     * Comments will be shown on the Details page, above links.
+     *
+     * Unlike [property@Gtk.AboutDialog:comments], this string can be long and
+     * detailed. It can also contain links and Pango markup.
+     * @param comments - the comments
+     */
+    setComments(comments) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_comments", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: comments,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the copyright information for @self.
+     *
+     * This should be a short string of one or two lines, for example:
+     * `© 2022 Example`.
+     *
+     * The copyright information will be displayed on the Legal page, before the
+     * application license.
+     *
+     * [method@AboutDialog.add_legal_section] can be used to add copyright
+     * information for the application dependencies or other components.
+     * @param copyright - the copyright information
+     */
+    setCopyright(copyright) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_copyright", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: copyright,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the debug information for @self.
+     *
+     * Debug information will be shown on the Troubleshooting page. It's intended
+     * to be attached to issue reports when reporting issues against the
+     * application.
+     *
+     * `AdwAboutDialog` provides a quick way to save debug information to a file.
+     * When saving, [property@AboutDialog:debug-info-filename] would be used as
+     * the suggested filename.
+     *
+     * Debug information cannot contain markup or links.
+     * @param debugInfo - the debug information
+     */
+    setDebugInfo(debugInfo) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_debug_info", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: debugInfo,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the debug information filename for @self.
+     *
+     * It will be used as the suggested filename when saving debug information to a
+     * file.
+     *
+     * See [property@AboutDialog:debug-info].
+     * @param filename - the debug info filename
+     */
+    setDebugInfoFilename(filename) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_debug_info_filename", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: filename,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the list of designers of the application.
+     *
+     * It will be displayed on the Credits page.
+     *
+     * Each name may contain email addresses and URLs, see the introduction for more
+     * details.
+     *
+     * See also:
+     *
+     * * [property@AboutDialog:developers]
+     * * [property@AboutDialog:artists]
+     * * [property@AboutDialog:documenters]
+     * * [property@AboutDialog:translator-credits]
+     * * [method@AboutDialog.add_credit_section]
+     * * [method@AboutDialog.add_acknowledgement_section]
+     * @param designers - the list of designers
+     */
+    setDesigners(designers) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_designers", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "array", itemType: { type: "string" } },
+                value: designers,
+                optional: true,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the developer name for @self.
+     *
+     * The developer name is displayed on the main page, under the application name.
+     *
+     * If the application is developed by multiple people, the developer name can be
+     * set to values like "AppName team", "AppName developers" or
+     * "The AppName project", and the individual contributors can be listed on the
+     * Credits page, with [property@AboutDialog:developers] and related properties.
+     * @param developerName - the developer name
+     */
+    setDeveloperName(developerName) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_developer_name", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: developerName,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the list of developers of the application.
+     *
+     * It will be displayed on the Credits page.
+     *
+     * Each name may contain email addresses and URLs, see the introduction for more
+     * details.
+     *
+     * See also:
+     *
+     * * [property@AboutDialog:designers]
+     * * [property@AboutDialog:artists]
+     * * [property@AboutDialog:documenters]
+     * * [property@AboutDialog:translator-credits]
+     * * [method@AboutDialog.add_credit_section]
+     * * [method@AboutDialog.add_acknowledgement_section]
+     * @param developers - the list of developers
+     */
+    setDevelopers(developers) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_developers", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "array", itemType: { type: "string" } },
+                value: developers,
+                optional: true,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the list of documenters of the application.
+     *
+     * It will be displayed on the Credits page.
+     *
+     * Each name may contain email addresses and URLs, see the introduction for more
+     * details.
+     *
+     * See also:
+     *
+     * * [property@AboutDialog:developers]
+     * * [property@AboutDialog:designers]
+     * * [property@AboutDialog:artists]
+     * * [property@AboutDialog:translator-credits]
+     * * [method@AboutDialog.add_credit_section]
+     * * [method@AboutDialog.add_acknowledgement_section]
+     * @param documenters - the list of documenters
+     */
+    setDocumenters(documenters) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_documenters", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "array", itemType: { type: "string" } },
+                value: documenters,
+                optional: true,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the issue tracker URL for @self.
+     *
+     * The issue tracker link is displayed on the main page.
+     * @param issueUrl - the issue tracker URL
+     */
+    setIssueUrl(issueUrl) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_issue_url", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: issueUrl,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the license for @self.
+     *
+     * This can be used to set a custom text for the license if it can't be set via
+     * [property@AboutDialog:license-type].
+     *
+     * When set, [property@AboutDialog:license-type] will be set to
+     * `GTK_LICENSE_CUSTOM`.
+     *
+     * The license text will be displayed on the Legal page, below the copyright
+     * information.
+     *
+     * License text can contain Pango markup and links.
+     *
+     * [method@AboutDialog.add_legal_section] can be used to add license information
+     * for the application dependencies or other components.
+     * @param license - the license
+     */
+    setLicense(license) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_license", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: license,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the license for `self` from a list of known licenses.
+     *
+     * If the application's license is not in the list,
+     * [property@AboutDialog:license] can be used instead. The license type will be
+     * automatically set to `GTK_LICENSE_CUSTOM` in that case.
+     *
+     * If `license_type` is `GTK_LICENSE_UNKNOWN`, no information will be displayed.
+     *
+     * If `license_type` is different from `GTK_LICENSE_CUSTOM`.
+     * [property@AboutDialog:license] will be cleared out.
+     *
+     * The license description will be displayed on the Legal page, below the
+     * copyright information.
+     *
+     * [method@AboutDialog.add_legal_section] can be used to add license information
+     * for the application dependencies or other components.
+     * @param licenseType - the license type
+     */
+    setLicenseType(licenseType) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_license_type", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "int", size: 32, unsigned: false },
+                value: licenseType,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the release notes for @self.
+     *
+     * Release notes are displayed on the the What's New page.
+     *
+     * Release notes are formatted the same way as
+     * AppStream descriptions.
+     *
+     * The supported formatting options are:
+     *
+     * * Paragraph (`<p>`)
+     * * Ordered list (`<ol>`), with list items (`<li>`)
+     * * Unordered list (`<ul>`), with list items (`<li>`)
+     *
+     * Within paragraphs and list items, emphasis (`<em>`) and inline code
+     * (`<code>`) text styles are supported. The emphasis is rendered in italic,
+     * while inline code is shown in a monospaced font.
+     *
+     * Any text outside paragraphs or list items is ignored.
+     *
+     * Nested lists are not supported.
+     *
+     * `AdwAboutDialog` displays the version above the release notes. If set, the
+     * [property@AboutDialog:release-notes-version] of the property will be used
+     * as the version; otherwise, [property@AboutDialog:version] is used.
+     * @param releaseNotes - the release notes
+     */
+    setReleaseNotes(releaseNotes) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_release_notes", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: releaseNotes,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the version described by the application's release notes.
+     *
+     * The release notes version is displayed on the What's New page, above the
+     * release notes.
+     *
+     * If not set, [property@AboutDialog:version] will be used instead.
+     *
+     * For example, an application with the current version 2.0.2 might want to
+     * keep the release notes from 2.0.0, and set the release notes version
+     * accordingly.
+     *
+     * See [property@AboutDialog:release-notes].
+     * @param version - the release notes version
+     */
+    setReleaseNotesVersion(version) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_release_notes_version", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: version,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the URL of the support page for @self.
+     *
+     * The support page link is displayed on the main page.
+     * @param supportUrl - the support page URL
+     */
+    setSupportUrl(supportUrl) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_support_url", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: supportUrl,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the translator credits string.
+     *
+     * It will be displayed on the Credits page.
+     *
+     * This string should be `"translator-credits"` or `"translator_credits"` and
+     * should be marked as translatable.
+     *
+     * The string may contain email addresses and URLs, see the introduction for
+     * more details. When there is more than one translator, they must be
+     * separated by a newline in the same string.
+     *
+     * See also:
+     *
+     * * [property@AboutDialog:developers]
+     * * [property@AboutDialog:designers]
+     * * [property@AboutDialog:artists]
+     * * [property@AboutDialog:documenters]
+     * * [method@AboutDialog.add_credit_section]
+     * * [method@AboutDialog.add_acknowledgement_section]
+     * @param translatorCredits - the translator credits
+     */
+    setTranslatorCredits(translatorCredits) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_translator_credits", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: translatorCredits,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the version for @self.
+     *
+     * The version is displayed on the main page.
+     *
+     * If [property@AboutDialog:release-notes-version] is not set, the version will
+     * also be displayed above the release notes on the What's New page.
+     * @param version - the version
+     */
+    setVersion(version) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_version", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: version,
+            },
+        ], { type: "undefined" });
+    }
+    /**
+     * Sets the application website URL for @self.
+     *
+     * Website is displayed on the Details page, below comments, or on the main page
+     * if the Details page doesn't have any other content.
+     *
+     * Applications can add other links below, see [method@AboutDialog.add_link].
+     * @param website - the website URL
+     */
+    setWebsite(website) {
+        call("libadwaita-1.so.0", "adw_about_dialog_set_website", [
+            {
+                type: { type: "gobject" },
+                value: this.id,
+            },
+            {
+                type: { type: "string" },
+                value: website,
+            },
+        ], { type: "undefined" });
+    }
+    connect(signal, handler, after = false) {
+        const meta = SIGNAL_META[signal];
+        const selfType = { type: "gobject", borrowed: true };
+        const argTypes = meta
+            ? [selfType, ...meta.params.map((m) => m.type)]
+            : [selfType];
+        const returnType = meta?.returnType;
+        const wrappedHandler = (...args) => {
+            const self = getObject(args[0]);
+            const signalArgs = args.slice(1);
+            if (!meta)
+                return handler(self, ...signalArgs);
+            const wrapped = meta.params.map((m, i) => {
+                if (m.getCls && signalArgs[i] != null) {
+                    return getObject(signalArgs[i]);
+                }
+                return signalArgs[i];
+            });
+            return handler(self, ...wrapped);
+        };
+        return call("libadwaita-1.so.0", "g_signal_connect_closure", [
+            { type: { type: "gobject" }, value: this.id },
+            { type: { type: "string" }, value: signal },
+            {
+                type: { type: "callback", argTypes, returnType },
+                value: wrappedHandler,
+            },
+            { type: { type: "boolean" }, value: after },
+        ], { type: "int", size: 64, unsigned: true });
+    }
+}
+registerType(AboutDialog);