@girs/glib-2.0 2.76.1-3.0.0-beta.14 → 2.76.1-3.0.0-beta.15

package/README.md

@@ -1,13 +1,13 @@
 
 # GLib-2.0
 
-GJS TypeScript type definitions for GLib-2.0, generated from library version 2.76.1 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.0.0-beta.14.
+GJS TypeScript type definitions for GLib-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.
 
 GLib provides the core application building blocks for libraries and applications written in C. It provides the core object system used in GNOME, the main loop implementation, and a large set of utility functions for strings and common data structures.
 
 ## 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/glib-2.0
 ```
@@ -24,14 +24,66 @@ Or if you prefer CommonJS, you can also use this:
 const GLib = require('@girs/glib-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/glib-2.0` or `@girs/glib-2.0/ambient` in your `tsconfig` or entry point Typescript file:
+
+`index.ts`:
+```ts
+import '@girs/glib-2.0'
+```
+
+`tsconfig.json`:
+```json
+{
+  "compilerOptions": {
+    ...
+  },
+  "include": ["@girs/glib-2.0"],
+  ...
+}
+```
+
+Now you can import the ambient module with TypeScript support: 
 
 ```ts
 import GLib from 'gi://GLib?version=2.0';
 ```
 
+
+### 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/glib-2.0` or `@girs/glib-2.0/import` in your `tsconfig` or entry point Typescript file:
+
+`index.ts`:
+```ts
+import '@girs/glib-2.0'
+```
+
+`tsconfig.json`:
+```json
+{
+  "compilerOptions": {
+    ...
+  },
+  "include": ["@girs/glib-2.0"],
+  ...
+}
+```
+
+Now you have also type support for this, too:
+
+```ts
+const GLib = imports.gi.GLib;
+```
+
+### 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).
+All existing pre-generated packages can be found on [gjsify/types](https://github.com/gjsify/types).
+

package/glib-2.0-ambient.d.ts

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

package/glib-2.0-import.d.ts

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

package/glib-2.0.cjs

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

package/glib-2.0.d.cts

@@ -5,6 +5,9 @@
  * 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-gir
  */
+
+import './glib-2.0-ambient.d.ts';
+import './glib-2.0-import.d.ts';
 /**
  * GLib-2.0
  */

package/glib-2.0.d.ts

@@ -5,6 +5,9 @@
  * 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-gir
  */
+
+import './glib-2.0-ambient.d.ts';
+import './glib-2.0-import.d.ts';
 /**
  * GLib-2.0
  */

package/glib-2.0.js

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

package/package.json

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

package/tsconfig.doc.json

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