@gtkx/ffi 0.10.5 → 0.11.0

package/dist/generated/appstream/component.d.ts

@@ -13,6 +13,7 @@ import { Pool } from "./pool.js";
 import { Provided } from "./provided.js";
 import { Reference } from "./reference.js";
 import { Relation } from "./relation.js";
+import { RelationCheckResult } from "./relation-check-result.js";
 import { Release } from "./release.js";
 import { ReleaseList } from "./release-list.js";
 import { Review } from "./review.js";
@@ -25,149 +26,74 @@ import * as GObject from "../gobject/index.js";
 export declare class Component extends GObject.GObject {
     static readonly glibTypeName: string;
     static readonly objectType: "gobject";
-    /**
-     * Creates a new #AsComponent.
-     */
+    /** Creates a new #AsComponent. */
     constructor();
-    /**
-     * Add a reference to the addon that is enhancing this component.
-     * @param addon - The #AsComponent that extends `cpt`
-     */
+    /** Add a reference to the addon that is enhancing this component. */
     addAddon(addon: Component): void;
-    /**
-     * Adds an agreement to the software component.
-     * @param agreement - an #AsAgreement instance.
-     */
+    /** Adds an agreement to the software component. */
     addAgreement(agreement: Agreement): void;
-    /**
-     * Adds a bundle to the component.
-     * @param bundle - The #AsBundle to add.
-     */
+    /** Adds a bundle to the component. */
     addBundle(bundle: Bundle): void;
-    /**
-     * Add a category.
-     * @param category - the categories name to add.
-     */
+    /** Add a category. */
     addCategory(category: string): void;
-    /**
-     * Adds a content rating to this component.
-     * @param contentRating - a #AsContentRating instance.
-     */
+    /** Adds a content rating to this component. */
     addContentRating(contentRating: ContentRating): void;
-    /**
-     * Add a reference to the extended component
-     * @param cptId - The id of a component which is extended by this component
-     */
+    /** Add a reference to the extended component */
     addExtends(cptId: string): void;
-    /**
-     * Add an icon to this component.
-     * @param icon - the valid #AsIcon instance to add.
-     */
+    /** Add an icon to this component. */
     addIcon(icon: Icon): void;
     /**
      * Add a new keyword to the keywords list for the given locale. This function does not
      * check for duplicate keywords.
-     * @param keyword - The new keyword to add.
-     * @param locale - BCP47 locale of the values, or %NULL to use current locale.
-     */
-    addKeyword(keyword: string, locale?: string): void;
-    /**
-     * Adds a language to the component.
-     * @param locale - the BCP47 locale, or %NULL. e.g. "en-GB"
-     * @param percentage - the percentage completion of the translation, 0 for locales with unknown amount of translation
-     */
-    addLanguage(percentage: number, locale?: string): void;
-    /**
-     * Adds a #AsLaunchable containing launchables entries for this component.
-     * @param launchable - a #AsLaunchable instance.
      */
+    addKeyword(keyword: string, locale?: string | null): void;
+    /** Adds a language to the component. */
+    addLanguage(percentage: number, locale?: string | null): void;
+    /** Adds a #AsLaunchable containing launchables entries for this component. */
     addLaunchable(launchable: Launchable): void;
-    /**
-     * Add a set of provided items to this component.
-     * @param prov - a #AsProvided instance.
-     */
+    /** Add a set of provided items to this component. */
     addProvided(prov: Provided): void;
     /**
      * Adds a provided item to the component with the given `kind`, creating a new
      * `AsProvided` for this kind internally if necessary.
-     * @param kind - the kind of the provided item (e.g. %AS_PROVIDED_KIND_MEDIATYPE)
-     * @param item - the item to add.
      */
     addProvidedItem(kind: ProvidedKind, item: string): void;
-    /**
-     * Adds an external reference to the software component.
-     * @param reference - an #AsReference instance.
-     */
+    /** Adds an external reference to the software component. */
     addReference(reference: Reference): void;
     /**
      * Adds a #AsRelation to set a recommends or requires relation of
      * component `cpt` on the item mentioned in the #AsRelation.
-     * @param relation - a #AsRelation instance.
      */
     addRelation(relation: Relation): void;
-    /**
-     * Add an #AsRelease to this component.
-     * @param release - The #AsRelease to add
-     */
+    /** Add an #AsRelease to this component. */
     addRelease(release: Release): void;
-    /**
-     * Add the component ID of a component that gets replaced by the current component.
-     * @param cid - an AppStream component ID
-     */
+    /** Add the component ID of a component that gets replaced by the current component. */
     addReplaces(cid: string): void;
-    /**
-     * Adds a user review to a software component.
-     * @param review - a #AsReview instance.
-     */
+    /** Adds a user review to a software component. */
     addReview(review: Review): void;
-    /**
-     * Add an #AsScreenshot to this component.
-     * @param sshot - The #AsScreenshot to add
-     */
+    /** Add an #AsScreenshot to this component. */
     addScreenshot(sshot: Screenshot): void;
-    /**
-     * Add an #AsSuggested to this component.
-     * @param suggested - The #AsSuggested
-     */
+    /** Add an #AsSuggested to this component. */
     addSuggested(suggested: Suggested): void;
-    /**
-     * Add a tag to this component.
-     * @param ns - The namespace the tag belongs to
-     * @param tag - The tag name
-     */
+    /** Add a tag to this component. */
     addTag(ns: string, tag: string): boolean;
     /**
      * Assign an #AsTranslation object describing the translation system used
      * by this component.
-     * @param tr - an #AsTranslation instance.
      */
     addTranslation(tr: Translation): void;
-    /**
-     * Adds some URL data to the component.
-     * @param urlKind - the URL kind, e.g. %AS_URL_KIND_HOMEPAGE
-     * @param url - the full URL.
-     */
+    /** Adds some URL data to the component. */
     addUrl(urlKind: UrlKind, url: string): void;
     /**
      * Verifies the respective relations and presents whether the system specified
      * in #AsSystemInfo `sysinfo` and data from `pool` supply the requested facilities.
-     * @param sysinfo - an #AsSystemInfo to use for system information.
-     * @param pool - an #AsPool to find component dependencies in.
-     * @param relKind - the kind of relations to check
-     */
-    checkRelations(relKind: RelationKind, sysinfo?: SystemInfo, pool?: Pool): GLib.PtrArray;
-    /**
-     * Remove all keywords for the given locale.
-     * @param locale - BCP47 locale of the values, or %NULL to use current locale.
-     */
-    clearKeywords(locale?: string): void;
-    /**
-     * Remove all registered language translation information.
      */
+    checkRelations(relKind: RelationKind, sysinfo?: SystemInfo | null, pool?: Pool | null): RelationCheckResult[];
+    /** Remove all keywords for the given locale. */
+    clearKeywords(locale?: string | null): void;
+    /** Remove all registered language translation information. */
     clearLanguages(): void;
-    /**
-     * Remove all tags associated with this component.
-     */
+    /** Remove all tags associated with this component. */
     clearTags(): void;
     /**
      * Returns a list of #AsComponent objects which
@@ -175,45 +101,28 @@ export declare class Component extends GObject.GObject {
      *
      * This is the reverse of %as_component_get_extends()
      */
-    getAddons(): GLib.PtrArray;
-    /**
-     * Gets an agreement the component has specified for the particular kind.
-     * @param kind - an agreement kind, e.g. %AS_AGREEMENT_KIND_EULA
-     */
+    getAddons(): Component[];
+    /** Gets an agreement the component has specified for the particular kind. */
     getAgreementByKind(kind: AgreementKind): Agreement | null;
-    /**
-     * Get a list of all agreements registered with this software component.
-     */
-    getAgreements(): GLib.PtrArray;
-    /**
-     * Gets the branch for the application.
-     */
+    /** Get a list of all agreements registered with this software component. */
+    getAgreements(): Agreement[];
+    /** Gets the branch for the application. */
     getBranch(): string;
     /**
      * Get the branding associated with this component, or %NULL
      * in case this component has no special branding.
      */
     getBranding(): Branding | null;
-    /**
-     * Gets a bundle identifier string.
-     * @param bundleKind - the bundle kind, e.g. %AS_BUNDLE_KIND_LIMBA.
-     */
+    /** Gets a bundle identifier string. */
     getBundle(bundleKind: BundleKind): Bundle | null;
-    /**
-     * Get a list of all software bundles associated with this component.
-     */
-    getBundles(): GLib.PtrArray;
-    getCategories(): GLib.PtrArray;
-    getCompulsoryForDesktops(): GLib.PtrArray;
-    /**
-     * Gets a content ratings of a specific type that are defined for this component.
-     * @param kind - a ratings kind, e.g. "oars-1.0"
-     */
+    /** Get a list of all software bundles associated with this component. */
+    getBundles(): Bundle[];
+    getCategories(): string[];
+    getCompulsoryForDesktops(): string[];
+    /** Gets a content ratings of a specific type that are defined for this component. */
     getContentRating(kind: string): ContentRating | null;
-    /**
-     * Gets all content ratings defined for this software.
-     */
-    getContentRatings(): GLib.PtrArray;
+    /** Gets all content ratings defined for this software. */
+    getContentRatings(): ContentRating[];
     /**
      * Get the #AsContext associated with this component.
      * This function may return %NULL if no context is set
@@ -221,11 +130,8 @@ export declare class Component extends GObject.GObject {
      * a file or cache but constructed in memory).
      */
     getContext(): Context | null;
-    getCustom(): GLib.HashTable;
-    /**
-     * Retrieve value for a custom data entry with the given key.
-     * @param key - Field name.
-     */
+    getCustom(): Map<number, number>;
+    /** Retrieve value for a custom data entry with the given key. */
     getCustomValue(key: string): string;
     /**
      * Get a unique identifier for this metadata set.
@@ -240,13 +146,9 @@ export declare class Component extends GObject.GObject {
      * system/os/package/org.example.FooBar
      */
     getDataId(): string;
-    /**
-     * Gets the end-of-life date for the entire component.
-     */
+    /** Gets the end-of-life date for the entire component. */
     getDateEol(): string;
-    /**
-     * Get the localized long description of this component.
-     */
+    /** Get the localized long description of this component. */
     getDescription(): string;
     /**
      * Get information about the component's developer or development team.
@@ -260,7 +162,7 @@ export declare class Component extends GObject.GObject {
      *
      * See %as_component_get_extends() for the reverse.
      */
-    getExtends(): GLib.PtrArray | null;
+    getExtends(): string[] | null;
     /**
      * Gets an icon matching the size constraints.
      * The icons are not filtered by type, and the first icon
@@ -270,8 +172,6 @@ export declare class Component extends GObject.GObject {
      *
      * Note that this function is not HiDPI aware! It will never return an icon with
      * a scaling factor > 1.
-     * @param width - The icon width in pixels.
-     * @param height - the icon height in pixels.
      */
     getIconBySize(width: number, height: number): Icon | null;
     /**
@@ -279,7 +179,7 @@ export declare class Component extends GObject.GObject {
      * Will return %NULL otherwise.
      */
     getIconStock(): Icon | null;
-    getIcons(): GLib.PtrArray;
+    getIcons(): Icon[];
     /**
      * Get the unique AppStream identifier for this component.
      * This ID is unique for the described component, but does
@@ -289,50 +189,38 @@ export declare class Component extends GObject.GObject {
      * session, use %as_component_get_data_id()
      */
     getId(): string;
-    getKeywords(): GLib.PtrArray;
+    getKeywords(): string[];
     /**
      * Retrieve the internal hash table mapping languages to
      * keword arrays.
      */
-    getKeywordsTable(): GLib.HashTable;
-    /**
-     * Returns the #AsComponentKind of this component.
-     */
+    getKeywordsTable(): Map<number, number>;
+    /** Returns the #AsComponentKind of this component. */
     getKind(): ComponentKind;
-    /**
-     * Gets the translation coverage in percent for a specific locale
-     * @param locale - the BCP47 locale, or %NULL. e.g. "en-GB"
-     */
-    getLanguage(locale?: string): number;
-    /**
-     * Get a list of all languages.
-     */
+    /** Gets the translation coverage in percent for a specific locale */
+    getLanguage(locale?: string | null): number;
+    /** Get a list of all languages. */
     getLanguages(): string[];
     /**
      * Gets a #AsLaunchable of a specific type that contains launchable entries for
      * this component.
-     * @param kind - a launch kind, e.g. %AS_LAUNCHABLE_KIND_DESKTOP_ID
      */
     getLaunchable(kind: LaunchableKind): Launchable | null;
-    getLaunchables(): GLib.PtrArray;
+    getLaunchables(): Launchable[];
     /**
      * Get the merge method which should apply to duplicate components
      * with this ID.
      */
     getMergeKind(): MergeKind;
-    /**
-     * The license the metadata iself is subjected to.
-     */
+    /** The license the metadata iself is subjected to. */
     getMetadataLicense(): string;
-    /**
-     * A human-readable name for this component.
-     */
+    /** A human-readable name for this component. */
     getName(): string;
     /**
      * Get the internal locale to component name
      * mapping table.
      */
-    getNameTable(): GLib.HashTable;
+    getNameTable(): Map<number, number>;
     /**
      * Get variant suffix for the component name
      * (only to be displayed if two components have the same name).
@@ -360,59 +248,38 @@ export declare class Component extends GObject.GObject {
      * This method is used internally.
      */
     getPriority(): number;
-    /**
-     * Get the component's project group.
-     */
+    /** Get the component's project group. */
     getProjectGroup(): string;
-    /**
-     * Get the license of the project this component belongs to.
-     */
+    /** Get the license of the project this component belongs to. */
     getProjectLicense(): string;
-    /**
-     * Get a list of #AsProvided objects associated with this component.
-     */
-    getProvided(): GLib.PtrArray;
+    /** Get a list of #AsProvided objects associated with this component. */
+    getProvided(): Provided[];
     /**
      * Get an #AsProvided object for the given interface type,
      * containing information about the public interfaces (mimetypes, firmware, DBus services, ...)
      * this component provides.
-     * @param kind - kind of the provided item, e.g. %AS_PROVIDED_KIND_MEDIATYPE
      */
     getProvidedForKind(kind: ProvidedKind): Provided | null;
-    /**
-     * Get an array of items that are recommended by this component.
-     */
-    getRecommends(): GLib.PtrArray;
-    /**
-     * Get a list of external references and citation information for this component.
-     */
-    getReferences(): GLib.PtrArray;
+    /** Get an array of items that are recommended by this component. */
+    getRecommends(): Relation[];
+    /** Get a list of external references and citation information for this component. */
+    getReferences(): Reference[];
     /**
      * Get release information for this component,
      * without downloading or loading any data from external sources.
      */
     getReleasesPlain(): ReleaseList;
-    /**
-     * Get a list of component IDs of components that this software replaces entirely.
-     */
-    getReplaces(): GLib.PtrArray;
-    /**
-     * Get an array of items that are required by this component.
-     */
-    getRequires(): GLib.PtrArray;
-    /**
-     * Gets any reviews associated with the component.
-     */
-    getReviews(): GLib.PtrArray;
+    /** Get a list of component IDs of components that this software replaces entirely. */
+    getReplaces(): string[];
+    /** Get an array of items that are required by this component. */
+    getRequires(): Relation[];
+    /** Gets any reviews associated with the component. */
+    getReviews(): Review[];
     getScope(): ComponentScope;
-    /**
-     * Get a list of all associated screenshots, for all environments.
-     */
-    getScreenshotsAll(): GLib.PtrArray;
-    /**
-     * Returns all search tokens for this component.
-     */
-    getSearchTokens(): GLib.PtrArray;
+    /** Get a list of all associated screenshots, for all environments. */
+    getScreenshotsAll(): Screenshot[];
+    /** Returns all search tokens for this component. */
+    getSearchTokens(): string[];
     /**
      * Returns the sorting priority of this component.
      *
@@ -429,34 +296,27 @@ export declare class Component extends GObject.GObject {
      */
     getSortScore(): number;
     getSourcePkgname(): string;
-    /**
-     * Get a list of associated suggestions.
-     */
-    getSuggested(): GLib.PtrArray;
-    /**
-     * Get a short description of this component.
-     */
+    /** Get a list of associated suggestions. */
+    getSuggested(): Suggested[];
+    /** Get a short description of this component. */
     getSummary(): string;
     /**
      * Get the internal locale to component summary
      * mapping table.
      */
-    getSummaryTable(): GLib.HashTable;
+    getSummaryTable(): Map<number, number>;
     /**
      * Get an array of items that are supported by this component,
      * e.g. to indicate support for a specific piece of hardware.
      */
-    getSupports(): GLib.PtrArray;
+    getSupports(): Relation[];
     /**
      * Return a score between 0 and 100 determining how compatible the component
      * is with the system configuration provided as parameter.
      *
      * 0 means the componsnt will not work at all, while 100 is best compatibility.
-     * @param sysinfo - an #AsSystemInfo to use for system information.
-     * @param isTemplate - if %TRUE, treat system info as neutral template, ignoring any peripheral devices or kernel relations.
-     * @param results - Receive the resulting check results
      */
-    getSystemCompatibilityScore(sysinfo: SystemInfo, isTemplate: boolean, results?: Ref<GLib.PtrArray>): number;
+    getSystemCompatibilityScore(sysinfo: SystemInfo, isTemplate: boolean, results?: Ref<RelationCheckResult[]> | null): number;
     /**
      * Gets the UNIX timestamp for the date when this component
      * is out of support (end-of-life) and will receive no more
@@ -470,35 +330,20 @@ export declare class Component extends GObject.GObject {
      *
      * Only set for metainfo files.
      */
-    getTranslations(): GLib.PtrArray;
-    /**
-     * Gets a URL.
-     * @param urlKind - the URL kind, e.g. %AS_URL_KIND_HOMEPAGE.
-     */
+    getTranslations(): Translation[];
+    /** Gets a URL. */
     getUrl(urlKind: UrlKind): string | null;
     hasBundle(): boolean;
-    /**
-     * Check if component is in the specified category.
-     * @param category - the specified category to check
-     */
+    /** Check if component is in the specified category. */
     hasCategory(category: string): boolean;
     /**
      * Test if the component is tagged with the selected
      * tag.
-     * @param ns - The namespace the tag belongs to
-     * @param tag - The tag name
      */
     hasTag(ns: string, tag: string): boolean;
-    /**
-     * Add a key and value pair to the custom data table.
-     * @param key - Key name.
-     * @param value - A string value.
-     */
+    /** Add a key and value pair to the custom data table. */
     insertCustomValue(key: string, value: string): boolean;
-    /**
-     * Check if this component is compulsory for the given desktop.
-     * @param desktop - the desktop-id to test for
-     */
+    /** Check if this component is compulsory for the given desktop. */
     isCompulsoryForDesktop(desktop: string): boolean;
     /**
      * Returns %TRUE if this component is free and open source software.
@@ -508,10 +353,7 @@ export declare class Component extends GObject.GObject {
      */
     isFloss(): boolean;
     isIgnored(): boolean;
-    /**
-     * Test if the component `cpt` is a member of category `category`.
-     * @param category - The category to test.
-     */
+    /** Test if the component `cpt` is a member of category `category`. */
     isMemberOfCategory(category: Category): boolean;
     /**
      * Check if the essential properties of this Component are
@@ -526,9 +368,6 @@ export declare class Component extends GObject.GObject {
      * If this function returns %TRUE, a valid component is returned unless the selected
      * format was %AS_FORMAT_KIND_DESKTOP_ENTRY, in which case a component ID will have to
      * be set explicitly by the caller in order to make the component valid.
-     * @param context - an #AsContext instance.
-     * @param format - the format of the data to load, e.g. %AS_FORMAT_KIND_XML
-     * @param bytes - the data to load.
      */
     loadFromBytes(context: Context, format: FormatKind, bytes: GLib.Bytes): boolean;
     /**
@@ -536,41 +375,21 @@ export declare class Component extends GObject.GObject {
      * if necessary.
      */
     loadReleases(allowNet: boolean): ReleaseList | null;
-    /**
-     * Remove a tag from this component
-     * @param ns - The namespace the tag belongs to
-     * @param tag - The tag name
-     */
+    /** Remove a tag from this component */
     removeTag(ns: string, tag: string): boolean;
-    /**
-     * Searches component data for a specific keyword.
-     * @param term - the search term.
-     */
+    /** Searches component data for a specific keyword. */
     searchMatches(term: string): number;
-    /**
-     * Searches component data for all the specific keywords.
-     * @param terms - the search terms.
-     */
+    /** Searches component data for all the specific keywords. */
     searchMatchesAll(terms: string): number;
-    /**
-     * Set the branch that the component instance was sourced from.
-     * @param branch - the branch, e.g. "master" or "3-16".
-     */
+    /** Set the branch that the component instance was sourced from. */
     setBranch(branch: string): void;
-    /**
-     * Set branding for this component.
-     * @param branding - an #AsBranding instance.
-     */
+    /** Set branding for this component. */
     setBranding(branding: Branding): void;
-    /**
-     * Mark this component to be compulsory for the specified desktop environment.
-     * @param desktop - The name of the desktop.
-     */
+    /** Mark this component to be compulsory for the specified desktop environment. */
     setCompulsoryForDesktop(desktop: string): void;
     /**
      * Sets the document context this component is associated
      * with.
-     * @param context - the #AsContext.
      */
     setContext(context: Context): void;
     /**
@@ -581,7 +400,6 @@ export declare class Component extends GObject.GObject {
      * entities that use the same context as well!
      * This function is just a convenience method, and does not replace
      * proper #AsContext management.
-     * @param locale - the new locale.
      */
     setContextLocale(locale: string): void;
     /**
@@ -590,73 +408,33 @@ export declare class Component extends GObject.GObject {
      * If two components have a different data_id but the same ID,
      * they will be treated as independent sets of metadata describing
      * the same component type.
-     * @param value - the unique session-specific identifier.
      */
     setDataId(value: string): void;
-    /**
-     * Sets an end-of-life date for this component.
-     * @param date - the EOL date in ISO8601 format.
-     */
+    /** Sets an end-of-life date for this component. */
     setDateEol(date: string): void;
-    /**
-     * Set long description for this component.
-     * @param value - The long description
-     * @param locale - The BCP47 locale for this value, or %NULL to use the current active one.
-     */
-    setDescription(value: string, locale?: string): void;
-    /**
-     * Set the the component's developer.
-     * @param developer - the new #AsDeveloper
-     */
+    /** Set long description for this component. */
+    setDescription(value: string, locale?: string | null): void;
+    /** Set the the component's developer. */
     setDeveloper(developer: Developer): void;
-    /**
-     * Set the AppStream identifier for this component.
-     * @param value - the unique identifier.
-     */
+    /** Set the AppStream identifier for this component. */
     setId(value: string): void;
-    /**
-     * Set keywords for this component, replacing all existing ones for the selected locale.
-     * @param newKeywords - Array of keywords
-     * @param locale - BCP47 locale of the values, or %NULL to use current locale.
-     * @param deepCopy - Set to %TRUE if the keywords array should be copied, %FALSE to set by reference.
-     */
-    setKeywords(newKeywords: GLib.PtrArray, deepCopy: boolean, locale?: string): void;
-    /**
-     * Sets the #AsComponentKind of this component.
-     * @param value - the #AsComponentKind.
-     */
+    /** Set keywords for this component, replacing all existing ones for the selected locale. */
+    setKeywords(newKeywords: string[], deepCopy: boolean, locale?: string | null): void;
+    /** Sets the #AsComponentKind of this component. */
     setKind(value: ComponentKind): void;
-    /**
-     * Sets the #AsMergeKind for this component.
-     * @param kind - the #AsMergeKind.
-     */
+    /** Sets the #AsMergeKind for this component. */
     setMergeKind(kind: MergeKind): void;
-    /**
-     * Set the license this metadata is licensed under.
-     * @param value - the metadata license.
-     */
+    /** Set the license this metadata is licensed under. */
     setMetadataLicense(value: string): void;
-    /**
-     * Set a human-readable name for this component.
-     * @param value - The name
-     * @param locale - The BCP47 locale for this value, or %NULL to use the current active one.
-     */
-    setName(value: string, locale?: string): void;
+    /** Set a human-readable name for this component. */
+    setName(value: string, locale?: string | null): void;
     /**
      * Set a variant suffix for the component name
      * (only to be displayed if components have the same name).
-     * @param value - the developer or developer team name
-     * @param locale - the BCP47 locale, or %NULL. e.g. "en-GB"
-     */
-    setNameVariantSuffix(value: string, locale?: string): void;
-    /**
-     * @param origin - the origin.
      */
+    setNameVariantSuffix(value: string, locale?: string | null): void;
     setOrigin(origin: string): void;
-    /**
-     * Set the package name that provides this component.
-     * @param pkgname - the package name
-     */
+    /** Set the package name that provides this component. */
     setPkgname(pkgname: string): void;
     /**
      * Set a list of package names this component consists of.
@@ -666,54 +444,28 @@ export declare class Component extends GObject.GObject {
     /**
      * Sets the priority of this component.
      * This method is used internally.
-     * @param priority - the given priority
      */
     setPriority(priority: number): void;
-    /**
-     * Set the component's project group.
-     * @param value - the project group.
-     */
+    /** Set the component's project group. */
     setProjectGroup(value: string): void;
-    /**
-     * Set the project license.
-     * @param value - the project license.
-     */
+    /** Set the project license. */
     setProjectLicense(value: string): void;
-    /**
-     * Set a new set of releases for this component.
-     * @param releases - the #AsReleaseList to use.
-     */
+    /** Set a new set of releases for this component. */
     setReleases(releases: ReleaseList): void;
-    /**
-     * Sets the #AsComponentScope of this component.
-     * @param scope - the #AsComponentKind.
-     */
+    /** Sets the #AsComponentScope of this component. */
     setScope(scope: ComponentScope): void;
-    /**
-     * Sets the sorting score of this component.
-     * @param score - the given sorting score
-     */
+    /** Sets the sorting score of this component. */
     setSortScore(score: number): void;
-    /**
-     * @param spkgname - the source package name.
-     */
     setSourcePkgname(spkgname: string): void;
-    /**
-     * Set a short description for this component.
-     * @param value - The summary
-     * @param locale - The BCP47 locale for this value, or %NULL to use the current active one.
-     */
-    setSummary(value: string, locale?: string): void;
+    /** Set a short description for this component. */
+    setSummary(value: string, locale?: string | null): void;
     /**
      * Reorder the screenshots to prioritize a certain environment or style, instead of using the default
      * screenshot order.
      *
      * If both "environment" and "style" are %NULL, the previous default order is restored.
-     * @param environment - a GUI environment string, e.g. "plasma" or "gnome"
-     * @param style - and environment style string, e.g. "light" or "dark"
-     * @param prioritizeStyle - if %TRUE, order screenshots of the given style earlier than ones of the given environment.
      */
-    sortScreenshots(prioritizeStyle: boolean, environment?: string, style?: string): void;
+    sortScreenshots(prioritizeStyle: boolean, environment?: string | null, style?: string | null): void;
     /**
      * Returns a string identifying this component.
      * (useful for debugging)
@@ -723,9 +475,6 @@ export declare class Component extends GObject.GObject {
      * Serialize this component into an XML string.
      * You normally do not want to use this method directly and instead use the more
      * convenient API of #AsMetadata to serialize components.
-     * @param context - an #AsContext instance.
      */
     toXmlData(context: Context): string;
-    connect(signal: "notify", handler: (self: Component, pspec: GObject.ParamSpec) => void, after?: boolean): number;
-    connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }