@girs/gio-2.0 2.76.1-3.0.0-beta.13 → 2.76.1-3.0.0-beta.15

package/README.md

@@ -1,13 +1,13 @@
 
 # Gio-2.0
 
-GJS TypeScript type definitions for Gio-2.0, generated from library version 2.76.1 using [ts-for-gir](https://github.com/gjsify/ts-for-gjs) v3.0.0-beta.13.
+GJS TypeScript type definitions for Gio-2.0, generated from library version 2.76.1 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.0.0-beta.15.
 
 GIO provides a modern and easy-to-use VFS API. It provides a file system abstraction which allows applications to access local and remote files with a single consistent API.
 
 ## Install
 
-To use this type definitions, install them with NPM like this:
+To use this type definitions, install them with NPM:
 ```bash
 npm install @girs/gio-2.0
 ```
@@ -24,10 +24,66 @@ Or if you prefer CommonJS, you can also use this:
 const Gio = require('@girs/gio-2.0');
 ```
 
-If you use [ambient modules](https://github.com/gjsify/ts-for-gir/tree/main/packages/cli#ambient-modules), you can also import this module like you would do this in JavaScript:
+### 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.
+For this you need to include `@girs/gio-2.0` or `@girs/gio-2.0/ambient` in your `tsconfig` or entry point Typescript file:
+
+`index.ts`:
+```ts
+import '@girs/gio-2.0'
+```
+
+`tsconfig.json`:
+```json
+{
+  "compilerOptions": {
+    ...
+  },
+  "include": ["@girs/gio-2.0"],
+  ...
+}
+```
+
+Now you can import the ambient module with TypeScript support: 
 
 ```ts
 import Gio from 'gi://Gio?version=2.0';
 ```
 
-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).
+
+### Global import
+
+You can also import the module with Typescript support using the global `imports.gi` object of GJS.
+For this you need to include `@girs/gio-2.0` or `@girs/gio-2.0/import` in your `tsconfig` or entry point Typescript file:
+
+`index.ts`:
+```ts
+import '@girs/gio-2.0'
+```
+
+`tsconfig.json`:
+```json
+{
+  "compilerOptions": {
+    ...
+  },
+  "include": ["@girs/gio-2.0"],
+  ...
+}
+```
+
+Now you have also type support for this, too:
+
+```ts
+const Gio = imports.gi.Gio;
+```
+
+### 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).
+
+## Other packages
+
+All existing pre-generated packages can be found on [gjsify/types](https://github.com/gjsify/types).
+

package/gio-2.0-ambient.d.ts

@@ -0,0 +1,13 @@
+
+
+declare module 'gi://Gio?version=2.0' {
+    import Gio20 from '@girs/gio-2.0';
+    export default Gio20;
+}
+
+declare module 'gi://Gio' {
+    import Gio20 from '@girs/gio-2.0';
+    export default Gio20;
+}
+
+

package/gio-2.0-import.d.ts

@@ -0,0 +1,13 @@
+
+
+import Gio20 from '@girs/gio-2.0';
+
+declare global {
+    export interface GjsGiImports {
+        Gio: typeof Gio20;
+    }
+}
+
+export default GjsGiImports;
+
+

package/gio-2.0.cjs

@@ -7,3 +7,5 @@
   
 
 
+
+

package/gio-2.0.d.cts

@@ -3,8 +3,11 @@
  * 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
+ * If you found a bug fix it in `ts-for-gir` or create a bug report on https://github.com/gjsify/ts-for-gir
  */
+
+import './gio-2.0-ambient.d.ts';
+import './gio-2.0-import.d.ts';
 /**
  * Gio-2.0
  */

package/gio-2.0.d.ts

@@ -3,8 +3,11 @@
  * 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
+ * If you found a bug fix it in `ts-for-gir` or create a bug report on https://github.com/gjsify/ts-for-gir
  */
+
+import './gio-2.0-ambient.d.ts';
+import './gio-2.0-import.d.ts';
 /**
  * Gio-2.0
  */

package/gio-2.0.js

@@ -6,3 +6,5 @@
   export default Gio;
 
 
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@girs/gio-2.0",
-  "version": "2.76.1-3.0.0-beta.13",
+  "version": "2.76.1-3.0.0-beta.15",
   "description": "GJS TypeScript type definitions for Gio-2.0, generated from library version 2.76.1",
   "type": "module",
   "module": "gio-2.0.js",
@@ -12,6 +12,8 @@
     "tsconfig": "./tsconfig.doc.json"
   },
   "exports": {
+    "./ambient": "./gio-2.0-ambient.d.ts",
+    "./import": "./gio-2.0-import.d.ts",
     ".": {
       "import": {
         "types": "./gio-2.0.d.ts",
@@ -29,8 +31,8 @@
     "test:cjs": "tsc --noEmit gio-2.0.d.cts"
   },
   "dependencies": {
-    "@girs/glib-2.0": "^2.76.1-3.0.0-beta.13",
-    "@girs/gobject-2.0": "^2.76.1-3.0.0-beta.13"
+    "@girs/gobject-2.0": "^2.76.1-3.0.0-beta.15",
+    "@girs/glib-2.0": "^2.76.1-3.0.0-beta.15"
   },
   "devDependencies": {
     "typescript": "^5.0.4"

package/tsconfig.doc.json

@@ -17,3 +17,5 @@
   },
   "include": ["./gio-2.0.d.ts"]
 }
+
+