@gjsify/adwaita-nativescript 0.47.0 → 0.49.0

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

@@ -1,14 +1,42 @@
 import type { View } from '@nativescript/core';
 import { ScrollView, StackLayout } from '@nativescript/core';
 import type { NsSearchableGroup, NsSearchablePage } from './preferences-search.js';
-export declare class AdwPreferencesPage extends ScrollView implements NsSearchablePage {
-    /** The vertical stack that actually holds the groups. */
-    protected readonly _content: StackLayout;
+import { type ConstructProps } from './construct-props.js';
+declare const AdwPreferencesPage_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 ScrollView;
+export declare class AdwPreferencesPage extends AdwPreferencesPage_base implements NsSearchablePage {
+    /**
+     * The vertical stack that actually holds the groups.
+     *
+     * NOT `_content`, which is what it was called first. `ContentView` — in this
+     * class's chain via `ScrollView` — uses `this._content` as the backing store for
+     * its own `content` accessor (`ui/content-view/index.js:12,15-21`). Sharing that
+     * name does not shadow the field, it IS the field: `readonly` becomes a
+     * compile-time fiction, because `set content` writes it, so any `page.content = x`
+     * silently re-points this handle and `add`/`searchGroups`/`groups` then work
+     * on the wrong view. No type-checker can catch it — `_content` appears in no
+     * `.d.ts` of `@nativescript/core`, only in the compiled JS.
+     *
+     * Five sibling widgets keep `_content` safely, because their chain runs
+     * `GridLayout → LayoutBase → CustomLayoutView` and never reaches `ContentView`.
+     * This class and `AdwSidebar` (which calls its stack `_list`) are the two on
+     * `ScrollView`, and so the two where the name is taken.
+     */
+    protected readonly _groups: StackLayout;
     private _title;
     private _name;
     private _iconName;
     private _useUnderline;
-    constructor();
+    constructor(props?: ConstructProps<AdwPreferencesPage>);
     /**
      * `AdwPreferencesPage:title` — shown by a view switcher and by the search
      * results, never by the page itself. `null` is the empty string
@@ -28,10 +56,10 @@ export declare class AdwPreferencesPage extends ScrollView implements NsSearchab
      */
     get useUnderline(): boolean;
     set useUnderline(value: boolean | string);
-    /** Append a preferences group (or any view) to the page. */
-    addGroup(view: View): void;
-    /** Remove a previously-added group from the page. */
-    removeGroup(view: View): void;
+    /** Append a preferences group (or any view) to the page — `adw_preferences_page_add`. */
+    add(view: View): void;
+    /** Remove a previously-added group from the page — `adw_preferences_page_remove`. */
+    remove(view: View): void;
     /**
      * An XML child is a GROUP. `ScrollView`'s inherited `_addChildFromBuilder` sets
      * `content`, which would REPLACE the page's own scroll body — one group in place
@@ -48,3 +76,4 @@ export declare class AdwPreferencesPage extends ScrollView implements NsSearchab
     /** The vertical content stack holding the groups. */
     get groups(): StackLayout;
 }
+export {};

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

@@ -1,8 +1,20 @@
 import { StackLayout } from '@nativescript/core';
-export declare class AdwShortcutLabel extends StackLayout {
+import { type ConstructProps } from './construct-props.js';
+declare const AdwShortcutLabel_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 StackLayout;
+export declare class AdwShortcutLabel extends AdwShortcutLabel_base {
     private _accelerator;
     private _disabledText;
-    constructor();
+    constructor(props?: ConstructProps<AdwShortcutLabel>);
     /** The accelerator to draw, in `gtk_accelerator_parse` syntax (`<Control>C`). */
     get accelerator(): string;
     set accelerator(value: string);
@@ -11,3 +23,4 @@ export declare class AdwShortcutLabel extends StackLayout {
     set disabledText(value: string);
     private _rebuild;
 }
+export {};

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,44 +1,55 @@
 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. */
 export interface NotifySliderValueEventData extends EventData {
-    /** The new numeric value (already clamped to `[min, max]` and snapped to `step`). */
+    /** 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). */
     protected readonly _valueLabel: Label;
     /** The horizontal slider. */
     protected readonly _slider: Slider;
-    private _value;
-    private _min;
-    private _max;
-    private _step;
+    /** The headless adjustment: clamp, step and the two signals (ADR 0004, ADR 0047). */
+    private readonly _state;
     /** Guards the slider's `valueChange` while we programmatically set its value. */
     private _suppress;
-    constructor();
-    /** Clamp to `[min, max]` then snap to the nearest `step` from `min`. */
-    private _snap;
+    constructor(props?: ConstructProps<AdwSliderRow>);
     /** Push the current value to the slider + label without emitting. */
     private _sync;
     /** The group title shown in the header (left). */
     get title(): string;
     set title(value: string);
-    /** The current numeric value (always within `[min, max]`, snapped to `step`). */
+    /** The current numeric value (always within the adjustment's range, snapped to a tick). */
     get value(): number;
     set value(raw: number | string);
-    /** Lower bound. Re-clamps the current value if it now falls below. */
-    get min(): number;
-    set min(raw: number | string);
-    /** Upper bound. Re-clamps the current value if it now falls above. */
-    get max(): number;
-    set max(raw: number | string);
-    /** Snap granularity applied as the slider is dragged. */
-    get step(): number;
-    set step(raw: number | string);
+    /**
+     * The numeric range this row slides through — the `Gtk.Adjustment` a `Gtk.Scale` is
+     * handed, under the same key the spin row uses.
+     *
+     * Reads back whole; writes MERGE, so `adjustment = { upper: 20 }` moves one bound and
+     * leaves the rest. From XML it is a JSON object —
+     * `adjustment='{"lower":0,"upper":20,"stepIncrement":5}'`.
+     */
+    get adjustment(): AdwAdjustment;
+    set adjustment(v: AdwAdjustmentInput | string);
     /** The underlying {@link Slider} (e.g. to tweak styling). */
     get slider(): Slider;
 }
+export {};

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

@@ -1,14 +1,16 @@
 import { Label } from '@nativescript/core';
 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 { SpinStateChange, SpinStateListener } 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`. */
 export declare const NOTIFY_VALUE = "notify::value";
 /** Payload of the `notify::value` event. */
 export interface NotifyValueEventData extends EventData {
-    /** The new numeric value (already clamped to `[min, max]`). */
+    /** The new numeric value (already clamped into the adjustment's range). */
     value: number;
 }
 export declare class AdwSpinRow extends AdwActionRow {
@@ -18,19 +20,21 @@ export declare class AdwSpinRow extends AdwActionRow {
     protected readonly _plusButton: AdwImageButton;
     /** The value display before the stepper buttons. */
     protected readonly _valueLabel: Label;
-    /** The headless value/min/max/step clamp-and-step state machine (ADR 0004). */
+    /** The headless adjustment: clamp, step and the two signals (ADR 0004, ADR 0047). */
     private readonly _state;
-    constructor();
-    /** The current numeric value (always within `[min, max]`). */
+    constructor(props?: ConstructProps<AdwSpinRow>);
+    /** The current numeric value (always within the adjustment's range). */
     get value(): number;
     set value(v: number | string);
-    /** Lower bound. Re-clamps the current value if it now falls below. */
-    get min(): number;
-    set min(v: number | string);
-    /** Upper bound. Re-clamps the current value if it now falls above. */
-    get max(): number;
-    set max(v: number | string);
-    /** Increment/decrement step applied per button press. */
-    get step(): number;
-    set step(v: number | string);
+    /**
+     * The numeric range this row steps through — `Adw.SpinRow:adjustment`.
+     *
+     * Reads back whole; writes MERGE, so `adjustment = { upper: 20 }` moves one bound and
+     * leaves the rest, the value included (re-clamped if the move came under it). From XML
+     * it is a JSON object — `adjustment='{"lower":1,"upper":20}'` — which is why the setter
+     * takes a string: NativeScript's XML builder assigns attributes verbatim, so a
+     * non-string property needs its own door (see `xml-values.ts`).
+     */
+    get adjustment(): AdwAdjustment;
+    set adjustment(v: AdwAdjustmentInput | 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 { AdwMenuEntry, SplitButtonDirection } from '@gjsify/adwaita-core';
-import { AdwIcon } from './adw-icon.js';
+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. */
@@ -9,23 +10,41 @@ export declare const MENU_TAPPED = "menuTapped";
 export interface MenuTappedEventData extends EventData {
     /** The chosen menu item label. */
     item: string;
-    /** The chosen item's index in {@link AdwSplitButton.menu} — its GMenuModel POSITION. */
-    index: number;
-    /** The chosen item's detailed action name, when the entry carried one. */
+    /** The chosen item's id, falling back to its label. */
+    id: string;
+    /**
+     * Where the item sits in {@link AdwSplitButton.menuModel} — its `GMenuModel`
+     * POSITION, as a PATH since ADR 0042: a submenu is a model of its own, so `[2, 0]`
+     * is the first item of the third entry and a flat index cannot name it.
+     */
+    path: readonly number[];
+    /** 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). */
     protected readonly _actionLabel: Label;
     /** The action symbolic icon (shown in icon mode). */
-    protected readonly _actionIcon: AdwIcon;
+    protected readonly _actionIcon: GtkImage;
     /** The dropdown-arrow part (column 1). */
     protected readonly _dropdownPart: GridLayout;
     /** The direction arrow. */
-    protected readonly _chevron: AdwIcon;
+    protected readonly _chevron: GtkImage;
     private readonly _state;
+    private _actions;
     /** Which of the two action views is currently parented. */
     private _showingIcon;
     /**
@@ -38,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.
      *
@@ -64,9 +83,37 @@ export declare class AdwSplitButton extends GridLayout {
      */
     get iconName(): string;
     set iconName(svg: string);
-    /** The dropdown menu entries (opened as a native `action()` sheet on arrow tap). */
-    get menu(): readonly AdwMenuEntry[];
-    set menu(value: readonly (string | AdwMenuEntry)[]);
+    /**
+     * The dropdown menu, normalised (ADR 0042) — opened as a native `action()` sheet on
+     * an arrow tap.
+     *
+     * Accepts everything the portable model does, INCLUDING the bare `string[]` this
+     * widget used to be alone in taking: that shorthand is now one of the model's own
+     * input forms rather than a NativeScript-only shape, so the same value works on
+     * every surface.
+     *
+     * IT DOES NOT TAKE A JSON STRING, which the browser element's `menu-model`
+     * ATTRIBUTE does. Not an oversight: NativeScript's Builder writes an XML attribute
+     * straight onto the property, so accepting one here would open the XML door — and
+     * the gallery probe that would have to prove it compares a read-back by IDENTITY
+     * (`gallery-page.ts`), which no structured value can satisfy. An input form nothing
+     * can run is a claim, not a feature.
+     *
+     * AND IT SAYS SO. Left to `normalizeMenuModel`, a string is "not an array" and
+     * becomes an EMPTY menu — so an XML author writing `menuModel="[…]"` would get a
+     * button whose dropdown is dead, with nothing anywhere saying why. A shut door that
+     * is silent is worse than one that is open.
+     */
+    get menuModel(): AdwMenuModel;
+    set menuModel(value: AdwMenuInput);
+    /**
+     * What the action group publishes about the actions this menu names — the portable
+     * stand-in for a `GActionGroup`, and the only source of a menu's enabled/checked
+     * state (ADR 0042). A sheet has no disabled row, so an insensitive item is not
+     * offered; a checked one wears a tick.
+     */
+    get actions(): AdwMenuActions | null;
+    set actions(value: AdwMenuActions | null);
     /** The direction the arrow points (and, on GTK, the popup opens). */
     get direction(): SplitButtonDirection;
     set direction(value: SplitButtonDirection);
@@ -93,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 { AdwIcon } from './adw-icon.js';
-export declare class AdwStatusPage extends GridLayout {
+import { GtkImage } from './gtk-image.js';
+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: AdwIcon;
-    private _iconSvg;
+    protected readonly _icon: GtkImage;
+    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[]);