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

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

@@ -18,6 +18,8 @@ export interface PageChangedEventData extends EventData {
     index: number;
 }
 declare const AdwCarousel_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;
@@ -64,10 +66,12 @@ declare const AdwCarousel_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-clamp.d.ts

@@ -4,6 +4,8 @@ import { DEFAULT_CLAMP_MAX_SIZE, DEFAULT_CLAMP_TIGHTENING_THRESHOLD } from './ch
 import { type ConstructProps } from './construct-props.js';
 export { DEFAULT_CLAMP_MAX_SIZE, DEFAULT_CLAMP_TIGHTENING_THRESHOLD };
 declare const AdwClamp_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;
@@ -50,10 +52,12 @@ declare const AdwClamp_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-data-grid.d.ts

@@ -10,6 +10,8 @@ export interface RowActivatedEventData extends EventData {
     row: AdwDataGridRow;
 }
 declare const AdwDataGrid_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;
@@ -56,10 +58,12 @@ declare const AdwDataGrid_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-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-entry-row.d.ts

@@ -1,44 +1,78 @@
-import { Label, StackLayout, TextField, type EventData, type View } from '@nativescript/core';
-import { EntryRowState, type EntryRowRenderState } from '@gjsify/adwaita-core';
+import { Label, StackLayout, TextField, type View } from '@nativescript/core';
+import { type EntryRowRenderState } from '@gjsify/adwaita-core';
 import { AdwActionRow } from './adw-action-row.js';
 import { GtkImage } from './gtk-image.js';
 import { AdwImageButton } from './adw-image-button.js';
 import { type ConstructProps } from './construct-props.js';
-export { EntryRowState } from '@gjsify/adwaita-core';
 export type { EntryRowRenderState, EntryRowActivation } from '@gjsify/adwaita-core';
 /** Event name emitted when {@link AdwEntryRow.text} changes. Mirrors GObject `notify::text`. */
 export declare const NOTIFY_TEXT = "notify::text";
 /** Event name emitted when the character count changes. */
 export declare const NOTIFY_TEXT_LENGTH = "notify::text-length";
+/** Event name emitted when {@link AdwEntryRow.maxLength} changes. */
+export declare const NOTIFY_MAX_LENGTH = "notify::max-length";
+/** Event name emitted when {@link AdwEntryRow.editable} changes. */
+export declare const NOTIFY_EDITABLE = "notify::editable";
+/** Event name emitted when {@link AdwEntryRow.showApplyButton} changes. */
+export declare const NOTIFY_SHOW_APPLY_BUTTON = "notify::show-apply-button";
+/** Event name emitted when {@link AdwEntryRow.activatesDefault} changes. */
+export declare const NOTIFY_ACTIVATES_DEFAULT = "notify::activates-default";
 /** `AdwEntryRow::apply` — the apply button, or the return key while it shows. */
 export declare const SIGNAL_APPLY = "apply";
-/** `AdwEntryRow::entry-activated` — the return key when there is nothing to apply. */
+/**
+ * `AdwEntryRow::entry-activated` — the return key when there is nothing to apply.
+ *
+ * No parameters, as upstream declares it. The C activates the default widget itself before
+ * emitting and NativeScript has no default-widget concept, so that ordering is the host's
+ * here — and what it needs to know is the row's own `activates-default`, which a handler
+ * reads off the emitter: `(self) => self.activatesDefault`.
+ */
 export declare const SIGNAL_ENTRY_ACTIVATED = "entry-activated";
-/** Payload of the `notify::text` event. */
-export interface NotifyTextEventData extends EventData {
-    text: string;
-}
-/** Payload of the `notify::text-length` event. */
-export interface NotifyTextLengthEventData extends EventData {
-    /** The new number of CHARACTERS (not UTF-16 units). */
-    textLength: number;
-}
-/** Payload of the `entry-activated` event. */
-export interface EntryActivatedEventData extends EventData {
-    /**
-     * Whether the host must activate its default action FIRST — C calls
-     * `gtk_widget_activate_default` before emitting, and NS has no default-widget
-     * concept, so the ordering becomes the host's.
-     */
-    activateDefault: boolean;
-}
-export declare class AdwEntryRow extends AdwActionRow {
+declare const AdwEntryRow_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 AdwEntryRow extends AdwEntryRow_base {
     static readonly GTypeName: string;
     /** `AdwEntryRow` derives from `AdwPreferencesRow` in C, so the preferences search
      *  must NOT read the text typed into it. */
     readonly isActionRow: boolean;
-    /** The headless `update_empty` derivation + apply latch (ADR 0004). */
-    protected readonly _state: EntryRowState;
+    /** The editable text, truncated to {@link maxLength} by the property's normalizer. */
+    text: string;
+    /**
+     * `Adw.EntryRow:text-length` — the number of CHARACTERS, not UTF-16 units.
+     *
+     * READ-ONLY, as upstream declares it: a write is normalized back to the count derived from
+     * this row's own {@link text}, so it resolves to the value already held and changes nothing
+     * (module header). Not `readonly` in TypeScript, because the seam installs one accessor pair
+     * per declared property and the row itself is what writes the derived value.
+     */
+    textLength: number;
+    /** `Adw.EntryRow:max-length` — maximum number of characters, `0` = unlimited. */
+    maxLength: number;
+    /** Whether the entry accepts edits (`GtkEditable:editable`). */
+    editable: boolean;
+    /** `Adw.EntryRow:show-apply-button` — typing reveals an apply button. */
+    showApplyButton: boolean;
+    /** `Adw.EntryRow:activates-default` — read by the host on `entry-activated`. */
+    activatesDefault: boolean;
+    /**
+     * `priv->editing` — whether the embedded entry has focus. A private field and NOT a declared
+     * property, because it is not one upstream either: `text_state_flags_changed_cb` keeps it,
+     * nothing outside the widget may set it, and the focus events below are its only writers.
+     */
+    private _editing;
+    /** The private `adw_entry_row_set_show_indicator` hook's state — see {@link setShowIndicator}. */
+    private _showIndicator;
+    /** `priv->text_changed` — the pending-apply latch. Private upstream too. */
+    private _textChanged;
     /** The TextField stacked below the title in column 0. */
     protected readonly _field: TextField;
     /** The large placeholder title (`empty_title` in adw-entry-row.ui). */
@@ -52,28 +86,11 @@ export declare class AdwEntryRow extends AdwActionRow {
     protected readonly _applyButton: AdwImageButton;
     /** The suffix installed through the inherited single-slot {@link add_suffix}. */
     private _slotSuffix;
-    private _lastText;
-    private _lastLength;
     constructor(props?: ConstructProps<AdwEntryRow>);
-    /** The editable text. */
-    get text(): string;
-    set text(value: string);
-    /** `Adw.EntryRow:text-length` — the number of CHARACTERS, not UTF-16 units. */
-    get textLength(): number;
-    /** `Adw.EntryRow:max-length` — maximum number of characters, `0` = unlimited. */
-    get maxLength(): number;
-    set maxLength(raw: number | string);
-    /** Whether the entry accepts edits (`GtkEditable:editable`). */
-    get editable(): boolean;
-    set editable(raw: boolean | string);
-    /** `Adw.EntryRow:show-apply-button` — typing reveals an apply button. */
-    get showApplyButton(): boolean;
-    set showApplyButton(raw: boolean | string);
-    /** `Adw.EntryRow:activates-default` — reported on `entry-activated`, acted on by the host. */
-    get activatesDefault(): boolean;
-    set activatesDefault(raw: boolean | string);
-    /** Whether the field currently has focus. */
+    /** Whether the field currently has focus — `priv->editing`, not a property upstream. */
     get editing(): boolean;
+    /** The pending-apply latch — `true` exactly while the apply button shows. */
+    get textChanged(): boolean;
     /**
      * Append a suffix — `adw_entry_row_add_suffix` appends into a BOX, so suffixes
      * COEXIST here as upstream, unlike the one-slot rule `AdwActionRow.add_suffix` states.
@@ -95,13 +112,33 @@ export declare class AdwEntryRow extends AdwActionRow {
     setShowIndicator(show: boolean): void;
     /** `adw_entry_row_set_indicator_icon_name`, as an Adwaita symbolic SVG. */
     setIndicatorIcon(svg: string): void;
-    /** Apply the pending edit — the apply button tap. */
+    /** Apply the pending edit — the apply button tap (`apply_button_clicked_cb`). */
     apply(): void;
-    /** `text_activated_cb` — exactly one of the two signals. */
+    /** `text_activated_cb` — exactly one of the two signals, never both. */
     private _activate;
+    /**
+     * Re-run `update_empty` over the row's current inputs and paint the result — the one place
+     * the derivation is read, standing in for the subscription the state object used to push.
+     */
+    protected _update(): void;
     /** Paint one render snapshot through the shared (spec-driven) painter. */
     protected _render(state: EntryRowRenderState): void;
     /** Base class list this row paints its state classes onto. */
     protected get _baseClassName(): string;
-    private _onStateChanged;
+    /** Feed the focus state in — `text_state_flags_changed_cb`, guarded as the C's flag is. */
+    private _setEditing;
+    /**
+     * `text_changed_cb` (C:166-174) plus the derived count.
+     *
+     * `text-length` SETTLES INSIDE THIS EMISSION, so a handler of `notify::text` reads the new
+     * count off the emitter — and a handler of both sees `notify::text-length` first, because a
+     * notify emitted from within another one nests. That is what deriving a property from a
+     * property costs in GObject, with no `g_object_freeze_notify` in this seam to reorder it;
+     * the old payload-carrying events had the opposite order and no emitter to read.
+     */
+    private _onTextChanged;
+    /** Over-long contents are truncated the moment the limit drops — `adw_entry_row_set_max_length`. */
+    private _onMaxLengthChanged;
+    /** Turning the apply button OFF retracts a pending apply; turning it on derives nothing (C:989-992). */
+    private _onShowApplyButtonChanged;
 }

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-password-entry-row.d.ts

@@ -13,7 +13,12 @@ export interface NotifyRevealedEventData extends EventData {
 }
 export declare class AdwPasswordEntryRow extends AdwEntryRow {
     static readonly GTypeName: string;
-    /** The headless peek + caps-lock derivation, composing the parent row's state. */
+    /**
+     * The headless peek + caps-lock derivation, composing the parent ROW — since the entry row
+     * became a real GObject (ADR 0105 § 2) there is no `EntryRowState` beside it to hand over,
+     * and the composition never wanted one: all it reaches the parent through is the private
+     * `setShowIndicator` hook, which the row itself answers.
+     */
     private readonly _password;
     /** The trailing peek (reveal/conceal) toggle button. */
     protected readonly _peekButton: AdwImageButton;

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;