@gjsify/adwaita-nativescript 0.64.2 → 0.64.3-next.260

package/lib/types/widgets/adw-dialog.d.ts

@@ -21,6 +21,8 @@ export declare class AdwDialog extends AdwSingleChildBase {
     private _presentationMode;
     /** The window `present (parent)` mounted this in, so closing can take it back out. */
     private _host;
+    /** The window size the card was last laid out against, in DIP; `null` before a layout. */
+    private _available;
     constructor(props?: ConstructProps<AdwDialog>);
     protected get _ownClass(): string;
     protected _adopt(view: View): void;
@@ -58,6 +60,11 @@ export declare class AdwDialog extends AdwSingleChildBase {
     close(): void;
     /** `adw_dialog_force_close` — closes whatever `can-close` says. */
     force_close(): void;
-    /** The card's size and place, from `content-*` and `presentation-mode`. */
+    /**
+     * Re-read the window size after a layout pass. Guarded on a real change: re-sizing the
+     * card schedules another pass, which lands here again.
+     */
+    private _measureWindow;
+    /** The card's size and place, from `content-*`, `presentation-mode` and the window size. */
     private _layoutCard;
 }

package/lib/types/widgets/adw-header-bar.d.ts

@@ -2,6 +2,8 @@ import type { View } from '@nativescript/core';
 import { GridLayout, StackLayout } from '@nativescript/core';
 import { type ConstructProps } from './construct-props.js';
 declare const AdwHeaderBar_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -48,10 +50,12 @@ declare const AdwHeaderBar_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     notify<T extends import("@nativescript/core").EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;

package/lib/types/widgets/adw-image-button.d.ts

@@ -12,6 +12,8 @@ import { type ConstructProps } from './construct-props.js';
  */
 export declare const DEFAULT_ICON_BUTTON_ICON_SIZE: number;
 declare const AdwImageButton_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -58,10 +60,12 @@ declare const AdwImageButton_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     notify<T extends import("@nativescript/core").EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;

package/lib/types/widgets/adw-navigation-page.d.ts

@@ -8,6 +8,8 @@ export interface NavigationPageOwner {
     setPageCanPop(view: View, canPop: boolean): boolean;
 }
 declare const AdwNavigationPage_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -54,10 +56,12 @@ declare const AdwNavigationPage_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     notify<T extends import("@nativescript/core").EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;

package/lib/types/widgets/adw-navigation-view.d.ts

@@ -15,6 +15,8 @@ export interface AdwNavigationEventData extends EventData {
 /** Payload of the `notify::visible-page` event. */
 export type NotifyVisiblePageEventData = AdwNavigationEventData;
 declare const AdwNavigationView_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -61,10 +63,12 @@ declare const AdwNavigationView_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     notify<T extends EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;

package/lib/types/widgets/adw-preferences-dialog.d.ts

@@ -1,86 +1,27 @@
 import type { View } from '@nativescript/core';
-import { GridLayout, Label, StackLayout, type EventData } from '@nativescript/core';
+import { GridLayout, Label } from '@nativescript/core';
 import type { SearchPreferencesOptions } from '@gjsify/adwaita-core';
+import { AdwDialog } from './adw-dialog.js';
 import { type NsPreferencesSearchResult, type NsSearchablePage } from './preferences-search.js';
 import { type ConstructProps } from './construct-props.js';
 /** Event name emitted when the dialog is closed. */
 export declare const CLOSED = "closed";
-declare const AdwPreferencesDialog_base: ((abstract new (...args: any[]) => {
-    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
-    disconnect(handlerId: number): void;
-    emit(eventName: string, ...args: unknown[]): void;
-    get_property(name: string): unknown;
-    set_property(name: string, value: unknown): void;
-    get halign(): string;
-    set halign(value: string | number);
-    get valign(): string;
-    set valign(value: string | number);
-    get hexpand(): boolean;
-    set hexpand(value: boolean | string);
-    get vexpand(): boolean;
-    set vexpand(value: boolean | string);
-    get marginStart(): number;
-    set marginStart(value: number | string);
-    get marginEnd(): number;
-    set marginEnd(value: number | string);
-    get visible(): boolean;
-    set visible(value: boolean | string);
-    get sensitive(): boolean;
-    set sensitive(value: boolean | string);
-    get name(): string;
-    set name(value: string | null);
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get tooltip_text(): string;
-    set tooltip_text(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
-    get_visible(): boolean;
-    set_visible(visible: boolean): void;
-    get_mapped(): boolean;
-    get_tooltip_text(): string;
-    set_tooltip_text(text: string): void;
-    set_direction(direction: number): void;
-    get_direction(): number;
-    get_first_child(): object | null;
-    get_last_child(): object | null;
-    get_next_sibling(): object | null;
-    get_prev_sibling(): object | null;
-    get_parent(): object | null;
-    insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get focusable(): boolean;
-    set focusable(value: boolean | string);
-    grab_focus(): boolean;
-    _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
-    notify<T extends EventData>(data: T): void;
-    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
-    set(name: string, value: unknown): void;
-    get(name: string): unknown;
-}) & {
-    readonly emittedSignals: readonly string[];
-}) & typeof GridLayout;
-export declare class AdwPreferencesDialog extends AdwPreferencesDialog_base {
+export declare class AdwPreferencesDialog extends AdwDialog {
     static readonly GTypeName: string;
-    protected readonly _card: GridLayout;
     protected readonly _headerBox: GridLayout;
     protected readonly _titleLabel: Label;
-    protected readonly _body: StackLayout;
-    /** The window `present (parent)` mounted this in, so closing can take it back out. */
-    private _host;
+    protected readonly _body: GridLayout;
     constructor(props?: ConstructProps<AdwPreferencesDialog>);
-    /** The dialog title. */
+    protected get _ownClass(): string;
+    /** `AdwDialog:title`, shown in the header. */
     get title(): string;
-    set title(value: string);
+    set title(value: string | null);
     /** Add an `AdwPreferencesPage` (or any view) to the dialog body. */
     add(view: View): void;
     /**
-     * An XML child is a page in the dialog BODY, not a child of the grid the dialog
-     * builds its header and scroller in — which is where `LayoutBase`'s inherited
-     * `_addChildFromBuilder` would have put it, on top of the title bar.
+     * An XML child is a page in the dialog BODY, not the dialog's `child` — which is
+     * where `AdwDialog`'s inherited `_addChildFromBuilder` would have put it, in place of
+     * the header and the body.
      */
     _addChildFromBuilder(_name: string, view: View): void;
     /** Remove a previously-added page from the body. */
@@ -101,19 +42,11 @@ export declare class AdwPreferencesDialog extends AdwPreferencesDialog_base {
      * keeps a results list populated before the user types.
      */
     search(query: string, options?: SearchPreferencesOptions): NsPreferencesSearchResult[];
-    /**
-     * Reveal the preferences overlay — `adw_dialog_present`.
-     *
-     * With a `parent` it is hosted in that widget's window like every other AdwDialog, so the
-     * window's back handling closes it first. Without one it must already sit in a layout.
-     */
-    present(parent?: View | null): void;
-    /** Hide the preferences overlay, take it out of its window and emit `closed`. */
-    close(): void;
-    /** Whether the dialog is currently shown. */
+    /** Whether the dialog is currently shown; writing it presents or closes. */
     get open(): boolean;
     set open(value: boolean | string);
-    /** The scrollable body that hosts the preferences pages. */
-    get body(): StackLayout;
+    /** The body that hosts the preferences pages. */
+    get body(): GridLayout;
+    /** One star row per page, in add order. */
+    private _layoutBody;
 }
-export {};

package/lib/types/widgets/adw-preferences-group.d.ts

@@ -2,7 +2,10 @@ import type { View } from '@nativescript/core';
 import { GridLayout, Label, StackLayout } from '@nativescript/core';
 import type { NsSearchableGroup, NsSearchableRow } from './preferences-search.js';
 import { type ConstructProps } from './construct-props.js';
+import { type AdwStyleClassesInput } from './style-classes.js';
 declare const AdwPreferencesGroup_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -49,10 +52,12 @@ declare const AdwPreferencesGroup_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     notify<T extends import("@nativescript/core").EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;
@@ -77,6 +82,7 @@ export declare class AdwPreferencesGroup extends AdwPreferencesGroup_base implem
     private _title;
     private _description;
     private _headerSuffix;
+    private readonly _classList;
     constructor(props?: ConstructProps<AdwPreferencesGroup>);
     /**
      * The group title (dim, uppercase header above the boxed list).
@@ -152,5 +158,22 @@ export declare class AdwPreferencesGroup extends AdwPreferencesGroup_base implem
     private _setFlushTop;
     /** The boxed-list container (column of rows). */
     get listbox(): StackLayout;
+    /**
+     * `GtkWidget:css-classes`, spelled `styleClasses` (`style-classes.ts`). Learn6502's colour groups
+     * are `css-classes: ["custom-color-group"]`.
+     */
+    get styleClasses(): string[];
+    set styleClasses(value: AdwStyleClassesInput);
+    /** `gtk_widget_add_css_class`. */
+    add_css_class(name: string): void;
+    /** `gtk_widget_remove_css_class`. */
+    remove_css_class(name: string): void;
+    /** `gtk_widget_has_css_class`. */
+    has_css_class(name: string): boolean;
+    /** `gtk_widget_get_css_classes` — the list, without the widget's own class. */
+    get_css_classes(): string[];
+    /** `gtk_widget_set_css_classes` — REPLACES the list. */
+    set_css_classes(names: readonly string[]): void;
+    private _restyle;
 }
 export {};

package/lib/types/widgets/adw-preferences-page.d.ts

@@ -2,7 +2,10 @@ import type { View } from '@nativescript/core';
 import { ScrollView, StackLayout } from '@nativescript/core';
 import type { NsSearchableGroup, NsSearchablePage } from './preferences-search.js';
 import { type ConstructProps } from './construct-props.js';
+import { type AdwStyleClassesInput } from './style-classes.js';
 declare const AdwPreferencesPage_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -49,10 +52,12 @@ declare const AdwPreferencesPage_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     notify<T extends import("@nativescript/core").EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;
@@ -84,6 +89,7 @@ export declare class AdwPreferencesPage extends AdwPreferencesPage_base implemen
     private _name;
     private _iconName;
     private _useUnderline;
+    private readonly _classList;
     constructor(props?: ConstructProps<AdwPreferencesPage>);
     /**
      * `AdwPreferencesPage:title` — shown by a view switcher and by the search
@@ -123,5 +129,23 @@ export declare class AdwPreferencesPage extends AdwPreferencesPage_base implemen
     searchGroups(): readonly NsSearchableGroup[];
     /** The vertical content stack holding the groups. */
     get groups(): StackLayout;
+    /**
+     * `GtkWidget:css-classes`, spelled `styleClasses` (`style-classes.ts`). A `.blp` scopes a page's
+     * CSS with `css-classes: ["appearance-page"]`, and the shared-tree builder refuses a class
+     * the widget has no door for.
+     */
+    get styleClasses(): string[];
+    set styleClasses(value: AdwStyleClassesInput);
+    /** `gtk_widget_add_css_class`. */
+    add_css_class(name: string): void;
+    /** `gtk_widget_remove_css_class`. */
+    remove_css_class(name: string): void;
+    /** `gtk_widget_has_css_class`. */
+    has_css_class(name: string): boolean;
+    /** `gtk_widget_get_css_classes` — the list, without the widget's own class. */
+    get_css_classes(): string[];
+    /** `gtk_widget_set_css_classes` — REPLACES the list. */
+    set_css_classes(names: readonly string[]): void;
+    private _restyle;
 }
 export {};

package/lib/types/widgets/adw-shortcut-label.d.ts

@@ -1,6 +1,8 @@
 import { StackLayout } from '@nativescript/core';
 import { type ConstructProps } from './construct-props.js';
 declare const AdwShortcutLabel_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -47,10 +49,12 @@ declare const AdwShortcutLabel_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     notify<T extends import("@nativescript/core").EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;

package/lib/types/widgets/adw-sidebar.d.ts

@@ -27,6 +27,8 @@ export interface SidebarActivatedEventData extends EventData {
     title: string;
 }
 declare const AdwSidebar_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -73,10 +75,12 @@ declare const AdwSidebar_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     notify<T extends EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;

package/lib/types/widgets/adw-slider-row.d.ts

@@ -9,6 +9,8 @@ export interface NotifySliderValueEventData extends EventData {
     value: number;
 }
 declare const AdwSliderRow_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -55,10 +57,12 @@ declare const AdwSliderRow_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     notify<T extends EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;

package/lib/types/widgets/adw-spinner.d.ts

@@ -1,8 +1,15 @@
 import { GridLayout } from '@nativescript/core';
 import { DEFAULT_SPINNER_SIZE } from './chrome.js';
 import { type ConstructProps } from './construct-props.js';
+import type { GObjectNotify } from './signals.js';
 export { DEFAULT_SPINNER_SIZE };
+/** Event name emitted when {@link AdwSpinner.spinning} changes. */
+export declare const NOTIFY_SPINNING = "notify::spinning";
+/** Event name emitted when {@link AdwSpinner.size} changes. */
+export declare const NOTIFY_SIZE = "notify::size";
 declare const AdwSpinner_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -49,10 +56,12 @@ declare const AdwSpinner_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     notify<T extends import("@nativescript/core").EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;
@@ -62,18 +71,11 @@ declare const AdwSpinner_base: ((abstract new (...args: any[]) => {
 }) & typeof GridLayout;
 export declare class AdwSpinner extends AdwSpinner_base {
     static readonly GTypeName: string;
-    /** The platform indicator — the RING, capped at 64 DIPs. */
-    private readonly _indicator;
-    /** The requested BOX size, floored at the measured minimum 16. */
-    private _size;
-    /** Whether the consumer wants it spinning, independent of whether it is mapped. */
-    private _spinning;
-    constructor(props?: ConstructProps<AdwSpinner>);
-    private _applySize;
-    private _applySpinning;
-    /** Whether the spinner is animating. Gated on being mapped, as in GTK. */
-    get spinning(): boolean;
-    set spinning(value: boolean | string);
+    /**
+     * Whether the spinner is animating. Gated on being mapped, as in GTK. A string from XML is
+     * parsed to a boolean by the seam; anything but `'true'` / `'false'` throws.
+     */
+    spinning: boolean;
     /**
      * The BOX size in DIPs — what was requested, floored at the measured
      * minimum 16 and NOT capped.
@@ -83,8 +85,14 @@ export declare class AdwSpinner extends AdwSpinner_base {
      * the 64 cap lives. The two used to be one number, so an oversized spinner
      * silently took 64 DIPs of layout instead of the 200 it was given.
      */
-    get size(): number;
-    set size(value: number | string);
+    size: number;
+    /** `notify('size')` beside NativeScript's `notify({ eventName })` — see {@link GObjectNotify}. */
+    notify: GObjectNotify;
+    /** The platform indicator — the RING, capped at 64 DIPs. */
+    private readonly _indicator;
+    constructor(props?: ConstructProps<AdwSpinner>);
+    private _applySize;
+    private _applySpinning;
     /** The drawn ring diameter — `spinnerGeometry`, capped at 64. */
     get ringDiameter(): number;
 }

package/lib/types/widgets/adw-split-button.d.ts

@@ -24,6 +24,8 @@ export interface MenuTappedEventData extends EventData {
     action?: string;
 }
 declare const AdwSplitButton_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -70,10 +72,12 @@ declare const AdwSplitButton_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     notify<T extends EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;

package/lib/types/widgets/adw-status-page.d.ts

@@ -3,6 +3,8 @@ import { GridLayout, Label, StackLayout } from '@nativescript/core';
 import { GtkImage } from './gtk-image.js';
 import { type ConstructProps } from './construct-props.js';
 declare const AdwStatusPage_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -49,10 +51,12 @@ declare const AdwStatusPage_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
     notify<T extends import("@nativescript/core").EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;

package/lib/types/widgets/adw-switch-row.d.ts

@@ -1,25 +1,33 @@
-import { Switch, type EventData } from '@nativescript/core';
+import { Switch } from '@nativescript/core';
 import { AdwActionRow } from './adw-action-row.js';
 import { type ConstructProps } from './construct-props.js';
-/** Event name emitted when {@link AdwSwitchRow.active} changes. Mirrors GObject `notify::active`. */
+/**
+ * Event name emitted when {@link AdwSwitchRow.active} changes. Mirrors GObject `notify::active`,
+ * and like every declared member it is subscribed with `connect` alone (see `signals.ts`).
+ *
+ * There is no payload TYPE to go with it: a real `notify::` carries a `GParamSpec`, not the
+ * value, and the seam hands a handler the port's plain `{ eventName, object }` on both legs.
+ * Read the state off the emitter — `(self) => self.active`.
+ */
 export declare const NOTIFY_ACTIVE = "notify::active";
-/** Payload of the `notify::active` event. */
-export interface NotifyActiveEventData extends EventData {
-    /** The new `active` state. */
-    active: boolean;
-}
-export declare class AdwSwitchRow extends AdwActionRow {
+declare const AdwSwitchRow_base: ((abstract new (...args: any[]) => {
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
+    notify<T extends import("@nativescript/core").EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & {
+    readonly emittedSignals: readonly string[];
+}) & typeof AdwActionRow;
+export declare class AdwSwitchRow extends AdwSwitchRow_base {
     static readonly GTypeName: string;
-    /** What the builder checks before it binds to `active`, one way or both. */
-    static readonly emittedSignals: readonly string[];
+    /** Whether the switch is on. */
+    active: boolean;
     /** The suffix Switch control. */
     protected readonly _switch: Switch;
-    /** The headless active flag + its notify rule (ADR 0004). */
-    private readonly _switchState;
     constructor(props?: ConstructProps<AdwSwitchRow>);
-    /** Whether the switch is on. */
-    get active(): boolean;
-    set active(value: boolean | string);
     get_active(): boolean;
     set_active(active: boolean): void;
     /**
@@ -34,10 +42,7 @@ export declare class AdwSwitchRow extends AdwActionRow {
      * that — `row-press.ts` reasons about the same propagation for its highlight.
      */
     activate(): void;
-    /**
-     * Push a state transition out to the Switch and emit `notify::active` — only
-     * when something actually changed, which is the `g_object_notify` gate
-     * libadwaita puts on the same transition (C:224-225 → :76).
-     */
+    /** Push the state out to the `Switch`. Run from `notify::active`, which is already the gate. */
     private _apply;
 }
+export {};

package/lib/types/widgets/adw-tab-view.d.ts

@@ -24,6 +24,8 @@ export interface ClosePageEventData extends EventData {
     index: number;
 }
 declare const AdwTabView_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -70,10 +72,12 @@ declare const AdwTabView_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): void;
-    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
-    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     notify<T extends EventData>(data: T): void;
     notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
     set(name: string, value: unknown): void;