@gjsify/adwaita-nativescript 0.48.0 → 0.50.0

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

@@ -1,5 +1,6 @@
 import { ScrollView, StackLayout, type EventData } from '@nativescript/core';
 import type { AdwSidebarItemSpec, AdwSidebarSectionSpec, SidebarItemFilter } from './sidebar-model.js';
+import { type ConstructProps } from './construct-props.js';
 /** Event name emitted when {@link AdwSidebar.selected} changes. Mirrors GObject `notify::selected`. */
 export declare const NOTIFY_SELECTED = "notify::selected";
 /**
@@ -25,12 +26,23 @@ export interface SidebarActivatedEventData extends EventData {
     /** The activated item's label. */
     title: string;
 }
-export declare class AdwSidebar extends ScrollView {
+declare const AdwSidebar_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof ScrollView;
+export declare class AdwSidebar extends AdwSidebar_base {
     /** The vertical list container. */
     protected readonly _list: StackLayout;
     private readonly _state;
     private readonly _rows;
-    constructor();
+    constructor(props?: ConstructProps<AdwSidebar>);
     /** Set the navigation item labels — one untitled section. Rebuilds the tappable rows. */
     setItems(items: string[]): void;
     /** Set the full section model (titles, subtitles, icons, per-item `visible`/`enabled`). */
@@ -67,3 +79,4 @@ export declare class AdwSidebar extends ScrollView {
     /** Whether the FILTERED row list is empty — the `.empty` / placeholder state. */
     get isEmpty(): boolean;
 }
+export {};

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

@@ -1,5 +1,6 @@
 import { Label, Slider, StackLayout, type EventData } from '@nativescript/core';
 import type { AdwAdjustment, AdwAdjustmentInput } from '@gjsify/adwaita-core';
+import { type ConstructProps } from './construct-props.js';
 /** Event name emitted when {@link AdwSliderRow.value} changes. Mirrors GObject `notify::value`. */
 export declare const NOTIFY_SLIDER_VALUE = "notify::value";
 /** Payload of the `notify::value` event. */
@@ -7,7 +8,18 @@ export interface NotifySliderValueEventData extends EventData {
     /** The new numeric value (already clamped into the adjustment's range and snapped to a tick). */
     value: number;
 }
-export declare class AdwSliderRow extends StackLayout {
+declare const AdwSliderRow_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof StackLayout;
+export declare class AdwSliderRow extends AdwSliderRow_base {
     /** The title label (header, left). */
     protected readonly _titleLabel: Label;
     /** The live value label (header, right, dim). */
@@ -18,7 +30,7 @@ export declare class AdwSliderRow extends StackLayout {
     private readonly _state;
     /** Guards the slider's `valueChange` while we programmatically set its value. */
     private _suppress;
-    constructor();
+    constructor(props?: ConstructProps<AdwSliderRow>);
     /** Push the current value to the slider + label without emitting. */
     private _sync;
     /** The group title shown in the header (left). */
@@ -40,3 +52,4 @@ export declare class AdwSliderRow extends StackLayout {
     /** The underlying {@link Slider} (e.g. to tweak styling). */
     get slider(): Slider;
 }
+export {};

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

@@ -3,6 +3,7 @@ import type { EventData } from '@nativescript/core';
 import type { AdwAdjustment, AdwAdjustmentInput } from '@gjsify/adwaita-core';
 import { AdwActionRow } from './adw-action-row.js';
 import { AdwImageButton } from './adw-image-button.js';
+import { type ConstructProps } from './construct-props.js';
 export { SpinState } from '@gjsify/adwaita-core';
 export type { AdwAdjustment, AdwAdjustmentInput, SpinStateChange, SpinStateListener } from '@gjsify/adwaita-core';
 /** Event name emitted when {@link AdwSpinRow.value} changes. Mirrors GObject `notify::value`. */
@@ -21,7 +22,7 @@ export declare class AdwSpinRow extends AdwActionRow {
     protected readonly _valueLabel: Label;
     /** The headless adjustment: clamp, step and the two signals (ADR 0004, ADR 0047). */
     private readonly _state;
-    constructor();
+    constructor(props?: ConstructProps<AdwSpinRow>);
     /** The current numeric value (always within the adjustment's range). */
     get value(): number;
     set value(v: number | string);

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

@@ -1,14 +1,26 @@
 import { GridLayout } from '@nativescript/core';
 import { DEFAULT_SPINNER_SIZE } from './chrome.js';
+import { type ConstructProps } from './construct-props.js';
 export { DEFAULT_SPINNER_SIZE };
-export declare class AdwSpinner extends GridLayout {
+declare const AdwSpinner_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof GridLayout;
+export declare class AdwSpinner extends AdwSpinner_base {
     /** 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();
+    constructor(props?: ConstructProps<AdwSpinner>);
     private _applySize;
     private _applySpinning;
     /** Whether the spinner is animating. Gated on being mapped, as in GTK. */

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

@@ -1,6 +1,7 @@
 import { GridLayout, Label, StackLayout, type EventData } from '@nativescript/core';
 import type { AdwMenuActions, AdwMenuInput, AdwMenuModel, SplitButtonDirection } from '@gjsify/adwaita-core';
 import { GtkImage } from './gtk-image.js';
+import { type ConstructProps } from './construct-props.js';
 /** Event name emitted when the main action part is tapped. Mirrors `Adw.SplitButton::clicked`. */
 export declare const CLICKED = "clicked";
 /** Event name emitted when a dropdown menu item is chosen. */
@@ -20,7 +21,18 @@ export interface MenuTappedEventData extends EventData {
     /** The chosen item's detailed action name, when the item carried one. */
     action?: string;
 }
-export declare class AdwSplitButton extends GridLayout {
+declare const AdwSplitButton_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof GridLayout;
+export declare class AdwSplitButton extends AdwSplitButton_base {
     /** The main action part (column 0). */
     protected readonly _actionPart: StackLayout;
     /** The action label (shown in label mode). */
@@ -45,7 +57,7 @@ export declare class AdwSplitButton extends GridLayout {
      * state to contradict it. One polarity, so there is nothing to forget.
      */
     private _sensitive;
-    constructor();
+    constructor(props?: ConstructProps<AdwSplitButton>);
     /**
      * Present the dropdown menu and dispatch the choice BY POSITION.
      *
@@ -128,3 +140,4 @@ export declare class AdwSplitButton extends GridLayout {
     /** The main action part (for composing a custom content widget). */
     get actionButton(): StackLayout;
 }
+export {};

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

@@ -1,12 +1,24 @@
 import type { View } from '@nativescript/core';
 import { GridLayout, Label, StackLayout } from '@nativescript/core';
 import { GtkImage } from './gtk-image.js';
-export declare class AdwStatusPage extends GridLayout {
+import { type ConstructProps } from './construct-props.js';
+declare const AdwStatusPage_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof GridLayout;
+export declare class AdwStatusPage extends AdwStatusPage_base {
     /** The centered vertical stack. */
     protected readonly _stack: StackLayout;
     /** The large symbolic icon (shown when an `icon` SVG is set). */
     protected readonly _icon: GtkImage;
-    private _iconSvg;
+    private _iconName;
     /** The large glyph label (shown when `iconText` is set — the legacy fallback). */
     protected readonly _iconLabel: Label;
     private _iconGlyph;
@@ -15,9 +27,10 @@ export declare class AdwStatusPage extends GridLayout {
     /** The dim description label. */
     protected readonly _descriptionLabel: Label;
     private _child;
-    constructor();
+    constructor(props?: ConstructProps<AdwStatusPage>);
     /**
-     * A large Adwaita symbolic SVG string shown above the title (e.g.
+     * The large icon shown above the title — an Adwaita icon NAME
+     * (`'folder-symbolic'`) or a symbolic SVG SOURCE string (e.g.
      * `folderSymbolic`). Setting a non-empty value shows the symbolic icon; empty
      * hides it. Matches `Adw.StatusPage`'s themed icon. Mutually exclusive with
      * {@link iconText} — whichever was set last wins.
@@ -43,8 +56,8 @@ export declare class AdwStatusPage extends GridLayout {
      */
     get description(): string;
     set description(value: string);
-    /** Set (or replace) the optional child widget below the description. */
-    setChild(view: View | null): void;
+    /** Set (or replace) the optional child widget below the description — `adw_status_page_set_child`. */
+    set_child(view: View | null): void;
     /** The currently-installed child, or `null`. */
     get child(): View | null;
     /**
@@ -55,3 +68,4 @@ export declare class AdwStatusPage extends GridLayout {
      */
     _addChildFromBuilder(_name: string, view: View): void;
 }
+export {};

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

@@ -1,5 +1,6 @@
 import { Switch, type EventData } 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`. */
 export declare const NOTIFY_ACTIVE = "notify::active";
 /** Payload of the `notify::active` event. */
@@ -12,7 +13,7 @@ export declare class AdwSwitchRow extends AdwActionRow {
     protected readonly _switch: Switch;
     /** The headless active flag + its notify rule (ADR 0004). */
     private readonly _switchState;
-    constructor();
+    constructor(props?: ConstructProps<AdwSwitchRow>);
     /** Whether the switch is on. */
     get active(): boolean;
     set active(value: boolean | string);

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

@@ -2,6 +2,7 @@ import { GridLayout, type EventData, type View } from '@nativescript/core';
 import type { AdwTabPageSpec, TabViewPagesChange } from '@gjsify/adwaita-core';
 import { type AdwTabPage, type TabViewNotifyPayload } from './tab-view-state.js';
 import type { AdwViewPage } from './view-switcher-base.js';
+import { type ConstructProps } from './construct-props.js';
 export type { AdwTabPage };
 /** Event name emitted when the selected page changes. Mirrors `notify::selected-page`. */
 export declare const NOTIFY_SELECTED_PAGE = "notify::selected-page";
@@ -22,7 +23,18 @@ export interface ClosePageEventData extends EventData {
     /** Its index while it is still in the view. */
     index: number;
 }
-export declare class AdwTabView extends GridLayout {
+declare const AdwTabView_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof GridLayout;
+export declare class AdwTabView extends AdwTabView_base {
     private readonly _state;
     private readonly _bar;
     private readonly _contentArea;
@@ -42,7 +54,7 @@ export declare class AdwTabView extends GridLayout {
      * and deciding stay separable.
      */
     closeHandler: ((page: AdwTabPage) => boolean | 'defer') | null;
-    constructor();
+    constructor(props?: ConstructProps<AdwTabView>);
     /** All pages in order. */
     get pages(): readonly AdwTabPage[];
     /** Number of pages. */
@@ -53,14 +65,28 @@ export declare class AdwTabView extends GridLayout {
     get selectedId(): string | null;
     /** Index of the selected page, `-1` when the view is empty — never 0 for an empty view. */
     get selectedIndex(): number;
-    /** The selected page index. Setting it IGNORES a non-integer or out-of-range value. */
-    get selected(): number;
-    set selected(raw: number | string);
+    /**
+     * The selected page (`Adw.TabView:selected-page`), `null` when the view is empty.
+     *
+     * THE PAGE, NOT ITS POSITION (ADR 0048). `Adw.TabView` is the one widget in this port
+     * whose counterpart selects by OBJECT rather than by name or by ordinal, and the model
+     * has held that object all along — this getter is the door onto it.
+     *
+     * READS THE PAGE, WRITES THE ID: the setter below takes the id this port uses as its
+     * page handle, because that is what an XML attribute can carry. TypeScript allows the
+     * two halves to differ, so `view.selectedPage = view.selectedPage` is a type error
+     * rather than a silent one — which is the intended reading, not an oversight.
+     */
+    get selectedPage(): AdwTabPage | null;
+    set selectedPage(id: string | null);
     isClosing(id: string): boolean;
-    setSelectedPage(id: string | null): boolean;
+    /** `adw_tab_view_set_selected_page`. The page, or the id this port uses as its handle. */
+    set_selected_page(page: AdwTabPage | string | null): boolean;
     selectNthPage(n: number): boolean;
-    selectPreviousPage(): boolean;
-    selectNextPage(): boolean;
+    /** `adw_tab_view_select_previous_page`. */
+    select_previous_page(): boolean;
+    /** `adw_tab_view_select_next_page`. */
+    select_next_page(): boolean;
     selectFirstPage(): boolean;
     selectLastPage(): boolean;
     /** The next page, WRAPPING to the first (Ctrl+Tab). */

package/lib/types/widgets/adw-toast-overlay.d.ts

@@ -1,12 +1,24 @@
 import type { View } from '@nativescript/core';
-import { Button, GridLayout, Label } from '@nativescript/core';
+import { Button, GridLayout, Label, type EventData } from '@nativescript/core';
 import { AdwToast } from '@gjsify/adwaita-core';
 import type { AdwToastOptions } from '@gjsify/adwaita-core';
+import { type ConstructProps } from './construct-props.js';
 export { AdwToast, AdwToastQueue, DEFAULT_TOAST_TIMEOUT } from '@gjsify/adwaita-core';
 export type { AdwToastOptions, AdwToastQueueHandlers, AdwToastQueueOptions, ToastScheduler, ToastTimerHandle, } from '@gjsify/adwaita-core';
 /** Event name emitted when a toast's action button is tapped. */
 export declare const TOAST_BUTTON_CLICKED = "toastButtonClicked";
-export declare class AdwToastOverlay extends GridLayout {
+declare const AdwToastOverlay_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof GridLayout;
+export declare class AdwToastOverlay extends AdwToastOverlay_base {
     /** The always-visible content layer. */
     private _content;
     /** The bottom-anchored toast strip. */
@@ -16,11 +28,11 @@ export declare class AdwToastOverlay extends GridLayout {
     private _hasButton;
     /** The headless one-at-a-time + auto-dismiss state machine (ADR 0004). */
     private readonly _queue;
-    constructor();
-    /** Set (or replace) the always-visible content layer (under the toast). */
-    setContent(view: View | null): void;
-    /** Enqueue a {@link AdwToast} descriptor (shows now, or after the current one). */
-    addToast(toast: AdwToast): void;
+    constructor(props?: ConstructProps<AdwToastOverlay>);
+    /** Set (or replace) the always-visible content layer (under the toast) — `adw_toast_overlay_set_child`. */
+    set_child(view: View | null): void;
+    /** Enqueue a {@link AdwToast} descriptor (shows now, or after the current one) — `adw_toast_overlay_add_toast`. */
+    add_toast(toast: AdwToast): void;
     /** Enqueue a transient toast with the given message and options. */
     showToast(title: string, options?: AdwToastOptions): void;
     /** Dismiss the current toast immediately (advances to the next queued one). */

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

@@ -1,4 +1,5 @@
 import { StackLayout, type EventData } from '@nativescript/core';
+import { type ConstructProps } from './construct-props.js';
 export { ToggleGroupState } from '@gjsify/adwaita-core';
 export type { ToggleGroupStateChange, ToggleGroupStateListener } from '@gjsify/adwaita-core';
 /** Event name emitted when {@link AdwToggleGroup.selected} changes. Mirrors GObject `notify::selected`. */
@@ -15,12 +16,23 @@ export interface AdwToggle {
     label: string;
     icon?: string;
 }
-export declare class AdwToggleGroup extends StackLayout {
+declare const AdwToggleGroup_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof StackLayout;
+export declare class AdwToggleGroup extends AdwToggleGroup_base {
     private _toggles;
     private readonly _segments;
     /** The headless labels + selected-index state machine (ADR 0004). */
     private readonly _state;
-    constructor();
+    constructor(props?: ConstructProps<AdwToggleGroup>);
     /** The segment labels (icon-less). Setting them rebuilds the toggle group. */
     get options(): string[];
     set options(value: string[]);

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

@@ -1,7 +1,19 @@
 import type { View } from '@nativescript/core';
 import { GridLayout, StackLayout } from '@nativescript/core';
 import { type AdwToolbarStyle } from './chrome.js';
-export declare class AdwToolbarView extends GridLayout {
+import { type ConstructProps } from './construct-props.js';
+declare const AdwToolbarView_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof GridLayout;
+export declare class AdwToolbarView extends AdwToolbarView_base {
     /** The top-bar slot (row 0) — stack of header bars / toolbars. */
     protected readonly _topBox: StackLayout;
     /** The bottom-bar slot (row 2) — stack of bottom toolbars. */
@@ -14,13 +26,13 @@ export declare class AdwToolbarView extends GridLayout {
     private _topBarCount;
     private _bottomBarCount;
     private _detachInsets;
-    constructor();
-    /** Append a widget (e.g. an {@link AdwHeaderBar}) to the top-bar slot. */
-    addTopBar(view: View): void;
-    /** Append a widget to the bottom-bar slot. */
-    addBottomBar(view: View): void;
-    /** Set (or replace) the main content view. Pass `null` to clear it. */
-    setContent(view: View | null): void;
+    constructor(props?: ConstructProps<AdwToolbarView>);
+    /** Append a widget (e.g. an {@link AdwHeaderBar}) to the top-bar slot — `adw_toolbar_view_add_top_bar`. */
+    add_top_bar(view: View): void;
+    /** Append a widget to the bottom-bar slot — `adw_toolbar_view_add_bottom_bar`. */
+    add_bottom_bar(view: View): void;
+    /** Set (or replace) the main content view — `adw_toolbar_view_set_content`. `null` clears it. */
+    set_content(view: View | null): void;
     /**
      * XML inflation — route a template's child through the slot API.
      *
@@ -92,3 +104,4 @@ export declare class AdwToolbarView extends GridLayout {
      */
     private _syncClasses;
 }
+export {};

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

@@ -1,6 +1,7 @@
 import type { View } from '@nativescript/core';
 import { GridLayout, type EventData } from '@nativescript/core';
 import { type AdwViewStackPage, type ViewStackNotifyPayload } from './view-stack-state.js';
+import { type ConstructProps } from './construct-props.js';
 export type { AdwViewStackPage };
 /** Event name emitted when the visible child changes. Mirrors GObject `notify::visible-child`. */
 export declare const NOTIFY_VISIBLE_CHILD = "notify::visible-child";
@@ -11,9 +12,20 @@ export declare const NOTIFY_VISIBLE_CHILD = "notify::visible-child";
  */
 export interface NotifyVisibleChildEventData extends EventData, ViewStackNotifyPayload {
 }
-export declare class AdwViewStack extends GridLayout {
+declare const AdwViewStack_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof GridLayout;
+export declare class AdwViewStack extends AdwViewStack_base {
     private readonly _state;
-    constructor();
+    constructor(props?: ConstructProps<AdwViewStack>);
     /**
      * Register a page. It becomes visible when nothing is selected yet — and,
      * unlike before, that auto-pick NOTIFIES, so a bound switcher highlights the
@@ -22,7 +34,7 @@ export declare class AdwViewStack extends GridLayout {
      */
     add(content: View, name: string, title?: string, icon?: string): AdwViewStackPage;
     /** Convenience alias matching `Adw.ViewStack.add_titled`. */
-    addTitled(content: View, name: string, title: string): AdwViewStackPage;
+    add_titled(content: View, name: string, title: string): AdwViewStackPage;
     /**
      * Remove the first page named `name` and detach its content view. Returns
      * whether anything was removed. When the removed page was the visible one the
@@ -39,9 +51,30 @@ export declare class AdwViewStack extends GridLayout {
     setPageVisible(name: string, visible: boolean): boolean;
     /** All registered pages, in add order (a bound switcher reads this). */
     get pages(): readonly AdwViewStackPage[];
-    /** The visible page index, `-1` when nothing is selected. Swaps the visible page + emits. */
+    /**
+     * The visible page's position, `-1` when nothing is selected.
+     *
+     * A REPORT, NOT A DOOR (ADR 0048). `Adw.ViewStack` selects by NAME, and an ordinal
+     * is derived: an insertion before the visible page increments it, a reorder rewrites
+     * it and a removal decrements it — the three cases `ViewStackState` carries code for.
+     * So it is safe to read at a moment and unsafe to hold, and selecting is
+     * {@link visibleChildName}.
+     */
     get visibleChildIndex(): number;
-    set visibleChildIndex(raw: number | string);
+    /**
+     * Show the page at position `n`. Returns whether the selection moved.
+     *
+     * THE ORDINAL IS A CALL, NOT A PROPERTY (ADR 0048). It resolves against the page list
+     * as it is at THIS moment and keeps nothing, which is the whole difference from the
+     * setter it replaces: a held index silently comes to mean another page after an
+     * insert, a reorder or a removal. Port-owned — measured, `refs/libadwaita` gives
+     * `AdwViewStack` no ordinal API at all — and named for the `selectNthPage` the tab
+     * view already has, so the two widgets ask the same question the same way.
+     *
+     * A non-integer or out-of-range `n` selects nothing; the guard is the core's
+     * ({@link ViewStackState.setVisibleIndex}) and is pinned by the shared vectors.
+     */
+    selectNthPage(n: number): boolean;
     /** The visible page name (`Adw.ViewStack.visible-child-name`), `''` for none. */
     get visibleChildName(): string;
     set visibleChildName(name: string | null | undefined);

package/lib/types/widgets/adw-view-switcher-bar.d.ts

@@ -1,15 +1,27 @@
 import { GridLayout } from '@nativescript/core';
 import type { AdwViewStack } from './adw-view-stack.js';
-export declare class AdwViewSwitcherBar extends GridLayout {
+import { type ConstructProps } from './construct-props.js';
+declare const AdwViewSwitcherBar_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof GridLayout;
+export declare class AdwViewSwitcherBar extends AdwViewSwitcherBar_base {
     /** The horizontal (homogeneous) row of buttons. */
     private readonly _bar;
     private _nodes;
     private _stack;
     private _stackListener;
     private readonly _barState;
-    constructor();
+    constructor(props?: ConstructProps<AdwViewSwitcherBar>);
     /** Bind to an {@link AdwViewStack}: build buttons from its pages + two-way sync. */
-    setStack(stack: AdwViewStack | null): void;
+    set_stack(stack: AdwViewStack | null): void;
     /** The bound stack (`Adw.ViewSwitcherBar.stack`). */
     get stack(): AdwViewStack | null;
     set stack(value: AdwViewStack | null);
@@ -39,3 +51,4 @@ export declare class AdwViewSwitcherBar extends GridLayout {
     private _buildButton;
     private _applyRevealed;
 }
+export {};

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

@@ -1,6 +1,7 @@
 import { AdwViewSwitcherBase } from './view-switcher-base.js';
+import { type ConstructProps } from './construct-props.js';
 export declare class AdwViewSwitcher extends AdwViewSwitcherBase {
-    constructor();
+    constructor(props?: ConstructProps<AdwViewSwitcher>);
     protected get barClass(): string;
     protected get buttonClass(): string;
 }

package/lib/types/widgets/adw-window-title.d.ts

@@ -1,16 +1,28 @@
-import { Label, StackLayout } from '@nativescript/core';
+import { Label, StackLayout, type EventData } from '@nativescript/core';
+import { type ConstructProps } from './construct-props.js';
 /** Event name emitted when {@link AdwWindowTitle.title} changes. */
 export declare const NOTIFY_TITLE = "notify::title";
 /** Event name emitted when {@link AdwWindowTitle.subtitle} changes. */
 export declare const NOTIFY_SUBTITLE = "notify::subtitle";
-export declare class AdwWindowTitle extends StackLayout {
+declare const AdwWindowTitle_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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;
+}) & typeof StackLayout;
+export declare class AdwWindowTitle extends AdwWindowTitle_base {
     /** The bold title label. */
     protected readonly _titleLabel: Label;
     /** The dim subtitle label. */
     protected readonly _subtitleLabel: Label;
     /** The headless title/subtitle pair + change detection (ADR 0004). */
     private readonly _state;
-    constructor();
+    constructor(props?: ConstructProps<AdwWindowTitle>);
     /** The window title (bold, top line). Empty collapses its label. */
     get title(): string;
     set title(value: string);
@@ -21,3 +33,4 @@ export declare class AdwWindowTitle extends StackLayout {
     private _apply;
     private _notify;
 }
+export {};