@girs/gpaste-2 4.4.0 → 4.6.0

package/README.md

@@ -4,82 +4,77 @@
 ![version](https://img.shields.io/npm/v/@girs/gpaste-2)
 ![downloads/week](https://img.shields.io/npm/dw/@girs/gpaste-2)
 
+GJS TypeScript type definitions for GPaste-2 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.6.0.
 
-GJS TypeScript type definitions for GPaste-2 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.4.0.
+This package contains type declarations only. It ships no runtime code, so it adds
+nothing to your program and works with any bundler or none at all.
 
 ## Install
 
-Install the type definitions with npm:
 ```bash
 npm install @girs/gpaste-2
 ```
 
-## Usage
+Any package manager works. The package has no dependencies beyond other `@girs/*`
+type packages.
+
+## What it exports
+
+| Import | What you get |
+|---|---|
+| `@girs/gpaste-2` | the namespace as a default export, plus the ambient and global declarations |
+| `@girs/gpaste-2/ambient` | only the `gi://` module declarations |
+| `@girs/gpaste-2/import` | only the `imports.gi` declarations |
+| `@girs/gpaste-2/gpaste-2` | the namespace, without the side-effecting declarations |
+
+## Three ways to import
+
+Which one you use depends on how you write imports elsewhere, not on your toolchain.
+
+### As a module
 
-Import it like any other module:
 ```ts
 import GPaste from '@girs/gpaste-2';
 ```
 
-### Ambient Modules
+### As `gi://`
 
-[Ambient modules](https://github.com/gjsify/ts-for-gir/tree/main/packages/cli#ambient-modules) let you write the same import you would in plain JavaScript.
-For this you need to include `@girs/gpaste-2` or `@girs/gpaste-2/ambient` in your `tsconfig` or entry point Typescript file:
+GJS resolves `gi://` at runtime. To give it types, reference the package once, either
+from your entry point or from `tsconfig.json`:
 
-`index.ts`:
 ```ts
-import '@girs/gpaste-2'
+import '@girs/gpaste-2';
 ```
 
-`tsconfig.json`:
 ```json
-{
-  "compilerOptions": {
-    ...
-  },
-  "include": ["@girs/gpaste-2"],
-  ...
-}
+{ "include": ["@girs/gpaste-2"] }
 ```
 
-The ambient module now resolves with types:
+Then the runtime spelling type-checks:
 
 ```ts
 import GPaste from 'gi://GPaste?version=2';
 ```
 
-### Global import
-
-GJS's global `imports.gi` works too, with types.
-For this you need to include `@girs/gpaste-2` or `@girs/gpaste-2/import` in your `tsconfig` or entry point Typescript file:
+Referencing `@girs/gpaste-2/ambient` instead pulls in these declarations
+alone. See [ambient modules](https://github.com/gjsify/ts-for-gir/tree/main/packages/cli#ambient-modules).
 
-`index.ts`:
-```ts
-import '@girs/gpaste-2'
-```
-
-`tsconfig.json`:
-```json
-{
-  "compilerOptions": {
-    ...
-  },
-  "include": ["@girs/gpaste-2"],
-  ...
-}
-```
+### As `imports.gi`
 
-That form carries types as well:
+GJS's global object works the same way, via `@girs/gpaste-2/import`:
 
 ```ts
 const GPaste = imports.gi.GPaste;
 ```
 
-### Bundle
+## Building
 
-Most projects want a bundler. [esbuild](https://esbuild.github.io/) is the smallest thing that works; the [examples directory](https://github.com/gjsify/ts-for-gir/tree/main/examples) has setups for several others.
+The declarations need no build step. If you bundle, every bundler works, since there is
+no runtime code to resolve. The [examples](https://github.com/gjsify/ts-for-gir/tree/main/examples)
+show working setups for several.
 
 ## Other packages
 
-All existing pre-generated packages can be found on [gjsify/types](https://github.com/gjsify/types).
+Every pre-generated package is at [gjsify/types](https://github.com/gjsify/types).
+
 

package/gpaste-2.d.ts

@@ -34,10 +34,10 @@ export namespace GPaste {
      * @gir-type Enum
      */
     enum ItemKind {
-        TEXT,
-        URIS,
-        IMAGE,
-        PASSWORD,
+        TEXT = 1,
+        URIS = 2,
+        IMAGE = 3,
+        PASSWORD = 4,
     }
 
 
@@ -52,8 +52,8 @@ export namespace GPaste {
      * @gir-type Enum
      */
     enum UpdateAction {
-        REPLACE,
-        REMOVE,
+        REPLACE = 1,
+        REMOVE = 2,
     }
 
 
@@ -68,179 +68,434 @@ export namespace GPaste {
      * @gir-type Enum
      */
     enum UpdateTarget {
-        ALL,
-        POSITION,
+        ALL = 1,
+        POSITION = 2,
     }
 
 
+    /**
+     * @default org.gnome.GPaste
+     */
     const BUS_NAME: string;
 
+    /**
+     * @default close-on-select
+     */
     const CLOSE_ON_SELECT_SETTING: string;
 
+    /**
+     * @default About
+     */
     const DAEMON_ABOUT: string;
 
+    /**
+     * @default Add
+     */
     const DAEMON_ADD: string;
 
+    /**
+     * @default AddFile
+     */
     const DAEMON_ADD_FILE: string;
 
+    /**
+     * @default AddPassword
+     */
     const DAEMON_ADD_PASSWORD: string;
 
+    /**
+     * @default BackupHistory
+     */
     const DAEMON_BACKUP_HISTORY: string;
 
+    /**
+     * @default Delete
+     */
     const DAEMON_DELETE: string;
 
+    /**
+     * @default DeleteHistory
+     */
     const DAEMON_DELETE_HISTORY: string;
 
+    /**
+     * @default DeletePassword
+     */
     const DAEMON_DELETE_PASSWORD: string;
 
+    /**
+     * @default EmptyHistory
+     */
     const DAEMON_EMPTY_HISTORY: string;
 
+    /**
+     * @default GetElement
+     */
     const DAEMON_GET_ELEMENT: string;
 
+    /**
+     * @default GetElements
+     */
     const DAEMON_GET_ELEMENTS: string;
 
+    /**
+     * @default GetElementAtIndex
+     */
     const DAEMON_GET_ELEMENT_AT_INDEX: string;
 
+    /**
+     * @default GetElementKind
+     */
     const DAEMON_GET_ELEMENT_KIND: string;
 
+    /**
+     * @default GetHistory
+     */
     const DAEMON_GET_HISTORY: string;
 
+    /**
+     * @default GetHistoryName
+     */
     const DAEMON_GET_HISTORY_NAME: string;
 
+    /**
+     * @default GetHistorySize
+     */
     const DAEMON_GET_HISTORY_SIZE: string;
 
+    /**
+     * @default GetRawElement
+     */
     const DAEMON_GET_RAW_ELEMENT: string;
 
+    /**
+     * @default GetRawHistory
+     */
     const DAEMON_GET_RAW_HISTORY: string;
 
+    /**
+     * @default <node> <interface name='
+     */
     const DAEMON_INTERFACE: string;
 
+    /**
+     * @default org.gnome.GPaste2
+     */
     const DAEMON_INTERFACE_NAME: string;
 
+    /**
+     * @default ListHistories
+     */
     const DAEMON_LIST_HISTORIES: string;
 
+    /**
+     * @default Merge
+     */
     const DAEMON_MERGE: string;
 
+    /**
+     * @default /org/gnome/GPaste
+     */
     const DAEMON_OBJECT_PATH: string;
 
+    /**
+     * @default OnExtensionStateChanged
+     */
     const DAEMON_ON_EXTENSION_STATE_CHANGED: string;
 
+    /**
+     * @default Active
+     */
     const DAEMON_PROP_ACTIVE: string;
 
+    /**
+     * @default Version
+     */
     const DAEMON_PROP_VERSION: string;
 
+    /**
+     * @default Reexecute
+     */
     const DAEMON_REEXECUTE: string;
 
+    /**
+     * @default RenamePassword
+     */
     const DAEMON_RENAME_PASSWORD: string;
 
+    /**
+     * @default Replace
+     */
     const DAEMON_REPLACE: string;
 
+    /**
+     * @default Search
+     */
     const DAEMON_SEARCH: string;
 
+    /**
+     * @default Select
+     */
     const DAEMON_SELECT: string;
 
+    /**
+     * @default SetPassword
+     */
     const DAEMON_SET_PASSWORD: string;
 
+    /**
+     * @default ShowHistory
+     */
     const DAEMON_SHOW_HISTORY: string;
 
+    /**
+     * @default DeleteHistory
+     */
     const DAEMON_SIG_DELETE_HISTORY: string;
 
+    /**
+     * @default EmptyHistory
+     */
     const DAEMON_SIG_EMPTY_HISTORY: string;
 
+    /**
+     * @default ShowHistory
+     */
     const DAEMON_SIG_SHOW_HISTORY: string;
 
+    /**
+     * @default SwitchHistory
+     */
     const DAEMON_SIG_SWITCH_HISTORY: string;
 
+    /**
+     * @default Update
+     */
     const DAEMON_SIG_UPDATE: string;
 
+    /**
+     * @default SwitchHistory
+     */
     const DAEMON_SWITCH_HISTORY: string;
 
+    /**
+     * @default Track
+     */
     const DAEMON_TRACK: string;
 
+    /**
+     * @default Upload
+     */
     const DAEMON_UPLOAD: string;
 
+    /**
+     * @default element-size
+     */
     const ELEMENT_SIZE_SETTING: string;
 
+    /**
+     * @default empty-history-confirmation
+     */
     const EMPTY_HISTORY_CONFIRMATION_SETTING: string;
 
+    /**
+     * @default extension-enabled
+     */
     const EXTENSION_ENABLED_SETTING: string;
 
+    /**
+     * @default org.gnome.Shell
+     */
     const GNOME_SHELL_BUS_NAME: string;
 
+    /**
+     * @default growing-lines
+     */
     const GROWING_LINES_SETTING: string;
 
+    /**
+     * @default history-name
+     */
     const HISTORY_NAME_SETTING: string;
 
+    /**
+     * @default images-preview
+     */
     const IMAGES_PREVIEW_SETTING: string;
 
+    /**
+     * @default images-preview-size
+     */
     const IMAGES_PREVIEW_SIZE_SETTING: string;
 
+    /**
+     * @default images-support
+     */
     const IMAGES_SUPPORT_SETTING: string;
 
+    /**
+     * @default launch-ui
+     */
     const LAUNCH_UI_SETTING: string;
 
+    /**
+     * @default make-password
+     */
     const MAKE_PASSWORD_SETTING: string;
 
+    /**
+     * @default max-displayed-history-size
+     */
     const MAX_DISPLAYED_HISTORY_SIZE_SETTING: string;
 
+    /**
+     * @default max-history-size
+     */
     const MAX_HISTORY_SIZE_SETTING: string;
 
+    /**
+     * @default max-memory-usage
+     */
     const MAX_MEMORY_USAGE_SETTING: string;
 
+    /**
+     * @default max-text-item-size
+     */
     const MAX_TEXT_ITEM_SIZE_SETTING: string;
 
+    /**
+     * @default min-text-item-size
+     */
     const MIN_TEXT_ITEM_SIZE_SETTING: string;
 
+    /**
+     * @default open-centered
+     */
     const OPEN_CENTERED_SETTING: string;
 
+    /**
+     * @default pop
+     */
     const POP_SETTING: string;
 
+    /**
+     * @default primary-to-history
+     */
     const PRIMARY_TO_HISTORY_SETTING: string;
 
+    /**
+     * @default rich-text-support
+     */
     const RICH_TEXT_SUPPORT_SETTING: string;
 
+    /**
+     * @default save-history
+     */
     const SAVE_HISTORY_SETTING: string;
 
+    /**
+     * @default org.gnome.ScreenSaver
+     */
     const SCREENSAVER_BUS_NAME: string;
 
+    /**
+     * @default ActivateResult
+     */
     const SEARCH_PROVIDER_ACTIVATE_RESULT: string;
 
+    /**
+     * @default GetInitialResultSet
+     */
     const SEARCH_PROVIDER_GET_INITIAL_RESULT_SET: string;
 
+    /**
+     * @default GetResultMetas
+     */
     const SEARCH_PROVIDER_GET_RESULT_METAS: string;
 
+    /**
+     * @default GetSubsearchResultSet
+     */
     const SEARCH_PROVIDER_GET_SUBSEARCH_RESULT_SET: string;
 
+    /**
+     * @default <node> <interface name='
+     */
     const SEARCH_PROVIDER_INTERFACE: string;
 
+    /**
+     * @default org.gnome.Shell.SearchProvider2
+     */
     const SEARCH_PROVIDER_INTERFACE_NAME: string;
 
+    /**
+     * @default LaunchSearch
+     */
     const SEARCH_PROVIDER_LAUNCH_SEARCH: string;
 
+    /**
+     * @default /org/gnome/GPaste/SearchProvider
+     */
     const SEARCH_PROVIDER_OBJECT_PATH: string;
 
+    /**
+     * @default org.gnome.GPaste
+     */
     const SETTINGS_NAME: string;
 
+    /**
+     * @default /org/gnome/GPaste/
+     */
     const SETTINGS_PATH: string;
 
+    /**
+     * @default enabled-extensions
+     */
     const SHELL_ENABLED_EXTENSIONS_SETTING: string;
 
+    /**
+     * @default org.gnome.shell
+     */
     const SHELL_SETTINGS_NAME: string;
 
+    /**
+     * @default show-history
+     */
     const SHOW_HISTORY_SETTING: string;
 
+    /**
+     * @default synchronize-clipboards
+     */
     const SYNCHRONIZE_CLIPBOARDS_SETTING: string;
 
+    /**
+     * @default sync-clipboard-to-primary
+     */
     const SYNC_CLIPBOARD_TO_PRIMARY_SETTING: string;
 
+    /**
+     * @default sync-primary-to-clipboard
+     */
     const SYNC_PRIMARY_TO_CLIPBOARD_SETTING: string;
 
+    /**
+     * @default track-changes
+     */
     const TRACK_CHANGES_SETTING: string;
 
+    /**
+     * @default track-extension-state
+     */
     const TRACK_EXTENSION_STATE_SETTING: string;
 
+    /**
+     * @default trim-items
+     */
     const TRIM_ITEMS_SETTING: string;
 
+    /**
+     * @default upload
+     */
     const UPLOAD_SETTING: string;
 
     /**
@@ -255,6 +510,7 @@ export namespace GPaste {
      * @param action the action to activate
      * @param arg the action argument
      * @returns whether the action was successful
+     * @throws GLib.Error
      */
     function util_activate_ui_sync(action: string, arg: GLib.Variant | null): boolean;
 
@@ -274,6 +530,7 @@ export namespace GPaste {
      * @param settings a {@link GPaste.Settings} instance
      * @param history the name of the history to empty
      * @returns whether the action was successful
+     * @throws GLib.Error
      */
     function util_empty_with_confirmation_sync(client: Client, settings: Settings, history: string): boolean;
 
@@ -362,6 +619,7 @@ export namespace GPaste {
      * spawn a GPaste app
      * @param app the GPaste app to spawn
      * @returns whether the spawn was successful
+     * @throws GLib.Error
      */
     function util_spawn_sync(app: string): boolean;
 
@@ -394,48 +652,48 @@ export namespace GPaste {
         /**
          * block action
          */
-        NONE,
+        NONE = 0,
         /**
          * allow action when in window mode,
          *     e.g. when the focus is in an application window
          */
-        NORMAL,
+        NORMAL = 1,
         /**
          * allow action while the overview
          *     is active
          */
-        OVERVIEW,
+        OVERVIEW = 2,
         /**
          * allow action when the screen
          *     is locked, e.g. when the screen shield is shown
          */
-        LOCK_SCREEN,
+        LOCK_SCREEN = 4,
         /**
          * allow action in the unlock
          *     dialog
          */
-        UNLOCK_SCREEN,
+        UNLOCK_SCREEN = 8,
         /**
          * allow action in the login screen
          */
-        LOGIN_SCREEN,
+        LOGIN_SCREEN = 16,
         /**
          * allow action when a system modal
          *     dialog (e.g. authentification or session dialogs) is open
          */
-        SYSTEM_MODAL,
+        SYSTEM_MODAL = 32,
         /**
          * allow action in looking glass
          */
-        LOOKING_GLASS,
+        LOOKING_GLASS = 64,
         /**
          * allow action while a shell menu is open
          */
-        POPUP,
+        POPUP = 128,
         /**
          * always allow action
          */
-        ALL,
+        ALL = -1,
     }
 
 
@@ -446,24 +704,24 @@ export namespace GPaste {
         /**
          * none
          */
-        NONE,
+        NONE = 0,
         /**
          * per-window
          */
-        PER_WINDOW,
+        PER_WINDOW = 1,
         /**
          * built-in
          */
-        BUILTIN,
+        BUILTIN = 2,
         /**
          * is reversed
          */
-        IS_REVERSED,
+        IS_REVERSED = 4,
         /**
          * always active
          */
-        NON_MASKABLE,
-        IGNORE_AUTOREPEAT,
+        NON_MASKABLE = 8,
+        IGNORE_AUTOREPEAT = 16,
     }
 
 
@@ -476,14 +734,14 @@ export namespace GPaste {
              * @signal
              * @run-last
              */
-            "delete-history": (arg0: string) => void;
+            "delete-history": (history: string) => void;
             /**
              * The "empty-history" signal is emitted when we empty
              * a history.
              * @signal
              * @run-last
              */
-            "empty-history": (arg0: string) => void;
+            "empty-history": (history: string) => void;
             /**
              * The "show-history" signal is emitted when we switch
              * from a history to another.
@@ -497,19 +755,19 @@ export namespace GPaste {
              * @signal
              * @run-last
              */
-            "switch-history": (arg0: string) => void;
+            "switch-history": (history: string) => void;
             /**
              * @signal
              * @run-last
              */
-            tracking: (arg0: boolean) => void;
+            tracking: (object: boolean) => void;
             /**
              * The "update" signal is emitted whenever anything changed
              * in the history (something was added, removed, selected, replaced...).
              * @signal
              * @run-last
              */
-            update: (arg0: UpdateAction, arg1: UpdateTarget, arg2: number) => void;
+            update: (action: UpdateAction, target: UpdateTarget, index: number) => void;
             "notify::g-bus-type": (pspec: GObject.ParamSpec) => void;
             "notify::g-connection": (pspec: GObject.ParamSpec) => void;
             "notify::g-default-timeout": (pspec: GObject.ParamSpec) => void;
@@ -599,11 +857,13 @@ export namespace GPaste {
         /**
          * Display the about dialog
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         about_finish(result: Gio.AsyncResult): void;
 
         /**
          * Display the about dialog
+         * @throws GLib.Error
          */
         about_sync(): void;
 
@@ -650,18 +910,21 @@ export namespace GPaste {
         /**
          * Add the file contents to the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         add_file_finish(result: Gio.AsyncResult): void;
 
         /**
          * Add the file contents to the `GPasteDaemon`
          * @param file the file to add
+         * @throws GLib.Error
          */
         add_file_sync(file: string): void;
 
         /**
          * Add an item to the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         add_finish(result: Gio.AsyncResult): void;
 
@@ -691,6 +954,7 @@ export namespace GPaste {
         /**
          * Add the password to the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         add_password_finish(result: Gio.AsyncResult): void;
 
@@ -698,12 +962,14 @@ export namespace GPaste {
          * Add the password to the `GPasteDaemon`
          * @param name the name to identify the password to add
          * @param password the password to add
+         * @throws GLib.Error
          */
         add_password_sync(name: string, password: string): void;
 
         /**
          * Add an item to the `GPasteDaemon`
          * @param text the text to add
+         * @throws GLib.Error
          */
         add_sync(text: string): void;
 
@@ -733,6 +999,7 @@ export namespace GPaste {
         /**
          * Backup the current history
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         backup_history_finish(result: Gio.AsyncResult): void;
 
@@ -740,6 +1007,7 @@ export namespace GPaste {
          * Backup the current history
          * @param history the name of the history
          * @param backup the name of the backup
+         * @throws GLib.Error
          */
         backup_history_sync(history: string, backup: string): void;
 
@@ -766,6 +1034,7 @@ export namespace GPaste {
         /**
          * Delete an item from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         delete_finish(result: Gio.AsyncResult): void;
 
@@ -792,12 +1061,14 @@ export namespace GPaste {
         /**
          * Delete a history
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         delete_history_finish(result: Gio.AsyncResult): void;
 
         /**
          * Delete a history
          * @param name the name of the history to delete
+         * @throws GLib.Error
          */
         delete_history_sync(name: string): void;
 
@@ -824,18 +1095,21 @@ export namespace GPaste {
         /**
          * Delete the password from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         delete_password_finish(result: Gio.AsyncResult): void;
 
         /**
          * Delete the password from the `GPasteDaemon`
          * @param name the name of the password to delete
+         * @throws GLib.Error
          */
         delete_password_sync(name: string): void;
 
         /**
          * Delete an item from the `GPasteDaemon`
          * @param uuid the uuid of the element we want to delete
+         * @throws GLib.Error
          */
         delete_sync(uuid: string): void;
 
@@ -862,12 +1136,14 @@ export namespace GPaste {
         /**
          * Empty the history from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         empty_history_finish(result: Gio.AsyncResult): void;
 
         /**
          * Empty the history from the `GPasteDaemon`
          * @param name the name of the history to empty
+         * @throws GLib.Error
          */
         empty_history_sync(name: string): void;
 
@@ -915,6 +1191,7 @@ export namespace GPaste {
          * Get an item from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns a new {@link GPaste.ClientItem}
+         * @throws GLib.Error
          */
         get_element_at_index_finish(result: Gio.AsyncResult): ClientItem;
 
@@ -922,6 +1199,7 @@ export namespace GPaste {
          * Get an item from the `GPasteDaemon`
          * @param index the index of the element we want to get
          * @returns a new {@link GPaste.ClientItem}
+         * @throws GLib.Error
          */
         get_element_at_index_sync(index: bigint | number): ClientItem;
 
@@ -929,6 +1207,7 @@ export namespace GPaste {
          * Get an item from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns a newly allocated string
+         * @throws GLib.Error
          */
         get_element_finish(result: Gio.AsyncResult): string;
 
@@ -956,6 +1235,7 @@ export namespace GPaste {
          * Get this kind of an item from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns The {@link GPaste.ItemKind}
+         * @throws GLib.Error
          */
         get_element_kind_finish(result: Gio.AsyncResult): ItemKind;
 
@@ -963,6 +1243,7 @@ export namespace GPaste {
          * Get the kind of an item from the `GPasteDaemon`
          * @param uuid the uuid of the element we want to get
          * @returns The {@link GPaste.ItemKind}
+         * @throws GLib.Error
          */
         get_element_kind_sync(uuid: string): ItemKind;
 
@@ -970,6 +1251,7 @@ export namespace GPaste {
          * Get an item from the `GPasteDaemon`
          * @param uuid the uuid of the element we want to get
          * @returns a newly allocated string
+         * @throws GLib.Error
          */
         get_element_sync(uuid: string): string;
 
@@ -997,6 +1279,7 @@ export namespace GPaste {
          * Get some items from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns a newly allocated array of string
+         * @throws GLib.Error
          */
         get_elements_finish(result: Gio.AsyncResult): ClientItem[];
 
@@ -1004,6 +1287,7 @@ export namespace GPaste {
          * Get some items from the `GPasteDaemon`
          * @param uuids the uuids of the elements we want to get
          * @returns a newly allocated array of string
+         * @throws GLib.Error
          */
         get_elements_sync(uuids: string[]): ClientItem[];
 
@@ -1028,6 +1312,7 @@ export namespace GPaste {
          * Get the history from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns a newly allocated array of string
+         * @throws GLib.Error
          */
         get_history_finish(result: Gio.AsyncResult): ClientItem[];
 
@@ -1052,12 +1337,14 @@ export namespace GPaste {
          * Get the name of the history from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns a newly allocated string
+         * @throws GLib.Error
          */
         get_history_name_finish(result: Gio.AsyncResult): string;
 
         /**
          * Get the name of the history from the `GPasteDaemon`
          * @returns a newly allocated string
+         * @throws GLib.Error
          */
         get_history_name_sync(): string;
 
@@ -1085,6 +1372,7 @@ export namespace GPaste {
          * Get the history size from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns the size of the history
+         * @throws GLib.Error
          */
         get_history_size_finish(result: Gio.AsyncResult): number;
 
@@ -1092,12 +1380,14 @@ export namespace GPaste {
          * Get the history size from the `GPasteDaemon`
          * @param name the name of the history
          * @returns the size of the history
+         * @throws GLib.Error
          */
         get_history_size_sync(name: string): number;
 
         /**
          * Get the history from the `GPasteDaemon`
          * @returns a newly allocated array of string
+         * @throws GLib.Error
          */
         get_history_sync(): ClientItem[];
 
@@ -1125,6 +1415,7 @@ export namespace GPaste {
          * Get an item from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns a newly allocated string
+         * @throws GLib.Error
          */
         get_raw_element_finish(result: Gio.AsyncResult): string;
 
@@ -1132,6 +1423,7 @@ export namespace GPaste {
          * Get an item from the `GPasteDaemon`
          * @param uuid the uuid of the element we want to get
          * @returns a newly allocated string
+         * @throws GLib.Error
          */
         get_raw_element_sync(uuid: string): string;
 
@@ -1156,12 +1448,14 @@ export namespace GPaste {
          * Get the history from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns a newly allocated array of string
+         * @throws GLib.Error
          */
         get_raw_history_finish(result: Gio.AsyncResult): ClientItem[];
 
         /**
          * Get the history from the `GPasteDaemon`
          * @returns a newly allocated array of string
+         * @throws GLib.Error
          */
         get_raw_history_sync(): ClientItem[];
 
@@ -1198,12 +1492,14 @@ export namespace GPaste {
          * List all available hisotries
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns a newly allocated array of string
+         * @throws GLib.Error
          */
         list_histories_finish(result: Gio.AsyncResult): string[];
 
         /**
          * List all available hisotries
          * @returns a newly allocated array of string
+         * @throws GLib.Error
          */
         list_histories_sync(): string[];
 
@@ -1245,6 +1541,7 @@ export namespace GPaste {
         /**
          * Merge some history entries
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         merge_finish(result: Gio.AsyncResult): void;
 
@@ -1256,6 +1553,7 @@ export namespace GPaste {
          * @param decoration the decoration to apply to each entry
          * @param separator the separator to add between each entry
          * @param uuids the uuids of the elements we want to get
+         * @throws GLib.Error
          */
         merge_sync(decoration: string | null, separator: string | null, uuids: string[]): void;
 
@@ -1282,12 +1580,14 @@ export namespace GPaste {
         /**
          * Call this when the extension changes its state
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         on_extension_state_changed_finish(result: Gio.AsyncResult): void;
 
         /**
          * Call this when the extension changes its state
          * @param state the new state of the extension
+         * @throws GLib.Error
          */
         on_extension_state_changed_sync(state: boolean): void;
 
@@ -1311,11 +1611,13 @@ export namespace GPaste {
         /**
          * Reexecute the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         reexecute_finish(result: Gio.AsyncResult): void;
 
         /**
          * Reexecute the `GPasteDaemon`
+         * @throws GLib.Error
          */
         reexecute_sync(): void;
 
@@ -1345,6 +1647,7 @@ export namespace GPaste {
         /**
          * Rename the password in the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         rename_password_finish(result: Gio.AsyncResult): void;
 
@@ -1352,6 +1655,7 @@ export namespace GPaste {
          * Rename the password in the `GPasteDaemon`
          * @param old_name the name of the password to rename
          * @param new_name the new name to give it
+         * @throws GLib.Error
          */
         rename_password_sync(old_name: string, new_name: string): void;
 
@@ -1381,6 +1685,7 @@ export namespace GPaste {
         /**
          * Replace the contents of an item
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         replace_finish(result: Gio.AsyncResult): void;
 
@@ -1388,6 +1693,7 @@ export namespace GPaste {
          * Replace the contents of an item
          * @param uuid the uuid of the element we want to replace
          * @param contents the replacement contents
+         * @throws GLib.Error
          */
         replace_sync(uuid: string, contents: string): void;
 
@@ -1415,6 +1721,7 @@ export namespace GPaste {
          * Search for items matching `pattern` in history
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns The indexes of the matching items
+         * @throws GLib.Error
          */
         search_finish(result: Gio.AsyncResult): string[];
 
@@ -1422,6 +1729,7 @@ export namespace GPaste {
          * Search for items matching `pattern` in history
          * @param pattern the pattern to look for in history
          * @returns The uuids of the matching items
+         * @throws GLib.Error
          */
         search_sync(pattern: string): string[];
 
@@ -1448,12 +1756,14 @@ export namespace GPaste {
         /**
          * Select an item from the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         select_finish(result: Gio.AsyncResult): void;
 
         /**
          * Select an item from the `GPasteDaemon`
          * @param uuid the uuid of the element we want to select
+         * @throws GLib.Error
          */
         select_sync(uuid: string): void;
 
@@ -1483,6 +1793,7 @@ export namespace GPaste {
         /**
          * Set the item as password
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         set_password_finish(result: Gio.AsyncResult): void;
 
@@ -1490,6 +1801,7 @@ export namespace GPaste {
          * Set the item as password
          * @param uuid the uuid of the element we want to set as password
          * @param name the name to identify the password
+         * @throws GLib.Error
          */
         set_password_sync(uuid: string, name: string): void;
 
@@ -1513,11 +1825,13 @@ export namespace GPaste {
         /**
          * Emit the ShowHistory signal
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         show_history_finish(result: Gio.AsyncResult): void;
 
         /**
          * Emit the ShowHistory signal
+         * @throws GLib.Error
          */
         show_history_sync(): void;
 
@@ -1544,12 +1858,14 @@ export namespace GPaste {
         /**
          * Switch to another history
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         switch_history_finish(result: Gio.AsyncResult): void;
 
         /**
          * Switch to another history
          * @param name the name of the history to switch to
+         * @throws GLib.Error
          */
         switch_history_sync(name: string): void;
 
@@ -1576,12 +1892,14 @@ export namespace GPaste {
         /**
          * Change the tracking state of the `GPasteDaemon`
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         track_finish(result: Gio.AsyncResult): void;
 
         /**
          * Change the tracking state of the `GPasteDaemon`
          * @param state the new tracking state of the `GPasteDaemon`
+         * @throws GLib.Error
          */
         track_sync(state: boolean): void;
 
@@ -1608,12 +1926,14 @@ export namespace GPaste {
         /**
          * Upload an item to a pastebin service
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
+         * @throws GLib.Error
          */
         upload_finish(result: Gio.AsyncResult): void;
 
         /**
          * Upload an item to a pastebin service
          * @param uuid the uuid of the element we want to upload
+         * @throws GLib.Error
          */
         upload_sync(uuid: string): void;
 
@@ -1754,6 +2074,7 @@ export namespace GPaste {
          * @param res a {@link Gio.AsyncResult}.
          * @returns `true` if successful. If an error has occurred, this function will return `false` and set `error` appropriately if present.
          * @since 2.22
+         * @throws GLib.Error
          */
         init_finish(res: Gio.AsyncResult): boolean;
 
@@ -1763,6 +2084,7 @@ export namespace GPaste {
          * @param res the {@link Gio.AsyncResult} from the callback
          * @returns a newly created {@link GObject.Object},      or `null` on error. Free with `g_object_unref()`.
          * @since 2.22
+         * @throws GLib.Error
          */
         new_finish(res: Gio.AsyncResult): Client;
 
@@ -1927,6 +2249,7 @@ export namespace GPaste {
          * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
          * @returns `true` if successful. If an error has occurred, this function will     return `false` and set `error` appropriately if present.
          * @since 2.22
+         * @throws GLib.Error
          */
         init(cancellable: Gio.Cancellable | null): boolean;
 
@@ -2035,14 +2358,14 @@ export namespace GPaste {
 
     namespace GnomeShellClient {
         // Signal signatures
-        interface SignalSignatures extends Gio.DBusProxy.SignalSignatures {
+        interface SignalSignatures extends Gio.DBusProxy.SignalSignatures, KeybindingProvider.SignalSignatures {
             /**
              * The "accelerator-activated" signal is emitted when gnome-shell notifies us
              * that an accelerator has been pressed.
              * @signal
              * @run-last
              */
-            "accelerator-activated": (arg0: number) => void;
+            "accelerator-activated": (id: number) => void;
             "notify::g-bus-type": (pspec: GObject.ParamSpec) => void;
             "notify::g-connection": (pspec: GObject.ParamSpec) => void;
             "notify::g-default-timeout": (pspec: GObject.ParamSpec) => void;
@@ -2136,6 +2459,7 @@ export namespace GPaste {
          * Grab a keybinding
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns the action id corresultponding
+         * @throws GLib.Error
          */
         grab_accelerator_finish(result: Gio.AsyncResult): number;
 
@@ -2143,6 +2467,7 @@ export namespace GPaste {
          * Grab a keybinding
          * @param accelerator a {@link GPaste.GnomeShellAccelerator} instance
          * @returns the action id corresponding
+         * @throws GLib.Error
          */
         grab_accelerator_sync(accelerator: GnomeShellAccelerator): number;
 
@@ -2170,6 +2495,7 @@ export namespace GPaste {
          * Grab some keybindings
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns the action ids corresultponding
+         * @throws GLib.Error
          */
         grab_accelerators_finish(result: Gio.AsyncResult): number;
 
@@ -2177,6 +2503,7 @@ export namespace GPaste {
          * Grab some keybindings
          * @param accelerators an array of {@link GPaste.GnomeShellAccelerator} instances
          * @returns the action ids corresponding
+         * @throws GLib.Error
          */
         grab_accelerators_sync(accelerators: GnomeShellAccelerator[]): number;
 
@@ -2204,6 +2531,7 @@ export namespace GPaste {
          * Ungrab a keybinding
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to the async call.
          * @returns whether the ungrab was succesful or not
+         * @throws GLib.Error
          */
         ungrab_accelerator_finish(result: Gio.AsyncResult): boolean;
 
@@ -2211,6 +2539,7 @@ export namespace GPaste {
          * Ungrab a keybinding
          * @param action the action id corresponding to the keybinding
          * @returns whether the ungrab was succesful or not
+         * @throws GLib.Error
          */
         ungrab_accelerator_sync(action: number): boolean;
 
@@ -2381,6 +2710,7 @@ export namespace GPaste {
          * @param res a {@link Gio.AsyncResult}.
          * @returns `true` if successful. If an error has occurred, this function will return `false` and set `error` appropriately if present.
          * @since 2.22
+         * @throws GLib.Error
          */
         init_finish(res: Gio.AsyncResult): boolean;
 
@@ -2390,6 +2720,7 @@ export namespace GPaste {
          * @param res the {@link Gio.AsyncResult} from the callback
          * @returns a newly created {@link GObject.Object},      or `null` on error. Free with `g_object_unref()`.
          * @since 2.22
+         * @throws GLib.Error
          */
         new_finish(res: Gio.AsyncResult): GnomeShellClient;
 
@@ -2554,6 +2885,7 @@ export namespace GPaste {
          * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
          * @returns `true` if successful. If an error has occurred, this function will     return `false` and set `error` appropriately if present.
          * @since 2.22
+         * @throws GLib.Error
          */
         init(cancellable: Gio.Cancellable | null): boolean;
 
@@ -2612,7 +2944,7 @@ export namespace GPaste {
              * @signal
              * @run-last
              */
-            "active-changed": (arg0: boolean) => void;
+            "active-changed": (active: boolean) => void;
             "notify::g-bus-type": (pspec: GObject.ParamSpec) => void;
             "notify::g-connection": (pspec: GObject.ParamSpec) => void;
             "notify::g-default-timeout": (pspec: GObject.ParamSpec) => void;
@@ -2818,6 +3150,7 @@ export namespace GPaste {
          * @param res a {@link Gio.AsyncResult}.
          * @returns `true` if successful. If an error has occurred, this function will return `false` and set `error` appropriately if present.
          * @since 2.22
+         * @throws GLib.Error
          */
         init_finish(res: Gio.AsyncResult): boolean;
 
@@ -2827,6 +3160,7 @@ export namespace GPaste {
          * @param res the {@link Gio.AsyncResult} from the callback
          * @returns a newly created {@link GObject.Object},      or `null` on error. Free with `g_object_unref()`.
          * @since 2.22
+         * @throws GLib.Error
          */
         new_finish(res: Gio.AsyncResult): ScreensaverClient;
 
@@ -2991,6 +3325,7 @@ export namespace GPaste {
          * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
          * @returns `true` if successful. If an error has occurred, this function will     return `false` and set `error` appropriately if present.
          * @since 2.22
+         * @throws GLib.Error
          */
         init(cancellable: Gio.Cancellable | null): boolean;
 
@@ -3056,7 +3391,7 @@ export namespace GPaste {
              * @detailed
              * @run-last
              */
-            changed: (arg0: string) => void;
+            changed: (key: string) => void;
             /**
              * The "rebind" signal is emitted when a key has potentially changed.
              * You should call one of the `g_paste_settings_get()` calls to check the new
@@ -3069,16 +3404,16 @@ export namespace GPaste {
              * @detailed
              * @run-last
              */
-            rebind: (arg0: string) => void;
+            rebind: (key: string) => void;
             /**
              * The "track" signal is emitted when the daemon starts or stops tracking
              * clipboard changes
              * @signal
              * @run-last
              */
-            track: (arg0: boolean) => void;
-            [key: `changed::${string}`]: (arg0: string) => void;
-            [key: `rebind::${string}`]: (arg0: string) => void;
+            track: (tracking_state: boolean) => void;
+            [key: `changed::${string}`]: (key: string) => void;
+            [key: `rebind::${string}`]: (key: string) => void;
         }
 
         // Constructor properties interface
@@ -3682,6 +4017,16 @@ export namespace GPaste {
     type SettingsClass = typeof Settings;
 
     namespace KeybindingProvider {
+        // Signal signatures
+        interface SignalSignatures {
+            /**
+             * The "keybinding-activated" signal is emitted when a registered shortcut
+             * is pressed by the user.
+             * @signal
+             * @run-last
+             */
+            "keybinding-activated": (id: string) => void;
+        }
         /**
          * Interface for implementing KeybindingProvider.
          * Contains only the virtual methods that need to be implemented.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@girs/gpaste-2",
-    "version": "4.4.0",
+    "version": "4.6.0",
     "description": "GJS TypeScript type definitions for GPaste-2",
     "type": "module",
     "module": "gpaste-2.js",
@@ -31,11 +31,11 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "^4.4.0",
-      "@girs/gio-2.0": "^4.4.0",
-      "@girs/gobject-2.0": "^4.4.0",
-      "@girs/glib-2.0": "^4.4.0",
-      "@girs/gmodule-2.0": "^4.4.0"    },
+      "@girs/gjs": "^4.6.0",
+      "@girs/gio-2.0": "^4.6.0",
+      "@girs/gobject-2.0": "^4.6.0",
+      "@girs/glib-2.0": "^4.6.0",
+      "@girs/gmodule-2.0": "^4.6.0"    },
     "devDependencies": {
       "typescript": "*"
     },