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

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,9 +2,7 @@ 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 { AdwEntryRow, NOTIFY_TEXT, NOTIFY_TEXT_LENGTH, NOTIFY_MAX_LENGTH, NOTIFY_EDITABLE, NOTIFY_SHOW_APPLY_BUTTON, NOTIFY_ACTIVATES_DEFAULT, SIGNAL_APPLY, SIGNAL_ENTRY_ACTIVATED, } from './adw-entry-row.js';
 export { AdwPasswordEntryRow } from './adw-password-entry-row.js';
 export { GtkEntry, ACTIVATE as ENTRY_ACTIVATE, NOTIFY_TEXT as NOTIFY_ENTRY_TEXT } from './gtk-entry.js';
 export type { NotifyEntryTextEventData } from './gtk-entry.js';

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

@@ -1,4 +1,49 @@
 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.
+     *
+     * `self` is the INSTANCE being written, so a normalizer may read the row's other properties:
+     * `AdwEntryRow` clamps `text` to that row's own `max-length`, and derives `text-length` from
+     * its own `text` — which is also how a property that is read-only upstream is held read-only
+     * here, since a write that resolves to the value already held is not a change.
+     */
+    readonly normalize?: (value: unknown, self: object) => unknown;
+}
+/** {@link ForeignClassMeta} whose properties may carry a {@link DeclaredProperty.normalize}. */
+export interface DeclaredClassMeta extends Omit<ForeignClassMeta, 'Properties'> {
+    readonly Properties?: Readonly<Record<string, DeclaredProperty>>;
+}
+/**
+ * {@link coerceDeclared}'s string reading on its own, so a {@link DeclaredProperty.normalize} that
+ * only wants to ADD a rule — a clamp, a floor — does not have to restate it. Without it every
+ * normalizer re-decides what `<AdwEntryRow maxLength="12">` means, and XML would answer one way
+ * for a property that has a normalizer and another way for one that does not.
+ */
+export declare function readDeclaredValue(name: string, kind: ForeignProperty['kind'], value: unknown): unknown;
+/**
+ * `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 +85,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 +139,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 +176,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;

package/lib/types/widgets/split-view-base.d.ts

@@ -11,6 +11,8 @@ export interface NotifyShowSidebarEventData extends EventData {
     collapsed: boolean;
 }
 declare const AdwSplitViewBase_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;
@@ -57,10 +59,12 @@ declare const AdwSplitViewBase_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/stack-page.d.ts

@@ -9,6 +9,8 @@ interface AwaitingStack {
     _addChildFromBuilder(name: string, view: GtkStackPage): void;
 }
 declare const GtkStackPage_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;
@@ -55,10 +57,12 @@ declare const GtkStackPage_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/style-manager-host.d.ts

@@ -0,0 +1,2 @@
+import { AdwStyleManager } from './style-manager.js';
+export { AdwStyleManager };

package/lib/types/widgets/style-manager.d.ts

@@ -1,4 +1,17 @@
-import { StyleManagerBase, type StyleSource } from '@gjsify/adwaita-core';
+import { StyleManagerBase, type AdwColorScheme, type StyleSource } from '@gjsify/adwaita-core';
+/** The system's light/dark preference as a platform reports it. */
+export interface SystemAppearance {
+    /** The current preference, `null` while the platform cannot tell. */
+    current(): AdwColorScheme | null;
+    /** Calls `changed` with each new preference; returns the unsubscribe. */
+    subscribe(changed: (scheme: AdwColorScheme) => void): () => void;
+}
+/**
+ * Hand the source the system's appearance (or take it away with `null`). From then on the scheme
+ * follows the system while no `FORCE_*` scheme pins it, and `system_supports_color_schemes` answers
+ * whether the system reports a preference.
+ */
+export declare function setSystemAppearance(next: SystemAppearance | null): void;
 export declare const nativeScriptStyleSource: StyleSource;
 export declare class AdwStyleManager extends StyleManagerBase {
     static readonly GTypeName: string;

package/lib/types/widgets/styled-layout-base.d.ts

@@ -1,6 +1,8 @@
 import { GridLayout } from '@nativescript/core';
 import { type AdwStyleClassesInput } from './style-classes.js';
 declare const AdwStyledLayoutBase_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 AdwStyledLayoutBase_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/view-stack-page.d.ts

@@ -9,6 +9,8 @@ interface AwaitingStack {
     _addChildFromBuilder(name: string, view: AdwViewStackPage): void;
 }
 declare const AdwViewStackPage_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;
@@ -55,10 +57,12 @@ declare const AdwViewStackPage_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/view-switcher-base.d.ts

@@ -13,6 +13,8 @@ export declare const NOTIFY_SELECTED = "notify::selected";
 export interface NotifyViewSelectedEventData extends EventData, ViewSwitcherNotifyPayload {
 }
 declare const AdwViewSwitcherBase_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;
@@ -59,10 +61,12 @@ declare const AdwViewSwitcherBase_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/widget-layout.d.ts

@@ -96,6 +96,10 @@ export declare abstract class GtkWidgetLayoutMembers {
     insert_action_group(prefix: string, group: 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;
     /** `gtk_widget_grab_focus`: asks the platform to move focus here; answers whether it now holds it. */
     grab_focus(): boolean;
 }

package/lib/types/widgets/window-state.d.ts

@@ -19,6 +19,32 @@ export declare function dialogPresentationMode(value: unknown): AdwDialogPresent
  * and a blank attribute keeps what was there.
  */
 export declare function surfaceSize(parsed: number, written: unknown, current: number, property: string): number;
+/** `PORTRAIT_CONDITION` of adw-dialog.c: `max-width: 450px`. */
+export declare const DIALOG_PORTRAIT_MAX_WIDTH = 450;
+/** `LANDSCAPE_CONDITION` of adw-dialog.c: `max-height: 360px`. */
+export declare const DIALOG_LANDSCAPE_MAX_HEIGHT = 360;
+/** The card's margin on every side, as `.adw-dialog-card` writes it. */
+export declare const DIALOG_CARD_MARGIN = 24;
+/** Where a dialog's card goes and how big it is. `'auto'` follows the content. */
+export interface DialogCardLayout {
+    readonly sheet: boolean;
+    readonly width: number | 'auto';
+    readonly height: number | 'auto';
+}
+/**
+ * The card layout for a dialog shown over a window of `available` size (DIP), or over a window
+ * not laid out yet (`null`).
+ *
+ * `auto` is a bottom sheet when the window matches `max-width: 450px or max-height: 360px`, a
+ * floating card otherwise — adw-dialog.c's two breakpoints. Before the first layout there is
+ * no window size to ask, so `auto` floats. A floating card is `content-width` /
+ * `content-height` wide and high, but never more than the window leaves around its margins: an
+ * NS `width` is an exact size, and libadwaita shrinks a dialog that does not fit.
+ */
+export declare function dialogCardLayout(available: {
+    readonly width: number;
+    readonly height: number;
+} | null, mode: AdwDialogPresentationNick, contentWidth: number, contentHeight: number): DialogCardLayout;
 /** What a dialog hands itself to when it is presented over a widget. */
 export interface DialogHost {
     /** Put `dialog` above everything the host shows. */

package/lib/types/window-title-properties.spec.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-nativescript",
-    "version": "0.64.2",
+    "version": "0.64.3-next.262",
     "description": "Native Adwaita widgets for the NativeScript runtime — real NativeScript components (StackLayout/GridLayout/Switch/Label) styled like Libadwaita, not a webview",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -73,15 +73,15 @@
         "design-system"
     ],
     "dependencies": {
-        "@gjsify/adwaita-core": "^0.64.2",
-        "@gjsify/adwaita-fonts": "^0.64.2",
-        "@gjsify/adwaita-icons": "^0.64.2",
-        "@gjsify/canvas2d-core": "^0.64.2",
-        "@gjsify/native-platform": "^0.64.2"
+        "@gjsify/adwaita-core": "0.64.3-next.262",
+        "@gjsify/adwaita-fonts": "0.64.3-next.262",
+        "@gjsify/adwaita-icons": "0.64.3-next.262",
+        "@gjsify/canvas2d-core": "0.64.3-next.262",
+        "@gjsify/native-platform": "0.64.3-next.262"
     },
     "peerDependencies": {
         "@nativescript/core": "*",
-        "@gjsify/app-settings": "^0.64.2"
+        "@gjsify/app-settings": "0.64.3-next.262"
     },
     "peerDependenciesMeta": {
         "@nativescript/core": {
@@ -92,11 +92,11 @@
         }
     },
     "devDependencies": {
-        "@gjsify/app-settings": "^0.64.2",
-        "@gjsify/blueprint": "^0.64.2",
-        "@gjsify/cli": "^0.64.2",
-        "@gjsify/unit": "^0.64.2",
-        "@gjsify/vite-plugin-blueprint": "^0.64.2",
+        "@gjsify/app-settings": "0.64.3-next.262",
+        "@gjsify/blueprint": "0.64.3-next.262",
+        "@gjsify/cli": "0.64.3-next.262",
+        "@gjsify/unit": "0.64.3-next.262",
+        "@gjsify/vite-plugin-blueprint": "0.64.3-next.262",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
@@ -125,5 +125,6 @@
     "bugs": {
         "url": "https://github.com/gjsify/gjsify/issues"
     },
-    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/nativescript-bridge/adwaita#readme"
+    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/nativescript-bridge/adwaita#readme",
+    "gitHead": "0f5ca82aab25bf9df8d1e790d28483b1f90fe3a9"
 }

package/src/testing/ns-core.mts

@@ -608,6 +608,11 @@ export class GridLayout extends LayoutBase {
         if (at !== -1) this._rows.splice(at, 1);
     }
 
+    /** `GridLayoutBase.getColumns` — a copy, as on a device. */
+    getColumns(): ItemSpec[] {
+        return [...this._cols];
+    }
+
     removeColumns(): void {
         this._cols.length = 0;
     }
@@ -933,6 +938,8 @@ const APPLIED_CSS: string[] = [];
 
 const LIFECYCLE = new Map<string, ((args: unknown) => void)[]>();
 
+const SYSTEM_APPEARANCE: { value: 'dark' | 'light' | null } = { value: null };
+
 // An object, not a `namespace`: the gi-renderer-arms e2e loads this file with Node's strip-only
 // type removal, which refuses every non-erasable construct.
 export const Application = {
@@ -970,6 +977,19 @@ export const Application = {
         if (at !== -1) existing.splice(at, 1);
     },
 
+    /** The double has no configuration to read, so it cannot tell — until a spec says otherwise. */
+    systemAppearance(): 'dark' | 'light' | null {
+        return SYSTEM_APPEARANCE.value;
+    },
+
+    /** Change the system's appearance and deliver `systemAppearanceChanged`, as the platform does. */
+    emitSystemAppearance(value: 'dark' | 'light'): void {
+        SYSTEM_APPEARANCE.value = value;
+        for (const callback of (LIFECYCLE.get('systemAppearanceChanged') ?? []).slice()) {
+            callback({ eventName: 'systemAppearanceChanged', newValue: value });
+        }
+    },
+
     /** Deliver a lifecycle event (`resume`, `suspend`) to its subscribers, as the platform does. */
     emitLifecycle(event: string): void {
         for (const callback of (LIFECYCLE.get(event) ?? []).slice()) callback({ eventName: event });

package/src/theme/adwaita.css

@@ -1768,15 +1768,27 @@ Page.adw-window {
     background-color: #fafafb;
     border-radius: 16;
     padding: 24;
-    width: 320;
     margin: 24;
 }
 
+/* The about card has no `content-width`; the preferences card's comes from AdwDialog. */
+.adw-about-dialog-card {
+    width: 320;
+}
+
 .adw-about-dialog-icon {
-    font-size: 48;
     margin: 0 0 8 0;
 }
 
+.adw-about-dialog-link,
+.adw-about-dialog-links-item {
+    background-color: transparent;
+    color: rgba(0, 0, 0, 0.8);
+    text-decoration: underline;
+    font-size: 13;
+    margin: 2 0 2 0;
+}
+
 .adw-about-dialog-name {
     font-size: 20;
     font-weight: 700;
@@ -1793,7 +1805,11 @@ Page.adw-window {
 .adw-about-dialog-developer,
 .adw-about-dialog-comments,
 .adw-about-dialog-website,
-.adw-about-dialog-copyright,
+.adw-about-dialog-support,
+.adw-about-dialog-issue,
+.adw-about-dialog-credits,
+.adw-about-dialog-acknowledgements,
+.adw-about-dialog-legal,
 .adw-about-dialog-release-notes,
 .adw-about-dialog-links,
 .adw-about-dialog-debug-info {
@@ -1802,6 +1818,7 @@ Page.adw-window {
     margin: 2 0 2 0;
 }
 
+.adw-about-dialog-copy,
 .adw-about-dialog-close {
     background-color: rgba(0, 0, 0, 0.08);
     color: rgba(0, 0, 0, 0.8);
@@ -2630,13 +2647,23 @@ Page.ns-dark.adw-window {
 .ns-dark .adw-about-dialog-developer,
 .ns-dark .adw-about-dialog-comments,
 .ns-dark .adw-about-dialog-website,
-.ns-dark .adw-about-dialog-copyright,
+.ns-dark .adw-about-dialog-support,
+.ns-dark .adw-about-dialog-issue,
+.ns-dark .adw-about-dialog-credits,
+.ns-dark .adw-about-dialog-acknowledgements,
+.ns-dark .adw-about-dialog-legal,
 .ns-dark .adw-about-dialog-release-notes,
 .ns-dark .adw-about-dialog-links,
 .ns-dark .adw-about-dialog-debug-info {
     color: rgba(255, 255, 255, 0.6);
 }
 
+.ns-dark .adw-about-dialog-link,
+.ns-dark .adw-about-dialog-links-item {
+    color: #ffffff;
+}
+
+.ns-dark .adw-about-dialog-copy,
 .ns-dark .adw-about-dialog-close {
     background-color: rgba(255, 255, 255, 0.1);
     color: #ffffff;