@gjsify/adwaita-nativescript 0.44.0 → 0.46.0

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

@@ -1,4 +1,5 @@
-import { GridLayout, StackLayout, View } from '@nativescript/core';
+import type { View } from '@nativescript/core';
+import { GridLayout, StackLayout } from '@nativescript/core';
 import type { BottomSheetCloseOutcome, BottomSheetCloseSource } from '@gjsify/adwaita-core';
 import { CLOSE_ATTEMPT, NOTIFY_OPEN, SHEET_CLOSE, type NotifyOpenEventData } from './bottom-sheet-state.js';
 export { CLOSE_ATTEMPT, NOTIFY_OPEN, SHEET_CLOSE };
@@ -16,6 +17,24 @@ export declare class AdwBottomSheet extends GridLayout {
     setContent(view: View | null): void;
     /** Set (or replace) the sheet panel's child (shown when open). */
     setSheet(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
+     * with it.
+     */
+    _addChildFromBuilder(name: string, view: View): void;
+    /**
+     * The always-visible content layer, or `null`.
+     *
+     * A read-back for `setContent`: a write-only pane cannot be asserted, and the XML
+     * door made that concrete — the gallery probe has to ask the widget where the
+     * child it declared actually went.
+     */
+    get content(): View | null;
+    /** The sheet panel's child, or `null` — the read-back for `setSheet`. */
+    get sheet(): View | null;
     /** Open the sheet programmatically. */
     open(): void;
     /**
@@ -25,13 +44,13 @@ export declare class AdwBottomSheet extends GridLayout {
     close(): void;
     /** Whether the sheet is open. Toggling shows/hides the panel + emits `notify::open`. */
     get openState(): boolean;
-    set openState(value: boolean);
+    set openState(value: 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(value: boolean);
+    set canClose(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

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

@@ -26,8 +26,8 @@ export declare class AdwButtonContent extends StackLayout {
      * the C sets that fallback (:355-356) and never hides `self->icon`. The doc
      * comments at :228/:343 say otherwise — see `buttonContentIconSvg`.
      */
-    get icon(): string;
-    set icon(svg: string);
+    get iconName(): string;
+    set iconName(svg: string);
     /** Whether the icon currently shown is the empty-slot fallback. */
     get iconIsFallback(): boolean;
     /** The icon fill colour (hex). Set to the button's foreground (e.g. white on suggested-action). */
@@ -41,7 +41,7 @@ export declare class AdwButtonContent extends StackLayout {
      * Defaults to FALSE (:253-256), so an underscore is a literal unless asked.
      */
     get useUnderline(): boolean;
-    set useUnderline(value: boolean);
+    set useUnderline(raw: boolean | string);
     /**
      * Whether the label may be smaller than its natural size (:489-491).
      *
@@ -51,7 +51,7 @@ export declare class AdwButtonContent extends StackLayout {
      * but the truncation ellipsis is not available on this platform.
      */
     get canShrink(): boolean;
-    set canShrink(value: boolean);
+    set canShrink(raw: boolean | string);
     /** The label's `PangoEllipsizeMode` for the current `canShrink` (:462). */
     get ellipsize(): ButtonContentEllipsize;
     private _renderLabel;

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

@@ -34,14 +34,14 @@ export declare class AdwButtonRow extends AdwActionRow {
      * A leading Adwaita symbolic SVG string before the centered title (e.g.
      * `listAddSymbolic`). Empty collapses the icon.
      */
-    get startIcon(): string;
-    set startIcon(value: string);
+    get startIconName(): string;
+    set startIconName(value: string);
     /**
      * A trailing Adwaita symbolic SVG string after the centered title (e.g.
      * `goNextSymbolic`) — `Adw.ButtonRow:end-icon-name`. Empty collapses it.
      */
-    get endIcon(): string;
-    set endIcon(value: string);
+    get endIconName(): string;
+    set endIconName(value: string);
     /**
      * The icons' fill colour (hex). Defaults to the Adwaita accent; callers set
      * the destructive red when the row carries `destructive-action` so the

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

@@ -1,4 +1,5 @@
-import { GridLayout, ScrollView, StackLayout, View, type EventData } from '@nativescript/core';
+import type { View } from '@nativescript/core';
+import { GridLayout, ScrollView, StackLayout, type EventData } from '@nativescript/core';
 import { DEFAULT_CAROUSEL_PAGE_WIDTH, type CarouselNotifyPayload } from './carousel-state.js';
 export { DEFAULT_CAROUSEL_PAGE_WIDTH };
 /** Event name emitted when {@link AdwCarousel.position} changes. Mirrors GObject `notify::position`. */
@@ -33,6 +34,15 @@ export declare class AdwCarousel extends GridLayout {
     constructor();
     /** Append a page — `adw_carousel_append` (adw-carousel.c:1348-1357). */
     addPage(view: View): void;
+    /**
+     * An XML child is a PAGE, appended in document order.
+     *
+     * 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.
+     */
+    _addChildFromBuilder(_name: string, view: View): void;
     /**
      * Insert a page at `position` — `adw_carousel_insert` (adw-carousel.c:1370-1407).
      * `-1` or a position past the end appends. Returns whether it was added.
@@ -51,6 +61,8 @@ export declare class AdwCarousel extends GridLayout {
     scrollToPage(index: number): 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 `addPage`/`insertPage`. */
+    get pages(): readonly View[];
     /** The number of pages. */
     get nPages(): number;
     /** The fractional scroll position; 1 matches 1 page. */
@@ -63,19 +75,19 @@ export declare class AdwCarousel extends GridLayout {
      * `get_page_at_position` rule used everywhere else, so 0.5 lands on page 0
      * where the old `Math.round` picked page 1.
      */
-    set position(value: number);
+    set position(raw: number | string);
     /** The page the current position settles on, `-1` when the carousel is empty. */
     get currentPage(): number;
     /** Whether the carousel can be navigated (`AdwCarousel:interactive`, default TRUE). */
     get interactive(): boolean;
-    set interactive(value: boolean);
+    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
      * all existing pages.
      */
     get pageWidth(): number;
-    set pageWidth(value: number);
+    set pageWidth(raw: number | string);
     /** The px pitch between two page origins — `self->distance` (adw-carousel.c:767). */
     private _distance;
     /** The state's id for a page view, or `null` when it is not one of ours. */

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

@@ -1,4 +1,5 @@
-import { GridLayout, View } from '@nativescript/core';
+import type { View } from '@nativescript/core';
+import { GridLayout } from '@nativescript/core';
 import { DEFAULT_CLAMP_MAX_SIZE, DEFAULT_CLAMP_TIGHTENING_THRESHOLD } from './chrome.js';
 export { DEFAULT_CLAMP_MAX_SIZE, DEFAULT_CLAMP_TIGHTENING_THRESHOLD };
 export declare class AdwClamp extends GridLayout {
@@ -11,9 +12,20 @@ export declare class AdwClamp extends GridLayout {
     setChild(view: View | null): void;
     /** The currently-clamped child, or `null`. */
     get child(): View | null;
+    /**
+     * XML inflation — every child a template declares is THE clamped child.
+     *
+     * Without this the `LayoutBase` default calls `addChild`, which puts the view
+     * in the grid and leaves `_child` null, so `_allocate` returns early: measured
+     * on Android, a clamp written in markup rendered its child at full width with
+     * no size class at all, i.e. as if there were no clamp around it. The name is
+     * ignored because there is only one destination — `<AdwClamp.child>` and a
+     * bare child mean the same thing.
+     */
+    _addChildFromBuilder(_name: string, view: View): void;
     /** `Adw.Clamp:maximum-size` — the widest the child may ever get, in DIPs. */
     get maximumSize(): number;
-    set maximumSize(value: number);
+    set maximumSize(value: number | string);
     /**
      * `Adw.Clamp:tightening-threshold` — the width above which the clamp starts
      * tightening its grip, easing the child toward {@link maximumSize} instead of
@@ -21,7 +33,7 @@ export declare class AdwClamp extends GridLayout {
      * only the GTK pane responded to it.
      */
     get tighteningThreshold(): number;
-    set tighteningThreshold(value: number);
+    set tighteningThreshold(value: number | string);
     /**
      * Re-run libadwaita's allocation against the container's current width.
      *

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

@@ -4,7 +4,7 @@ import { AdwActionRow } from './adw-action-row.js';
 import { AdwIcon } from './adw-icon.js';
 export { ComboState } from '@gjsify/adwaita-core';
 export type { AdwComboOption, ComboStateChange, ComboStateListener } from '@gjsify/adwaita-core';
-/** Event name emitted when {@link AdwComboRow.selectedIndex} changes. Mirrors GObject `notify::selected`. */
+/** Event name emitted when {@link AdwComboRow.selected} changes. Mirrors GObject `notify::selected`. */
 export declare const NOTIFY_SELECTED = "notify::selected";
 /** Payload of the `notify::selected` event. */
 export interface NotifySelectedEventData extends EventData {
@@ -36,8 +36,8 @@ export declare class AdwComboRow extends AdwActionRow {
     get options(): AdwComboOption[];
     set options(value: AdwComboOption[]);
     /** The selected option index. Updates the inline value label. */
-    get selectedIndex(): number;
-    set selectedIndex(value: number);
+    get selected(): number;
+    set selected(raw: number | string);
     /** The selected option's `value`, or `''` when out of range. */
     get selectedValue(): string;
     set selectedValue(value: string);

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

@@ -35,7 +35,7 @@ export declare class AdwDataGrid extends GridLayout {
      * `interactive` class and answer a tap, and nothing about the layout.
      */
     get interactive(): boolean;
-    set interactive(value: boolean);
+    set interactive(raw: boolean | string);
     private _render;
     /**
      * (Re)declare the column tracks from the descriptors.

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

@@ -60,16 +60,16 @@ export declare class AdwEntryRow extends AdwActionRow {
     get textLength(): number;
     /** `Adw.EntryRow:max-length` — maximum number of characters, `0` = unlimited. */
     get maxLength(): number;
-    set maxLength(value: number);
+    set maxLength(raw: number | string);
     /** Whether the entry accepts edits (`GtkEditable:editable`). */
     get editable(): boolean;
-    set editable(value: boolean);
+    set editable(raw: boolean | string);
     /** `Adw.EntryRow:show-apply-button` — typing reveals an apply button. */
     get showApplyButton(): boolean;
-    set showApplyButton(value: boolean);
+    set showApplyButton(raw: boolean | string);
     /** `Adw.EntryRow:activates-default` — reported on `entry-activated`, acted on by the host. */
     get activatesDefault(): boolean;
-    set activatesDefault(value: boolean);
+    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. */

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

@@ -1,4 +1,5 @@
-import { ItemSpec, StackLayout, View, type EventData } from '@nativescript/core';
+import type { View } from '@nativescript/core';
+import { ItemSpec, StackLayout, type EventData } from '@nativescript/core';
 import { AdwActionRow } from './adw-action-row.js';
 import { AdwIcon } from './adw-icon.js';
 export { ExpanderState } from '@gjsify/adwaita-core';
@@ -25,7 +26,26 @@ export declare class AdwExpanderRow extends AdwActionRow {
     addRow(viewOrSpec: View | ItemSpec): void;
     /** Remove a previously-added child row from the disclosure container. */
     removeRow(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
+     * rule rather than inheriting it. The two edges stay reachable by name.
+     */
+    _addChildFromBuilder(name: string, view: View): void;
+    /**
+     * The rows inside the disclosure, in order — the read-back for `addRow`.
+     *
+     * 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
+     * name on a subclass shadows it: `expanderRow.rows = 'auto,*'` then throws
+     * `TypeError: Cannot set property rows … which has only a getter` in strict mode,
+     * 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.
+     */
+    get disclosureRows(): readonly View[];
     /** Whether the disclosure is revealed. */
     get expanded(): boolean;
-    set expanded(value: boolean);
+    set expanded(value: boolean | string);
 }

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

@@ -1,4 +1,5 @@
-import { GridLayout, StackLayout, View } from '@nativescript/core';
+import type { View } from '@nativescript/core';
+import { GridLayout, StackLayout } from '@nativescript/core';
 export declare class AdwHeaderBar extends GridLayout {
     /** The start (left) slot — a horizontal stack. */
     protected readonly _startBox: StackLayout;
@@ -19,7 +20,7 @@ export declare class AdwHeaderBar extends GridLayout {
      * matching `Adw.HeaderBar`'s `.flat` style. Toggling swaps the `flat` class.
      */
     get flat(): boolean;
-    set flat(value: boolean);
+    set flat(raw: boolean | string);
     /** Pack a widget at the start (left) of the bar — `gtk_box_append`. */
     packStart(view: View): void;
     /**
@@ -35,6 +36,18 @@ export declare class AdwHeaderBar extends GridLayout {
     packEnd(view: View): void;
     /** Replace the centered title widget with a custom one (e.g. a URL entry). */
     setTitleWidget(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
+     * 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
+     * drawn on top of the first rather than beside it.
+     */
+    _addChildFromBuilder(name: string, view: View): void;
     /** The centered title widget. */
     get titleWidget(): View;
     /** The start (left) slot container. */

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

@@ -12,8 +12,8 @@ export declare class AdwIcon extends Image {
     private _syncThemeColor;
     private _render;
     /** The Adwaita symbolic SVG string to render (e.g. `panDownSymbolic`). */
-    get icon(): string;
-    set icon(svg: string);
+    get iconName(): string;
+    set iconName(svg: string);
     /** The icon fill colour (hex). Setting it PINS the colour (it no longer follows
      *  the light/dark scheme) — use it for context colours like white on a suggested
      *  button or destructive red, which must survive both schemes. */
@@ -21,5 +21,5 @@ export declare class AdwIcon extends Image {
     set iconColor(value: string);
     /** The icon size in DIPs (default 16). Re-renders + resizes the image box. */
     get iconSize(): number;
-    set iconSize(value: number);
+    set iconSize(raw: number | string);
 }

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

@@ -15,15 +15,15 @@ export declare class AdwImageButton extends GridLayout {
     /** Re-render the icon bitmap from the current svg / colour / size. */
     private _render;
     /** The Adwaita symbolic SVG string to render (e.g. `goPreviousSymbolic`). */
-    get icon(): string;
-    set icon(svg: string);
+    get iconName(): string;
+    set iconName(svg: 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;
     set iconColor(value: string);
     /** The icon size in DIPs (default 16). Re-renders + resizes the image box. */
     get iconSize(): number;
-    set iconSize(value: number);
+    set iconSize(raw: number | string);
     /** The underlying icon {@link Image} (e.g. to tweak alignment). */
     get image(): Image;
 }

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

@@ -29,5 +29,5 @@ export declare class AdwNavigationSplitView extends AdwSplitViewBase<NsNavigatio
     pop(): NavigationActionResult;
     /** `Adw.NavigationSplitView:show-content`, the C's own spelling of the flag. */
     get showContent(): boolean;
-    set showContent(value: boolean);
+    set showContent(raw: boolean | string);
 }

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

@@ -22,6 +22,17 @@ export declare class AdwNavigationView extends GridLayout {
      * which also re-arms after `replace([])`.
      */
     add(view: View, tag?: string | null, options?: Omit<AdwNavigationPageProps, 'tag'>): boolean;
+    /**
+     * 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. `pushByTag` 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
@@ -80,9 +91,9 @@ export declare class AdwNavigationView extends GridLayout {
      * subset has no transition, so the swap is instant either way.
      */
     get animateTransitions(): boolean;
-    set animateTransitions(value: boolean);
+    set animateTransitions(raw: boolean | string);
     /** `Adw.NavigationView:pop-on-escape` — consulted by {@link popFromEscape}. */
     get popOnEscape(): boolean;
-    set popOnEscape(value: boolean);
+    set popOnEscape(raw: boolean | string);
     private _emit;
 }

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

@@ -10,7 +10,7 @@ export declare class AdwOverlaySplitView extends AdwSplitViewBase<NsOverlaySplit
      * default FALSE) — whether collapsing leaves the sidebar's visibility alone.
      */
     get pinSidebar(): boolean;
-    set pinSidebar(value: boolean);
+    set pinSidebar(raw: boolean | string);
     protected _applyLayout(): void;
     /** Animate a collapsed show/hide toggle; fall back to instant off-screen/off-device. */
     protected _transitionSidebar(): void;

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

@@ -18,14 +18,14 @@ export declare class AdwPasswordEntryRow extends AdwEntryRow {
     constructor();
     /** Whether the contents are shown in clear text (`GtkText:visibility`). */
     get revealed(): boolean;
-    set revealed(value: boolean);
+    set revealed(value: boolean | string);
     /**
      * Legacy spelling of {@link revealed}. The web port called it `revealed`, this
      * one called it `peeking`, and neither name is in the C — kept so existing
      * NativeScript callers keep working while `revealed` is the shared name.
      */
     get peeking(): boolean;
-    set peeking(value: boolean);
+    set peeking(value: boolean | string);
     /** Flip masked↔revealed — `show_text_clicked_cb` (C:90-97). */
     togglePeek(): boolean;
     /** Whether Caps Lock is engaged, as last reported by the host. */

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

@@ -1,4 +1,5 @@
-import { GridLayout, Label, StackLayout, View } from '@nativescript/core';
+import type { View } from '@nativescript/core';
+import { GridLayout, Label, StackLayout } from '@nativescript/core';
 import type { SearchPreferencesOptions } from '@gjsify/adwaita-core';
 import { type NsPreferencesSearchResult, type NsSearchablePage } from './preferences-search.js';
 /** Event name emitted when the dialog is closed. */
@@ -14,6 +15,12 @@ export declare class AdwPreferencesDialog extends GridLayout {
     set title(value: string);
     /** Add an `AdwPreferencesPage` (or any view) to the dialog body. */
     add(view: View): void;
+    /**
+     * An XML child is a page in the dialog BODY, not a child of the grid the dialog
+     * builds its header and scroller in — which is where `LayoutBase`'s inherited
+     * `_addChildFromBuilder` would have put it, on top of the title bar.
+     */
+    _addChildFromBuilder(_name: string, view: View): void;
     /** Remove a previously-added page from the body. */
     remove(view: View): void;
     /**
@@ -38,7 +45,7 @@ export declare class AdwPreferencesDialog extends GridLayout {
     close(): void;
     /** Whether the dialog is currently shown. */
     get open(): boolean;
-    set open(value: boolean);
+    set open(value: boolean | string);
     /** The scrollable body that hosts the preferences pages. */
     get body(): StackLayout;
 }

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

@@ -1,4 +1,5 @@
-import { GridLayout, Label, StackLayout, View } from '@nativescript/core';
+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 {
     /** The header box: labels on the leading edge, suffix on the trailing one. */
@@ -45,6 +46,17 @@ export declare class AdwPreferencesGroup extends StackLayout implements NsSearch
      */
     get headerSuffix(): View | null;
     set headerSuffix(view: View | null);
+    /**
+     * XML inflation — a template's children are ROWS, not stray layout children.
+     *
+     * `<AdwPreferencesGroup.headerSuffix>` reaches the suffix host; everything
+     * else goes into the boxed list, which is where a row has to be to get the
+     * card, the rounded ends and the separators. Without this the `StackLayout`
+     * default appended each row NEXT TO the listbox: measured on Android, the
+     * rows rendered — unboxed, on the page background, with no `.boxed-list`
+     * 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. */

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

@@ -1,4 +1,5 @@
-import { ScrollView, StackLayout, View } from '@nativescript/core';
+import type { View } from '@nativescript/core';
+import { ScrollView, StackLayout } from '@nativescript/core';
 import type { NsSearchableGroup, NsSearchablePage } from './preferences-search.js';
 export declare class AdwPreferencesPage extends ScrollView implements NsSearchablePage {
     /** The vertical stack that actually holds the groups. */
@@ -26,11 +27,17 @@ export declare class AdwPreferencesPage extends ScrollView implements NsSearchab
      * a search-result subtitle strips before showing it (:196-199).
      */
     get useUnderline(): boolean;
-    set useUnderline(value: boolean);
+    set useUnderline(value: boolean | string);
     /** Append a preferences group (or any view) to the page. */
     addGroup(view: View): void;
     /** Remove a previously-added group from the page. */
     removeGroup(view: View): void;
+    /**
+     * An XML child is a GROUP. `ScrollView`'s inherited `_addChildFromBuilder` sets
+     * `content`, which would REPLACE the page's own scroll body — one group in place
+     * of all of them, and no error.
+     */
+    _addChildFromBuilder(_name: string, view: View): void;
     /**
      * The groups this page contributes to a preferences search, in order.
      *

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

@@ -51,7 +51,7 @@ export declare class AdwSidebar extends ScrollView {
      * selection rather than being ignored (adw-sidebar.c:3028-3029).
      */
     get selected(): number;
-    set selected(value: number);
+    set selected(raw: number | string);
     /** The selected item, or undefined — `adw_sidebar_get_selected_item`. */
     get selectedItem(): AdwSidebarItemSpec | undefined;
     /**

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

@@ -29,16 +29,16 @@ export declare class AdwSliderRow extends StackLayout {
     set title(value: string);
     /** The current numeric value (always within `[min, max]`, snapped to `step`). */
     get value(): number;
-    set value(v: number);
+    set value(raw: number | string);
     /** Lower bound. Re-clamps the current value if it now falls below. */
     get min(): number;
-    set min(v: number);
+    set min(raw: number | string);
     /** Upper bound. Re-clamps the current value if it now falls above. */
     get max(): number;
-    set max(v: number);
+    set max(raw: number | string);
     /** Snap granularity applied as the slider is dragged. */
     get step(): number;
-    set step(v: number);
+    set step(raw: number | string);
     /** The underlying {@link Slider} (e.g. to tweak styling). */
     get slider(): Slider;
 }

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

@@ -23,14 +23,14 @@ export declare class AdwSpinRow extends AdwActionRow {
     constructor();
     /** The current numeric value (always within `[min, max]`). */
     get value(): number;
-    set value(v: number);
+    set value(v: number | string);
     /** Lower bound. Re-clamps the current value if it now falls below. */
     get min(): number;
-    set min(v: number);
+    set min(v: number | string);
     /** Upper bound. Re-clamps the current value if it now falls above. */
     get max(): number;
-    set max(v: number);
+    set max(v: number | string);
     /** Increment/decrement step applied per button press. */
     get step(): number;
-    set step(v: number);
+    set step(v: number | string);
 }

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

@@ -13,7 +13,7 @@ export declare class AdwSpinner extends GridLayout {
     private _applySpinning;
     /** Whether the spinner is animating. Gated on being mapped, as in GTK. */
     get spinning(): boolean;
-    set spinning(value: boolean);
+    set spinning(value: boolean | string);
     /**
      * The BOX size in DIPs — what was requested, floored at the measured
      * minimum 16 and NOT capped.
@@ -24,7 +24,7 @@ export declare class AdwSpinner extends GridLayout {
      * silently took 64 DIPs of layout instead of the 200 it was given.
      */
     get size(): number;
-    set size(value: number);
+    set size(value: number | string);
     /** The drawn ring diameter — `spinnerGeometry`, capped at 64. */
     get ringDiameter(): number;
 }

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

@@ -28,7 +28,16 @@ export declare class AdwSplitButton extends GridLayout {
     private readonly _state;
     /** Which of the two action views is currently parented. */
     private _showingIcon;
-    private _disabled;
+    /**
+     * `GtkWidget:sensitive`, in GTK's polarity and no other.
+     *
+     * The field was `_disabled` while the property was, and the rename INVERTED the
+     * property. Keeping the old polarity inside would have left every reader holding
+     * two of them, one negation apart, in a class where a forgotten `!` dims a live
+     * button and emits nothing — silently, because NativeScript has no insensitive
+     * state to contradict it. One polarity, so there is nothing to forget.
+     */
+    private _sensitive;
     constructor();
     /**
      * Present the dropdown menu and dispatch the choice BY POSITION.
@@ -53,8 +62,8 @@ export declare class AdwSplitButton extends GridLayout {
      * The SVG string IS the icon identity here, so it is what the state machine
      * stores as the icon name; NS resolves no icon theme.
      */
-    get actionIcon(): string;
-    set actionIcon(svg: string);
+    get iconName(): string;
+    set iconName(svg: string);
     /** The dropdown menu entries (opened as a native `action()` sheet on arrow tap). */
     get menu(): readonly AdwMenuEntry[];
     set menu(value: readonly (string | AdwMenuEntry)[]);
@@ -70,10 +79,17 @@ export declare class AdwSplitButton extends GridLayout {
     set dropdownTooltip(value: string);
     /** Whether an underline in the label marks a mnemonic. */
     get useUnderline(): boolean;
-    set useUnderline(value: boolean);
-    /** Whether the control is insensitive: dimmed, and emitting neither signal. */
-    get disabled(): boolean;
-    set disabled(value: boolean);
+    set useUnderline(raw: boolean | string);
+    /**
+     * Whether the control is sensitive — `GtkWidget:sensitive`, so `false` is the
+     * insensitive state: dimmed, and emitting neither signal.
+     *
+     * The port spelled this `disabled` until ADR 0034 clause 1. Converging the name
+     * INVERTS it, which is why the ledger recorded the pair rather than renaming
+     * quietly: a `sensitive` that still meant `disabled` is worse than either name.
+     */
+    get sensitive(): boolean;
+    set sensitive(raw: boolean | string);
     /** The main action part (for composing a custom content widget). */
     get actionButton(): StackLayout;
 }