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

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

@@ -5,6 +5,8 @@ import { type ConstructProps } from './construct-props.js';
 export { AdwToast, AdwToastQueue, DEFAULT_TOAST_TIMEOUT } from '@gjsify/adwaita-core';
 export type { AdwToastOptions, AdwToastQueueHandlers, AdwToastQueueOptions, ToastScheduler, ToastTimerHandle, } from '@gjsify/adwaita-core';
 declare const AdwToastOverlay_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;
@@ -51,10 +53,12 @@ declare const AdwToastOverlay_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-toggle-group.d.ts

@@ -22,6 +22,8 @@ export interface AdwToggleSpec {
     name?: string | null;
 }
 declare const AdwToggleGroup_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;
@@ -68,10 +70,12 @@ declare const AdwToggleGroup_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-toggle.d.ts

@@ -1,6 +1,8 @@
 import { Observable } from '@nativescript/core';
 import { type ConstructProps } from './construct-props.js';
 declare const AdwToggle_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;
@@ -47,10 +49,12 @@ declare const AdwToggle_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-toolbar-view.d.ts

@@ -4,6 +4,8 @@ import { type AdwToolbarStyle } from './chrome.js';
 import { type SystemBarEdges } from './system-bars.js';
 import { type ConstructProps } from './construct-props.js';
 declare const AdwToolbarView_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 AdwToolbarView_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-view-stack.d.ts

@@ -16,6 +16,8 @@ export declare const NOTIFY_VISIBLE_CHILD_NAME = "notify::visible-child-name";
 export interface NotifyVisibleChildEventData extends EventData, ViewStackNotifyPayload {
 }
 declare const AdwViewStack_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;
@@ -62,10 +64,12 @@ declare const AdwViewStack_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-view-switcher-bar.d.ts

@@ -3,6 +3,8 @@ import { AdwViewStack } from './adw-view-stack.js';
 import { type ViewId } from './id-reference.js';
 import { type ConstructProps } from './construct-props.js';
 declare const AdwViewSwitcherBar_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 AdwViewSwitcherBar_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-window-title.d.ts

@@ -1,11 +1,14 @@
-import { Label, StackLayout, type EventData } from '@nativescript/core';
+import { Label, StackLayout } from '@nativescript/core';
 import { type ConstructProps } from './construct-props.js';
+import type { GObjectNotify } from './signals.js';
 /** Event name emitted when {@link AdwWindowTitle.title} changes. */
 export declare const NOTIFY_TITLE = "notify::title";
 /** Event name emitted when {@link AdwWindowTitle.subtitle} changes. */
 export declare const NOTIFY_SUBTITLE = "notify::subtitle";
 declare const AdwWindowTitle_base: ((abstract new (...args: any[]) => {
-    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
+    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;
     get_property(name: string): unknown;
@@ -51,11 +54,13 @@ declare const AdwWindowTitle_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;
+    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;
@@ -64,6 +69,12 @@ declare const AdwWindowTitle_base: ((abstract new (...args: any[]) => {
 }) & typeof StackLayout;
 export declare class AdwWindowTitle extends AdwWindowTitle_base {
     static readonly GTypeName: string;
+    /** The window title (bold, top line). Empty collapses its label. */
+    title: string;
+    /** The subtitle (dim second line). Empty collapses its label. */
+    subtitle: string;
+    /** `notify('title')` beside NativeScript's `notify({ eventName })` — see {@link GObjectNotify}. */
+    notify: GObjectNotify;
     /** The bold title label. */
     protected readonly _titleLabel: Label;
     /** The dim subtitle label. */
@@ -71,14 +82,7 @@ export declare class AdwWindowTitle extends AdwWindowTitle_base {
     /** The headless title/subtitle pair + change detection (ADR 0004). */
     private readonly _state;
     constructor(props?: ConstructProps<AdwWindowTitle>);
-    /** The window title (bold, top line). Empty collapses its label. */
-    get title(): string;
-    set title(value: string);
-    /** The subtitle (dim second line). Empty collapses its label. */
-    get subtitle(): string;
-    set subtitle(value: string);
     /** Push the derived text + visibility onto the two `Label`s. */
     private _apply;
-    private _notify;
 }
 export {};

package/lib/types/widgets/adw-wrap-box.d.ts

@@ -4,6 +4,8 @@ import { type ConstructProps } from './construct-props.js';
 /** Every `notify::` an `Adw.WrapBox` emits (adw-wrap-box.c:284-497). */
 export type AdwWrapBoxProperty = 'child-spacing' | 'child-spacing-unit' | 'pack-direction' | 'align' | 'justify' | 'justify-last-line' | 'line-spacing' | 'line-spacing-unit' | 'line-homogeneous' | 'natural-line-length' | 'natural-line-length-unit' | 'wrap-reverse' | 'wrap-policy' | 'orientation';
 declare const AdwWrapBox_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 AdwWrapBox_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/carousel-indicator-base.d.ts

@@ -2,6 +2,8 @@ import { GridLayout, StackLayout } from '@nativescript/core';
 import { AdwCarousel } from './adw-carousel.js';
 import { type ViewId } from './id-reference.js';
 declare const AdwCarouselIndicatorBase_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;
@@ -48,10 +50,12 @@ declare const AdwCarouselIndicatorBase_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/gtk-action-bar.d.ts

@@ -2,6 +2,8 @@ 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[]) => {
+    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;
@@ -48,10 +50,12 @@ declare const GtkActionBar_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/gtk-button.d.ts

@@ -7,6 +7,8 @@ export declare const GTK_BUTTON_IMAGE_CLASS = "image-button";
 /** The class the button's own label carries, so the theme can give it Adwaita's type. */
 export declare const GTK_BUTTON_LABEL_CLASS = "adw-button-label";
 declare const GtkButton_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;
@@ -53,10 +55,12 @@ declare const GtkButton_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/gtk-check-button.d.ts

@@ -28,6 +28,8 @@ export declare class GtkCheckButton extends AdwStyledLayoutBase {
     private _child;
     /** A `group` written as an id before the button was in a loaded tree. */
     private _groupId;
+    /** The content column's unit, which {@link _syncContent} keeps. */
+    private _contentUnit;
     constructor(props?: ConstructProps<GtkCheckButton>);
     /** `Gtk.CheckButton:active` — whether the box is ticked. Defaults to `false`. */
     get active(): boolean;
@@ -57,7 +59,14 @@ export declare class GtkCheckButton extends AdwStyledLayoutBase {
     /** `gtk_check_button_set_active`. */
     set_active(active: boolean): void;
     _addChildFromBuilder(_name: string, view: View): void;
-    /** The text shows only while there is a label and no child widget replacing it. */
+    /**
+     * The text shows only while there is a label and no child widget replacing it.
+     *
+     * The content column is `star` only while it holds content. An empty `star` column still
+     * takes the whole width a parent offers at most, so a bare check button in an
+     * `Adw.WrapBox` (a flexbox, which measures `AT_MOST`) filled its line and the swatches of
+     * Learn6502's colour selectors stacked one per line.
+     */
     private _syncContent;
     protected get _ownClass(): string;
     protected _restyle(): void;

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

@@ -16,6 +16,8 @@ export interface NotifyDropDownSelectedEventData extends EventData {
     label: string;
 }
 declare const GtkDropDown_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;
@@ -62,10 +64,12 @@ declare const GtkDropDown_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/gtk-entry.d.ts

@@ -14,6 +14,8 @@ export interface NotifyEntryTextEventData extends EventData {
     textLength: number;
 }
 declare const GtkEntry_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;
@@ -60,10 +62,12 @@ declare const GtkEntry_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/gtk-image.d.ts

@@ -12,6 +12,8 @@ import { type ConstructProps } from './construct-props.js';
  */
 export declare const DEFAULT_GTK_IMAGE_SIZE: number;
 declare const GtkImage_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;
@@ -58,10 +60,12 @@ declare const GtkImage_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/gtk-label.d.ts

@@ -2,6 +2,8 @@ import { Label } from '@nativescript/core';
 import { type LabelEllipsizeMode, type LabelJustification } from '@gjsify/adwaita-core';
 import { type ConstructProps } from './construct-props.js';
 declare const GtkLabel_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;
@@ -48,10 +50,12 @@ declare const GtkLabel_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/gtk-popover-menu.d.ts

@@ -5,6 +5,8 @@ import { type ConstructProps } from './construct-props.js';
 /** `GtkPopover::closed`, emitted when the menu goes away. */
 export declare const CLOSED = "closed";
 declare const GtkPopoverMenu_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 GtkPopoverMenu_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/gtk-stack.d.ts

@@ -12,6 +12,8 @@ export declare const NOTIFY_STACK_VISIBLE_CHILD_NAME = "notify::visible-child-na
 export interface NotifyStackVisibleChildEventData extends EventData, ViewStackNotifyPayload {
 }
 declare const GtkStack_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;
@@ -58,10 +60,12 @@ declare const GtkStack_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/gtk-text-view.d.ts

@@ -14,6 +14,8 @@ export interface GtkTextBufferSubset {
     insert_at_cursor(text: string, len?: number): void;
 }
 declare const GtkTextView_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;
@@ -60,10 +62,12 @@ declare const GtkTextView_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/index.d.ts

@@ -2,7 +2,6 @@ export { AdwPreferencesPage } from './adw-preferences-page.js';
 export { AdwPreferencesGroup } from './adw-preferences-group.js';
 export { AdwActionRow } from './adw-action-row.js';
 export { AdwSwitchRow, NOTIFY_ACTIVE } from './adw-switch-row.js';
-export type { NotifyActiveEventData } from './adw-switch-row.js';
 export { AdwEntryRow, NOTIFY_TEXT } from './adw-entry-row.js';
 export type { NotifyTextEventData } from './adw-entry-row.js';
 export { AdwPasswordEntryRow } from './adw-password-entry-row.js';

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

@@ -1,4 +1,37 @@
 import type { EventData, Observable } from '@nativescript/core';
+import { type ForeignClassMeta, type ForeignProperty } from '@gjsify/adwaita-core';
+/**
+ * A declared property, plus the one thing the engine's vocabulary has no room for: how a value is
+ * brought into the property's shape BEFORE it is stored. The engine never sees `normalize`.
+ */
+export interface DeclaredProperty extends ForeignProperty {
+    /**
+     * Replaces the seam's own coercion for EVERY write, typed or not — a floor, a clamp, a lenient
+     * parse. Runs identically on both legs, ahead of the store and of the equal-write check, so a
+     * write the normalizer maps onto the held value is not a change.
+     */
+    readonly normalize?: (value: unknown) => unknown;
+}
+/** {@link ForeignClassMeta} whose properties may carry a {@link DeclaredProperty.normalize}. */
+export interface DeclaredClassMeta extends Omit<ForeignClassMeta, 'Properties'> {
+    readonly Properties?: Readonly<Record<string, DeclaredProperty>>;
+}
+/**
+ * `notify` on a class that DECLARES properties — GJS's `notify('<prop>')` beside NativeScript's
+ * `notify({ eventName })`, which is how both legs install it (node-gi routes on the argument's
+ * type, and the pure-JS leg imitates that).
+ *
+ * A migrated widget declares it the same way it declares its properties — `declare notify:
+ * GObjectNotify;` — rather than the mixin typing it for every class, because a class with no
+ * declaration HAS no property to name and the string form would be a type that lies about 39
+ * widgets. One line, beside the `declare` lines the migration already brings.
+ */
+export interface GObjectNotify {
+    /** `g_object_notify`: emit `notify::<propertyName>`. Throws on a name the class never declared. */
+    (propertyName: string): void;
+    /** NativeScript's own: dispatch `data` to the listeners of `data.eventName`. */
+    <T extends EventData>(data: T): void;
+}
 /** The two methods the mixin adds. Named so a consumer can annotate with it. */
 export interface GObjectSignals {
     /**
@@ -40,9 +73,14 @@ export type ObservableConstructor = abstract new (...args: any[]) => Observable;
  *
  * 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
- * the two methods and would otherwise carry a second, identical copy one prototype up.
+ * the two methods and would otherwise carry a second, identical copy one prototype up. Such a
+ * class adds properties with {@link withProperties} instead.
  */
-export declare function withSignals<TBase extends ObservableConstructor>(Base: TBase): ((abstract new (...args: any[]) => {
+export declare function withSignals<TBase extends ObservableConstructor>(Base: TBase, meta?: DeclaredClassMeta): ((abstract new (...args: any[]) => {
+    /** Refuses a declared member's name; see the header. Covers `on` and `once` with it. */
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    /** The other half of the refusal, and with it `off`. */
+    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;
@@ -89,7 +127,35 @@ export declare function withSignals<TBase extends ObservableConstructor>(Base: T
     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;
+    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;
+}) & {
+    /**
+     * What every widget emits; a class's own list adds to it (`emittedSignalsOf`). A
+     * declared property's `notify::` and a declared signal are emitted by the seam itself,
+     * so they belong here rather than in each migrated widget's own list.
+     */
+    readonly emittedSignals: readonly string[];
+}) & TBase;
+/**
+ * Declare properties and signals on a class whose base is ALREADY a widget of this package —
+ * `class AdwSwitchRow extends withProperties(AdwActionRow, { ... })`.
+ *
+ * The same declaration as {@link withSignals}'s second argument, and nothing else: `connect`,
+ * `disconnect`, `emit`, `notify` and `GtkWidget`'s layout properties come down from the base
+ * widget, and they already answer this class's declaration because they resolve the instance's
+ * whole chain (see the header). Under route D this is a GType over the base's GType; under the
+ * pure-JS leg it is the same accessors over the same store, one prototype down.
+ */
+export declare function withProperties<TBase extends ObservableConstructor>(Base: TBase, meta: DeclaredClassMeta): ((abstract new (...args: any[]) => {
     _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;
@@ -98,6 +164,6 @@ export declare function withSignals<TBase extends ObservableConstructor>(Base: T
     set(name: string, value: unknown): void;
     get(name: string): unknown;
 }) & {
-    /** What every widget emits; a class's own list adds to it (`emittedSignalsOf`). */
+    /** Only what this class ADDS; `emittedSignalsOf` merges it with the base's. */
     readonly emittedSignals: readonly string[];
 }) & TBase;