@gjsify/adwaita-nativescript 0.51.1 → 0.53.0

package/lib/types/widgets/adw-bottom-sheet.d.ts

@@ -1,6 +1,6 @@
 import type { View } from '@nativescript/core';
 import { GridLayout, StackLayout } from '@nativescript/core';
-import type { BottomSheetCloseOutcome, BottomSheetCloseSource } from '@gjsify/adwaita-core';
+import type { BottomSheetCloseOutcome, BottomSheetCloseSource, BottomSheetOpenOutcome, BottomSheetOpenSource } from '@gjsify/adwaita-core';
 import { CLOSE_ATTEMPT, NOTIFY_OPEN, SHEET_CLOSE, type NotifyOpenEventData } from './bottom-sheet-state.js';
 import { type ConstructProps } from './construct-props.js';
 export { CLOSE_ATTEMPT, NOTIFY_OPEN, SHEET_CLOSE };
@@ -8,6 +8,18 @@ export type { NotifyOpenEventData };
 declare const AdwBottomSheet_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => void): number;
     disconnect(handlerId: number): void;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
     _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;
@@ -17,23 +29,43 @@ declare const AdwBottomSheet_base: (abstract new (...args: any[]) => {
     get(name: string): unknown;
 }) & typeof GridLayout;
 export declare class AdwBottomSheet extends AdwBottomSheet_base {
+    /** The names this widget's `_addChildFromBuilder` honours — see `./builder-slots.ts`. */
+    static readonly builderSlots: readonly string[];
     /** The always-visible content layer. */
     private _content;
-    /** The bottom sheet panel wrapper (drag handle + sheet child). */
+    /** The scrim over the content while a modal sheet is open — libadwaita's `dimming`. */
+    private readonly _dimming;
+    /** The bottom-anchored bin holding both layers — libadwaita's `sheet_bin`. */
     protected readonly _sheetPanel: StackLayout;
+    /** The sheet page inside the bin: drag handle + sheet child. */
+    private readonly _sheetPage;
+    /** The bottom-bar bin — the bin's other layer, tapped to open the sheet. */
+    private readonly _bottomBarBin;
     private _sheetChild;
+    private _bottomBar;
     /** The shared open/can-close model — the single source of truth for both. */
     private readonly _state;
     constructor(props?: ConstructProps<AdwBottomSheet>);
+    /** Push the current chrome onto the three views — the widget's whole rendering step. */
+    private _paintChrome;
     /** Set (or replace) the always-visible content layer (painted under the sheet) — `adw_bottom_sheet_set_content`. */
     set_content(view: View | null): void;
     /** Set (or replace) the sheet panel's child (shown when open) — `adw_bottom_sheet_set_sheet`. */
     set_sheet(view: View | null): void;
     /**
-     * An XML child asks for the sheet or for the content, and a bare one is CONTENT —
-     * the always-visible layer, which is what a sheet with nothing behind it would be
-     * missing. `LayoutBase`'s inherited default would put either into the grid
-     * alongside the sheet panel, where it neither paints under the sheet nor moves
+     * Set (or replace) the bottom bar — `adw_bottom_sheet_set_bottom_bar`, shown in the
+     * sheet's place while it is closed.
+     *
+     * Presence is an INPUT to the open gate, not decoration: taking the bar away takes every
+     * on-device way of opening this sheet with it, which is why the state hears about it
+     * (upstream re-runs `update_swipe_tracker` from the same setter, adw-bottom-sheet.c:1629).
+     */
+    set_bottom_bar(view: View | null): void;
+    /**
+     * An XML child asks for the sheet, the bottom bar or the content, and a bare one is
+     * CONTENT — the always-visible layer, which is what a sheet with nothing behind it
+     * would be missing. `LayoutBase`'s inherited default would put any of them into the
+     * grid alongside the sheet panel, where it neither paints under the sheet nor moves
      * with it.
      */
     _addChildFromBuilder(name: string, view: View): void;
@@ -45,8 +77,20 @@ export declare class AdwBottomSheet extends AdwBottomSheet_base {
      * child it declared actually went.
      */
     get content(): View | null;
+    /**
+     * `Adw.BottomSheet:content` — {@link set_content} under the property spelling the
+     * counterpart declares, so a construct-props bag can carry the pane and a snippet
+     * ported off GJS keeps the assignment it was written as.
+     */
+    set content(view: View | null);
     /** The sheet panel's child, or `null` — the read-back for `set_sheet`. */
     get sheet(): View | null;
+    /** `Adw.BottomSheet:sheet` — {@link set_sheet} under the counterpart's spelling. */
+    set sheet(view: View | null);
+    /** The bottom bar's child, or `null` — the read-back for `set_bottom_bar`. */
+    get bottomBar(): View | null;
+    /** `Adw.BottomSheet:bottom-bar` — {@link set_bottom_bar} under the counterpart's spelling. */
+    set bottomBar(view: View | null);
     /**
      * Whether the sheet is open (`AdwBottomSheet:open`). Toggling shows/hides the panel
      * and emits `notify::open`.
@@ -61,12 +105,31 @@ export declare class AdwBottomSheet extends AdwBottomSheet_base {
      */
     get open(): boolean;
     set open(value: boolean | string);
+    /**
+     * Whether the sheet dims the content and blocks it while open (`AdwBottomSheet:modal`,
+     * default `true`). Changing it on an open sheet adds or removes the scrim at once, as
+     * `adw_bottom_sheet_set_modal` does; `open` does not move.
+     */
+    get modal(): boolean;
+    set modal(raw: boolean | string);
     /**
      * Whether the user may dismiss the sheet (`AdwBottomSheet:can-close`). When
      * off, a refused dismissal emits `close-attempt` instead of closing.
      */
     get canClose(): boolean;
     set canClose(raw: boolean | string);
+    /**
+     * Whether the user may open the sheet from its bottom bar (`AdwBottomSheet:can-open`).
+     *
+     * Off, the bar STAYS on screen and only gains the inert marker: libadwaita refuses the
+     * click in the handler rather than disabling the button (adw-bottom-sheet.c:2031-2038).
+     * There is no `open-attempt` signal to answer with, so a refused tap is silent.
+     */
+    get canOpen(): boolean;
+    set canOpen(raw: boolean | string);
+    /** Whether the bottom bar is shown while the sheet is closed (`AdwBottomSheet:reveal-bottom-bar`). */
+    get revealBottomBar(): boolean;
+    set revealBottomBar(raw: boolean | string);
     /**
      * Route a dismissal affordance through the shared gate and act on the
      * verdict: close, emit `close-attempt`, emit `sheet.close` for the host to
@@ -78,4 +141,12 @@ export declare class AdwBottomSheet extends AdwBottomSheet_base {
      * `requestClose('close-button')`.
      */
     requestClose(source: BottomSheetCloseSource): BottomSheetCloseOutcome;
+    /**
+     * Route an open affordance through the shared gate — the bar's own tap goes through
+     * here, and a host with a gesture of its own passes `'swipe'`.
+     *
+     * Unlike {@link requestClose} there is nothing to emit on a refusal: libadwaita has no
+     * `open-attempt` counterpart to `close-attempt`, so `'ignored'` is silent.
+     */
+    requestOpen(source: BottomSheetOpenSource): BottomSheetOpenOutcome;
 }

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

@@ -5,6 +5,18 @@ import { type ConstructProps } from './construct-props.js';
 declare const AdwButtonContent_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => void): number;
     disconnect(handlerId: number): void;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
     _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;

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

@@ -27,7 +27,28 @@ export declare class AdwButtonRow extends AdwActionRow {
      * second state object would give one label two sources of truth.
      */
     private readonly _buttonState;
+    private _styleClasses;
     constructor(props?: ConstructProps<AdwButtonRow>);
+    /**
+     * `GtkWidget:css-classes`, spelled `styleClasses` for the reason `style-classes.ts`
+     * gives. The Adwaita page documents a button row by its style classes
+     * (`.suggested-action`, `.destructive-action`), and a `.blp` writes them as
+     * `styles [...]`; the shared-tree builder refuses a style class the widget has no door
+     * for, so without this the gallery's button-row `.blp` did not build here.
+     */
+    get styleClasses(): string[];
+    set styleClasses(value: string | null | undefined);
+    /** `gtk_widget_add_css_class`. A class the row already carries is a no-op. */
+    add_css_class(name: string): void;
+    /** `gtk_widget_remove_css_class`. A class it does not carry is a no-op. */
+    remove_css_class(name: string): void;
+    /** `gtk_widget_has_css_class`. */
+    has_css_class(name: string): boolean;
+    /** `gtk_widget_get_css_classes` — the list, without the row's own classes. */
+    get_css_classes(): string[];
+    /** `gtk_widget_set_css_classes` — REPLACES the list, as in C. */
+    set_css_classes(names: readonly string[]): void;
+    private _setClasses;
     /** A centered symbolic icon, collapsed until it has content. Its fill is set by
      *  {@link _applyIconColor}, which is also what follows an accent change. */
     private static _makeIcon;

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

@@ -0,0 +1,7 @@
+import { AdwCarouselIndicatorBase } from './carousel-indicator-base.js';
+import { type ConstructProps } from './construct-props.js';
+export declare class AdwCarouselIndicatorDots extends AdwCarouselIndicatorBase {
+    protected readonly _markerClass = "adw-carousel-dot";
+    protected readonly _markerText = "\u25CF";
+    constructor(props?: ConstructProps<AdwCarouselIndicatorDots>);
+}

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

@@ -0,0 +1,7 @@
+import { AdwCarouselIndicatorBase } from './carousel-indicator-base.js';
+import { type ConstructProps } from './construct-props.js';
+export declare class AdwCarouselIndicatorLines extends AdwCarouselIndicatorBase {
+    protected readonly _markerClass = "adw-carousel-line";
+    protected readonly _markerText = "";
+    constructor(props?: ConstructProps<AdwCarouselIndicatorLines>);
+}

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

@@ -20,6 +20,18 @@ export interface PageChangedEventData extends EventData {
 declare const AdwCarousel_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
     disconnect(handlerId: number): void;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
     _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;
@@ -33,14 +45,10 @@ export declare class AdwCarousel extends AdwCarousel_base {
     protected readonly _scroller: ScrollView;
     /** The horizontal track inside the scroller (holds fixed-width pages). */
     protected readonly _track: StackLayout;
-    /** The dot-indicator row. */
-    protected readonly _dots: StackLayout;
     private readonly _state;
     private readonly _sync;
     /** Page id → its content view, so a DOM-free model can still be projected. */
     private readonly _views;
-    /** Page id → its dot. Keyed by ID, not by index: an insert or a reorder renumbers every page after it. */
-    private readonly _dotsById;
     private _nextPageId;
     private _pageWidth;
     constructor(props?: ConstructProps<AdwCarousel>);
@@ -51,8 +59,8 @@ export declare class AdwCarousel extends AdwCarousel_base {
      *
      * The name is ignored: a carousel has one kind of child. Without this,
      * `LayoutBase`'s default puts the view straight into the grid the carousel builds
-     * its scroller and dots in — on top of the track rather than on it, and the page
-     * never gets a width, a `adw-carousel-page` class or a dot.
+     * its scroller in — on top of the track rather than on it, and the page never gets
+     * a width or a `adw-carousel-page` class.
      */
     _addChildFromBuilder(_name: string, view: View): void;
     /**
@@ -65,12 +73,15 @@ export declare class AdwCarousel extends AdwCarousel_base {
     /** Move a page — `adw_carousel_reorder` (adw-carousel.c:1419-1499). */
     reorder(view: View, position: number): boolean;
     /**
-     * Scroll to a page by index. Out-of-range, fractional and NaN indices are
-     * refused rather than clamped, matching `adw_carousel_get_nth_page`'s
-     * precondition (adw-carousel.c:1616) — `scrollToPage(NaN)` used to set the
-     * position to NaN and leave no dot selected.
+     * Scroll to a page — `adw_carousel_scroll_to` (adw-carousel.c:1600-1640).
+     *
+     * Takes the PAGE, as its siblings `insert`, `remove` and `reorder` already do, and
+     * resolves it through the same `_idOf` they use; a view this carousel does not hold
+     * is refused, which is C's precondition — and it is what a bound indicator calls
+     * with `pages[i]` when a marker is tapped, as `adw-carousel-indicator-dots.c` does.
+     * The INDEX door is {@link position}.
      */
-    scrollToPage(index: number): void;
+    scroll_to(page: View): void;
     /** One keynav step — `navigate_to_direction` (adw-carousel.c:475-508). */
     navigate(direction: 'back' | 'forward'): boolean;
     /** The pages on the track, in order — the read-back for `append`/`insert`. */
@@ -95,21 +106,26 @@ export declare class AdwCarousel extends AdwCarousel_base {
     set interactive(raw: boolean | string);
     /**
      * The per-page width in DIPs used for scroll-offset math. Set this to the
-     * carousel's on-screen width so `scrollToPage` lands cleanly. Re-applies to
+     * carousel's on-screen width so `scroll_to` lands cleanly. Re-applies to
      * all existing pages.
      */
     get pageWidth(): number;
     set pageWidth(raw: number | string);
     /** The px pitch between two page origins — `self->distance` (adw-carousel.c:767). */
     private _distance;
+    /**
+     * Scroll to a page by index. Out-of-range, fractional and NaN indices are
+     * refused rather than clamped, matching `adw_carousel_get_nth_page`'s
+     * precondition (adw-carousel.c:1616) — an index of NaN used to set the
+     * position to NaN and leave no dot selected.
+     */
+    private _scrollToIndex;
     /** The state's id for a page view, or `null` when it is not one of ours. */
     private _idOf;
     /** Run the scroll the state asked for. */
     private _performScroll;
-    /** The dots in page order — the order `applyCarouselDots` indexes by. */
-    private _orderedDots;
     /**
-     * Make both native child lists match the model order.
+     * Make the track's child list match the model order.
      *
      * Detach-then-reattach rather than a positional patch: NS has no "move
      * child", `insertChild` on an already-parented view double-parents it, and

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

@@ -6,6 +6,18 @@ export { DEFAULT_CLAMP_MAX_SIZE, DEFAULT_CLAMP_TIGHTENING_THRESHOLD };
 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;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
     _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;
@@ -15,6 +27,13 @@ declare const AdwClamp_base: (abstract new (...args: any[]) => {
     get(name: string): unknown;
 }) & typeof GridLayout;
 export declare class AdwClamp extends AdwClamp_base {
+    /**
+     * The names this widget's `_addChildFromBuilder` honours — see `./builder-slots.ts`.
+     * `Adw.Clamp:child` is this widget's own property name, and its fallback: an authored
+     * `child: …` and a bare child mean the same thing, the shape `_addChildFromBuilder`
+     * below already has.
+     */
+    static readonly builderSlots: readonly string[];
     private _props;
     private _child;
     /** The container width the child was last clamped against, in DIPs. */

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

@@ -1,4 +1,4 @@
-import { Label, type EventData } from '@nativescript/core';
+import { Label, type EventData, type View } from '@nativescript/core';
 import type { AdwComboOption, AdwListModelInput } from '@gjsify/adwaita-core';
 import { AdwActionRow } from './adw-action-row.js';
 import { GtkImage } from './gtk-image.js';
@@ -15,12 +15,25 @@ export interface NotifySelectedEventData extends EventData {
     value: string;
 }
 export declare class AdwComboRow extends AdwActionRow {
+    /**
+     * The action row's edges, plus `model`: `model: Gtk.StringList { strings [ … ] }` in a
+     * `.blp` places the list at the property it sets (ADR 0072).
+     */
+    static readonly builderSlots: readonly string[];
     /** The dim inline value label (selected option). */
     protected readonly _valueLabel: Label;
     /** The down-chevron — a real Adwaita `pan-down-symbolic` icon. */
     protected readonly _chevron: GtkImage;
     /** The headless options list + selectedIndex↔selectedValue state machine (ADR 0004). */
     private readonly _state;
+    /**
+     * A `selected` written while the row has no model yet. NativeScript's XML builder assigns
+     * every attribute before it adds the children, so `<adw:ComboRow selected="1">` reaches
+     * this setter before its `<adw:ComboRow.model>` list does, and the index had nothing to
+     * select. Held until the first model arrives, which is the order a `.blp` states when it
+     * writes `model:` first — the order GtkBuilder needs too.
+     */
+    private _pendingSelected;
     constructor(props?: ConstructProps<AdwComboRow>);
     /**
      * `model_changed` (adw-combo-row.c:187-195) — one option or none is not a
@@ -36,6 +49,12 @@ export declare class AdwComboRow extends AdwActionRow {
     /** The list model (`Adw.ComboRow:model`). Updates the inline value label. */
     get model(): AdwComboOption[];
     set model(value: AdwListModelInput);
+    /**
+     * XML inflation: a child at `model` is the row's list — a `Gtk.StringList` is already an
+     * `AdwListModelInput`, so it goes through the same setter as the property. Everything
+     * else is a row edge, as on any action row.
+     */
+    _addChildFromBuilder(name: string, child: View): void;
     /** 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

@@ -12,6 +12,18 @@ export interface RowActivatedEventData extends EventData {
 declare const AdwDataGrid_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
     disconnect(handlerId: number): void;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
     _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;

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

@@ -13,6 +13,8 @@ export interface NotifyExpandedEventData extends EventData {
     expanded: boolean;
 }
 export declare class AdwExpanderRow extends AdwActionRow {
+    /** The names this widget's `_addChildFromBuilder` honours — see `./builder-slots.ts`. */
+    static readonly builderSlots: readonly string[];
     /** `AdwExpanderRow` derives from `AdwPreferencesRow` in C
      *  (adw-expander-row.c:72), so the search does not consult a subtitle here. */
     readonly isActionRow: boolean;

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

@@ -4,6 +4,18 @@ 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;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
     _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;
@@ -13,6 +25,8 @@ declare const AdwHeaderBar_base: (abstract new (...args: any[]) => {
     get(name: string): unknown;
 }) & typeof GridLayout;
 export declare class AdwHeaderBar extends AdwHeaderBar_base {
+    /** The names this widget's `_addChildFromBuilder` honours — see `./builder-slots.ts`. */
+    static readonly builderSlots: readonly string[];
     /** The start (left) slot — a horizontal stack. */
     protected readonly _startBox: StackLayout;
     /** The end (right) slot — a horizontal stack. */

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

@@ -14,6 +14,18 @@ export declare const DEFAULT_ICON_BUTTON_ICON_SIZE: number;
 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;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
     _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;

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

@@ -0,0 +1,63 @@
+import type { View } from '@nativescript/core';
+import { GridLayout } from '@nativescript/core';
+import { type ConstructProps } from './construct-props.js';
+/** The navigation view a page is registered in — the three setters it forwards to. */
+export interface NavigationPageOwner {
+    setPageTag(view: View, tag: string | null): boolean;
+    setPageTitle(view: View, title: string): boolean;
+    setPageCanPop(view: View, canPop: boolean): boolean;
+}
+declare const AdwNavigationPage_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => void): number;
+    disconnect(handlerId: number): void;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
+    _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 AdwNavigationPage extends AdwNavigationPage_base {
+    /**
+     * `Adw.NavigationPage:child` is the one destination, so it is also the fallback: an
+     * authored `child: …` and a bare child mean the same thing (adw-navigation-view.c:808).
+     */
+    static readonly builderSlots: readonly string[];
+    private _child;
+    private _tag;
+    private _title;
+    private _canPop;
+    private _owner;
+    constructor(props?: ConstructProps<AdwNavigationPage>);
+    /** Set (or clear) the page's content — `adw_navigation_page_set_child`. */
+    set_child(view: View | null): void;
+    /** The page's content, or `null`. */
+    get child(): View | null;
+    /** XML inflation — every child is THE child, as the C's `add_child` makes it. */
+    _addChildFromBuilder(_name: string, view: View): void;
+    /** `Adw.NavigationPage:tag` — how `push_by_tag` finds this page; `null` for none. */
+    get tag(): string | null;
+    set tag(value: string | null);
+    /** `Adw.NavigationPage:title` — also the next page's back-button tooltip. */
+    get title(): string;
+    set title(value: string);
+    /** `Adw.NavigationPage:can-pop` — gates the back button and the shortcuts, not `pop()`. */
+    get canPop(): boolean;
+    set canPop(raw: boolean | string);
+    /** Called by the view that registered this page, so later writes reach its stack. */
+    _setOwner(owner: NavigationPageOwner | null): void;
+}
+export {};

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

@@ -17,6 +17,18 @@ export type NotifyVisiblePageEventData = AdwNavigationEventData;
 declare const AdwNavigationView_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
     disconnect(handlerId: number): void;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
     _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;
@@ -38,11 +50,12 @@ export declare class AdwNavigationView extends AdwNavigationView_base {
      * An XML child is a PAGE, registered in document order — so the first one is
      * pushed and the rest wait behind it, exactly as `add` already promises.
      *
-     * 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. `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.
+     * An {@link AdwNavigationPage} brings its own `tag`, `title` and `can-pop`, which is
+     * what `adw_navigation_view_add` reads off an `AdwNavigationPage` in C
+     * (adw-navigation-view.c:2192), and it keeps a handle on this view so a later write
+     * to one of them reaches the stack. Any other view is still accepted and registered
+     * untagged: this port let a bare view be a page before the page class existed, and
+     * dropping it — the C's `g_warning` — would empty every template written that way.
      */
     _addChildFromBuilder(_name: string, view: View): void;
     /**

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

@@ -8,6 +8,18 @@ export declare const CLOSED = "closed";
 declare const AdwPreferencesDialog_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
     disconnect(handlerId: number): void;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
     _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;

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

@@ -5,6 +5,18 @@ 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;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
     _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;
@@ -14,6 +26,8 @@ declare const AdwPreferencesGroup_base: (abstract new (...args: any[]) => {
     get(name: string): unknown;
 }) & typeof StackLayout;
 export declare class AdwPreferencesGroup extends AdwPreferencesGroup_base implements NsSearchableGroup {
+    /** The names this widget's `_addChildFromBuilder` honours — see `./builder-slots.ts`. */
+    static readonly builderSlots: readonly string[];
     /** The header box: labels on the leading edge, suffix on the trailing one. */
     protected readonly _header: GridLayout;
     /** The group header label. */

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

@@ -5,6 +5,18 @@ 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;
+    get halign(): string;
+    set halign(value: string | number);
+    get valign(): string;
+    set valign(value: string | number);
+    get hexpand(): boolean;
+    set hexpand(value: boolean | string);
+    get vexpand(): boolean;
+    set vexpand(value: boolean | string);
+    get marginStart(): number;
+    set marginStart(value: number | string);
+    get marginEnd(): number;
+    set marginEnd(value: number | string);
     _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;