@gjsify/adwaita-nativescript 0.47.0 → 0.49.0

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

@@ -1,15 +1,27 @@
 import type { View } from '@nativescript/core';
 import { GridLayout } from '@nativescript/core';
 import { DEFAULT_CLAMP_MAX_SIZE, DEFAULT_CLAMP_TIGHTENING_THRESHOLD } from './chrome.js';
+import { type ConstructProps } from './construct-props.js';
 export { DEFAULT_CLAMP_MAX_SIZE, DEFAULT_CLAMP_TIGHTENING_THRESHOLD };
-export declare class AdwClamp extends GridLayout {
+declare const AdwClamp_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 AdwClamp extends AdwClamp_base {
     private _props;
     private _child;
     /** The container width the child was last clamped against, in DIPs. */
-    private _measuredWidth;
-    constructor();
-    /** Set (or replace) the clamped, centered child. Pass `null` to clear it. */
-    setChild(view: View | null): void;
+    private _clampWidth;
+    constructor(props?: ConstructProps<AdwClamp>);
+    /** Set (or replace) the clamped, centered child — `adw_clamp_set_child`. `null` clears it. */
+    set_child(view: View | null): void;
     /** The currently-clamped child, or `null`. */
     get child(): View | null;
     /**

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

@@ -1,7 +1,8 @@
 import { Label, type EventData } from '@nativescript/core';
-import type { AdwComboOption } from '@gjsify/adwaita-core';
+import type { AdwComboOption, AdwListModelInput } from '@gjsify/adwaita-core';
 import { AdwActionRow } from './adw-action-row.js';
-import { AdwIcon } from './adw-icon.js';
+import { GtkImage } from './gtk-image.js';
+import { type ConstructProps } from './construct-props.js';
 export { ComboState } from '@gjsify/adwaita-core';
 export type { AdwComboOption, ComboStateChange, ComboStateListener } from '@gjsify/adwaita-core';
 /** Event name emitted when {@link AdwComboRow.selected} changes. Mirrors GObject `notify::selected`. */
@@ -17,10 +18,10 @@ export declare class AdwComboRow extends AdwActionRow {
     /** The dim inline value label (selected option). */
     protected readonly _valueLabel: Label;
     /** The down-chevron — a real Adwaita `pan-down-symbolic` icon. */
-    protected readonly _chevron: AdwIcon;
+    protected readonly _chevron: GtkImage;
     /** The headless options list + selectedIndex↔selectedValue state machine (ADR 0004). */
     private readonly _state;
-    constructor();
+    constructor(props?: ConstructProps<AdwComboRow>);
     /**
      * `model_changed` (adw-combo-row.c:187-195) — one option or none is not a
      * choice, so the chevron goes and the row stops being activatable.
@@ -32,9 +33,9 @@ export declare class AdwComboRow extends AdwActionRow {
     private _syncChooser;
     /** Open the native action chooser and apply the picked option. */
     private _openChooser;
-    /** The selectable options. Updates the inline value label. */
-    get options(): AdwComboOption[];
-    set options(value: AdwComboOption[]);
+    /** The list model (`Adw.ComboRow:model`). Updates the inline value label. */
+    get model(): AdwComboOption[];
+    set model(value: AdwListModelInput);
     /** The selected option index. Updates the inline value label. */
     get selected(): number;
     set selected(raw: number | string);

package/lib/types/widgets/adw-data-grid.d.ts

@@ -1,5 +1,6 @@
 import { GridLayout, type EventData } from '@nativescript/core';
 import type { AdwDataGridColumn, AdwDataGridRow } from '@gjsify/adwaita-core';
+import { type ConstructProps } from './construct-props.js';
 /** Event name emitted when an interactive row is tapped. Mirrors the browser's `row-activated`. */
 export declare const ROW_ACTIVATED = "row-activated";
 /** Payload of the `row-activated` event. */
@@ -8,19 +9,30 @@ export interface RowActivatedEventData extends EventData {
     index: number;
     row: AdwDataGridRow;
 }
-export declare class AdwDataGrid extends GridLayout {
+declare const AdwDataGrid_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 AdwDataGrid extends AdwDataGrid_base {
     private _columns;
-    private _rows;
+    private _dataRows;
     private _interactive;
     /** The header row's nodes, or `null` while there are no columns. */
     private _header;
-    /** One entry per data row, index-aligned with {@link _rows}. */
+    /** One entry per data row, index-aligned with {@link _dataRows}. */
     private _rowNodes;
     /** The tracks the declared columns were built from — the re-declare guard. */
     private _trackKey;
     /** The columns×rows the views were built for — the rebuild guard. */
     private _shapeKey;
-    constructor();
+    constructor(props?: ConstructProps<AdwDataGrid>);
     /** The column descriptors. Setting them re-derives the tracks. */
     get columns(): AdwDataGridColumn[];
     set columns(value: ReadonlyArray<AdwDataGridColumn>);
@@ -65,3 +77,4 @@ export declare class AdwDataGrid extends GridLayout {
      */
     private _activate;
 }
+export {};

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

@@ -1,8 +1,9 @@
 import { Label, StackLayout, TextField, type EventData, type View } from '@nativescript/core';
 import { EntryRowState, type EntryRowRenderState } from '@gjsify/adwaita-core';
 import { AdwActionRow } from './adw-action-row.js';
-import { AdwIcon } from './adw-icon.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`. */
@@ -44,15 +45,15 @@ export declare class AdwEntryRow extends AdwActionRow {
     /** The trailing affordance box — `Adw.EntryRow`'s suffixes BOX, not a slot. */
     protected readonly _suffixes: StackLayout;
     /** The pencil (`edit_icon`). Non-interactive, like its `can-target=False` original. */
-    protected readonly _editIcon: AdwIcon;
+    protected readonly _editIcon: GtkImage;
     /** The caps-lock warning slot (`indicator`). */
-    protected readonly _indicator: AdwIcon;
+    protected readonly _indicator: GtkImage;
     protected readonly _applyButton: AdwImageButton;
-    /** The suffix installed through the inherited single-slot {@link setSuffix}. */
+    /** The suffix installed through the inherited single-slot {@link add_suffix}. */
     private _slotSuffix;
     private _lastText;
     private _lastLength;
-    constructor();
+    constructor(props?: ConstructProps<AdwEntryRow>);
     /** The editable text. */
     get text(): string;
     set text(value: string);
@@ -72,17 +73,18 @@ export declare class AdwEntryRow extends AdwActionRow {
     set activatesDefault(raw: boolean | string);
     /** Whether the field currently has focus. */
     get editing(): boolean;
-    /** Append a suffix — `adw_entry_row_add_suffix` appends into a BOX, so suffixes COEXIST. */
-    addSuffix(view: View): void;
     /**
-     * The inherited single-slot API, narrowed to replace only the suffix a previous
-     * `setSuffix` installed. `AdwActionRow.setSuffix` removes whatever sits in the
-     * slot, which would detach the password row's own peek toggle — leaving
-     * `_peekButton` pointing at a detached view, so the row could never be revealed
-     * again. Upstream has no such conflict: `add_suffix` appends.
+     * 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.
+     *
+     * The override matters for the password row: the base's one-slot `add_suffix` would
+     * detach the row's own peek toggle to make room, leaving `_peekButton` pointing at a
+     * detached view so the row could never be revealed again.
      */
-    setSuffix(view: View | null): void;
-    /** The suffix installed through {@link setSuffix}, or `null`. */
+    add_suffix(view: View): void;
+    /** Remove a suffix added through {@link add_suffix} — `adw_entry_row_remove`. */
+    remove(view: View): void;
+    /** The suffix most recently installed through {@link add_suffix}, or `null`. */
     get suffix(): View | null;
     /**
      * Drive the trailing indicator — `adw_entry_row_set_show_indicator`. Private to

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

@@ -1,7 +1,8 @@
 import type { View } from '@nativescript/core';
-import { ItemSpec, StackLayout, type EventData } from '@nativescript/core';
+import { StackLayout, type EventData } from '@nativescript/core';
 import { AdwActionRow } from './adw-action-row.js';
-import { AdwIcon } from './adw-icon.js';
+import { GtkImage } from './gtk-image.js';
+import { type ConstructProps } from './construct-props.js';
 export { ExpanderState } from '@gjsify/adwaita-core';
 export type { ExpanderStateListener } from '@gjsify/adwaita-core';
 /** Event name emitted when {@link AdwExpanderRow.expanded} changes. Mirrors GObject `notify::expanded`. */
@@ -16,16 +17,25 @@ export declare class AdwExpanderRow extends AdwActionRow {
      *  (adw-expander-row.c:72), so the search does not consult a subtitle here. */
     readonly isActionRow: boolean;
     /** The disclosure chevron (suffix) — a plain symbolic icon, like Adw.ExpanderRow. */
-    protected readonly _toggle: AdwIcon;
+    protected readonly _toggle: GtkImage;
     /** The container of revealed child rows (second grid row). */
     protected readonly _disclosure: StackLayout;
     /** The headless expanded/collapsed disclosure state machine (ADR 0004). */
     private readonly _state;
-    constructor();
-    /** Append a child row (or any view) to the disclosure container. */
-    addRow(viewOrSpec: View | ItemSpec): void;
-    /** Remove a previously-added child row from the disclosure container. */
-    removeRow(view: View): void;
+    constructor(props?: ConstructProps<AdwExpanderRow>);
+    /**
+     * Append a child row (or any view) to the disclosure container —
+     * `adw_expander_row_add_row`.
+     *
+     * The GIR name is what ended a collision: this method was `addRow(View | ItemSpec)`,
+     * a union that existed only because `GridLayoutBase` already declares
+     * `addRow(itemSpec: ItemSpec)` and a same-named method with a narrower parameter is
+     * a type error against the real `@nativescript/core`. `add_row` is nobody else's, so
+     * the grid's track setup and the row's child list no longer share a name.
+     */
+    add_row(view: View): void;
+    /** Remove a previously-added child row from the disclosure container — `adw_expander_row_remove`. */
+    remove(view: View): void;
     /**
      * An XML child is a ROW inside the disclosure — the one placement an expander row
      * adds over its base, and the reason this overrides `AdwActionRow`'s prefix/suffix
@@ -33,7 +43,7 @@ export declare class AdwExpanderRow extends AdwActionRow {
      */
     _addChildFromBuilder(name: string, view: View): void;
     /**
-     * The rows inside the disclosure, in order — the read-back for `addRow`.
+     * The rows inside the disclosure, in order — the read-back for `add_row`.
      *
      * NOT `rows`, which is what it was called first. `GridLayoutBase` declares `rows`
      * as a SETTER-ONLY accessor (its getter is `rowsInternal`), so a getter of that
@@ -42,7 +52,8 @@ export declare class AdwExpanderRow extends AdwActionRow {
      * which every NativeScript bundle is. Measured against that prototype shape, and
      * it would have broken apps that never touch XML. `rows` and `columns` are the
      * only two accessors of that shape on the bases this package extends —
-     * `scripts/check-nativescript-accessor-shadowing.mjs` holds both.
+     * `scripts/check-nativescript-xml-doors.mjs` holds both (in `SETTER_ONLY_ON_BASE`,
+     * `scripts/nativescript-xml-doors.mjs:116`).
      */
     get disclosureRows(): readonly View[];
     /** Whether the disclosure is revealed. */

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

@@ -1,14 +1,26 @@
 import type { View } from '@nativescript/core';
 import { GridLayout, StackLayout } from '@nativescript/core';
-export declare class AdwHeaderBar extends GridLayout {
+import { type ConstructProps } from './construct-props.js';
+declare const AdwHeaderBar_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 AdwHeaderBar extends AdwHeaderBar_base {
     /** The start (left) slot — a horizontal stack. */
     protected readonly _startBox: StackLayout;
     /** The end (right) slot — a horizontal stack. */
     protected readonly _endBox: StackLayout;
     /** The centered title widget (default {@link AdwWindowTitle}). */
     private _titleWidget;
-    private _flat;
-    constructor();
+    private _styleClasses;
+    constructor(props?: ConstructProps<AdwHeaderBar>);
     /** The header title — forwarded to the default {@link AdwWindowTitle}. */
     get title(): string;
     set title(value: string);
@@ -16,13 +28,25 @@ export declare class AdwHeaderBar extends GridLayout {
     get subtitle(): string;
     set subtitle(value: string);
     /**
-     * Whether the header bar is flat (no background fill / no bottom separator),
-     * matching `Adw.HeaderBar`'s `.flat` style. Toggling swaps the `flat` class.
+     * The style classes this header bar carries (`GtkWidget:css-classes`), without the
+     * `adw-header-bar` class that makes it one — GTK's own rule for the property.
+     *
+     * IT WAS `flat`, A BOOLEAN (ADR 0049), and the port's own doc said what it really was:
+     * "matching `Adw.HeaderBar`'s `.flat` style. Toggling swaps the `flat` class." A style
+     * class is `GtkWidget:css-classes` on GTK, which is a LIST — so `flat` was one look
+     * with a property of its own while every other look had none.
+     *
+     * NOT `cssClasses`: `ViewBase` owns that name as a live `Set<string>` the CSS engine
+     * rebuilds on every `className` write, and shadowing it kills the widget in its own
+     * constructor — see `style-classes.ts`.
+     *
+     * `header.styleClasses = 'flat'` replaces `header.flat = true`, and from XML
+     * `styleClasses="flat"` replaces `flat="true"`.
      */
-    get flat(): boolean;
-    set flat(raw: boolean | string);
-    /** Pack a widget at the start (left) of the bar — `gtk_box_append`. */
-    packStart(view: View): void;
+    get styleClasses(): string[];
+    set styleClasses(value: string | null | undefined);
+    /** Pack a widget at the start (left) of the bar — `adw_header_bar_pack_start`, a `gtk_box_append`. */
+    pack_start(view: View): void;
     /**
      * Pack a widget at the end (right) of the bar.
      *
@@ -30,18 +54,18 @@ export declare class AdwHeaderBar extends GridLayout {
      * adw-header-bar.c:1106): "packed with reference to the end" means the FIRST
      * widget packed is the one nearest the end of the bar, and each later one
      * goes in front of it. The port appended instead, so every end slot came out
-     * mirrored — `packEnd(menu); packEnd(search)` drew `menu | search` where
+     * mirrored — `pack_end(menu); pack_end(search)` drew `menu | search` where
      * libadwaita draws `search | menu`, with the menu button in the corner.
      */
-    packEnd(view: View): void;
-    /** Replace the centered title widget with a custom one (e.g. a URL entry). */
-    setTitleWidget(view: View): void;
+    pack_end(view: View): void;
+    /** Replace the centered title widget with a custom one — `adw_header_bar_set_title_widget`. */
+    set_title_widget(view: View): void;
     /**
      * XML inflation — route a template's child through the packing API.
      *
      * NativeScript spells a slot as a complex property, so `<AdwHeaderBar.endBox>`
      * arrives here as `endBox`; a bare child arrives under its element name and
-     * takes the fallback, `packStart`. Without this the `GridLayout` default added
+     * takes the fallback, `pack_start`. Without this the `GridLayout` default added
      * the view straight to the grid at column 0: measured on Android, a header bar
      * written in markup left `startBox` and `endBox` empty while the button still
      * appeared, so it LOOKED packed and was not — a second one would have been
@@ -55,3 +79,4 @@ export declare class AdwHeaderBar extends GridLayout {
     /** The end (right) slot container. */
     get endBox(): StackLayout;
 }
+export {};

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

@@ -1,22 +1,38 @@
 import { GridLayout, Image } from '@nativescript/core';
+import { type ConstructProps } from './construct-props.js';
 /** Default symbolic-icon size, in DIPs — the Adwaita 16px icon grid. */
 export declare const DEFAULT_ICON_BUTTON_ICON_SIZE = 16;
-export declare class AdwImageButton extends GridLayout {
+declare const AdwImageButton_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 AdwImageButton extends AdwImageButton_base {
     /** The centered icon image. */
     protected readonly _image: Image;
-    private _iconSvg;
+    private _icon;
     private _iconColor;
     private _explicitColor;
     private _iconSize;
     private _unsubScheme;
-    constructor();
+    constructor(props?: ConstructProps<AdwImageButton>);
     /** Adopt the active scheme's default fill (no-op if the caller pinned a colour). */
     private _syncThemeColor;
     /** Re-render the icon bitmap from the current svg / colour / size. */
     private _render;
-    /** The Adwaita symbolic SVG string to render (e.g. `goPreviousSymbolic`). */
+    /**
+     * The icon to render: an Adwaita icon NAME (`'go-previous-symbolic'`) or an Adwaita
+     * symbolic SVG SOURCE string (e.g. `goPreviousSymbolic`). A name the compiled subset
+     * does not carry draws the `image-missing` glyph; `''` draws nothing.
+     */
     get iconName(): string;
-    set iconName(svg: string);
+    set iconName(value: string);
     /** The icon fill colour (hex). Setting it PINS the colour (it no longer follows
      *  the light/dark scheme) — for context colours that must survive both schemes. */
     get iconColor(): string;
@@ -27,3 +43,4 @@ export declare class AdwImageButton extends GridLayout {
     /** The underlying icon {@link Image} (e.g. to tweak alignment). */
     get image(): Image;
 }
+export {};

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

@@ -1,9 +1,10 @@
 import type { AdwInlineViewSwitcherDisplayMode } from '@gjsify/adwaita-core';
 import { AdwViewSwitcherBase } from './view-switcher-base.js';
 import type { ViewSwitcherKind } from './view-switcher-model.js';
+import { type ConstructProps } from './construct-props.js';
 export declare class AdwInlineViewSwitcher extends AdwViewSwitcherBase {
     private _displayMode;
-    constructor();
+    constructor(props?: ConstructProps<AdwInlineViewSwitcher>);
     protected get barClass(): string;
     protected get buttonClass(): string;
     protected get buttonDisplayMode(): AdwInlineViewSwitcherDisplayMode;

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

@@ -1,8 +1,9 @@
 import { AdwSplitViewBase } from './split-view-base.js';
 import { NsNavigationSplitViewState } from './split-view-state.js';
 import type { NavigationActionResult } from '@gjsify/adwaita-core';
+import { type ConstructProps } from './construct-props.js';
 export declare class AdwNavigationSplitView extends AdwSplitViewBase<NsNavigationSplitViewState> {
-    constructor();
+    constructor(props?: ConstructProps<AdwNavigationSplitView>);
     protected _applyLayout(): void;
     /** Animate the collapsed master⇄detail swap; instant off-screen/off-device. */
     protected _transitionSidebar(): void;

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

@@ -1,6 +1,7 @@
 import { GridLayout, type EventData, type View } from '@nativescript/core';
 import type { AdwNavigationPageProps, NavigationShortcutResult } from '@gjsify/adwaita-core';
 import { NOTIFY_VISIBLE_PAGE, POPPED, PUSHED, REPLACED } from './navigation-stack.js';
+import { type ConstructProps } from './construct-props.js';
 export { NOTIFY_VISIBLE_PAGE, POPPED, PUSHED, REPLACED };
 /** Payload of every navigation signal — `pushed`, `popped`, `replaced`, `notify::visible-page`. */
 export interface AdwNavigationEventData extends EventData {
@@ -13,9 +14,20 @@ export interface AdwNavigationEventData extends EventData {
 }
 /** Payload of the `notify::visible-page` event. */
 export type NotifyVisiblePageEventData = AdwNavigationEventData;
-export declare class AdwNavigationView extends GridLayout {
+declare const AdwNavigationView_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 AdwNavigationView extends AdwNavigationView_base {
     private readonly _nav;
-    constructor();
+    constructor(props?: ConstructProps<AdwNavigationView>);
     /**
      * Register a page (optionally with a tag for `push(tag)`). A page added while
      * the stack is EMPTY is pushed automatically, so the view is never blank —
@@ -28,40 +40,47 @@ export declare class AdwNavigationView extends GridLayout {
      *
      * Registered with NO TAG: `add(view)` defaults it to `null`, and nothing in the
      * markup can supply one, because a `tag` is this widget's own idea rather than a
-     * property of the child. `pushByTag` is therefore not reachable for a page that
+     * property of the child. `push_by_tag` is therefore not reachable for a page that
      * came from a template; a loader that wants it registers the page itself, or
      * calls `setPageTag` on one it looked up. What XML contributes is the tree.
      */
     _addChildFromBuilder(_name: string, view: View): void;
     /**
-     * Remove a page (`AdwNavigationView.remove`). One that is on the stack is
-     * removed once it is POPPED. Named `removePage` rather than `remove` so the
-     * widget never shadows a member of NativeScript's own `ViewBase`, the same
-     * reason `@gjsify/adwaita-web` avoids `HTMLElement.remove()`.
+     * Remove a page — `adw_navigation_view_remove`. One that is on the stack is
+     * removed once it is POPPED.
+     *
+     * This was `removePage`, "so the widget never shadows a member of NativeScript's
+     * own `ViewBase`, the same reason `@gjsify/adwaita-web` avoids
+     * `HTMLElement.remove()`". The web half is true; the NativeScript half was never
+     * measured. Against `@nativescript/core@9.1.0-alpha.11` no view base declares a
+     * `remove` at all — the one `remove(` in the package is `ImageCache.remove(key)` —
+     * and `AdwWrapBox` and `AdwPreferencesDialog` had carried the name the whole time
+     * without incident. The same shape as the `openState` reasoning ADR 0034
+     * § Amendment 11 keeps: a collision ruled a name out, and the collision was assumed.
      */
-    removePage(view: View): boolean;
+    remove(view: View): boolean;
     /** Push a page (a previously-registered tag, or a fresh view) onto the stack. */
     push(viewOrTag: View | string, options?: AdwNavigationPageProps): boolean;
-    /** Push the page carrying `tag`. */
-    pushByTag(tag: string): boolean;
+    /** Push the page carrying `tag` — `adw_navigation_view_push_by_tag`. */
+    push_by_tag(tag: string): boolean;
     /**
      * Pop the top page. Returns `true` if a page was popped (the stack keeps ≥1).
      * `can-pop` does NOT gate this — it gates {@link popFromShortcut} and the back
      * button, exactly as libadwaita documents.
      */
     pop(): boolean;
-    /** Pop until `view` is visible, in ONE transition. */
-    popToPage(view: View): boolean;
-    /** Pop until the page carrying `tag` is visible. */
-    popToTag(tag: string): boolean;
+    /** Pop until `view` is visible, in ONE transition — `adw_navigation_view_pop_to_page`. */
+    pop_to_page(view: View): boolean;
+    /** Pop until the page carrying `tag` is visible — `adw_navigation_view_pop_to_tag`. */
+    pop_to_tag(tag: string): boolean;
     /** Replace the whole stack; the last entry becomes visible. Never animates. */
     replace(entries: ReadonlyArray<View | string | null>): void;
-    /** Replace the stack with the pages carrying `tags`. */
-    replaceWithTags(tags: readonly string[]): void;
-    /** The page with this tag, or `null`. */
-    findPage(tag: string): View | null;
-    /** The page popping `view` would reveal, or `null`. */
-    getPreviousPage(view: View): View | null;
+    /** Replace the stack with the pages carrying `tags` — `adw_navigation_view_replace_with_tags`. */
+    replace_with_tags(tags: readonly string[]): void;
+    /** The page with this tag, or `null` — `adw_navigation_view_find_page`. */
+    find_page(tag: string): View | null;
+    /** The page popping `view` would reveal, or `null` — `adw_navigation_view_get_previous_page`. */
+    get_previous_page(view: View): View | null;
     /** Set a page's tag. Rejected when another page already owns it. */
     setPageTag(view: View, tag: string | null): boolean;
     /** Set a page's title — used as the NEXT page's back-button tooltip. */
@@ -95,5 +114,5 @@ export declare class AdwNavigationView extends GridLayout {
     /** `Adw.NavigationView:pop-on-escape` — consulted by {@link popFromEscape}. */
     get popOnEscape(): boolean;
     set popOnEscape(raw: boolean | string);
-    private _emit;
+    private _emitNavigation;
 }

package/lib/types/widgets/adw-overlay-split-view.d.ts

@@ -1,10 +1,11 @@
 import { AdwSplitViewBase } from './split-view-base.js';
 import { NsOverlaySplitViewState } from './split-view-state.js';
+import { type ConstructProps } from './construct-props.js';
 export declare class AdwOverlaySplitView extends AdwSplitViewBase<NsOverlaySplitViewState> {
     /** Dimmed backdrop drawn between content and the overlaid sidebar; tapping it
      *  closes the sidebar (Adwaita's click-outside-to-dismiss). Created lazily. */
     private _scrim;
-    constructor();
+    constructor(props?: ConstructProps<AdwOverlaySplitView>);
     /**
      * `Adw.OverlaySplitView:pin-sidebar` (adw-overlay-split-view.c:990-992,
      * default FALSE) — whether collapsing leaves the sidebar's visibility alone.
@@ -33,7 +34,7 @@ export declare class AdwOverlaySplitView extends AdwSplitViewBase<NsOverlaySplit
     private _ensureScrim;
     /** Re-establish paint order: content < scrim < sidebar (NS paints in add order).
      *  Removing + re-adding the scrim/sidebar keeps them above the content no matter
-     *  what order setContent/setSidebar/collapsed ran in. */
+     *  what order set_content/set_sidebar/collapsed ran in. */
     private _raiseOverlayChildren;
     /** Detach the scrim (side-by-side mode has no overlay). */
     private _detachScrim;

package/lib/types/widgets/adw-password-entry-row.d.ts

@@ -1,6 +1,7 @@
 import type { EventData } from '@nativescript/core';
 import { AdwEntryRow } from './adw-entry-row.js';
 import { AdwImageButton } from './adw-image-button.js';
+import { type ConstructProps } from './construct-props.js';
 export { PasswordEntryRowState } from '@gjsify/adwaita-core';
 export type { PasswordEntryRowRenderState } from '@gjsify/adwaita-core';
 /** Event name emitted when the peek state flips. Mirrors a GObject `notify::`. */
@@ -15,7 +16,7 @@ export declare class AdwPasswordEntryRow extends AdwEntryRow {
     private readonly _password;
     /** The trailing peek (reveal/conceal) toggle button. */
     protected readonly _peekButton: AdwImageButton;
-    constructor();
+    constructor(props?: ConstructProps<AdwPasswordEntryRow>);
     /** Whether the contents are shown in clear text (`GtkText:visibility`). */
     get revealed(): boolean;
     set revealed(value: boolean | string);

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

@@ -1,15 +1,27 @@
 import type { View } from '@nativescript/core';
-import { GridLayout, Label, StackLayout } from '@nativescript/core';
+import { GridLayout, Label, StackLayout, type EventData } from '@nativescript/core';
 import type { SearchPreferencesOptions } from '@gjsify/adwaita-core';
 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";
-export declare class AdwPreferencesDialog extends GridLayout {
+declare const AdwPreferencesDialog_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 AdwPreferencesDialog extends AdwPreferencesDialog_base {
     protected readonly _card: GridLayout;
     protected readonly _headerBox: GridLayout;
     protected readonly _titleLabel: Label;
     protected readonly _body: StackLayout;
-    constructor();
+    constructor(props?: ConstructProps<AdwPreferencesDialog>);
     /** The dialog title. */
     get title(): string;
     set title(value: string);
@@ -49,3 +61,4 @@ export declare class AdwPreferencesDialog extends GridLayout {
     /** The scrollable body that hosts the preferences pages. */
     get body(): StackLayout;
 }
+export {};

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

@@ -1,7 +1,19 @@
 import type { View } from '@nativescript/core';
 import { GridLayout, Label, StackLayout } from '@nativescript/core';
 import type { NsSearchableGroup, NsSearchableRow } from './preferences-search.js';
-export declare class AdwPreferencesGroup extends StackLayout implements NsSearchableGroup {
+import { type ConstructProps } from './construct-props.js';
+declare const AdwPreferencesGroup_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 AdwPreferencesGroup extends AdwPreferencesGroup_base implements NsSearchableGroup {
     /** The header box: labels on the leading edge, suffix on the trailing one. */
     protected readonly _header: GridLayout;
     /** The group header label. */
@@ -15,7 +27,7 @@ export declare class AdwPreferencesGroup extends StackLayout implements NsSearch
     private _title;
     private _description;
     private _headerSuffix;
-    constructor();
+    constructor(props?: ConstructProps<AdwPreferencesGroup>);
     /**
      * The group title (dim, uppercase header above the boxed list).
      *
@@ -57,10 +69,10 @@ export declare class AdwPreferencesGroup extends StackLayout implements NsSearch
      * around them — which is the failure that looks like a styling bug.
      */
     _addChildFromBuilder(name: string, view: View): void;
-    /** Append a row (or any view) to the boxed list. */
-    addRow(view: View): void;
-    /** Remove a previously-added row from the boxed list. */
-    removeRow(view: View): void;
+    /** Append a row (or any view) to the boxed list — `adw_preferences_group_add`. */
+    add(view: View): void;
+    /** Remove a previously-added row from the boxed list — `adw_preferences_group_remove`. */
+    remove(view: View): void;
     /**
      * The rows this group contributes to a preferences search, in listbox order.
      *
@@ -91,3 +103,4 @@ export declare class AdwPreferencesGroup extends StackLayout implements NsSearch
     /** The boxed-list container (column of rows). */
     get listbox(): StackLayout;
 }
+export {};