@gjsify/adwaita-nativescript 0.64.13-next.283 → 0.64.13

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

@@ -59,6 +59,15 @@ export declare class Style extends Observable {
     constructor(view: View);
     get visibility(): string;
     set visibility(value: string);
+    /**
+     * The inline width, in DIPs or as a percentage string, `'auto'` until written — and the
+     * `widthChange` a one-child container listens for. A CSS property notifies on the style
+     * and not on the view, which is the whole reason this pair lives here.
+     */
+    get width(): number | string;
+    set width(value: number | string);
+    get height(): number | string;
+    set height(value: number | string);
 }
 export declare class View extends Observable {
     /**
@@ -95,8 +104,21 @@ export declare class View extends Observable {
      * missing so the first `className` write died inside a constructor.
      */
     readonly cssClasses: Set<string>;
-    width: number | string;
-    height: number | string;
+    /**
+     * `'auto'` until written, and HELD ON THE {@link Style} as `widthProperty` /
+     * `heightProperty` are (`ui/styling/style-properties.ts` registers both on `Style`;
+     * `view-common.ts`'s `get width()` is a one-line forward to `this.style.width`).
+     *
+     * This double held them as plain fields on the view, which made it STRUCTURALLY BLIND to
+     * the one thing a reader needs from them: the notification. `AdwSingleChildBase` learns
+     * that a parent settled its width from `widthChange` on the style — on a device the only
+     * place it is emitted — and against a field there is no event at all, so a spec would
+     * have passed while the widget sat waiting for a message that never came.
+     */
+    get width(): number | string;
+    set width(value: number | string);
+    get height(): number | string;
+    set height(value: number | string);
     horizontalAlignment: string;
     verticalAlignment: string;
     /**

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

@@ -1,4 +1,4 @@
-import { Label, type EventData, type View } from '@nativescript/core';
+import { Label, type View } from '@nativescript/core';
 import type { AdwComboOption, ComboWatchableModel } from '@gjsify/adwaita-core';
 import { AdwActionRow } from './adw-action-row.js';
 import { GtkImage } from './gtk-image.js';
@@ -7,14 +7,18 @@ export { ComboState } from '@gjsify/adwaita-core';
 export type { AdwComboOption, ComboStateChange, ComboStateListener } from '@gjsify/adwaita-core';
 /** Event name emitted when {@link AdwComboRow.selected} changes. Mirrors GObject `notify::selected`. */
 export declare const NOTIFY_SELECTED = "notify::selected";
-/** Payload of the `notify::selected` event. */
-export interface NotifySelectedEventData extends EventData {
-    /** The newly-selected index. */
-    selected: number;
-    /** The newly-selected option's `value`. */
-    value: string;
-}
-export declare class AdwComboRow extends AdwActionRow {
+declare const AdwComboRow_base: ((abstract new (...args: any[]) => {
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: import("@nativescript/core").EventData) => void, thisArg?: unknown): void;
+    notify<T extends import("@nativescript/core").EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & {
+    readonly emittedSignals: readonly string[];
+}) & typeof AdwActionRow;
+export declare class AdwComboRow extends AdwComboRow_base {
     static readonly GTypeName: string;
     /**
      * The action row's edges, plus `model`: `model: Gtk.StringList { strings [ … ] }` in a
@@ -42,7 +46,35 @@ export declare class AdwComboRow extends AdwActionRow {
      * writes `model:` first — the order GtkBuilder needs too.
      */
     private _pendingSelected;
+    /** `Adw.ComboRow:model` — the list, by identity. Declared above; the seam installs it. */
+    model: ComboWatchableModel | null;
+    /**
+     * `Adw.ComboRow:selected` — the selected position, or {@link ADW_COMBO_NO_SELECTION}.
+     * Declared above; not `readonly` in TypeScript because the seam installs one accessor pair
+     * per declared property and this row is what writes the derived value.
+     */
+    selected: number;
+    /**
+     * `Adw.ComboRow:selected-item` — the model's OWN object at {@link selected}, so the identity
+     * comparison a `selected-item` consumer writes holds. `null` for the sentinel and for no
+     * model. Read-only by derivation (see the declaration).
+     */
+    selectedItem: unknown;
+    /**
+     * What a `model` write DOES, once the seam has stored the normalized value.
+     *
+     * A method on the class and not a body inside the declaration, because the descriptor sits
+     * outside the class and reaches the state through a cast — and a reader keyed on
+     * `this.<field>` cannot tell `ComboState.setModel` from `ListViewState.setModel` through
+     * one (`check-adwaita-collection-reactivity.mjs`). Guessing there would merge two different
+     * collections into one comparison, so the call is made where the field's type is declared.
+     */
+    private _applyModel;
+    /** What a `selected` write does: emits `selected` then `selected-item` through the relay. */
+    private _applySelected;
     constructor(props?: ConstructProps<AdwComboRow>);
+    /** What the relay pushes for each of the three — the state's reading, never the store's. */
+    private _valueOf;
     /**
      * `model_changed` (adw-combo-row.c:187-195) — one option or none is not a
      * choice, so the chevron goes and the row stops being activatable.
@@ -54,13 +86,6 @@ export declare class AdwComboRow extends AdwActionRow {
     private _syncChooser;
     /** Open the native action chooser and apply the picked option. */
     private _openChooser;
-    /**
-     * The list model (`Adw.ComboRow:model`) — the OBJECT that was assigned, by identity, as
-     * `row.model === model` is measured to hold in libadwaita (ADR 0122 § 4). The normalised
-     * descriptors are {@link options}.
-     */
-    get model(): ComboWatchableModel | null;
-    set model(value: ComboWatchableModel | string | null);
     /** The held model's items as `{ value, label }` descriptors. */
     get options(): AdwComboOption[];
     /** `adw_combo_row_set_model`. */
@@ -73,21 +98,12 @@ export declare class AdwComboRow extends AdwActionRow {
      * row edge, as on any action row.
      */
     _addChildFromBuilder(name: string, child: View): void;
-    /** The selected option index. Updates the inline value label. */
-    get selected(): number;
-    set selected(raw: number | string);
+    /** `adw_combo_row_get_selected`. */
     get_selected(): number;
     set_selected(position: number): void;
     /** The selected option's `value`, or `''` when out of range. */
     get selectedValue(): string;
     set selectedValue(value: string);
-    /**
-     * The selected ITEM (`Adw.ComboRow:selected-item`) — the model's own object at
-     * {@link selected}, read through `get_item`, so the identity comparison a `selected-item`
-     * consumer writes holds. `null` for the sentinel and for no model. Read-only, as in
-     * libadwaita.
-     */
-    get selectedItem(): unknown;
     /** `adw_combo_row_get_selected_item`. */
     get_selected_item(): unknown;
 }

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

@@ -1,24 +1,16 @@
-import { Label, StackLayout, type EventData, type View } from '@nativescript/core';
+import { Label, StackLayout, type View } from '@nativescript/core';
 import type { AdwComboOption, ComboWatchableModel } from '@gjsify/adwaita-core';
 import { GtkImage } from './gtk-image.js';
 import { type ConstructProps } from './construct-props.js';
-/** Event name emitted when {@link GtkDropDown.selected} changes through a pick. Mirrors GObject `notify::selected`. */
+import { type GObjectNotify } from './signals.js';
+/** Event name emitted when {@link GtkDropDown.selected} changes. Mirrors GObject `notify::selected`. */
 export declare const NOTIFY_SELECTED = "notify::selected";
 /** Mirrors GObject `notify::selected-item`; fired right after the one above, on the same change. */
 export declare const NOTIFY_SELECTED_ITEM = "notify::selected-item";
-/** Payload of the `notify::selected` event. */
-export interface NotifyDropDownSelectedEventData extends EventData {
-    /** The newly-selected index. */
-    selected: number;
-    /** The newly-selected option's `value`. */
-    value: string;
-    /** The newly-selected option's `label` — what the button now shows. */
-    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;
+    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;
@@ -73,7 +65,7 @@ declare const GtkDropDown_base: ((abstract new (...args: any[]) => {
     set_focus_on_click(focusOnClick: boolean): void;
     grab_focus(): boolean;
     _emit(eventName: string): 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;
@@ -82,8 +74,6 @@ declare const GtkDropDown_base: ((abstract new (...args: any[]) => {
 }) & typeof StackLayout;
 export declare class GtkDropDown extends GtkDropDown_base {
     static readonly GTypeName: string;
-    /** The GTK signals this widget emits through `connect` — read by the shared-tree builder (ADR 0093). */
-    static readonly emittedSignals: readonly string[];
     /**
      * `model` only: `model: Gtk.StringList { strings [ … ] }` in a `.blp` places the list at
      * the property it sets (ADR 0072). `GtkDropDown` takes no child widget in GTK.
@@ -104,16 +94,43 @@ export declare class GtkDropDown extends GtkDropDown_base {
     private readonly _authored;
     /** Title shown atop the substituted `action()` sheet. */
     private _chooserTitle;
+    /**
+     * A `selected` written while the widget has no model yet — the twin of
+     * {@link AdwComboRow}'s. NativeScript's XML builder assigns every attribute before it adds
+     * the children, so `<gtk:DropDown selected="1">` reached this widget before its
+     * `<gtk:DropDown.model>` list did and the index was DROPPED; the row has held it since it
+     * was written and the drop-down does now too.
+     */
+    private _pendingSelected;
+    /** `Gtk.DropDown:model` — the list, by identity. Declared above; the seam installs it. */
+    model: ComboWatchableModel | null;
+    /**
+     * `Gtk.DropDown:selected` — the selected position, or {@link ADW_COMBO_NO_SELECTION}.
+     * Declared above; not `readonly` in TypeScript because the seam installs one accessor pair
+     * per declared property and this widget is what writes the derived value.
+     */
+    selected: number;
+    /**
+     * `Gtk.DropDown:selected-item` — the model's OWN object at {@link selected}, so the identity
+     * comparison a `selected-item` consumer writes holds. `null` for the sentinel and for no
+     * model. Read-only by derivation (see the declaration).
+     */
+    selectedItem: unknown;
+    /** GJS's `notify('<prop>')` beside NativeScript's `notify({ eventName })`; see the seam. */
+    notify: GObjectNotify;
+    /**
+     * What a `model` write does, once the seam has stored the normalized value — the twin of
+     * `AdwComboRow._applyModel`, which says why the body sits on the class and not in the
+     * declaration.
+     */
+    private _applyModel;
+    /** What a `selected` write does: emits `selected` then `selected-item` through the relay. */
+    private _applySelected;
     constructor(props?: ConstructProps<GtkDropDown>);
+    /** What the relay pushes for each of the three — the state's reading, never the store's. */
+    private _valueOf;
     /** Open the native chooser and apply the picked option. */
     private _openChooser;
-    /**
-     * The list model (`Gtk.DropDown:model`) — the OBJECT that was assigned, by identity, as
-     * `dropdown.model === model` is measured to hold in GTK (ADR 0122 § 4). The normalised
-     * descriptors are {@link options}.
-     */
-    get model(): ComboWatchableModel | null;
-    set model(value: ComboWatchableModel | string | null);
     /** The held model's items as `{ value, label }` descriptors. */
     get options(): AdwComboOption[];
     /** `gtk_drop_down_set_model`. */
@@ -125,9 +142,6 @@ export declare class GtkDropDown extends GtkDropDown_base {
      * Anything else is refused, as GTK refuses a child widget on a `GtkDropDown`.
      */
     _addChildFromBuilder(name: string, child: View): void;
-    /** The selected option index (`Gtk.DropDown:selected`). */
-    get selected(): number;
-    set selected(raw: number | string);
     /** `gtk_drop_down_get_selected`. */
     get_selected(): number;
     /** `gtk_drop_down_set_selected`. */
@@ -135,12 +149,6 @@ export declare class GtkDropDown extends GtkDropDown_base {
     /** The selected option's `value`, or `''` when out of range. */
     get selectedValue(): string;
     set selectedValue(value: string);
-    /**
-     * The selected ITEM (`Gtk.DropDown:selected-item`) — the model's own object at
-     * {@link selected}, read through `get_item`, so the identity comparison a `selected-item`
-     * consumer writes holds. `null` for the sentinel and for no model. Read-only, as in GTK.
-     */
-    get selectedItem(): unknown;
     /** `gtk_drop_down_get_selected_item`. */
     get_selected_item(): unknown;
     /**

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

@@ -7,9 +7,8 @@ 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';
 export { AdwComboRow, ComboState, NOTIFY_SELECTED } from './adw-combo-row.js';
-export type { AdwComboOption, ComboStateChange, ComboStateListener, NotifySelectedEventData } from './adw-combo-row.js';
+export type { AdwComboOption, ComboStateChange, ComboStateListener } from './adw-combo-row.js';
 export { GtkDropDown, NOTIFY_SELECTED as NOTIFY_DROP_DOWN_SELECTED } from './gtk-drop-down.js';
-export type { NotifyDropDownSelectedEventData } from './gtk-drop-down.js';
 export { AdwSpinRow, NOTIFY_VALUE, SpinState } from './adw-spin-row.js';
 export type { NotifyValueEventData, SpinStateChange, SpinStateListener } from './adw-spin-row.js';
 export { AdwSliderRow, NOTIFY_SLIDER_VALUE } from './adw-slider-row.js';

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

@@ -22,9 +22,9 @@ type Declared<P> = P & {
      */
     readonly normalize?: (value: unknown, self: object) => unknown;
     /**
-     * Replaces the equal-write check for this property on the PURE leg: `written` is the value as
-     * the caller spelled it, `next` what {@link Declared.normalize} made of it, `held` what the
-     * store holds — and the answer decides whether the write notifies at all.
+     * Replaces the equal-write check for this property: `written` is the value as the caller
+     * spelled it, `next` what {@link Declared.normalize} made of it, `held` what the store holds
+     * — and the answer decides whether the write notifies at all.
      *
      * WHY. A C setter guards on `g_strcmp0 (value, adw_…_get_…(self))`, against the GETTER
      * READBACK rather than the stored field. Where storage normalises, the two differ and the
@@ -33,12 +33,19 @@ type Declared<P> = P & {
      * libadwaita 1.9.4). Comparing the held value says the opposite, and only the property whose
      * `normalize` collapses distinct writes onto one held value can tell the difference.
      *
-     * The real leg has no use for it — there the guard IS the C one.
+     * RUNS ON BOTH LEGS. It used to run on the pure one alone, on the reasoning that "there the
+     * guard IS the C one" — which holds for a widget wrapping a real C object and not for a
+     * foreign-parent class, which has no C setter at all. On route D node-gi's generated setter
+     * is an identity guard and nothing more (`installForeignPropertyAccessors` in `gi.js`), so a
+     * property that left this to the real leg got the identity answer there and the measured one
+     * off-device — the per-leg difference this seam exists to close.
      */
     readonly changed?: (next: unknown, held: unknown, written: unknown, self: object) => boolean;
     /**
-     * The rest of the C setter, on the PURE leg: runs once this property's own `notify::<name>`
-     * is out, so a setter that also drives OTHER properties emits in the order C does.
+     * The rest of the C setter: runs once this property's own `notify::<name>` is out, so a
+     * setter that also drives OTHER properties emits in the order C does. For a property with
+     * {@link ForeignScalarProperty.explicitNotify} it runs INSTEAD of that notify, and owes every
+     * emission the write makes, its own included.
      *
      * WHY IT IS NOT `normalize`. A normalizer runs AHEAD of the store, so a cross-write made
      * there notifies before the property that caused it. `Adw.SplitButton` measures the other way
@@ -46,8 +53,9 @@ type Declared<P> = P & {
      * after — and the two cannot both be one hook. The SHAPE of a value still belongs to
      * `normalize`; what the write does to its siblings belongs here.
      *
-     * Not run on the real leg, where the C setter does this itself: a second pass would write the
-     * cleared slot a second time, and C answers a redundant `null` with a CRITICAL.
+     * RUNS ON BOTH LEGS, for the reason {@link Declared.changed} states: the foreign-parent class
+     * route D registers has no C setter to do this instead. `adw-split-button`'s label/icon-name
+     * mutual clear is the one that was silently missing on Android because of it.
      */
     readonly afterNotify?: (self: object) => void;
 };
@@ -223,4 +231,21 @@ export declare function withProperties<TBase extends ObservableConstructor>(Base
     /** Only what this class ADDS; `emittedSignalsOf` merges it with the base's. */
     readonly emittedSignals: readonly string[];
 }) & TBase;
+/**
+ * Write a declared property's held value WITHOUT notifying, and without running `normalize`,
+ * `changed` or `afterNotify` — the PUSH half of a property whose widget owns the emission.
+ *
+ * WHY A WIDGET NEEDS IT. A property whose value also moves from UNDERNEATH — the selection of an
+ * `Adw.ComboRow` when its model is replaced, or when the held model splices — cannot be kept in
+ * sync by writing it, because the write is the thing that emits and the emission order is
+ * measured and is not the order a write would produce. `model = null` is the sharpest case:
+ * `selected` goes to the sentinel and `selected-item` to null with NO notify at all, and `model`
+ * alone notifies. So the widget pushes the new value in here and emits what it owes with
+ * `notify('<name>')`, in the order it measured.
+ *
+ * Only a {@link isSeamOwned} property may be pushed, and a name that is not one THROWS rather
+ * than writing a store route D would never read back: there the value lives in the GObject, and
+ * a silent push would be correct off-device and invisible on the device.
+ */
+export declare function pushDeclared(self: object, name: string, value: unknown): void;
 export {};

package/lib/types/widgets/single-child-base.d.ts

@@ -5,6 +5,8 @@ export declare abstract class AdwSingleChildBase extends AdwStyledLayoutBase {
     constructor();
     private _columnIsStar;
     onLoaded(): void;
+    onUnloaded(): void;
+    private _onWidthChangeSyncColumn;
     private _syncColumnToAlignment;
     /** The child, or `null`. */
     get child(): View | null;

package/lib/types/widgets/single-child-cell.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Whether the single cell of a one-child container is `star` rather than `auto`.
+ *
+ * `star` when the container's width is settled — either because it stretches to its parent,
+ * or because a definite `width` was written on it. `auto` otherwise, so the container can
+ * still report its child's natural width and be placed by its alignment.
+ */
+export declare function singleChildCellIsStar(horizontalAlignment: unknown, width: unknown): boolean;

package/lib/types/widgets/xml-values.d.ts

@@ -6,6 +6,18 @@
  * caller can keep validating a RANGE without also having to re-check the type.
  */
 export declare function xmlNumber(value: unknown, fallback: number): number;
+/**
+ * The integer GtkBuilder reads out of an enum property's value, or `undefined` when the
+ * value is a nick or name.
+ *
+ * `_gtk_builder_enum_from_string` (gtk/gtkbuilder.c) tries the number FIRST
+ * (`g_ascii_strtoull (string, &endptr, 0)`, so base 0: decimal, `0x` hex, leading-`0` octal)
+ * and only then the nick and the name — which is why `halign="1"` and `halign="start"` are
+ * the same attribute in a `.ui` file. A JS number is the same reading, already parsed.
+ * GTK also accepts a numeric PREFIX (`"2abc"` is 2); the whole string must be a number here,
+ * so a nick that merely starts with a digit stays a nick.
+ */
+export declare function gtkBuilderInteger(value: unknown): number | undefined;
 /**
  * An attribute as a boolean.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-nativescript",
-    "version": "0.64.13-next.283",
+    "version": "0.64.13",
     "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.13-next.283",
-        "@gjsify/adwaita-fonts": "0.64.13-next.283",
-        "@gjsify/adwaita-icons": "0.64.13-next.283",
-        "@gjsify/canvas2d-core": "0.64.13-next.283",
-        "@gjsify/native-platform": "0.64.13-next.283"
+        "@gjsify/adwaita-core": "^0.64.13",
+        "@gjsify/adwaita-fonts": "^0.64.13",
+        "@gjsify/adwaita-icons": "^0.64.13",
+        "@gjsify/canvas2d-core": "^0.64.13",
+        "@gjsify/native-platform": "^0.64.13"
     },
     "peerDependencies": {
         "@nativescript/core": "*",
-        "@gjsify/app-settings": "0.64.13-next.283"
+        "@gjsify/app-settings": "^0.64.13"
     },
     "peerDependenciesMeta": {
         "@nativescript/core": {
@@ -92,11 +92,11 @@
         }
     },
     "devDependencies": {
-        "@gjsify/app-settings": "0.64.13-next.283",
-        "@gjsify/blueprint": "0.64.13-next.283",
-        "@gjsify/cli": "0.64.13-next.283",
-        "@gjsify/unit": "0.64.13-next.283",
-        "@gjsify/vite-plugin-blueprint": "0.64.13-next.283",
+        "@gjsify/app-settings": "^0.64.13",
+        "@gjsify/blueprint": "^0.64.13",
+        "@gjsify/cli": "^0.64.13",
+        "@gjsify/unit": "^0.64.13",
+        "@gjsify/vite-plugin-blueprint": "^0.64.13",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
@@ -125,6 +125,5 @@
     "bugs": {
         "url": "https://github.com/gjsify/gjsify/issues"
     },
-    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/nativescript-bridge/adwaita#readme",
-    "gitHead": "05fae97125a374e84bf57c2d2d086fb53523f205"
+    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/nativescript-bridge/adwaita#readme"
 }

package/src/testing/ns-core.mts

@@ -177,6 +177,8 @@ export class Style extends Observable {
     fontSize?: number;
     readonly viewRef: WeakRef<View>;
     #visibility = 'visible';
+    #width: number | string = 'auto';
+    #height: number | string = 'auto';
 
     constructor(view: View) {
         super();
@@ -193,6 +195,33 @@ export class Style extends Observable {
         this.#visibility = value;
         this.notify({ eventName: 'visibilityChange', object: this, propertyName: 'visibility', value, oldValue });
     }
+
+    /**
+     * The inline width, in DIPs or as a percentage string, `'auto'` until written — and the
+     * `widthChange` a one-child container listens for. A CSS property notifies on the style
+     * and not on the view, which is the whole reason this pair lives here.
+     */
+    get width(): number | string {
+        return this.#width;
+    }
+
+    set width(value: number | string) {
+        const oldValue = this.#width;
+        if (value === oldValue) return;
+        this.#width = value;
+        this.notify({ eventName: 'widthChange', object: this, propertyName: 'width', value, oldValue });
+    }
+
+    get height(): number | string {
+        return this.#height;
+    }
+
+    set height(value: number | string) {
+        const oldValue = this.#height;
+        if (value === oldValue) return;
+        this.#height = value;
+        this.notify({ eventName: 'heightChange', object: this, propertyName: 'height', value, oldValue });
+    }
 }
 
 export class View extends Observable {
@@ -234,8 +263,32 @@ export class View extends Observable {
      * missing so the first `className` write died inside a constructor.
      */
     readonly cssClasses: Set<string> = new Set();
-    width: number | string = 'auto';
-    height: number | string = 'auto';
+    /**
+     * `'auto'` until written, and HELD ON THE {@link Style} as `widthProperty` /
+     * `heightProperty` are (`ui/styling/style-properties.ts` registers both on `Style`;
+     * `view-common.ts`'s `get width()` is a one-line forward to `this.style.width`).
+     *
+     * This double held them as plain fields on the view, which made it STRUCTURALLY BLIND to
+     * the one thing a reader needs from them: the notification. `AdwSingleChildBase` learns
+     * that a parent settled its width from `widthChange` on the style — on a device the only
+     * place it is emitted — and against a field there is no event at all, so a spec would
+     * have passed while the widget sat waiting for a message that never came.
+     */
+    get width(): number | string {
+        return this._style.width;
+    }
+
+    set width(value: number | string) {
+        this._style.width = value;
+    }
+
+    get height(): number | string {
+        return this._style.height;
+    }
+
+    set height(value: number | string) {
+        this._style.height = value;
+    }
     horizontalAlignment = 'stretch';
     verticalAlignment = 'stretch';
     /**