@girs/handy-1 5.0.0 → 5.2.0

package/README.md

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

@@ -3,7 +3,7 @@
  *
  * GENERATED — do not edit. Provenance: Handy-1 — dropped empty base(s): GObject.InitiallyUnowned GObject.Object Atk.ImplementorIface Gio.ActionGroup Gio.ActionMap
  *
- * 29 concrete widgets, 30 declarations, 11 enum nick unions, 24 slot candidates.
+ * 37 instantiable GTypes (of which 29 concrete widgets), 38 declarations, 11 enum nick unions, 24 slot candidates.
  *
  * Module-scoped exports only. There is no `JSX` namespace here, no tag spelling and
  * no `on<Signal>` prop name: those are DIALECT, and every framework answers them
@@ -24,6 +24,8 @@
  * and the `notify::` keys folded in, is what `Widgets[G]['signals']` points at.
  */
 
+import type GObject from '@girs/gobject-2.0';
+import type Gdk from '@girs/gdk-3.0';
 import type Gio from '@girs/gio-2.0';
 import type Gtk from '@girs/gtk-3.0';
 import type Handy from './handy-1.js';
@@ -307,6 +309,12 @@ export interface HdyDeckProps extends GtkContainerProps, GtkBuildableProps, GtkO
 /** Settable only at construction — a renderer must REBUILD, not patch. */
 export type HdyDeckConstructOnly = GtkContainerConstructOnly | GtkBuildableConstructOnly | GtkOrientableConstructOnly | HdySwipeableConstructOnly;
 
+/** An object representing an [struct@GObject.EnumValue]. */
+export interface HdyEnumValueObjectProps {
+}
+/** Settable only at construction — a renderer must REBUILD, not patch. */
+export type HdyEnumValueObjectConstructOnly = never;
+
 /** A [class@Gtk.ListBoxRow] used to reveal widgets. */
 export interface HdyExpanderRowProps extends HdyPreferencesRowProps, GtkActionableProps, GtkBuildableProps {
     /**
@@ -499,6 +507,24 @@ export interface HdyHeaderBarProps extends GtkContainerProps, GtkBuildableProps
 /** Settable only at construction — a renderer must REBUILD, not patch. */
 export type HdyHeaderBarConstructOnly = GtkContainerConstructOnly | GtkBuildableConstructOnly;
 
+/** An object handling composite title bars. */
+export interface HdyHeaderGroupProps extends GtkBuildableProps {
+    /**
+     * Whether the elements of the group should all receive the full decoration.
+     * @since 1.0
+     * @default FALSE
+     */
+    'decorate-all'?: boolean;
+}
+/** Settable only at construction — a renderer must REBUILD, not patch. */
+export type HdyHeaderGroupConstructOnly = GtkBuildableConstructOnly;
+
+/** A child object for [class@HeaderGroup]. */
+export interface HdyHeaderGroupChildProps {
+}
+/** Settable only at construction — a renderer must REBUILD, not patch. */
+export type HdyHeaderGroupChildConstructOnly = never;
+
 /** A keypad for dialing numbers The `HdyKeypad` widget is a keypad for entering numbers such as phone numbers or PIN codes. */
 export interface HdyKeypadProps extends GtkBinProps, GtkBuildableProps {
     /**
@@ -776,6 +802,64 @@ export interface HdyStatusPageProps extends GtkBinProps, GtkBuildableProps {
 /** Settable only at construction — a renderer must REBUILD, not patch. */
 export type HdyStatusPageConstructOnly = GtkBinConstructOnly | GtkBuildableConstructOnly;
 
+/** A class for managing application-wide styling. */
+export interface HdyStyleManagerProps {
+    /**
+     * The requested application color scheme.
+     * @since 1.6
+     * @default HDY_COLOR_SCHEME_DEFAULT
+     */
+    'color-scheme'?: HdyColorSchemeNick | Handy.ColorScheme;
+    /**
+     * The display the style manager is associated with.
+     * @since 1.6
+     */
+    display?: Gdk.Display;
+}
+/** Settable only at construction — a renderer must REBUILD, not patch. */
+export type HdyStyleManagerConstructOnly = 'display';
+
+/** An object for syncing swipeable widgets. */
+export interface HdySwipeGroupProps extends GtkBuildableProps {
+}
+/** Settable only at construction — a renderer must REBUILD, not patch. */
+export type HdySwipeGroupConstructOnly = GtkBuildableConstructOnly;
+
+/** Swipe tracker used in [class@Carousel] and [class@Leaflet]. */
+export interface HdySwipeTrackerProps extends GtkOrientableProps {
+    /**
+     * Whether to allow swiping for more than one snap point at a time.
+     * @since 1.2
+     * @default FALSE
+     */
+    'allow-long-swipes'?: boolean;
+    /**
+     * Whether to allow dragging with mouse pointer.
+     * @since 1.0
+     * @default FALSE
+     */
+    'allow-mouse-drag'?: boolean;
+    /**
+     * Whether the swipe tracker is enabled.
+     * @since 1.0
+     * @default TRUE
+     */
+    enabled?: boolean;
+    /**
+     * Whether to reverse the swipe direction.
+     * @since 1.0
+     * @default FALSE
+     */
+    reversed?: boolean;
+    /**
+     * The widget the swipe tracker is attached to.
+     * @since 1.0
+     */
+    swipeable?: Handy.Swipeable;
+}
+/** Settable only at construction — a renderer must REBUILD, not patch. */
+export type HdySwipeTrackerConstructOnly = GtkOrientableConstructOnly | 'swipeable';
+
 /** An interface for swipeable widgets. */
 export interface HdySwipeableProps extends GtkWidgetProps {
 }
@@ -826,6 +910,62 @@ export interface HdyTabBarProps extends GtkBinProps, GtkBuildableProps {
 /** Settable only at construction — a renderer must REBUILD, not patch. */
 export type HdyTabBarConstructOnly = GtkBinConstructOnly | GtkBuildableConstructOnly;
 
+/** An auxiliary class used by [class@TabView]. */
+export interface HdyTabPageProps {
+    /**
+     * The child of the page.
+     * @since 1.2
+     */
+    child?: Gtk.Widget;
+    /**
+     * The icon of the page.
+     * @since 1.2
+     */
+    icon?: Gio.Icon | null;
+    /**
+     * Whether the indicator icon is activatable.
+     * @since 1.2
+     * @default FALSE
+     */
+    'indicator-activatable'?: boolean;
+    /**
+     * An indicator icon for the page.
+     * @since 1.2
+     */
+    'indicator-icon'?: Gio.Icon | null;
+    /**
+     * Whether the page is loading.
+     * @since 1.2
+     * @default FALSE
+     */
+    loading?: boolean;
+    /**
+     * Whether the page needs attention.
+     * @since 1.2
+     * @default FALSE
+     */
+    'needs-attention'?: boolean;
+    /**
+     * The parent page of the page.
+     * @since 1.2
+     */
+    parent?: Handy.TabPage | null;
+    /**
+     * The title of the page.
+     * @since 1.2
+     * @default NULL
+     */
+    title?: string | null;
+    /**
+     * The tooltip of the page.
+     * @since 1.2
+     * @default NULL
+     */
+    tooltip?: string | null;
+}
+/** Settable only at construction — a renderer must REBUILD, not patch. */
+export type HdyTabPageConstructOnly = 'child' | 'parent';
+
 /** A dynamic tabbed container. */
 export interface HdyTabViewProps extends GtkBinProps, GtkBuildableProps {
     /**
@@ -865,6 +1005,17 @@ export interface HdyTitleBarProps extends GtkBinProps, GtkBuildableProps {
 /** Settable only at construction — a renderer must REBUILD, not patch. */
 export type HdyTitleBarConstructOnly = GtkBinConstructOnly | GtkBuildableConstructOnly;
 
+/** An object representing a [struct@GObject.Value]. */
+export interface HdyValueObjectProps {
+    /**
+     * The contained value.
+     * @since 1.0
+     */
+    value?: GObject.Value;
+}
+/** Settable only at construction — a renderer must REBUILD, not patch. */
+export type HdyValueObjectConstructOnly = 'value';
+
 /** An adaptive view switcher. */
 export interface HdyViewSwitcherProps extends GtkBinProps, GtkBuildableProps {
     /**
@@ -1217,7 +1368,11 @@ export interface Widgets {
     };
 }
 
-/** Every GType this namespace can create. A consumer derives its own tag map. */
+/**
+ * Every GType this namespace can create AND put on screen. A consumer derives its own
+ * tag map. For everything a UI file can instantiate — layout managers, event
+ * controllers, cell renderers, `GtkSizeGroup` — read `DECLS` below.
+ */
 export type WidgetGType = keyof Widgets;
 
 // ---------------------------------------------------------------------------
@@ -1269,7 +1424,14 @@ export const PROVENANCE: {
     readonly childHolders: number;
     readonly droppedBases: readonly string[];
     readonly inlinedBases: readonly string[];
+    /** `<decl>.<prop>` for every property printed `never` because TypeScript has no value for it. */
     readonly unsettableProps: readonly string[];
+    /**
+     * `<decl>.<prop>: <Ns>.<Name>` for every property printed `never` because the model
+     * could not resolve its type across a namespace boundary — two independently released
+     * GIRs disagreeing, which is what the main emitter answers `never` for as well.
+     */
+    readonly unresolvedProps: readonly string[];
 };
 
 /** Declaration GType -> its own settable properties, as GObject registered them. */
@@ -1283,7 +1445,17 @@ export const OWN_PROPS: Readonly<Record<string, readonly string[]>>;
  */
 export const OWN_SIGNALS: Readonly<Record<string, readonly string[]>>;
 
-/** Widget GType -> every declaration its members come from, self first. */
+/**
+ * Instantiable GType -> every declaration its members come from, self first.
+ *
+ * The key set is what a UI description file can NAME: every registered, non-abstract
+ * class this namespace declares. GtkBuilder resolves a `<object class="…">` through
+ * `g_type_from_name`, which knows nothing about widgets, so this is wider than
+ * `Widgets` by design — `GtkSizeGroup`, `GtkTextTag`, every `GtkEventController`
+ * and every `GtkCellRenderer` are here and are not widgets.
+ *
+ * `Widgets` and `CHILD_HOLDERS` are the narrower questions and answer them unchanged.
+ */
 export const DECLS: Readonly<Record<string, readonly string[]>>;
 
 /** The GTypes in `DECLS` that hold a widget without being one — see `ChildHolders`. */
@@ -1295,8 +1467,8 @@ export const ENUM_NICKS: Readonly<Record<string, readonly string[]>>;
 /**
  * `<enum GType>.<nick>` -> the integer GObject registers for it, from GIR's `value`.
  *
- * Position in `ENUM_NICKS` is NOT this number. Counting is wrong on 6 of the 129 enums a
- * GTK 4 vocabulary carries -- 104 in Gtk-4.0 and 25 in Adw-1: `GtkResponseType` runs -1 to -11, `GtkTextWindowType` starts
+ * Position in `ENUM_NICKS` is NOT this number. Counting is wrong on 6 of the 137 enums a
+ * GTK 4 vocabulary carries -- 112 in Gtk-4.0 and 25 in Adw-1: `GtkResponseType` runs -1 to -11, `GtkTextWindowType` starts
  * at 1, `GtkOrdering` and `GtkConstraintRelation` are -1/0/1, `GtkAlign` has two names
  * on one value, and `GtkConstraintStrength.required` is 1001001000 where counting says 0.
  *
@@ -1334,10 +1506,11 @@ export const ENUM_VALUES_UNREADABLE: Readonly<Record<string, string>>;
  *
  * `ENUM_NICKS` carries no bitfield, because GObject cannot resolve a nick SET; that says
  * nothing about a single member's number, and the number is what a host without GI needs.
- * 21 writable widget properties in Gtk-4.0 and Adw-1 are bitfield-typed and are declared
- * bare `number` -- `GtkEntry:input-hints`, `GtkPopoverMenu:flags`, `AdwTabView:shortcuts`
- * among them. Counting is worst here: 95 of 121 Gtk-4.0 bitfield members disagree with their
- * position, against 29 of 685 enumeration members.
+ * 23 settable properties in Gtk-4.0 and Adw-1 are bitfield-typed and are declared bare
+ * `number` -- `GtkEntry:input-hints`, `GtkPopoverMenu:flags`, `AdwTabView:shortcuts`,
+ * `GtkDropTarget:actions` among them. Counting is worst here: 119 of the 156 Gtk-4.0
+ * bitfield members this vocabulary carries disagree with their declaration position,
+ * against 29 of 672 enumeration members.
  *
  * Combine with `|` as GObject does. There is no nick table to pair this with, so a name
  * here is resolvable and a SET still is not.
@@ -1361,13 +1534,52 @@ export const FLAG_VALUES_UNREADABLE: Readonly<Record<string, string>>;
  *
  * The GType named here is not always one THIS module gives numbers for. A nick vocabulary is
  * emitted once, by the namespace that owns the enum, so `AdwComboRow.search-match-mode` names
- * `GtkStringFilterMatchMode` and its rows are in `@girs/gtk-4.0/vocabulary` — 57 of the 438
+ * `GtkStringFilterMatchMode` and its rows are in `@girs/gtk-4.0/vocabulary` — 83 of the 909
  * entries in a full run resolve only with the owner's vocabulary loaded beside this one. An
  * owner with no vocabulary of its own (Gdk, Pango) is inlined here instead, so every entry
  * resolves against SOME module.
  */
 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/handy-1-vocabulary.js

@@ -14,6 +14,7 @@ export const PROVENANCE = {
     droppedBases: ['GObject.InitiallyUnowned', 'GObject.Object', 'Atk.ImplementorIface', 'Gio.ActionGroup', 'Gio.ActionMap'],
     inlinedBases: [],
     unsettableProps: [],
+    unresolvedProps: [],
 };
 
 export const OWN_PROPS = {
@@ -28,6 +29,7 @@ export const OWN_PROPS = {
     HdyExpanderRow: ['enable-expansion', 'expanded', 'icon-name', 'show-enable-switch', 'subtitle', 'use-underline'],
     HdyFlap: ['content', 'flap', 'flap-position', 'fold-duration', 'fold-policy', 'locked', 'modal', 'reveal-duration', 'reveal-flap', 'separator', 'swipe-to-close', 'swipe-to-open', 'transition-type'],
     HdyHeaderBar: ['centering-policy', 'custom-title', 'decoration-layout', 'decoration-layout-set', 'has-subtitle', 'interpolate-size', 'show-close-button', 'spacing', 'subtitle', 'title', 'transition-duration'],
+    HdyHeaderGroup: ['decorate-all'],
     HdyKeypad: ['column-spacing', 'end-action', 'entry', 'letters-visible', 'row-spacing', 'start-action', 'symbols-visible'],
     HdyLeaflet: ['can-swipe-back', 'can-swipe-forward', 'child-transition-duration', 'hhomogeneous-folded', 'hhomogeneous-unfolded', 'interpolate-size', 'mode-transition-duration', 'transition-type', 'vhomogeneous-folded', 'vhomogeneous-unfolded', 'visible-child', 'visible-child-name'],
     HdyPreferencesGroup: ['description', 'title', 'use-markup'],
@@ -37,9 +39,13 @@ export const OWN_PROPS = {
     HdySearchBar: ['search-mode-enabled', 'show-close-button'],
     HdySqueezer: ['homogeneous', 'interpolate-size', 'transition-duration', 'transition-type', 'xalign', 'yalign'],
     HdyStatusPage: ['description', 'icon-name', 'title'],
+    HdyStyleManager: ['color-scheme', 'display'],
+    HdySwipeTracker: ['allow-long-swipes', 'allow-mouse-drag', 'enabled', 'reversed', 'swipeable'],
     HdyTabBar: ['autohide', 'end-action-widget', 'expand-tabs', 'extra-drag-dest-targets', 'inverted', 'start-action-widget', 'view'],
+    HdyTabPage: ['child', 'icon', 'indicator-activatable', 'indicator-icon', 'loading', 'needs-attention', 'parent', 'title', 'tooltip'],
     HdyTabView: ['default-icon', 'menu-model', 'selected-page', 'shortcut-widget'],
     HdyTitleBar: ['selection-mode'],
+    HdyValueObject: ['value'],
     HdyViewSwitcher: ['narrow-ellipsize', 'policy', 'stack'],
     HdyViewSwitcherBar: ['policy', 'reveal', 'stack'],
     HdyViewSwitcherTitle: ['policy', 'stack', 'subtitle', 'title', 'view-switcher-enabled'],
@@ -48,11 +54,20 @@ export const OWN_PROPS = {
 export const OWN_SIGNALS = {
     HdyActionRow: ['activated'],
     HdyCarousel: ['page-changed'],
+    HdyHeaderGroup: ['update-decoration-layouts'],
+    HdySwipeTracker: ['begin-swipe', 'end-swipe', 'update-swipe'],
     HdySwipeable: ['child-switched'],
     HdyTabBar: ['extra-drag-data-received'],
     HdyTabView: ['close-page', 'create-window', 'indicator-activated', 'page-attached', 'page-detached', 'page-reordered', 'setup-menu'],
 };
 
+// Every GType this namespace can INSTANTIATE -> the declarations its members come from.
+//
+// The key set is what a UI description file can name: a registered, non-abstract class.
+// Not "every widget" — GtkBuilder resolves a name through `g_type_from_name`, which knows
+// nothing about widgets, and a `.ui` file is full of `GtkSizeGroup`, `GtkTextTag`,
+// `GtkEventController*` and `GtkCellRenderer*`. Use `Widgets` and `CHILD_HOLDERS`
+// below for the narrower questions; they did not move.
 export const DECLS = {
     HdyActionRow: ['HdyActionRow', 'HdyPreferencesRow', 'GtkListBoxRow', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkActionable', 'GtkBuildable'],
     HdyApplicationWindow: ['HdyApplicationWindow', 'GtkApplicationWindow', 'GtkWindow', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
@@ -63,9 +78,12 @@ export const DECLS = {
     HdyClamp: ['HdyClamp', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable', 'GtkOrientable'],
     HdyComboRow: ['HdyComboRow', 'HdyActionRow', 'HdyPreferencesRow', 'GtkListBoxRow', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkActionable', 'GtkBuildable'],
     HdyDeck: ['HdyDeck', 'GtkContainer', 'GtkWidget', 'GtkBuildable', 'GtkOrientable', 'HdySwipeable'],
+    HdyEnumValueObject: ['HdyEnumValueObject'],
     HdyExpanderRow: ['HdyExpanderRow', 'HdyPreferencesRow', 'GtkListBoxRow', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkActionable', 'GtkBuildable'],
     HdyFlap: ['HdyFlap', 'GtkContainer', 'GtkWidget', 'GtkBuildable', 'GtkOrientable', 'HdySwipeable'],
     HdyHeaderBar: ['HdyHeaderBar', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
+    HdyHeaderGroup: ['HdyHeaderGroup', 'GtkBuildable'],
+    HdyHeaderGroupChild: ['HdyHeaderGroupChild'],
     HdyKeypad: ['HdyKeypad', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
     HdyLeaflet: ['HdyLeaflet', 'GtkContainer', 'GtkWidget', 'GtkBuildable', 'GtkOrientable', 'HdySwipeable'],
     HdyPreferencesGroup: ['HdyPreferencesGroup', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
@@ -75,9 +93,14 @@ export const DECLS = {
     HdySearchBar: ['HdySearchBar', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
     HdySqueezer: ['HdySqueezer', 'GtkContainer', 'GtkWidget', 'GtkBuildable', 'GtkOrientable'],
     HdyStatusPage: ['HdyStatusPage', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
+    HdyStyleManager: ['HdyStyleManager'],
+    HdySwipeGroup: ['HdySwipeGroup', 'GtkBuildable'],
+    HdySwipeTracker: ['HdySwipeTracker', 'GtkOrientable'],
     HdyTabBar: ['HdyTabBar', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
+    HdyTabPage: ['HdyTabPage'],
     HdyTabView: ['HdyTabView', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
     HdyTitleBar: ['HdyTitleBar', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
+    HdyValueObject: ['HdyValueObject'],
     HdyViewSwitcher: ['HdyViewSwitcher', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
     HdyViewSwitcherBar: ['HdyViewSwitcherBar', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
     HdyViewSwitcherTitle: ['HdyViewSwitcherTitle', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
@@ -85,10 +108,11 @@ export const DECLS = {
     HdyWindowHandle: ['HdyWindowHandle', 'GtkEventBox', 'GtkBin', 'GtkContainer', 'GtkWidget', 'GtkBuildable'],
 };
 
-// The GTypes above that are NOT widgets: they hold one through `set_child`/`get_child`
-// and descend from `GObject.Object`. A renderer places them like a container; a check
-// asking "is this a widget" must not count them. Derived from the accessor pair, never
-// from a list — the count is in the provenance line above.
+// The GTypes above that ARE widgets are the `Widgets` map in the sibling `.d.ts`; these
+// are the ones that merely HOLD one, through `set_child`/`get_child`, descending from
+// `GObject.Object`. A renderer places them like a container; a check asking "is this a
+// widget" must not count them. Derived from the accessor pair, never from a list — the
+// count is in the provenance line above.
 export const CHILD_HOLDERS = [];
 
 export const ENUM_NICKS = {
@@ -110,7 +134,7 @@ export const ENUM_NICKS = {
 // It ships because position in `ENUM_NICKS` is not the value and a consumer with no
 // typelib has no other way to learn it: a surface without GI still has to hand GObject an
 // integer. The alternative a consumer reaches for first is counting, and counting is wrong
-// on 6 of the 129 enums a GTK 4 vocabulary carries (104 in Gtk-4.0, 25 in Adw-1) --
+// on 6 of the 137 enums a GTK 4 vocabulary carries (112 in Gtk-4.0, 25 in Adw-1) --
 // `GtkResponseType` runs -1 down to
 // -11, `GtkTextWindowType` starts at 1, and `GtkConstraintStrength.required` is
 // 1001001000 where counting answers 0.
@@ -181,11 +205,12 @@ export const ENUM_VALUES_UNREADABLE = {};
 // The number behind each member of a registered BITFIELD, keyed the same way.
 //
 // `ENUM_NICKS` refuses a bitfield because GObject cannot resolve a nick SET, and that
-// reason says nothing about one member's number. 21 writable widget properties in Gtk-4.0
-// and Adw-1 are bitfield-typed -- `GtkEntry:input-hints`, `GtkPopoverMenu:flags`,
-// `AdwTabView:shortcuts`, ... -- and they are typed bare `number`, so a host without GI
-// has nothing to compute one from. Counting is worst exactly here: 95 of 121 Gtk-4.0
-// bitfield members disagree with their position, against 29 of 685 enumeration members.
+// reason says nothing about one member's number. 23 settable properties in Gtk-4.0 and
+// Adw-1 are bitfield-typed -- `GtkEntry:input-hints`, `GtkPopoverMenu:flags`,
+// `AdwTabView:shortcuts`, `GtkDropTarget:actions`, ... -- and they are typed bare
+// `number`, so a host without GI has nothing to compute one from. Counting is worst
+// exactly here: 119 of the 156 Gtk-4.0 bitfield members this vocabulary carries disagree
+// with their declaration position, against 29 of 672 enumeration members.
 //
 // A table of its own rather than more rows in `ENUM_VALUES`, so that "every nick in
 // `ENUM_NICKS` has a number or a declared reason" stays a claim about one set.
@@ -208,7 +233,7 @@ export const FLAG_VALUES_UNREADABLE = {};
 // one are both entries a consumer would resolve wrongly, so neither is written.
 //
 // A GType named here has numbers in SOME vocabulary, not necessarily this one: the namespace
-// that OWNS an enum publishes it, so 57 of the 438 entries a full run emits want the owner's
+// that OWNS an enum publishes it, so 83 of the 909 entries a full run emits want the owner's
 // vocabulary loaded too. Owners that emit none (Gdk, Pango) are inlined into the tables above.
 export const PROP_ENUMS = {
     'HdyDeck.transition-type': 'HdyDeckTransitionType',
@@ -218,12 +243,38 @@ export const PROP_ENUMS = {
     'HdyHeaderBar.centering-policy': 'HdyCenteringPolicy',
     'HdyLeaflet.transition-type': 'HdyLeafletTransitionType',
     'HdySqueezer.transition-type': 'HdySqueezerTransitionType',
+    'HdyStyleManager.color-scheme': 'HdyColorScheme',
     'HdyViewSwitcher.narrow-ellipsize': 'PangoEllipsizeMode',
     'HdyViewSwitcher.policy': 'HdyViewSwitcherPolicy',
     'HdyViewSwitcherBar.policy': 'HdyViewSwitcherPolicy',
     'HdyViewSwitcherTitle.policy': 'HdyViewSwitcherPolicy',
 };
 
+// `<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 = {
     HdyActionRow: {
         'activatable': 'set_activatable_widget',
@@ -324,6 +375,7 @@ export const SINCE = {
     'HdyDeck.vhomogeneous': '1.0',
     'HdyDeck.visible-child': '1.0',
     'HdyDeck.visible-child-name': '1.0',
+    'HdyEnumValueObject': '1.0',
     'HdyExpanderRow': '1.0',
     'HdyExpanderRow.enable-expansion': '1.0',
     'HdyExpanderRow.expanded': '1.0',
@@ -357,6 +409,10 @@ export const SINCE = {
     'HdyHeaderBar.subtitle': '1.0',
     'HdyHeaderBar.title': '1.0',
     'HdyHeaderBar.transition-duration': '1.0',
+    'HdyHeaderGroup': '1.0',
+    'HdyHeaderGroup.decorate-all': '1.0',
+    'HdyHeaderGroup::update-decoration-layouts': '1.0',
+    'HdyHeaderGroupChild': '1.0',
     'HdyKeypad': '1.0',
     'HdyKeypad.column-spacing': '1.0',
     'HdyKeypad.end-action': '1.0',
@@ -405,6 +461,19 @@ export const SINCE = {
     'HdyStatusPage.description': '1.2',
     'HdyStatusPage.icon-name': '1.2',
     'HdyStatusPage.title': '1.2',
+    'HdyStyleManager': '1.6',
+    'HdyStyleManager.color-scheme': '1.6',
+    'HdyStyleManager.display': '1.6',
+    'HdySwipeGroup': '1.0',
+    'HdySwipeTracker': '1.0',
+    'HdySwipeTracker.allow-long-swipes': '1.2',
+    'HdySwipeTracker.allow-mouse-drag': '1.0',
+    'HdySwipeTracker.enabled': '1.0',
+    'HdySwipeTracker.reversed': '1.0',
+    'HdySwipeTracker.swipeable': '1.0',
+    'HdySwipeTracker::begin-swipe': '1.0',
+    'HdySwipeTracker::end-swipe': '1.0',
+    'HdySwipeTracker::update-swipe': '1.0',
     'HdySwipeable': '1.0',
     'HdySwipeable::child-switched': '1.0',
     'HdyTabBar': '1.2',
@@ -416,6 +485,16 @@ export const SINCE = {
     'HdyTabBar.start-action-widget': '1.2',
     'HdyTabBar.view': '1.2',
     'HdyTabBar::extra-drag-data-received': '1.2',
+    'HdyTabPage': '1.2',
+    'HdyTabPage.child': '1.2',
+    'HdyTabPage.icon': '1.2',
+    'HdyTabPage.indicator-activatable': '1.2',
+    'HdyTabPage.indicator-icon': '1.2',
+    'HdyTabPage.loading': '1.2',
+    'HdyTabPage.needs-attention': '1.2',
+    'HdyTabPage.parent': '1.2',
+    'HdyTabPage.title': '1.2',
+    'HdyTabPage.tooltip': '1.2',
     'HdyTabView': '1.2',
     'HdyTabView.default-icon': '1.2',
     'HdyTabView.menu-model': '1.2',
@@ -430,6 +509,8 @@ export const SINCE = {
     'HdyTabView::setup-menu': '1.2',
     'HdyTitleBar': '1.0',
     'HdyTitleBar.selection-mode': '1.0',
+    'HdyValueObject': '1.0',
+    'HdyValueObject.value': '1.0',
     'HdyViewSwitcher': '1.0',
     'HdyViewSwitcher.narrow-ellipsize': '1.0',
     'HdyViewSwitcher.policy': '1.0',

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@girs/handy-1",
-    "version": "5.0.0",
+    "version": "5.2.0",
     "description": "GJS TypeScript type definitions for Handy-1",
     "type": "module",
     "module": "handy-1.js",
@@ -36,20 +36,20 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "^5.0.0",
-      "@girs/gtk-3.0": "^5.0.0",
-      "@girs/xlib-2.0": "^5.0.0",
-      "@girs/gdk-3.0": "^5.0.0",
-      "@girs/cairo-1.0": "^5.0.0",
-      "@girs/gobject-2.0": "^5.0.0",
-      "@girs/glib-2.0": "^5.0.0",
-      "@girs/pango-1.0": "^5.0.0",
-      "@girs/harfbuzz-0.0": "^5.0.0",
-      "@girs/freetype2-2.0": "^5.0.0",
-      "@girs/gio-2.0": "^5.0.0",
-      "@girs/gmodule-2.0": "^5.0.0",
-      "@girs/gdkpixbuf-2.0": "^5.0.0",
-      "@girs/atk-1.0": "^5.0.0"    },
+      "@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"    },
     "devDependencies": {
       "typescript": "*"
     },