@gjsify/adwaita-nativescript 0.51.1 → 0.53.0

package/lib/types/widgets/gtk-action-bar.d.ts

@@ -0,0 +1,53 @@
+import type { View } from '@nativescript/core';
+import { GridLayout, StackLayout } from '@nativescript/core';
+import { type ConstructProps } from './construct-props.js';
+declare const GtkActionBar_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 GtkActionBar extends GtkActionBar_base {
+    /** The names this widget's `_addChildFromBuilder` honours — see `./builder-slots.ts`. */
+    static readonly builderSlots: readonly string[];
+    private readonly _startBox;
+    private readonly _endBox;
+    private _centerWidget;
+    private _revealed;
+    constructor(props?: ConstructProps<GtkActionBar>);
+    /** Pack a widget from the start — `gtk_action_bar_pack_start`, an append. */
+    pack_start(view: View): void;
+    /** Pack a widget from the end — `gtk_action_bar_pack_end`, a PREPEND. */
+    pack_end(view: View): void;
+    /** `gtk_action_bar_set_center_widget` — replaces the previous centre; `null` clears it. */
+    set_center_widget(view: View | null): void;
+    /** The centre widget, or `null`. */
+    get centerWidget(): View | null;
+    /** The start box — what {@link pack_start} appends to. */
+    get startBox(): StackLayout;
+    /** The end box — what {@link pack_end} prepends to. */
+    get endBox(): StackLayout;
+    /** XML inflation — route a template's child through the packing API. */
+    _addChildFromBuilder(name: string, view: View): void;
+    /** `GtkActionBar:revealed` — whether the bar shows its contents. Default `true`. */
+    get revealed(): boolean;
+    set revealed(raw: boolean | string);
+}
+export {};

package/lib/types/widgets/gtk-box.d.ts

@@ -5,6 +5,18 @@ export { DEFAULT_BOX_SPACING };
 declare const GtkBox_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/gtk-button.d.ts

@@ -7,6 +7,18 @@ export declare const GTK_BUTTON_LABEL_CLASS = "adw-button-label";
 declare const GtkButton_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;
@@ -16,6 +28,13 @@ declare const GtkButton_base: (abstract new (...args: any[]) => {
     get(name: string): unknown;
 }) & typeof GridLayout;
 export declare class GtkButton extends GtkButton_base {
+    /**
+     * The names this widget's `_addChildFromBuilder` honours — see `./builder-slots.ts`.
+     * `Gtk.Button:child` is the property a `.blp` writes as `child: Adw.ButtonContent { … }`,
+     * which projects as `slot: 'child'`. Undeclared, the shared-tree builder refused that
+     * placement, so the gallery's button-content `.blp` did not build here at all.
+     */
+    static readonly builderSlots: readonly string[];
     private _styleClasses;
     private _label;
     private _iconName;
@@ -39,6 +58,14 @@ export declare class GtkButton extends GtkButton_base {
      */
     get iconName(): string;
     set iconName(value: string);
+    /**
+     * `GtkWidget:tooltip-text`. A phone has no hover, so there is no tooltip to show; GTK
+     * also hands the text to assistive technology as the widget's description, and that
+     * half has a home here: `accessibilityHint`. An icon-only button is where a `.blp`
+     * writes one, and the builder refused the whole tree for want of this door.
+     */
+    get tooltipText(): string;
+    set tooltipText(value: string);
     /**
      * `Gtk.Button:child` — any view, which is how a button wraps an `Adw.ButtonContent`.
      *

package/lib/types/widgets/gtk-drop-down.d.ts

@@ -1,4 +1,4 @@
-import { Label, StackLayout, type EventData } from '@nativescript/core';
+import { Label, StackLayout, type EventData, type View } from '@nativescript/core';
 import type { AdwComboOption, AdwListModelInput } from '@gjsify/adwaita-core';
 import { GtkImage } from './gtk-image.js';
 import { type ConstructProps } from './construct-props.js';
@@ -16,6 +16,18 @@ export interface NotifyDropDownSelectedEventData extends EventData {
 declare const GtkDropDown_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;
@@ -25,6 +37,11 @@ declare const GtkDropDown_base: (abstract new (...args: any[]) => {
     get(name: string): unknown;
 }) & typeof StackLayout;
 export declare class GtkDropDown extends GtkDropDown_base {
+    /**
+     * `model` only: `model: Gtk.StringList { strings [ … ] }` in a `.blp` places the list at
+     * the property it sets (ADR 0072). `GtkDropDown` takes no child widget in GTK.
+     */
+    static readonly builderSlots: readonly string[];
     /** The button label — the selected option. */
     protected readonly _label: Label;
     /** The down-chevron — a real Adwaita `pan-down-symbolic` icon. */
@@ -39,6 +56,11 @@ export declare class GtkDropDown extends GtkDropDown_base {
     /** The list model (`Gtk.DropDown:model`). Updates the button label. */
     get model(): AdwComboOption[];
     set model(value: AdwListModelInput);
+    /**
+     * XML inflation: a child at `model` is the list, written through the property's setter.
+     * Anything else is refused, as GTK refuses a child widget on a `GtkDropDown`.
+     */
+    _addChildFromBuilder(name: string, child: View): void;
     /** The selected option index (`Gtk.DropDown:selected`). */
     get selected(): number;
     set selected(raw: number | string);

package/lib/types/widgets/gtk-entry.d.ts

@@ -14,6 +14,18 @@ export interface NotifyEntryTextEventData extends EventData {
 declare const GtkEntry_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/gtk-image.d.ts

@@ -14,6 +14,18 @@ export declare const DEFAULT_GTK_IMAGE_SIZE: number;
 declare const GtkImage_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/gtk-label.d.ts

@@ -1,8 +1,21 @@
 import { Label } from '@nativescript/core';
+import { type LabelEllipsizeMode } from '@gjsify/adwaita-core';
 import { type ConstructProps } from './construct-props.js';
 declare const GtkLabel_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,7 +28,10 @@ export declare class GtkLabel extends GtkLabel_base {
     private _label;
     private _useMarkup;
     private _useUnderline;
+    private _ellipsize;
+    private _lines;
     private _styleClasses;
+    private _xalign;
     constructor(props?: ConstructProps<GtkLabel>);
     /**
      * `Gtk.Label:label` — the text, as written, before markup and the mnemonic marker are
@@ -47,10 +63,40 @@ export declare class GtkLabel extends GtkLabel_base {
      * NativeScript's own name for it is `textWrap`, which stays reachable; this is the GIR
      * spelling over the same platform property, so a snippet ported off GJS runs verbatim.
      * `wrap-mode` and `natural-wrap-mode` are the declared gaps beside it — the platform
-     * wraps at word boundaries and offers no choice.
+     * wraps at word boundaries and offers no choice. Does NOT reapply {@link lines}:
+     * MEASURED (`@gjsify/adwaita-core`'s `label.ts` header), `wrap` plays no part in
+     * whether `lines` has an effect, only {@link ellipsize} does.
      */
     get wrap(): boolean;
     set wrap(raw: boolean | string);
+    /**
+     * `Gtk.Label:ellipsize` — where the string is trimmed when it does not fit. Defaults
+     * to `none`. Sets the platform's `textOverflow`, which only acts while {@link wrap} is
+     * off (Android's `adjustLineBreak()` — see the header). `start` and `middle` are HELD
+     * faithfully but DRAWN as an end-ellipsis: `labelEllipsizeOverflowValue`
+     * (`@gjsify/adwaita-core`) says why, the same declared divergence the web element pins.
+     */
+    get ellipsize(): LabelEllipsizeMode;
+    set ellipsize(raw: LabelEllipsizeMode | string);
+    /**
+     * `Gtk.Label:lines` — the line count an ellipsized label is held to. Defaults to -1
+     * ("unset"), which still caps at Pango's own default of ONE line the moment
+     * {@link ellipsize} is active — never "unlimited". Has no effect at all while
+     * ellipsize is `none`, `wrap` or not — {@link labelEffectiveLines}
+     * (`@gjsify/adwaita-core`) is that MEASURED guard, applied to the platform's
+     * `maxLines`, where any `value <= 0` already means unlimited (measured in
+     * `@nativescript/core`'s `index.android.js`).
+     */
+    get lines(): number;
+    set lines(raw: number | string);
+    private _applyLines;
+    /**
+     * `Gtk.Label:xalign` — where the text sits in the label's box, `0` the start and `1` the
+     * end. Clamped to that range as `gtk_label_set_xalign` clamps it, and painted only at the
+     * three points `textAlignment` can say exactly; any other value throws (see the header).
+     */
+    get xalign(): number;
+    set xalign(raw: number | string);
     /**
      * `GtkWidget:css-classes`, spelled `styleClasses` for the reason `style-classes.ts`
      * records: the platform owns `cssClasses` as a live `Set` and taking that name kills

package/lib/types/widgets/gtk-menu-button.d.ts

@@ -22,6 +22,9 @@ export declare class GtkMenuButton extends AdwImageButton {
     private _model;
     private _actions;
     private _menuTitle;
+    /** The image button's own classes, which every `styleClasses` write keeps. */
+    private readonly _baseClassName;
+    private _styleClasses;
     constructor(props?: ConstructProps<GtkMenuButton>);
     /**
      * The menu, normalised (ADR 0042) — opened as a native `action()` sheet on tap.
@@ -43,5 +46,24 @@ export declare class GtkMenuButton extends AdwImageButton {
     /** Optional title shown atop the native menu sheet. */
     get menuTitle(): string;
     set menuTitle(value: string);
+    /**
+     * `GtkWidget:css-classes`, spelled `styleClasses` for the reason `style-classes.ts`
+     * gives. A `.blp` header bar writes `styles ["flat"]` on its menu button, and the
+     * shared-tree builder refuses a style class the widget has no door for, so without it
+     * that header bar did not build here at all.
+     */
+    get styleClasses(): string[];
+    set styleClasses(value: string | null | undefined);
+    /** `gtk_widget_add_css_class`. A class the button 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 widget's own CSS name. */
+    get_css_classes(): string[];
+    /** `gtk_widget_set_css_classes` — REPLACES the list, as in C. */
+    set_css_classes(names: readonly string[]): void;
+    private _setClasses;
     private _openMenu;
 }

package/lib/types/widgets/id-reference.d.ts

@@ -0,0 +1,13 @@
+import type { View } from '@nativescript/core';
+/**
+ * The id of another view in the same tree, as an object-valued setter takes it from XML.
+ * A plain string at runtime; the NAME is the declaration `check-nativescript-xml-doors.mjs`
+ * reads, so a setter annotated `<Something> | ViewId` is held to resolving it through
+ * {@link resolveIdReference} rather than keeping the string.
+ */
+export type ViewId = string;
+/**
+ * The view with `id` in the tree `view` is mounted in, which must be an instance of `Type`,
+ * or throw naming the property and the id.
+ */
+export declare function resolveIdReference<T extends View>(view: View, property: string, id: string, Type: abstract new (...args: never[]) => T): T;

package/lib/types/widgets/index.d.ts

@@ -22,10 +22,11 @@ export { GtkButton, GTK_BUTTON_CLICKED, GTK_BUTTON_LABEL_CLASS } from './gtk-but
 export { buttonSlotAfterWrite, buttonSlotDetaches } from './button-slot.js';
 export type { ButtonSlot, ButtonSlotWrite } from './button-slot.js';
 export { GtkBox, DEFAULT_BOX_SPACING } from './gtk-box.js';
+export { GtkActionBar } from './gtk-action-bar.js';
 export { boxChildMargin, boxSpacingChanges, normalizeBoxSpacing } from './box-layout.js';
 export type { BoxOrientation } from './box-layout.js';
 export { GtkLabel } from './gtk-label.js';
-export { labelDisplayText, labelMarkupIsUnparseable } from './label-text.js';
+export { labelDisplayText, labelMarkupIsUnparseable } from '@gjsify/adwaita-core';
 export { AdwImageButton, DEFAULT_ICON_BUTTON_ICON_SIZE } from './adw-image-button.js';
 export { GtkMenuButton, MENU_ITEM_ACTIVATED } from './gtk-menu-button.js';
 export type { MenuItemActivatedEventData } from './gtk-menu-button.js';
@@ -50,7 +51,8 @@ export { AdwButtonContent } from './adw-button-content.js';
 export { AdwSplitButton, CLICKED, MENU_TAPPED } from './adw-split-button.js';
 export type { MenuTappedEventData } from './adw-split-button.js';
 export { AdwToggleGroup, NOTIFY_SELECTED as NOTIFY_TOGGLE_SELECTED, ToggleGroupState } from './adw-toggle-group.js';
-export type { NotifyToggleSelectedEventData, ToggleGroupStateChange, ToggleGroupStateListener, } from './adw-toggle-group.js';
+export { AdwToggle } from './adw-toggle.js';
+export type { AdwToggleSpec, NotifyToggleSelectedEventData, ToggleGroupStateChange, ToggleGroupStateListener, } from './adw-toggle-group.js';
 export { applyAdwaitaNsAccent, clearAdwaitaNsAccent } from './adw-accent.js';
 export { ADWAITA_NS_ACCENT_RULES, adwaitaNsAccentColor, adwaitaNsAccentCss } from './accent-theme.js';
 export type { AccentRole, AccentRule } from './accent-theme.js';
@@ -58,7 +60,8 @@ export { AdwShortcutLabel } from './adw-shortcut-label.js';
 export { SHORTCUT_LABEL_CAP_TEXT_CLASS, SHORTCUT_LABEL_CLASS, SHORTCUT_LABEL_DIMMED_CLASS, SHORTCUT_LABEL_DISABLED_CLASS, SHORTCUT_LABEL_KEYCAP_CLASS, SHORTCUT_LABEL_KEYS_CLASS, SHORTCUT_LABEL_SIDE_CLASS, SHORTCUT_LABEL_SPACED_CLASS, shortcutLabelDirection, shortcutLabelPlatform, shortcutLabelRenderPlan, } from './shortcut-label.js';
 export type { ShortcutLabelRenderPlan, ShortcutLabelViewSpec } from './shortcut-label.js';
 export { AdwViewStack, NOTIFY_VISIBLE_CHILD } from './adw-view-stack.js';
-export type { AdwViewStackPage, NotifyVisibleChildEventData } from './adw-view-stack.js';
+export type { AdwViewStackPageInfo, NotifyVisibleChildEventData } from './adw-view-stack.js';
+export { AdwViewStackPage } from './view-stack-page.js';
 export { AdwViewSwitcherBase, NOTIFY_SELECTED as NOTIFY_VIEW_SELECTED } from './view-switcher-base.js';
 export type { AdwViewPage, NotifyViewSelectedEventData } from './view-switcher-base.js';
 export { AdwViewSwitcher } from './adw-view-switcher.js';
@@ -67,11 +70,17 @@ export { AdwInlineViewSwitcher } from './adw-inline-view-switcher.js';
 export { AdwTabView, CLOSE_PAGE, NOTIFY_SELECTED_PAGE, PAGES_CHANGED } from './adw-tab-view.js';
 export type { ClosePageEventData, NotifySelectedPageEventData, PagesChangedEventData } from './adw-tab-view.js';
 export { applyTabViewVisibility, createTabViewState, tabBarVisibility, tabCloseVisibilities, tabLabelText, tabPageVisibilities, tabTooltipText, tabViewNotifyPayload, } from './tab-view-state.js';
-export type { AdwTabPage, NsVisibility, TabViewNotifyPayload } from './tab-view-state.js';
+export type { NsTabPage, NsVisibility, TabViewNotifyPayload } from './tab-view-state.js';
+export { AdwTabPage } from '../values/tab-page.js';
+export type { AdwTabPageProps } from '../values/tab-page.js';
 export { AdwCarousel, DEFAULT_CAROUSEL_PAGE_WIDTH, NOTIFY_N_PAGES, NOTIFY_POSITION, PAGE_CHANGED, } from './adw-carousel.js';
 export type { NotifyPositionEventData, PageChangedEventData } from './adw-carousel.js';
-export { CarouselScrollSync, applyCarouselDots, carouselDotClasses, carouselNotifyPayload, carouselPositionAtOffset, carouselScrollOffset, createCarouselState, normalizeCarouselPageWidth, } from './carousel-state.js';
+export { AdwCarouselIndicatorDots } from './adw-carousel-indicator-dots.js';
+export { AdwCarouselIndicatorLines } from './adw-carousel-indicator-lines.js';
+export { CarouselScrollSync, applyMarkerClasses, carouselDotClasses, indicatorMarkerClasses, carouselNotifyPayload, carouselPositionAtOffset, carouselScrollOffset, createCarouselState, normalizeCarouselPageWidth, } from './carousel-state.js';
 export type { CarouselNotifyPayload, NsCarouselStateOptions } from './carousel-state.js';
+export { AdwNavigationPage } from './adw-navigation-page.js';
+export type { NavigationPageOwner } from './adw-navigation-page.js';
 export { AdwNavigationView, NOTIFY_VISIBLE_PAGE } from './adw-navigation-view.js';
 export type { NotifyVisiblePageEventData } from './adw-navigation-view.js';
 export { AdwSplitViewBase, NOTIFY_SHOW_SIDEBAR } from './split-view-base.js';
@@ -82,6 +91,8 @@ export { NsNavigationSplitViewState, NsOverlaySplitViewState, splitViewColumns }
 export type { NsShowSidebarNotification, NsSplitViewHost, NsSplitViewState } from './split-view-state.js';
 export { AdwSidebar, NOTIFY_SELECTED as NOTIFY_SIDEBAR_SELECTED } from './adw-sidebar.js';
 export type { NotifySidebarSelectedEventData } from './adw-sidebar.js';
+export { AdwSidebarItem, AdwSidebarSection } from '../values/sidebar.js';
+export type { AdwSidebarItemProps, AdwSidebarSectionProps } from '../values/sidebar.js';
 export { AdwBottomSheet, CLOSE_ATTEMPT, NOTIFY_OPEN, SHEET_CLOSE } from './adw-bottom-sheet.js';
 export type { NotifyOpenEventData } from './adw-bottom-sheet.js';
 export { AdwToast, AdwToastOverlay, AdwToastQueue, DEFAULT_TOAST_TIMEOUT, TOAST_BUTTON_CLICKED, } from './adw-toast-overlay.js';

package/lib/types/widgets/signals.d.ts

@@ -21,7 +21,8 @@ export interface GObjectSignals {
  */
 export type ObservableConstructor = abstract new (...args: any[]) => Observable;
 /**
- * Give a `@nativescript/core` base GJS's `connect` / `disconnect`.
+ * Give a `@nativescript/core` base GJS's `connect` / `disconnect`, and `GtkWidget`'s layout
+ * properties with them ({@link withGtkWidgetLayout}).
  *
  * Applied ONCE per class that extends a platform base — `extends withSignals(GridLayout)`
  * — and never on a class whose base is already a widget of this package, which inherits
@@ -30,6 +31,18 @@ export type ObservableConstructor = abstract new (...args: any[]) => Observable;
 export declare function withSignals<TBase extends ObservableConstructor>(Base: TBase): (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/split-view-base.d.ts

@@ -13,6 +13,18 @@ export interface NotifyShowSidebarEventData extends EventData {
 declare const AdwSplitViewBase_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;
@@ -26,6 +38,8 @@ export declare abstract class AdwSplitViewBase<TState extends NsSplitViewState =
     protected readonly _widthRule: SplitViewWidthRule;
     /** The headless state machine this widget renders (`split-view-state.ts`). */
     protected readonly _state: TState;
+    /** The names this widget's `_addChildFromBuilder` honours — see `./builder-slots.ts`. */
+    static readonly builderSlots: readonly string[];
     protected _sidebar: View | null;
     protected _content: View | null;
     /** The three width PROPERTIES; the drawn width is derived from them. */
@@ -141,9 +155,19 @@ export declare abstract class AdwSplitViewBase<TState extends NsSplitViewState =
     /** `Adw.OverlaySplitView:sidebar-position` — `'start'` (leading) or `'end'`. */
     get sidebarPosition(): AdwPackType;
     set sidebarPosition(value: AdwPackType);
-    /** The sidebar pane, or `null`. */
+    /**
+     * The sidebar pane, or `null` — `Adw.NavigationSplitView:sidebar` /
+     * `Adw.OverlaySplitView:sidebar`.
+     *
+     * The SETTER is what lets a construct-props bag carry the pane, so a caller ported
+     * off GJS writes the one `new Adw.OverlaySplitView({ sidebar, content })` the GIR
+     * takes instead of three statements. It is {@link set_sidebar} under the property
+     * spelling the counterpart declares, never a second code path.
+     */
     get sidebar(): View | null;
-    /** The content pane, or `null`. */
+    set sidebar(view: View | null);
+    /** The content pane, or `null` — the `content` property of both split views. */
     get content(): View | null;
+    set content(view: View | null);
 }
 export {};

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

@@ -2,7 +2,7 @@ import type { View } from '@nativescript/core';
 import { TabViewState } from '@gjsify/adwaita-core';
 import type { AdwTabPageState, TabViewHandlers, TabViewSelectionChange } from '@gjsify/adwaita-core';
 /** One page of an `AdwTabView`, as a renderer reads it. */
-export type AdwTabPage = AdwTabPageState<View>;
+export type NsTabPage = AdwTabPageState<View>;
 /** The two `View.visibility` values a stacked page or a tab affordance ever takes. */
 export type NsVisibility = 'visible' | 'collapse';
 /** The model an `AdwTabView` delegates to, typed on the NS `View`. */
@@ -32,14 +32,14 @@ export declare function tabBarVisibility(state: TabViewState<View>, autohide: bo
  * Everything else shows its title, which the model has already coerced to `''` for a
  * page that declared none.
  */
-export declare function tabLabelText(page: AdwTabPage): string;
+export declare function tabLabelText(page: NsTabPage): string;
 /**
  * The tooltip text for a tab — the page's own tooltip when it has one, its title
  * otherwise. NS has no tooltip primitive, so this is exposed for a consumer (and the
  * accessibility label) rather than rendered, and in TEXT form: a page-supplied tooltip
  * is Pango markup in C and NS has no markup sink.
  */
-export declare function tabTooltipText(page: AdwTabPage): string;
+export declare function tabTooltipText(page: NsTabPage): string;
 /** The data half of the `notify::selected-page` event (minus NS's `eventName`/`object`). */
 export interface TabViewNotifyPayload {
     /** Id of the newly-selected page, `null` when the view is empty. */

package/lib/types/widgets/view-stack-page.d.ts

@@ -0,0 +1,98 @@
+import { Observable, type View } from '@nativescript/core';
+import { type ConstructProps } from './construct-props.js';
+/** The one stack call a record needs once adopted — `AdwViewStack.setPageVisible`. */
+interface AdoptingStack {
+    setPageVisible(name: string, visible: boolean): boolean;
+}
+/** A stack this record was handed to before it had a child — see {@link AdwViewStackPage._awaitChild}. */
+interface AwaitingStack {
+    _addChildFromBuilder(name: string, view: AdwViewStackPage): void;
+}
+declare const AdwViewStackPage_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 AdwViewStackPage extends AdwViewStackPage_base {
+    /** `child:` in a `.blp` — the page itself. The fallback too: a bare child IS the page. */
+    static readonly builderSlots: readonly string[];
+    private _child;
+    private _name;
+    private _title;
+    private _iconName;
+    private _needsAttention;
+    private _badgeNumber;
+    private _visible;
+    private _useUnderline;
+    /** The stack that adopted this record, or `null` while it is still being authored. */
+    private _stack;
+    /** The stack waiting for this record's child, while it has none. */
+    private _awaiting;
+    constructor(props?: ConstructProps<AdwViewStackPage>);
+    /** `AdwViewStackPage:child` — the view the stack shows for this page. */
+    get child(): View | null;
+    set child(view: View | null);
+    /** `AdwViewStackPage:name` — what `visible-child-name` and a bound switcher select by. */
+    get name(): string;
+    set name(value: string | null);
+    /** `AdwViewStackPage:title` — `null` until written; the stack falls back to the name. */
+    get title(): string | null;
+    set title(value: string | null);
+    /** `AdwViewStackPage:icon-name`. */
+    get iconName(): string | null;
+    set iconName(value: string | null);
+    /** `AdwViewStackPage:needs-attention` — the dot a switcher draws beside the title. */
+    get needsAttention(): boolean;
+    set needsAttention(raw: boolean | string);
+    /** `AdwViewStackPage:badge-number` — `0` shows no badge. */
+    get badgeNumber(): number;
+    set badgeNumber(raw: number | string);
+    /** `AdwViewStackPage:use-underline` — whether an `_` in the title marks a mnemonic. */
+    get useUnderline(): boolean;
+    set useUnderline(raw: boolean | string);
+    /**
+     * `AdwViewStackPage:visible` — whether the page can be selected at all. The one property
+     * that still reaches the stack after adoption, because the stack has a door for it.
+     */
+    get visible(): boolean;
+    set visible(raw: boolean | string);
+    /**
+     * An XML child is the page's `child` — there is nothing else a record holds, which is why
+     * the slot and the fallback are one name.
+     */
+    _addChildFromBuilder(_name: string, view: View): void;
+    /**
+     * Called by the stack that takes this record. Not API: the stack is the only caller, and
+     * a record adopted twice is refused, since two stacks cannot show one child.
+     */
+    _adoptBy(stack: AdoptingStack): void;
+    /**
+     * Called by a stack handed this record while it has no child yet. NativeScript's XML
+     * builder hands a child to its parent at the child's START tag, so a template's
+     * `<adw:ViewStackPage>` reaches the stack before its own `<adw:ViewStackPage.child>` has
+     * been read — where GtkBuilder adds the page once it is whole. The stack takes the record
+     * when the child arrives, which is still before the next page's start tag, so the pages
+     * keep document order.
+     */
+    _awaitChild(stack: AwaitingStack): void;
+    private _refuseAfterAdoption;
+}
+export {};

package/lib/types/widgets/view-stack-state.d.ts

@@ -1,8 +1,12 @@
 import type { View } from '@nativescript/core';
 import { ViewStackState } from '@gjsify/adwaita-core';
-import type { AdwViewStackPageInfo, ViewStackStateChange } from '@gjsify/adwaita-core';
-/** One page registered with an `AdwViewStack`, as a bound switcher reads it. */
-export type AdwViewStackPage = AdwViewStackPageInfo<View>;
+import type { AdwViewStackPageInfo as CorePageInfo, ViewStackStateChange } from '@gjsify/adwaita-core';
+/**
+ * One page registered with an `AdwViewStack`, as a bound switcher reads it — the stack's
+ * resolved descriptor. `AdwViewStackPage` is the class a stack is AUTHORED with
+ * (`adw-view-stack-page.ts`); this is what the stack keeps after reading one.
+ */
+export type AdwViewStackPageInfo = CorePageInfo<View>;
 /** The two `View.visibility` values a stacked page ever takes. */
 export type NsPageVisibility = 'visible' | 'collapse';
 /** The selection machine an `AdwViewStack` delegates to, typed on the NS `View`. */