@girs/gdl-3 5.2.0 → 5.4.0

package/README.md

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

@@ -1,7 +1,7 @@
 /**
  * The GIR-derived widget VOCABULARY for Gdl-3.
  *
- * GENERATED — do not edit. Provenance: Gdl-3 — dropped empty base(s): GObject.InitiallyUnowned GObject.Object Atk.ImplementorIface — prop(s) no TypeScript value satisfies: Gdl.DockObject.pixbuf-icon
+ * GENERATED — do not edit. Provenance: Gdl-3 — dropped empty base(s): Atk.ImplementorIface — prop(s) no TypeScript value satisfies: Gdl.DockObject.pixbuf-icon
  *
  * 15 instantiable GTypes (of which 12 concrete widgets), 15 declarations, 3 enum nick unions, 4 slot candidates.
  *
@@ -27,6 +27,7 @@
 import type GObject from '@girs/gobject-2.0';
 import type Gdl from './gdl-3.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, GtkBoxConstructOnly, GtkBoxProps, GtkBuildableConstructOnly, GtkBuildableProps, GtkContainerConstructOnly, GtkContainerProps, GtkNotebookConstructOnly, GtkNotebookProps, GtkOrientableConstructOnly, GtkOrientableProps, GtkOrientationNick, GtkPositionTypeNick, GtkWidgetConstructOnly, GtkWidgetProps, GtkWindowConstructOnly, GtkWindowProps } from '@girs/gtk-3.0/vocabulary';
 
 // ---------------------------------------------------------------------------
@@ -129,13 +130,13 @@ export interface GdlDockItemGripProps extends GtkContainerProps, GtkBuildablePro
 export type GdlDockItemGripConstructOnly = GtkContainerConstructOnly | GtkBuildableConstructOnly | 'item';
 
 /** The GdlDockLayout struct contains only private fields and should not be directly accessed. */
-export interface GdlDockLayoutProps {
+export interface GdlDockLayoutProps extends GObjectProps {
     master?: GObject.Object;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GdlDockLayoutConstructOnly = never;
+export type GdlDockLayoutConstructOnly = GObjectConstructOnly;
 
-export interface GdlDockMasterProps {
+export interface GdlDockMasterProps extends GObjectProps {
     /** @default NULL */
     'default-title'?: string;
     /** @default 0 */
@@ -148,7 +149,7 @@ export interface GdlDockMasterProps {
     'tab-reorderable'?: boolean;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GdlDockMasterConstructOnly = never;
+export type GdlDockMasterConstructOnly = GObjectConstructOnly;
 
 export interface GdlDockNotebookProps extends GdlDockItemProps, GtkBuildableProps {
     /** @default -1 */
@@ -411,6 +412,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. */
@@ -520,6 +545,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/gdl-3-vocabulary.js

@@ -1,6 +1,6 @@
 // The widget vocabulary of Gdl-3 as runtime data.
 //
-// GENERATED — do not edit. Provenance: Gdl-3 — dropped empty base(s): GObject.InitiallyUnowned GObject.Object Atk.ImplementorIface — prop(s) no TypeScript value satisfies: Gdl.DockObject.pixbuf-icon
+// GENERATED — do not edit. Provenance: Gdl-3 — dropped empty base(s): Atk.ImplementorIface — prop(s) no TypeScript value satisfies: Gdl.DockObject.pixbuf-icon
 //
 // 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: '3',
     libraryVersion: null,
     childHolders: 0,
-    droppedBases: ['GObject.InitiallyUnowned', 'GObject.Object', 'Atk.ImplementorIface'],
+    droppedBases: ['Atk.ImplementorIface'],
     inlinedBases: [],
     unsettableProps: ['Gdl.DockObject.pixbuf-icon'],
     unresolvedProps: [],
+    identifierPrefixes: ['Gdl'],
+    requiredVocabularies: ['@girs/gobject-2.0/vocabulary', '@girs/gtk-3.0/vocabulary'],
 };
 
 export const OWN_PROPS = {
@@ -48,21 +50,21 @@ export const OWN_SIGNALS = {
 // `GtkEventController*` and `GtkCellRenderer*`. Use `Widgets` and `CHILD_HOLDERS`
 // below for the narrower questions; they did not move.
 export const DECLS = {
-    GdlDock: ['GdlDock', 'GdlDockObject', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
-    GdlDockBar: ['GdlDockBar', 'GtkBox', 'GtkContainer', 'GtkWidget', 'GtkBuildable', 'GtkOrientable'],
-    GdlDockItem: ['GdlDockItem', 'GdlDockObject', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
-    GdlDockItemButtonImage: ['GdlDockItemButtonImage', 'GtkWidget', 'GtkBuildable'],
-    GdlDockItemGrip: ['GdlDockItemGrip', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
-    GdlDockLayout: ['GdlDockLayout'],
-    GdlDockMaster: ['GdlDockMaster'],
-    GdlDockNotebook: ['GdlDockNotebook', 'GdlDockItem', 'GdlDockObject', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
-    GdlDockObject: ['GdlDockObject', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
-    GdlDockPaned: ['GdlDockPaned', 'GdlDockItem', 'GdlDockObject', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
+    GdlDock: ['GdlDock', 'GdlDockObject', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
+    GdlDockBar: ['GdlDockBar', 'GtkBox', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable', 'GtkOrientable'],
+    GdlDockItem: ['GdlDockItem', 'GdlDockObject', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
+    GdlDockItemButtonImage: ['GdlDockItemButtonImage', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
+    GdlDockItemGrip: ['GdlDockItemGrip', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
+    GdlDockLayout: ['GdlDockLayout', 'GObject'],
+    GdlDockMaster: ['GdlDockMaster', 'GObject'],
+    GdlDockNotebook: ['GdlDockNotebook', 'GdlDockItem', 'GdlDockObject', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
+    GdlDockObject: ['GdlDockObject', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
+    GdlDockPaned: ['GdlDockPaned', 'GdlDockItem', 'GdlDockObject', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
     GdlDockParam: ['GdlDockParam'],
-    GdlDockPlaceholder: ['GdlDockPlaceholder', 'GdlDockObject', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
-    GdlDockTablabel: ['GdlDockTablabel', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
-    GdlPreviewWindow: ['GdlPreviewWindow', 'GtkWindow', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
-    GdlSwitcher: ['GdlSwitcher', 'GtkNotebook', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
+    GdlDockPlaceholder: ['GdlDockPlaceholder', 'GdlDockObject', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
+    GdlDockTablabel: ['GdlDockTablabel', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
+    GdlPreviewWindow: ['GdlPreviewWindow', 'GtkWindow', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
+    GdlSwitcher: ['GdlSwitcher', 'GtkNotebook', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable'],
 };
 
 // The GTypes above that ARE widgets are the `Widgets` map in the sibling `.d.ts`; these
@@ -76,6 +78,8 @@ export const ENUM_NICKS = {
     GdlDockBarStyle: ['icons', 'text', 'both', 'auto'],
     GdlDockPlacement: ['none', 'top', 'bottom', 'right', 'left', 'center', 'floating'],
     GdlSwitcherStyle: ['text', 'icon', 'both', 'toolbar', 'tabs', 'none'],
+    GtkOrientation: ['horizontal', 'vertical'],
+    GtkPositionType: ['left', 'right', 'top', 'bottom'],
 };
 
 // The number behind each of those nicks, read from GIR's own `value` attribute.
@@ -110,6 +114,12 @@ export const ENUM_VALUES = {
     'GdlSwitcherStyle.tabs': 4,
     'GdlSwitcherStyle.text': 0,
     'GdlSwitcherStyle.toolbar': 3,
+    'GtkOrientation.horizontal': 0,
+    'GtkOrientation.vertical': 1,
+    'GtkPositionType.bottom': 3,
+    'GtkPositionType.left': 0,
+    'GtkPositionType.right': 1,
+    'GtkPositionType.top': 2,
 };
 
 // The nicks GIR marks `deprecated="1"`.
@@ -203,6 +213,62 @@ export const PROP_ENUMS = {
     'GdlSwitcher.tab-pos': 'GtkPositionType',
 };
 
+// `<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 = {
+    'GdlDock.default-title': 'gchararray',
+    'GdlDock.floating': 'gboolean',
+    'GdlDock.floatx': 'gint',
+    'GdlDock.floaty': 'gint',
+    'GdlDock.height': 'gint',
+    'GdlDock.skip-taskbar': 'gboolean',
+    'GdlDock.width': 'gint',
+    'GdlDockBar.dockbar-style': 'GdlDockBarStyle',
+    'GdlDockBar.master': 'GObject',
+    'GdlDockItem.behavior': 'GdlDockItemBehavior',
+    'GdlDockItem.closed': 'gboolean',
+    'GdlDockItem.iconified': 'gboolean',
+    'GdlDockItem.locked': 'gboolean',
+    'GdlDockItem.orientation': 'GtkOrientation',
+    'GdlDockItem.preferred-height': 'gint',
+    'GdlDockItem.preferred-width': 'gint',
+    'GdlDockItem.resize': 'gboolean',
+    'GdlDockItemGrip.item': 'GdlDockItem',
+    'GdlDockLayout.master': 'GObject',
+    'GdlDockMaster.default-title': 'gchararray',
+    'GdlDockMaster.locked': 'gint',
+    'GdlDockMaster.switcher-style': 'GdlSwitcherStyle',
+    'GdlDockMaster.tab-pos': 'GtkPositionType',
+    'GdlDockMaster.tab-reorderable': 'gboolean',
+    'GdlDockNotebook.page': 'gint',
+    'GdlDockObject.long-name': 'gchararray',
+    'GdlDockObject.master': 'GdlDockMaster',
+    'GdlDockObject.name': 'gchararray',
+    'GdlDockObject.pixbuf-icon': 'gpointer',
+    'GdlDockObject.stock-id': 'gchararray',
+    'GdlDockPaned.position': 'guint',
+    'GdlDockPlaceholder.floating': 'gboolean',
+    'GdlDockPlaceholder.floatx': 'gint',
+    'GdlDockPlaceholder.floaty': 'gint',
+    'GdlDockPlaceholder.height': 'gint',
+    'GdlDockPlaceholder.host': 'GdlDockObject',
+    'GdlDockPlaceholder.next-placement': 'GdlDockPlacement',
+    'GdlDockPlaceholder.sticky': 'gboolean',
+    'GdlDockPlaceholder.width': 'gint',
+    'GdlDockTablabel.item': 'GdlDockItem',
+    'GdlSwitcher.switcher-style': 'GdlSwitcherStyle',
+    'GdlSwitcher.tab-pos': 'GtkPositionType',
+    'GdlSwitcher.tab-reorderable': '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/gdl-3",
-    "version": "5.2.0",
+    "version": "5.4.0",
     "description": "GJS TypeScript type definitions for Gdl-3",
     "type": "module",
     "module": "gdl-3.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": "*"
     },