@girs/amtk-5 5.2.0 → 5.4.0

package/README.md

@@ -4,7 +4,7 @@
 ![version](https://img.shields.io/npm/v/@girs/amtk-5)
 ![downloads/week](https://img.shields.io/npm/dw/@girs/amtk-5)
 
-GJS TypeScript type definitions for Amtk-5 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v5.2.0.
+GJS TypeScript type definitions for Amtk-5 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v5.4.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/amtk-5-vocabulary.d.ts

@@ -1,7 +1,7 @@
 /**
  * The GIR-derived widget VOCABULARY for Amtk-5.
  *
- * GENERATED — do not edit. Provenance: Amtk-5 — dropped empty base(s): GObject.Object GObject.InitiallyUnowned Atk.ImplementorIface
+ * GENERATED — do not edit. Provenance: Amtk-5 — dropped empty base(s): Atk.ImplementorIface
  *
  * 6 instantiable GTypes (of which 1 concrete widgets), 6 declarations, 0 enum nick unions, 0 slot candidates.
  *
@@ -26,6 +26,7 @@
 
 import type Amtk from './amtk-5.js';
 import type Gtk from '@girs/gtk-3.0';
+import type { GInitiallyUnownedConstructOnly, GInitiallyUnownedProps, GObjectConstructOnly, GObjectProps } from '@girs/gobject-2.0/vocabulary';
 import type { GtkBinConstructOnly, GtkBinProps, GtkBuildableConstructOnly, GtkBuildableProps, GtkContainerConstructOnly, GtkContainerProps, GtkScrolledWindowConstructOnly, GtkScrolledWindowProps, GtkWidgetConstructOnly, GtkWidgetProps } from '@girs/gtk-3.0/vocabulary';
 
 // ---------------------------------------------------------------------------
@@ -50,17 +51,17 @@ import type { GtkBinConstructOnly, GtkBinProps, GtkBuildableConstructOnly, GtkBu
 // GIR keeps them once, on the interface.
 // ---------------------------------------------------------------------------
 
-export interface AmtkActionInfoCentralStoreProps {
+export interface AmtkActionInfoCentralStoreProps extends GObjectProps {
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type AmtkActionInfoCentralStoreConstructOnly = never;
+export type AmtkActionInfoCentralStoreConstructOnly = GObjectConstructOnly;
 
-export interface AmtkActionInfoStoreProps {
+export interface AmtkActionInfoStoreProps extends GObjectProps {
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type AmtkActionInfoStoreConstructOnly = never;
+export type AmtkActionInfoStoreConstructOnly = GObjectConstructOnly;
 
-export interface AmtkApplicationWindowProps {
+export interface AmtkApplicationWindowProps extends GObjectProps {
     /**
      * The #GtkApplicationWindow.
      * @since 2.0
@@ -73,9 +74,9 @@ export interface AmtkApplicationWindowProps {
     statusbar?: Gtk.Statusbar | null;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type AmtkApplicationWindowConstructOnly = 'application-window';
+export type AmtkApplicationWindowConstructOnly = GObjectConstructOnly | 'application-window';
 
-export interface AmtkFactoryProps {
+export interface AmtkFactoryProps extends GObjectProps {
     /**
      * The associated #GtkApplication (it is optional, it can be %NULL).
      * @since 3.0
@@ -89,9 +90,9 @@ export interface AmtkFactoryProps {
     'default-flags'?: number;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type AmtkFactoryConstructOnly = 'application';
+export type AmtkFactoryConstructOnly = GObjectConstructOnly | 'application';
 
-export interface AmtkMenuShellProps {
+export interface AmtkMenuShellProps extends GObjectProps {
     /**
      * The #GtkMenuShell.
      * @since 2.0
@@ -99,7 +100,7 @@ export interface AmtkMenuShellProps {
     'menu-shell'?: Gtk.MenuShell;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type AmtkMenuShellConstructOnly = 'menu-shell';
+export type AmtkMenuShellConstructOnly = GObjectConstructOnly | 'menu-shell';
 
 export interface AmtkTreeViewScrolledWindowSizingProps extends GtkScrolledWindowProps, GtkBuildableProps {
     /**
@@ -201,6 +202,30 @@ export const PROVENANCE: {
      * GIRs disagreeing, which is what the main emitter answers `never` for as well.
      */
     readonly unresolvedProps: readonly string[];
+    /**
+     * `c:identifier-prefixes` from the GIR, verbatim and in order — `['G']` for Gio.
+     *
+     * The C prefix a type REFERENCE needs: resolving `Gio.Icon` means producing `GIcon`,
+     * and nothing else in this package states that `Gio` spells itself `G`. Carried rather
+     * than derived because GIR carries it, and a derivation over the `DECLS` keys is wrong
+     * wherever the C prefix is not a prefix of the type NAMES: gdkx11-4.0 and gdkwayland-4.0
+     * both state `Gdk` while every key they declare begins `GdkX11`/`GdkWayland`.
+     *
+     * Empty where the GIR states none — 17 of the 627 emitting namespaces — because
+     * inventing the namespace name there is a confident wrong answer in place of a missing
+     * one. A LIST because 20 of them state more than one, which no single string expresses.
+     */
+    readonly identifierPrefixes: readonly string[];
+    /**
+     * Sibling vocabularies this one's DECLARATIONS come from, as import specifiers.
+     *
+     * A chain link with no `OWN_PROPS` row is ambiguous on its own — `GtkSeparator` has no
+     * settable property, `GApplication` has its properties in another package — and this
+     * list is what tells the two apart. Enum and bitfield NUMBERS are not here: those are
+     * carried in this file, because a `PROP_ENUMS` row naming a foreign GType gives a
+     * consumer nothing to load and a `.ui` file using the property never names its owner.
+     */
+    readonly requiredVocabularies: readonly string[];
 };
 
 /** Declaration GType -> its own settable properties, as GObject registered them. */
@@ -310,6 +335,19 @@ export const FLAG_VALUES_UNREADABLE: Readonly<Record<string, string>>;
  */
 export const PROP_ENUMS: Readonly<Record<string, string>>;
 
+/**
+ * `<declaration GType>.<property>` -> the GType of that property's own type.
+ *
+ * `PROP_ENUMS` one case wider, and separate on purpose: that table promises the GType it names
+ * has NUMBERS, and this one promises only that the GType is the property's. A host inferring a
+ * type from a property — the middle of an uncast lookup chain, an uncast closure's return type —
+ * reads this one; a host resolving a nick to a number reads that one.
+ *
+ * Absent means no GType can be stated, not that the property is scalar: `gchararray` is carried
+ * like any other, so absence is readable as "unknown".
+ */
+export const PROP_TYPES: Readonly<Record<string, string>>;
+
 /**
  * The kinds of value a GTK accessible property, relation or state takes.
  *

package/amtk-5-vocabulary.js

@@ -1,6 +1,6 @@
 // The widget vocabulary of Amtk-5 as runtime data.
 //
-// GENERATED — do not edit. Provenance: Amtk-5 — dropped empty base(s): GObject.Object GObject.InitiallyUnowned Atk.ImplementorIface
+// GENERATED — do not edit. Provenance: Amtk-5 — dropped empty base(s): Atk.ImplementorIface
 //
 // The type half of this subpath is the sibling `.d.ts`. This file exists because
 // types are erased: a consumer that wants to ask the installed library whether every
@@ -11,10 +11,12 @@ export const PROVENANCE = {
     version: '5',
     libraryVersion: null,
     childHolders: 0,
-    droppedBases: ['GObject.Object', 'GObject.InitiallyUnowned', 'Atk.ImplementorIface'],
+    droppedBases: ['Atk.ImplementorIface'],
     inlinedBases: [],
     unsettableProps: [],
     unresolvedProps: [],
+    identifierPrefixes: ['Amtk'],
+    requiredVocabularies: ['@girs/gobject-2.0/vocabulary', '@girs/gtk-3.0/vocabulary'],
 };
 
 export const OWN_PROPS = {
@@ -36,12 +38,12 @@ export const OWN_SIGNALS = {
 // `GtkEventController*` and `GtkCellRenderer*`. Use `Widgets` and `CHILD_HOLDERS`
 // below for the narrower questions; they did not move.
 export const DECLS = {
-    AmtkActionInfoCentralStore: ['AmtkActionInfoCentralStore'],
-    AmtkActionInfoStore: ['AmtkActionInfoStore'],
-    AmtkApplicationWindow: ['AmtkApplicationWindow'],
-    AmtkFactory: ['AmtkFactory'],
-    AmtkMenuShell: ['AmtkMenuShell'],
-    AmtkTreeViewScrolledWindowSizing: ['AmtkTreeViewScrolledWindowSizing', 'GtkScrolledWindow', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
+    AmtkActionInfoCentralStore: ['AmtkActionInfoCentralStore', 'GObject'],
+    AmtkActionInfoStore: ['AmtkActionInfoStore', 'GObject'],
+    AmtkApplicationWindow: ['AmtkApplicationWindow', 'GObject'],
+    AmtkFactory: ['AmtkFactory', 'GObject'],
+    AmtkMenuShell: ['AmtkMenuShell', 'GObject'],
+    AmtkTreeViewScrolledWindowSizing: ['AmtkTreeViewScrolledWindowSizing', 'GtkScrolledWindow', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
 };
 
 // The GTypes above that ARE widgets are the `Widgets` map in the sibling `.d.ts`; these
@@ -138,6 +140,25 @@ export const PROP_ENUMS = {
     'AmtkFactory.default-flags': 'AmtkFactoryFlags',
 };
 
+// `<declaration GType>.<property>` -> the GType of that property's own type.
+//
+// `PROP_ENUMS` one case wider, and a SEPARATE table on purpose. That one is a join with a
+// contract — the GType it names has numbers, in this vocabulary or the owner's — and folding a
+// plain type table in would mix "resolvable to numbers" with "not" and hand the distinction to
+// the consumer. `ARIA_VALUE_ENUMS` beside `ARIA_VALUE_TYPES` is the same split.
+//
+// A row is ABSENT where no GType can be stated: a fundamental spelling outside the generator's
+// closed map, a registered type with no `glib:type-name`, or a property with no `<type>`
+// child. Absence therefore reads as "unknown" and never as "scalar".
+export const PROP_TYPES = {
+    'AmtkApplicationWindow.application-window': 'GtkApplicationWindow',
+    'AmtkApplicationWindow.statusbar': 'GtkStatusbar',
+    'AmtkFactory.application': 'GtkApplication',
+    'AmtkFactory.default-flags': 'AmtkFactoryFlags',
+    'AmtkMenuShell.menu-shell': 'GtkMenuShell',
+    'AmtkTreeViewScrolledWindowSizing.monitor-limit-enabled': 'gboolean',
+};
+
 // `<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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@girs/amtk-5",
-    "version": "5.2.0",
+    "version": "5.4.0",
     "description": "GJS TypeScript type definitions for Amtk-5",
     "type": "module",
     "module": "amtk-5.js",
@@ -36,20 +36,20 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "^5.2.0",
-      "@girs/gtk-3.0": "^5.2.0",
-      "@girs/xlib-2.0": "^5.2.0",
-      "@girs/gdk-3.0": "^5.2.0",
-      "@girs/cairo-1.0": "^5.2.0",
-      "@girs/gobject-2.0": "^5.2.0",
-      "@girs/glib-2.0": "^5.2.0",
-      "@girs/pango-1.0": "^5.2.0",
-      "@girs/harfbuzz-0.0": "^5.2.0",
-      "@girs/freetype2-2.0": "^5.2.0",
-      "@girs/gio-2.0": "^5.2.0",
-      "@girs/gmodule-2.0": "^5.2.0",
-      "@girs/gdkpixbuf-2.0": "^5.2.0",
-      "@girs/atk-1.0": "^5.2.0"    },
+      "@girs/gjs": "^5.4.0",
+      "@girs/gtk-3.0": "^5.4.0",
+      "@girs/xlib-2.0": "^5.4.0",
+      "@girs/gdk-3.0": "^5.4.0",
+      "@girs/cairo-1.0": "^5.4.0",
+      "@girs/gobject-2.0": "^5.4.0",
+      "@girs/glib-2.0": "^5.4.0",
+      "@girs/pango-1.0": "^5.4.0",
+      "@girs/harfbuzz-0.0": "^5.4.0",
+      "@girs/freetype2-2.0": "^5.4.0",
+      "@girs/gio-2.0": "^5.4.0",
+      "@girs/gmodule-2.0": "^5.4.0",
+      "@girs/gdkpixbuf-2.0": "^5.4.0",
+      "@girs/atk-1.0": "^5.4.0"    },
     "devDependencies": {
       "typescript": "*"
     },