@gjsify/adwaita-nativescript 0.47.0 → 0.49.0

package/lib/types/index.d.ts

@@ -1,7 +1,8 @@
 export { assertNativeScript, isNativeScript, isAndroid, isIOS } from '@gjsify/native-platform';
-export { AdwPreferencesPage, AdwPreferencesGroup, AdwActionRow, AdwSwitchRow, NOTIFY_ACTIVE, AdwEntryRow, NOTIFY_TEXT, AdwPasswordEntryRow, GtkEntry, ENTRY_ACTIVATE, NOTIFY_ENTRY_TEXT, AdwComboRow, ComboState, NOTIFY_SELECTED, GtkDropDown, NOTIFY_DROP_DOWN_SELECTED, AdwSpinRow, SpinState, NOTIFY_VALUE, AdwSliderRow, NOTIFY_SLIDER_VALUE, AdwExpanderRow, ExpanderState, NOTIFY_EXPANDED, GtkButton, AdwImageButton, DEFAULT_ICON_BUTTON_ICON_SIZE, GtkMenuButton, MENU_ITEM_ACTIVATED, AdwIcon, DEFAULT_ADW_ICON_SIZE, AdwBanner, BUTTON_CLICKED, AdwAvatar, DEFAULT_AVATAR_SIZE, avatarInitials, AdwWindowTitle, AdwClamp, DEFAULT_CLAMP_MAX_SIZE, AdwHeaderBar, AdwToolbarView, AdwWrapBox, AdwDataGrid, ROW_ACTIVATED, dataGridCellClass, dataGridItemSpec, dataGridRowClass, dataGridShapeKey, dataGridTracksKey, parseDataGridWidth, DATA_GRID_HEADER_CELL_CLASS, DATA_GRID_HEADER_ROW_CLASS, DATA_GRID_SECTION_CELL_CLASS, AdwSpinner, DEFAULT_SPINNER_SIZE, AdwStatusPage, AdwButtonRow, ACTIVATED, AdwButtonContent, AdwSplitButton, CLICKED, MENU_TAPPED, AdwToggleGroup, ToggleGroupState, NOTIFY_TOGGLE_SELECTED, applyAdwaitaNsAccent, clearAdwaitaNsAccent, ADWAITA_NS_ACCENT_RULES, adwaitaNsAccentColor, adwaitaNsAccentCss, AdwShortcutLabel, 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, AdwViewStack, NOTIFY_VISIBLE_CHILD, AdwViewSwitcherBase, NOTIFY_VIEW_SELECTED, AdwViewSwitcher, AdwViewSwitcherBar, AdwInlineViewSwitcher, AdwTabView, AdwCarousel, DEFAULT_CAROUSEL_PAGE_WIDTH, NOTIFY_POSITION, AdwNavigationView, NOTIFY_VISIBLE_PAGE, AdwSplitViewBase, NOTIFY_SHOW_SIDEBAR, AdwNavigationSplitView, AdwOverlaySplitView, NsNavigationSplitViewState, NsOverlaySplitViewState, splitViewColumns, AdwSidebar, NOTIFY_SIDEBAR_SELECTED, AdwBottomSheet, NOTIFY_OPEN, AdwToast, AdwToastOverlay, AdwToastQueue, DEFAULT_TOAST_TIMEOUT, TOAST_BUTTON_CLICKED, AdwAlertDialog, AdwAlertResponses, NOTIFY_RESPONSE, AdwAboutDialog, ABOUT_CLOSED, AdwPreferencesDialog, PREFERENCES_CLOSED, attachRowPressFeedback, renderSymbolicIcon, extractIconPaths, extractPathData, ADWAITA_ICON_GRID, DEFAULT_ICON_COLOR, DEFAULT_ICON_COLOR_DARK, adwaitaColorScheme, isThemeIconColor, onAdwaitaColorSchemeChanged, setAdwaitaColorScheme, themeIconColor, toggleAdwaitaColorScheme, AdwBreakpoint, addBreakpoints, evaluateBreakpointCondition, parseBreakpointCondition, registerAdwaitaElements, } from './widgets/index.js';
-export type { NotifyActiveEventData, NotifyTextEventData, NotifyEntryTextEventData, AdwComboOption, ComboStateChange, ComboStateListener, NotifySelectedEventData, NotifyDropDownSelectedEventData, NotifyValueEventData, SpinStateChange, SpinStateListener, NotifySliderValueEventData, NotifyExpandedEventData, ExpanderStateListener, AdwButtonVariant, AdwMenuItem, MenuItemActivatedEventData, MenuTappedEventData, RowActivatedEventData, DataGridItemSpec, NotifyToggleSelectedEventData, ToggleGroupStateChange, ToggleGroupStateListener, AccentRole, AccentRule, ShortcutLabelRenderPlan, ShortcutLabelViewSpec, AdwViewStackPage, NotifyVisibleChildEventData, AdwViewPage, NotifyViewSelectedEventData, NotifyPositionEventData, NotifyVisiblePageEventData, NotifyShowSidebarEventData, NsShowSidebarNotification, NsSplitViewHost, NsSplitViewState, NotifySidebarSelectedEventData, NotifyOpenEventData, AdwToastOptions, AdwToastQueueHandlers, AdwToastQueueOptions, ToastScheduler, ToastTimerHandle, NotifyResponseEventData, AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, OrderedConfirmResponses, SymbolicIconOptions, IconPath, AdwColorScheme, AdwBreakpointHandlers, BreakpointBound, BreakpointConditionGroup, BreakpointConditionLeaf, BreakpointConditionNode, BreakpointDimension, BreakpointSize, } from './widgets/index.js';
-export { Adw, Gtk } from './namespace.js';
+export { NOTIFY_ACTIVE, NOTIFY_TEXT, ENTRY_ACTIVATE, NOTIFY_ENTRY_TEXT, ComboState, NOTIFY_SELECTED, NOTIFY_DROP_DOWN_SELECTED, SpinState, NOTIFY_VALUE, AdwSliderRow, NOTIFY_SLIDER_VALUE, ExpanderState, NOTIFY_EXPANDED, AdwImageButton, DEFAULT_ICON_BUTTON_ICON_SIZE, MENU_ITEM_ACTIVATED, DEFAULT_GTK_IMAGE_SIZE, DEFAULT_BOX_SPACING, GTK_BUTTON_CLICKED, GTK_BUTTON_LABEL_CLASS, buttonSlotAfterWrite, buttonSlotDetaches, boxChildMargin, boxSpacingChanges, normalizeBoxSpacing, labelDisplayText, labelMarkupIsUnparseable, BUTTON_CLICKED, AVATAR_DEFAULT_ICON, DEFAULT_AVATAR_SIZE, avatarInitials, DEFAULT_CLAMP_MAX_SIZE, AdwDataGrid, ROW_ACTIVATED, dataGridCellClass, dataGridItemSpec, dataGridRowClass, dataGridShapeKey, dataGridTracksKey, parseDataGridWidth, DATA_GRID_HEADER_CELL_CLASS, DATA_GRID_HEADER_ROW_CLASS, DATA_GRID_SECTION_CELL_CLASS, DEFAULT_SPINNER_SIZE, ACTIVATED, CLICKED, MENU_TAPPED, ToggleGroupState, NOTIFY_TOGGLE_SELECTED, applyAdwaitaNsAccent, clearAdwaitaNsAccent, ADWAITA_NS_ACCENT_RULES, adwaitaNsAccentColor, adwaitaNsAccentCss, 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, NOTIFY_VISIBLE_CHILD, AdwViewSwitcherBase, NOTIFY_VIEW_SELECTED, DEFAULT_CAROUSEL_PAGE_WIDTH, NOTIFY_POSITION, NOTIFY_VISIBLE_PAGE, AdwSplitViewBase, NOTIFY_SHOW_SIDEBAR, NsNavigationSplitViewState, NsOverlaySplitViewState, splitViewColumns, NOTIFY_SIDEBAR_SELECTED, NOTIFY_OPEN, AdwToast, AdwToastQueue, DEFAULT_TOAST_TIMEOUT, TOAST_BUTTON_CLICKED, AdwAlertResponses, NOTIFY_RESPONSE, ABOUT_CLOSED, PREFERENCES_CLOSED, applyConstructProps, nsAlignment, GTK_ALIGN, attachRowPressFeedback, ICON_FALLBACK_NAME, compiledIconNames, iconValueKind, isIconAvailable, registerIcon, registeredIconNames, resolveIconSource, unregisterIcon, renderSymbolicIcon, extractIconPaths, extractPathData, ADWAITA_ICON_GRID, DEFAULT_ICON_COLOR, DEFAULT_ICON_COLOR_DARK, adwaitaColorScheme, isThemeIconColor, onAdwaitaColorSchemeChanged, setAdwaitaColorScheme, themeIconColor, toggleAdwaitaColorScheme, AdwBreakpoint, addBreakpoints, evaluateBreakpointCondition, parseBreakpointCondition, registerAdwaitaElements, } from './widgets/index.js';
+export type { BoxOrientation, ButtonSlot, ButtonSlotWrite, NotifyActiveEventData, NotifyTextEventData, NotifyEntryTextEventData, AdwComboOption, ComboStateChange, ComboStateListener, NotifySelectedEventData, NotifyDropDownSelectedEventData, NotifyValueEventData, SpinStateChange, SpinStateListener, NotifySliderValueEventData, NotifyExpandedEventData, ExpanderStateListener, MenuItemActivatedEventData, MenuSheetPresenter, MenuSheetRow, MenuTappedEventData, RowActivatedEventData, DataGridItemSpec, NotifyToggleSelectedEventData, ToggleGroupStateChange, ToggleGroupStateListener, AccentRole, AccentRule, ShortcutLabelRenderPlan, ShortcutLabelViewSpec, AdwViewStackPage, NotifyVisibleChildEventData, AdwViewPage, NotifyViewSelectedEventData, NotifyPositionEventData, NotifyVisiblePageEventData, NotifyShowSidebarEventData, NsShowSidebarNotification, NsSplitViewHost, NsSplitViewState, NotifySidebarSelectedEventData, NotifyOpenEventData, AdwToastOptions, AdwToastQueueHandlers, AdwToastQueueOptions, ToastScheduler, ToastTimerHandle, NotifyResponseEventData, AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, OrderedConfirmResponses, ConstructProps, IconValueKind, SymbolicIconOptions, IconPath, AdwColorScheme, AdwBreakpointHandlers, BreakpointBound, BreakpointConditionGroup, BreakpointConditionLeaf, BreakpointConditionNode, BreakpointDimension, BreakpointSize, } from './widgets/index.js';
+export * as Adw from './namespace/adw.js';
+export * as Gtk from './namespace/gtk.js';
 export { ADWAITA_SANS_FONT_FAMILY, ADWAITA_SANS_TTF_FILES, adwaitaFontInstallInstructions, hasAdwaitaSans, } from './fonts.js';
 /**
  * One-call convenience setup for the Adwaita NativeScript layer.

package/lib/types/label-text.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/namespace/adw.d.ts

@@ -0,0 +1,38 @@
+export { AdwAboutDialog as AboutDialog } from '../widgets/adw-about-dialog.js';
+export { AdwActionRow as ActionRow } from '../widgets/adw-action-row.js';
+export { AdwAlertDialog as AlertDialog } from '../widgets/adw-alert-dialog.js';
+export { AdwAvatar as Avatar } from '../widgets/adw-avatar.js';
+export { AdwBanner as Banner } from '../widgets/adw-banner.js';
+export { AdwBottomSheet as BottomSheet } from '../widgets/adw-bottom-sheet.js';
+export { AdwButtonContent as ButtonContent } from '../widgets/adw-button-content.js';
+export { AdwButtonRow as ButtonRow } from '../widgets/adw-button-row.js';
+export { AdwCarousel as Carousel } from '../widgets/adw-carousel.js';
+export { AdwClamp as Clamp } from '../widgets/adw-clamp.js';
+export { AdwComboRow as ComboRow } from '../widgets/adw-combo-row.js';
+export { AdwEntryRow as EntryRow } from '../widgets/adw-entry-row.js';
+export { AdwExpanderRow as ExpanderRow } from '../widgets/adw-expander-row.js';
+export { AdwHeaderBar as HeaderBar } from '../widgets/adw-header-bar.js';
+export { AdwInlineViewSwitcher as InlineViewSwitcher } from '../widgets/adw-inline-view-switcher.js';
+export { AdwNavigationSplitView as NavigationSplitView } from '../widgets/adw-navigation-split-view.js';
+export { AdwNavigationView as NavigationView } from '../widgets/adw-navigation-view.js';
+export { AdwOverlaySplitView as OverlaySplitView } from '../widgets/adw-overlay-split-view.js';
+export { AdwPasswordEntryRow as PasswordEntryRow } from '../widgets/adw-password-entry-row.js';
+export { AdwPreferencesDialog as PreferencesDialog } from '../widgets/adw-preferences-dialog.js';
+export { AdwPreferencesGroup as PreferencesGroup } from '../widgets/adw-preferences-group.js';
+export { AdwPreferencesPage as PreferencesPage } from '../widgets/adw-preferences-page.js';
+export { AdwShortcutLabel as ShortcutLabel } from '../widgets/adw-shortcut-label.js';
+export { AdwSidebar as Sidebar } from '../widgets/adw-sidebar.js';
+export { AdwSpinRow as SpinRow } from '../widgets/adw-spin-row.js';
+export { AdwSpinner as Spinner } from '../widgets/adw-spinner.js';
+export { AdwSplitButton as SplitButton } from '../widgets/adw-split-button.js';
+export { AdwStatusPage as StatusPage } from '../widgets/adw-status-page.js';
+export { AdwSwitchRow as SwitchRow } from '../widgets/adw-switch-row.js';
+export { AdwTabView as TabView } from '../widgets/adw-tab-view.js';
+export { AdwToastOverlay as ToastOverlay } from '../widgets/adw-toast-overlay.js';
+export { AdwToggleGroup as ToggleGroup } from '../widgets/adw-toggle-group.js';
+export { AdwToolbarView as ToolbarView } from '../widgets/adw-toolbar-view.js';
+export { AdwViewStack as ViewStack } from '../widgets/adw-view-stack.js';
+export { AdwViewSwitcher as ViewSwitcher } from '../widgets/adw-view-switcher.js';
+export { AdwViewSwitcherBar as ViewSwitcherBar } from '../widgets/adw-view-switcher-bar.js';
+export { AdwWindowTitle as WindowTitle } from '../widgets/adw-window-title.js';
+export { AdwWrapBox as WrapBox } from '../widgets/adw-wrap-box.js';

package/lib/types/namespace/gtk.d.ts

@@ -0,0 +1,7 @@
+export { GtkBox as Box } from '../widgets/gtk-box.js';
+export { GtkButton as Button } from '../widgets/gtk-button.js';
+export { GtkDropDown as DropDown } from '../widgets/gtk-drop-down.js';
+export { GtkEntry as Entry } from '../widgets/gtk-entry.js';
+export { GtkImage as Image } from '../widgets/gtk-image.js';
+export { GtkLabel as Label } from '../widgets/gtk-label.js';
+export { GtkMenuButton as MenuButton } from '../widgets/gtk-menu-button.js';

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

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/style-classes.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

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

@@ -1,7 +1,19 @@
-import { GridLayout, Label, StackLayout } from '@nativescript/core';
+import { GridLayout, Label, StackLayout, type EventData } from '@nativescript/core';
+import { type ConstructProps } from './construct-props.js';
 /** Event name emitted when the dialog is closed. */
 export declare const CLOSED = "closed";
-export declare class AdwAboutDialog extends GridLayout {
+declare const AdwAboutDialog_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
+    notify<T extends EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & typeof GridLayout;
+export declare class AdwAboutDialog extends AdwAboutDialog_base {
     protected readonly _card: StackLayout;
     protected readonly _iconLabel: Label;
     protected readonly _nameLabel: Label;
@@ -17,7 +29,7 @@ export declare class AdwAboutDialog extends GridLayout {
     private _comments;
     private _website;
     private _copyright;
-    constructor();
+    constructor(props?: ConstructProps<AdwAboutDialog>);
     private _addCardLabel;
     /** The application name (bold, centered). */
     get applicationName(): string;
@@ -66,3 +78,4 @@ export declare class AdwAboutDialog extends GridLayout {
     get open(): boolean;
     set open(value: boolean | string);
 }
+export {};

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

@@ -1,9 +1,21 @@
 import type { View } from '@nativescript/core';
-import { GridLayout, StackLayout, Label } from '@nativescript/core';
+import { GridLayout, StackLayout, Label, type EventData } from '@nativescript/core';
 import { ActionRowState } from './row-state.js';
+import { type ConstructProps } from './construct-props.js';
 /** Event name emitted when the row is activated. Mirrors `Adw.ActionRow::activated`. */
 export declare const ACTIVATED = "activated";
-export declare class AdwActionRow extends GridLayout {
+declare const AdwActionRow_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
+    notify<T extends EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & typeof GridLayout;
+export declare class AdwActionRow extends AdwActionRow_base {
     /**
      * Whether libadwaita would answer `ADW_IS_ACTION_ROW` for this row, which decides
      * whether the preferences SEARCH consults its subtitle.
@@ -23,9 +35,17 @@ export declare class AdwActionRow extends GridLayout {
     protected readonly _rowState: ActionRowState<View>;
     private _prefix;
     private _suffix;
-    constructor();
-    /** Install a prefix widget in column 0. Replaces any previous one; `null` clears. */
-    setPrefix(view: View | null): void;
+    constructor(props?: ConstructProps<AdwActionRow>);
+    /**
+     * Install a prefix widget in column 0 — `adw_action_row_add_prefix`.
+     *
+     * ONE slot per edge on this port, where libadwaita keeps a box: a second call
+     * REPLACES the first. The verb converges (a widget goes in, on both sides) and the
+     * cardinality is the declared remainder — the method ledger in
+     * `scripts/check-vocabulary-alignment.mjs` compares names, and ADR 0034 § Amendment 14
+     * names this as the divergence a name cannot carry. `remove()` clears the slot.
+     */
+    add_prefix(view: View): void;
     get prefix(): View | null;
     /** The row title (column 1, top line). */
     get title(): string;
@@ -36,8 +56,15 @@ export declare class AdwActionRow extends GridLayout {
      */
     get subtitle(): string;
     set subtitle(value: string);
-    /** Install a suffix widget in column 2. Replaces any previous one; `null` clears. */
-    setSuffix(view: View | null): void;
+    /** Install a suffix widget in column 2 — `adw_action_row_add_suffix`. Same one-slot rule as {@link add_prefix}. */
+    add_suffix(view: View): void;
+    /**
+     * Remove a prefix or suffix previously added — `adw_action_row_remove`.
+     *
+     * A view in neither slot throws, where C logs a critical and returns: a silent
+     * no-op here is the failure the construct-props bag refuses one door over.
+     */
+    remove(view: View): void;
     get suffix(): View | null;
     /**
      * An XML child goes to a named edge, and a bare one to the SUFFIX.
@@ -48,9 +75,9 @@ export declare class AdwActionRow extends GridLayout {
      * `adw-row-suffix` class and no column, so it lands on top of the title.
      *
      * The subclasses inherit it, and that is deliberate but sharp-edged: a switch row
-     * builds its own `Switch` as the suffix in its constructor, and `setSuffix`
-     * REPLACES. An explicit `<AdwSwitchRow.suffix>` therefore takes the switch's
-     * place, which is what "set the suffix" has to mean.
+     * builds its own `Switch` as the suffix in its constructor, and `add_suffix` on this
+     * one-slot port REPLACES. An explicit `<adw:SwitchRow.suffix>` therefore takes the
+     * switch's place, which is what "the suffix" has to mean here.
      */
     _addChildFromBuilder(name: string, view: View): void;
     /** `Adw.ActionRow:activatable-widget` — the widget this row activates. */
@@ -92,3 +119,4 @@ export declare class AdwActionRow extends GridLayout {
     /** Push the derived label text + visibility onto the two `Label`s. */
     protected _applyLabels(): void;
 }
+export {};

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

@@ -1,6 +1,7 @@
 import { Observable, type EventData } from '@nativescript/core';
 import { AdwAlertResponses } from '@gjsify/adwaita-core';
 import type { AdwResponseAppearance, AdwResponseOptions } from '@gjsify/adwaita-core';
+import { type ConstructProps } from './construct-props.js';
 export { AdwAlertResponses } from '@gjsify/adwaita-core';
 export type { AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, OrderedConfirmResponses, } from '@gjsify/adwaita-core';
 /** Event name emitted when a response is chosen. Mirrors GObject `notify::response`. */
@@ -10,28 +11,44 @@ export interface NotifyResponseEventData extends EventData {
     /** The chosen response id. */
     response: string;
 }
-export declare class AdwAlertDialog extends Observable {
+declare const AdwAlertDialog_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
+    notify<T extends EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & typeof Observable;
+export declare class AdwAlertDialog extends AdwAlertDialog_base {
     /** The headless response registry + ordering + resolution (ADR 0004). */
     private readonly _responses;
-    constructor(heading?: string, body?: string);
+    constructor(heading?: string, body?: string, props?: ConstructProps<AdwAlertDialog>);
     /** The dialog heading (title). */
     get heading(): string;
     set heading(value: string);
     /** The dialog body text. */
     get body(): string;
     set body(value: string);
-    /** Register a response button (`id` is what `present()` resolves to). */
-    addResponse(id: string, label: string, options?: AdwResponseOptions): void;
-    /** Register many responses at once (`id, label, id, label, …`). */
+    /** Register a response button — `adw_alert_dialog_add_response`; `id` is what `present()` resolves to. */
+    add_response(id: string, label: string, options?: AdwResponseOptions): void;
+    /**
+     * Register many responses at once (`id, label, id, label, …`).
+     *
+     * Keeps its own name: the C counterpart `adw_alert_dialog_add_responses` is varargs,
+     * which introspection skips, so no GJS caller has a spelling of it to converge on.
+     */
     addResponses(...idLabelPairs: string[]): void;
-    /** Set a registered response's visual emphasis (suggested/destructive). */
-    setResponseAppearance(id: string, appearance: AdwResponseAppearance): void;
-    /** A registered response's emphasis (`'default'` for an unknown id). */
-    getResponseAppearance(id: string): AdwResponseAppearance;
-    /** Enable/disable a registered response. */
-    setResponseEnabled(id: string, enabled: boolean): void;
-    /** Whether a registered response is enabled (`true` for an unknown id). */
-    getResponseEnabled(id: string): boolean;
+    /** Set a registered response's emphasis — `adw_alert_dialog_set_response_appearance`. */
+    set_response_appearance(id: string, appearance: AdwResponseAppearance): void;
+    /** A registered response's emphasis — `adw_alert_dialog_get_response_appearance`; `'default'` for an unknown id. */
+    get_response_appearance(id: string): AdwResponseAppearance;
+    /** Enable/disable a registered response — `adw_alert_dialog_set_response_enabled`. */
+    set_response_enabled(id: string, enabled: boolean): void;
+    /** Whether a registered response is enabled — `adw_alert_dialog_get_response_enabled`; `true` for an unknown id. */
+    get_response_enabled(id: string): boolean;
     /** The default (emphasised) response id, used as the OK button in `confirm()`. */
     get defaultResponse(): string | null;
     set defaultResponse(id: string | null);

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

@@ -1,20 +1,66 @@
 import { GridLayout, Label } from '@nativescript/core';
 import { avatarColor, avatarInitials } from './avatar-color.js';
+import { AVATAR_DEFAULT_ICON } from './avatar-view.js';
+import { GtkImage } from './gtk-image.js';
+import { type ConstructProps } from './construct-props.js';
 /** Default avatar diameter in DIPs (Adwaita's common avatar size). */
 export declare const DEFAULT_AVATAR_SIZE = 48;
 export { avatarColor, avatarInitials };
-export declare class AdwAvatar extends GridLayout {
+export { AVATAR_DEFAULT_ICON };
+declare const AdwAvatar_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
+    notify<T extends import("@nativescript/core").EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & typeof GridLayout;
+export declare class AdwAvatar extends AdwAvatar_base {
     /** The centered initials label. */
     protected readonly _label: Label;
+    /** The fallback symbolic icon, shown when the initials are not. */
+    protected readonly _icon: GtkImage;
     private _text;
     private _size;
-    constructor();
+    private _showInitials;
+    private _iconName;
+    constructor(props?: ConstructProps<AdwAvatar>);
     /** Sync the inline width/height/border-radius/font-size for the current size. */
     private _applySize;
-    /** The name the initials are derived from. */
+    /**
+     * Paint the per-name colour (`set_class_color`) onto the circle and both children.
+     *
+     * The glyph is PINNED to the palette's `fg` rather than left following the light/dark
+     * scheme: it sits on the accent fill in both, where a scheme-coloured symbolic would
+     * go near-black on light and vanish.
+     */
+    private _applyColor;
+    /** Show the child `update_visibility` says, and give the icon arm its glyph. */
+    private _applyMode;
+    /** The name the initials are derived from, and the colour is hashed from. */
     get text(): string;
     set text(value: string);
     /** The circular diameter in DIPs. Updates width/height/border-radius. */
     get size(): number;
     set size(value: number | string);
+    /**
+     * Whether the derived initials are shown instead of the fallback icon.
+     *
+     * `false` by default, as in the C — and a name alone does not switch it: both
+     * halves of `has_initials` must hold.
+     */
+    get showInitials(): boolean;
+    set showInitials(value: boolean | string);
+    /**
+     * The fallback icon: an Adwaita icon NAME (`'avatar-default-symbolic'`) or a
+     * symbolic SVG SOURCE string (e.g. `contactNewSymbolic`
+     * from `@gjsify/adwaita-icons`) — NOT an icon-theme name, because nothing on this
+     * runtime resolves one. Empty falls back to {@link AVATAR_DEFAULT_ICON}, the way an
+     * unset `icon-name` falls back to `adw-avatar-default-symbolic` under GTK.
+     */
+    get iconName(): string;
+    set iconName(value: string);
 }

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

@@ -1,15 +1,27 @@
-import { Button, GridLayout, Label } from '@nativescript/core';
+import { Button, GridLayout, Label, type EventData } from '@nativescript/core';
 import type { AdwBannerButtonStyle } from '@gjsify/adwaita-core';
+import { type ConstructProps } from './construct-props.js';
 /** Event name emitted when the banner's action button is tapped. */
 export declare const BUTTON_CLICKED = "buttonClicked";
-export declare class AdwBanner extends GridLayout {
+declare const AdwBanner_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
+    notify<T extends EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & typeof GridLayout;
+export declare class AdwBanner extends AdwBanner_base {
     /** The message label (column 0). */
     protected readonly _titleLabel: Label;
     /** The action button (column 1, only in the tree when a label is set). */
     protected readonly _button: Button;
     private _hasButton;
     private readonly _props;
-    constructor();
+    constructor(props?: ConstructProps<AdwBanner>);
     /** The banner message. Pango markup when {@link useMarkup}. */
     get title(): string;
     set title(value: string);
@@ -42,3 +54,4 @@ export declare class AdwBanner extends GridLayout {
     set revealed(value: boolean | string);
     private _renderTitle;
 }
+export {};

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

@@ -2,9 +2,21 @@ 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';
+import { type ConstructProps } from './construct-props.js';
 export { CLOSE_ATTEMPT, NOTIFY_OPEN, SHEET_CLOSE };
 export type { NotifyOpenEventData };
-export declare class AdwBottomSheet extends GridLayout {
+declare const AdwBottomSheet_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _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 AdwBottomSheet extends AdwBottomSheet_base {
     /** The always-visible content layer. */
     private _content;
     /** The bottom sheet panel wrapper (drag handle + sheet child). */
@@ -12,11 +24,11 @@ export declare class AdwBottomSheet extends GridLayout {
     private _sheetChild;
     /** The shared open/can-close model — the single source of truth for both. */
     private readonly _state;
-    constructor();
-    /** Set (or replace) the always-visible content layer (painted under the sheet). */
-    setContent(view: View | null): void;
-    /** Set (or replace) the sheet panel's child (shown when open). */
-    setSheet(view: View | null): void;
+    constructor(props?: ConstructProps<AdwBottomSheet>);
+    /** Set (or replace) the always-visible content layer (painted under the sheet) — `adw_bottom_sheet_set_content`. */
+    set_content(view: View | null): void;
+    /** Set (or replace) the sheet panel's child (shown when open) — `adw_bottom_sheet_set_sheet`. */
+    set_sheet(view: View | null): void;
     /**
      * An XML child asks for the sheet or for the content, and a bare one is CONTENT —
      * the always-visible layer, which is what a sheet with nothing behind it would be
@@ -28,23 +40,27 @@ export declare class AdwBottomSheet extends GridLayout {
     /**
      * The always-visible content layer, or `null`.
      *
-     * A read-back for `setContent`: a write-only pane cannot be asserted, and the XML
+     * A read-back for `set_content`: 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`. */
+    /** The sheet panel's child, or `null` — the read-back for `set_sheet`. */
     get sheet(): View | null;
-    /** Open the sheet programmatically. */
-    open(): void;
     /**
-     * Close the sheet programmatically. Like `AdwBottomSheet:open` this ignores
-     * `can-close`; a user-driven dismissal belongs in {@link requestClose}.
+     * Whether the sheet is open (`AdwBottomSheet:open`). Toggling shows/hides the panel
+     * and emits `notify::open`.
+     *
+     * Like the GTK property this ignores `can-close`; a user-driven dismissal belongs in
+     * {@link requestClose}.
+     *
+     * BREAKING: was `openState`, and `sheet.open = true` / `= false` replace the port's
+     * own `open()` / `close()` methods, which libadwaita has no counterpart for. Why the
+     * collision with them was not a reason to keep the divergent name is ADR 0034
+     * § Amendment 11.
      */
-    close(): void;
-    /** Whether the sheet is open. Toggling shows/hides the panel + emits `notify::open`. */
-    get openState(): boolean;
-    set openState(value: boolean | string);
+    get open(): boolean;
+    set open(value: boolean | string);
     /**
      * Whether the user may dismiss the sheet (`AdwBottomSheet:can-close`). When
      * off, a refused dismissal emits `close-attempt` instead of closing.

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

@@ -1,14 +1,26 @@
 import { Label, StackLayout, type View } from '@nativescript/core';
 import type { ButtonContentEllipsize } from '@gjsify/adwaita-core';
-import { AdwIcon } from './adw-icon.js';
-export declare class AdwButtonContent extends StackLayout {
+import { GtkImage } from './gtk-image.js';
+import { type ConstructProps } from './construct-props.js';
+declare const AdwButtonContent_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
+    notify<T extends import("@nativescript/core").EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & typeof StackLayout;
+export declare class AdwButtonContent extends AdwButtonContent_base {
     /** The leading symbolic icon. Always parented — the C never hides the image. */
-    protected readonly _icon: AdwIcon;
+    protected readonly _icon: GtkImage;
     /** The text label. */
     protected readonly _label: Label;
     private readonly _props;
     private _hostButton;
-    constructor();
+    constructor(props?: ConstructProps<AdwButtonContent>);
     /**
      * The button view this content styles — NS's stand-in for the `GtkButton`
      * ancestor `adw_button_content_root` finds (:108).
@@ -20,11 +32,12 @@ export declare class AdwButtonContent extends StackLayout {
     get hostButton(): View | null;
     set hostButton(view: View | null);
     /**
-     * A leading Adwaita symbolic SVG string (e.g. `folderDownloadSymbolic`).
+     * The leading icon — an Adwaita icon NAME (`'folder-download-symbolic'`) or a
+     * symbolic SVG SOURCE string (e.g. `folderDownloadSymbolic`).
      *
      * An empty value shows the `image-missing` asset rather than hiding the icon:
      * the C sets that fallback (:355-356) and never hides `self->icon`. The doc
-     * comments at :228/:343 say otherwise — see `buttonContentIconSvg`.
+     * comments at :228/:343 say otherwise — see `buttonContentIcon`.
      */
     get iconName(): string;
     set iconName(svg: string);
@@ -56,3 +69,4 @@ export declare class AdwButtonContent extends StackLayout {
     get ellipsize(): ButtonContentEllipsize;
     private _renderLabel;
 }
+export {};

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

@@ -1,6 +1,7 @@
 import { StackLayout } from '@nativescript/core';
 import { AdwActionRow } from './adw-action-row.js';
-import { AdwIcon } from './adw-icon.js';
+import { GtkImage } from './gtk-image.js';
+import { type ConstructProps } from './construct-props.js';
 /** Event name emitted when the row is tapped. Mirrors `Adw.ButtonRow::activated`. */
 export { ACTIVATED } from './adw-action-row.js';
 export declare class AdwButtonRow extends AdwActionRow {
@@ -10,9 +11,9 @@ export declare class AdwButtonRow extends AdwActionRow {
     /** The horizontal content box (leading icon + centered title + trailing icon). */
     protected readonly _contentBox: StackLayout;
     /** The leading symbolic icon. */
-    protected readonly _startIcon: AdwIcon;
+    protected readonly _startIcon: GtkImage;
     /** The trailing symbolic icon. */
-    protected readonly _endIcon: AdwIcon;
+    protected readonly _endIcon: GtkImage;
     /** An explicit icon fill (the destructive red), or `null` to follow the accent. */
     private _pinnedIconColor;
     /** Live accent subscription — held only while the row is on screen. */
@@ -26,18 +27,20 @@ export declare class AdwButtonRow extends AdwActionRow {
      * second state object would give one label two sources of truth.
      */
     private readonly _buttonState;
-    constructor();
+    constructor(props?: ConstructProps<AdwButtonRow>);
     /** A centered symbolic icon, collapsed until it has content. Its fill is set by
      *  {@link _applyIconColor}, which is also what follows an accent change. */
     private static _makeIcon;
     /**
-     * A leading Adwaita symbolic SVG string before the centered title (e.g.
+     * The leading icon before the centered title — an Adwaita icon NAME
+     * (`'list-add-symbolic'`) or a symbolic SVG SOURCE string (e.g.
      * `listAddSymbolic`). Empty collapses the icon.
      */
     get startIconName(): string;
     set startIconName(value: string);
     /**
-     * A trailing Adwaita symbolic SVG string after the centered title (e.g.
+     * The trailing icon after the centered title — an Adwaita icon NAME
+     * (`'go-next-symbolic'`) or a symbolic SVG SOURCE string (e.g.
      * `goNextSymbolic`) — `Adw.ButtonRow:end-icon-name`. Empty collapses it.
      */
     get endIconName(): string;
@@ -52,6 +55,6 @@ export declare class AdwButtonRow extends AdwActionRow {
     set startIconColor(value: string);
     /** Paint both icons in the pinned colour, or in the active accent's fill. */
     private _applyIconColor;
-    /** Push the derived icon payload + visibility onto the two `AdwIcon`s. */
+    /** Push the derived icon payload + visibility onto the two `GtkImage`s. */
     private _applyIcons;
 }

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

@@ -1,6 +1,7 @@
 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';
+import { type ConstructProps } from './construct-props.js';
 export { DEFAULT_CAROUSEL_PAGE_WIDTH };
 /** Event name emitted when {@link AdwCarousel.position} changes. Mirrors GObject `notify::position`. */
 export declare const NOTIFY_POSITION = "notify::position";
@@ -16,7 +17,18 @@ export interface PageChangedEventData extends EventData {
     /** The page the carousel came to rest on, `-1` when it has none. */
     index: number;
 }
-export declare class AdwCarousel extends GridLayout {
+declare const AdwCarousel_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
+    notify<T extends EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & typeof GridLayout;
+export declare class AdwCarousel extends AdwCarousel_base {
     /** The horizontal scroller holding the pages. */
     protected readonly _scroller: ScrollView;
     /** The horizontal track inside the scroller (holds fixed-width pages). */
@@ -31,9 +43,9 @@ export declare class AdwCarousel extends GridLayout {
     private readonly _dotsById;
     private _nextPageId;
     private _pageWidth;
-    constructor();
+    constructor(props?: ConstructProps<AdwCarousel>);
     /** Append a page — `adw_carousel_append` (adw-carousel.c:1348-1357). */
-    addPage(view: View): void;
+    append(view: View): void;
     /**
      * An XML child is a PAGE, appended in document order.
      *
@@ -47,11 +59,11 @@ export declare class AdwCarousel extends GridLayout {
      * 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.
      */
-    insertPage(view: View, position?: number): boolean;
+    insert(view: View, position?: number): boolean;
     /** Remove a page — `adw_carousel_remove` (adw-carousel.c:1508-1532). */
-    removePage(view: View): boolean;
+    remove(view: View): boolean;
     /** Move a page — `adw_carousel_reorder` (adw-carousel.c:1419-1499). */
-    reorderPage(view: View, position: number): boolean;
+    reorder(view: View, position: number): boolean;
     /**
      * Scroll to a page by index. Out-of-range, fractional and NaN indices are
      * refused rather than clamped, matching `adw_carousel_get_nth_page`'s
@@ -61,7 +73,7 @@ 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`. */
+    /** The pages on the track, in order — the read-back for `append`/`insert`. */
     get pages(): readonly View[];
     /** The number of pages. */
     get nPages(): number;