@girs/gtop-2.0 4.2.0 → 4.4.0

package/README.md

@@ -5,25 +5,25 @@
 ![downloads/week](https://img.shields.io/npm/dw/@girs/gtop-2.0)
 
 
-GJS TypeScript type definitions for GTop-2.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.2.0.
+GJS TypeScript type definitions for GTop-2.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.4.0.
 
 ## Install
 
-To use this type definitions, install them with NPM:
+Install the type definitions with npm:
 ```bash
 npm install @girs/gtop-2.0
 ```
 
 ## Usage
 
-You can import this package into your project like this:
+Import it like any other module:
 ```ts
 import GTop from '@girs/gtop-2.0';
 ```
 
 ### Ambient Modules
 
-You can also use [ambient modules](https://github.com/gjsify/ts-for-gir/tree/main/packages/cli#ambient-modules) to import this module like you would do this in JavaScript.
+[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/gtop-2.0` or `@girs/gtop-2.0/ambient` in your `tsconfig` or entry point Typescript file:
 
 `index.ts`:
@@ -42,7 +42,7 @@ import '@girs/gtop-2.0'
 }
 ```
 
-Now you can import the ambient module with TypeScript support: 
+The ambient module now resolves with types:
 
 ```ts
 import GTop from 'gi://GTop?version=2.0';
@@ -50,7 +50,7 @@ import GTop from 'gi://GTop?version=2.0';
 
 ### Global import
 
-You can also import the module with Typescript support using the global `imports.gi` object of GJS.
+GJS's global `imports.gi` works too, with types.
 For this you need to include `@girs/gtop-2.0` or `@girs/gtop-2.0/import` in your `tsconfig` or entry point Typescript file:
 
 `index.ts`:
@@ -69,7 +69,7 @@ import '@girs/gtop-2.0'
 }
 ```
 
-Now you have also type support for this, too:
+That form carries types as well:
 
 ```ts
 const GTop = imports.gi.GTop;
@@ -77,7 +77,7 @@ const GTop = imports.gi.GTop;
 
 ### Bundle
 
-Depending on your project configuration, it is recommended to use a bundler like [esbuild](https://esbuild.github.io/). You can find examples using different bundlers [here](https://github.com/gjsify/ts-for-gir/tree/main/examples).
+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.
 
 ## Other packages
 

package/gtop-2.0.d.ts

@@ -849,87 +849,87 @@ export namespace GTop {
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_affinity(buf: glibtop_proc_affinity, pid: number): number;
+    function glibtop_get_proc_affinity(buf: glibtop_proc_affinity, pid: never): number;
 
     /**
      * @param buf 
      * @param pid 
      * @param max_len 
      */
-    function glibtop_get_proc_args(buf: glibtop_proc_args, pid: number, max_len: number): string;
+    function glibtop_get_proc_args(buf: glibtop_proc_args, pid: never, max_len: number): string;
 
     /**
      * @param buf 
      * @param pid 
      * @param max_len 
      */
-    function glibtop_get_proc_argv(buf: glibtop_proc_args, pid: number, max_len: number): string[];
+    function glibtop_get_proc_argv(buf: glibtop_proc_args, pid: never, max_len: number): string[];
 
     /**
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_io(buf: glibtop_proc_io, pid: number): void;
+    function glibtop_get_proc_io(buf: glibtop_proc_io, pid: never): void;
 
     /**
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_kernel(buf: glibtop_proc_kernel, pid: number): void;
+    function glibtop_get_proc_kernel(buf: glibtop_proc_kernel, pid: never): void;
 
     /**
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_map(buf: glibtop_proc_map, pid: number): glibtop_map_entry[];
+    function glibtop_get_proc_map(buf: glibtop_proc_map, pid: never): glibtop_map_entry[];
 
     /**
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_mem(buf: glibtop_proc_mem, pid: number): void;
+    function glibtop_get_proc_mem(buf: glibtop_proc_mem, pid: never): void;
 
     /**
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_open_files(buf: glibtop_proc_open_files, pid: number): glibtop_open_files_entry[];
+    function glibtop_get_proc_open_files(buf: glibtop_proc_open_files, pid: never): glibtop_open_files_entry[];
 
     /**
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_segment(buf: glibtop_proc_segment, pid: number): void;
+    function glibtop_get_proc_segment(buf: glibtop_proc_segment, pid: never): void;
 
     /**
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_signal(buf: glibtop_proc_signal, pid: number): void;
+    function glibtop_get_proc_signal(buf: glibtop_proc_signal, pid: never): void;
 
     /**
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_state(buf: glibtop_proc_state, pid: number): void;
+    function glibtop_get_proc_state(buf: glibtop_proc_state, pid: never): void;
 
     /**
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_time(buf: glibtop_proc_time, pid: number): void;
+    function glibtop_get_proc_time(buf: glibtop_proc_time, pid: never): void;
 
     /**
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_uid(buf: glibtop_proc_uid, pid: number): void;
+    function glibtop_get_proc_uid(buf: glibtop_proc_uid, pid: never): void;
 
     /**
      * @param buf 
      * @param pid 
      */
-    function glibtop_get_proc_wd(buf: glibtop_proc_wd, pid: number): string[];
+    function glibtop_get_proc_wd(buf: glibtop_proc_wd, pid: never): string[];
 
     /**
      * @param buf a {@link GTop.glibtop_proclist}
@@ -937,7 +937,7 @@ export namespace GTop {
      * @param arg an argument specific for the process type
      * @returns an array of process     ids
      */
-    function glibtop_get_proclist(buf: glibtop_proclist, which: bigint | number, arg: bigint | number): number[];
+    function glibtop_get_proclist(buf: glibtop_proclist, which: bigint | number, arg: bigint | number): never[];
 
     /**
      * @param buf 
@@ -1025,15 +1025,15 @@ export namespace GTop {
 
         server_port: number;
 
-        pid: number;
+        pid: never;
 
-        uid: number;
+        uid: never;
 
-        euid: number;
+        euid: never;
 
-        gid: number;
+        gid: never;
 
-        egid: number;
+        egid: never;
 
         ndisk: number;
 
@@ -1100,94 +1100,94 @@ export namespace GTop {
          * @param buf 
          * @param pid 
          */
-        static get_proc_affinity(buf: glibtop_proc_affinity, pid: number): number;
+        static get_proc_affinity(buf: glibtop_proc_affinity, pid: never): number;
 
         /**
          * @param buf 
          * @param pid 
          * @param max_len 
          */
-        static get_proc_args(buf: glibtop_proc_args, pid: number, max_len: number): string;
+        static get_proc_args(buf: glibtop_proc_args, pid: never, max_len: number): string;
 
         /**
          * @param buf 
          * @param pid 
          * @param max_len 
          */
-        static get_proc_argv(buf: glibtop_proc_args, pid: number, max_len: number): string[];
+        static get_proc_argv(buf: glibtop_proc_args, pid: never, max_len: number): string[];
 
         /**
          * @param buf 
          * @param pid 
          */
-        static get_proc_io(buf: glibtop_proc_io, pid: number): void;
+        static get_proc_io(buf: glibtop_proc_io, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        static get_proc_kernel(buf: glibtop_proc_kernel, pid: number): void;
+        static get_proc_kernel(buf: glibtop_proc_kernel, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        static get_proc_map(buf: glibtop_proc_map, pid: number): glibtop_map_entry[];
+        static get_proc_map(buf: glibtop_proc_map, pid: never): glibtop_map_entry[];
 
         /**
          * @param buf 
          * @param pid 
          */
-        static get_proc_mem(buf: glibtop_proc_mem, pid: number): void;
+        static get_proc_mem(buf: glibtop_proc_mem, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        static get_proc_open_files(buf: glibtop_proc_open_files, pid: number): glibtop_open_files_entry[];
+        static get_proc_open_files(buf: glibtop_proc_open_files, pid: never): glibtop_open_files_entry[];
 
         /**
          * @param buf 
          * @param pid 
          */
-        static get_proc_segment(buf: glibtop_proc_segment, pid: number): void;
+        static get_proc_segment(buf: glibtop_proc_segment, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        static get_proc_signal(buf: glibtop_proc_signal, pid: number): void;
+        static get_proc_signal(buf: glibtop_proc_signal, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        static get_proc_state(buf: glibtop_proc_state, pid: number): void;
+        static get_proc_state(buf: glibtop_proc_state, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        static get_proc_time(buf: glibtop_proc_time, pid: number): void;
+        static get_proc_time(buf: glibtop_proc_time, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        static get_proc_uid(buf: glibtop_proc_uid, pid: number): void;
+        static get_proc_uid(buf: glibtop_proc_uid, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        static get_proc_wd(buf: glibtop_proc_wd, pid: number): string[];
+        static get_proc_wd(buf: glibtop_proc_wd, pid: never): string[];
 
         /**
          * @param buf a {@link GTop.glibtop_proclist}
          * @param which a #GLIBTOP_* constant specifying process type
          * @param arg an argument specific for the process type
          */
-        static get_proclist(buf: glibtop_proclist, which: bigint | number, arg: bigint | number): number[];
+        static get_proclist(buf: glibtop_proclist, which: bigint | number, arg: bigint | number): never[];
 
         /**
          * @param buf 
@@ -1380,144 +1380,144 @@ export namespace GTop {
          * @param buf 
          * @param pid 
          */
-        get_proc_affinity_l(buf: glibtop_proc_affinity, pid: number): number;
+        get_proc_affinity_l(buf: glibtop_proc_affinity, pid: never): number;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_affinity_s(buf: glibtop_proc_affinity, pid: number): number;
+        get_proc_affinity_s(buf: glibtop_proc_affinity, pid: never): number;
 
         /**
          * @param buf 
          * @param pid 
          * @param max_len 
          */
-        get_proc_args_l(buf: glibtop_proc_args, pid: number, max_len: number): string;
+        get_proc_args_l(buf: glibtop_proc_args, pid: never, max_len: number): string;
 
         /**
          * @param buf 
          * @param pid 
          * @param max_len 
          */
-        get_proc_args_s(buf: glibtop_proc_args, pid: number, max_len: number): string;
+        get_proc_args_s(buf: glibtop_proc_args, pid: never, max_len: number): string;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_io_l(buf: glibtop_proc_io, pid: number): void;
+        get_proc_io_l(buf: glibtop_proc_io, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_io_s(buf: glibtop_proc_io, pid: number): void;
+        get_proc_io_s(buf: glibtop_proc_io, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_kernel_l(buf: glibtop_proc_kernel, pid: number): void;
+        get_proc_kernel_l(buf: glibtop_proc_kernel, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_kernel_s(buf: glibtop_proc_kernel, pid: number): void;
+        get_proc_kernel_s(buf: glibtop_proc_kernel, pid: never): void;
 
         /**
          * @param pid 
          */
-        get_proc_map_l(pid: number): [glibtop_map_entry[], glibtop_proc_map];
+        get_proc_map_l(pid: never): [glibtop_map_entry[], glibtop_proc_map];
 
         /**
          * @param pid 
          */
-        get_proc_map_s(pid: number): [glibtop_map_entry[], glibtop_proc_map];
+        get_proc_map_s(pid: never): [glibtop_map_entry[], glibtop_proc_map];
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_mem_l(buf: glibtop_proc_mem, pid: number): void;
+        get_proc_mem_l(buf: glibtop_proc_mem, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_mem_s(buf: glibtop_proc_mem, pid: number): void;
+        get_proc_mem_s(buf: glibtop_proc_mem, pid: never): void;
 
         /**
          * @param pid 
          */
-        get_proc_open_files_l(pid: number): [glibtop_open_files_entry[], glibtop_proc_open_files];
+        get_proc_open_files_l(pid: never): [glibtop_open_files_entry[], glibtop_proc_open_files];
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_open_files_s(buf: glibtop_proc_open_files, pid: number): glibtop_open_files_entry;
+        get_proc_open_files_s(buf: glibtop_proc_open_files, pid: never): glibtop_open_files_entry;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_segment_l(buf: glibtop_proc_segment, pid: number): void;
+        get_proc_segment_l(buf: glibtop_proc_segment, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_segment_s(buf: glibtop_proc_segment, pid: number): void;
+        get_proc_segment_s(buf: glibtop_proc_segment, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_signal_l(buf: glibtop_proc_signal, pid: number): void;
+        get_proc_signal_l(buf: glibtop_proc_signal, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_signal_s(buf: glibtop_proc_signal, pid: number): void;
+        get_proc_signal_s(buf: glibtop_proc_signal, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_state_l(buf: glibtop_proc_state, pid: number): void;
+        get_proc_state_l(buf: glibtop_proc_state, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_state_s(buf: glibtop_proc_state, pid: number): void;
+        get_proc_state_s(buf: glibtop_proc_state, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_time_l(buf: glibtop_proc_time, pid: number): void;
+        get_proc_time_l(buf: glibtop_proc_time, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_time_s(buf: glibtop_proc_time, pid: number): void;
+        get_proc_time_s(buf: glibtop_proc_time, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_uid_l(buf: glibtop_proc_uid, pid: number): void;
+        get_proc_uid_l(buf: glibtop_proc_uid, pid: never): void;
 
         /**
          * @param buf 
          * @param pid 
          */
-        get_proc_uid_s(buf: glibtop_proc_uid, pid: number): void;
+        get_proc_uid_s(buf: glibtop_proc_uid, pid: never): void;
 
         /**
          * @param buf a {@link GTop.glibtop_proclist}
@@ -1525,7 +1525,7 @@ export namespace GTop {
          * @param arg an argument specific for the process type
          * @returns an array of process     ids
          */
-        get_proclist_l(buf: glibtop_proclist, which: bigint | number, arg: bigint | number): number[];
+        get_proclist_l(buf: glibtop_proclist, which: bigint | number, arg: bigint | number): never[];
 
         /**
          * @param buf a {@link GTop.glibtop_proclist}
@@ -1533,7 +1533,7 @@ export namespace GTop {
          * @param arg an argument specific for the process type
          * @returns an array of process     ids
          */
-        get_proclist_s(buf: glibtop_proclist, which: bigint | number, arg: bigint | number): number[];
+        get_proclist_s(buf: glibtop_proclist, which: bigint | number, arg: bigint | number): never[];
 
         /**
          * @param buf 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@girs/gtop-2.0",
-    "version": "4.2.0",
+    "version": "4.4.0",
     "description": "GJS TypeScript type definitions for GTop-2.0",
     "type": "module",
     "module": "gtop-2.0.js",
@@ -31,9 +31,9 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "^4.2.0",
-      "@girs/gobject-2.0": "^4.2.0",
-      "@girs/glib-2.0": "^4.2.0"    },
+      "@girs/gjs": "^4.4.0",
+      "@girs/gobject-2.0": "^4.4.0",
+      "@girs/glib-2.0": "^4.4.0"    },
     "devDependencies": {
       "typescript": "*"
     },