@gjsify/adwaita-nativescript 0.64.2 → 0.64.3-next.260

package/lib/types/index.d.ts

@@ -1,6 +1,6 @@
 export { assertNativeScript, isNativeScript, isAndroid, isIOS } from '@gjsify/native-platform';
 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, boxChildTrack, boxTrackPlan, boxSpacingChanges, normalizeBoxSpacing, NOTIFY_REVEAL_CHILD, ADW_DIALOG_CLOSED, ADW_DIALOG_CLOSE_ATTEMPT, LIST_BOX_ROW_ACTIVATED, LIST_BOX_ROW_SELECTED, NOTIFY_HEXPAND, NOTIFY_VEXPAND, withGtkWidgetLayout, NOTIFY_STACK_VISIBLE_CHILD, NOTIFY_STACK_VISIBLE_CHILD_NAME, DRAWING_AREA_REFUSAL, GTK_CHECK_BUTTON_TOGGLED, GTK_CHECK_BUTTON_ACTIVATE, GTK_CHECK_BUTTON_CHECKED_CLASS, GTK_CHECK_BUTTON_INCONSISTENT_CLASS, NOTIFY_CHECK_ACTIVE, GTK_WRAP_MODES, NOTIFY_TEXT_VIEW_TEXT, GTK_TOGGLE_BUTTON_CHECKED_CLASS, GTK_TOGGLE_BUTTON_TOGGLED, NOTIFY_TOGGLE_ACTIVE, labelDisplayText, labelMarkupIsUnparseable, BUTTON_CLICKED, AVATAR_DEFAULT_ICON, DEFAULT_AVATAR_SIZE, avatarInitials, DEFAULT_CLAMP_MAX_SIZE, padForSystemInsets, padSheetForSystemInsets, bottomSheetPanel, 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, AdwAlertResponses, ABOUT_CLOSED, PREFERENCES_CLOSED, applyConstructProps, nsAlignment, GTK_ALIGN, DEFAULT_ICON_PIXEL_SIZE, GTK_ICON_SIZE_NICKS, GTK_ICON_SIZE_PIXELS, type GtkIconSizeNick, isGtkIconSizeNick, PIXEL_SIZE_UNSET, activateWidgetAction, findActionGroup, insertActionGroup, attachRowPressFeedback, ICON_FALLBACK_NAME, compiledIconNames, iconValueKind, isIconAvailable, resolveIconSource, renderSymbolicIcon, extractIconPaths, extractPathData, ADWAITA_ICON_GRID, DEFAULT_ICON_COLOR, DEFAULT_ICON_COLOR_DARK, adwaitaColorScheme, isThemeIconColor, onAdwaitaColorSchemeChanged, setAdwaitaColorScheme, themeIconColor, toggleAdwaitaColorScheme, AdwBreakpoint, addBreakpoints, evaluateBreakpointCondition, observeViewSize, observeWindowSize, 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, MenuTappedEventData, RowActivatedEventData, DataGridItemSpec, NotifyToggleSelectedEventData, ToggleGroupStateChange, ToggleGroupStateListener, AccentRole, AccentRule, ShortcutLabelRenderPlan, ShortcutLabelViewSpec, AdwViewStackPageInfo, NotifyVisibleChildEventData, AdwViewPage, NotifyViewSelectedEventData, NotifyPositionEventData, NotifyVisiblePageEventData, NotifyShowSidebarEventData, NsShowSidebarNotification, NsSplitViewHost, NsSplitViewState, NotifySidebarSelectedEventData, NotifyOpenEventData, AdwToastOptions, AdwToastQueueHandlers, AdwToastQueueOptions, ToastScheduler, ToastTimerHandle, AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, OrderedConfirmResponses, ConstructProps, SystemInsetEdges, IconValueKind, SymbolicIconOptions, IconPath, AdwColorScheme, AdwBreakpointHandlers, BreakpointBound, BreakpointConditionGroup, BreakpointConditionLeaf, BreakpointConditionNode, BreakpointDimension, BreakpointSize, } from './widgets/index.js';
+export type { BoxOrientation, ButtonSlot, ButtonSlotWrite, NotifyTextEventData, NotifyEntryTextEventData, AdwComboOption, ComboStateChange, ComboStateListener, NotifySelectedEventData, NotifyDropDownSelectedEventData, NotifyValueEventData, SpinStateChange, SpinStateListener, NotifySliderValueEventData, NotifyExpandedEventData, ExpanderStateListener, MenuItemActivatedEventData, MenuTappedEventData, RowActivatedEventData, DataGridItemSpec, NotifyToggleSelectedEventData, ToggleGroupStateChange, ToggleGroupStateListener, AccentRole, AccentRule, ShortcutLabelRenderPlan, ShortcutLabelViewSpec, AdwViewStackPageInfo, NotifyVisibleChildEventData, AdwViewPage, NotifyViewSelectedEventData, NotifyPositionEventData, NotifyVisiblePageEventData, NotifyShowSidebarEventData, NsShowSidebarNotification, NsSplitViewHost, NsSplitViewState, NotifySidebarSelectedEventData, NotifyOpenEventData, AdwToastOptions, AdwToastQueueHandlers, AdwToastQueueOptions, ToastScheduler, ToastTimerHandle, AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, OrderedConfirmResponses, ConstructProps, SystemInsetEdges, IconValueKind, SymbolicIconOptions, IconPath, AdwColorScheme, AdwBreakpointHandlers, BreakpointBound, BreakpointConditionGroup, BreakpointConditionLeaf, BreakpointConditionNode, BreakpointDimension, BreakpointSize, } from './widgets/index.js';
 export type { GtkWidgetLayout, GtkWidgetLayoutMembers } from './widgets/widget-layout.js';
 export * as Adw from './namespace/adw.js';
 export * as Gtk from './namespace/gtk.js';

package/lib/types/language-host.d.ts

@@ -0,0 +1,3 @@
+/** @internal A seam for the specs: `null` restores the platform's own. */
+export declare function useLanguageHost(host: (() => string[]) | null): void;
+export declare function hostLanguageTags(): string[];

package/lib/types/language-source.android.d.ts

@@ -0,0 +1 @@
+export declare function platformLanguageTags(): string[];

package/lib/types/language-source.d.ts

@@ -0,0 +1 @@
+export declare function platformLanguageTags(): string[];

package/lib/types/language-source.ios.d.ts

@@ -0,0 +1 @@
+export declare function platformLanguageTags(): string[];

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

@@ -49,5 +49,5 @@ export { AdwWindow as Window } from '../widgets/adw-window.js';
 export { AdwWindowTitle as WindowTitle } from '../widgets/adw-window-title.js';
 export { AdwWrapBox as WrapBox } from '../widgets/adw-wrap-box.js';
 export { AdwApplication as Application } from '../widgets/application.js';
-export { AdwStyleManager as StyleManager } from '../widgets/style-manager.js';
+export { AdwStyleManager as StyleManager } from '../widgets/style-manager-host.js';
 export { ColorScheme, Toast, ToastPriority } from '@gjsify/adwaita-core';

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

@@ -1,5 +1,5 @@
-export { GLibBytes as Bytes, GLibError as Error } from '@gjsify/adwaita-core';
-import { buildFilenamev, getCurrentDir, getSystemDataDirs, uriEscapeString } from '@gjsify/adwaita-core';
+export { GLibBytes as Bytes, GLibError as Error, GLibVariant as Variant } from '@gjsify/adwaita-core';
+import { buildFilenamev, getCurrentDir, getSystemDataDirs, unicharIsalpha, uriEscapeString } from '@gjsify/adwaita-core';
 export declare const PRIORITY_HIGH: number;
 export declare const PRIORITY_DEFAULT: number;
 export declare const PRIORITY_HIGH_IDLE: number;
@@ -14,4 +14,6 @@ export declare const MAXUINT32 = 4294967295;
 export declare const build_filenamev: typeof buildFilenamev;
 export declare const get_current_dir: typeof getCurrentDir;
 export declare const get_system_data_dirs: typeof getSystemDataDirs;
+export declare const get_language_names: () => string[];
 export declare const uri_escape_string: typeof uriEscapeString;
+export declare const unichar_isalpha: typeof unicharIsalpha;

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

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

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

@@ -1,2 +1,26 @@
+import type { EventData } from '@nativescript/core';
+/**
+ * The event half of `Observable`, as `ns-core.d.ts` declares it: enough for the mixin
+ * to subscribe, unsubscribe and be notified, and nothing the mixin does not touch.
+ *
+ * Exported for `signals-gobject.spec.ts`, which drives the same mixin with a declaration
+ * attached and needs the same platform boundary under it. One stand-in, so the two legs of
+ * the seam are measured against one base rather than against two that can drift.
+ */
+export declare class ObservableShape {
+    private readonly _listeners;
+    _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;
+    on(eventName: string, callback: (data: EventData) => void, thisArg?: unknown): void;
+    once(eventName: string, callback: (data: EventData) => void, thisArg?: unknown): void;
+    off(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;
+    /** How many listeners `eventName` has — what the mixin's bookkeeping is measured against. */
+    listenerCount(eventName: string): number;
+}
 declare const _default: () => Promise<void>;
 export default _default;

package/lib/types/spinner-properties.spec.d.ts

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

package/lib/types/switch-row-properties.spec.d.ts

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

package/lib/types/testing/ns-core.d.mts

@@ -259,6 +259,8 @@ export declare class GridLayout extends LayoutBase {
     addColumn(itemSpec: ItemSpec): void;
     addRow(itemSpec: ItemSpec): void;
     removeRow(itemSpec: ItemSpec): void;
+    /** `GridLayoutBase.getColumns` — a copy, as on a device. */
+    getColumns(): ItemSpec[];
     removeColumns(): void;
     removeRows(): void;
     /** Where a child was placed — the read-back the `set*` statics have on a device. */
@@ -440,6 +442,10 @@ export declare const Application: {
     }): void;
     on(event: string, callback: (args: unknown) => void): void;
     off(event: string, callback: (args: unknown) => void): void;
+    /** The double has no configuration to read, so it cannot tell — until a spec says otherwise. */
+    systemAppearance(): "dark" | "light" | null;
+    /** Change the system's appearance and deliver `systemAppearanceChanged`, as the platform does. */
+    emitSystemAppearance(value: "dark" | "light"): void;
     /** Deliver a lifecycle event (`resume`, `suspend`) to its subscribers, as the platform does. */
     emitLifecycle(event: string): void;
     /** Absent, as on every platform that is not Android — and this is not Android. */

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

@@ -1,9 +1,14 @@
-import { GridLayout, Label, StackLayout, type EventData } from '@nativescript/core';
+import { Button, GridLayout, Label, StackLayout, type EventData } from '@nativescript/core';
+import { GtkImage } from './gtk-image.js';
 import { type ConstructProps } from './construct-props.js';
 import type { View } from '@nativescript/core';
 /** Event name emitted when the dialog is closed. */
 export declare const CLOSED = "closed";
+/** Event name emitted when a link is tapped, before it is opened. */
+export declare const ACTIVATE_LINK = "activate-link";
 declare const AdwAboutDialog_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -50,10 +55,12 @@ declare const AdwAboutDialog_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _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;
@@ -64,37 +71,62 @@ declare const AdwAboutDialog_base: ((abstract new (...args: any[]) => {
 export declare class AdwAboutDialog extends AdwAboutDialog_base {
     static readonly GTypeName: string;
     protected readonly _card: StackLayout;
-    protected readonly _iconLabel: Label;
+    protected readonly _appIcon: GtkImage;
     protected readonly _nameLabel: Label;
     protected readonly _versionLabel: Label;
     protected readonly _developerLabel: Label;
     protected readonly _commentsLabel: Label;
-    protected readonly _websiteLabel: Label;
-    protected readonly _copyrightLabel: Label;
+    protected readonly _websiteButton: Button;
+    protected readonly _supportButton: Button;
+    protected readonly _issueButton: Button;
+    protected readonly _creditsLabel: Label;
+    protected readonly _acknowledgementsLabel: Label;
+    protected readonly _legalLabel: Label;
     protected readonly _releaseNotesLabel: Label;
-    protected readonly _linksLabel: Label;
+    protected readonly _linksBox: StackLayout;
     protected readonly _debugInfoLabel: Label;
+    protected readonly _copyButton: Button;
     private _applicationName;
     private _applicationIcon;
     private _developerName;
     private _version;
     private _comments;
     private _website;
+    private _supportUrl;
+    private _issueUrl;
     private _copyright;
+    private _licenseState;
+    private _developers;
+    private _designers;
+    private _artists;
+    private _documenters;
+    private _translatorCredits;
     private _releaseNotes;
     private _releaseNotesVersion;
     private _debugInfo;
     private _links;
+    private _creditSections;
+    private _acknowledgementSections;
+    private _legalSections;
     /** The What's New buffer; `version` alone never rebuilds it. */
     private _releaseNotesSegments;
     /** The window `present (parent)` mounted this in, so closing can take it back out. */
     private _host;
     constructor(props?: ConstructProps<AdwAboutDialog>);
     private _addCardLabel;
+    /** A link row: tapping it activates whatever URI the render last gave it. */
+    private _addLinkButton;
+    /**
+     * `activate-link`: emit with GTK's handled accumulator, then launch unless a handler
+     * returned true. A URI the host cannot launch is dropped, as a failed launch is.
+     */
+    private _activateLink;
+    /** Point a link button at `uri`; the tap handler is replaced, never stacked. */
+    private _setLink;
     /** The application name (bold, centered). */
     get applicationName(): string;
     set applicationName(value: string);
-    /** A glyph standing in for the app icon (no icon-theme lookup in the NS subset). */
+    /** The icon name, drawn like any `Gtk.Image` icon name. */
     get applicationIcon(): string;
     set applicationIcon(value: string);
     /** The version string. */
@@ -106,12 +138,42 @@ export declare class AdwAboutDialog extends AdwAboutDialog_base {
     /** A short comments/description line. */
     get comments(): string;
     set comments(value: string);
-    /** The website URL (plain text — not a tappable link in this subset). */
+    /** The website URL, a link button. */
     get website(): string;
     set website(value: string);
-    /** The copyright line. */
+    /** The support-questions URL, a link button. */
+    get supportUrl(): string;
+    set supportUrl(value: string);
+    /** The issue-tracker URL, a link button. */
+    get issueUrl(): string;
+    set issueUrl(value: string);
+    /** The copyright line, the first part of the Legal text. */
     get copyright(): string;
     set copyright(value: string);
+    /** The custom licence text, `''` for a stock licence. */
+    get license(): string;
+    set license(value: string);
+    /**
+     * A `Gtk.License` value. A string from an XML attribute is an integer or a licence nick;
+     * anything outside `Gtk.License` is refused, as the C setter does.
+     */
+    get licenseType(): number;
+    set licenseType(value: number | string);
+    /** Names for the "Code by" credits; each line is `Name`, `Name <email>` or `Name https://url`. */
+    get developers(): string[];
+    set developers(value: string[]);
+    /** Names for the "Design by" credits. */
+    get designers(): string[];
+    set designers(value: string[]);
+    /** Names for the "Artwork by" credits. */
+    get artists(): string[];
+    set artists(value: string[]);
+    /** Names for the "Documentation by" credits. */
+    get documenters(): string[];
+    set documenters(value: string[]);
+    /** The translators, one per line; the untranslated gettext sentinel shows nothing. */
+    get translatorCredits(): string;
+    set translatorCredits(value: string);
     /** AppStream release-notes markup, shown as the What's New text. */
     get releaseNotes(): string;
     set releaseNotes(value: string);
@@ -123,11 +185,17 @@ export declare class AdwAboutDialog extends AdwAboutDialog_base {
     set debugInfo(value: string);
     /** `adw_about_dialog_add_link`: an extra link; `_` marks a mnemonic. */
     add_link(title: string, url: string): void;
+    /** `adw_about_dialog_add_credit_section`: a Credits block; `name` may be `null`. */
+    add_credit_section(name: string | null, people: string[]): void;
+    /** `adw_about_dialog_add_acknowledgement_section`: an Acknowledgements block. */
+    add_acknowledgement_section(name: string | null, people: string[]): void;
+    /** `adw_about_dialog_add_legal_section`: a Legal block. A `license_type` outside `Gtk.License` is refused. */
+    add_legal_section(title: string, copyright: string | null, license_type: number, license: string | null): void;
     /** `adw_about_dialog_new_from_appdata`, refused by name. */
     static new_from_appdata(_resourcePath: string, _releaseNotesVersion?: string | null): never;
     private _updateReleaseNotes;
     /**
-     * Push the ten strings onto their labels, and COLLAPSE the ones with nothing
+     * Push the card's strings onto their labels, and COLLAPSE the ones with nothing
      * to say.
      *
      * Every label used to be unconditionally visible, so an about dialog without a
@@ -137,13 +205,13 @@ export declare class AdwAboutDialog extends AdwAboutDialog_base {
      * Same input, two different dialogs, and nothing said so.
      *
      * The core's record covers a nineteen-part dialog; this port is a flat card, so
-     * it reads the parts it has. `copyright` is NOT one of them: upstream has no
-     * copyright LABEL, it derives the string into the Legal page this port does not
-     * build (`legalSectionVisible` takes it as a separate argument). It therefore
-     * keeps the same non-empty rule directly. The website row is the core's
-     * `websiteRow`, which is the flat-card equivalent here.
+     * it reads the parts it has. Upstream has no copyright label, it derives the string
+     * into the Legal page, so `copyright` reaches the card through `legalSections`. The
+     * website row is the core's `websiteRow`, which is the flat-card equivalent here.
      */
     private _render;
+    /** Copy Text: the debug info to the platform clipboard. A host without one keeps the text on screen. */
+    private _copyDebugInfo;
     /**
      * Reveal the about overlay — `adw_dialog_present`.
      *

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

@@ -2,9 +2,20 @@ import type { View } 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';
+import type { GObjectNotify } from './signals.js';
 /** Event name emitted when the row is activated. Mirrors `Adw.ActionRow::activated`. */
 export declare const ACTIVATED = "activated";
+/** Event name emitted when {@link AdwActionRow.title} changes. */
+export declare const NOTIFY_TITLE = "notify::title";
+/** Event name emitted when {@link AdwActionRow.subtitle} changes. */
+export declare const NOTIFY_SUBTITLE = "notify::subtitle";
+/** Event name emitted when {@link AdwActionRow.iconName} changes. */
+export declare const NOTIFY_ICON_NAME = "notify::icon-name";
+/** Event name emitted when {@link AdwActionRow.activatable} changes. */
+export declare const NOTIFY_ACTIVATABLE = "notify::activatable";
 declare const AdwActionRow_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -51,10 +62,12 @@ declare const AdwActionRow_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _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;
@@ -77,11 +90,33 @@ export declare class AdwActionRow extends AdwActionRow_base {
      * search behaves as GTK does.
      */
     readonly isActionRow: boolean;
+    /** The row title (column 1, top line). Empty collapses its label. */
+    title: string;
+    /**
+     * The row subtitle (column 1, dim second line). Empty collapses its label so it
+     * leaves no blank gap — `string_is_not_empty`, the rule the title follows too.
+     */
+    subtitle: string;
+    /**
+     * `AdwActionRow:icon-name` — an icon in the prefix slot, before the title.
+     *
+     * It TAKES that slot: setting it over a widget `add_prefix` put there replaces it, the same
+     * one-slot rule `add_prefix` applies to itself. The twin threw instead, which a declared
+     * property cannot (see the header).
+     */
+    iconName: string;
+    /** `GtkListBoxRow:activatable` — whether a tap activates this row at all. */
+    activatable: boolean;
+    /** `notify('title')` beside NativeScript's `notify({ eventName })` — see {@link GObjectNotify}. */
+    notify: GObjectNotify;
     /** The text/value column (column 1). */
     protected readonly _textStack: StackLayout;
     protected readonly _titleLabel: Label;
     protected readonly _subtitleLabel: Label;
-    /** The headless labels + activatable-widget coupling (ADR 0004). */
+    /**
+     * The activatable-widget ↔ sensitivity binding (ADR 0004). No longer the labels' store:
+     * `title` and `subtitle` are the declared properties', and their change detection with them.
+     */
     protected readonly _rowState: ActionRowState<View>;
     private _prefix;
     private _iconImage;
@@ -103,24 +138,12 @@ export declare class AdwActionRow extends AdwActionRow_base {
      * `<div class="adw-entry-row-prefixes">` both put it first. `adwaita-web`'s own slot
      * binding already records the rule ("`addPrefix` PREPENDS, mirroring `gtk_box_prepend`");
      * this is the third renderer joining it.
+     *
+     * An icon {@link AdwActionRow.iconName} put there is displaced like any other prefix, and
+     * clearing the property is part of that — see `remove()`.
      */
     add_prefix(view: View): void;
-    /**
-     * `AdwActionRow:icon-name` — an icon in the prefix slot, before the title. It takes that slot,
-     * so a row whose prefix was set with {@link add_prefix} refuses it rather than replace it.
-     */
-    get iconName(): string;
-    set iconName(value: string | null);
     get prefix(): View | null;
-    /** The row title (column 1, top line). */
-    get title(): string;
-    set title(value: string);
-    /**
-     * The row subtitle (column 1, dim second line). Empty collapses its label so it
-     * leaves no blank gap — `string_is_not_empty`, the rule the title follows too.
-     */
-    get subtitle(): string;
-    set subtitle(value: string);
     /** 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;
     /**
@@ -158,9 +181,6 @@ export declare class AdwActionRow extends AdwActionRow_base {
     set activatableWidget(widget: View | null);
     /** Re-read the activatable widget's sensitivity — the live half of the binding. */
     syncActivatableWidgetSensitivity(): void;
-    /** `GtkListBoxRow:activatable` — whether a tap activates this row at all. */
-    get activatable(): boolean;
-    set activatable(value: boolean | string);
     /**
      * `adw_action_row_activate`: forward to the activatable widget, then emit
      * `activated`. A no-op while unactivatable, because a tap on a non-activatable
@@ -183,5 +203,14 @@ export declare class AdwActionRow extends AdwActionRow_base {
     protected _managesTitleVisibility: boolean;
     /** Push the derived label text + visibility onto the two `Label`s. */
     protected _applyLabels(): void;
+    /**
+     * Put the named icon in the prefix slot, or take it out again — the render half of
+     * `icon-name`, run from `notify::icon-name`.
+     *
+     * Everything that can refuse happens BEFORE the write reaches here: an unparseable value is
+     * the seam's throw, and there is nothing left for this to reject (see the header on why it
+     * could not throw anyway). `remove()` is what clears the field on the way out.
+     */
+    private _applyIconName;
 }
 export {};

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

@@ -5,6 +5,8 @@ import { type ConstructProps } from './construct-props.js';
 export { AdwAlertResponses } from '@gjsify/adwaita-core';
 export type { AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, OrderedConfirmResponses, } from '@gjsify/adwaita-core';
 declare const AdwAlertDialog_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -51,10 +53,12 @@ declare const AdwAlertDialog_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _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;

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

@@ -8,6 +8,8 @@ export declare const DEFAULT_AVATAR_SIZE = 48;
 export { avatarColor, avatarInitials };
 export { AVATAR_DEFAULT_ICON };
 declare const AdwAvatar_base: ((abstract new (...args: any[]) => {
+    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;
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -54,10 +56,12 @@ declare const AdwAvatar_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _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;

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

@@ -4,6 +4,8 @@ import { type ConstructProps } from './construct-props.js';
 /** Event name emitted when the banner's action button is tapped. */
 export declare const BUTTON_CLICKED = "buttonClicked";
 declare const AdwBanner_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -50,10 +52,12 @@ declare const AdwBanner_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _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;

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

@@ -15,6 +15,8 @@ export declare const NOTIFY_MODAL = "notify::modal";
 export declare function bottomSheetPanel(sheet: AdwBottomSheet): View;
 export type { NotifyOpenEventData };
 declare const AdwBottomSheet_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -61,10 +63,12 @@ declare const AdwBottomSheet_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _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;

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

@@ -3,6 +3,8 @@ import type { ButtonContentEllipsize } from '@gjsify/adwaita-core';
 import { GtkImage } from './gtk-image.js';
 import { type ConstructProps } from './construct-props.js';
 declare const AdwButtonContent_base: ((abstract new (...args: any[]) => {
+    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;
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -49,10 +51,12 @@ declare const AdwButtonContent_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _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;

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

@@ -18,6 +18,8 @@ export interface PageChangedEventData extends EventData {
     index: number;
 }
 declare const AdwCarousel_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -64,10 +66,12 @@ declare const AdwCarousel_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _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;

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

@@ -4,6 +4,8 @@ import { DEFAULT_CLAMP_MAX_SIZE, DEFAULT_CLAMP_TIGHTENING_THRESHOLD } from './ch
 import { type ConstructProps } from './construct-props.js';
 export { DEFAULT_CLAMP_MAX_SIZE, DEFAULT_CLAMP_TIGHTENING_THRESHOLD };
 declare const AdwClamp_base: ((abstract new (...args: any[]) => {
+    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;
     connect(eventName: string, callback: (self: /*elided*/ any, data: import("@nativescript/core").EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -50,10 +52,12 @@ declare const AdwClamp_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _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;

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

@@ -10,6 +10,8 @@ export interface RowActivatedEventData extends EventData {
     row: AdwDataGridRow;
 }
 declare const AdwDataGrid_base: ((abstract new (...args: any[]) => {
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
@@ -56,10 +58,12 @@ declare const AdwDataGrid_base: ((abstract new (...args: any[]) => {
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
     get focusable(): boolean;
     set focusable(value: boolean | string);
+    get focusOnClick(): boolean;
+    set focusOnClick(value: boolean | string);
+    get_focus_on_click(): boolean;
+    set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _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;