@gjsify/adwaita-nativescript 0.63.0 → 0.63.1-next.235

package/lib/types/widgets/carousel-indicator-base.d.ts

@@ -5,6 +5,8 @@ declare const AdwCarouselIndicatorBase_base: (abstract new (...args: any[]) => {
     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;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -23,6 +25,12 @@ declare const AdwCarouselIndicatorBase_base: (abstract new (...args: any[]) => {
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -31,12 +39,6 @@ declare const AdwCarouselIndicatorBase_base: (abstract new (...args: any[]) => {
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;

package/lib/types/widgets/construct-props.d.ts

@@ -1,4 +1,5 @@
 import type { AdwAdjustmentInput, AdwListModelInput } from '@gjsify/adwaita-core';
+import { type ShadowedName } from './shadowed-properties.js';
 /**
  * The keys a widget's construct-props bag accepts, derived from the widget itself.
  *
@@ -13,10 +14,15 @@ import type { AdwAdjustmentInput, AdwListModelInput } from '@gjsify/adwaita-core
  * measured to drop `size` as well — a getter/setter pair with different types does not
  * compare equal under it — and a type that silently loses real properties is worse than
  * one that admits two impossible ones and says so when they arrive.
+ *
+ * A name a NativeScript base owns (`shadowed-properties.ts`) is dropped whatever `T` inherits
+ * under it — read off `T`, `direction` would be NativeScript's layout direction — and comes
+ * back only through `Shadowed`, typed as the class's own `set_<p>` takes it:
+ * `ConstructProps<AdwSplitButton, { direction: number }>`. The applier routes it to that verb.
  */
-export type ConstructProps<T> = Partial<{
-    [K in keyof T as T[K] extends (...args: never[]) => unknown ? never : K]: K extends EnumProp ? T[K] | number : K extends ValueProp ? T[K] | ValueProps[K & ValueProp] : T[K];
-}>;
+export type ConstructProps<T, Shadowed extends object = object> = Partial<{
+    [K in keyof T as T[K] extends (...args: never[]) => unknown ? never : K extends ShadowedName | keyof Shadowed ? never : K]: K extends EnumProp ? T[K] | number : K extends ValueProp ? T[K] | ValueProps[K & ValueProp] : T[K];
+} & Shadowed>;
 /**
  * The two properties whose SETTER takes a portable VALUE the getter does not hand back, and
  * what each one accepts.

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

@@ -5,6 +5,8 @@ declare const GtkActionBar_base: (abstract new (...args: any[]) => {
     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;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -23,6 +25,12 @@ declare const GtkActionBar_base: (abstract new (...args: any[]) => {
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -31,12 +39,6 @@ declare const GtkActionBar_base: (abstract new (...args: any[]) => {
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;

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

@@ -25,7 +25,7 @@ export declare class GtkBox extends AdwStyledLayoutBase {
      * spacing at all.
      */
     addChild(view: View): void;
-    insertChild(child: View, atIndex: number): void;
+    insertChild(child: View, atIndex: number): boolean;
     removeChild(view: View): void;
     /**
      * `gtk_box_insert_child_after`.

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

@@ -10,6 +10,8 @@ declare const GtkButton_base: (abstract new (...args: any[]) => {
     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;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -28,6 +30,12 @@ declare const GtkButton_base: (abstract new (...args: any[]) => {
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -36,12 +44,6 @@ declare const GtkButton_base: (abstract new (...args: any[]) => {
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;

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

@@ -19,6 +19,8 @@ declare const GtkDropDown_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
+    get_property(name: string): unknown;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -37,6 +39,12 @@ declare const GtkDropDown_base: (abstract new (...args: any[]) => {
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -45,12 +53,6 @@ declare const GtkDropDown_base: (abstract new (...args: any[]) => {
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;

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

@@ -17,6 +17,8 @@ declare const GtkEntry_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
+    get_property(name: string): unknown;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -35,6 +37,12 @@ declare const GtkEntry_base: (abstract new (...args: any[]) => {
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -43,12 +51,6 @@ declare const GtkEntry_base: (abstract new (...args: any[]) => {
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;

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

@@ -5,6 +5,14 @@ export declare const PolicyType: Readonly<{
     readonly NEVER: 2;
     readonly EXTERNAL: 3;
 }>;
+/** `Gtk.ArrowType`: `UP` 0, `DOWN` 1, `LEFT` 2, `RIGHT` 3, `NONE` 4 — `Adw.SplitButton:direction`. */
+export declare const ArrowType: Readonly<{
+    readonly UP: 0;
+    readonly DOWN: 1;
+    readonly LEFT: 2;
+    readonly RIGHT: 3;
+    readonly NONE: 4;
+}>;
 /** `Gtk.TextDirection`: `NONE` 0, `LTR` 1, `RTL` 2. */
 export declare const TextDirection: Readonly<{
     readonly NONE: 0;

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

@@ -27,7 +27,7 @@ export declare class GtkGrid extends AdwStyledLayoutBase {
      * are derived here.
      */
     addChild(view: View): void;
-    insertChild(child: View, atIndex: number): void;
+    insertChild(child: View, atIndex: number): boolean;
     removeChild(view: View): void;
     /** `Gtk.Grid:row-spacing` — the gap between rows, in DIPs. */
     get rowSpacing(): number;

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

@@ -15,6 +15,8 @@ declare const GtkImage_base: (abstract new (...args: any[]) => {
     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;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -33,6 +35,12 @@ declare const GtkImage_base: (abstract new (...args: any[]) => {
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -41,12 +49,6 @@ declare const GtkImage_base: (abstract new (...args: any[]) => {
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;

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

@@ -5,6 +5,8 @@ declare const GtkLabel_base: (abstract new (...args: any[]) => {
     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;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -23,6 +25,12 @@ declare const GtkLabel_base: (abstract new (...args: any[]) => {
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -31,12 +39,6 @@ declare const GtkLabel_base: (abstract new (...args: any[]) => {
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;

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

@@ -35,7 +35,7 @@ export declare class GtkListBox extends AdwStyledLayoutBase {
     get_row_at_index(index: number): View | null;
     /** Every path a row can enter by ends here, so the rows are numbered here. */
     addChild(view: View): void;
-    insertChild(child: View, atIndex: number): void;
+    insertChild(child: View, atIndex: number): boolean;
     removeChild(view: View): void;
     /** XML inflation — every child is a row, whatever slot it names. */
     _addChildFromBuilder(_name: string, view: View): void;

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

@@ -8,6 +8,8 @@ declare const GtkPopoverMenu_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
+    get_property(name: string): unknown;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -26,6 +28,12 @@ declare const GtkPopoverMenu_base: (abstract new (...args: any[]) => {
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -34,12 +42,6 @@ declare const GtkPopoverMenu_base: (abstract new (...args: any[]) => {
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;

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

@@ -15,6 +15,8 @@ declare const GtkStack_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
+    get_property(name: string): unknown;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -33,6 +35,12 @@ declare const GtkStack_base: (abstract new (...args: any[]) => {
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -41,12 +49,6 @@ declare const GtkStack_base: (abstract new (...args: any[]) => {
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;

package/lib/types/widgets/gtk-text-view.d.ts

@@ -17,6 +17,8 @@ declare const GtkTextView_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
+    get_property(name: string): unknown;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -35,6 +37,12 @@ declare const GtkTextView_base: (abstract new (...args: any[]) => {
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -43,12 +51,6 @@ declare const GtkTextView_base: (abstract new (...args: any[]) => {
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;

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

@@ -13,6 +13,7 @@ export declare class GtkWindow extends AdwSingleChildBase {
     private readonly _members;
     private readonly _closeRequest;
     private _unwatchForeground;
+    private _unwatchBack;
     constructor(props?: ConstructProps<GtkWindow>);
     onLoaded(): void;
     onUnloaded(): void;
@@ -38,6 +39,17 @@ export declare class GtkWindow extends AdwSingleChildBase {
      * it ends. Throws on iOS (no public API to end the root) before any handler runs.
      */
     close(): void;
+    private _requestClose;
+    /**
+     * What the back button does, in order: the topmost dialog, the innermost navigation view, then
+     * `close-request`. Always consumes the press — the system's own back would `finish()` too, but
+     * without asking the handlers.
+     */
+    private _handleBack;
+    /** A subclass that shows things over the window (dialogs) takes the press first; true = taken. */
+    protected _consumeBack(): boolean;
+    /** Only a window with no window above it owns the back button. */
+    private _isToplevel;
     connect(eventName: string, callback: (self: this, data: EventData) => unknown): number;
     /** `GtkWindow:title`. Held: a `Page` has no title bar of this window's to put it in. */
     get title(): string;

package/lib/types/widgets/shadowed-properties.d.ts

@@ -0,0 +1,99 @@
+/** One GTK property name that a NativeScript base owns as something else. */
+export interface ShadowedProperty {
+    /** The platform member the name lands on, and what it is there. */
+    readonly nativeScript: string;
+    /** GType names whose GTK property of this name the port implements through `get_<p>` / `set_<p>`. */
+    readonly routed: readonly string[];
+    /** GIR types declaring a property of this name the port does not implement. */
+    readonly refused: readonly string[];
+}
+export declare const SHADOWED_PROPERTIES: {
+    readonly columns: {
+        readonly nativeScript: "GridLayoutBase.columns — the column track spec ('auto,*'), setter-only";
+        readonly routed: readonly ["AdwDataGrid"];
+        readonly refused: readonly [];
+    };
+    readonly cssClasses: {
+        readonly nativeScript: "ViewBase.cssClasses — the Set the view's own class list lives in";
+        readonly routed: readonly [];
+        readonly refused: readonly ["GtkWidget"];
+    };
+    readonly direction: {
+        readonly nativeScript: "ViewCommon.direction — the CSS layout direction ('ltr' | 'rtl') margins resolve by";
+        readonly routed: readonly ["AdwSplitButton"];
+        readonly refused: readonly ["GtkMenuButton"];
+    };
+    readonly modal: {
+        readonly nativeScript: "ViewCommon.modal — the view this one was shown modally from, getter-only";
+        readonly routed: readonly ["AdwBottomSheet"];
+        readonly refused: readonly ["GtkWindow"];
+    };
+    readonly rows: {
+        readonly nativeScript: "GridLayoutBase.rows — the row track spec ('auto,*'), setter-only";
+        readonly routed: readonly ["AdwDataGrid"];
+        readonly refused: readonly [];
+    };
+    readonly visibility: {
+        readonly nativeScript: "View.visibility — 'visible' | 'hidden' | 'collapse'";
+        readonly routed: readonly [];
+        readonly refused: readonly ["GtkEntry"];
+    };
+};
+/** Every name {@link SHADOWED_PROPERTIES} decides. */
+export type ShadowedName = keyof typeof SHADOWED_PROPERTIES;
+/** A GTK property the NativeScript member of the same name already carries, and why that is enough. */
+export interface SharedProperty {
+    /** The GIR type that declares it. */
+    readonly declarer: string;
+    readonly why: string;
+}
+export declare const SHARED_PROPERTIES: {
+    readonly marginBottom: {
+        readonly declarer: "GtkWidget";
+        readonly why: "View.marginBottom is the same outer spacing; a GTK pixel count is a valid NativeScript length.";
+    };
+    readonly marginTop: {
+        readonly declarer: "GtkWidget";
+        readonly why: "View.marginTop is the same outer spacing; a GTK pixel count is a valid NativeScript length.";
+    };
+    readonly opacity: {
+        readonly declarer: "GtkWidget";
+        readonly why: "View.opacity is the same 0..1 alpha.";
+    };
+    readonly orientation: {
+        readonly declarer: "GtkOrientable";
+        readonly why: "StackLayout.orientation takes the same two nicks, 'horizontal' and 'vertical'.";
+    };
+};
+/** How a GTK property name reaches a given object. */
+export type GtkPropertyDoor = {
+    readonly kind: 'accessor';
+} | {
+    readonly kind: 'verbs';
+    readonly get: string;
+    readonly set: string;
+} | {
+    readonly kind: 'refused';
+    readonly why: string;
+} | {
+    readonly kind: 'absent';
+};
+/**
+ * A GObject property name (`'can-close'`, `'can_close'`, `'canClose'`) in the camel case the
+ * port's members use — `propertyOf` from `@gjsify/adwaita-core/tags`, restated here so every
+ * widget importing `signals.js` does not reach adwaita-core through it.
+ */
+export declare const camelProperty: (name: string) => string;
+/**
+ * Where an assignment or read of the camel-case GTK property `prop` lands on `target`: the
+ * class's own accessor, its `get_<p>` / `set_<p>` pair, a refusal, or nowhere.
+ */
+export declare function gtkPropertyDoor(target: object, prop: string): GtkPropertyDoor;
+/** Whether {@link writeGtkProperty} has somewhere to put `prop`. */
+export declare function hasGtkProperty(target: object, prop: string): boolean;
+/** Why `prop` is refused on `target`, or `null` when it is not one of the shadowed names. */
+export declare function gtkPropertyRefusal(target: object, prop: string): string | null;
+/** Read the GTK property `prop`, through `get_<p>()` where the name is NativeScript's. */
+export declare function readGtkProperty(target: object, prop: string): unknown;
+/** Write the GTK property `prop`, through `set_<p>()` where the name is NativeScript's. */
+export declare function writeGtkProperty(target: object, prop: string, value: unknown): void;

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

@@ -13,6 +13,13 @@ export interface GObjectSignals {
     disconnect(handlerId: number): void;
     /** `g_signal_emit_by_name`: run every handler `connect` added for `eventName`, with `args` in the payload. */
     emit(eventName: string, ...args: unknown[]): void;
+    /**
+     * `g_object_get_property`: the GTK property `name` (`'can-close'` or camel case). A
+     * name NativeScript owns as something else is read through the class's `get_<p>()`.
+     */
+    get_property(name: string): unknown;
+    /** `g_object_set_property`, routed the same way as {@link get_property}. */
+    set_property(name: string, value: unknown): void;
 }
 /**
  * A constructor the mixin can wrap: anything that is an `Observable`, abstract or not.
@@ -34,6 +41,8 @@ export declare function withSignals<TBase extends ObservableConstructor>(Base: T
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
+    get_property(name: string): unknown;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -52,6 +61,12 @@ export declare function withSignals<TBase extends ObservableConstructor>(Base: T
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -60,12 +75,6 @@ export declare function withSignals<TBase extends ObservableConstructor>(Base: T
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;

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

@@ -14,6 +14,8 @@ declare const AdwSplitViewBase_base: (abstract new (...args: any[]) => {
     connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => unknown): number;
     disconnect(handlerId: number): void;
     emit(eventName: string, ...args: unknown[]): void;
+    get_property(name: string): unknown;
+    set_property(name: string, value: unknown): void;
     get halign(): string;
     set halign(value: string | number);
     get valign(): string;
@@ -32,6 +34,12 @@ declare const AdwSplitViewBase_base: (abstract new (...args: any[]) => {
     set sensitive(value: boolean | string);
     get name(): string;
     set name(value: string | null);
+    get tooltipText(): string;
+    set tooltipText(value: string);
+    get widthRequest(): number;
+    set widthRequest(value: number | string);
+    get heightRequest(): number;
+    set heightRequest(value: number | string);
     set_direction(direction: number): void;
     get_direction(): number;
     get_first_child(): object | null;
@@ -40,12 +48,6 @@ declare const AdwSplitViewBase_base: (abstract new (...args: any[]) => {
     get_prev_sibling(): object | null;
     get_parent(): object | null;
     insert_action_group(prefix: string, group: import("@gjsify/adwaita-core").ActionGroupLike | null): void;
-    get tooltipText(): string;
-    set tooltipText(value: string);
-    get widthRequest(): number;
-    set widthRequest(value: number | string);
-    get heightRequest(): number;
-    set heightRequest(value: number | string);
     _emit(eventName: string): void;
     addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
     removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;