@gjsify/adwaita-nativescript 0.51.1 → 0.52.0

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

@@ -3,6 +3,18 @@ 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;
+    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-sidebar.d.ts

@@ -29,6 +29,18 @@ export interface SidebarActivatedEventData extends EventData {
 declare const AdwSidebar_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;
@@ -41,8 +53,22 @@ export declare class AdwSidebar extends AdwSidebar_base {
     /** The vertical list container. */
     protected readonly _list: StackLayout;
     private readonly _state;
+    /**
+     * A `selected` written before any section exists. NativeScript's XML builder assigns the
+     * attribute before it appends the `<adw:SidebarSection>` children, so the index was
+     * out of range and cleared the selection — where GtkBuilder, adding the same children,
+     * ends with the index the file wrote. Held until the first items arrive.
+     */
+    private _pendingSelected;
     private readonly _rows;
     constructor(props?: ConstructProps<AdwSidebar>);
+    /**
+     * XML inflation: every child is an `Adw.SidebarSection`, appended in document order as
+     * `adw_sidebar_append` appends it, with the items it already holds. Anything else is
+     * refused, as the C refuses it with a `g_warning` (adw-sidebar.c:2758) — a view here
+     * would be a row nobody authored.
+     */
+    _addChildFromBuilder(_name: string, child: object): void;
     /** 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`). */

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

@@ -11,6 +11,18 @@ export interface NotifySliderValueEventData extends EventData {
 declare const AdwSliderRow_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-spin-row.d.ts

@@ -1,5 +1,5 @@
 import { Label } from '@nativescript/core';
-import type { EventData } from '@nativescript/core';
+import type { EventData, View } 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';
@@ -14,6 +14,11 @@ export interface NotifyValueEventData extends EventData {
     value: number;
 }
 export declare class AdwSpinRow extends AdwActionRow {
+    /**
+     * The action row's edges, plus `adjustment`: `adjustment: Adjustment { … }` in a `.blp`
+     * places a `Gtk.Adjustment` at the property it sets.
+     */
+    static readonly builderSlots: readonly string[];
     /** The `−` decrement button (circular icon button, value-decrease symbolic). */
     protected readonly _minusButton: AdwImageButton;
     /** The `+` increment button (circular icon button, value-increase symbolic). */
@@ -23,6 +28,12 @@ export declare class AdwSpinRow extends AdwActionRow {
     /** The headless adjustment: clamp, step and the two signals (ADR 0004, ADR 0047). */
     private readonly _state;
     constructor(props?: ConstructProps<AdwSpinRow>);
+    /**
+     * XML inflation: a child at `adjustment` is the row's range, written through the same
+     * setter as the property — a `Gtk.Adjustment` is already an `AdwAdjustmentInput`.
+     * Everything else is a row edge, as on any action row.
+     */
+    _addChildFromBuilder(name: string, child: View): void;
     /** The current numeric value (always within the adjustment's range). */
     get value(): number;
     set value(v: number | string);

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

@@ -5,6 +5,18 @@ export { DEFAULT_SPINNER_SIZE };
 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;
+    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-split-button.d.ts

@@ -24,6 +24,18 @@ export interface MenuTappedEventData extends EventData {
 declare const AdwSplitButton_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-status-page.d.ts

@@ -5,6 +5,18 @@ 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;
+    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,13 @@ declare const AdwStatusPage_base: (abstract new (...args: any[]) => {
     get(name: string): unknown;
 }) & typeof GridLayout;
 export declare class AdwStatusPage extends AdwStatusPage_base {
+    /**
+     * The names this widget's `_addChildFromBuilder` honours — see `./builder-slots.ts`.
+     * `Adw.StatusPage: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[];
     /** The centered vertical stack. */
     protected readonly _stack: StackLayout;
     /** The large symbolic icon (shown when an `icon` SVG is set). */
@@ -27,6 +46,7 @@ export declare class AdwStatusPage extends AdwStatusPage_base {
     /** The dim description label. */
     protected readonly _descriptionLabel: Label;
     private _child;
+    private _styleClasses;
     constructor(props?: ConstructProps<AdwStatusPage>);
     /**
      * The large icon shown above the title — an Adwaita icon NAME
@@ -60,6 +80,12 @@ export declare class AdwStatusPage extends AdwStatusPage_base {
     set_child(view: View | null): void;
     /** The currently-installed child, or `null`. */
     get child(): View | null;
+    /**
+     * `Adw.StatusPage:child` — {@link set_child} under the property spelling the
+     * counterpart declares, so the one slot a status page has can arrive in the
+     * construct-props bag instead of a second statement after it.
+     */
+    set child(view: View | null);
     /**
      * The one destination an XML child can have: the slot under the description,
      * where `AdwStatusPage:child` goes. The name is ignored because
@@ -67,5 +93,25 @@ export declare class AdwStatusPage extends AdwStatusPage_base {
      * `AdwClamp` already has.
      */
     _addChildFromBuilder(_name: string, view: View): void;
+    /**
+     * `GtkWidget:css-classes`, spelled `styleClasses` for the reason `style-classes.ts` gives.
+     * A status page has one documented style class, `.compact` (style-classes.md "Compact
+     * Status Page"), and a `.blp` writes it as `styles ["compact"]`; the shared-tree builder
+     * refuses a style class the widget has no door for, so the gallery's carousel of compact
+     * pages did not build here.
+     */
+    get styleClasses(): string[];
+    set styleClasses(value: string | null | undefined);
+    /** `gtk_widget_add_css_class`. A class the page 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 page's own class. */
+    get_css_classes(): string[];
+    /** `gtk_widget_set_css_classes` — REPLACES the list, as in C. */
+    set_css_classes(names: readonly string[]): void;
+    private _setClasses;
 }
 export {};

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

@@ -1,9 +1,9 @@
 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 NsTabPage, 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 };
+export type { NsTabPage };
 /** Event name emitted when the selected page changes. Mirrors `notify::selected-page`. */
 export declare const NOTIFY_SELECTED_PAGE = "notify::selected-page";
 /** Event name emitted for every page-list change (attach / detach / reorder / pin / update). */
@@ -26,6 +26,18 @@ export interface ClosePageEventData extends EventData {
 declare const AdwTabView_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;
@@ -45,7 +57,7 @@ export declare class AdwTabView extends AdwTabView_base {
     private _generatedIds;
     /**
      * The `close-page` decision seam. Return `true` to confirm, `false` to deny,
-     * `'defer'` to hold the page until {@link closePageFinish} — which is how an
+     * `'defer'` to hold the page until {@link close_page_finish} — which is how an
      * app shows a "save before closing?" dialog. Unset takes libadwaita's own
      * default, `!page.pinned` (adw-tab-view.c:1990-1991).
      *
@@ -53,10 +65,10 @@ export declare class AdwTabView extends AdwTabView_base {
      * carry one; {@link CLOSE_PAGE} still fires for every attempt, so observing
      * and deciding stay separable.
      */
-    closeHandler: ((page: AdwTabPage) => boolean | 'defer') | null;
+    closeHandler: ((page: NsTabPage) => boolean | 'defer') | null;
     constructor(props?: ConstructProps<AdwTabView>);
     /** All pages in order. */
-    get pages(): readonly AdwTabPage[];
+    get pages(): readonly NsTabPage[];
     /** Number of pages. */
     get nPages(): number;
     /** Length of the pinned prefix. */
@@ -77,11 +89,11 @@ export declare class AdwTabView extends AdwTabView_base {
      * 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;
+    get selectedPage(): NsTabPage | null;
     set selectedPage(id: string | null);
     isClosing(id: string): 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;
+    set_selected_page(page: NsTabPage | string | null): boolean;
     selectNthPage(n: number): boolean;
     /** `adw_tab_view_select_previous_page`. */
     select_previous_page(): boolean;
@@ -93,29 +105,44 @@ export declare class AdwTabView extends AdwTabView_base {
     cycleNextPage(): boolean;
     /** The previous page, WRAPPING to the last (Ctrl+Shift+Tab). */
     cyclePreviousPage(): boolean;
-    /** Add a page opened FROM `parentId`, deriving its position (Adw.TabView.add_page). */
-    addPage(spec: AdwTabPageSpec<View>, parentId?: string | null): number;
-    insertPage(spec: AdwTabPageSpec<View>, position: number): number;
-    prependPage(spec: AdwTabPageSpec<View>): number;
-    appendPage(spec: AdwTabPageSpec<View>): number;
-    insertPinnedPage(spec: AdwTabPageSpec<View>, position: number): number;
-    prependPinnedPage(spec: AdwTabPageSpec<View>): number;
-    appendPinnedPage(spec: AdwTabPageSpec<View>): number;
+    /** Add a page opened FROM `parent`, deriving its position — `adw_tab_view_add_page`. */
+    add_page(spec: AdwTabPageSpec<View>, parent?: NsTabPage | string | null): number;
+    /** `adw_tab_view_insert`. */
+    insert(spec: AdwTabPageSpec<View>, position: number): number;
+    /** `adw_tab_view_prepend`. */
+    prepend(spec: AdwTabPageSpec<View>): number;
+    /** `adw_tab_view_append`. */
+    append(spec: AdwTabPageSpec<View>): number;
+    /** `adw_tab_view_insert_pinned`. */
+    insert_pinned(spec: AdwTabPageSpec<View>, position: number): number;
+    /** `adw_tab_view_prepend_pinned`. */
+    prepend_pinned(spec: AdwTabPageSpec<View>): number;
+    /** `adw_tab_view_append_pinned`. */
+    append_pinned(spec: AdwTabPageSpec<View>): number;
     /** Pin or unpin a page, re-ordering it in the same step. Returns its new position. */
-    setPagePinned(id: string, pinned: boolean): number;
+    set_page_pinned(page: NsTabPage | string, pinned: boolean): number;
     /** Request a close. Fires {@link CLOSE_PAGE}, then applies {@link closeHandler}'s verdict. */
-    closePage(id: string): boolean;
-    closePageFinish(id: string, confirm: boolean): boolean;
-    closeOtherPages(id: string): void;
-    closePagesBefore(id: string): void;
-    closePagesAfter(id: string): void;
+    close_page(page: NsTabPage | string): boolean;
+    /** Settle a close {@link closeHandler} deferred — `adw_tab_view_close_page_finish`. */
+    close_page_finish(page: NsTabPage | string, confirm: boolean): boolean;
+    /** `adw_tab_view_close_other_pages`. */
+    close_other_pages(page: NsTabPage | string): void;
+    /** `adw_tab_view_close_pages_before`. */
+    close_pages_before(page: NsTabPage | string): void;
+    /** `adw_tab_view_close_pages_after`. */
+    close_pages_after(page: NsTabPage | string): void;
     /** Remove a page unconditionally, running the successor rule first. */
-    detachPage(id: string): AdwTabPage | null;
-    reorderPage(id: string, position: number): boolean;
-    reorderBackward(id: string): boolean;
-    reorderForward(id: string): boolean;
-    reorderFirst(id: string): boolean;
-    reorderLast(id: string): boolean;
+    detachPage(id: string): NsTabPage | null;
+    /** `adw_tab_view_reorder_page`. */
+    reorder_page(page: NsTabPage | string, position: number): boolean;
+    /** `adw_tab_view_reorder_backward`. */
+    reorder_backward(page: NsTabPage | string): boolean;
+    /** `adw_tab_view_reorder_forward`. */
+    reorder_forward(page: NsTabPage | string): boolean;
+    /** `adw_tab_view_reorder_first`. */
+    reorder_first(page: NsTabPage | string): boolean;
+    /** `adw_tab_view_reorder_last`. */
+    reorder_last(page: NsTabPage | string): boolean;
     setPageTitle(id: string, title: string | null): boolean;
     setPageIcon(id: string, icon: string | null): boolean;
     setPageLoading(id: string, loading: boolean): boolean;
@@ -133,6 +160,12 @@ export declare class AdwTabView extends AdwTabView_base {
     /** `Adw.TabView:default-icon` — what a PINNED page with no icon of its own shows. */
     get defaultIcon(): string | null;
     set defaultIcon(value: string | null);
+    /**
+     * XML inflation: an `Adw.TabPage` becomes an appended page carrying its title, and a
+     * bare widget becomes an untitled page around itself — the two branches of the C's
+     * `add_child` (adw-tab-view.c:2884). Both take a generated id, as `setViews` does.
+     */
+    _addChildFromBuilder(_name: string, child: object): void;
     /**
      * Replace every page from a plain `{ title, content, icon? }` list.
      *

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

@@ -10,6 +10,18 @@ export declare const TOAST_BUTTON_CLICKED = "toastButtonClicked";
 declare const AdwToastOverlay_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;
@@ -31,6 +43,14 @@ export declare class AdwToastOverlay extends AdwToastOverlay_base {
     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;
+    /** The always-visible content layer, or `null` — `Adw.ToastOverlay:child`. */
+    get child(): View | null;
+    /**
+     * `Adw.ToastOverlay:child` — {@link set_child} under the property spelling the
+     * counterpart declares, so the overlay's one slot can arrive in a construct-props
+     * bag instead of a second statement.
+     */
+    set child(view: View | null);
     /** 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. */

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

@@ -11,14 +11,31 @@ export interface NotifyToggleSelectedEventData extends EventData {
     /** The newly-selected segment's label. */
     value: string;
 }
-/** One toggle: a label and an optional Adwaita symbolic SVG icon. */
-export interface AdwToggle {
+/**
+ * One toggle as {@link AdwToggleGroup.setToggles} takes it: a label, an optional Adwaita
+ * symbolic icon, and the `name` `active-name` finds it by. A `.blp` writes an
+ * {@link AdwToggle} instead, which the group reads into one of these.
+ */
+export interface AdwToggleSpec {
     label: string;
     icon?: string;
+    name?: string | null;
 }
 declare const AdwToggleGroup_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;
@@ -29,6 +46,14 @@ declare const AdwToggleGroup_base: (abstract new (...args: any[]) => {
 }) & typeof StackLayout;
 export declare class AdwToggleGroup extends AdwToggleGroup_base {
     private _toggles;
+    /**
+     * `active` / `active-name` written before the toggle they name exists. GtkBuilder sets
+     * a group's properties BEFORE it adds the toggles, so the C holds both back until
+     * `parser_finished` (adw-toggle-group.c:1238); NativeScript has no such hook, so each
+     * one is applied by the first toggle list it resolves against.
+     */
+    private _pendingActive;
+    private _pendingActiveName;
     private readonly _segments;
     /** The headless labels + selected-index state machine (ADR 0004). */
     private readonly _state;
@@ -37,12 +62,35 @@ export declare class AdwToggleGroup extends AdwToggleGroup_base {
     get options(): string[];
     set options(value: string[]);
     /** Set the toggles (label + optional symbolic icon). Rebuilds the segments. */
-    setToggles(toggles: AdwToggle[]): void;
+    setToggles(toggles: AdwToggleSpec[]): void;
+    private _rebuild;
+    /**
+     * XML inflation: every child is an `Adw.Toggle`, appended in document order as
+     * `adw_toggle_group_add` appends it. Anything else is refused, as the C refuses a
+     * widget child with a `g_critical` (adw-toggle-group.c:1213) — a view placed here
+     * would be a segment nobody asked for.
+     */
+    _addChildFromBuilder(_name: string, child: object): void;
+    /**
+     * Apply a held `active` / `active-name` once it resolves, the name after the index as
+     * `parser_finished` orders them. `building` keeps the name held for the next toggle;
+     * any other change is the end of construction, and a name that still resolves to
+     * nothing is dropped as the C drops it (a `g_critical`, :2001).
+     */
+    private _applyPending;
     /** Mark only the selected segment `.active` (the raised white pill). */
     private _applySelection;
     /** The selected segment index. Swaps the active pill + emits `notify::selected`. */
     get active(): number;
     set active(raw: number | string);
+    /**
+     * `Adw.ToggleGroup:active-name` — the `name` of the active toggle, or `null`.
+     *
+     * A name no toggle carries yet is held until one does (see `_pendingActiveName`); a
+     * name that never arrives changes nothing, which is the C's `g_critical` and return.
+     */
+    get activeName(): string | null;
+    set activeName(name: string | null);
     /** The selected segment's label, or `''` when out of range. */
     get selectedValue(): string;
 }

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

@@ -0,0 +1,41 @@
+import { Observable } from '@nativescript/core';
+import { type ConstructProps } from './construct-props.js';
+declare const AdwToggle_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 Observable;
+export declare class AdwToggle extends AdwToggle_base {
+    private _name;
+    private _label;
+    private _iconName;
+    constructor(props?: ConstructProps<AdwToggle>);
+    /** `Adw.Toggle:name` — how `Adw.ToggleGroup:active-name` finds this toggle. */
+    get name(): string | null;
+    set name(value: string | null);
+    /** `Adw.Toggle:label`. */
+    get label(): string;
+    set label(value: string | null);
+    /** `Adw.Toggle:icon-name` — a symbolic icon drawn before the label. */
+    get iconName(): string | null;
+    set iconName(value: string | null);
+}
+export {};

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

@@ -5,6 +5,18 @@ import { type ConstructProps } from './construct-props.js';
 declare const AdwToolbarView_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => void): number;
     disconnect(handlerId: number): void;
+    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 AdwToolbarView_base: (abstract new (...args: any[]) => {
     get(name: string): unknown;
 }) & typeof GridLayout;
 export declare class AdwToolbarView extends AdwToolbarView_base {
+    /** The names this widget's `_addChildFromBuilder` honours — see `./builder-slots.ts`. */
+    static readonly builderSlots: readonly string[];
     /** The top-bar slot (row 0) — stack of header bars / toolbars. */
     protected readonly _topBox: StackLayout;
     /** The bottom-bar slot (row 2) — stack of bottom toolbars. */
@@ -43,8 +57,15 @@ export declare class AdwToolbarView extends AdwToolbarView_base {
      * painted ON TOP OF EACH OTHER in the bar row while row 1 stayed empty.
      */
     _addChildFromBuilder(name: string, view: View): void;
-    /** The currently-installed content view, or `null`. */
+    /**
+     * The currently-installed content view, or `null` — `Adw.ToolbarView:content`.
+     *
+     * The setter is {@link set_content} under the property spelling the counterpart
+     * declares, so a construct-props bag can carry the slot and a pane ported off GJS
+     * keeps `view.content = …` rather than growing a second verb.
+     */
     get content(): View | null;
+    set content(view: View | null);
     /** The top-bar slot container. */
     get topBar(): StackLayout;
     /** The bottom-bar slot container. */