@girs/gcrui-3 4.9.0 → 5.1.0

package/README.md

@@ -4,7 +4,7 @@
 ![version](https://img.shields.io/npm/v/@girs/gcrui-3)
 ![downloads/week](https://img.shields.io/npm/dw/@girs/gcrui-3)
 
-GJS TypeScript type definitions for GcrUi-3 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.9.0.
+GJS TypeScript type definitions for GcrUi-3 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v5.1.0.
 
 This package contains type declarations only. It ships no runtime code, so it adds
 nothing to your program and works with any bundler or none at all.

package/gcrui-3-vocabulary.d.ts

@@ -413,6 +413,45 @@ export const FLAG_VALUES_UNREADABLE: Readonly<Record<string, string>>;
  */
 export const PROP_ENUMS: Readonly<Record<string, string>>;
 
+/**
+ * The kinds of value a GTK accessible property, relation or state takes.
+ *
+ * `enum` is the one that needs a second lookup: `ARIA_VALUE_ENUMS` names the enum GType,
+ * and `ENUM_NICKS` and `ENUM_VALUES` answer from there.
+ */
+export type AriaValueType = 'string' | 'integer' | 'double' | 'boolean' | 'reference' | 'enum';
+
+/**
+ * `<enum GType>.<nick>` -> the kind of value that ARIA slot takes.
+ *
+ * The one table in this file that is not a fact about a ParamSpec. A GtkBuilder or
+ * Blueprint `accessibility { … }` block is typed by GTK's ARIA table, not by the widget,
+ * and the two disagree where it costs most: `orientation` is settable on a `GtkLabel`
+ * that implements no `GtkOrientable`, and `checked` is a `GtkAccessibleTristate`, so
+ * `checked: true` is the number 1 rather than a boolean. Typing those slots from the
+ * widget's properties gets both wrong and raises nothing.
+ *
+ * Keyed like `ENUM_VALUES` because the ARIA names ARE enum members — of
+ * `GtkAccessibleProperty`, `GtkAccessibleRelation` and `GtkAccessibleState` — so
+ * `ENUM_NICKS` already lists them and one key parser reads both.
+ *
+ * Read from each member's own GIR documentation. `gtk_accessible_property_init_value()`
+ * is the C half of this table and is not introspectable; the doc sentence is, and states
+ * the type for 52 of the 53 members in gtk4 4.23.3. Complete or absent, never partial: a
+ * member the generator cannot answer for fails the build and names itself.
+ */
+export const ARIA_VALUE_TYPES: Readonly<Record<string, AriaValueType>>;
+
+/**
+ * The same keys, for the `'enum'` rows only -> the GType of that enum.
+ *
+ * A table of its own for the reason `PROP_ENUMS` is one: folded in, the values of
+ * `ARIA_VALUE_TYPES` would be six reserved words mixed with arbitrary GTypes and telling
+ * them apart would be the consumer's problem. Apart, `ARIA_VALUE_TYPES[k] === 'enum'` is
+ * the whole test and `ENUM_NICKS[ARIA_VALUE_ENUMS[k]]` is the nick list.
+ */
+export const ARIA_VALUE_ENUMS: Readonly<Record<string, string>>;
+
 /** Widget GType -> slot name -> the method that may adopt a child there. */
 export const SLOT_CANDIDATES: Readonly<Record<string, Readonly<Record<string, string>>>>;
 

package/gcrui-3-vocabulary.js

@@ -126,6 +126,31 @@ export const FLAG_VALUES_UNREADABLE = {};
 // vocabulary loaded too. Owners that emit none (Gdk, Pango) are inlined into the tables above.
 export const PROP_ENUMS = {};
 
+// `<enum GType>.<nick>` -> the kind of value that ARIA slot takes.
+//
+// The one table here that is not about a ParamSpec. A GtkBuilder or Blueprint
+// `accessibility { … }` block is typed by GTK's ARIA table instead, and the two disagree
+// where it matters: `orientation` is settable on a `GtkLabel` that implements no
+// `GtkOrientable` and has no such property, and `checked` is a `GtkAccessibleTristate`, so
+// `checked: true` means the number 1 and not the boolean. A consumer typing those slots
+// from the widget gets both wrong, silently.
+//
+// Read from each member's own documentation, which is where GTK keeps the table --
+// `gtk_accessible_property_init_value()` is the C half and is not introspectable, the
+// sentence is. Complete or absent, never partial: a member whose documentation states no
+// value type fails generation and names itself, because a missing row is indistinguishable
+// from "GTK has no such name" and the plausible fallback emits `true` where GTK means 1.
+export const ARIA_VALUE_TYPES = {};
+
+// The same keys, for the `'enum'` rows only -> the GType of the enum.
+//
+// The join on from a kind to a number, and a table of its own for the reason `PROP_ENUMS`
+// is one: folding the GType into `ARIA_VALUE_TYPES` would make its values a mix of six
+// reserved words and arbitrary GTypes, and telling them apart would be the consumer's
+// problem. With this, `ARIA_VALUE_TYPES[k] === 'enum'` is the whole test, and
+// `ENUM_NICKS[ARIA_VALUE_ENUMS[k]]` is the nick list.
+export const ARIA_VALUE_ENUMS = {};
+
 export const SLOT_CANDIDATES = {};
 
 export const SINCE = {};

package/gcrui-3.d.ts

@@ -162,15 +162,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof CertificateRenderer.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, CertificateRenderer.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof CertificateRenderer.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, CertificateRenderer.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof CertificateRenderer.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<CertificateRenderer.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof CertificateRenderer.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<CertificateRenderer.SignalSignatures[K]>): void;
 
         // Methods
         /**
@@ -608,15 +605,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof CertificateWidget.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, CertificateWidget.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof CertificateWidget.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, CertificateWidget.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof CertificateWidget.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<CertificateWidget.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof CertificateWidget.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<CertificateWidget.SignalSignatures[K]>): void;
 
         // Methods
         /**
@@ -713,15 +707,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof CollectionModel.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, CollectionModel.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof CollectionModel.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, CollectionModel.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof CollectionModel.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<CollectionModel.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof CollectionModel.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<CollectionModel.SignalSignatures[K]>): void;
 
         // Methods
         /**
@@ -1494,15 +1485,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof ComboSelector.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, ComboSelector.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof ComboSelector.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, ComboSelector.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof ComboSelector.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<ComboSelector.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof ComboSelector.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<ComboSelector.SignalSignatures[K]>): void;
 
         // Methods
         /**
@@ -1877,15 +1865,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof FailureRenderer.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, FailureRenderer.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof FailureRenderer.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, FailureRenderer.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof FailureRenderer.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<FailureRenderer.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof FailureRenderer.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<FailureRenderer.SignalSignatures[K]>): void;
 
         // Static methods
         /**
@@ -2059,15 +2044,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof ImportButton.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, ImportButton.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof ImportButton.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, ImportButton.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof ImportButton.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<ImportButton.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof ImportButton.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<ImportButton.SignalSignatures[K]>): void;
 
         // Virtual methods
         /**
@@ -2497,15 +2479,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof KeyRenderer.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, KeyRenderer.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof KeyRenderer.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, KeyRenderer.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof KeyRenderer.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<KeyRenderer.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof KeyRenderer.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<KeyRenderer.SignalSignatures[K]>): void;
 
         // Methods
         /**
@@ -2672,15 +2651,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof KeyWidget.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, KeyWidget.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof KeyWidget.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, KeyWidget.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof KeyWidget.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<KeyWidget.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof KeyWidget.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<KeyWidget.SignalSignatures[K]>): void;
 
         // Methods
         /**
@@ -2812,15 +2788,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof ListSelector.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, ListSelector.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof ListSelector.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, ListSelector.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof ListSelector.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<ListSelector.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof ListSelector.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<ListSelector.SignalSignatures[K]>): void;
 
         // Methods
         /**
@@ -3174,15 +3147,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof PromptDialog.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, PromptDialog.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof PromptDialog.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, PromptDialog.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof PromptDialog.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<PromptDialog.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof PromptDialog.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<PromptDialog.SignalSignatures[K]>): void;
 
         /**
          * The string handle of the caller's window.
@@ -3881,15 +3851,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof SecureEntryBuffer.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, SecureEntryBuffer.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof SecureEntryBuffer.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, SecureEntryBuffer.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof SecureEntryBuffer.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<SecureEntryBuffer.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof SecureEntryBuffer.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<SecureEntryBuffer.SignalSignatures[K]>): void;
     }
 
 
@@ -4009,15 +3976,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof TreeSelector.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, TreeSelector.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof TreeSelector.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, TreeSelector.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof TreeSelector.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<TreeSelector.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof TreeSelector.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<TreeSelector.SignalSignatures[K]>): void;
 
         // Methods
         /**
@@ -4282,15 +4246,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof UnlockOptionsWidget.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, UnlockOptionsWidget.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof UnlockOptionsWidget.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, UnlockOptionsWidget.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof UnlockOptionsWidget.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<UnlockOptionsWidget.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof UnlockOptionsWidget.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<UnlockOptionsWidget.SignalSignatures[K]>): void;
 
         // Methods
         /**
@@ -4491,15 +4452,12 @@ export namespace GcrUi {
         // Signals
         /** @signal */
         connect<K extends keyof ViewerWidget.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, ViewerWidget.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
         connect_after<K extends keyof ViewerWidget.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, ViewerWidget.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
 
         /** @signal */
-        emit<K extends keyof ViewerWidget.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<ViewerWidget.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof ViewerWidget.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<ViewerWidget.SignalSignatures[K]>): void;
 
         // Methods
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@girs/gcrui-3",
-    "version": "4.9.0",
+    "version": "5.1.0",
     "description": "GJS TypeScript type definitions for GcrUi-3",
     "type": "module",
     "module": "gcrui-3.js",
@@ -36,22 +36,22 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "^4.9.0",
-      "@girs/gtk-3.0": "^4.9.0",
-      "@girs/xlib-2.0": "^4.9.0",
-      "@girs/gdk-3.0": "^4.9.0",
-      "@girs/cairo-1.0": "^4.9.0",
-      "@girs/gobject-2.0": "^4.9.0",
-      "@girs/glib-2.0": "^4.9.0",
-      "@girs/pango-1.0": "^4.9.0",
-      "@girs/harfbuzz-0.0": "^4.9.0",
-      "@girs/freetype2-2.0": "^4.9.0",
-      "@girs/gio-2.0": "^4.9.0",
-      "@girs/gmodule-2.0": "^4.9.0",
-      "@girs/gdkpixbuf-2.0": "^4.9.0",
-      "@girs/atk-1.0": "^4.9.0",
-      "@girs/gcr-3": "^4.9.0",
-      "@girs/gck-1": "^4.9.0"    },
+      "@girs/gjs": "^5.1.0",
+      "@girs/gtk-3.0": "^5.1.0",
+      "@girs/xlib-2.0": "^5.1.0",
+      "@girs/gdk-3.0": "^5.1.0",
+      "@girs/cairo-1.0": "^5.1.0",
+      "@girs/gobject-2.0": "^5.1.0",
+      "@girs/glib-2.0": "^5.1.0",
+      "@girs/pango-1.0": "^5.1.0",
+      "@girs/harfbuzz-0.0": "^5.1.0",
+      "@girs/freetype2-2.0": "^5.1.0",
+      "@girs/gio-2.0": "^5.1.0",
+      "@girs/gmodule-2.0": "^5.1.0",
+      "@girs/gdkpixbuf-2.0": "^5.1.0",
+      "@girs/atk-1.0": "^5.1.0",
+      "@girs/gcr-3": "^5.1.0",
+      "@girs/gck-1": "^5.1.0"    },
     "devDependencies": {
       "typescript": "*"
     },