@girs/cally-8 4.4.0 → 4.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +36 -41
  2. package/cally-8.d.ts +4 -4
  3. package/package.json +18 -18
package/README.md CHANGED
@@ -4,82 +4,77 @@
4
4
  ![version](https://img.shields.io/npm/v/@girs/cally-8)
5
5
  ![downloads/week](https://img.shields.io/npm/dw/@girs/cally-8)
6
6
 
7
+ GJS TypeScript type definitions for Cally-8 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.6.0.
7
8
 
8
- GJS TypeScript type definitions for Cally-8 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.4.0.
9
+ This package contains type declarations only. It ships no runtime code, so it adds
10
+ nothing to your program and works with any bundler or none at all.
9
11
 
10
12
  ## Install
11
13
 
12
- Install the type definitions with npm:
13
14
  ```bash
14
15
  npm install @girs/cally-8
15
16
  ```
16
17
 
17
- ## Usage
18
+ Any package manager works. The package has no dependencies beyond other `@girs/*`
19
+ type packages.
20
+
21
+ ## What it exports
22
+
23
+ | Import | What you get |
24
+ |---|---|
25
+ | `@girs/cally-8` | the namespace as a default export, plus the ambient and global declarations |
26
+ | `@girs/cally-8/ambient` | only the `gi://` module declarations |
27
+ | `@girs/cally-8/import` | only the `imports.gi` declarations |
28
+ | `@girs/cally-8/cally-8` | the namespace, without the side-effecting declarations |
29
+
30
+ ## Three ways to import
31
+
32
+ Which one you use depends on how you write imports elsewhere, not on your toolchain.
33
+
34
+ ### As a module
18
35
 
19
- Import it like any other module:
20
36
  ```ts
21
37
  import Cally from '@girs/cally-8';
22
38
  ```
23
39
 
24
- ### Ambient Modules
40
+ ### As `gi://`
25
41
 
26
- [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.
27
- For this you need to include `@girs/cally-8` or `@girs/cally-8/ambient` in your `tsconfig` or entry point Typescript file:
42
+ GJS resolves `gi://` at runtime. To give it types, reference the package once, either
43
+ from your entry point or from `tsconfig.json`:
28
44
 
29
- `index.ts`:
30
45
  ```ts
31
- import '@girs/cally-8'
46
+ import '@girs/cally-8';
32
47
  ```
33
48
 
34
- `tsconfig.json`:
35
49
  ```json
36
- {
37
- "compilerOptions": {
38
- ...
39
- },
40
- "include": ["@girs/cally-8"],
41
- ...
42
- }
50
+ { "include": ["@girs/cally-8"] }
43
51
  ```
44
52
 
45
- The ambient module now resolves with types:
53
+ Then the runtime spelling type-checks:
46
54
 
47
55
  ```ts
48
56
  import Cally from 'gi://Cally?version=8';
49
57
  ```
50
58
 
51
- ### Global import
52
-
53
- GJS's global `imports.gi` works too, with types.
54
- For this you need to include `@girs/cally-8` or `@girs/cally-8/import` in your `tsconfig` or entry point Typescript file:
59
+ Referencing `@girs/cally-8/ambient` instead pulls in these declarations
60
+ alone. See [ambient modules](https://github.com/gjsify/ts-for-gir/tree/main/packages/cli#ambient-modules).
55
61
 
56
- `index.ts`:
57
- ```ts
58
- import '@girs/cally-8'
59
- ```
60
-
61
- `tsconfig.json`:
62
- ```json
63
- {
64
- "compilerOptions": {
65
- ...
66
- },
67
- "include": ["@girs/cally-8"],
68
- ...
69
- }
70
- ```
62
+ ### As `imports.gi`
71
63
 
72
- That form carries types as well:
64
+ GJS's global object works the same way, via `@girs/cally-8/import`:
73
65
 
74
66
  ```ts
75
67
  const Cally = imports.gi.Cally;
76
68
  ```
77
69
 
78
- ### Bundle
70
+ ## Building
79
71
 
80
- 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.
72
+ The declarations need no build step. If you bundle, every bundler works, since there is
73
+ no runtime code to resolve. The [examples](https://github.com/gjsify/ts-for-gir/tree/main/examples)
74
+ show working setups for several.
81
75
 
82
76
  ## Other packages
83
77
 
84
- All existing pre-generated packages can be found on [gjsify/types](https://github.com/gjsify/types).
78
+ Every pre-generated package is at [gjsify/types](https://github.com/gjsify/types).
79
+
85
80
 
package/cally-8.d.ts CHANGED
@@ -65,7 +65,7 @@ export namespace Cally {
65
65
 
66
66
  namespace Actor {
67
67
  // Signal signatures
68
- interface SignalSignatures extends Atk.GObjectAccessible.SignalSignatures {
68
+ interface SignalSignatures extends Atk.GObjectAccessible.SignalSignatures, Atk.Component.SignalSignatures {
69
69
  "notify::accessible-component-layer": (pspec: GObject.ParamSpec) => void;
70
70
  "notify::accessible-component-mdi-zorder": (pspec: GObject.ParamSpec) => void;
71
71
  "notify::accessible-description": (pspec: GObject.ParamSpec) => void;
@@ -665,7 +665,7 @@ export namespace Cally {
665
665
 
666
666
  namespace Clone {
667
667
  // Signal signatures
668
- interface SignalSignatures extends Actor.SignalSignatures {
668
+ interface SignalSignatures extends Actor.SignalSignatures, Atk.Component.SignalSignatures {
669
669
  "notify::accessible-component-layer": (pspec: GObject.ParamSpec) => void;
670
670
  "notify::accessible-component-mdi-zorder": (pspec: GObject.ParamSpec) => void;
671
671
  "notify::accessible-description": (pspec: GObject.ParamSpec) => void;
@@ -1302,7 +1302,7 @@ export namespace Cally {
1302
1302
 
1303
1303
  namespace Stage {
1304
1304
  // Signal signatures
1305
- interface SignalSignatures extends Actor.SignalSignatures {
1305
+ interface SignalSignatures extends Actor.SignalSignatures, Atk.Component.SignalSignatures, Atk.Window.SignalSignatures {
1306
1306
  "notify::accessible-component-layer": (pspec: GObject.ParamSpec) => void;
1307
1307
  "notify::accessible-component-mdi-zorder": (pspec: GObject.ParamSpec) => void;
1308
1308
  "notify::accessible-description": (pspec: GObject.ParamSpec) => void;
@@ -1873,7 +1873,7 @@ export namespace Cally {
1873
1873
 
1874
1874
  namespace Text {
1875
1875
  // Signal signatures
1876
- interface SignalSignatures extends Actor.SignalSignatures {
1876
+ interface SignalSignatures extends Actor.SignalSignatures, Atk.Component.SignalSignatures, Atk.Text.SignalSignatures {
1877
1877
  "notify::accessible-component-layer": (pspec: GObject.ParamSpec) => void;
1878
1878
  "notify::accessible-component-mdi-zorder": (pspec: GObject.ParamSpec) => void;
1879
1879
  "notify::accessible-description": (pspec: GObject.ParamSpec) => void;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@girs/cally-8",
3
- "version": "4.4.0",
3
+ "version": "4.6.0",
4
4
  "description": "GJS TypeScript type definitions for Cally-8",
5
5
  "type": "module",
6
6
  "module": "cally-8.js",
@@ -31,23 +31,23 @@
31
31
  "test": "tsc --project tsconfig.json"
32
32
  },
33
33
  "dependencies": {
34
- "@girs/gjs": "^4.4.0",
35
- "@girs/coglpango-8": "^4.4.0",
36
- "@girs/pangocairo-1.0": "^4.4.0",
37
- "@girs/cairo-1.0": "^4.4.0",
38
- "@girs/gobject-2.0": "^4.4.0",
39
- "@girs/glib-2.0": "^4.4.0",
40
- "@girs/pango-1.0": "^4.4.0",
41
- "@girs/harfbuzz-0.0": "^4.4.0",
42
- "@girs/freetype2-2.0": "^4.4.0",
43
- "@girs/gio-2.0": "^4.4.0",
44
- "@girs/gmodule-2.0": "^4.4.0",
45
- "@girs/cogl-8": "^4.4.0",
46
- "@girs/graphene-1.0": "^4.4.0",
47
- "@girs/gl-1.0": "^4.4.0",
48
- "@girs/clutter-8": "^4.4.0",
49
- "@girs/json-1.0": "^4.4.0",
50
- "@girs/atk-1.0": "^4.4.0" },
34
+ "@girs/gjs": "^4.6.0",
35
+ "@girs/coglpango-8": "^4.6.0",
36
+ "@girs/pangocairo-1.0": "^4.6.0",
37
+ "@girs/cairo-1.0": "^4.6.0",
38
+ "@girs/gobject-2.0": "^4.6.0",
39
+ "@girs/glib-2.0": "^4.6.0",
40
+ "@girs/pango-1.0": "^4.6.0",
41
+ "@girs/harfbuzz-0.0": "^4.6.0",
42
+ "@girs/freetype2-2.0": "^4.6.0",
43
+ "@girs/gio-2.0": "^4.6.0",
44
+ "@girs/gmodule-2.0": "^4.6.0",
45
+ "@girs/cogl-8": "^4.6.0",
46
+ "@girs/graphene-1.0": "^4.6.0",
47
+ "@girs/gl-1.0": "^4.6.0",
48
+ "@girs/clutter-8": "^4.6.0",
49
+ "@girs/json-1.0": "^4.6.0",
50
+ "@girs/atk-1.0": "^4.6.0" },
51
51
  "devDependencies": {
52
52
  "typescript": "*"
53
53
  },