@girs/peas-2 2.0.0-3.0.0-beta.13

package/peas-2.d.ts

@@ -0,0 +1,1183 @@
+
+/*
+ * Type Definitions for Gjs (https://gjs.guide/)
+ *
+ * These type definitions are automatically generated, do not edit them by hand.
+ * If you found a bug fix it in `ts-for-gir` or create a bug report on https://github.com/gjsify/ts-for-gjs
+ */
+/**
+ * Peas-2
+ */
+
+import type Gio from '@girs/gio-2.0';
+import type GObject from '@girs/gobject-2.0';
+import type GLib from '@girs/glib-2.0';
+import type GModule from '@girs/gmodule-2.0';
+import type GIRepository from '@girs/girepository-2.0';
+
+export namespace Peas {
+
+/**
+ * These identify the various errors that can occur while
+ * loading a plugin.
+ */
+enum PluginInfoError {
+    /**
+     * The plugin failed to load.
+     */
+    LOADING_FAILED,
+    /**
+     * The plugin's loader was not found.
+     */
+    LOADER_NOT_FOUND,
+    /**
+     * A dependency of the plugin was not found.
+     */
+    DEP_NOT_FOUND,
+    /**
+     * A dependency of the plugin failed to load.
+     */
+    DEP_LOADING_FAILED,
+}
+/**
+ * This function is passed to [method`ExtensionSet`.foreach] and
+ * will be called for each extension in `set`.
+ * @callback 
+ * @param set A #PeasExtensionSet.
+ * @param info A #PeasPluginInfo.
+ * @param extension The extension instance.
+ * @param data Optional data passed to the function.
+ */
+interface ExtensionSetForeachFunc {
+    (set: ExtensionSet, info: PluginInfo, extension: GObject.Object, data: any | null): void
+}
+/**
+ * A #PeasFactoryFunc is a factory function which will instanciate a new
+ * extension of a given type. [ctor`GObject`.Object.newv] is such a function.
+ * 
+ * It is used with [method`ObjectModule`.register_extension_factory].
+ * @callback 
+ * @param parameters The parameters.
+ * @returns The created object.
+ */
+interface FactoryFunc {
+    (parameters: GObject.Parameter[]): GObject.Object
+}
+module Engine {
+
+    // Signal callback interfaces
+
+    /**
+     * Signal callback interface for `load-plugin`
+     */
+    interface LoadPluginSignalCallback {
+        ($obj: Engine, info: PluginInfo): void
+    }
+
+    /**
+     * Signal callback interface for `unload-plugin`
+     */
+    interface UnloadPluginSignalCallback {
+        ($obj: Engine, info: PluginInfo): void
+    }
+
+
+    // Constructor properties interface
+
+    interface ConstructorProperties extends Gio.ListModel.ConstructorProperties, GObject.Object.ConstructorProperties {
+
+        // Own constructor properties of Peas-2.Peas.Engine
+
+        /**
+         * The list of loaded plugins.
+         * 
+         * This will be modified when [method`Engine`.load_plugin] or
+         * [method`Engine`.unload_plugin] is called.
+         * 
+         * This can be used with [class`Gio`.Settings] to save the loaded plugins by
+         * binding to this property after instantiating the engine by doing:
+         * 
+         * ```c
+         *   g_settings_bind (gsettings_object,
+         *                    LOADED_PLUGINS_KEY,
+         *                    engine,
+         *                    "loaded-plugins",
+         *                    G_SETTINGS_BIND_DEFAULT);
+         * ```
+         * 
+         * Note: notify will not be called when the engine is being destroyed.
+         */
+        loaded_plugins?: string[] | null
+        /**
+         * If non-global plugin loaders should be used.
+         * 
+         * See [ctor`Engine`.new_with_nonglobal_loaders] for more information.
+         */
+        nonglobal_loaders?: boolean | null
+    }
+
+}
+
+interface Engine extends Gio.ListModel {
+
+    // Own properties of Peas-2.Peas.Engine
+
+    /**
+     * The list of loaded plugins.
+     * 
+     * This will be modified when [method`Engine`.load_plugin] or
+     * [method`Engine`.unload_plugin] is called.
+     * 
+     * This can be used with [class`Gio`.Settings] to save the loaded plugins by
+     * binding to this property after instantiating the engine by doing:
+     * 
+     * ```c
+     *   g_settings_bind (gsettings_object,
+     *                    LOADED_PLUGINS_KEY,
+     *                    engine,
+     *                    "loaded-plugins",
+     *                    G_SETTINGS_BIND_DEFAULT);
+     * ```
+     * 
+     * Note: notify will not be called when the engine is being destroyed.
+     */
+    loaded_plugins: string[]
+    /**
+     * If non-global plugin loaders should be used.
+     * 
+     * See [ctor`Engine`.new_with_nonglobal_loaders] for more information.
+     */
+    readonly nonglobal_loaders: boolean
+
+    // Owm methods of Peas-2.Peas.Engine
+
+    /**
+     * Appends a search path to the list of paths where to look for plugins.
+     * 
+     * A so-called "search path" actually consists of both a
+     * module directory (where the shared libraries or language modules
+     * lie) and a data directory (where the plugin data is).
+     * 
+     * The plugin will be able to use a correct data dir depending on
+     * where it is installed, hence allowing to keep the plugin agnostic
+     * when it comes to installation location: the same plugin can be
+     * installed either in the system path or in the user's home directory,
+     * without taking other special care than using
+     * [method`PluginInfo`.get_data_dir] when looking for its data files.
+     * 
+     * If `data_dir` is %NULL, then it is set to the same value as
+     * `module_dir`.
+     * @param module_dir the plugin module directory.
+     * @param data_dir the plugin data directory.
+     */
+    add_search_path(module_dir: string | null, data_dir: string | null): void
+    /**
+     * If the plugin identified by `info` implements the `extension_type,`
+     * then this function will return a new instance of this implementation.
+     * 
+     * See [method`Engine`.create_extension] for more information.
+     * @param info A loaded #PeasPluginInfo.
+     * @param extension_type The implemented extension #GType.
+     * @param prop_names an array of property names.
+     * @param prop_values an array of property values.
+     * @returns a new instance of #GObject which meets the   prerequisites of @extension_type, or %NULL.
+     */
+    create_extension(info: PluginInfo, extension_type: GObject.GType, prop_names: string[], prop_values: any[]): GObject.Object
+    /**
+     * Returns the list of the names of all the loaded plugins.
+     * 
+     * If there is no plugin currently loaded, it will return an array containing a
+     * single %NULL element.
+     * 
+     * Please note that the returned array is a newly allocated one: you will need
+     * to free it using [func`GLib`.strfreev].
+     * @returns A newly-allocated   %NULL-terminated array of strings.
+     */
+    dup_loaded_plugins(): string[]
+    /**
+     * Enable a loader, enables a loader for plugins.
+     * 
+     * The C plugin loader is always enabled. The other plugin
+     * loaders are: lua5.1, python and python3.
+     * 
+     * For instance, the following code will enable Python 2 plugins
+     * to be loaded:
+     * 
+     * ```c
+     * peas_engine_enable_loader (engine, "python");
+     * ```
+     * 
+     * Note: plugin loaders used to be shared across `PeasEngine`s so enabling
+     *   a loader on one #PeasEngine would enable it on all #PeasEngines.
+     *   This behavior has been kept to avoid breaking applications,
+     *   however a warning has been added to help applications transition.
+     * @param loader_name The name of the loader to enable.
+     */
+    enable_loader(loader_name: string | null): void
+    /**
+     * Triggers garbage collection on all the loaders currently owned by the
+     * #PeasEngine.
+     * 
+     * This can be used to force the loaders to destroy
+     * managed objects that still hold references to objects that are about to
+     * disappear.
+     */
+    garbage_collect(): void
+    /**
+     * Gets the [class`PluginInfo]` corresponding with `plugin_name,`
+     * or %NULL if `plugin_name` was not found.
+     * @param plugin_name A plugin name.
+     * @returns the #PeasPluginInfo corresponding with   a given plugin module name.
+     */
+    get_plugin_info(plugin_name: string | null): PluginInfo
+    /**
+     * Loads the plugin corresponding to `info` if it's not currently loaded.
+     * 
+     * Emits the [signal`Engine:`:load-plugin] signal; loading the plugin
+     * actually occurs in the default signal handler.
+     * @param info A #PeasPluginInfo.
+     * @returns whether the plugin has been successfully loaded.
+     */
+    load_plugin(info: PluginInfo): boolean
+    /**
+     * Returns if `info` provides an extension for `extension_type`.
+     * 
+     * If the `info` is not loaded than %FALSE will always be returned.
+     * @param info A #PeasPluginInfo.
+     * @param extension_type The extension #GType.
+     * @returns if @info provides an extension for @extension_type.
+     */
+    provides_extension(info: PluginInfo, extension_type: GObject.GType): boolean
+    /**
+     * Rescan all the registered directories to find new or updated plugins.
+     * 
+     * Calling this function will make the newly installed plugin infos
+     * be loaded by the engine, so the new plugins can be used without
+     * restarting the application.
+     */
+    rescan_plugins(): void
+    /**
+     * Sets the list of loaded plugins for `engine`.
+     * 
+     * When this function is called, the #PeasEngine will load all the plugins whose
+     * names are in `plugin_names,` and ensures all other active plugins are
+     * unloaded.
+     * 
+     * If `plugin_names` is %NULL, all plugins will be unloaded.
+     * @param plugin_names A %NULL-terminated  array of plugin names, or %NULL.
+     */
+    set_loaded_plugins(plugin_names: string[] | null): void
+    /**
+     * Unloads the plugin corresponding to `info`.
+     * 
+     * Emits the [signal`Engine:`:unload-plugin] signal; unloading the plugin
+     * actually occurs in the default signal handler.
+     * @param info A #PeasPluginInfo.
+     * @returns whether the plugin has been successfully unloaded.
+     */
+    unload_plugin(info: PluginInfo): boolean
+
+    // Own signals of Peas-2.Peas.Engine
+
+    connect(sigName: "load-plugin", callback: Engine.LoadPluginSignalCallback): number
+    connect_after(sigName: "load-plugin", callback: Engine.LoadPluginSignalCallback): number
+    emit(sigName: "load-plugin", info: PluginInfo, ...args: any[]): void
+    connect(sigName: "unload-plugin", callback: Engine.UnloadPluginSignalCallback): number
+    connect_after(sigName: "unload-plugin", callback: Engine.UnloadPluginSignalCallback): number
+    emit(sigName: "unload-plugin", info: PluginInfo, ...args: any[]): void
+
+    // Class property signals of Peas-2.Peas.Engine
+
+    connect(sigName: "notify::loaded-plugins", callback: (($obj: Engine, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::loaded-plugins", callback: (($obj: Engine, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::loaded-plugins", ...args: any[]): void
+    connect(sigName: "notify::nonglobal-loaders", callback: (($obj: Engine, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::nonglobal-loaders", callback: (($obj: Engine, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::nonglobal-loaders", ...args: any[]): void
+    connect(sigName: string, callback: (...args: any[]) => void): number
+    connect_after(sigName: string, callback: (...args: any[]) => void): number
+    emit(sigName: string, ...args: any[]): void
+    disconnect(id: number): void
+}
+
+/**
+ * The #PeasEngine is the object which manages the plugins.
+ * 
+ * Its role is twofold:
+ * 
+ * - it will fetch all the information about the available plugins
+ *   from all the registered plugin directories;
+ * - it will provide you an API to load, control and unload your
+ *   plugins and their extensions from within your application.
+ * @class 
+ */
+class Engine extends GObject.Object {
+
+    // Own properties of Peas-2.Peas.Engine
+
+    static name: string
+    static $gtype: GObject.GType<Engine>
+
+    // Constructors of Peas-2.Peas.Engine
+
+    constructor(config?: Engine.ConstructorProperties) 
+    /**
+     * Return a new instance of #PeasEngine.
+     * 
+     * If no default #PeasEngine has been instantiated yet,
+     * the first call of this function will set the default
+     * engine as the new instance of #PeasEngine.
+     * @constructor 
+     * @returns a new instance of #PeasEngine.
+     */
+    constructor() 
+    /**
+     * Return a new instance of #PeasEngine.
+     * 
+     * If no default #PeasEngine has been instantiated yet,
+     * the first call of this function will set the default
+     * engine as the new instance of #PeasEngine.
+     * @constructor 
+     * @returns a new instance of #PeasEngine.
+     */
+    static new(): Engine
+    /**
+     * Return a new instance of #PeasEngine which will use non-global
+     * plugin loaders instead of the default global ones.
+     * 
+     * This allows multiple threads to each have a #PeasEngine and be used without
+     * internal locking.
+     * 
+     * Note: due to CPython's GIL the python and python3
+     *   plugin loaders are always global.
+     * @constructor 
+     * @returns a new instance of #PeasEngine that uses non-global loaders.
+     */
+    static new_with_nonglobal_loaders(): Engine
+    _init(config?: Engine.ConstructorProperties): void
+    /**
+     * Return the existing instance of #PeasEngine or a subclass of it.
+     * 
+     * If no #PeasEngine subclass has been instantiated yet, the first call
+     * of this function will return a new instance of #PeasEngine.
+     * 
+     * Note: this function should never be used when multiple threads are
+     *   using libpeas API as it is not thread-safe.
+     * @returns the existing instance of #PeasEngine.
+     */
+    static get_default(): Engine
+}
+
+module ExtensionBase {
+
+    // Constructor properties interface
+
+    interface ConstructorProperties extends GObject.Object.ConstructorProperties {
+
+        // Own constructor properties of Peas-2.Peas.ExtensionBase
+
+        /**
+         * The [class`PluginInfo]` related to the current plugin.
+         */
+        plugin_info?: PluginInfo | null
+    }
+
+}
+
+interface ExtensionBase {
+
+    // Own properties of Peas-2.Peas.ExtensionBase
+
+    /**
+     * The The full path of the directory where the plugin
+     * should look for its data files.
+     * 
+     * Note: This is the same path as that returned by
+     * [method`PluginInfo`.get_data_dir].
+     */
+    readonly data_dir: string | null
+    /**
+     * The [class`PluginInfo]` related to the current plugin.
+     */
+    readonly plugin_info: PluginInfo
+
+    // Own fields of Peas-2.Peas.ExtensionBase
+
+    parent_instance: GObject.Object
+
+    // Owm methods of Peas-2.Peas.ExtensionBase
+
+    /**
+     * Get the path of the directory where the plugin should look for
+     * its data files.
+     * @returns A newly allocated string with the path of the   directory where the plugin should look for its data files
+     */
+    get_data_dir(): string | null
+    /**
+     * Get information relative to `extbase`.
+     * @returns the [class@PluginInfo] relative   to the #PeasExtensionBase.
+     */
+    get_plugin_info(): PluginInfo
+
+    // Class property signals of Peas-2.Peas.ExtensionBase
+
+    connect(sigName: "notify::data-dir", callback: (($obj: ExtensionBase, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::data-dir", callback: (($obj: ExtensionBase, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::data-dir", ...args: any[]): void
+    connect(sigName: "notify::plugin-info", callback: (($obj: ExtensionBase, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::plugin-info", callback: (($obj: ExtensionBase, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::plugin-info", ...args: any[]): void
+    connect(sigName: string, callback: (...args: any[]) => void): number
+    connect_after(sigName: string, callback: (...args: any[]) => void): number
+    emit(sigName: string, ...args: any[]): void
+    disconnect(id: number): void
+}
+
+/**
+ * Base class for C extensions.
+ * 
+ * #PeasExtensionBase can optionally be used as a base class for the extensions
+ * of your plugin. By inheriting from it, you will make your extension able to
+ * access the related [class`PluginInfo]`, and especially the location where all
+ * the data of your plugin lives.
+ * 
+ * Non-C extensions will usually not inherit from this class: Python
+ * plugins automatically get a "plugin_info" attribute that serves
+ * the same purpose.
+ * @class 
+ */
+class ExtensionBase extends GObject.Object {
+
+    // Own properties of Peas-2.Peas.ExtensionBase
+
+    static name: string
+    static $gtype: GObject.GType<ExtensionBase>
+
+    // Constructors of Peas-2.Peas.ExtensionBase
+
+    constructor(config?: ExtensionBase.ConstructorProperties) 
+    _init(config?: ExtensionBase.ConstructorProperties): void
+}
+
+module ExtensionSet {
+
+    // Signal callback interfaces
+
+    /**
+     * Signal callback interface for `extension-added`
+     */
+    interface ExtensionAddedSignalCallback {
+        ($obj: ExtensionSet, info: PluginInfo, extension: GObject.Object): void
+    }
+
+    /**
+     * Signal callback interface for `extension-removed`
+     */
+    interface ExtensionRemovedSignalCallback {
+        ($obj: ExtensionSet, info: PluginInfo, extension: GObject.Object): void
+    }
+
+
+    // Constructor properties interface
+
+    interface ConstructorProperties extends Gio.ListModel.ConstructorProperties, GObject.Object.ConstructorProperties {
+
+        // Own constructor properties of Peas-2.Peas.ExtensionSet
+
+        construct_properties?: any | null
+        engine?: Engine | null
+        extension_type?: GObject.GType | null
+    }
+
+}
+
+interface ExtensionSet extends Gio.ListModel {
+
+    // Own properties of Peas-2.Peas.ExtensionSet
+
+    readonly construct_properties: any
+    readonly engine: Engine
+    readonly extension_type: GObject.GType
+
+    // Owm methods of Peas-2.Peas.ExtensionSet
+
+    /**
+     * Calls `func` for each [class`GObject`.Object].
+     * @param func A function call for each extension.
+     */
+    foreach(func: ExtensionSetForeachFunc): void
+    /**
+     * Returns the [class`GObject`.Object] object corresponding to `info`.
+     * 
+     * If the plugin doesn't provide such an extension, it returns %NULL.
+     * @param info a #PeasPluginInfo
+     * @returns a reference to a #GObject
+     */
+    get_extension(info: PluginInfo): GObject.Object | null
+
+    // Own signals of Peas-2.Peas.ExtensionSet
+
+    connect(sigName: "extension-added", callback: ExtensionSet.ExtensionAddedSignalCallback): number
+    connect_after(sigName: "extension-added", callback: ExtensionSet.ExtensionAddedSignalCallback): number
+    emit(sigName: "extension-added", info: PluginInfo, extension: GObject.Object, ...args: any[]): void
+    connect(sigName: "extension-removed", callback: ExtensionSet.ExtensionRemovedSignalCallback): number
+    connect_after(sigName: "extension-removed", callback: ExtensionSet.ExtensionRemovedSignalCallback): number
+    emit(sigName: "extension-removed", info: PluginInfo, extension: GObject.Object, ...args: any[]): void
+
+    // Class property signals of Peas-2.Peas.ExtensionSet
+
+    connect(sigName: "notify::construct-properties", callback: (($obj: ExtensionSet, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::construct-properties", callback: (($obj: ExtensionSet, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::construct-properties", ...args: any[]): void
+    connect(sigName: "notify::engine", callback: (($obj: ExtensionSet, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::engine", callback: (($obj: ExtensionSet, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::engine", ...args: any[]): void
+    connect(sigName: "notify::extension-type", callback: (($obj: ExtensionSet, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::extension-type", callback: (($obj: ExtensionSet, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::extension-type", ...args: any[]): void
+    connect(sigName: string, callback: (...args: any[]) => void): number
+    connect_after(sigName: string, callback: (...args: any[]) => void): number
+    emit(sigName: string, ...args: any[]): void
+    disconnect(id: number): void
+}
+
+/**
+ * Proxy for a set of extensions of the same type.
+ * 
+ * A #PeasExtensionSet is an object which proxies method calls to a set
+ * of actual extensions.  The application writer will use these objects
+ * in order to call methods on several instances of an actual extension
+ * exported by all the currently loaded plugins.
+ * 
+ * #PeasExtensionSet will automatically track loading and unloading of
+ * the plugins, and signal appearance and disappearance of new
+ * extension instances.  You should connect to those signals if you
+ * wish to call specific methods on loading or unloading time.
+ * 
+ * Here is the code for a typical setup of #PeasExtensionSet with
+ * ExampleActivatable as the watched extension point, and GtkWindow
+ * instances as the target objects:
+ * 
+ * ```c
+ * static void
+ * on_extension_added (PeasExtensionSet   *set,
+ *                     PeasPluginInfo     *info,
+ *                     ExampleActivatable *activatable)
+ * {
+ *   example_activatable_activate (activatable);
+ * }
+ * 
+ * static void
+ * on_extension_removed (PeasExtensionSet   *set,
+ *                       PeasPluginInfo     *info,
+ *                       ExampleActivatable *activatable)
+ * {
+ *   example_activatable_deactivate (activatable);
+ * }
+ * 
+ * PeasExtensionSet *
+ * setup_extension_set (PeasEngine *engine,
+ *                      GtkWindow  *window)
+ * {
+ *   PeasExtensionSet *set;
+ * 
+ *   set = peas_extension_set_new (engine, EXAMPLE_TYPE_ACTIVATABLE,
+ *                                 "object", window, NULL);
+ *   peas_extension_set_foreach (set,
+ *                               (PeasExtensionSetForeachFunc) on_extension_added,
+ *                               NULL);
+ *   g_signal_connect (set, "extension-added",
+ *                     G_CALLBACK (on_extension_added), NULL);
+ *   g_signal_connect (set, "extension-removed",
+ *                     G_CALLBACK (on_extension_removed), NULL);
+ *   return set;
+ * }
+ * ```
+ * @class 
+ */
+class ExtensionSet extends GObject.Object {
+
+    // Own properties of Peas-2.Peas.ExtensionSet
+
+    static name: string
+    static $gtype: GObject.GType<ExtensionSet>
+
+    // Constructors of Peas-2.Peas.ExtensionSet
+
+    constructor(config?: ExtensionSet.ConstructorProperties) 
+    /**
+     * Create a new #PeasExtensionSet for the `exten_type` extension type.
+     * 
+     * If `engine` is %NULL, then the default engine will be used.
+     * 
+     * See [ctor`ExtensionSet`.new] for more information.
+     * @constructor 
+     * @param engine A #PeasEngine, or %NULL.
+     * @param exten_type the extension #GType.
+     * @param prop_names an array of property names.
+     * @param prop_values an array of property values.
+     * @returns a new instance of #PeasExtensionSet.
+     */
+    constructor(engine: Engine | null, exten_type: GObject.GType, prop_names: string[], prop_values: any[]) 
+    /**
+     * Create a new #PeasExtensionSet for the `exten_type` extension type.
+     * 
+     * If `engine` is %NULL, then the default engine will be used.
+     * 
+     * See [ctor`ExtensionSet`.new] for more information.
+     * @constructor 
+     * @param engine A #PeasEngine, or %NULL.
+     * @param exten_type the extension #GType.
+     * @param prop_names an array of property names.
+     * @param prop_values an array of property values.
+     * @returns a new instance of #PeasExtensionSet.
+     */
+    static new(engine: Engine | null, exten_type: GObject.GType, prop_names: string[], prop_values: any[]): ExtensionSet
+    _init(config?: ExtensionSet.ConstructorProperties): void
+}
+
+module ObjectModule {
+
+    // Constructor properties interface
+
+    interface ConstructorProperties extends GObject.TypePlugin.ConstructorProperties, GObject.TypeModule.ConstructorProperties {
+
+        // Own constructor properties of Peas-2.Peas.ObjectModule
+
+        /**
+         * Whether the module is loaded with local linkage, i.e. #G_MODULE_BIND_LOCAL.
+         */
+        local_linkage?: boolean | null
+        module_name?: string | null
+        path?: string | null
+        resident?: boolean | null
+        symbol?: string | null
+    }
+
+}
+
+interface ObjectModule extends GObject.TypePlugin {
+
+    // Own properties of Peas-2.Peas.ObjectModule
+
+    /**
+     * Whether the module is loaded with local linkage, i.e. #G_MODULE_BIND_LOCAL.
+     */
+    readonly local_linkage: boolean
+    readonly module_name: string | null
+    readonly path: string | null
+    readonly resident: boolean
+    readonly symbol: string | null
+
+    // Own fields of Peas-2.Peas.ObjectModule
+
+    parent_instance: GObject.TypeModule & GObject.Object
+
+    // Owm methods of Peas-2.Peas.ObjectModule
+
+    /**
+     * Register an implementation for an extension type through a factory
+     * function `factory_func` which will instantiate the extension when
+     * requested.
+     * 
+     * This method is primarily meant to be used by native bindings (like gtkmm),
+     * creating native types which cannot be instantiated correctly using
+     * [ctor`GObject`.Object.new].  For other uses, you will usually prefer relying on
+     * peas_object_module_register_extension_type().
+     * @param exten_type The #GType of the extension you implement.
+     * @param factory_func The #PeasFactoryFunc that will create the `exten_type`   instance when requested.
+     */
+    register_extension_factory(exten_type: GObject.GType, factory_func: FactoryFunc): void
+    /**
+     * Register `impl_type` as an extension which implements `extension_type`.
+     * @param exten_type The #GType of the extension you implement.
+     * @param impl_type The #GType of your implementation of `exten_type`.
+     */
+    register_extension_type(exten_type: GObject.GType, impl_type: GObject.GType): void
+
+    // Conflicting methods
+
+    /**
+     * Calls the `use_plugin` function from the #GTypePluginClass of
+     * `plugin`.  There should be no need to use this function outside of
+     * the GObject type system itself.
+     */
+    use(): void
+    /**
+     * Increases the use count of a #GTypeModule by one. If the
+     * use count was zero before, the plugin will be loaded.
+     * If loading the plugin fails, the use count is reset to
+     * its prior value.
+     * @returns %FALSE if the plugin needed to be loaded and  loading the plugin failed.
+     */
+    use(): boolean
+
+    // Overloads of use
+
+    /**
+     * Calls the `use_plugin` function from the #GTypePluginClass of
+     * `plugin`.  There should be no need to use this function outside of
+     * the GObject type system itself.
+     */
+    use(): void
+
+    // Class property signals of Peas-2.Peas.ObjectModule
+
+    connect(sigName: "notify::local-linkage", callback: (($obj: ObjectModule, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::local-linkage", callback: (($obj: ObjectModule, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::local-linkage", ...args: any[]): void
+    connect(sigName: "notify::module-name", callback: (($obj: ObjectModule, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::module-name", callback: (($obj: ObjectModule, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::module-name", ...args: any[]): void
+    connect(sigName: "notify::path", callback: (($obj: ObjectModule, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::path", callback: (($obj: ObjectModule, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::path", ...args: any[]): void
+    connect(sigName: "notify::resident", callback: (($obj: ObjectModule, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::resident", callback: (($obj: ObjectModule, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::resident", ...args: any[]): void
+    connect(sigName: "notify::symbol", callback: (($obj: ObjectModule, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::symbol", callback: (($obj: ObjectModule, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::symbol", ...args: any[]): void
+    connect(sigName: string, callback: (...args: any[]) => void): number
+    connect_after(sigName: string, callback: (...args: any[]) => void): number
+    emit(sigName: string, ...args: any[]): void
+    disconnect(id: number): void
+}
+
+/**
+ * Type module which allows extension registration.
+ * 
+ * #PeasObjectModule is a subclass of [class`GObject`.TypeModule] which allows
+ * registration of extensions. It will be used by C extensions implementors to
+ * register extension implementations from within the peas_register_types module
+ * function.
+ * @class 
+ */
+class ObjectModule extends GObject.TypeModule {
+
+    // Own properties of Peas-2.Peas.ObjectModule
+
+    static name: string
+    static $gtype: GObject.GType<ObjectModule>
+
+    // Constructors of Peas-2.Peas.ObjectModule
+
+    constructor(config?: ObjectModule.ConstructorProperties) 
+    _init(config?: ObjectModule.ConstructorProperties): void
+}
+
+module PluginInfo {
+
+    // Constructor properties interface
+
+    interface ConstructorProperties extends GObject.Object.ConstructorProperties {
+    }
+
+}
+
+interface PluginInfo {
+
+    // Own properties of Peas-2.Peas.PluginInfo
+
+    readonly authors: string[]
+    readonly builtin: boolean
+    readonly copyright: string | null
+    readonly dependencies: string[]
+    readonly description: string | null
+    readonly help_uri: string | null
+    readonly hidden: boolean
+    readonly icon_name: string | null
+    readonly loaded: boolean
+    readonly module_dir: string | null
+    readonly module_name: string | null
+    readonly name: string | null
+    readonly version: string | null
+    readonly website: string | null
+
+    // Owm methods of Peas-2.Peas.PluginInfo
+
+    /**
+     * Gets a %NULL-terminated array of strings with the authors of the plugin.
+     * 
+     * The relevant key in the plugin info file is "Authors".
+     * @returns the plugin's author list.
+     */
+    get_authors(): string[]
+    /**
+     * Gets the copyright of the plugin.
+     * 
+     * The relevant key in the plugin info file is "Copyright".
+     * @returns the plugin's copyright information.
+     */
+    get_copyright(): string | null
+    /**
+     * Gets the data dir of the plugin.
+     * 
+     * The module data directory is the directory where a plugin should find its
+     * runtime data. This is not a value read from the [struct`GLib`.KeyFile], but
+     * rather a value provided by the [class`Engine]`, depending on where the plugin
+     * file was found.
+     * @returns the plugin's data dir.
+     */
+    get_data_dir(): string | null
+    /**
+     * Gets the dependencies of the plugin.
+     * 
+     * The [class`Engine]` will always ensure that the dependencies of a plugin are
+     * loaded when the said plugin is loaded. It means that dependencies are
+     * loaded before the plugin, and unloaded after it. Circular dependencies of
+     * plugins lead to undefined loading order.
+     * 
+     * The relevant key in the plugin info file is "Depends".
+     * @returns the plugin's dependencies.
+     */
+    get_dependencies(): string[]
+    /**
+     * Gets the description of the plugin.
+     * 
+     * The description of the plugin should be a string presenting the purpose of
+     * the plugin. It will typically be presented in a plugin's about box.
+     * 
+     * The relevant key in the plugin info file is "Description".
+     * @returns the plugin's description.
+     */
+    get_description(): string | null
+    /**
+     * Gets external data specified for the plugin.
+     * 
+     * External data is specified in the plugin info file prefixed with X-. For
+     * example, if a key/value pair `X-Peas=1` is specified in the key file, you
+     * can use "Peas" for `key` to retrieve the value "1".
+     * 
+     * Note: that you can omit the X- prefix when retrieving the value,
+     * but not when specifying the value in the file.
+     * @param key The key to lookup.
+     * @returns the external data, or %NULL if the external data could not be found.
+     */
+    get_external_data(key: string | null): string | null
+    /**
+     * Gets the help URI of the plugin.
+     * 
+     * The Help URI of a plugin will typically be presented by the plugin manager
+     * as a "Help" button linking to the URI. It can either be a HTTP URL on some
+     * website or a ghelp: URI if a Gnome help page is available for the plugin.
+     * 
+     * The relevant key in the plugin info file is "Help". Other platform-specific
+     * keys exist for platform-specific help files. Those are "Help-GNOME",
+     * "Help-Windows" and "Help-MacOS-X".
+     * @returns the plugin's help URI.
+     */
+    get_help_uri(): string | null
+    /**
+     * Gets the icon name of the plugin.
+     * 
+     * The icon of the plugin will be presented in the plugin manager UI. If no
+     * icon is specified, the default green puzzle icon will be used.
+     * 
+     * The relevant key in the plugin info file is "Icon".
+     * @returns the plugin's icon name.
+     */
+    get_icon_name(): string | null
+    /**
+     * Gets the module directory.
+     * 
+     * The module directory is the directory where the plugin file was found. This
+     * is not a value from the [struct`GLib`.KeyFile], but rather a value provided by the
+     * [class`Engine]`.
+     * @returns the module directory.
+     */
+    get_module_dir(): string | null
+    /**
+     * Gets the module name.
+     * 
+     * The module name will be used to find the actual plugin. The way this value
+     * will be used depends on the loader (i.e. on the language) of the plugin.
+     * This value is also used to uniquely identify a particular plugin.
+     * 
+     * The relevant key in the plugin info file is "Module".
+     * @returns the module name.
+     */
+    get_module_name(): string | null
+    /**
+     * Gets the name of the plugin.
+     * 
+     * The name of a plugin should be a nice short string to be presented in UIs.
+     * 
+     * The relevant key in the plugin info file is "Name".
+     * @returns the plugin's name.
+     */
+    get_name(): string | null
+    /**
+     * Creates a new #GResource for the given `filename`
+     * located in the module directory. If `filename` is %NULL
+     * then "${module_name}.gresource" will be loaded.
+     * @param filename The filename of the resource, or %NULL.
+     * @returns a new #GResource, or %NULL.
+     */
+    get_resource(filename: string | null): Gio.Resource
+    /**
+     * Creates a new [class`Gio`.Settings] for the given `schema_id` and if
+     * gschemas.compiled is not in the module directory an attempt
+     * will be made to create it.
+     * @param schema_id The schema id.
+     * @returns a new #GSettings.
+     */
+    get_settings(schema_id: string | null): Gio.Settings | null
+    /**
+     * Gets the version of the plugin.
+     * 
+     * The relevant key in the plugin info file is "Version".
+     * @returns the plugin's version.
+     */
+    get_version(): string | null
+    /**
+     * Gets the website of the plugin.
+     * 
+     * The relevant key in the plugin info file is "Website".
+     * @returns the plugin's associated website.
+     */
+    get_website(): string | null
+    /**
+     * Check if the plugin depends on another plugin.
+     * @param module_name The name of the plugin to check.
+     * @returns whether the plugin depends on the plugin @module_name.
+     */
+    has_dependency(module_name: string | null): boolean
+    /**
+     * Check if the plugin is available.
+     * 
+     * A plugin is marked as not available when there is no loader available to
+     * load it, or when there has been an error when trying to load it previously.
+     * If not available then `error` will be set.
+     * @returns %TRUE if the plugin is available.
+     */
+    is_available(): boolean
+    /**
+     * Check if the plugin is a builtin plugin.
+     * 
+     * A builtin plugin is a plugin which cannot be enabled or disabled by the user
+     * through a plugin manager (like
+     * [PeasGtkPluginManager](https://gnome.pages.gitlab.gnome.org/libpeas/libpeas-gtk-1.0/class.PluginManager.html)).
+     * Loading or unloading such plugins is the responsibility of the application
+     * alone. Most applications will usually load those plugins immediately after
+     * the initialization of the #PeasEngine.
+     * 
+     * The relevant key in the plugin info file is "Builtin".
+     * @returns %TRUE if the plugin is a builtin plugin, %FALSE   if not.
+     */
+    is_builtin(): boolean
+    /**
+     * Check if the plugin is a hidden plugin.
+     * 
+     * A hidden plugin is a plugin which cannot be seen by a
+     * user through a plugin manager (like
+     * [PeasGtkPluginManager](https://gnome.pages.gitlab.gnome.org/libpeas/libpeas-gtk-1.0/class.PluginManager.html)).
+     * Loading and
+     * unloading such plugins is the responsibility of the application alone or
+     * through plugins that depend on them.
+     * 
+     * The relevant key in the plugin info file is "Hidden".
+     * @returns %TRUE if the plugin is a hidden plugin, %FALSE   if not.
+     */
+    is_hidden(): boolean
+    /**
+     * Check if the plugin is loaded.
+     * @returns %TRUE if the plugin is loaded.
+     */
+    is_loaded(): boolean
+    /**
+     * Loads the resource using peas_plugin_info_get_resource() and
+     * registers it. The resource's lifetime will be automatically
+     * handled by `info`.
+     * 
+     * See peas_plugin_info_get_resource() for more information.
+     * @param filename The filename of the resource, or %NULL.
+     */
+    load_resource(filename: string | null): void
+
+    // Class property signals of Peas-2.Peas.PluginInfo
+
+    connect(sigName: "notify::authors", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::authors", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::authors", ...args: any[]): void
+    connect(sigName: "notify::builtin", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::builtin", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::builtin", ...args: any[]): void
+    connect(sigName: "notify::copyright", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::copyright", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::copyright", ...args: any[]): void
+    connect(sigName: "notify::dependencies", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::dependencies", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::dependencies", ...args: any[]): void
+    connect(sigName: "notify::description", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::description", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::description", ...args: any[]): void
+    connect(sigName: "notify::help-uri", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::help-uri", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::help-uri", ...args: any[]): void
+    connect(sigName: "notify::hidden", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::hidden", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::hidden", ...args: any[]): void
+    connect(sigName: "notify::icon-name", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::icon-name", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::icon-name", ...args: any[]): void
+    connect(sigName: "notify::loaded", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::loaded", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::loaded", ...args: any[]): void
+    connect(sigName: "notify::module-dir", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::module-dir", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::module-dir", ...args: any[]): void
+    connect(sigName: "notify::module-name", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::module-name", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::module-name", ...args: any[]): void
+    connect(sigName: "notify::name", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::name", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::name", ...args: any[]): void
+    connect(sigName: "notify::version", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::version", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::version", ...args: any[]): void
+    connect(sigName: "notify::website", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    connect_after(sigName: "notify::website", callback: (($obj: PluginInfo, pspec: GObject.ParamSpec) => void)): number
+    emit(sigName: "notify::website", ...args: any[]): void
+    connect(sigName: string, callback: (...args: any[]) => void): number
+    connect_after(sigName: string, callback: (...args: any[]) => void): number
+    emit(sigName: string, ...args: any[]): void
+    disconnect(id: number): void
+}
+
+/**
+ * A #PeasPluginInfo contains all the information available about a plugin.
+ * 
+ * All this information comes from the related plugin info file, whose file
+ * extension is ".plugin". Here is an example of such a plugin file, in the
+ * [struct`GLib`.KeyFile] format:
+ * 
+ * ```toml
+ * [Plugin]
+ * Module=helloworld
+ * Depends=foo;bar;baz
+ * Loader=python
+ * Name=Hello World
+ * Description=Displays "Hello World"
+ * Authors=Steve Frécinaux &lt;code`istique`.net&gt;
+ * Copyright=Copyright © 2009-10 Steve Frécinaux
+ * Website=https://wiki.gnome.org/Projects/Libpeas
+ * Help=http://library.gnome.org/devel/libpeas/stable/
+ * Hidden=false
+ * ```
+ * @class 
+ */
+class PluginInfo extends GObject.Object {
+
+    // Own properties of Peas-2.Peas.PluginInfo
+
+    static name: string
+    static $gtype: GObject.GType<PluginInfo>
+
+    // Constructors of Peas-2.Peas.PluginInfo
+
+    constructor(config?: PluginInfo.ConstructorProperties) 
+    _init(config?: PluginInfo.ConstructorProperties): void
+    static error_quark(): GLib.Quark
+}
+
+interface EngineClass {
+
+    // Own fields of Peas-2.Peas.EngineClass
+
+    parent_class: GObject.ObjectClass
+}
+
+abstract class EngineClass {
+
+    // Own properties of Peas-2.Peas.EngineClass
+
+    static name: string
+}
+
+interface ExtensionBaseClass {
+
+    // Own fields of Peas-2.Peas.ExtensionBaseClass
+
+    /**
+     * The parent class.
+     * @field 
+     */
+    parent_class: GObject.ObjectClass
+}
+
+/**
+ * The class structure of #PeasExtensionBase.
+ * @record 
+ */
+abstract class ExtensionBaseClass {
+
+    // Own properties of Peas-2.Peas.ExtensionBaseClass
+
+    static name: string
+}
+
+interface ExtensionSetClass {
+
+    // Own fields of Peas-2.Peas.ExtensionSetClass
+
+    parent_class: GObject.ObjectClass
+}
+
+abstract class ExtensionSetClass {
+
+    // Own properties of Peas-2.Peas.ExtensionSetClass
+
+    static name: string
+}
+
+interface ObjectModuleClass {
+
+    // Own fields of Peas-2.Peas.ObjectModuleClass
+
+    /**
+     * The parent class.
+     * @field 
+     */
+    parent_class: GObject.TypeModuleClass
+}
+
+/**
+ * The class structure for #PeasObjectModule.
+ * @record 
+ */
+abstract class ObjectModuleClass {
+
+    // Own properties of Peas-2.Peas.ObjectModuleClass
+
+    static name: string
+}
+
+interface PluginInfoClass {
+
+    // Own fields of Peas-2.Peas.PluginInfoClass
+
+    parent_class: GObject.ObjectClass
+}
+
+abstract class PluginInfoClass {
+
+    // Own properties of Peas-2.Peas.PluginInfoClass
+
+    static name: string
+}
+
+/**
+ * Name of the imported GIR library
+ * @see https://gitlab.gnome.org/GNOME/gjs/-/blob/master/gi/ns.cpp#L188
+ */
+const __name__: string
+/**
+ * Version of the imported GIR library
+ * @see https://gitlab.gnome.org/GNOME/gjs/-/blob/master/gi/ns.cpp#L189
+ */
+const __version__: string
+}
+
+export default Peas;
+// END