@girs/gobject-2.0 2.76.1-3.0.0-beta.14 → 2.76.1-3.0.0-beta.16

package/README.md

@@ -1,13 +1,13 @@
 
 # GObject-2.0
 
-GJS TypeScript type definitions for GObject-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 GObject-2.0, generated from library version 2.76.1 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.0.0-beta.16.
 
 GObject provides the object system used for Pango and GTK+.
 
 ## 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/gobject-2.0
 ```
@@ -24,14 +24,66 @@ Or if you prefer CommonJS, you can also use this:
 const GObject = require('@girs/gobject-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/gobject-2.0` or `@girs/gobject-2.0/ambient` in your `tsconfig` or entry point Typescript file:
+
+`index.ts`:
+```ts
+import '@girs/gobject-2.0'
+```
+
+`tsconfig.json`:
+```json
+{
+  "compilerOptions": {
+    ...
+  },
+  "include": ["@girs/gobject-2.0"],
+  ...
+}
+```
+
+Now you can import the ambient module with TypeScript support: 
 
 ```ts
 import GObject from 'gi://GObject?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/gobject-2.0` or `@girs/gobject-2.0/import` in your `tsconfig` or entry point Typescript file:
+
+`index.ts`:
+```ts
+import '@girs/gobject-2.0'
+```
+
+`tsconfig.json`:
+```json
+{
+  "compilerOptions": {
+    ...
+  },
+  "include": ["@girs/gobject-2.0"],
+  ...
+}
+```
+
+Now you have also type support for this, too:
+
+```ts
+const GObject = imports.gi.GObject;
+```
+
+### 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/gobject-2.0-ambient.d.ts

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

package/gobject-2.0-import.d.ts

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

package/gobject-2.0.cjs

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

package/gobject-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 './gobject-2.0-ambient.d.ts';
+import './gobject-2.0-import.d.ts';
 /**
  * GObject-2.0
  */

package/gobject-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 './gobject-2.0-ambient.d.ts';
+import './gobject-2.0-import.d.ts';
 /**
  * GObject-2.0
  */

package/gobject-2.0.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@girs/gobject-2.0",
-  "version": "2.76.1-3.0.0-beta.14",
+  "version": "2.76.1-3.0.0-beta.16",
   "description": "GJS TypeScript type definitions for GObject-2.0, generated from library version 2.76.1",
   "type": "module",
   "module": "gobject-2.0.js",
@@ -12,6 +12,8 @@
     "tsconfig": "./tsconfig.doc.json"
   },
   "exports": {
+    "./ambient": "./gobject-2.0-ambient.d.ts",
+    "./import": "./gobject-2.0-import.d.ts",
     ".": {
       "import": {
         "types": "./gobject-2.0.d.ts",
@@ -29,7 +31,8 @@
     "test:cjs": "tsc --noEmit gobject-2.0.d.cts"
   },
   "dependencies": {
-    "@girs/glib-2.0": "^2.76.1-3.0.0-beta.14"
+    "@girs/gjs": "^3.0.0-beta.16",
+    "@girs/glib-2.0": "^2.76.1-3.0.0-beta.16"
   },
   "devDependencies": {
     "typescript": "^5.0.4"
@@ -46,7 +49,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/gjsify/ts-for-gir.git"
+    "url": "git+https://github.com/gjsify/types.git"
   },
   "bugs": {
     "url": "https://github.com/gjsify/ts-for-gir/issues"

package/tsconfig.doc.json

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